
a minecraft randomizer challenge controlled by your twitch chat
TwitchRandomizer is a powerful Minecraft (Paper 1.21.8+) plugin that brings interactive, randomized challenges to your server... 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.
Twitch Chat Integration:
Twitch viewers can trigger random events by subscribing or donating bits to your channel!
Event Weighting and Customization:
Adjust the likelihood of each event — make some more common, some rare, or disable them entirely. Easily reload or adjust settings on the fly.
Death Counter and Statistics:
Built-in death tracking and player statistics, perfect for challenge runs and community competitions.
Queue System:
Viewer-triggered events can be queued and managed, ensuring smooth pacing and no event spam. Even after a seed reset, the queue will still be the same!
Graphical Interface (GUI):
Tweak plugin settings, manage event weights, and configure behaviors directly from an in-game GUI. Perfect for easy setup without any OP permissions!
Session and World Reset:
Reset your seed after a death if you want a REAL challenge!
/trgui — Open the graphical config GUI.Optional commands (not necessary, because you can manage everything seamlessly from the GUI):
/timer — Start, stop, pause, or reset the challenge timer./reset — Initiate a world/session reset with confirmation./queue add <amount> <username> — Manually add events to the queue./cleardeath — Clear the death counter./trconfig — Configure the plugin via command (tab completion supported).You can configure the plugin through the config.yml or without OP permissions directly through the GUI in-game.
Install:
Place TwitchRandomizer.jar into your server's plugins folder.
Configure Twitch Integration:
/trgui; in the top left, you'll find the "twitch-info" book.Broadcaster Username by left-clicking on the book, then confirm with done.Bot OAuth by right-clicking on the book, then confirm with done.bits.read, chat:read, channel:read:subscriptions and user:read:subscriptions.Reload/Restart:
If you use the GUI, you don't need to restart the server.
Set up your trigger
You can test your connection. With the test triggers enabled (find them in the Debug Menu), you can simulate events like a sub (!test or !gift) or a sub gift bomb (!giftbomb).
MAKE SURE YOUR TIMER IS RUNNING! OTHERWISE, YOU CAN'T ADD EVENTS TO THE QUEUE THROUGH TWITCH!
If you want to add some events to the queue, you can simply use the command /queue add <AMOUNT> <Username>. This also works when the timer isn't running!
| Permission | Description |
|---|---|
| twitchrandomizer.gui | Full GUI access (super-node) |
| twitchrandomizer.gui.use | Use GUI (basic) |
| twitchrandomizer.admin.save | Save & hot-reload config |
| twitchrandomizer.admin.edit | Edit values via GUI |
| twitchrandomizer.admin.twitch | Set Twitch channel/token |
| twitchrandomizer.timer.<start/stop/reset> | Timer control |
| twitchrandomizer.reset | Reset flow |
The GUI uses sensible permission checks for each action.
Built by exnfachjan with the help of AI (Copilot and ChatGPT).
Thanks to the Paper/Spigot communities and Twitch4J for solid foundations.
Do you like my plugin? Feel free to support my work: https://streamelements.com/exnfachjan/tip