Item Shuffle

🎲 Item Shuffle — Everyone Racing the Clock, Alone



Picture this: the server announces the round, and a second later your chat lights up with — "Your item: Totem of Undying". The player next to you got assigned something completely different. Everyone hunts their own personal target, tracked by their own boss bar counting down the seconds.



Item Shuffle is a mod for Minecraft 1.21.1, built on the Forge (javafml) API, adding an individual, simultaneous item-hunting mechanic: when a round starts, every online player is assigned a different random item, drawn from the chosen difficulty pool. Whoever has the right item in their inventory before the 5-minute timer runs out scores a point and is safe. Whoever doesn't... dies.



⚙️ How It Works

• • Running /start individually rolls a random item for every connected player, drawn from the selected difficulty pool.

• • Each player gets their own boss bar (red bar at the top of the screen) showing the required item's name and the remaining time in MM:SS format.

• • The timer is fixed at 5:00 (6000 ticks), regardless of difficulty.

• • The moment the required item appears in a player's inventory, their bar turns green, displays "ITEM FOUND!", and the player earns +1 point.

• • Scores are cumulative across rounds — starting a new round with /start does not reset player scores, it only rerolls items and restarts the timer.

• • If time runs out before a player finds their item, they are instantly killed, and a message is broadcast to the whole server.

• • The round ends automatically once every player has found their item (a shared victory message) or once the timer hits zero for everyone.

🛠️ Commands



The mod adds a single root command with three difficulty subcommands. Permission level 2 (operator) is required to run it.

Command	Permission	Effect
/start easy	Level 2 (OP)	Starts a round using day-1 items: woods, stones, basic foods, flowers, dirt, and wood/stone tools.
/start medium	Level 2 (OP)	Starts a round using mining/Nether items: iron, gold, redstone, buckets, village items, quartz, potions, and mechanisms.
/start hard	Level 2 (OP)	Starts a round using end-game items: diamond, netherite, End items, totems, tridents, elytra, Trial Chamber keys, and rare music discs.

Difficulty details (randomized item pools):

• • 🟢 Easy — ~100 items: woods and derivatives, stone variants, raw/cooked foods, flowers, wood and stone tools, torch, chest, crafting table, surface ores (coal, copper, amethyst).

• • 🟡 Medium — ~100 items: iron, gold, lapis lazuli, diamond, iron/gold tools and armor, buckets, bow/crossbow, redstone and its mechanisms, rails and minecarts, Nether items (quartz, magma, glowstone), potions, and brewing supplies.

• • 🔴 Hard — ~75 items: full diamond and netherite gear, Nether boss drops, ancient debris, End items (elytra, shulker shell, dragon egg, nether star, trident, totem of undying), Trial Chamber keys, mace, heavy core, armor trim smithing templates, and exclusive music discs.

📋 Technical Requirements

• • Minecraft version: 1.21.1 (declared range: [1.21.1, 1.22))

• • Mod Loader / API: Forge (modLoader = "javafml")

• • Mod ID: itemshuffle

• • Mod version: 1.0.0

• • Required side: client and server (dependency declared as side = "BOTH")

• • External dependencies: none beyond Forge/Minecraft itself

🏆 Why support on Patreon?



This mod is made with care (and a lot of caffeine) to bring something different to Minecraft. Your support helps me:



🔧 Keep the mod updated with new Minecraft versions
➕ Add new items, modes, and mechanics
🐛 Fix bugs quickly
🎮 Create more content for the community



Every bit of support, however small, makes a huge difference and keeps me motivated to keep developing. Thanks for being part of this! 💚