![](https://cdn.modrinth.com/data/cached_images/48b3f8553305ae3ee283e30b80d4b24f055cd2cd.png) **History Stages** is a comprehensive progression and gatekeeping mod for Minecraft. It empowers modpack creators to lock items, recipes, dimensions, mobs, and even entire mod content behind custom "Stages" (Eras). Players must use the **Research Pedestal** to unlock these stages and advance their technological level. --- ## 🛠 Features * **Gated Progression:** Lock items, tags, or entire mods behind specific research stages. * **Recipe Locking:** Hide specific crafting recipes from crafting menus by recipe ID. * **Dimension Locks:** Prevent players from entering specific dimensions (Nether, End, etc.) until they have the required knowledge. * **Mob Control:** Two distinct lock modes for entities: * **Attacklock:** Prevent players from damaging specific mobs until the required stage is unlocked. * **Spawnlock:** Prevent entities from spawning entirely while the stage is locked (covers natural spawning, spawners, and commands). Spawnlocked entities are automatically also attacklocked. * **Smart Loot Filtering:** Locked items are automatically removed from loot chests or replaced with configurable items. * **Locked Mob Drops:** Locked items are removed from mob drops as well. * **Lock Icon Overlay:** Locked items show a lock icon in inventories and JEI (auto-disabled with EMI). * **Research Pedestal:** A functional block with a dedicated UI for unlocking stages using Research Scrolls. Each stage can have its own configurable research time. * **In-Game Stage Editor:** Create, edit, duplicate, and delete stages directly in-game — no need to leave the game or manually edit JSON files. Includes searchable lists for items, recipes, entities, dimensions, tags, and mods. Accessible via a button in the **pause menu** (OP required). * **In-Game Config Editor:** Modify all mod settings from within the game with organized categories and reset-to-defaults. Accessible through the stage editor. * **Debug Logging:** Configurable debug log system for troubleshooting config validation and stage loading issues. * **Toast Notifications:** An advancement-style popup is shown to all players when a stage is unlocked. * **JEI and EMI Integration:** Locked items can be hidden or marked in Just Enough Items and EMI. * **Forge Events:** Fires `StageEvent.Unlocked` and `StageEvent.Locked` events for KubeJS, CraftTweaker, and other mod integrations. * **Localization:** English and German translations included. --- ## 📘 Obtaining Research Scrolls To maintain maximum flexibility for modpack creators, **this mod does not include default crafting recipes** for the Research Pedestal or the Research Scrolls. If you want players to be able to craft these items, you must add your own recipes using: * **[KubeJS](https://modrinth.com/mod/kubejs)** * **[CraftTweaker](https://modrinth.com/mod/crafttweaker)** * Or a standard **Datapack**. ### Obtaining Scrolls via Command You can give specific Research Scrolls to players (e.g., as quest rewards) using this command: ``` /give @s historystages:research_scroll{StageResearch:"YOUR_STAGE_NAME"} ``` > **Note:** Replace `YOUR_STAGE_NAME` with the exact ID of your stage (the filename of your JSON). ---

📂 How to Create Stages (Click to expand)

The easiest way to create and manage stages is the **in-game stage editor**. It lets you create, edit, duplicate, and delete stages with a full GUI — no file editing required. Alternatively, stages can be defined manually via JSON files located in `config/historystages/`. 1. Run the game once to generate the directory. 2. Create a new `.json` file (e.g., `bronze_age.json`). 3. Use the following format: ```json { "display_name": "Bronze Age", "research_time": 60, "items": [ "minecraft:iron_ingot", "minecraft:iron_pickaxe" ], "tags": [ "forge:ores/iron" ], "mods": [ "mekanism" ], "recipes": [ "minecraft:iron_pickaxe" ], "dimensions": [ "minecraft:the_nether" ], "entities": { "attacklock": [ "minecraft:zombie" ], "spawnlock": [ "minecraft:skeleton" ] } } ``` **Fields:** - **display_name:** Human-readable name shown in messages and tooltips. - **research_time:** *(Optional)* Research duration in seconds for this stage. If omitted or 0, uses the global config default. - **items:** List of item IDs to lock. - **tags:** List of item tags to lock. - **mods:** List of mod IDs to lock all items from. - **recipes:** List of recipe IDs to hide from crafting menus. - **dimensions:** List of dimension IDs to block access to. - **entities:** Object with two subcategories: - **attacklock:** Entities that cannot be attacked by players while the stage is locked. - **spawnlock:** Entities that are prevented from spawning entirely (natural, spawners, and commands). Spawnlocked entities are also automatically attacklocked. *Note: Files starting with an underscore (`_`) are ignored and can be used as templates.* > ⚠️ **Breaking Change in 2.0.0:** The old flat `entities` list format (`"entities": ["minecraft:zombie"]`) is no longer supported. You must update your stage files to the new nested format shown above.

⌨️ Admin Commands (Click to expand)

🔧 Forge Events for Mod/Script Authors (Click to expand)

History Stages fires custom Forge events on the EVENT_BUS: - **StageEvent.Unlocked** — Fired after a stage is unlocked (via command or Research Pedestal). - **StageEvent.Locked** — Fired after a stage is locked (via command). Both events provide `getStageId()` and `getDisplayName()`. **KubeJS Example:** ```js ForgeEvents.onEvent( 'net.bananemdnsa.historystages.events.StageEvent$Unlocked', event => { console.log('Stage unlocked: ' + event.getStageId()); } ); ```

--- ## 📦 Dependencies - **Required:** [Lootr](https://modrinth.com/mod/lootr) - **Optional:** [JEI](https://modrinth.com/mod/jei) - **Optional:** [EMI](https://modrinth.com/mod/emi) --- ## ⚙️ Configuration The mod is highly customizable via `historystages-common.toml` and `historystages-client.toml`, or directly through the **in-game config editor**. You can toggle: * Toast popup notifications, achievement sounds, and actionbar messages. * Customizable unlock message format with color codes. * How loot replacement behaves (replacement list, tag-based replacement, or deletion). * Lock icon overlays on locked items. * Tooltip display options (show stage names, show all required stages). * Dimension and mob lock feedback (actionbar and/or chat messages). * Debug messages to help find errors in your JSON files. * Default research time as a global fallback. * And more... --- ⚠️ **Note: This mod is currently in active development. Bugs may occur. Please report any issues to help improve the mod.**

PixlStudios

Cyberpunk Samurai

Organizations