<\/p>\n
> \ud83d\udcd6 Full documentation, all config fields, examples, and the developer API are on the Wiki.<\/p>\n
**History Stages** is a comprehensive progression and gatekeeping mod built for modpack creators. Lock items, recipes, dimensions, structures, mobs, and loot behind custom research-based eras \u2014 and let players work together or individually to unlock them through the Research Pedestal.<\/p>\n
Stages can unlock **server-wide** (global) for the whole group, **per player** (individual), or even use a **dual-phase** approach \u2014 giving you full control over how progression works in your pack.<\/p>\n
—<\/p>\n
## \u2728 What makes History Stages different<\/p>\n
Most progression mods track progress per player. History Stages lets you do it all:
\n– **Global stages** unlock for the entire server at once, perfect for collaborative packs where no one sneaks ahead.
\n– **Individual stages** track progress per player via UUID-based persistence, opening the door for personal quest lines or story-driven packs.
\n– **Dual-Phase stages** automatically trigger when an item is in both a global and individual stage. The item is locked globally until the server reaches the era, and then remains locked per-player until they personally catch up.<\/p>\n
Advancing isn’t just a command either. Players physically bring **Research Scrolls** to the **Research Pedestal** and spend time researching to unlock the next era. With the **Dependency System**, you can require players to reach specific XP levels, kill certain mobs, achieve statistics, or deposit items directly into the pedestal before a stage can be researched.<\/p>\n
On top of that, almost everything can be locked \u2014 not just items, but recipes across every mod, dimensions, structures, mob spawning, loot tables, armor stand displays, block GUIs, enchantments, and more. And with the built-in in-game editor, you can build and tweak your entire stage setup without ever touching a config file.<\/p>\n
If you’re using FTB Quests, the integration goes even deeper \u2014 History Stages adds native **stage task types** and **stage reward types** for both global and individual stages directly into the FTB Quests editor.<\/p>\n
—<\/p>\n
## \ud83d\udd12 What you can lock<\/p>\n
– **Items, Tags & entire Mods** \u2014 lock individual items, item tags, or everything from a specific mod at once
\n– **NBT-specific Items** \u2014 lock items by exact NBT criteria (e.g. a specific enchantment or potion effect)
\n– **Mod Exceptions** \u2014 exclude specific items (with full NBT support) from mod-level locking
\n– **Per-Action Locking** \u2014 restrict individual entries to specific interactions (use, attack, equip, pickup, place, break, \u2026) instead of locking them entirely, configurable per item, tag, or mod
\n– **Recipes** \u2014 locked recipes show a **”Locked”** overlay in JEI\/EMI instead of being hidden, so players can see what’s coming
\n– **Dimensions** \u2014 block access to the Nether, End, or any other dimension until players are ready
\n– **Structures** \u2014 prevent players from entering specific structures (e.g. Strongholds or Villages via tags), optionally dealing damage and blocking container interactions inside
\n– **Mobs** \u2014 two modes: *Attacklock* (players can’t hurt the mob) and *Spawnlock* (prevents spawning entirely, including spawners and commands). Spawnlocked mobs are also automatically attacklocked.
\n– **Loot & Drops** \u2014 locked items are removed or replaced in loot chests and mob drops
\n– **Blocks** \u2014 locked blocks resist breaking with a configurable slow-break multiplier
\n– **Block GUIs** \u2014 prevent players from opening chests, furnaces, and other block containers while locked
\n– **Enchantments** \u2014 prevent applying locked enchantments via the anvil and enchanting table
\n– **Armor Stands & Item Frames** \u2014 locked items displayed on armor stands or item frames can’t be taken or destroyed<\/p>\n
—<\/p>\n
## \ud83d\udd2c The Research System<\/p>\n
Players unlock stages by using **Research Scrolls** at the **Research Pedestal**. Each stage can have its own research time \u2014 or fall back to a global default in your config.<\/p>\n
If a stage has **Dependencies**, the Pedestal GUI dynamically expands to show a checklist of all required conditions. Players can deposit required items and XP directly into the pedestal to fulfill these requirements incrementally.<\/p>\n
This mod intentionally ships without default recipes for the Pedestal and Scrolls, so you as a modpack creator can decide how players obtain them. To give a specific scroll via command:<\/p>\n
“`
\n\/give @s historystages:research_scroll{StageResearch:”YOUR_STAGE_NAME”}
\n“`<\/p>\n
—
\n## \ud83d\udcc2 Creating Stages<\/p>\n
The easiest way is the in-game stage editor (see below). If you prefer working with files, global stage configs are stored in `config\/historystages\/global\/` and individual stages in `config\/historystages\/individual\/`.<\/p>\n “`json Files starting with `_` are ignored and can be used as templates. The full field reference and more examples are on the Wiki.<\/p>\n<\/details>\n —<\/p>\n ## \ud83d\udee0\ufe0f Tools for Pack Creators<\/p>\n ### In-Game Stage Editor ### In-Game Config Editor ### Debug Commands —<\/p>\n ## \ud83c\udfa8 UI & Feedback<\/p>\n – **Lock Icon Overlay** \u2014 locked items show a padlock in inventories and JEI (auto-disabled with EMI). Dual-phase items get a dedicated lock icon during Phase 1. —<\/p>\n ## \u2328\ufe0f Admin Commands<\/p>\n All commands use the `\/history` prefix and require Permission Level 2 (OP). They cover unlocking and locking stages globally or per player, reloading configs, and debug utilities for structure IDs and item NBT data.<\/p>\n —<\/p>\n ## \ud83d\udd27 For Developers & Script Authors<\/p>\n History Stages fires `StageEvent.Unlocked` and `StageEvent.Locked` on the Forge event bus, which KubeJS, CraftTweaker, and other mods can listen to.<\/p>\n —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n Everything is configurable via `historystages-common.toml` and `historystages-client.toml`, or through the in-game config editor.<\/p>\n —<\/p>\n ## \ud83d\udce6 Dependencies<\/p>\n – **Lootr** \u2014 required —<\/p>\n ## \u2753 FAQ<\/p>\n Yes! History Stages supports both **global stages** (server-wide) and **individual stages** (per player, tracked via UUID). You can mix and match both types in the same pack, which automatically creates **Dual-Phase** locks for overlapping items.<\/p>\n<\/details>\n Yes. The mod ships without default recipes on purpose so you have full control over how players obtain them. You can add recipes via KubeJS, CraftTweaker, or a datapack \u2014 or simply give scrolls to players as quest rewards using the `\/give` command.<\/p>\n<\/details>\n Yes, Lootr is a hard dependency. Loot chest filtering is built entirely around Lootr’s container system and can’t be made optional without a major rewrite. If you’re not using loot locking, Lootr still needs to be present but won’t get in the way.<\/p>\n<\/details>\n Yes \u2014 History Stages fires `StageEvent.Unlocked` and `StageEvent.Locked` on the Forge event bus, which both KubeJS and CraftTweaker can listen to. You can use these to trigger custom logic when a stage changes.<\/p>\n<\/details>\n Yes \u2014 each item, tag, or mod entry supports an optional `unlock_actions` list. You can specify exactly which interactions stay available (e.g. `pickup` and `equip`) while everything else (attacking, crafting, using, \u2026) remains locked. This works for items, tags, and mods, and can be configured directly in the in-game stage editor.<\/p>\n<\/details>\n – **1.20.1 \/ 1.21.1** \u2014 Forge & NeoForge (latest features) No, FTB Quests is completely optional. The integration only activates when FTB Quests is present and adds custom task and reward types for both global and individual stages \u2014 but the mod works perfectly without it.<\/p>\n<\/details>\n —<\/p>\n Found a bug or have a question? Feel free to open an issue on GitHub \u2014 we read everything! \ud83d\ude42<\/p>\n","protected":false},"excerpt":{"rendered":" Guide your players through the ages. History Stages lets modpack creators lock items, recipes, dimensions, mobs, loot, and more behind custom research-based eras with full in-game tooling.<\/p>\n","protected":false},"featured_media":81280,"template":"","meta":{"_minecraft_slug":"history-stages","_minecraft_project_id":"vChjQZEl","_minecraft_author":"Flix100000","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":810,"_minecraft_follows":21,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"history-stages.zip","_minecraft_size_bytes":7131155,"_minecraft_version_count":28,"_minecraft_updated_at":"2026-05-15T20:44:56.241739Z","_minecraft_date_created":"2026-02-26T04:24:15.721107Z","_minecraft_date_modified":"2026-05-13T15:13:54.193903Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/history-stages","_minecraft_icon_attachment_id":81280,"_minecraft_imported_at":"2026-06-04T16:14:11+00:00","_minecraft_import_hash":"6c18924e160e6ac1fb3270fc5aadafcc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,89,126,158,90,123,92],"mod_loader":[106,160],"minecraft_version":[54,55,56,59,36,62,37],"class_list":["post-81279","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-optimization","mod_category-technology","mod_category-utility","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\nClick to expand \u2014 JSON format<\/summary>\n
\n{
\n “display_name”: “Bronze Age”,
\n “research_time”: 60,
\n “icon”: “minecraft:iron_ingot”,
\n “items”: [
\n “minecraft:iron_ingot”,
\n {
\n “id”: “minecraft:iron_sword”,
\n “unlock_actions”: [“pickup”, “equip”]
\n }
\n ],
\n “tags”: [“forge:ores\/iron”],
\n “mods”: [“mekanism”],
\n “mod_exceptions”: [“mekanism:osmium_ingot”],
\n “recipes”: [“minecraft:iron_pickaxe”],
\n “dimensions”: [“minecraft:the_nether”],
\n “structures”: [“minecraft:stronghold”, “#minecraft:village”],
\n “entities”: {
\n “attacklock”: [“minecraft:zombie”],
\n “spawnlock”: [“minecraft:skeleton”]
\n },
\n “dependencies”: [
\n {“type”: “xp_level”, “level”: 10},
\n {“type”: “entity_kills”, “entity”: “minecraft:zombie”, “count”: 20}
\n ]
\n}
\n“`<\/p>\n
\nCreate, edit, duplicate, and delete stages directly in-game \u2014 no file editing required. Features searchable lists with multi-select for items, recipes, entities, dimensions, structures, tags, and mods. Includes a **Dependency Editor**, **NBT Editor**, **Lock Actions Editor**, and a dedicated **Stage Settings** screen. The editor also warns about overlaps between global and individual stages, marking dual-phase entries with a `[Dual]` badge. Accessible via a button in the pause menu (OP required).<\/p>\n
\nTweak all mod settings without leaving the game, organized by category with a reset-to-defaults option. Accessible through the stage editor.<\/p>\n
\nDebug commands help you find the exact IDs and NBT data you need for your configs:
\n– `\/history debug structure` \u2014 lists structure IDs and tags at your current position
\n– `\/history debug nbt preset|custom` \u2014 lists NBT data for your held item<\/p>\n
\n– **Recipe “Locked” Overlay** \u2014 locked recipes show a “Locked” label in JEI\/EMI instead of being hidden entirely
\n– **Toast Notifications** \u2014 an advancement-style popup notifies players when a stage unlocks, with support for custom per-stage icons
\n– **Jade Integration** \u2014 shows stage info as a tooltip on armor stands, item frames, blocks, and entity items
\n– **Actionbar & Chat Messages** \u2014 configurable per-stage feedback when players try to access locked content<\/p>\n
\n– JEI \u2014 optional
\n– EMI \u2014 optional
\n– FTB Quests \u2014 optional (adds custom stage task & reward types for global and individual stages)
\n– Jade \u2014 optional (shows stage info on armor stands, item frames, blocks, and entity items)
\n– Curios \u2014 optional (extends item locking to Curios slots)<\/p>\nCan stages be unlocked per player instead of server-wide?<\/summary>\n
Do I need to add crafting recipes for the Research Pedestal and Scrolls myself?<\/summary>\n
Is Lootr really required? Can I use the mod without it?<\/summary>\n
Does it work with KubeJS or CraftTweaker?<\/summary>\n
Can I let players pick up or carry a locked item, but not use it?<\/summary>\n
Which Minecraft versions are supported?<\/summary>\n
\n– **1.19.2** \u2014 Forge (legacy version, no longer receiving updates)<\/p>\n<\/details>\nDo I need FTB Quests to use this mod?<\/summary>\n