GameruleLock

插件

· 作者 XenbleDev

将你的 gamerules 固定在配置文件中并保持一致 —— GameruleLock 会在启动、世界加载以及运行时更改后重新应用你选择的值,并记录每次修正。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 1.21.1 · Paper / Purpur

一键开服(送7天)

GameruleLock

将你的游戏规则锁定为你选择的值——永久生效。

GameruleLock 会在服务器启动和每次世界加载时,验证配置中固定的每一个游戏规则;一旦发现偏离,便会写回配置的数值,并记录每一次修正。再也不用在重启、导入世界或好心的管理员执行了 /gamerule 命令后,惊慌失措地大喊“为什么 keepInventory 又关了?”。

✨ 功能特性

  • ? 基于配置的锁定 — 可以为每个世界固定游戏规则值,也可以通过 default 块一次性为所有世界固定。配置中未列出的游戏规则绝不会受到干扰。
  • ? 启动时强制应用 — 插件启用时会检查所有已加载的世界;任何偏差都会立即被纠正。
  • ? 加载世界时强制应用 — 后续加载的世界(例如通过 Multiverse)会通过 WorldLoadEvent 进行相同的检查。
  • ?️ 可选的运行时保护 — 当 enforce-on-change: true 时,任何与锁定值冲突的更改都会在一刻钟(tick)内被撤销,无论该更改来自玩家的 /gamerule、控制台、RCON 还是其他插件。执行了冲突命令的玩家会收到其更改被撤销的原因说明;但命令本身不会被阻止。
  • ? 变更日志 — 每一次修正都会写入控制台,并且(可选地)追加到 plugins/GameruleLock/changes.log 文件中,包含时间戳、世界名称、发现的值、写入的值以及触发检查的原因。
  • ? 快照命令 — /grl capture 会将某个世界(或所有世界)当前的游戏规则直接写入 config.yml,这样你就不必手动编写 YAML 文件了。

? 安装方法

  1. 下载 GameruleLock jar 文件。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 重启服务器。默认的 plugins/GameruleLock/config.yml 文件将被创建。
  4. 你可以手动编辑 config.yml,或者在游戏中按照你希望的方式设置游戏规则,然后运行 /grl capture all 将所有内容按当前状态锁定。

要求: Minecraft 1.20.x–1.21.x 的 Paper(或 Paper 分支),Java 21。仅使用稳定的 Bukkit/Paper API —— 不涉及 NMS,也不使用反射。

⌨️ 命令

主命令:/grl(别名:/gamerulelock)。

命令 描述 权限
/grl check [world] 将当前值与锁定值进行比较,列出偏差(不会修改任何内容) gamerulelock.check
/grl enforce [world] 立即执行强制应用,并纠正任何偏差 gamerulelock.enforce
/grl capture <world|all> 将当前的游戏规则值快照保存到 config.yml 并保存文件 gamerulelock.capture
/grl reload 重新加载 config.yml,然后执行强制应用 gamerulelock.reload

所有权限默认授予 op(操作员)。

⚙️ 配置

# 是否撤销与锁定值冲突的运行时更改(玩家 /gamerule、控制台、RCON、其他插件)?
# 命令不会被阻止;该值将在一刻钟(tick)内被纠正。
enforce-on-change: true

# 是否将修正记录追加到 plugins/GameruleLock/changes.log?
# (控制台日志始终开启。)
log-to-file: true

# 是否在做出修正时向在线的操作员发送简短摘要?
notify-ops: true

# 应用于所有世界的锁定规则。
default:
  keepInventory: true
  doFireTick: false

# 针对特定世界的锁定规则。这些规则会覆盖该世界的 "default" 块。
worlds:
  world_nether:
    doMobSpawning: false

注意:

  • 值必须匹配游戏规则的类型 —— 布尔规则使用 true/false,整数规则使用整数(例如 randomTickSpeed: 3)。
  • 如果游戏规则名称未知或值类型错误,则会被跳过并附带控制台警告;配置的其他部分仍正常工作。
  • 某个世界的有效锁定规则是 default 块与该世界在 worlds 下的条目合并而成,若存在冲突,则以该世界条目的值为准。
  • 配置中完全未出现的游戏规则将完全不受影响。

? 变更日志文件

当启用 log-to-file 时,每一次修正都会作为一行纯文本追加到 plugins/GameruleLock/changes.log 中:

2026-07-21 14:03:12 [startup] world: keepInventory false -> true

触发标签可以是以下之一:startup(启动)、world-load(世界加载)、runtime(运行时更改被撤销)或 manual(/grl enforce 或 /grl reload)。文件写入操作在非主线程上进行,因此日志记录不会占用你的游戏刻(ticks)。

? GameruleLock 故意不做的事情

不提供图形界面(GUI)、不使用数据库、没有网页面板,也不会锁定非游戏规则的设置(如难度或生成标志)。它只做一件事:让你的游戏规则保持在你设定的位置。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源