ProgressiveStages

# ProgressiveStages 3.0 > 🧭 **Build complete Minecraft progression systems through an in-game editor—then let ProgressiveStages enforce them everywhere.** (https://img.shields.io/badge/Minecraft-1.21.1-62B47A)](https://www.minecraft.net/) (https://img.shields.io/badge/Loader-NeoForge-E78A3A)](https://neoforged.net/) (https://img.shields.io/badge/Download-CurseForge-F16436)](https://www.curseforge.com/minecraft/mc-mods/progressivestages) (https://img.shields.io/badge/Download-Modrinth-00AF5C)](https://modrinth.com/mod/progressivestages) (https://img.shields.io/badge/Community-Discord-5865F2)](https://discord.com/invite/9v4gaRSfdJ) ## ✨ Create your progression in-game Run **`/pstages editor`** to open the ProgressiveStages editor GUI. Create, edit, organize, and configure your stages without needing to build every TOML file by hand. Design the progression your pack needs, connect its dependencies, configure its locks and unlock conditions, customize how it looks, and then test it in-game. ProgressiveStages is not simply an item-locking mod. It is a complete progression-authoring platform that lets modpack creators decide **what players can use, where they can travel, what they must accomplish, how progression is shared, what happens when a stage is earned or lost, and how the entire journey is presented in-game**. Every stage is defined in a readable TOML file. A stage can represent almost anything: an age, chapter, skill, class, research topic, quest milestone, boss tier, dimension, technology branch, magic school, server event, temporary blessing, punishment, or purchasable upgrade. ### 🌟 Build practically any kind of progression - A simple `Stone Age → Iron Age → Diamond Age` progression. - Several independent technology, exploration, farming, and magic branches. - A large quest-driven modpack with hundreds of interconnected milestones. - RPG-style skill trees with costs, prerequisites, attributes, rewards, and refunds. - Team progression with FTB Teams or world-wide server milestones. - Secret paths that remain hidden until the player discovers their prerequisites. - Temporary challenge stages that expire, disappear on death, or require maintained XP. - Fully scripted progression using KubeJS and the Java API. ProgressiveStages itself does not require a quest mod, recipe viewer, team mod, scripting mod, or overlay mod. Every integration is optional and activates only when its related mod is installed. > 🛡️ **Server authoritative:** the server owns stage progress, grants, revocations, dependencies, costs, and enforcement. A modified client cannot give itself stages, fake a purchase, or bypass progression rules. --- ## 🌳 What progression can look like Progression can be linear: ```text 🪨 Stone Age └── 🔩 Iron Age └── 💎 Diamond Age └── ⚔️ Netherite Age ``` It can branch into different playstyles and later converge: ```text 🌱 Survival Basics └── 🔩 Iron Age ├── ⚙️ Engineering ──────┐ │ └── 🏭 Advanced Tech │ ├── 🔮 Arcane Studies ───┼──▶ 👑 Endgame │ └── 🪄 Master Sorcery│ └── 🧭 Exploration ──────┘ └── 🌌 Outer Realms ``` Dependencies support `all`, `any`, and counted satisfaction. That means an endgame stage can require every branch, any one specialization, or a configurable number of paths. ```text 🎯 Choose a Specialization ├── ⚙️ Technology ─┐ ├── 🔮 Magic ──────┼──▶ 🏆 Mastery (complete any 2 paths) └── ⚔️ Combat ─────┘ ``` Stages may also be completely independent. A server can have a main story tree, optional skill trees, temporary events, and hidden secrets at the same time. --- ## 🗺️ The player progression map Open the map with `/stage`, `/stages`, `/ps`, `/stage gui`, or a configurable keybind. The 3.0 map is modeled after Minecraft's advancement screen while remaining fully controlled by the pack author: - Familiar vanilla task, goal, and challenge frames. - A draggable, wheel-scrollable dependency graph. - Automatic graph layout when coordinates are omitted. - Exact `x` and `y` placement when a hand-authored layout is preferred. - Dependency connectors that make branches and convergence easy to understand. - Hover cards with descriptions, dependencies, trigger progress, and unlock previews. - Click-to-pin detail panels for longer information. - Search by name, ID, description, category, or locked item. - A toggle to hide stages the player already owns. - Per-stage icons, colors, categories, backgrounds, frames, and sort order. - Server-validated stage purchases directly from the map. - Live progress for automatic trigger conditions. - Unknown icons, concealed names, and spoiler-safe descriptions. Authors decide when a node becomes visible with `.reveal`: | Reveal mode | Behavior | | --- | --- | | `always` | The stage is always visible. | | `dependencies` | The stage appears when its prerequisite path becomes relevant. | | `unlocked` | The s