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:

1. Run /cycm http ui on in Minecraft
2. Open http://localhost:21457 in your browser (default port)
3. 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

1. Grab the latest .jar from Modrinth
2. Drop it in your Fabric mods folder
3. Launch Minecraft with Fabric Loader

2. YouTube — OAuth2 (recommended)

1. Go to Google Cloud Console and create a project
2. Enable YouTube Data API v3
3. Create OAuth 2.0 credentials (Desktop app type)
4. In-game, run: /cycm youtube oa2client <YOUR_CLIENT_ID> /cycm youtube oa2secret <YOUR_CLIENT_SECRET> /cycm youtube connect
5. Click the link, authorize in your browser, come back to Minecraft
6. Enable the source: /cycm source on youtube

2b. YouTube — Simple API key (read-only)

1. Get an API key from Google Cloud Console
2. 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:

1. Run /cycm ytmode http in-game
2. Install the UserScript in Tampermonkey or Violentmonkey
3. Open your YouTube live stream in the browser
4. The script relays chat to your local Minecraft instance automatically

4. Telegram

1. Create a bot via @BotFather and copy the token
2. In-game, run: /cycm tg token <YOUR_BOT_TOKEN> /cycm source on telegram
3. 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) — Вбити всіх мобів у світі Я можу блокувати небажані команди, які занадто заважають грі. Веселіться! 🎉 🎮 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) — Убить всех мобов в мире Я могу блокировать нежелательные команды, которые слишком мешают игре. Веселитесь! 🎉

Credits & support

• YouTube: CraftLLC
• Telegram: CraftLLC
• GitHub: CraftLLC-Org/CYCM (GitHub repo is kinda outdated, i will fix soon)

Built by creators, for creators. 🚀