NoFullBright

插件

· 作者 davi_fonto_

Paper 插件,当检测到玩家使用全亮材质包时执行命令

0 本站下载 0 关注 更新于 1 年前

最新 1.0 · 1.21.8 · Bukkit / Paper

一键开服(送7天)

NoFullBright

NoFullBright 是一个轻量级的 Paper/Spigot 插件,用于检测配置世界中的疑似客户端“全亮”(fullbright)行为,并在玩家超过警告阈值时执行可配置的命令。

功能

  • 定期在服务器端检查低光照条件,即玩家本应无法清晰视物的情况。
  • 可配置的检查生效世界列表。
  • 当检测到玩家在可疑条件下反复出现时,执行可配置的命令(支持占位符)。
  • 轻量且极简:默认情况下不包含任何命令或额外的监听器。

工作原理

每隔设定的时间间隔(默认初始延迟为 200 tick,运行间隔为 200 tick),插件会扫描配置世界中的所有玩家并评估每个玩家的状态:

  • 如果玩家脚底的光照等级小于 2 且 Y 坐标低于 40,则视为“处于黑暗中”。
  • 如果玩家没有获得夜视或发光药水效果,并且双手均未手持火把,插件会增加该玩家的内部警告计数器。

注意:仅在生存游戏模式下对玩家进行检查。创造模式或旁观者模式的玩家不会被检查。

  • 当警告计数器达到配置的阈值(默认为 5)时,插件会执行配置的 report-command(包含 %player% 和 %world% 占位符),并重置该玩家的计数器。
  • 如果玩家回到安全状态,警告计数器会随着时间推移逐渐递减直至归零。

这种方法旨在通过在采取行动前要求重复检测,从而减少误报。

配置文件 (config.yml)

插件创建的默认 config.yml:

# NoFullBright 配置
# worlds: 运行反全亮检查的世界名称列表
# report-command: 违规时执行的命令。可以使用 %player% 和 %world% 占位符。

worlds:
  - hardcore

report-command: 'report %player% utilizzo della fullbright in %world%'
  • worlds (列表) — 将运行检查的确切世界名称。修改此列表以包含您希望启用反全亮检查的所有世界。
  • report-command (字符串) — 当玩家达到警告阈值时由服务器控制台执行的命令。插件会将 %player% 和 %world% 分别替换为玩家名称和世界名称。请确保您的服务器上存在该命令(例如来自其他插件的 report 命令)。如果命令不可用,不会发生严重错误,但也不会采取任何有效行动。

占位符

  • %player% — 替换为玩家名称。
  • %world% — 替换为世界名称。

建议与调整

  • 如果您的世界名称有所不同(例如 hardcore_1, hardcore_2),请相应地更新 worlds。
  • 如果您想要不同的灵敏度,我可以添加以下可配置选项:
    • light-threshold(默认 2)
    • y-limit(默认 40)
    • warning-count(默认 5)
    • tick-interval(调度器延迟/周期)

故障排除

  • 违规时无任何操作:请确保 report-command 中设置的命令确实存在,并且可以由服务器控制台执行(例如由其他插件提供的 report 命令)。
  • 误报过多:请在 Issues 页面告知我。
  • /plugins 列表中未显示插件:确认 JAR 文件名正确,并检查服务器日志是否显示其已加载;查看 server.log 以获取启动错误信息。

许可证

随意使用。不提供任何保修。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源