Перейти к содержимому
Mineforgian

History Stages

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.

Загрузки
4K
Подписчики
43
Обновлён
19 августа 2026 г.
Лицензия
History-Stages-Custom-License

Опубликован 22 февраля 2026 г.

Исходный кодСообщить об ошибке

  • 📖 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, 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, Recipes
  • Dimensions, Structures & Biomes — with force-field zones, damage, potion effects & a red screen overlay
  • 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 — spawnlock, attacklock & interaction lock: breeding, mounting, trading, leashing, shearing, milking, naming and equipping, each toggleable per entry and filterable by held item
  • 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) 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/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, or items 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), 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.

  • Four visibility modes — from the whole map down to unlocked only, so you decide how much of the pack's structure players get to see
  • Hand-authorable — drag nodes where you want them, or leave the layout to compute itself
  • Per-stage node styles — fill, border, label colour and corner radius, each editable per lock state
  • Info texts & a detail window — describe an era and show exactly what it requires and what it unlocks

It's off by default (the map reveals how a pack is built); admins always reach it through the editor. Colours, title and layout live in a Graph tab in the in-game config editor.

🛠️ In-Game Editor

Build and tweak your entire stage setup without ever touching a config file — straight from the pause menu (OP required):

  • Searchable multi-select lists, folders for your stages and an organize mode to drag them around
  • Dedicated editors for Dependencies, NBT & Lock-Actions — Ctrl-click any inventory slot to import its NBT
  • Unlock or re-lock individual stages per player right from the overview
  • Design the Research Scroll tooltip line by line, with colours and a live preview
  • Overlap warnings between global & individual stages, plus a full in-game config editor

🎨 Feedback & Integrations

Players always know why something is locked: lock icons in inventories and JEI/EMI, "Locked" recipe overlays, toasts with custom per-stage icons, and configurable actionbar/chat messages.

  • FTB Quests — native stage task & reward types (global + individual)
  • KubeJS / CraftTweaker — StageEvent.Unlocked / Locked events
  • Jade, Curios & Accessories support

📂 Creating Stages

Use the in-game editor, or write simple JSONs in config/historystages/global/ and individual/ — subfolders are picked up, so a big pack stays sorted. Full field reference: Stage Configuration.

The mod intentionally ships without default recipes for the Pedestal, Boosters & Scrolls — you decide how players obtain them (KubeJS, datapack, quest rewards, …). Give a scroll via:

/give @s historystages:research_scroll{StageResearch:"YOUR_STAGE_NAME"}

📦 Dependencies

  • Lootr — required
  • Optional: JEI, EMI, FTB Quests, Jade, Curios, Accessories

❓ FAQ

Can stages be unlocked per player instead of server-wide?

Yes — global, individual, or both mixed in the same pack (overlaps become Dual-Phase locks).

Is Lootr really required?

Yes, loot filtering is built on Lootr's container system. Without loot locking it just sits there quietly.

Do I need FTB Quests?

No — the integration only activates when it's installed.

Which versions are supported?
  • 1.20.1 — Forge (latest features)
  • 1.21.1 — NeoForge (latest features)
  • 1.21.1 — Fabric (currently a few versions behind)
  • 1.19.2 — Forge (legacy, no longer updated)

Questions or found a bug? Join the Discord or open an issue — we read everything! 🙂

Ченджлог

5.6.0-1.20.1Релиз1.20, 1.20.1 · 19 августа 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.5.1-1.20.1...5.6.0-1.20.1

New

  • Stages: Added folder support for stage JSON files, with a matching organize mode in the editor for moving stages and folders around.
  • Graph: Rebuilt the dependency graph as a hand-authorable stage map and opened it to players in-game, with a reworked sidebar, a detail window instead of the old panel, a GraphViewFilter visibility ladder, a strict progressive mode with per-option tooltips, per-stage node style overrides editable per lock state, and a screen title that can be written as rich text.
  • Config: Added a Graph tab to the config editor for editing graph.toml directly.
  • Locks: Added biome and interaction lock categories, the latter with per-action and held-item filters. Locked structures are now kept out of world generation, and structures can be capped on how often they generate.
  • Stages: Added a lose-on-death setting and per-player unlocking of individual stages from the overview.
  • Editor: Added a classic HSV colour picker with fixed swatches and hover animation, a credits dialog with wiki/Discord/issue links, a display-name prompt when creating a stage, select-all/deselect-all and multiselect for searchable lists, and a time-based animation system with general UI polish. Save now stays on the current screen and persists the whole stage.
  • Pedestal/Scroll: Reworked the research screen with scroll completion modes, a readable open scroll document, and the ability to read open scrolls from a lectern. The research scroll tooltip is now configurable.

