CraftLLC YouTube指令模组 [CYCM]

CraftLLC YouTube指令模组 [CYCM]

一个用于从YouTube聊天控制Minecraft的Minecraft模组。

游戏机制

CraftLLC YouTube 命令模组 (CYCM)

CYCM 是一款为希望在游戏中让观众真正做点事情而不仅仅是观看的主播打造的 Minecraft 模组。它将你的 YouTube 直播聊天和 Telegram 直接接入 Minecraft,让观众可以实时生成羊、投放 TNT,或串联起混乱的命令序列。

下载量 最新版本 Minecraft 版本

功能简介

  • 同时读取来自 YouTube 直播聊天和 Telegram 的命令
  • 通过 OAuth2(安全、规范的方式)与 YouTube 进行身份验证
  • 可在 直接 API 轮询 或 浏览器桥接 之间选择 —— 哪个更适合你的环境就用哪个
  • 支持使用 | 进行命令串联,让观众可以排队执行整段序列
  • 按设定的预算公平分配,带延迟地重复命令
  • 允许你屏蔽特定命令,防止任何破坏游戏的内容溜进来
  • 将重复的聊天消息合并为 x2、x3 等,而不是刷屏
  • 在动作栏显示实时状态悬浮层
  • 支持英语、乌克兰语和俄语
  • 为命令和聊天保留独立日志

命令语法

CYCM 不仅仅是转发器 —— 它是一个完整的命令引擎。以下是它的能力。

重复命令

/command +[次数] [延迟秒数]
  • /summon sheep +5 — 立即生成 5 只羊
  • /tnt +10 2 — 总共生成 10 个 TNT,每 2 秒一个
  • /say Hello +3 1 — 说三次 "Hello",每次间隔 1 秒

串联命令

用 | 分隔多个命令,它们将按顺序执行:

/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 <秒数>,即可在继续之前等待:

/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 提供了一个可在浏览器中打开的 Web 仪表盘 —— 非常适合双显示器环境。

使用方法:

  1. 在 Minecraft 中运行 /cycm http ui on
  2. 在浏览器中打开 http://localhost:21457(默认端口)
  3. 配置一切 —— 密钥、令牌、限制、屏蔽列表 —— 无需触碰游戏

更改即时生效。面板支持英语、乌克兰语和俄语。


内置游戏快捷方式

以下是 CYCM 为方便使用而添加的特殊简写命令:

快捷方式 功能
/tnt [数量] [半径] 默认生成一个 TNT。添加 数量 可在玩家处生成多个。再添加 半径 则生成环形。两者均受你的 CYCM 设置限制。
/ka 或 /killaura 杀死 20 格范围内的所有生物
/ke 或 /killentities 移除世界中所有非玩家实体
/blocklist 同 /cycm blocklist

配置

1. 安装模组

  1. 从 Modrinth 获取最新的 .jar
  2. 将其放入你的 Fabric mods 文件夹
  3. 使用 Fabric Loader 启动 Minecraft

2. YouTube — OAuth2(推荐)

  1. 前往 Google Cloud Console 并创建一个项目
  2. 启用 YouTube Data API v3
  3. 创建 OAuth 2.0 凭据(桌面应用类型)
  4. 在游戏中运行:
    /cycm youtube oa2client <YOUR_CLIENT_ID>
    /cycm youtube oa2secret <YOUR_CLIENT_SECRET>
    /cycm youtube connect
    
  5. 点击链接,在浏览器中授权,然后回到 Minecraft
  6. 启用来源:/cycm source on youtube

2b. YouTube — 简单 API 密钥(只读)

  1. 从 Google Cloud Console 获取 API 密钥
  2. 在游戏中运行:
    /cycm youtube key <YOUR_API_KEY>
    /cycm youtube id <YOUR_VIDEO_ID>
    /cycm ytmode api
    /cycm source on youtube
    

3. YouTube — 浏览器桥接模式

如果 API 方式对你不起作用,或者你想避免配额消耗,可以试试这个:

  1. 在游戏中运行 /cycm ytmode http
  2. 在 Tampermonkey 或 Violentmonkey 中安装 UserScript
  3. 在浏览器中打开你的 YouTube 直播
  4. 脚本会自动将聊天转发到你本地的 Minecraft 实例

4. Telegram

  1. 通过 @BotFather 创建一个机器人并复制令牌
  2. 在游戏中运行:
    /cycm tg token <YOUR_BOT_TOKEN>
    /cycm source on telegram
    
  3. 在 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! 🎉
🇷🇺 Русский
🎮 УПРАВЛЯЙ ИГРОЙ ЧЕРЕЗ ЧАТ!

Пишите сообщения или команды в чат YouTube — и они выполнятся прямо в моём Minecraft!

📝 Как это работает:
• Простые сообщения: Просто пишите в чат.
• Команды: Пишите команды (с / или без), например: /tnt, /killaura
• Повторения: /summon sheep +5 (заспавнит 5 овец)
• Задержка: /tnt +5 2 (динамит каждые 2 секунды)
• Лимиты: до 20 повторений, до 5 секунд задержки
• Несколько команд: /summon sheep | summon cow

⚔️ Специальные команды:
• /tnt — Заспавнить динамит
• /killaura (или /ka) — Убить всех мобов в радиусе 20 блоков
• /killentities (или /ke) — Убить всех мобов в мире

Я могу блокировать нежелательные команды, которые слишком мешают игре. Веселитесь! 🎉

致谢与支持


由创作者打造,为创作者服务。 🚀