Skip to main content

Saturn

Saturn is a NeoForge development library for data-driven mods. Modpack authors can define resources, abilities, trigger rules and player information rows in JSON; mod authors can extend actions, conditions, costs, getters and the HUD.

Supported versions​

ItemVersion used in this documentation
Minecraft26.1.2
NeoForge26.1.2.99
Java25
SaturnCurrent source of the development branch that contains 1.2.6

The documentation covers interfaces already implemented in the current source, such as FileAccess.write and saturn:advancement_completed; before using a released JAR, confirm that the version contains the corresponding interfaces. The Saturn release that System currently depends on does not yet use these two new entry points.

Start here​

  • Installation and basic conventions: where to install, dependencies, resource IDs, data pack directories and when changes take effect.
  • Data definitions: one page for each standalone JSON definition.
  • Type reference: actions, conditions, abilities, costs, triggers, information expressions and more, with a separate page for each type including field tables and JSON examples.
  • Triggers: publishing, subscriptions, rebuilding and advancement completion events.
  • Costs and payment: cost preparation, trial calculation and commit.
  • Player information: information rows, groups, getters and missing-value handling.
  • Development API: registries, DataStorage, HUD, file access and extension interfaces.

Source code