Stream Tweaks

Stream Tweaks

Свяжи Minecraft с Twitch

StreamTweaks — клиентский мод для Minecraft на Fabric и NeoForge, который связывает твой геймплей в Minecraft с Twitch, делая стримы более интерактивными и увлекательными. Он позволяет видеть чат Twitch прямо внутри Minecraft и даёт инструменты для более удобного взаимодействия со зрителями.

Возможности

• 💬 Отображение чата Twitch в Minecraft — оставайся на связи со зрителями, не выходя из игры.
• 🔐 Аутентификация Twitch через OAuth — безопасно входи в свой аккаунт Twitch прямо из игры.
• 🗑️ Удалённые сообщения исчезают — когда модератор удаляет сообщение в Twitch, соответствующая строка убирается из чата Minecraft.
• 😀 Эмоуты Twitch — статичные и анимированные (GIF) эмоуты Twitch отображаются прямо в чате Minecraft.
• 🎨 Цвета ников в чате — ники отображаются в цвете чата Twitch каждого зрителя.
• ⚙️ Интеграция с ModMenu (только Fabric) — проверяй статус аутентификации и подключённые каналы, а также входи/выходи и подключай/отключай каналы через экран настроек с GUI.

Область удаления сообщений: поддерживается только удаление отдельных сообщений модераторами (channel.chat.message_delete). Массовые удаления из-за таймаута, бана или очистки чата не отображаются — такие сообщения остаются видимыми в чате Minecraft.

О логах: сообщения чата записываются в logs/latest.log по мере их отображения, как и любые другие строки чата Minecraft. Сообщение, удалённое в Twitch, убирается только из отображения чата — его текст остаётся в лог-файле в виде обычного текста.

Планируемые улучшения

• Инструменты модерации чата (бан и т. д.)
• Уведомления о событиях (фолловы, сабы, рейды)
• Функции взаимодействия со зрителями

Требования

• Minecraft 26.2
• Java 25+

• Fabric:

  • Fabric Mod Loader 0.19.3+
  • Fabric API
  • ModMenu (опционально, только Fabric) — включает экран настроек в игре

• NeoForge:

  • NeoForge 26.2.0.25-beta+
• Порт 7654, доступный на localhost (используется для OAuth-колбэка Twitch)

Установка

1. Установи Fabric или NeoForge для Minecraft 26.2.
2. Для Fabric скачай Fabric API и положи его в папку mods.

3. Скачай подходящий .jar StreamTweaks со страницы Releases:

   • Fabric: `stream-tweaks-fabric-mc26.2-.jar`
   • NeoForge: `stream-tweaks-neoforge-mc26.2-.jar`
4. Положи .jar StreamTweaks в папку .minecraft/mods.
5. Запусти Minecraft с соответствующим профилем Fabric или NeoForge.

Использование

Команды /twitch доступны и на Fabric, и на NeoForge. Экран настроек ModMenu доступен только в сборке для Fabric.

Шаг 1 — Аутентификация в Twitch

/twitch login

В чате появится кликабельная ссылка. Нажми на неё, чтобы открыть страницу авторизации Twitch в браузере. После подтверждения в Minecraft появится сообщение об успехе. Если не успеешь завершить авторизацию вовремя, запрос истечёт — просто выполни /twitch login снова.

Примечание: аккаунт разработчика Twitch и настройка приложения не требуются. StreamTweaks использует собственное встроенное приложение Twitch. Твои учётные данные сохраняются локально и остаются после перезапуска игры, так что войти нужно только один раз.

Шаг 2 — Подключение к каналу Twitch

/twitch connect <channel>

Замени `на название канала Twitch (например,/twitch connect etwas`). Сообщения из этого канала начнут появляться внутри Minecraft.

Шаг 3 — Отключение от канала

/twitch disconnect

Прекращает приём чата с указанного канала. Поддерживается автодополнение по Tab для вывода списка каналов, к которым вы сейчас подключены.

### Выход из аккаунта

/twitch logout

Выполняет выход из Twitch и автоматически отключается от всех каналов, на которые вы подписаны.

---
# Stream Tweaks

## Связываем Minecraft и Twitch

StreamTweaks — это клиентский мод для Fabric / NeoForge, который связывает Minecraft и Twitch, делая стримы более интерактивными и интересными.

