**Full documentation (datapacks, KubeJS, FTB, examples): GitHub Wiki**<\/p>\n
**Chapters** is a progression mod for **NeoForge 1.21.1** inspired by *GameStages* and *ItemStages*. It lets you split your modpack into named “chapters” (stages) and gate **items, fluids, Mekanism chemicals, and recipes** behind them, so players cannot interact with locked content until you unlock the stage.<\/p>\n
It targets pack authors who want **one integrated tool** for progression on modern NeoForge, with first-class support for **datapacks**, **KubeJS**, **JEI**, **Mekanism**, and **FTB** (Library, Teams, Quests).<\/p>\n
### FTB Library, FTB Teams, and FTB Quests<\/p>\n
When **FTB Library** is installed, Chapters registers as the FTB **stage provider** (`StageHelper`). **FTB Quests** can then use the built-in **Stage Reward** (grant a chapter on claim), **Stage Task** (require a chapter), and **Stage Required** on quests or chapters, all using your chapter ids with no extra wiring.<\/p>\n
With **FTB Teams** as well, unlocks are **team-scoped** via FTB’s `TEAM_STAGES`: the whole party shares chapter progress, inventory checks and JEI updates apply for every online member, and `\/chapters`, KubeJS `PlayerStages`, and FTB Quests stage rewards all read and write the same team storage. Joining a team adopts that team’s stages; leaving personal progress behind follows FTB’s team model (see the wiki for migration details).<\/p>\n
For branching logic (e.g. only grant if some other condition holds), combine **FTB Quests Custom Reward** with KubeJS. Example: `examples\/kubejs\/server_scripts\/ftbquests_chapter_reward.js` in the GitHub repo.<\/p>\n
### What you can lock<\/p>\n
– **Items:** by id, by tag (`#minecraft:swords`), or whole mod (`@create`).
\n– **Fluids:** by id, tag, or mod. Buckets, placement, and NeoForge fluid transfers are checked where a server player applies.
\n– **Mekanism chemicals:** gas \/ infusion \/ slurry \/ pigment by id, tag, or mod, on Mekanism `ChemicalUtils` paths when a server player is in scope.
\n– **Recipes:** by recipe id (`minecraft:diamond_pickaxe`, KubeJS `recipe:\u2026`, etc.). Vanilla crafting-grid recipes are blocked server-side until unlocked.
\n– **Whole mod at once:** `@modid` covers items, fluids, and chemicals from that namespace in one stage entry.<\/p>\n
Locked items are **auto-dropped** from inventory while the player lacks the stage (tick while online, and on stage removal or reload), so stashing in shulkers does not bypass the lock.<\/p>\n
### JEI<\/p>\n
With **JEI**, Chapters syncs stages to the client so JEI can hide locked ingredients, hide output recipes for locked items\/fluids\/chemicals (`TYPE_CHEMICAL` when Mekanism is present), hide recipes by locked recipe id, and show them again after unlock (`includeHidden()` on focus).<\/p>\n
### Commands<\/p>\n
“` ### Datapack stages<\/p>\n Path:<\/p>\n “` Example `data\/mypack\/chapters\/stages\/tier1.json`:<\/p>\n “`json #### Syntax<\/p>\n | Prefix | Meaning | Optional keys: `namespaces`, `fluid_namespaces`, `chemical_namespaces`.<\/p>\n If something appears in **any** stage file, the player needs **at least one** of the stages that list it (OR across definitions that mention the same ingredient), so packs and scripts can layer rules without overwriting each other.<\/p>\n ### KubeJS<\/p>\n “`js – `ChaptersEvents.defineStage(stageId, entries)`. Multiple calls in the same tick batch into one index rebuild. ### Quick start<\/p>\n The jar ships **no** preset stages. Quick test: add a datapack stage gating `minecraft:netherite_ingot`, `\/reload`, `\/chapters check ### Compatibility<\/p>\n | Mod | Notes | Recipe blocking in the mixin targets the **vanilla crafting grid** (`CraftingMenu`) for now. Other stations may still be hidden in JEI when locked but not blocked server-side the same way.<\/p>\n ### Links<\/p>\n – **GitHub:** https:\/\/github.com\/GabinFqt\/chapters —<\/p>\n","protected":false},"excerpt":{"rendered":" GameStages-style item progression for NeoForge 1.21.<\/p>\n","protected":false},"featured_media":38569,"template":"","meta":{"_minecraft_slug":"chapters","_minecraft_project_id":"kBw6VkrT","_minecraft_author":"gabinx","_minecraft_license":"MIT","_minecraft_downloads":6,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chapters.zip","_minecraft_size_bytes":1926922,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:36:48.785335Z","_minecraft_date_created":"2026-05-11T22:22:14.998598Z","_minecraft_date_modified":"2026-05-09T11:42:17.655244Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chapters","_minecraft_icon_attachment_id":38569,"_minecraft_imported_at":"2026-06-01T19:58:19+00:00","_minecraft_import_hash":"43475af65bd27de2fd81c4546b385217","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,158],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-38568","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n
\n\/chapters add
\n\/chapters remove
\n\/chapters list
\n\/chapters reload
\n“`<\/p>\n
\ndata\/
\n“`<\/p>\n
\n{
\n “items”: [
\n “minecraft:netherite_ingot”,
\n “#minecraft:swords”,
\n “minecraft:enchanted_book”
\n ],
\n “fluids”: [
\n “minecraft:lava”,
\n “#minecraft:water”,
\n “@mymodfluids”
\n ],
\n “chemicals”: [
\n “mekanism:hydrogen”,
\n “#mekanism:gases”,
\n “@mekanism”
\n ],
\n “recipes”: [
\n “minecraft:diamond_pickaxe”
\n ]
\n}
\n“`<\/p>\n
\n| — | — |
\n| `minecraft:foo` | Single id |
\n| `#namespace:tag` | Tag (items, fluids, chemicals) |
\n| `@modid` | All items, fluids, and Mekanism chemicals from that mod |<\/p>\n
\nServerEvents.loaded(event => {
\n ChaptersEvents.defineStage(
\n ‘mypack:tier1’,
\n [
\n ‘minecraft:netherite_ingot’,
\n ‘#minecraft:swords’,
\n ‘recipe:minecraft:diamond_pickaxe’,
\n ‘fluid:minecraft:lava’,
\n ‘chemical:mekanism:hydrogen’,
\n ‘@create’
\n ]
\n )
\n})
\n“`<\/p>\n
\n– `PlayerStages.of(player).add(stageId)` \/ `.remove(stageId)` \/ `.has(stageId)` \/ `.get()`<\/p>\n
\n| — | — |
\n| NeoForge 1.21.1 (21.1.x) | Required |
\n| Java 21 | Required |
\n| JEI | Optional. Hides locked content client-side |
\n| KubeJS | Optional. Bindings load automatically |
\n| Mekanism | Optional. Chemical locking; without it, chemical keys in JSON are ignored at index time |
\n| FTB Library | Optional. Stage provider for FTB Quests UI |
\n| FTB Teams | Optional. Shared team stages when Library + Teams are both present |
\n| FTB Quests | Optional. Stage Reward \/ Task \/ Stage Required |<\/p>\n
\n– **Releases:** https:\/\/github.com\/GabinFqt\/chapters\/releases
\n– **License:** MIT<\/p>\n