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!