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)