# TwitchRandomizer<\/p>\n
\n<\/p>\n
TwitchRandomizer is a powerful Minecraft (Paper 1.21+) plugin that brings interactive, randomized challenges to your server \u2014 all controlled by your Twitch viewers! It seamlessly integrates your Minecraft gameplay with Twitch chat, letting your audience influence and trigger in-game events in real time.<\/p>\n
—<\/p>\n
## \ud83d\udccc Key Features<\/p>\n
– **Twitch Chat Integration:**
\n Twitch viewers can trigger random events by subscribing or donating bits to your channel!<\/p>\n
– **Play this Challenge with your Twitch Friends:**
\n The plugin can read subscriptions and bits from multiple Twitch accounts \u2014 including StreamElements and Tipeeestream donations. So you can play this challenge with your Twitch friends!<\/p>\n
– **StreamElements & Tipeeestream Donation Integration:**
\n Donations via StreamElements or Tipeeestream trigger in-game events. Both support **multiple streamer accounts simultaneously**. Configuration is done exclusively via `donations.yml` in the plugin folder.<\/p>\n
– **Channel Name Display:**
\n When playing with multiple Twitch channels, the source channel is shown in brackets after every trigger \u2014 e.g. `exnfachjan (fuxelbau) deals 4 hearts`.<\/p>\n
– **Twitch Role Colors:**
\n Viewer names appear color-coded in Minecraft chat \u2014 Broadcaster (red), Moderator (green), VIP (pink), Donation (aqua), and regular viewers (white).<\/p>\n
– **Event Weighting and Customization:**
\n Adjust the likelihood of each event \u2014 make some more common, some rare, or disable them entirely. Easily reload or adjust settings on the fly. Reset all weights to defaults with one click.<\/p>\n
– **Recent Event Cooldown:**
\n A built-in cooldown system reduces the chance of the same event appearing multiple times in a row, automatically \u2014 no configuration needed.<\/p>\n
– **Synced Multi-Player Events:**
\n When playing with multiple players, all random values within an event (duration, item, mob type, etc.) are identical for every player. No more player 1 getting 10 seconds of Floor is Lava while player 2 gets 69.<\/p>\n
– **Spectator After Death:**
\n When a player dies, all players are moved to Spectator mode simultaneously. The timer and queue pause until a new run begins. Configurable per-run as “Tries” (team lives) or classic “Deaths” counter.<\/p>\n
– **Death Counter and Statistics:**
\n Built-in death tracking and player statistics, perfect for challenge runs and community competitions.<\/p>\n
– **Queue System:**
\n Viewer-triggered events can be queued and managed, ensuring smooth pacing and no event spam. The queue persists across server restarts and world resets!<\/p>\n
– **Pause System:**
\n Timer and queue automatically pause when a player is in the death screen or when all players are in spectator mode. Fully configurable.<\/p>\n
– **Pause Aura:**
\n When the timer is paused, a spiral flame particle aura appears around all online players \u2014 a clear visual indicator that the challenge is on hold.<\/p>\n
– **Graphical Interface (GUI):**
\n Tweak plugin settings, manage event weights, control the timer, and configure behaviors directly from an in-game GUI. Perfect for easy setup without any OP permissions!<\/p>\n
– **Multi-Language Support:**
\n Full German and English UI with automatic client language detection. Players can override their language in the GUI.<\/p>\n
– **Session and World Reset:**
\n Reset your seed after a death if you want a REAL challenge! Supports BungeeCord fallback servers.<\/p>\n
—<\/p>\n
## \u2714\ufe0f Main Commands<\/p>\n
– `\/trgui` \u2014 Open the graphical config GUI.<\/p>\n
Optional commands (not necessary, because you can manage everything seamlessly from the GUI):<\/p>\n
– `\/timer` \u2014 Start, stop, pause, or reset the challenge timer. —<\/p>\n ## \ud83c\udf89 Events<\/p>\n | Event | Description | —<\/p>\n ## \ud83d\udee0 Getting Started<\/p>\n You can configure the plugin through the config.yml or without OP permissions directly through the GUI in-game.<\/p>\n 1. **Install:** 2. **Configure Twitch Integration:** 3. **Configure StreamElements (optional):** “`yaml For multiple streamers, separate entries with a semicolon:<\/p>\n “`yaml Get your JWT token from: https:\/\/streamelements.com\/dashboard\/account\/channels<\/p>\n 4. **Configure Tipeeestream (optional):** “`yaml Multiple accounts work the same way: `”Ch1:KEY1;Ch2:KEY2″` After editing `donations.yml`, apply it in-game with `\/trconfig donations reload` \u2014 no server restart required.<\/p>\n 5. **Reload\/Restart:** 6. **Set up your trigger** **MAKE SURE YOUR TIMER IS RUNNING! OTHERWISE, YOU CAN’T ADD EVENTS TO THE QUEUE THROUGH TWITCH!**<\/p>\n If you want to add some events to the queue, you can simply use the command `\/queue add —<\/p>\n ## \ud83d\udd0d Permissions for non-OP users (LuckPerms required)<\/p>\n | Permission | Description | The GUI uses sensible permission checks for each action.<\/p>\n ## \ud83d\udcce Requirements<\/p>\n – Minecraft Paper server 1.21+ —<\/p>\n ## \ud83d\udccb Changelog<\/p>\n ### v1.5.0<\/p>\n – **Tipeeestream multi-account support** \u2014 `donations.yml` now uses `tipeee_accounts` with the same `”Channel:APIKEY;Channel2:APIKEY2″` format as StreamElements. ### v1.4.0<\/p>\n – **New event: `equipment_shuffle`** \u2014 All tiered tools and armor in the inventory are randomly upgraded or downgraded by one tier. Enchantments, display names, and lore are preserved. ### v1.3.1<\/p>\n – Initial public release.<\/p>\n —<\/p>\n ## \ud83d\udddd Credits<\/p>\n Built by exnfachjan with the help of AI (Claude by Anthropic). —<\/p>\n ## \ud83d\udd12 License<\/p>\n This project is licensed under the **GNU General Public License v3.0** \u2014 <\/p>\n —<\/p>\n ## \u2764\ufe0f Support<\/p>\n Do you like my plugin? Feel free to support my work: https:\/\/streamelements.com\/exnfachjan\/tip<\/p>\n","protected":false},"excerpt":{"rendered":" a minecraft randomizer challenge controlled by your twitch chat<\/p>\n","protected":false},"featured_media":160933,"template":"","meta":{"_minecraft_slug":"twitchrandomizer","_minecraft_project_id":"ogCyDo14","_minecraft_author":"exnfachjanTTV","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":89,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"twitchrandomizer.zip","_minecraft_size_bytes":117547698,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T19:55:21.863261Z","_minecraft_date_created":"2025-09-17T00:02:27.175706Z","_minecraft_date_modified":"2026-04-25T15:19:45.103149Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/twitchrandomizer","_minecraft_icon_attachment_id":160933,"_minecraft_imported_at":"2026-06-09T15:09:27+00:00","_minecraft_import_hash":"e3cf8d2fdc68052cb916283a117ad190","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,866,127,129],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-160932","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/reset` \u2014 Initiate a world\/session reset with confirmation.
\n– `\/queue add
\n– `\/cleardeath` \u2014 Clear the death counter.
\n– `\/trconfig` \u2014 Configure the plugin via command (tab completion supported).<\/p>\n
\n| ——————— | ——————————————————————————– |
\n| **spawn_mobs** | Spawn random mobs near the player (hostile mobs chase you!) |
\n| **potion** | Apply a random potion effect |
\n| **give_item** | Give a random item |
\n| **clear_inventory** | Clear random slots from the player’s inventory |
\n| **teleport** | Teleport to a random location (safe Y-level) |
\n| **damage_half_heart** | Take heart damage |
\n| **fire** | Set the player on fire |
\n| **inv_shuffle** | Shuffle the entire inventory |
\n| **hot_potato** | A fast zombie chases you \u2014 if it catches you, it explodes! |
\n| **no_crafting** | Block crafting for a random duration (with boss bar countdown) |
\n| **safe_creepers** | Creepers surround you clock-style and explode (no damage, no block destruction) |
\n| **floor_is_lava** | The floor beneath you turns to magma blocks (with block restore) |
\n| **nasa_call** | Launch the player sky-high |
\n| **slippery_ground** | The ground turns to packed ice (with block restore) |
\n| **hell_is_calling** | Homing fireballs rain down on you |
\n| **tnt_rain** | TNT Minecarts rain from the sky |
\n| **anvil_rain** | Anvils fall from the sky |
\n| **skyblock** | All players are teleported together \u2014 surrounding chunks get deleted! |
\n| **fake_totem** | Receive a Totem of Undying that doesn’t actually work |
\n| **equipment_shuffle** | All tiered tools and armor in your inventory are randomly upgraded or downgraded |<\/p>\n
\n Place `TwitchRandomizer.jar` into your server’s plugins folder.<\/p>\n
\n – Open the GUI with `\/trgui`; in the top left, you’ll find the “twitch-info” book.
\n – Insert your `Broadcaster Username` by left-clicking on the book, then confirm with `done`.
\n You can enter multiple channels separated by commas, semicolons, or new lines.
\n – Insert your `Bot OAuth` by right-clicking on the book, then confirm with `done`.
\n You can get your OAuth token here: https:\/\/twitchtokengenerator.com\/quick\/1KRFjxyoNE
\n Make sure the following scopes are active: `bits.read`, `chat:read`, `channel:read:subscriptions` and `user:read:subscriptions`.<\/p>\n
\n Edit `plugins\/TwitchRandomizer\/donations.yml` \u2014 this file is created automatically on first start and is **never overwritten** by the plugin.<\/p>\n
\n se_enabled: true
\n se_accounts: “YOUR_CHANNEL:YOUR_JWT_TOKEN”
\n “`<\/p>\n
\n se_accounts: “Channel1:JWT1;Channel2:JWT2”
\n “`<\/p>\n
\n In the same `donations.yml`:<\/p>\n
\n tipeee_enabled: true
\n tipeee_accounts: “YOUR_CHANNEL:YOUR_APIKEY”
\n “`<\/p>\n
\n Get your API key from: https:\/\/tipeeestream.com\/dashboard\/stream<\/p>\n
\n If you use the GUI, you don’t need to restart the server.<\/p>\n
\n You can test your connection. With the test triggers enabled (find them in the `Debug Menu`), you can simulate events like a sub (`!test`), a gift sub (`!gift`), or a sub gift bomb (`!giftbomb [N]`).<\/p>\n
\n| —————————– | ——————————- |
\n| twitchrandomizer.gui | Full GUI access (super-node) |
\n| twitchrandomizer.gui.use | Use GUI (basic) |
\n| twitchrandomizer.admin.save | Save & hot-reload config |
\n| twitchrandomizer.admin.edit | Edit values via GUI |
\n| twitchrandomizer.admin.twitch | Set Twitch channel\/token |
\n| twitchrandomizer.timer.start | Start the timer |
\n| twitchrandomizer.timer.stop | Stop\/pause the timer |
\n| twitchrandomizer.timer.reset | Reset the timer |
\n| twitchrandomizer.reset | Reset flow |
\n| twitchrandomizer.reset.force | Force reset (skip confirmation) |<\/p>\n
\n– Java 21 or newer
\n– Twitch account (at least affiliate) and OAuth token for chat integration<\/p>\n
\n– **Channel tag display** \u2014 When playing with multiple Twitch channels, the source channel name is shown in brackets after every event trigger.
\n– **Synced multi-player events** \u2014 All random values (duration, item, mob type, potion effect, etc.) are now identical for every player in the same event dispatch.
\n– **Skyblock team fix** \u2014 All players are now teleported to a single meeting point before chunks are cleared. Prevents players from voiding each other.
\n– **Spectator-after-death team fix** \u2014 When a player dies, all online players are now moved to Spectator simultaneously. Timer and queue pause correctly.
\n– **Tries vs Deaths counter** \u2014 When Spectator-after-death is enabled, the counter is labeled “Tries\/Versuche” and only counts once per team-death. When disabled, it counts individual deaths as before.
\n– **Euro\/Event maximum** \u2014 The donation value per event is now capped at 5.0\u20ac (the standard price). You can only go lower, not higher.
\n– **Recent event cooldown** \u2014 A new anti-repeat algorithm reduces the weight of recently triggered events for the next 2\u20133 picks, making the event pool feel more varied.
\n– **Queue pause on all-spectator** \u2014 Timer and queue now correctly pause as soon as all players are in Spectator mode.<\/p>\n
\n– **StreamElements donation integration** \u2014 Donations via StreamElements now trigger in-game events. Supports multiple streamer accounts simultaneously.
\n– **Pause aura** \u2014 A spiral flame particle effect is displayed around all online players while the timer is paused.
\n– **Weights:** small default value changes.<\/p>\n
\nThanks to the Paper\/Spigot communities and Twitch4J for solid foundations.<\/p>\n
\nsee [LICENSE](LICENSE) for details.<\/p>\n