Вы можете читать чат Twitch прямо в Minecraft, а также получаете функции для более удобного взаимодействия со зрителями.

## Возможности

💬 **Отображение чата Twitch прямо в Minecraft**
Вы можете читать комментарии зрителей, не выходя из игры.

🔐 **Авторизация Twitch OAuth**
Вы можете безопасно войти в аккаунт Twitch прямо из Minecraft.

🗑️ **Скрытие удалённых сообщений**
Когда модератор удаляет сообщение в Twitch, это сообщение удаляется и в чате Minecraft.

😀 **Поддержка эмотов Twitch**
Статичные эмоты и анимированные GIF-эмоты Twitch отображаются прямо в чате Minecraft.

🎨 **Поддержка цветов имён пользователей в чате**
Имена зрителей отображаются с использованием цвета чата, который каждый из них настроил в Twitch.

⚙️ **Интеграция с ModMenu (только в версии для Fabric)**
В окне настроек GUI можно посмотреть состояние авторизации Twitch и подключённые каналы. Также можно выполнять вход и выход из аккаунта, а также подключаться к каналам и отключаться от них.

### Область действия функции удаления сообщений

Поддерживается только удаление отдельных сообщений модератором (`channel.chat.message_delete`).

Таймауты, баны и массовая очистка чата не отражаются на стороне Minecraft. Эти сообщения остаются в чате Minecraft как есть.

### О логах

Сообщения чата, как и обычный чат Minecraft, записываются в `logs/latest.log` в момент отображения.

Если сообщение удалено в Twitch, оно исчезает из чата Minecraft, но остаётся в лог-файле в виде обычного текста.

## Планируемые функции

* Функции модерации чата, такие как баны
* Уведомления о событиях: подписки, фолловы, рейды и т. д.
* Функции взаимодействия со зрителями

## Требования

* Minecraft 26.2
* Java 25 или выше

### Fabric

* Fabric Mod Loader 0.19.3 или выше
* Fabric API
* ModMenu (опционально, только для версии Fabric)

  * Требуется для использования экрана настроек в игре

### NeoForge

* NeoForge 26.2.0.25-beta или выше

### Общее

* Для обратного вызова Twitch OAuth локальный порт `7654` должен быть доступен

## Установка

1. Установите Fabric или NeoForge, совместимые с Minecraft 26.2.
2. Если вы используете Fabric, скачайте Fabric API и поместите его в папку `mods`.
3. Со страницы Releases скачайте файл `.jar` StreamTweaks, соответствующий вашему загрузчику модов.

Fabric:

`stream-tweaks-fabric-mc26.2-<version>.jar`

NeoForge:

`stream-tweaks-neoforge-mc26.2-<version>.jar`

4. Поместите скачанный файл `.jar` StreamTweaks в папку `.minecraft/mods`.
5. Запустите Minecraft с соответствующим профилем Fabric или NeoForge.

## Использование

Команда `/twitch` доступна как в версии для Fabric, так и в версии для NeoForge.

Экран настроек через ModMenu доступен только в версии для Fabric.

### Шаг 1 — Вход в Twitch

```text
/twitch login

В чате появится кликабельная ссылка.

Нажмите на ссылку, чтобы открыть страницу авторизации Twitch в браузере, и разрешите доступ. После завершения авторизации в Minecraft появится сообщение об успехе.

Если не завершить авторизацию в течение определённого времени, запрос на авторизацию истечёт. В этом случае выполните /twitch login ещё раз.

Примечание

Создавать аккаунт Twitch Developer или настраивать приложение Twitch не нужно.

В StreamTweaks уже встроено собственное приложение Twitch.

Учётные данные сохраняются локально и остаются после перезапуска игры, поэтому обычно достаточно войти один раз.

Шаг 2 — Подключение к каналу Twitch

/twitch connect <channel>

Замените `` на название канала Twitch, к которому хотите подключиться.

Пример:

/twitch connect etwas

После подключения сообщения чата этого канала начнут отображаться в Minecraft.

Шаг 3 — Отключение от канала Twitch

/twitch disconnect <channel>

Прекращает приём чата с указанного канала.

Поддерживается автодополнение по Tab для вывода списка каналов, к которым вы сейчас подключены.

Выход из Twitch

/twitch logout

Выполняет выход из Twitch и автоматически отключается от всех каналов, на которые вы подписаны.