History Stages
Modpack creators know the struggle: you have a vision for a curated, story-driven experience, but the base game hands players every tool, weapon, and dimension from the very first minute. The History Stages mod for Minecraft is the definitive answer to that problem. It is a comprehensive progression and gatekeeping system that transforms your pack from a sandbox into a structured journey. Instead of simply hiding recipes, this mod allows you to lock almost every aspect of the game behind custom "eras" or stages, which players must unlock through research, exploration, quests, or commands. It is not just a restriction tool; it is a storytelling engine that puts the modpack author in complete control of pacing.
This article explores the deep feature set of History Stages, explaining how it works, what you can lock, and how to tailor the unlock conditions to fit your pack's theme. We will cover the research system, the in-game editor, and the performance of the mod across different loaders. By the end, you will understand why this is a must-have tool for any serious modpack developer looking to create a memorable and balanced player journey.
What Can You Lock with History Stages?
The scope of this mod is staggering. It goes far beyond the typical "item blacklist" found in other gatekeeping mods. With History Stages, you can lock nearly every interactive element in the game, allowing for a truly holistic progression system.
- Items and Tags: Lock specific items or entire tags, with support for complex NBT criteria to differentiate between similar items.
- Recipes and Mods: Hide specific crafting recipes or gate entire mods behind a stage, preventing players from using any of their content until unlocked.
- World Interaction: Lock dimensions, structures, and biomes. You can even apply force-field zones that damage players, apply potion effects, and show a red screen overlay when they enter restricted areas.
- World Generation: Prevent locked structures from generating entirely, or cap how many can generate in the world, both before and after the stage is unlocked.
- Mobs and Entities: Use spawnlock, attacklock, and interaction lock to prevent players from breeding, mounting, trading, shearing, or even naming specific mobs. These can be toggled per entry and filtered by the item the player is holding.
- Loot and Blocks: Remove or replace items from chests and mob drops. Lock block breaking, GUI access, and container interaction.
- Enchantments and Displays: Prevent enchanting at tables and anvils, and protect armor stands and item frames from having locked items removed.
Furthermore, locked items can have their names and tooltips hidden or replaced with custom text. The unlock_actions feature allows you to permit specific interactions, like picking up an item or crafting, while keeping everything else locked. This granularity ensures that your progression rules are always clear and consistently enforced.
Unlock Mechanics: Choose Your Progression Path
History Stages doesn't force a single progression style. Instead, it offers several distinct unlock modes that can be mixed and matched within the same pack. This flexibility is what makes it suitable for any genre, from hardcore survival to quest-driven RPGs.
Research, Auto, External, and Temporary Modes
Each stage has a mode that defines how it is unlocked. The Default mode uses the classic research system, where players bring Research Scrolls to a Research Pedestal. The Auto mode unlocks stages via in-game triggers, such as picking up an item, entering a biome, killing an entity, or reaching a playtime milestone. The External mode restricts unlocking to commands, KubeJS/CraftTweaker scripts, or FTB Quests rewards. Finally, the Temporary mode unlocks and re-locks stages on a timer, complete with cooldowns and trigger limits.
You can mix all of these modes freely. For example, a pack might have an "Era of Discovery" that unlocks automatically when the player first mines iron, while the next era requires a quest reward. Individual stages can also be set to be lost on death, dropping the items they gated and adding a hardcore twist to the progression.
The Research System and the Research Record
For packs that prefer a physical, in-world progression mechanic, the Research System is a standout feature. Players physically bring Research Scrolls to a Research Pedestal and must spend time researching the next era. There are four pedestal tiers, placeable Research Boosters, and per-stage research times to tune the pacing. The Dependency System adds another layer, allowing you to require XP levels, mob kills, advancements, or specific items deposited into the pedestal.
Once research is complete, the scroll can be consumed, replaced, or opened as a readable keepsake. This Research Record is a real, in-game document with chapters for Items, Creatures, and World. It can be placed on a lectern for all players to read, offering a searchable overview of everything the stage gates. In "Obscured" mode, locked entries appear as silhouettes with enchanting glyphs, adding a layer of mystery and lore to the pack.
Visualizing Progression and Editing in-Game
Keeping players informed is crucial in a gated pack. History Stages provides a Stage Graph, a progression map accessible from the pause menu. It displays stages as nodes and dependencies as edges, color-coded into Unlocked, Reachable, and Locked states. You can choose from four visibility modes to control how much of the pack's structure players see. The graph is hand-authorable, allowing you to drag nodes to create the perfect layout, and supports per-stage node styles for clear visual distinction.
For pack authors, the In-Game Editor is a godsend. You can build and tweak your entire stage setup without touching a single config file. It features searchable multi-select lists, folders for organizing stages, and a drag-and-drop organize mode. Dedicated editors for Dependencies, NBT, and Lock-Actions allow for precise control, and you can even Ctrl-click any inventory slot to import its NBT data. This makes the creation process intuitive and iterative, allowing for rapid testing and balancing.
Compatibility, Installation, and Community Feedback
History Stages is available for several versions and loaders. The latest features are found on Minecraft 1.20.1 (Forge) and 1.21.1 (NeoForge). There is also a Fabric version for 1.21.1, though it is currently a few versions behind in features. A legacy 1.19.2 Forge build exists but is no longer updated. The mod requires the Lootr mod as a dependency, as its loot filtering is built on Lootr's container system. Optional integrations include JEI, EMI, FTB Quests, Jade, Curios, and Accessories.
Players looking to download History Stages should ensure they have the correct loader and base version installed. The installation process is standard for modded Minecraft: drop the mod file into the mods folder and launch the game. For those using a launcher, the process is equally simple. For example, the foxygame.net launcher offers a one-click install feature for modpacks, automatically handling dependencies and version compatibility, which makes adding History Stages for Minecraft to a custom pack significantly easier. This allows creators to focus on game design rather than troubleshooting load order.
For those wondering how to install the mod manually, the process is straightforward. First, download the correct version of the mod file from a trusted source. Then, navigate to your Minecraft directory, open the "mods" folder, and place the downloaded file inside. Finally, launch the game using your chosen loader. Once in-game, you can verify the mod is working by checking the mod list in the main menu.
The mod ships without default recipes for the Pedestal, Boosters, and Scrolls, intentionally. This forces pack authors to decide how players obtain these crucial items, whether through KubeJS, datapacks, or quest rewards. This design philosophy extends to the community support, with a dedicated Wiki, Discord server, and Issue Tracker available for users. The developers are active and responsive, ensuring that History Stages remains a robust and evolving tool for the modding community. It is more than just a mod; it is a framework for creating unforgettable, structured adventures in Minecraft.
--- **Update Sep 12, 2026:** Added 1 file for version 1.20.1, 1.20 (Forge).