
Item Stages
Allows items to be restricted to a stage.
About this Mod
Item Stages
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 players through a command, which is typically ran by a questing mod, advancement, or even a Command Block.
This project is sponsored by Nodecraft. Use code DARKHAX for 30% off your first month of service!
Setup
This mod uses CraftTweaker for configuration.
This mod adds one new ZenScript method for adding item stage restrictions. You can use a specific item/block id, or an ore dictionary entry. If an ore dictionary is used, all entries for that oredict will be restricted. mods.ItemStages.addItemStage(String stage, Item/Block/OreDict);
Effects
When something is restricted by this mod, several things will happen to prevent the player from using the item.
- Holding a restricted item will cause it to be dropped immediately. (Configurable)
- Equipping the item to offhand, armor, or bauble slot will cause it to be dropped. (Configurable)
- Players can not right click or left click with the item. (Configurable)
- The tooltip will be replaced with a restricted message.
- The item will not be visible in JEI
Example Script
// Example Script
// Locks stone to stage one
mods.ItemStages.addItemStage("one", <minecraft:stone>);
// Locks all registered records to stage two
mods.ItemStages.addItemStage("two", <ore:record>);
// Locks all items from a mod to a stage
mods.ItemStages.stageModItems("one", "minecraft");
// Locks a liquid to a stage. This only affects JEI
mods.ItemStages.stageLiquid("nine", <liquid:water>);
Available Versions
How to Install Item Stages on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.3).
Install Mod
Open the mod browser in the dashboard and search for "Item Stages". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.3, 1.20.2, 1.20.1 (+6 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Item Stages server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.3). You can switch loaders with one click in the panel.
Is Item Stages compatible with forge?
Item Stages officially supports forge for Minecraft 1.20.3, 1.20.2, 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Item Stages – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Item Stages consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Item Stages with just one click on your server.
