CraftLLC YouTube Command Mod (CYCM)
CYCM 是一款专为主播设计的 Minecraft 模组,旨在让你的观众真正在游戏里做点什么——而不仅仅是观看。它将你的 YouTube 实时聊天和 Telegram 直接接入 Minecraft,让观众能够生成绵羊、放置 TNT,或在实时中串联起混乱的命令序列。
功能介绍
- 同时读取来自 YouTube 实时聊天和 Telegram 的命令
- 通过 OAuth2 进行 YouTube 身份验证(安全且规范的方式)
- 支持在 Direct API polling(直接 API 轮询) 和 Browser Bridge(浏览器桥接) 之间选择——根据你的设置选用最合适的方式
- 支持使用
| 进行命令链式操作,让观众可以排队执行整个命令序列
- 重复执行命令并设置延迟,在你设定的预算范围内公平分配
- 允许你屏蔽特定命令,防止破坏游戏体验的命令混入
- 将重复的聊天消息合并显示为
x2、x3 等,避免刷屏
- 在动作栏中显示实时状态叠加层
- 支持英语、乌克兰语和俄语
- 为命令和聊天分别保留独立的日志
命令语法
CYCM 不仅仅是一个中继工具——它是一个完整的命令引擎。以下是它所能实现的功能。
重复命令
/command +[Count] [DelaySeconds]
/summon sheep +5 — 立即生成 5 只绵羊
/tnt +10 2 — 总共生成 10 个 TNT,每 2 秒生成一个
/say Hello +3 1 — 间隔 1 秒,连续说三次 "Hello"
命令链式操作
用 | 分隔多个命令,它们将按顺序执行:
/tnt | /summon zombie +5 2 | /say Watch out!
/tp @p ~ ~10 ~ | /summon creeper
/say Phase 1 | !sleep 3 | /say Phase 2
公平预算系统:如果全局限制为 20 次重复,而有人发送了 /cmd1 +15 | /cmd2 +10,模组会公平分配——cmd1 获得 15 次,cmd2 获得 5 次,总计仍保持在 20 次。
使用 !sleep 添加暂停
在命令链中的任何位置插入 !sleep <seconds>,可在继续之前等待指定时间:
/summon lightning_bolt | !sleep 2 | /tnt 8 5
/say Get ready | !sleep 5 | /say Go
转义特殊字符
如果你希望 + 或其他符号作为字面量处理,请使用 \ ——例如 /say \+10 会在聊天中实际显示 "+10",而不是被当作重复指令处理。
命令
核心控制
| 命令 |
作用 |
/cycm <on|off> |
开启或关闭整个模组 |
/cycm restart |
重新加载配置并重启所有内容 |
/cycm stop |
取消所有正在运行的重复命令和延迟命令 |
/cycm block <cmd> |
永久屏蔽某个命令 |
/cycm unblock <cmd|all> |
从黑名单中移除某个命令(或全部) |
/cycm blocklist |
显示当前被屏蔽的命令列表 |
/cycm execute <cmd> |
手动运行 CYCM 语法(也可用作 /ce) |
YouTube
| 命令 |
作用 |
/cycm ytmode <api|http> |
在直接 API 模式和浏览器桥接模式之间切换 |
/cycm youtube key <apiKey> |
设置你的 YouTube API 密钥 |
/cycm youtube id <videoId> |
设置直播视频 ID |
/cycm youtube oa2client <clientId> |
设置你的 OAuth2 客户端 ID |
/cycm youtube oa2secret <clientSecret> |
设置你的 OAuth2 客户端密钥 |
/cycm youtube connect |
启动 OAuth2 授权流程 |
/cycm youtube send <on|off> |
将 Minecraft 聊天消息发送到 YouTube(或取消发送) |
/cycm source <on|off> youtube |
启用或禁用 YouTube 作为数据源 |
Telegram
| 命令 |
作用 |
/cycm tg token <token> |
设置你的 Telegram 机器人令牌 |
/cycm source <on|off> telegram |
启用或禁用 Telegram 作为数据源 |
设置
| 命令 |
作用 |
/cycm source list |
查看所有已连接的数据源及其状态 |
/cycm grouping <on|off> |
切换聊天中的消息分组功能 |
/cycm actionbar <on|off> |
切换状态覆盖层(动作栏) |
/cycm num <N> |
每条消息的最大重复次数(默认:20) |
/cycm delay <S> |
最大延迟时间(秒)(默认:5) |
/cycm tnt count <N> |
同时生成的 TNT 最大数量(默认:20) |
/cycm tnt radius <R> |
TNT 环形半径最大值(默认:8) |
/cycm http messages port <port> |
浏览器模式下的 HTTP 服务器端口 |
/cycm http ui port <port> |
Web 控制面板的端口 |
/cycm http ui <on|off> |
启用或禁用 Web 控制面板 |
Web 控制面板
如果你不想在直播过程中输入冗长的命令,CYCM 提供了一个基于网页的控制面板,你可以在浏览器中打开它——非常适合双显示器设置。
使用方法:
- 在 Minecraft 中运行
/cycm http ui on
- 在浏览器中打开
http://localhost:21457(默认端口)
- 配置所有设置——密钥、令牌、限制、黑名单——无需接触游戏
更改会立即生效。该面板支持英语、乌克兰语和俄语。
内置游戏快捷键
这些是 CYCM 为方便起见而添加的特殊简写命令:
| 快捷键 |
功能说明 |
/tnt [数量] [半径] |
默认生成一个 TNT。添加 count(数量)可在玩家位置生成多个 TNT。同时添加 radius(半径)则会生成环形排列的 TNT。两者均受你的 CYCM 设置上限限制。 |
/ka 或 /killaura |
击杀 20 格范围内的所有生物 |
/ke 或 /killentities |
移除世界中除玩家以外的所有实体 |
/blocklist |
等同于 /cycm blocklist |
安装设置
1. 安装模组
- 从 Modrinth 下载最新的
.jar 文件
- 将其放入 Fabric 的
mods 文件夹中
- 使用 Fabric Loader 启动 Minecraft
2. YouTube — OAuth2(推荐)
- 前往 Google Cloud Console 并创建一个项目
- 启用 YouTube Data API v3
- 创建 OAuth 2.0 凭据(桌面应用程序类型)
- 在游戏中运行:
/cycm youtube oa2client <YOUR_CLIENT_ID>
/cycm youtube oa2secret <YOUR_CLIENT_SECRET>
/cycm youtube connect
- 点击链接,在浏览器中完成授权,然后回到 Minecraft
- 启用该源:
/cycm source on youtube
2b. YouTube — 简单 API 密钥(只读)
- 从 Google Cloud Console 获取一个 API 密钥
- 在游戏中运行:
/cycm youtube key <YOUR_API_KEY>
/cycm youtube id <YOUR_VIDEO_ID>
/cycm ytmode api
/cycm source on youtube
3. YouTube — 浏览器桥接模式
如果 API 方式对你不起作用,或者你想避免配额使用,请尝试以下方法:
- 在游戏中运行
/cycm ytmode http
- 在 Tampermonkey 或 Violentmonkey 中安装 UserScript
- 在浏览器中打开你的 YouTube 直播流
- 脚本会自动将聊天内容中继到你的本地 Minecraft 实例
4. Telegram
- 通过 @BotFather 创建一个机器人并复制令牌
- 在游戏中运行:
/cycm tg token <YOUR_BOT_TOKEN>
/cycm source on telegram
- 在 Telegram 中向你的机器人发送
/start
配置文件
所有内容都位于 config/cycm/ 目录下:
| 文件 |
包含内容 |
cycm.json |
主配置文件 — API 密钥、端口、模式、开关、黑名单、限制 |
live.json |
持久化状态 — OAuth 令牌、已处理的消息 ID、直播信息 |
commands_log.txt |
所有运行过的命令日志 |
chat_log.txt |
所有接收到的聊天消息日志 |
OAuth2 令牌会自动刷新。不要与任何人分享你的 live.json 文件。
安全性
- 屏蔽你不想要的任何内容:
/cycm block <command> — 重启后依然有效
- CYCM 自身的命令受到保护:观众无法远程执行
/cycm 或 /ce
- 合理的默认设置:最多重复 20 次,最大延迟 5 秒,最多放置 20 个 TNT,半径 8
!sleep 实际上会暂停链式操作,而不是快速执行完毕
- 聊天格式经过净化:颜色代码在任何发送到 YouTube 之前都会被剥离
故障排除
没有来自 YouTube 的消息?
- 重新运行
/cycm youtube connect 以检查认证状态
- 运行
/cycm source list 确认 YouTube 已启用
- 仔细检查你的视频 ID
- 查看
run/logs/latest.log 中的错误信息
无法向 YouTube 发送消息?
- 运行
/cycm youtube send on
- 确保 OAuth2 已获得正确的权限范围授权
HTTP 模式不起作用?
- 端口 21456 可能被阻止 — 检查你的防火墙
- 确认 UserScript 在你的浏览器中处于激活状态
- 打开浏览器控制台并查找错误
Telegram 机器人无响应?
- 检查你的令牌
- 确保你已向机器人发送了
/start
- 使用
/cycm source list 确认 Telegram 已启用
直播描述模板
复制其中一个到你的 YouTube 直播描述中,以便向观众解释情况:
?? Українська
? КЕРУЙ ГРОЮ ЧЕРЕЗ ЧАТ!
Пишіть повідомлення або команди в чат YouTube — і вони виконаються прямо в моєму Minecraft!
? Як це працює:
• Прості повідомлення: Просто пишіть у чат.
• Команди: Пишіть команди (з / або без), наприклад: /tnt, /killaura
• Повторення: /summon sheep +5 (заспавнить 5 овечок)
• Затримка: /tnt +5 2 (динаміт кожні 2 секунди)
• Ліміти: до 20 повторень, до 5 секунд затримки
• Декілька команд: /summon sheep | summon cow
⚔️ Спеціальні команди:
• /tnt — Заспавнити динаміт
• /killaura (або /ka) — Вбити всіх мобів у радіусі 20 блоків
• /killentities (або /ke) — Вбити всіх мобів у світі
Я можу блокувати небажані команди, які занадто заважають грі. Веселіться! ?
?? English
? CONTROL THE GAME VIA CHAT!
Write messages or commands in the YouTube chat — and they'll execute live in my Minecraft!
? How it works:
• Simple messages: Just type in chat.
• Commands: Enter commands (with or without /), e.g.: /tnt, /killaura
• Repetitions: /summon sheep +5 (spawns 5 sheep)
• Delays: /tnt +5 2 (5 TNT total, one every 2 seconds)
• Limits: up to 20 repetitions, up to 5 seconds delay
• Multiple commands: /summon sheep | summon cow
⚔️ Special commands:
• /tnt [count] [radius] — Spawn primed TNT or a TNT ring
• /killaura (or /ka) — Kill all mobs within 20 blocks
• /killentities (or /ke) — Remove all mobs from the world
I can block unwanted commands that disrupt gameplay too much. Have fun! ?
CraftLLC YouTube Command Mod (CYCM)
CYCM is a Minecraft mod built for streamers who want their audience to actually do things in the game — not just watch. It connects your YouTube Live Chat and Telegram straight into Minecraft, so viewers can spawn sheep, drop TNT, or chain together chaotic command sequences in real time.
What it does
- Reads commands from YouTube Live Chat and Telegram at the same time
- Authenticates with YouTube via OAuth2 (the secure, proper way)
- Lets you choose between Direct API polling or a Browser Bridge — whichever works better for your setup
- Supports command chaining with
| so viewers can queue up entire sequences
- Repeats commands with delays, fairly distributed across the budget you set
- Lets you block specific commands so nothing game-breaking slips through
- Groups duplicate chat messages into
x2, x3 etc. instead of flooding your screen
- Shows a live status overlay in the action bar
- Supports English, Ukrainian, and Russian
- Keeps separate logs for commands and chat
The command syntax
CYCM isn't just a relay — it's a proper command engine. Here's what it can do.
Repeating commands
/command +[Count] [DelaySeconds]
/summon sheep +5 — spawns 5 sheep immediately
/tnt +10 2 — spawns 10 TNT total, one every 2 seconds
/say Hello +3 1 — says "Hello" three times with a 1-second gap between each
Chaining commands
Separate multiple commands with | and they'll run in sequence:
/tnt | /summon zombie +5 2 | /say Watch out!
/tp @p ~ ~10 ~ | /summon creeper
/say Phase 1 | !sleep 3 | /say Phase 2
Fair budget system: if the global limit is 20 repeats and someone sends /cmd1 +15 | /cmd2 +10, the mod splits it fairly — cmd1 gets 15, cmd2 gets 5, total stays at 20.
Adding pauses with !sleep
Drop !sleep <seconds> anywhere in a chain to wait before continuing:
/summon lightning_bolt | !sleep 2 | /tnt 8 5
/say Get ready | !sleep 5 | /say Go
Escaping special characters
Use \ if you want a literal + or other symbol — so /say \+10 actually says "+10" in chat instead of being treated as a repeat.
Commands
Core controls
| Command |
What it does |
/cycm <on|off> |
Turns the whole mod on or off |
/cycm restart |
Reloads config and restarts everything |
/cycm stop |
Cancels all running repeats and delayed commands |
/cycm block <cmd> |
Permanently blocks a command |
/cycm unblock <cmd|all> |
Removes a command (or all) from the blocklist |
/cycm blocklist |
Shows what's currently blocked |
/cycm execute <cmd> |
Runs CYCM syntax manually (also works as /ce) |
YouTube
| Command |
What it does |
/cycm ytmode <api|http> |
Switch between Direct API and Browser Bridge mode |
/cycm youtube key <apiKey> |
Set your YouTube API key |
/cycm youtube id <videoId> |
Set the live stream video ID |
/cycm youtube oa2client <clientId> |
Set your OAuth2 Client ID |
/cycm youtube oa2secret <clientSecret> |
Set your OAuth2 Client Secret |
/cycm youtube connect |
Start the OAuth2 authorization flow |
/cycm youtube send <on|off> |
Send your Minecraft chat to YouTube (or not) |
/cycm source <on|off> youtube |
Enable or disable YouTube as a source |
Telegram
| Command |
What it does |
/cycm tg token <token> |
Set your Telegram bot token |
/cycm source <on|off> telegram |
Enable or disable Telegram as a source |
Settings
| Command |
What it does |
/cycm source list |
See all active connections and their status |
/cycm grouping <on|off> |
Toggle message grouping in chat |
/cycm actionbar <on|off> |
Toggle the status overlay |
/cycm num <N> |
Max repeats per message (default: 20) |
/cycm delay <S> |
Max delay in seconds (default: 5) |
/cycm tnt count <N> |
Max TNT spawned at once (default: 20) |
/cycm tnt radius <R> |
Max TNT ring radius (default: 8) |
/cycm http messages port <port> |
HTTP server port for browser mode |
/cycm http ui port <port> |
Port for the Web Control Panel |
/cycm http ui <on|off> |
Enable or disable the Web Control Panel |
Web Control Panel
If you'd rather not type long commands mid-stream, CYCM has a web-based dashboard you can open in your browser — great for dual-monitor setups.
To use it:
- Run
/cycm http ui on in Minecraft
- Open
http://localhost:21457 in your browser (default port)
- Configure everything — keys, tokens, limits, blocklists — without touching the game
Changes apply instantly. The panel supports English, Ukrainian, and Russian.
Built-in game shortcuts
These are special shorthand commands CYCM adds for convenience:
| Shortcut |
What it does |
/tnt [count] [radius] |
Spawns one TNT by default. Add count to spawn multiples at the player. Add radius too and it spawns a ring instead. Both are capped by your CYCM settings. |
/ka or /killaura |
Kills all mobs within 20 blocks |
/ke or /killentities |
Removes all non-player entities from the world |
/blocklist |
Same as /cycm blocklist |
Setup
1. Install the mod
- Grab the latest
.jar from Modrinth
- Drop it in your Fabric
mods folder
- Launch Minecraft with Fabric Loader
2. YouTube — OAuth2 (recommended)
- Go to Google Cloud Console and create a project
- Enable YouTube Data API v3
- Create OAuth 2.0 credentials (Desktop app type)
- In-game, run:
/cycm youtube oa2client <YOUR_CLIENT_ID>
/cycm youtube oa2secret <YOUR_CLIENT_SECRET>
/cycm youtube connect
- Click the link, authorize in your browser, come back to Minecraft
- Enable the source:
/cycm source on youtube
2b. YouTube — Simple API key (read-only)
- Get an API key from Google Cloud Console
- In-game, run:
/cycm youtube key <YOUR_API_KEY>
/cycm youtube id <YOUR_VIDEO_ID>
/cycm ytmode api
/cycm source on youtube
3. YouTube — Browser Bridge mode
If the API approach isn't working for you, or you want to avoid quota usage, try this instead:
- Run
/cycm ytmode http in-game
- Install the UserScript in Tampermonkey or Violentmonkey
- Open your YouTube live stream in the browser
- The script relays chat to your local Minecraft instance automatically
4. Telegram
- Create a bot via @BotFather and copy the token
- In-game, run:
/cycm tg token <YOUR_BOT_TOKEN>
/cycm source on telegram
- Send
/start to your bot in Telegram
Config files
Everything lives in config/cycm/:
| File |
What's in it |
cycm.json |
Main config — API keys, ports, modes, toggles, blocklist, limits |
live.json |
Persistent state — OAuth tokens, processed message IDs, stream info |
commands_log.txt |
Log of every command that ran |
chat_log.txt |
Log of all received chat messages |
OAuth2 tokens refresh automatically. Don't share your live.json file with anyone.
Safety
- Block anything you don't want:
/cycm block <command> — it persists across restarts
- CYCM's own commands are protected: viewers can't run
/cycm or /ce remotely
- Sane defaults: 20 max repeats, 5-second max delay, 20 max TNT, radius 8
!sleep actually pauses the chain rather than rushing through it
- Chat formatting is sanitized: color codes get stripped before anything goes to YouTube
Troubleshooting
No messages from YouTube?
- Re-run
/cycm youtube connect to check auth
- Run
/cycm source list to confirm YouTube is enabled
- Double-check your Video ID
- Look at
run/logs/latest.log for errors
Can't send messages to YouTube?
- Run
/cycm youtube send on
- Make sure OAuth2 is authorized with the right scopes
HTTP mode not working?
- Port 21456 might be blocked — check your firewall
- Confirm the UserScript is active in your browser
- Open the browser console and look for errors
Telegram bot not responding?
- Check your token
- Make sure you sent
/start to the bot
- Confirm Telegram is enabled with
/cycm source list
Stream description templates
Copy one of these into your YouTube stream description to explain things to your viewers:
?? Українська
? КЕРУЙ ГРОЮ ЧЕРЕЗ ЧАТ!
Пишіть повідомлення або команди в чат YouTube — і вони виконаються прямо в моєму Minecraft!
? Як це працює:
• Прості повідомлення: Просто пишіть у чат.
• Команди: Пишіть команди (з / або без), наприклад: /tnt, /killaura
• Повторення: /summon sheep +5 (заспавнить 5 овечок)
• Затримка: /tnt +5 2 (динаміт кожні 2 секунди)
• Ліміти: до 20 повторень, до 5 секунд затримки
• Декілька команд: /summon sheep | summon cow
⚔️ Спеціальні команди:
• /tnt — Заспавнити динаміт
• /killaura (або /ka) — Вбити всіх мобів у радіусі 20 блоків
• /killentities (або /ke) — Вбити всіх мобів у світі
Я можу блокувати небажані команди, які занадто заважають грі. Веселіться! ?
?? English
? CONTROL THE GAME VIA CHAT!
Write messages or commands in the YouTube chat — and they'll execute live in my Minecraft!
? How it works:
• Simple messages: Just type in chat.
• Commands: Enter commands (with or without /), e.g.: /tnt, /killaura
• Repetitions: /summon sheep +5 (spawns 5 sheep)
• Delays: /tnt +5 2 (5 TNT total, one every 2 seconds)
• Limits: up to 20 repetitions, up to 5 seconds delay
• Multiple commands: /summon sheep | summon cow
⚔️ Special commands:
• /tnt [count] [radius] — Spawn primed TNT or a TNT ring
• /killaura (or /ka) — Kill all mobs within 20 blocks
• /killentities (or /ke) — Remove all mobs from the world
I can block unwanted commands that disrupt gameplay too much. Have fun! ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