Fixes

  • Pedestal: The XP deposit button now shows why it does nothing when you cannot pay the level cost, instead of silently swallowing every click.
  • Pedestal: Dependency status is sent to the requesting player only; nearby clients no longer cache someone else's progress.
  • Pedestal: The wash over a running research scroll now draws over the item icon instead of behind it.
  • Editor: Stopped large stages from crashing the save, made searchable lists usable at a few thousand rows, and fixed config/item pickers leaking through their overlay. The editor now refreshes when the server pushes config, dependency/temporary badges show correctly on individual rows again, and the unsaved-changes warning actually discards on confirm.
  • Config: Synced every common config value to clients.
  • Locks: Item locks are now looked up through a stage index for better performance. The recipe lock overlay shows for individual stages, hidden_display applies to individual stages, and show_lock_hints works independently of tooltip mode.
  • Loot: Honored individual stages when stripping loot.
5.6.1-1.21.1Релиз1.21, 1.21.1 · 12 августа 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.6.0-1.21.1...5.6.1-1.21.1

Fixes

  • Network: Fixed dedicated servers refusing to start with "Attempted to load class net/minecraft/client/gui/screens/Screen for invalid dist DEDICATED_SERVER". The lectern scroll packet added in 5.6.0 referenced a client-only screen class, which broke mod loading while payload handlers were registered.
5.6.0-1.21.1Бета1.21, 1.21.1 · 12 августа 2026 г.

What's Changed

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.5.1-1.21.1...5.6.0-1.21.1

New

  • Stages: Added folder support for stage JSON files, with a matching organize mode in the editor for moving stages and folders around.
  • Graph: Rebuilt the dependency graph as a hand-authorable stage map and opened it to players in-game, with a reworked sidebar, a detail window instead of the old panel, a GraphViewFilter visibility ladder, a strict progressive mode with per-option tooltips, and per-stage node style overrides editable per lock state.
  • Config: Added a Graph tab to the config editor for editing graph.toml directly.
  • Locks: Added biome and interaction lock categories, the latter with per-action and held-item filters. Locked structures are now kept out of world generation, and structures can be capped on how often they generate.
  • Stages: Added a lose-on-death setting and per-player unlocking of individual stages from the overview.
  • Editor: Added a classic HSV colour picker with fixed swatches and hover animation, a credits dialog with wiki/Discord/issue links, a display-name prompt when creating a stage, select-all/deselect-all and multiselect for searchable lists, and a time-based animation system with general UI polish. Save now stays on the current screen and persists the whole stage.
  • Pedestal/Scroll: Reworked the research screen with scroll completion modes, a readable open scroll document, and the ability to read open scrolls from a lectern. The research scroll tooltip is now configurable.

Fixes

  • Editor: Stopped large stages from crashing the save, made searchable lists usable at a few thousand rows, and fixed config/item pickers leaking through their overlay. The editor now refreshes when the server pushes config, and dependency/temporary badges show correctly on individual rows again.
  • Config: Synced every common config value to clients.
  • Locks: Item locks are now looked up through a stage index for better performance. The recipe lock overlay shows for individual stages, hidden_display applies to individual stages, and show_lock_hints works independently of tooltip mode.
  • Loot: Honored individual stages when stripping loot.
  • Logger: Reports lose_on_death in the diagnostic stage dump.
5.5.1-1.20.1Релиз1.20, 1.20.1 · 17 июля 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.5.0-1.20.1...5.5.1-1.20.1

Fixes

  • Compat: Fixed startup crash with the latest Better Combat (1.9.0) on Forge 1.20.1.
5.5.0-1.20.1Релиз1.20, 1.20.1 · 15 июля 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.4.0-1.20.1...5.5.0-1.20.1

