What Is TwitchWhitelist?
TwitchWhitelist is a clever Bukkit plugin that bridges your Minecraft server with Twitch channel points. It allows Twitch Affiliates to automatically manage their server whitelist based on viewer rewards. Instead of manually adding and removing players, you can let your community unlock access by redeeming channel points during your streams. This creates a powerful incentive for viewers to engage with your content while keeping your server populated with active, invested players.
How the Integration Works
The plugin connects directly to the Twitch API and monitors your channel point redemptions. When a viewer spends points on a specific reward you have configured, the plugin receives a notification and adds their Minecraft username to the server whitelist for a set duration. Once that time expires, the player is automatically removed unless they redeem again. This seamless loop encourages repeated engagement and gives your Twitch community a tangible in-game benefit.
Core Mechanics
- Channel Point Rewards: You define a custom reward on your Twitch dashboard that viewers can purchase with their accumulated channel points.
- Whitelist Management: The plugin listens for redemptions and adds the corresponding Minecraft username to the server whitelist.
- Time-Based Access: You configure how long a redeemed access lasts, from seconds to days, giving you full control over server entry.
- Automated Cleanup: Expired whitelist entries are removed automatically, so you never have to prune the list by hand.
Requirements for Setup
Before diving into the configuration, make sure you have everything in place. The plugin is designed for Bukkit-based servers running Minecraft version 1.15 or higher. You also need an active Twitch Affiliate account, as channel points are only available to Affiliates and Partners. A basic understanding of OAuth and Twitch’s developer dashboard will help, but the setup guide walks you through each step clearly.
Step-by-Step Installation and Configuration
Getting TwitchWhitelist up and running involves a few straightforward stages. Follow these steps carefully, and you will have your server integrated with Twitch in no time.
1. Create a Twitch Application
Head over to the Twitch Developer Console and register a new application. Choose “Game Integration” as the category to keep things simple. This will generate a Client ID and Client Secret, which you will need later.
2. Set Up the Virtual Twitch Server
Download the VirtualTwitchServer tool and launch it. If you prefer a command-line interface, you can start it with the -cli argument. This lightweight server handles the OAuth token exchange between your Minecraft server and Twitch. Make note of the port number you select during this process.
3. Configure OAuth Redirect URL
Back in the Twitch Developer Console, set the OAuth redirect URL for your application to http://localhost:{PORT}/, replacing {PORT} with the actual port number from the previous step. This ensures the authentication flow works correctly.
4. Generate and Insert Your Token
Click the “Login with Twitch” button inside the VirtualTwitchServer interface. After authorizing, you will receive a token. Paste this token into the plugin’s configuration file. Also, set the broadcaster_name field to match your Twitch username exactly.
5. Finalize Plugin Configuration
Copy the Client ID and Client Secret from your Twitch application into the plugin’s config.yml. Then define the access duration using a simple format: a number followed by a letter. For example, 10 means 10 seconds, 5M means 5 minutes, 10H means 10 hours, and 30D means 30 days. This flexibility lets you tailor the reward to your community’s needs.
6. Adjust Reward Settings on Twitch
Once the plugin is running, it will automatically create a channel points reward on your Twitch dashboard. You can customize the reward name, cost, and description through the Twitch dashboard, but avoid manually changing the reward ID or other technical fields unless you fully understand the consequences.
During the configuration process, you might find it helpful to use a modern launcher that simplifies mod and plugin management. For instance, the foxygame.net launcher offers a convenient way to organize your server files and even download required dependencies directly from its menu, saving you time when setting up complex integrations like this one.
Why Use TwitchWhitelist on Your Server?
This plugin transforms your Minecraft server into an extension of your streaming brand. Viewers who invest their channel points gain a sense of ownership and exclusivity, which boosts loyalty and chat activity. It also reduces the administrative burden of manually whitelisting players, freeing you to focus on content creation. The time-limited access creates a natural cycle of engagement, as players return to your stream to renew their server access.
Key Advantages
- Automated Whitelist Management: No more manual adding or removing players.
- Increased Viewer Engagement: Channel points become more valuable, encouraging participation.
- Community Building: Your server becomes a hub for dedicated Twitch followers.
- Flexible Access Control: Set durations from seconds to days to match your streaming schedule.
Technical Considerations
The plugin relies on a few critical configuration values that should not be altered without understanding their purpose. The app_access_token, user_access_token, reward_id, and broadcaster_id are generated during the OAuth flow and reward setup. Changing these manually can break the connection between your server and Twitch, requiring a full reconfiguration. If you encounter issues, the developer is available for support and typically responds as soon as possible.
Conclusion
TwitchWhitelist is a focused, effective plugin that deepens the connection between your Twitch channel and your Minecraft community. By turning channel points into server access, you reward your most dedicated viewers and create a lively, engaged player base. The setup process, while involving several steps, is well-documented and manageable for anyone with a basic Bukkit server. Whether you run a small private server for subscribers or a larger community world, this tool adds a layer of interactivity that keeps viewers coming back to both your stream and your server.