StreamingModule — 用于 Minecraft 的 Twitch Drops 与直播集成
将每一次 Twitch 直播转化为观众的奖励,并作为主播的增长引擎。StreamingModule 连接了 Twitch 和你的 Minecraft 服务器(Spigot、Paper、Purpur、BungeeCord、Velocity),让观众只需观看即可赚取真正的游戏内掉落物,同时为主播提供直播内的实时公告、游戏内 Twitch 聊天以及能触发实际服务器指令的频道积分奖励。
Twitch 并不像支持其他游戏那样原生支持 Minecraft 的“Drops”功能——StreamingModule 填补了这一空白,让你的社区无需依赖 Twitch 的 Drops API 也能获得同样的热情体验。
StreamingModule 的功能
- Twitch 观众掉落 — 观看已配置主播的观众有机会获得奖励,该奖励以任意 Minecraft 指令的形式执行。给予物品、货币、排名、宝箱钥匙或任何插件可运行的内容——掉落本身没有任何限制。
- 离线掉落队列 — 正在观看直播但尚未在服务器上在线的观众不会错过奖励。掉落将被保存并在他们下次加入时自动送达。
- Minecraft 内的 Twitch 聊天 — 每位主播都可以在游戏内直接查看自己的 Twitch 聊天,无需切换窗口。
- Twitch 聊天指令 — 定义自定义聊天指令,直接在 Twitch 聊天中响应实时的 PlaceholderAPI 数据。
- 频道积分奖励 — 将 Twitch 频道积分连接到 Minecraft 指令。正面或负面效果,由你决定。
- 实时公告 — 当主播开始直播时,自动在游戏内和通过 Discord webhook 广播通知,全程无需手动操作。
- 通过 PlaceholderAPI 显示直播标签 — 在任何支持 PlaceholderAPI 的地方显示当前正在直播的主播(包括制表符列表、聊天、记分板和全息图)。
- 观看时间追踪 — 记录自安装以来每位观众观看某位主播的时长,以便你可以将奖励或聊天指令设置为需满足最低观看时间才能解锁。
- 多主播支持 — 同时为多位主播运行掉落、设置和聊天集成,每位主播拥有独立的配置。
- 可配置的掉落概率 — 可根据每位主播或全局调整概率,以匹配你的社区规模和游戏经济。
- 跨平台兼容 — 适用于单个 Spigot/Paper/Purpur 服务器以及 BungeeCord 和 Velocity 代理网络,在不同 Minecraft 版本间安全兼容。
- 无需 OAuth — 所有核心功能均无需生成或管理 Twitch OAuth 令牌即可工作。
为什么主播和服务器管理员使用它
每当有观众为了获得游戏内掉落而想要加入服务器时,主播就获得了一次免费推广的机会。服务器管理员则获得了一个内置的增长循环——观众变成玩家,玩家变成社区成员,而直播本身也成为值得定期关注的 recurring event(常规活动)。
要求
- SMLib(必需依赖)
- Java 11+
- 开放用于出站请求的 HTTPS 端口
- StreamingModule Twitch 机器人账号必须被设置为你的频道的 moderator(版主)
- 可选:PlaceholderAPI 用于直播标签功能
如果 /online 命令抛出 HTTP(S) 错误,你的服务器很可能阻止了出站连接——请检查防火墙或端口设置。
设置
完整逐步安装指南:Setup Wiki
快速概览:
- 安装 SMLib 和 StreamingModule
- 启动服务器一次以生成配置文件
- 在
streamer.yml 中添加你的 Twitch 频道名称
- 在你的 Twitch 聊天中将 StreamingModule 机器人设为版主(
/mod StreamingModule)
- 根据需要配置掉落、奖励和聊天指令
想要更多?
Premium version(高级版) 增加了按主播划分的掉落列表、Twitch 事件(关注、订阅、赠送订阅、Bits、突袭、投票)、防关注机器人保护、自定义品牌等功能——详见完整的 Feature Overview(功能概览) 以进行对比。
已知不兼容项
- Matrix Anti-Cheat(可能导致问题,不保证兼容)
支持
- 在游戏中运行
/sm report 生成一份支持文件,其中包含快速帮助你所需的信息
- 加入 Discord server(Discord 服务器) —— 提供 English(英语) 和 German(德语) 支持
- 完整文档:GitHub Wiki
StreamingModule — Twitch Drops & Live Integration for Minecraft
Turn every Twitch stream into a reward for your viewers — and a growth engine for your streamer. StreamingModule connects Twitch and your Minecraft server (Spigot, Paper, Purpur, BungeeCord, Velocity), letting chatters earn real in-game drops just for watching, while streamers get live announcements, Twitch chat in-game, and channel point rewards that trigger actual server commands.
Twitch doesn't support native "Drops" for Minecraft the way it does for other games — StreamingModule closes that gap so your community gets the same hype without needing Twitch's Drops API.
What StreamingModule does
- Twitch Viewer Drops — viewers watching a configured streamer have a chance to receive a reward, executed as any Minecraft command. Give items, money, ranks, crate keys, or anything a plugin can run — the drop itself has no limits.
- Offline Drop Queue — viewers who are watching the stream but aren't online on the server don't miss out. Drops are saved and delivered automatically next time they join.
- Twitch Chat inside Minecraft — each streamer can see their own Twitch chat directly in-game, no alt-tabbing required.
- Twitch Chat Commands — define custom chat commands that respond with live PlaceholderAPI data, right inside Twitch chat.
- Channel Point Rewards — connect Twitch Channel Points to Minecraft commands. Positive or negative effects, your choice.
- Live Announcements — automatic broadcast in-game and via Discord webhook the moment a streamer goes live, with zero manual steps.
- Live Tag via PlaceholderAPI — show who's currently streaming anywhere PlaceholderAPI is supported (tab list, chat, scoreboards, holograms).
- Watch Time Tracking — tracks how long each viewer has watched a streamer since installation, so you can gate rewards or chat commands behind a minimum watch time.
- Multi-Streamer Support — run drops, settings, and chat integration for several streamers at once, each with independent configuration.
- Configurable Drop Chance — fine-tune odds per streamer or globally to match your community size and economy.
- Cross-Platform — works on single Spigot/Paper/Purpur servers as well as BungeeCord and Velocity proxy networks, version-safe across Minecraft releases.
- No OAuth Required — all core features work without you needing to generate or manage a Twitch OAuth token.
Why streamers and server owners use it
Streamers get free promotion every time a viewer wants in-game drops badly enough to check out the server. Server owners get a built-in growth loop — viewers become players, players become community members, and the stream itself becomes a recurring event worth tuning in for.
Requirements
- SMLib (required dependency)
- Java 11+
- Open HTTPS port for outgoing requests
- The StreamingModule Twitch bot account must be set as a moderator in your channel
- Optional: PlaceholderAPI for the live tag feature
If /online throws an HTTP(S) error, your server is likely blocking outgoing connections — check your firewall/port settings.
Setup
Full step-by-step installation guide: Setup Wiki
Quick overview:
- Install SMLib and StreamingModule
- Start the server once to generate config files
- Add your Twitch channel name(s) in
streamer.yml
- Mod the StreamingModule bot in your Twitch chat (
/mod StreamingModule)
- Configure drops, rewards, and chat commands to taste
Want more?
The Premium version adds per-streamer drop lists, Twitch Events (Follow, Sub, GiftedSub, Bits, Raid, Poll), follow-bot protection, custom branding, and more — see the full Feature Overview for a side-by-side comparison.
Known incompatibilities
- Matrix Anti-Cheat (may cause issues, not guaranteed)
Support
- Run
/sm report in-game to generate a support file with the info needed to help you fast
- Join the Discord server — support is available in English and German
- Full documentation: GitHub Wiki
评论 0
登录后参与评分
还没有评论,来抢沙发吧