About History Stages
From ModrinthGuide 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.
- π Wiki β full documentation, config fields, JSON examples & developer API
- π¬ Discord β support, questions & sneak peeks
- π Issue Tracker β bug reports & feature requests
History Stages is a progression and gatekeeping mod for modpack creators. Lock items, recipes, dimensions, structures, biomes, mobs, fluids, merchant trades, enchantments, and loot behind custom eras β and let players unlock them however you want: research, in-game triggers, quests, or commands.
Stages can unlock server-wide (global), per player (individual), or as Dual-Phase β locked globally first, then per-player once the era is reached. You decide how progression works in your pack.
***
π What You Can Lock
Almost everything β not just item usage:
- Items & Tags (incl. NBT criteria), entire Mods, Specific Recipes β recipe locks apply per player at the crafting table, the 2Γ2 grid, the stonecutter and the smithing table, and a locked recipe stays out of the recipe book
- Dimensions, Structures & Biomes β with force-field zones, damage, potion effects & a red screen overlay
- Zones [BETA] β an area you draw yourself, built from cuboids, spheres and cylinders, several shapes per zone. A locked zone pushes players back, shows a force-field wall up close and an outline from a distance, and tints the screen from the inside
- World Generation β keep locked structures out of the world entirely, or cap how many may generate (while locked, or after the stage is unlocked)
- Mobs β attacklock & interaction lock: breeding, mounting, trading, leashing, shearing, milking, naming and equipping, each toggleable per entry and filterable by held item
- Spawn rules β a spawn lock is a full rule: a phase, eight optional conditions (dimension, biome, sky, height, time of day, light, weather, moon phase) and biomes the creature additionally spawns in, with a sentence in the editor saying in plain words what the rule does
- Trades β hide a single offer, a whole profession (optionally only on some of its levels), or a merchant level, per player, back the moment the stage unlocks. A locked offer is absent from the list rather than crossed out, so nobody loses a profession or stops levelling
- Fluids β gate a fluid through whatever is carrying it: vanilla buckets, modded buckets and tank items alike, without listing a single item id. It also covers the recipes that fluid is consumed by or produces
- Loot β chests & mob drops, removed or replaced
- Blocks β breaking, GUIs & container access
- Enchantments β anvil & enchanting table
- Armor Stands & Item Frames β displayed locked items are protected
On top of that, locked items can hide or replace their names and tooltips, and per-entry unlock_actions let you allow specific interactions (e.g. pickup or crafting) while everything else stays locked.
***
π Unlock It Your Way
The Research Pedestal is just the default, not a requirement β every stage has a mode that defines how it unlocks:
- Default β classic research with Scrolls at the Pedestal
- Auto β unlocks via in-game triggers: item pickup, entering a biome/dimension/structure, entity kill/interact, block place/break, advancements, playtime, any vanilla statistic, XP level, a status effect, the weather, the day count and the time of day (any/all combinable)
- External β unlock only via
/history, KubeJS/CraftTweaker, or as FTB Quests reward - Temporary β unlocks and re-locks on a timer, with cooldowns & trigger limits
Mix all of these freely in the same pack β research-driven eras, exploration-based unlocks, and quest rewards can live side by side. Individual stages can also be set to be lost on death, dropping the items they gated.
***
π¬ Research System
Players physically bring Research Scrolls to the Research Pedestal and spend time researching the next era. Four pedestal tiers (IβIV), placeable Research Boosters, and per-stage research times let you tune the pacing. With the Dependency System, stages can additionally require XP levels, mob kills, statistics, advancements, scoreboard objectives, another stage β global, or an individual one the researcher alone has to hold β and items or whole item tags deposited directly into the pedestal.
What happens to the scroll when the research finishes is up to you, per stage:
- Consumed β the scroll is used up
- Replaced β a fresh scroll for the same stage goes back into the pedestal, so the next player needs no second copy
- Opened β an open scroll stays behind as a readable keepsake
***
π The Research Record
An opened scroll is a real, readable document β chapters for Items, Creatures and World (dimensions, structures, biomes, zones and trades), with a searchable overview of everything the stage gates. Lay it on a lectern and it stays there to be read by anyone who walks up.
Set it to Visible and it reads as a plain record; set it to Obscured and locked entries become silhouettes with their names written in enchanting glyphs. Chapters and overview blocks are re-orderable, so the document says exactly what you want it to say.
***
πΊοΈ Stage Graph
A progression map players can open from the pause menu: stages as nodes, dependencies as edges, colour-coded into Unlocked, Reachable and Locked.
Highlights
From source dataGame versions
Supports 7 Minecraft versions, the newest being 1.21.1.
Loaders
Runs on Fabric, Forge and NeoForge.
Footprint
Rated a light load on a server.
History Stages on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Fabric, Forge, NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft β 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 6.1.0-1.21.1, released 2026-10-16
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Fabric | 1.21 to 1.21.1 (2 versions) | 1.21.1 |
| Forge | 1.20 to 1.20.1 (2 versions) | 1.20.1 |
| NeoForge | 1.21 to 1.21.1 (2 versions) | 1.21.1 |
From 5 recorded builds of History Stages.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 6.1.0-1.21.1 | 2026-10-16 | 1.21 to 1.21.1 (2 versions) | NeoForge |
| 6.0.2-1.20.1 | 2026-09-28 | 1.20 to 1.20.1 (2 versions) | Forge |
| 6.0.2-1.21.1 | 2026-09-28 | 1.21 to 1.21.1 (2 versions) | NeoForge |
| 6.0.0-1.21.1-fabric | 2026-09-23 | 1.21 to 1.21.1 (2 versions) | Fabric |
| 6.0.0-1.20.1 | 2026-09-19 | 1.20 to 1.20.1 (2 versions) | Forge |
Dependencies
- Required: modrinth project EltpO5cN (modrinth, not in our catalogue)
- Optional: modrinth project u6dRKJwZ (modrinth, not in our catalogue)
- Optional: modrinth project nvQzSEkH (modrinth, not in our catalogue)
- Optional: modrinth project fRiHVvU7 (modrinth, not in our catalogue)
- Optional: modrinth project 61MzPlJU (modrinth, not in our catalogue)
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run History Stages on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogCreatures & NPCs
Adds or changes creatures, NPCs and how they behave.
Runs on your server
From source side supportModrinth lists History Stages as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- FabricForgeNeoForge
- Runs on
- Serverrequired on the server
- Game versions
- 1.21.1 and 6 earlier
Verified at the source
- βModrinthOfficial listing, checked 2026-10-16Open β
- βAuthorBananemdnsa, as published on Modrinth
- βLicenseLicenseRef-History-Stages-Custom-LicenseFree












