LightVision

插件

· 作者 LucasTHCR

轻量级夜视插件。允许玩家自行切换,或由管理员控制、限制和自动化操作。

0 本站下载 0 关注 更新于 2 周前

最新 1.4-RELEASE · 26.3 · Bukkit / Folia

一键开服(送7天)

Built with Java 21 Available for Paper Available for Purpur Available for Spigot Available for Bukkit Available for Folia

Chat with us on Discord Available on Codeberg

LightVision

将夜视效果作为开关使用。玩家可以使用 /lv 自行开启或关闭夜视,工作人员可以为其他人设置,阻止滥用该功能的玩家,并允许插件在玩家进入黑暗区域时自动开启夜视。

状态会在重启后保留,被拉黑的世界无论如何都会保持黑暗,且插件绝不会干扰它未发放的夜视效果——药水或信标提供的夜视效果仍会按玩家预期正常工作。

要求

  • Minecraft 1.21+ 上的 Paper、Purpur 或 Spigot
  • Java 21
  • PlaceholderAPI(可选,仅用于占位符)

命令

/lv 和 /lightvision 是同一个命令。

命令 描述 权限
/lv 切换自己的夜视效果 lv.use
/lv <player> [on|off] 切换或为他人设置夜视效果 lv.admin
/lv block <player> 禁止某玩家使用夜视效果 lv.admin
/lv unblock <player> 解除禁止 lv.admin
/lv reload 重新加载 config.yml 并应用于所有在线玩家 lv.admin

lv.use 默认为 true,lv.admin 默认为 op。lv.bypass.block(op)可保护玩家不被其他工作人员屏蔽。

/lv unblock 也适用于离线玩家,只要服务器之前见过该玩家即可。原始 UUID 也可以使用。

占位符

占位符 值
%lightvision_enabled% 当玩家手动开启夜视时为 true
%lightvision_auto% 当黑暗触发器提供夜视时为 true
%lightvision_active% 上述两种情况之一
%lightvision_blocked% 如果工作人员屏蔽了该玩家则为 true

配置

config.yml 包含两个部分,均在内部进行了文档说明:

  • settings - 跨重启保存状态、使用动作栏而非聊天栏、标题、关闭夜视时的失明闪烁、黑暗触发器以及世界黑名单
  • messages - 所有面向玩家的文本,采用 MiniMessage 格式

黑暗触发器

默认关闭。启用后,低于 light-level(光照等级)的玩家会自动获得夜视效果,并在光线变亮时失去效果。自动获得的夜视效果与玩家手动切换的效果分开处理:它不会写入 data.yml,一旦有人使用 /lv 就会让位,且关闭触发器并运行 /lv reload 会移除当前拥有该效果的所有玩家的夜视。

光照检测在移动时进行(每个玩家每秒最多两次),并通过后台任务每 check-interval-ticks(检查间隔刻数)执行一次。

数据

data.yml 存储了开启夜视效果的玩家的 UUID 以及屏蔽列表。未开启夜视的玩家则不会出现在文件中,因此文件体积保持较小。它在主线程之外写入,最多每分钟一次,并在服务器关闭时写入。

构建

mvn clean package

着色后的 jar 包位于 target/lightvision-<version>.jar。bStats 和 MiniMessage 已着色并重定位到 de.empireblocks.lightVision.libs;spigot-api 标记为 provided,不包含在 jar 包中。

许可证

GNU General Public License v3.0。请参阅 LICENSE。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源