Twitch白名单

Twitch白名单

当玩家兑换Twitch频道点数奖励时,自动将他们加入白名单!非常适合希望让社区通过Twitch集成加入Minecraft服务器的主播。

管理

Twitch 白名单 - 频道积分白名单功能!

当玩家兑换 Twitch 频道积分奖励时自动将其加入白名单! 非常适合希望让社区通过 Twitch 集成加入其 Minecraft 服务器的直播主。

🎮 核心功能

  • 🔗 实时集成 - 通过 EventSub WebSocket 连接 Twitch,即时处理兑换
  • ✅ 智能验证 - 自动验证 Minecraft 用户名,并对无效输入退还积分
  • 💰 自动退款 - 失败的兑换会自动退款,并发送有用的聊天消息
  • 💬 聊天集成 - 通过你的机器人账号发送确认消息
  • 💾 SQLite 数据库 - 记录所有兑换、封禁和事件,保留完整历史
  • 🎯 活跃追踪 - 限制每个 Twitch 用户可加入白名单的 Minecraft 账号数量

🔄 高级功能

双向封禁同步

  • 封禁一名 Minecraft 玩家 → 自动封禁其关联的 Twitch 账号
  • 封禁一名 Twitch 用户 → 自动封禁其所有关联的 Minecraft 账号
  • 解封同步在两个方向上均有效
  • 包含循环防止机制

临时封禁超时同步(新增!)

  • 临时 Minecraft 封禁会自动转换为 Twitch 超时
  • 同步时长最多 14 天(Twitch 限制)
  • 更长的临时封禁会退化为永久 Twitch 封禁

游戏内管理

  • 无需重启即可重载配置(/twl reload)
  • 实时更新奖励标题/费用(/twl updatereward)
  • 查询账号以查找关联的 Minecraft/Twitch 用户名(/twl lookup)
  • 权限系统集成(LuckPerms、PlayerRoles)

📋 要求

  • Minecraft 1.21.1
  • Fabric Loader 0.18.4+
  • Fabric API 0.116.7+1.21.1
  • Twitch 开发者账号(免费)
  • 两个 Twitch 账号:主播账号和机器人账号

🚀 快速设置

  1. 在你的 Fabric 服务器上安装模组
  2. 创建一个 Twitch 应用并获取 Client ID/Secret
  3. 生成主播和机器人访问令牌
  4. 创建一个需要文本输入的频道积分奖励
  5. 配置 config/twitchwhitelist/config.json
  6. 重启并测试!

详细的设置指南包含在自动生成的 HOWTO.txt 文件中。

🎯 适用场景

  • 直播主服务器 - 让你的社区通过努力获得进入服务器的资格
  • 专属访问 - 用频道积分打造 VIP 体验
  • 社区管理 - 追踪兑换并管理访问权限
  • 互动直播 - 以服务器访问权限作为奖励与观众互动

📊 追踪内容

  • 所有兑换(成功和失败)
  • 平台之间的封禁/解封事件
  • 每个用户的活跃白名单状态
  • SQLite 数据库中的完整审计跟踪

🔧 配置选项

  • 自动创建奖励
  • 每个用户的最大活跃白名单数量
  • 封禁同步(MC ↔ Twitch)
  • 临时封禁超时同步
  • 自定义奖励标题和费用
  • EventSub 端口配置

💡 使用案例

社区服务器: 将奖励费用设为 50,000 积分,让加入变得有意义 订阅者福利: 为频道积分获取者创建专属服务器访问权限 活动服务器: 在特别直播期间临时启用自动白名单 管理工具: 使用封禁同步让捣乱者远离两个平台

📦 你将获得

  • 全自动白名单管理
  • 无需手动输入用户名
  • 出错时自动退还积分
  • 完整的兑换历史
  • 跨平台管理工具
  • 实时 Twitch 集成
  • 游戏内管理命令

🆘 支持

  • 📖 完整 Wiki 文档 - 完整指南和参考
  • 自动生成的设置指南(HOWTO.txt)
  • 详细的故障排除部分
  • GitHub issues 提供支持

📖 Wiki | 源代码 | 许可证: MIT 仅服务端: 无需客户端安装

将你的 Twitch 频道积分转化为服务器白名单访问权限——自动完成!