SL Channel Point Mod

SLChannelPointMod

Мод для Minecraft на Fabric, который связывает награды за баллы канала Twitch с действиями в игре. Когда зрители активируют награды за баллы канала на вашем стриме в Twitch, мод автоматически запускает действия в вашем мире Minecraft.

Возможности

• Интеграция с Twitch — Подключается к Twitch EventSub для получения активаций наград за баллы канала в реальном времени
• Простая настройка через GUI — Вся настройка выполняется через интуитивное меню в игре

• Несколько типов действий:

  • Спавн мобов — Заспавнить любого моба рядом с игроком
  • Случайные мобы — Заспавнить случайных мобов из настраиваемого набора
  • Выдать предметы — Выдать предметы игроку
  • Случайные предметы — Выдать случайные предметы игроку
  • Наложить эффекты — Наложить эффекты зелий на игрока
  • Случайные эффекты — Наложить случайные эффекты из настраиваемого набора
  • Воспроизвести звуки — Воспроизвести любой звуковой эффект с настраиваемой громкостью и высотой тона
  • Выполнить команды — Выполнить любую серверную команду с плейсхолдерами
  • Особые действия — Перемешать инвентарь, выбросить предмет в руке, выбросить весь инвентарь
• Синхронизация с Twitch — Импорт существующих наград за баллы канала с вашего канала Twitch
• Публикация в Twitch — Создание новых наград за баллы канала прямо из мода
• Экранный HUD — Просмотр активаций по мере их поступления с настраиваемой позицией и масштабом
• Сохранение конфигурации — Награды сохраняются и остаются после перезапуска сервера

Требования

• Minecraft 1.21.10
• Fabric Loader 0.18.1+
• Fabric API
• Java 21+

Установка

1. Установите Fabric Loader
2. Скачайте Fabric API
3. Скачайте последний релиз SLChannelPointMod
4. Поместите все моды в папку mods

Настройка

1. Откройте GUI конфигурации

(Интерфейс разрабатывался под GUI 3, поэтому может работать некорректно с другими настройками.) Есть два способа открыть GUI конфигурации:

• Нажмите K (клавиша по умолчанию) в игре
• Введите /channelpoints в чате

2. Войдите в Twitch

1. Перейдите на вкладку Settings
2. Разверните Twitch Connection
3. Нажмите Login with Twitch
4. Откроется окно браузера — авторизуйте приложение
5. Вернитесь в игру после авторизации

3. Подключитесь к Twitch

После входа нажмите Connect, чтобы начать получать активации наград за баллы канала.

4. Настройте награды

Вариант A: Синхронизировать существующие награды из Twitch

1. Перейдите на вкладку Rewards
2. Нажмите Sync from Twitch, чтобы импортировать существующие награды за баллы канала
3. Выберите награду и нажмите Edit, чтобы настроить, какое действие она запускает Вариант B: Создать новые награды
4. Нажмите + Add Reward, чтобы создать новую награду
5. Введите название, стоимость и настройте действие
6. Нажмите Save
7. При желании нажмите Publish, чтобы создать награду на вашем канале Twitch Вот и всё! Когда зрители активируют баллы канала, настроенные действия сработают в игре.

Типы действий

Спавн моба

Спавнит мобов рядом со случайным игроком.

• Выберите тип моба с помощью кнопки обзора
• Задайте количество (или используйте случайный диапазон)

Случайный моб (Same/Each)

Спавнит случайных мобов из настроенного набора мобов.

• Same: Все заспавненные мобы одного случайного типа
• Each: Каждый моб выбирается случайно отдельно
• Настройте собственный набор мобов для каждой награды или используйте стандартные списки враждебных/мирных

Выдать предмет

Выдаёт предметы случайному игроку.

• Выберите предмет с помощью кнопки обзора
• Задайте количество

Случайный предмет (Same/Each)

Выдаёт случайные предметы игроку из всех доступных предметов.

• Same: Все выданные предметы одного случайного типа
• Each: Каждый предмет выбирается случайно отдельно

Наложить эффект

Накладывает эффект зелья на игрока.

• Выберите эффект с помощью кнопки обзора
• Задайте уровень (1 = Уровень I, 2 = Уровень II и т. д.)
• Задайте длительность в секундах

Случайный эффект

Накладывает случайный эффект зелья из настраиваемого набора.

• Настройте набор эффектов с помощью пресетов (вредные, полезные) или собственного выбора
• Задайте уровень и длительность

Воспроизвести звук

Воспроизводит звуковой эффект в месте нахождения игрока.

• Выберите из всех звуков Minecraft с кнопкой предпросмотра
• Настройте громкость (0.0 - 1.0) и высоту тона (0.5 - 2.0)

Выполнить команду

Запускает серверную команду с поддержкой плейсхолдеров.

• {player} — Заменяется на имя целевого игрока
• {redeemer} — Заменяется на имя пользователя Twitch, активировавшего награду
• {random:min:max} — Заменяется на случайное число в диапазоне Пример: say {redeemer} says hello to {player}! Пример: tp {player} ~ ~{random:5:20} ~

Особые действия

Предварительно настроенные особые действия:

• Shuffle Inventory — Перемешивает все предметы в инвентаре игрока
• Drop Held Item — Выбрасывает предмет, который игрок держит в руке
• Drop Inventory — Выбрасывает весь инвентарь игрока

Настройки HUD

Мод отображает экранные уведомления при активации наград. Настройте в Settings > HUD Settings:

• Position — Сверху слева, сверху справа, снизу слева или снизу справа
• Max Messages — Сколько активаций показывать одновременно (1-10)
• Scale — Размер текста HUD (0.5x - 2.0x)

Конфигурация

Конфигурация хранится в .minecraft/config/slchannelpointmod.json и включает:

• Токены аутентификации Twitch
• Информацию о канале
• Настроенные награды и их действия
• Настройки HUD
• Набор случайных мобов

Разрешения

Моду требуются следующие разрешения Twitch (запрашиваются при входе):

• channel:read:redemptions — Для получения событий активации наград за баллы канала
• channel:manage:redemptions — Для создания и удаления наград за баллы канала

Решение проблем

Не удаётся войти / Браузер не открывается

Скопируйте URL из чата/логов и откройте его вручную в браузере.

Награды не срабатывают

• Убедитесь, что вы подключены (проверьте статус Twitch Connection в Settings)
• Убедитесь, что у награды настроено действие (не отображается красным/ненастроенным)
• Попробуйте отключиться и подключиться заново

Токен истёк

Перейдите в Settings > Twitch Connection и нажмите Re-login.

Сборка из исходного кода

git clone https://github.com/andrewccard/SLChannelPointMod.git
cd SLChannelPointMod
./gradlew build

Собранный JAR будет в `build/libs/`.
## Лицензия
CC0-1.0