CraftLLC YouTube Command Mod [CYCM]

CraftLLC YouTube Command Mod (CYCM)

CYCM — это мод для Minecraft, созданный для стримеров, которые хотят, чтобы их зрители реально что-то делали в игре, а не просто смотрели. Он подключает ваш YouTube Live Chat и Telegram прямо к Minecraft, так что зрители могут спавнить овец, сбрасывать TNT или выстраивать хаотичные цепочки команд в реальном времени.

Что он делает

• Читает команды из YouTube Live Chat и Telegram одновременно
• Авторизуется в YouTube через OAuth2 (безопасным, правильным способом)
• Позволяет выбрать между прямым опросом API и Browser Bridge — что лучше подходит для вашей конфигурации
• Поддерживает цепочки команд через |, так что зрители могут выстраивать целые последовательности
• Повторяет команды с задержками, справедливо распределяя их в рамках заданного лимита
• Позволяет блокировать отдельные команды, чтобы ничего не сломало игру
• Группирует повторяющиеся сообщения чата в x2, x3 и т.д. вместо того, чтобы заваливать экран
• Показывает живой статус-оверлей в action bar
• Поддерживает английский, украинский и русский
• Ведёт отдельные логи для команд и чата

Синтаксис команд

CYCM — не просто ретранслятор, а полноценный движок команд. Вот что он умеет.

Повтор команд

/command +[Count] [DelaySeconds]

• /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" в чате, а не будет воспринято как повтор.

Команды

Основное управление

YouTube

Telegram

Настройки

Веб-панель управления

Если вам не хочется вводить длинные команды посреди стрима, у CYCM есть веб-дашборд, который можно открыть в браузере — отлично для конфигураций с двумя мониторами. Как использовать:

1. Выполните /cycm http ui on в Minecraft
2. Откройте http://localhost:21457 в браузере (порт по умолчанию)
3. Настройте всё — ключи, токены, лимиты, блоклисты — не трогая игру Изменения применяются мгновенно. Панель поддерживает английский, украинский и русский.

Встроенные игровые сокращения

Это специальные сокращённые команды, которые CYCM добавляет для удобства:

Установка

1. Установите мод

1. Скачайте последний .jar с Modrinth
2. Положите его в папку mods вашего Fabric
3. Запустите Minecraft с Fabric Loader

2. YouTube — OAuth2 (рекомендуется)

1. Перейдите в Google Cloud Console и создайте проект
2. Включите YouTube Data API v3
3. Создайте учётные данные OAuth 2.0 (тип Desktop app)
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. Получи API-ключ в [Google Cloud Console](https://console.cloud.google.com/)
2. В игре выполни:

/cycm youtube key <YOUR_API_KEY> /cycm youtube id <YOUR_VIDEO_ID> /cycm ytmode api /cycm source on youtube

### 3. YouTube — режим Browser Bridge
Если способ с API тебе не подходит или ты хочешь избежать расхода квоты, попробуй это:
1. Выполни в игре `/cycm ytmode http`
2. Установи [UserScript](https://craftllc.pp.ua/cycm/httpMode.user.js) в Tampermonkey или Violentmonkey
3. Открой свой прямой эфир на YouTube в браузере
4. Скрипт автоматически передаёт чат в твой локальный экземпляр Minecraft
### 4. Telegram
1. Создай бота через [@BotFather](https://t.me/BotFather) и скопируй токен
2. В игре выполни:

/cycm tg token <YOUR_BOT_TOKEN> /cycm source on telegram

3. Отправь `/start` своему боту в Telegram
---
## Файлы конфигурации
Всё лежит в `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 включён
- Ещё раз проверь свой Video ID
- Посмотри `run/logs/latest.log` на наличие ошибок
**Не получается отправлять сообщения на YouTube?**
- Выполни `/cycm youtube send on`
- Убедись, что OAuth2 авторизован с нужными scopes
**HTTP-режим не работает?**
- Порт 21456 может быть заблокирован — проверь свой фаервол
- Убедись, что UserScript активен в браузере
- Открой консоль браузера и поищи ошибки
**Бот Telegram не отвечает?**
- Проверь свой токен
- Убедись, что отправил боту `/start`
- Проверь, что Telegram включён, через `/cycm source list`
---
## Шаблоны описания стрима
Скопируй один из них в описание своего стрима на YouTube, чтобы объяснить всё зрителям:
<details>
<summary>🇺🇦 Українська</summary>

🎮 КЕРУЙ ГРОЮ ЧЕРЕЗ ЧАТ!

Пишіть повідомлення або команди в чат YouTube — і вони виконаються прямо в моєму Minecraft!

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

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

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

</details>
<details>
<summary>🇬🇧 English</summary>

🎮 УПРАВЛЯЙ ИГРОЙ ЧЕРЕЗ ЧАТ!

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

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

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

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

</details>