Getting Started with History Stages

History Stages is a versatile progression and gatekeeping mod for Minecraft on Forge, NeoForge, and Fabric platforms. This document outlines the installation process and initial steps for creating stages.

Installation

To integrate History Stages into a modpack, the following dependencies are required:

• Required: Lootr (CurseForge: Lootr). Lootr is necessary for the correct handling of locked chest contents in multiplayer environments.
• Recommended:
  • JEI (Just Enough Items) or EMI (Everything Modded Items) for visual recipe overlays. These mods display locked recipes with a "Locked" indicator.
  • Jade (CurseForge: Jade) for enhanced in-game tooltips. Jade displays required stage information when players look at locked blocks, entities, armor stands, or item frames.

Creating Stages

Stages can be defined and managed using two methods:

1. In-Game Editor (Recommended for Modpack Creators): This graphical interface allows for the creation, modification, duplication, and deletion of stages directly within Minecraft. It includes searchable lists for items, recipes, entities, and dimensions, as well as a visual NBT editor for advanced item locking. The editor is accessible via a dedicated button in the pause menu (requires OP permissions).
2. Manual JSON Configuration: Stages can be defined by creating .json files in specific directories after the game has been run once with History Stages installed:
   • Global Stages: Files are placed in config/historystages/global/. These stages apply to all players on the server.
   • Individual Stages: Files are placed in config/historystages/individual/. These stages track progression on a per-player basis.

Example Stage Configuration (JSON)

An example of a basic "Bronze Age" stage that locks iron-related content:

{
  "display_name": "Bronze Age",
  "research_time": 60,
  "items": ["minecraft:iron_ingot"],
  "tags": ["forge:ores/iron"],
  "recipes": ["minecraft:iron_pickaxe"]
}

Upon loading and activation, players will be prevented from using or accessing iron ingots and crafting iron pickaxes until the "Bronze Age" stage is unlocked.

Research Pedestal and Scroll Recipes

History Stages does not include default crafting recipes for the Research Pedestal or Research Scrolls. Modpack creators are responsible for defining how these items are acquired within their modpack. This can be achieved using:

• KubeJS
• CraftTweaker
• Datapacks
• FTB Quests rewards