CraftLLC YouTube Command Mod [CYCM]

模组

· 作者 CraftLLC

一个 Minecraft 模组,让你可以通过 YouTube 聊天框来控制你的 Minecraft。

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 26.12 · 26.3 · Fabric

一键开服(送7天)

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 提供了一个基于网页的控制面板,你可以在浏览器中打开它——非常适合双显示器设置。

使用方法:

  1. 在 Minecraft 中运行 /cycm http ui on
  2. 在浏览器中打开 http://localhost:21457(默认端口)
  3. 配置所有设置——密钥、令牌、限制、黑名单——无需接触游戏

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


内置游戏快捷键

这些是 CYCM 为方便起见而添加的特殊简写命令:

快捷键 功能说明
/tnt [数量] [半径] 默认生成一个 TNT。添加 count(数量)可在玩家位置生成多个 TNT。同时添加 radius(半径)则会生成环形排列的 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! ?

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源