
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 账号:主播账号和机器人账号
🚀 快速设置
- 在你的 Fabric 服务器上安装模组
- 创建一个 Twitch 应用并获取 Client ID/Secret
- 生成主播和机器人访问令牌
- 创建一个需要文本输入的频道积分奖励
- 配置
config/twitchwhitelist/config.json - 重启并测试!
详细的设置指南包含在自动生成的 HOWTO.txt 文件中。
🎯 适用场景
- 直播主服务器 - 让你的社区通过努力获得进入服务器的资格
- 专属访问 - 用频道积分打造 VIP 体验
- 社区管理 - 追踪兑换并管理访问权限
- 互动直播 - 以服务器访问权限作为奖励与观众互动
📊 追踪内容
- 所有兑换(成功和失败)
- 平台之间的封禁/解封事件
- 每个用户的活跃白名单状态
- SQLite 数据库中的完整审计跟踪
🔧 配置选项
- 自动创建奖励
- 每个用户的最大活跃白名单数量
- 封禁同步(MC ↔ Twitch)
- 临时封禁超时同步
- 自定义奖励标题和费用
- EventSub 端口配置
💡 使用案例
社区服务器: 将奖励费用设为 50,000 积分,让加入变得有意义 订阅者福利: 为频道积分获取者创建专属服务器访问权限 活动服务器: 在特别直播期间临时启用自动白名单 管理工具: 使用封禁同步让捣乱者远离两个平台
📦 你将获得
- 全自动白名单管理
- 无需手动输入用户名
- 出错时自动退还积分
- 完整的兑换历史
- 跨平台管理工具
- 实时 Twitch 集成
- 游戏内管理命令
🆘 支持
- 📖 完整 Wiki 文档 - 完整指南和参考
- 自动生成的设置指南(HOWTO.txt)
- 详细的故障排除部分
- GitHub issues 提供支持
📖 Wiki | 源代码 | 许可证: MIT 仅服务端: 无需客户端安装
将你的 Twitch 频道积分转化为服务器白名单访问权限——自动完成!
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。