New

  • Compat: Locked items are now inert vs Spell Engine & Better Combat (#87).
  • EMI: Brought EMI integration up to the same level as JEI.
  • FTB Quests: Replaced stage cycling button with a searchable picker screen.
  • Locks: Added NBT criterion to tag locks (#84).
  • Stages: Added ability to hide or replace display names and tooltips of locked items.
  • Editor: Added dependency graph viewer.
  • Editor: Widgets and buttons now grow to fit long translations.
  • I18n: Made hardcoded player-facing text translatable.
  • Stages: Added temporary stage mode with auto re-lock timer.
  • Stages: Added AUTO stage mode and auto-trigger system (#80).
  • Editor: Added multi-select to entity picker.
  • Spawnlock: Added per-dimension filter for spawn-locked entities.
  • Stages: Added scoreboard objective dependency.
  • Pedestal: Added config to lock scroll in pedestal while researching.
  • Pedestal: Comparator output now reflects research progress (0-15).

Fixes

  • Toasts: Stack variable-height notifications without overlap.
  • Research: Gate isItemNeeded deposit timer by NBT criterion.
  • Locks: Split place/use gating and block copycat material application (#81, #85).
  • Research: Gate dependency item deposits by NBT criterion.
  • Pedestal: Orient tier 2 pedestal to player facing on placement.
5.5.1-1.21.1Релиз1.21, 1.21.1 · 2 июля 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.5.0-1.21.1...5.5.1-1.21.1

New

  • Editor widgets and buttons now auto-grow to fit long translations, preventing overflow in languages like Russian.

Fixes

  • Fixed registry-backed components (e.g., Iron's Jewelry stored_pattern) failing to encode, which broke item matching.
  • Gated Copycats+ material application by "use" instead of "place" to correctly respect item locks.
  • Fixed structure locks in individual stages not activating or invalidating cache properly.
5.5.0-1.21.1Релиз1.21, 1.21.1 · 26 июня 2026 г.

What's Changed

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.4.0-1.21.1...5.5.0-1.21.1

New

  • FTB Quests: Replaced stage cycling button with searchable picker screen.
  • Locks: Added NBT/component criterion to tag locks.
  • Spawnlock: Added per-dimension filter for spawn-locked entities.
  • Editor: Added multi-select to entity picker.
  • I18n: Made hardcoded player-facing text translatable.
  • Compatibility: Locked items are now inert against Spell Engine & Better Combat.
  • Editor: Added dependency graph viewer.
  • Stages: Added option to hide or replace locked item names & tooltips.
  • EMI: Brought integration up to parity with JEI.
  • Stages: Added temporary stage mode with an auto re-lock timer.
  • Stages: Added scoreboard objective dependency.
  • Pedestal: Comparator output reflects research progress (0-15).

Fixes

  • Research: Gated dependency item deposits by NBT criterion.
  • Pedestal: Fixed tier 2 pedestal orientation on placement.
  • Editor: Accepts non-object component values in NBT editor.
  • Lock: Only blocks placement on "place" lock, not "use".
  • Compatibility: Blocked locked items on Create: Copycats+ blocks.
  • Toasts: Stack variable-height notifications without overlap.
  • Stages: Recognized min_pedestal_tier and pedestal_tier_mode as known keys.
5.4.0-1.20.1Релиз1.20, 1.20.1 · 8 июня 2026 г.

Full Changelog: https://github.com/Flix100000/History-Stages/compare/5.3.1-1.20.1...5.4.0-1.20.1

New

  • Added Tier II, III, and IV variants for the Research Pedestal (Tier 3/4 are 2-wide multiblocks).
  • Added Research Boosters that can be placed under a Research Pedestal to increase research speed and reduce costs.
  • Added tier gating for stages and boosters, requiring a minimum pedestal tier for certain research.
  • Added optional client config to hide locked items and recipes in JEI (hideLockedItemsInJei, hideLockedRecipesInJei).
  • Added a toggle button in the editor for the lockedItemMultiStagePolicy (STRICT/LENIENT).
  • Added the ability to Ctrl-click an inventory slot in the editor to import its NBT data for criteria creation.
  • Added styled toast notifications for editor actions, replacing chat-spam feedback.
  • Moved the add button in the editor to a fixed center position and added an empty-state hint.

Fixes

  • Fixed a ConcurrentModificationException on the render thread by using ConcurrentHashMap for stage management.
  • Removed a stray debug print statement in RecipeManagerMixin.

Комментарии

Загружаем…