Datapack authoring
Start here for datapack formats, file paths and reload behavior.
NTM 1.0.4 supports Minecraft 26.2 and 26.3. Read the 1.0.4 changes and 26.3 migration guide.
ntm-next uses datapacks for recipes, hazards and radiation, custom machines, in-game manuals, fluid, machine and game settings, world generation, loot, tags and advancements. The version selector chooses the Minecraft release, NTM release, and loader. Start with the datapack catalog for formats and file paths.
| You want to… | Start here |
|---|---|
| Add or override in-game manuals and help triggers | Manuals (QMAW) |
| Change an existing recipe | Datapack Quick Start |
| Write inputs, outputs, probabilities, or conditions | Recipes |
| Find a machine's recipe format | Machine Recipes |
| Match container contents or item components | Ingredients and Components |
| Define a custom multiblock machine and its processes | Custom Machines |
| Change machine settings or an existing fluid's properties | Datapack Settings |
| Look up all machine-setting keys or fluid traits | Machine Settings Reference, Fluid Trait Reference |
| Change explosion, mob, meteor, item, energy or radiation settings | Game Settings |
| Set hazards, radiation sources or dimension radiation | Hazards and Radiation |
| Change generation, structures, processors or template pools | World Generation |
| Change loot, tags, damage data, songs or advancement criteria | Loot, Tags and Advancements |
| Find inherited Minecraft datapack entry points | Vanilla Data |
Addons have their own chapters and release tracks: NTM Space and NTM: Cursed. Select an addon release in the version selector.
Protection registries cover radiation resistance, filters, and suits. Consumable treatments bind item use or consumption to ordered treatment actions.
Start from the version you actually run
Open the version selector beside the theme switch to select Minecraft, the NTM release, and the loader. All revisions shows the documented history with since, until, deprecation and removal labels. Both loaders shows loader-specific forms side by side. Selecting an exact release or loader shows the content that applies to that choice.
Open your installed ntm-next .jar with a ZIP viewer and inspect its data/ directory. This is the reference for that build's identifiers, recipe types, conditions, and default values. Copy a relevant file into your own pack and make a small change.
Most examples work identically on both loaders. See Recipe Conditions for conditional recipes and Ingredients and Components for custom ingredient forms.
Datapacks refer to registered items, blocks, fluids and recipe types. Custom-machine definitions are an NTM data-loaded registry that uses the existing controller item.
What can be reloaded?
| Data | Location pattern | When changes take effect |
|---|---|---|
| Recipes | data/ | / |
| Item tags | data/ | / |
| QMAW manuals | data/ | /; the catalog is sent on join and reload |
| Fluid properties | data/ | /; properties are sent to connected clients |
| Fluid property patches | data/ | /, applied before the patched properties |
| Custom-machine definitions | data/ | World load: reopen singleplayer or restart the server |
| Machine settings | data/ | World load: reopen singleplayer or restart the server |
| Game settings | data/ | World load: reopen singleplayer or restart the server |
| Hazards, radiation and treatment registries | data/ | World load; see the catalog for each ID's meaning |
| Worldgen registry definitions, damage types, songs | Vanilla registry directories | World load |
| Structure templates | data/ | Resource-manager reload clears the template cache |
| Loot, advancements, functions, predicates, item modifiers | Corresponding vanilla directories | / |
The extra hbm/ in NTM's custom-registry paths names the registry's namespace. Reopen the world for changes to these registries. Template-resource reload is separate from the worldgen registry entries which reference the templates.
Translated names under assets/<namespace>/lang/ belong in a resource pack.
Example packs
Each ZIP contains one datapack. Put one ZIP in the world's datapacks/ directory and enable it.
| Pack | Change |
|---|---|
| Apple yield | One apple produces two sugar in the shredder. |
| Custom paper press | Adds a separate paper press definition, recipe and controller. |
| Centrifuge time | Sets centrifuge processing time to 100 ticks. |
| Diesel colour | Changes the diesel fluid colour. |
| Workshop manual | Adds a server-owned manual page triggered by paper. |
Alex's Caves has three packs for use with Alex's Caves.
© 2026 movblock. Original site text is licensed under CC BY-SA 4.0 unless otherwise noted. Built with Fumadocs.