ProgressiveStages

Looking for Beta Testers and bugs and issues. Report on discord or github.

🔒 What is ProgressiveStages?
ProgressiveStages is a powerful progression control mod for NeoForge 1.21.1 that lets modpack developers create true stage-gated gameplay. Lock items, recipes, blocks, dimensions, and even entire mods behind progression milestones. Players must unlock stages through exploration, quests, or custom conditions before accessing locked content—no more skipping ahead or bypassing your carefully crafted progression!

Perfect for expert modpacks, skyblock-style challenges, or any pack where you want players to earn their way through content tiers.

✨ Core Features

• Comprehensive Locking System
• Items - Block use, pickup, and inventory holding
• Recipes - Hide crafting outputs until unlocked
• Blocks - Prevent placement and interaction
• Dimensions - Gate portal travel to other dimensions
• Entire Mods - Lock all content from a mod namespace
• Name Matching - Lock anything with "diamond" in its ID (case-insensitive)
• Interactions - Gate Create-style item-on-block interactions

EMI Integration

• 🔒 Visual lock icons on locked items in search and recipes
• Orange overlays on locked recipe outputs
• Detailed tooltips showing required stage and progress (e.g., "Iron Age 2/5")
• Hide locked recipes entirely (optional)
• Item name masking - locked items show as "Unknown Item" until unlocked
• Team Progression (FTB Teams)
• Team-scoped stages - teams progress together
• Complex catch-up logic - higher-stage players can join lower teams without boosting them
• Synchronized unlocks - when one member unlocks a stage, the whole team gets it
• Stage matching rules - lower-stage players must match team's stage to join

Pack Developer Tools

• TOML-based configuration - easy-to-edit stage files
• Auto-generated examples - stone_age, iron_age, diamond_age files created on first run
• Live reload - /progressivestages reload applies changes without restart
• Validation command - catch invalid items/blocks before testing
• Unlock messages - send formatted chat messages when stages unlock
• Prerequisite stages - /stage grant diamond_age auto-grants iron and stone ages

Highly Configurable

• Toggle any enforcement type (items, recipes, blocks, etc.)
• Creative mode bypass option
• Customizable EMI visuals (icon size, overlay color, tooltip format)
• Notification cooldowns (prevent chat spam)
• Debug logging for troubleshooting

Player Commands:
/stage list - View your unlocked stages
/stage check - Check if you have a specific stage

Admin Commands:
/stage grant - Grant a stage (auto-grants prerequisites)
/stage revoke - Revoke a stage
/progressivestages reload - Reload stage files without restart
/progressivestages validate - Check stage files for errors