Item Stages

Item Stages

Allows items to be restricted to a stage.

by
128.0K Downloads
forgeadventurelibraryutility
Rent Server with this Mod

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.

Nodecraft sponsor banner

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

ItemStages-Forge-1.20.1-8.0.3release
MC 1.20.1forge
March 26, 2024
ItemStages-Forge-1.20.3-10.0.1release
MC 1.20.3forge
January 12, 2024
ItemStages-Forge-1.20.2-9.0.2release
MC 1.20.2forge
January 8, 2024
ItemStages-Forge-1.20.2-9.0.1release
MC 1.20.2forge
January 7, 2024
ItemStages-Forge-1.20.1-8.0.2release
MC 1.20.1forge
December 14, 2023

How to Install Item Stages on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.3).

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

forge

Minecraft Versions

1.20.3, 1.20.2, 1.20.1 (+6 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Item Stages with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v2.1 only
Server-side
Required

Supported Versions

1.20.31.20.21.20.11.201.19.41.19.21.18.21.16.51.12.2