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 - see the LICENSE.txt file for details.