Chapters

Documentation & examples: https://github.com/GabinFqt/chapters/wiki

Chapters turns your pack into a story of unlocks. You name each step a chapter, lock the content that belongs later, and only open it when players earn that chapter: quest reward, script, or admin command.

Available for Minecraft 1.21 (Chapters 1.x) and Minecraft 26 (Chapters 2.x). Inspired by GameStages / ItemStages, made for NeoForge packs that want real progression without juggling half-finished stage mods.

What it does for your pack

- Gate the next era: Keep netherite, Create, Mekanism, or a whole mod locked until players finish the early game.
- Hide the spoilers: With JEI, locked items and recipes stay out of the recipe book until unlocked.
- Enforce on the server: Locked items cannot be picked up or crafted on the vanilla crafting table, and they are dropped from inventory if obtained early.
- Lock more than items: Fluids (buckets, cauldrons, transfers), recipes by id, and Mekanism chemicals when Mekanism is available.
- One chapter, one mod: Lock an entire mod behind a single chapter when you want a clean era boundary.
- Solo or party: With FTB Teams, the party shares unlocks. With FTB Quests, grant or require chapters using the built-in Stage reward / task fields.
- Your tools: Define chapters with datapacks and/or KubeJS; grant them with commands, quests, or scripts.

Good use cases

- Age / chapter packs where each tech tree opens over time
- Softening early JEI overwhelm by revealing content as players progress
- Multiplayer co-op where the team unlocks the next chapter together
- Quest packs that already use FTB Quests and want stages that actually block items

Optional integrations

- JEI: hide locked content until unlock
- KubeJS: define and grant chapters from scripts
- FTB Library + Quests: Stage Reward, Stage Task, Stage Required with no extra wiring
- FTB Teams: shared team unlocks
- Mekanism: chemical gating when a matching build exists

Setup in short

The jar ships no preset chapters: you add your own.

1. Define a chapter (datapack or KubeJS).
2. Reload.
3. Test with /chapters check, then /chapters add.

Full syntax and examples: the wiki. Sample scripts on GitHub.

Commands: /chapters add, remove, list, check, reload

Compatibility

- Minecraft 1.21 → Chapters 1.x (NeoForge 21.1, Java 21)
- Minecraft 26 → Chapters 2.x (NeoForge 26.1, Java 25)

Links

- GitHub: https://github.com/GabinFqt/chapters
- Releases: https://github.com/GabinFqt/chapters/releases
- License: MIT

Issues and suggestions are welcome on GitHub.