游戏规则事件

游戏规则事件

Gamerule Events 是一个适用于 NeoForge 的 Minecraft 模组,允许你在游戏规则更改时触发自定义操作。

Gamerule Events

Gamerule Events 是一个适用于 NeoForge 的 Minecraft 模组,允许你在游戏规则发生变化时触发自定义操作。操作通过数据包定义。

功能特性

  • 游戏规则变化时触发操作:当特定游戏规则被修改时,执行标题、副标题和音效。
  • 数据包驱动:在 data/<namespace>/gamerule_events/ 下的 JSON 文件中定义你自己的规则和操作。
  • 多种操作:支持设置标题/副标题(含淡入淡出时间)以及播放音效。

配置示例

在 data/<namespace>/gamerule_events/<name>.json 创建文件:

{
  "rules": [
    {
      "gamerule": "minecraft:doDaylightCycle",
      "when": {
        "equals": "false"
      },
      "actions": [
        {
          "type": "broadcast_title",
          "title": { "text": "Daylight Cycle Stopped", "color": "red" },
          "subtitle": { "text": "Gamerule change detected", "color": "yellow" },
          "fadeIn": 10,
          "stay": 60,
          "fadeOut": 10
        },
        {
          "type": "broadcast_sound",
          "sound": "minecraft:block.note_block.pling",
          "volume": 1.0,
          "pitch": 1.0
        }
      ]
    }
  ]
}

说明:

  • gamerule 必须与游戏内的游戏规则标识符匹配(通常带命名空间,如 minecraft:doDaylightCycle)。
  • when.equals 会与序列化后的新游戏规则值进行比较;布尔值应写作 "true" / "false"。
  • 编辑 JSON 后,运行 /reload 以应用更改。

支持的操作

数据包模式使用 actions[] 数组。支持的操作 type:

  • broadcast_title

    • title(Component JSON)可选
    • subtitle(Component JSON)可选
    • fadeIn(int,默认 10)
    • stay(int,默认 40)
    • fadeOut(int,默认 10)
  • broadcast_sound

    • sound(string,资源位置,如 minecraft:block.note_block.pling)
    • volume(float,默认 1.0)
    • pitch(float,默认 1.0)

安装

Gamerule Events 面向 NeoForge 26.1(Minecraft 26.1)或更高版本。

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE.txt 文件。