Gamerule Events

Gamerule Events is a Minecraft mod for NeoForge that allows you to trigger custom actions when game rules change. Actions are defined via data packs.

Features

Trigger Actions on GameRule Change: Execute titles, subtitles, and sounds when a specific game rule is modified.
Data Pack Driven: Define your own rules and actions in data/<namespace>/gamerule_events/ JSON files.
Multiple Actions: Supports setting title/subtitle (with fade timings) and playing sounds.

Example Configuration

Create a file at 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
        }
      ]
    }
  ]
}

Notes:

gamerule must match the in-game gamerule identifier (usually namespaced like minecraft:doDaylightCycle).
when.equals is compared to the serialized new gamerule value; booleans should be "true" / "false".
After editing JSON, run /reload to apply changes.

Supported Actions

The datapack schema uses an actions[] array. Supported action types:

broadcast_title
- title (Component JSON) optional
- subtitle (Component JSON) optional
- fadeIn (int, default 10)
- stay (int, default 40)
- fadeOut (int, default 10)
broadcast_sound
- sound (string, resource location like minecraft:block.note_block.pling)
- volume (float, default 1.0)
- pitch (float, default 1.0)

Installation

Gamerule Events targets NeoForge 26.1 (Minecraft 26.1) or later.

License

This project is licensed under the MIT License for details.