Item Stages
by Darkhax
Item Stages lets server owners lock items behind a stage, so players cannot use an item until the stage is granted.
What it does
A stage is a named flag on a player. Items can be marked as restricted for a given stage, and until that stage is reached the item cannot be used. Holding a restricted item causes it to be dropped right away, and equipping one in the offhand or an armor or bauble slot drops it as well. Right-clicking or left-clicking with a restricted item has no effect while the stage is missing.
The mod is built around configuration rather than in-game commands. Its restriction rules are written with CraftTweaker, so pack makers can define which items belong to which stage and how access is granted. A restricted item shows a tooltip that states the restriction instead of its usual description, and restricted items still appear in JEI, so players can see what exists and what it requires.
Item Stages is a Library mod for Forge, and it runs on client and server, so both sides need it. Files cover 9 release versions 1.12.2 – 1.20.3, and the latest Forge file is 8.0.3 for 1.20.1. The code is released under the GNU Lesser General Public License v2.1 only and is open source, with public source code and an issue tracker.
Key features
Stage-locked items
Any item can be assigned to a stage, and the stage must be reached before the item can be used.
Immediate drop on hold
A restricted item held in the hand is dropped at once, so it cannot be carried around before its stage is granted.
Offhand and armor blocking
Restricted items placed in the offhand, armor or bauble slots are dropped, which closes off equipment-based workarounds.
Restricted tooltip
A locked item displays a message explaining the restriction in place of its normal tooltip.
JEI visibility
Restricted items remain visible in JEI, so players can look up how to obtain them.
CraftTweaker configuration
Restrictions and stage assignments are set through CraftTweaker scripts, which suit modpack configuration.
Compatibility
Latest build for each game version and loader.
1.20.x4 of 4 versions with builds
1.19.x2 of 2 versions with builds
1.18.x1 of 1 version with builds
1.16.x1 of 1 version with builds
1.12.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Recipe Stages is a Forge mod for 1.12 – 1.20.1 that runs on client and server and is released under the MIT License, so it is open source. The One Prode Stage is server-side only, covers 1.16.5 – 1.20.1 on Forge and is also open source under the GNU Lesser General Public License v2.1 only. GroovyStages is a client and server mod for 1.12.2 under a custom license that is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Item Stages | Forge | 1.12.2 – 1.20.3 | Client and server | 2024-03-26 |
| Recipe Stages | Forge | 1.12 – 1.20.1 | Client and server | 2024-03-11 |
| The One Prode Stage | Forge | 1.16.5 – 1.20.1 | Server-side only | 2024-09-09 |
| GroovyStages | Forge | 1.12.2 | Client and server | 2026-08-01 |
Questions
Does Item Stages require CraftTweaker?
Does Item Stages have to be installed on both sides?
Which game versions does Item Stages support?
In the catalog
Item Stages is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 10,115 mods support Minecraft 1.20.3.
More from Darkhax
Similar mods
What the author says
This mod is an addon for the GameStages API. It allows for items and blocks to be placed into custom progression systems. You should check out the GameStage API mod's description for more info. To give a brief run down, stages are parts of the progression system set up by the modpack or server. Stages are given to…
Official listing
- Modrinth page
- modrinth.com/mod/item-stages
- Owner
- Darkhax
- Published
- 2023-06-08
- Updated on Modrinth
- 2024-03-26
- Facts verified
- 2026-10-15