Twitch Whitelist - Automatic Whitelisting via Channel Points
Automatically whitelist players when they redeem a Twitch channel point reward! Perfect for streamers who want to let their community join their Minecraft server through Twitch integration.
🎮 Core Features
- 🔗 Real-Time Integration - Connects to Twitch via EventSub WebSocket for instant redemption processing
- ✅ Smart Validation - Automatically validates Minecraft usernames and refunds points for invalid entries
- 💰 Auto-Refund - Failed redemptions are automatically refunded with helpful chat messages
- 💬 Chat Integration - Sends confirmation messages through your bot account
- 💾 SQLite Database - Tracks all redemptions, bans, and events with full history
- 🎯 Active Tracking - Limit how many Minecraft accounts each Twitch user can have whitelisted
🔄 Advanced Features
Bidirectional Ban Sync
- Ban a Minecraft player → automatically ban their linked Twitch account
- Ban a Twitch user → automatically ban all their linked Minecraft accounts
- Unban sync works in both directions
- Circular loop prevention included
Temp Ban Timeouts (New!)
- Temporary Minecraft bans automatically convert to Twitch timeouts
- Syncs duration up to 14 days (Twitch limit)
- Longer temp bans fallback to permanent Twitch bans
In-Game Management
- Reload config without restarting (
/twl reload)
- Update reward title/cost in real-time (
/twl updatereward)
- Lookup accounts to find linked Minecraft/Twitch usernames (
/twl lookup)
- Permission system integration (LuckPerms, PlayerRoles)
📋 Requirements
- Minecraft 1.21.1
- Fabric Loader 0.18.4+
- Fabric API 0.116.7+1.21.1
- Twitch Developer Account (free)
- Two Twitch accounts: broadcaster and bot
🚀 Quick Setup
- Install mod on your Fabric server
- Create a Twitch Application and get Client ID/Secret
- Generate broadcaster and bot access tokens
- Create a Channel Point Reward requiring text input
- Configure
config/twitchwhitelist/config.json
- Restart and test!
Detailed setup guide included in auto-generated HOWTO.txt file.
🎯 Perfect For
- Streamer Servers - Let your community earn their way onto the server
- Exclusive Access - Create a VIP experience with channel points
- Community Management - Track redemptions and manage access
- Interactive Streams - Engage viewers with server access as a reward
📊 What's Tracked
- All redemptions (successful and failed)
- Ban/unban events between platforms
- Active whitelist status per user
- Complete audit trail in SQLite database
🔧 Configuration Options
- Automatic reward creation
- Max active whitelists per user
- Ban sync (MC ↔ Twitch)
- Temp ban timeout sync
- Custom reward title and cost
- EventSub port configuration
💡 Use Cases
Community Server: Set reward cost at 50,000 points to make joining meaningful
Subscriber Perk: Create exclusive server access for channel point earners
Event Server: Temporarily enable auto-whitelist during special streams
Moderation Tool: Use ban sync to keep troublemakers off both platforms
📦 What You Get
- Fully automated whitelist management
- No manual username entry needed
- Points automatically refunded for errors
- Complete redemption history
- Cross-platform moderation tools
- Real-time Twitch integration
- In-game management commands
🆘 Support
- 📖 Full Wiki Documentation - Complete guides and references
- Auto-generated setup guide (HOWTO.txt)
- Detailed troubleshooting section
- GitHub issues for support
📖 Wiki | Source Code | License: MIT
Server-Side Only: No client installation required
Transform your Twitch channel points into server whitelist access - automatically!
