Twitch Whitelist

Twitch Whitelist - Channel Point Whitelisting!

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

1. Install mod on your Fabric server
2. Create a Twitch Application and get Client ID/Secret
3. Generate broadcaster and bot access tokens
4. Create a Channel Point Reward requiring text input
5. Configure config/twitchwhitelist/config.json
6. 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!