RandomizerPlugin

Turn every block break and crafting recipe into a surprise. No two plays are the same.

RandomizerPlugin is a lightweight yet powerful Spigot/Paper plugin that completely overhauls
two of Minecraft's most fundamental mechanics — block drops and crafting results — by replacing
them with randomly selected items from a large, curated loot pool. A clean in-game GUI lets
server operators and permitted players toggle each feature independently at any time, with no
server restart required.

---

Features

Block Drop Randomizer

Every time a player breaks a block, the normal drop is suppressed and replaced with a
completely random item. The result is pulled from a pool of over 40 possible materials,
ranging from everyday resources like Cobblestone and Coal all the way to rare treasures such
as Elytra, Nether Stars, and even the Dragon Egg. Drop amounts are also randomized between
1 and 4 items, with a 10 % chance of a bonus stack (5–8 items) to keep things exciting.
This feature works on all breakable blocks and integrates seamlessly with the vanilla game
without modifying world data.

Crafting Randomizer

When the Crafting Randomizer is active, every crafting recipe in the game is replaced with
a mystery result. As soon as a player fills a valid crafting pattern, the output slot shows a
randomly chosen item instead of the expected product — and a second randomization fires the
moment the player picks up the result, preventing any exploit of the preview. The output pool
mirrors the block drop pool and spans tools, armor, food, building materials, and rare items.

In-Game Toggle GUI

Both features are fully controlled through a polished 3×9 chest GUI, opened with a single
command. The interface displays the current state of each randomizer using color-coded wool
blocks (green = active, red = inactive) and descriptive lore text. Clicking a button
instantly toggles the corresponding feature and refreshes the GUI to reflect the new state.
No configuration files, no restarts — changes apply live to all online players.

---

Commands

| Command | Alias | Description |
|---------|-------|-------------|
| /random gui | /rng gui | Opens the Randomizer control GUI |

---

Permissions

| Permission Node | Default | Description |
|-----------------|---------|-------------|
| randomizer.use | OP | Allows opening the GUI and toggling both randomizers |
| randomizer.admin | OP | Full administrative access (reserved for future expansions) |

---

Installation

1. Download RandomCore.jar
2. Drop the JAR into your server's plugins/ folder
3. Start or reload your server
4. Grant randomizer.use to the players or groups who should have access
5. Join the server and run /random gui to get started

Requirements: Java 17 or higher · Paper or Spigot 1.20.x