Плагин Продажа Механика RefontTransmitter - Реалистичные рации с каналами и помехами [1.4]

---

О ПЛАГИНЕ

RefontTransmitter добавляет на сервер систему ручных раций с передачей голоса через Plasmo Voice или Simple Voice Chat. Игроки включают рацию, выбирают канал и общаются на расстоянии. Используемый голосовой движок выбирается в конфигурации.

Дальность связи зависит от типа рации, канала, расстояния и окружения. На большом расстоянии сигнал может ухудшаться, а передача — прерываться. В Plasmo Voice при ухудшении сигнала доступны звуковые помехи; в Simple Voice Chat ухудшение выражается потерей голосовых пакетов.

ВОЗМОЖНОСТИ

• Поддержка Plasmo Voice и Simple Voice Chat. Используемый голосовой движок задаётся в конфигурации.
• До 999 каналов с настраиваемым количеством.
• Именованные каналы со своей дальностью, permission и ограничениями по типам раций.
• Закрытые каналы для полиции, армии, администрации, фракций и других групп.
• Типы раций: Basic, Professional и Military.
• Для каждого типа отдельно настраиваются дальность, внешний динамик, батарея, SCAN и доступные каналы.
• Дальность до 1800 блоков по умолчанию.
• Помехи от расстояния, препятствий и погоды. На дальность связи также влияют высота, подземелья и измерение.
• В Plasmo Voice при ухудшении сигнала могут появляться шипение, щелчки, помехи и обрывы передачи.
• В Simple Voice Chat ухудшение сигнала выражается потерей голосовых пакетов.
• Реалистичное «пш-пш» при начале и завершении передачи.
• Коллизии передач: помехи, приоритет более сильного сигнала или смешивание голосов — в зависимости от настроек.
• BUSY — отдельное состояние занятого или конфликтующего канала.
• SCAN — приём передач с доступных каналов без постоянного ручного переключения.
• Отдельный предмет сканера. Сканер ищет передачи и показывает найденный канал на экране.
• Сканер можно использовать для передачи голоса на выбранном канале.
• Физические и виртуальные ретрансляторы для увеличения дальности связи.
• Отдельный расчёт качества сигнала для каждого принимающего игрока.
• Пространственный внешний динамик: окружающие слышат принятый голос рядом с игроком, у которого включён динамик.
• Опциональная батарея с разным расходом при ожидании, приёме, передаче и использовании SCAN.
• Настраиваемая зарядка раций и автоматическое выключение при полном разряде.
• Поддержка основной и левой руки.
• Отображение состояний OFF, ON, TX, RX, SCAN и BUSY на моделях.
• Экран рации показывает канал; экран сканера — состояние поиска и найденный канал.
• Индикация приёма и передачи в Action Bar.
• 4 языка: русский, английский, вьетнамский и китайский.
• Озвучка предупреждений ниже Y=0 через ресурспак.
• Поддержка собственных sound events из вашего ресурспака.
• Режим language: custom позволяет сохранить собственные тексты и комментарии.
• Подробный конфиг с комментариями.

УПРАВЛЕНИЕ

По умолчанию:

• ПКМ — включить или выключить рацию.
• Shift + ПКМ — следующий канал.
• Shift + ЛКМ — предыдущий канал.
• Для разговора назначьте клавишу передачи в настройках используемого голосового плагина.

Клавиша передачи настраивается в клиенте Plasmo Voice или Simple Voice Chat. Удерживать Shift для разговора не требуется.

Действия ПКМ, ЛКМ, Shift + ПКМ и Shift + ЛКМ можно изменить через конфиг, в том числе назначить включение SCAN.

Все действия с предметом работают, когда рация находится в основной или левой руке.

КОМАНДЫ

Основные:


Выдача раций и сканера:


Примеры:


Ретрансляторы:


Администрирование:


Команда /rt recharge доступна, если батарея включена.

Полная команда: /refonttransmitter

Алиасы:
/rt,
/transmitter,
/walkie

ПРАВА

• refonttransmitter.use — использование рации; доступно всем по умолчанию.
• refonttransmitter.give — выдача раций и предметов; только операторам по умолчанию.
• refonttransmitter.admin — управление плагином и административные команды; только операторам по умолчанию.
• refonttransmitter.repeater.place — установка физических ретрансляторов.
• refonttransmitter.repeater.break — разрушение физических ретрансляторов.

Для отдельных каналов и типов раций можно задать собственные permissions.

ТИПЫ РАЦИЙ И КАНАЛЫ

По умолчанию доступны:

• Basic — стандартная рация.
• Professional — увеличенная дальность и улучшенные характеристики.
• Military — ещё большая дальность и улучшенные характеристики.

Типы настраиваются в radio-types.yml. Можно создавать собственные профили раций и задавать их характеристики.

Каналы настраиваются в channels.yml. Для каждого канала можно указать название, дальность, permission и разрешённые типы раций.

SCAN И СКАНЕР

Режим SCAN позволяет принимать передачи с доступных каналов без постоянного ручного переключения. Доступность сканирования и список каналов зависят от настроек.

Отдельный сканер показывает состояние поиска и найденный канал на экране. Разрешения сканера на прослушивание каналов настраиваются отдельно. Сканер также можно использовать для передачи голоса на выбранном канале.

РЕТРАНСЛЯТОРЫ

Ретрансляторы увеличивают зону связи. Для каждой точки задаются радиус и каналы, через которые она работает.

Плагин поддерживает физические ретрансляторы, устанавливаемые в мире, и виртуальные ретрансляторы, созданные командами. Данные физических ретрансляторов сохраняются в:

repeaters.yml

БАТАРЕЯ

Система батареи выключена по умолчанию.

Можно отдельно настроить расход при:

• ожидании;
• приёме;
• передаче;
• использовании SCAN.

При низком заряде игрок получает предупреждение, а при 0% рация автоматически выключается.

Для зарядки используется команда:


По умолчанию Redstone восстанавливает 25% заряда. Предмет и количество восстанавливаемого заряда можно изменить в конфигурации.

ЗАВИСИМОСТИ

Обязательно:

• Paper или совместимое ядро версии 1.16.5 и новее.
• Java 17 или новее.
• Один из голосовых плагинов: Plasmo Voice или Simple Voice Chat.

Необязательно: ViaVersion и ViaBackwards понадобятся только серверу, который одновременно принимает клиентов разных версий.

РЕСУРСПАКИ

В комплект входят три варианта ресурспака:

• 1.16.5-1.20.4 — Legacy.
• 1.20.5-1.21.3 — Components.
• 1.21.4 и новее — Modern.

Варианты содержат модели и текстуры раций, сканера и ретранслятора, а также звуки плагина. В Modern-ресурспаке модели RefontTransmitter назначаются отдельно и не заменяют общие модели бумаги и нотного блока. CustomModelData предметов других плагинов сохраняются.

Выберите архив под версию клиента и установите его как серверный ресурспак.

УСТАНОВКА

1. Установите Plasmo Voice или Simple Voice Chat.
2. Поместите RefontTransmitter-Paper-1.x.jar в папку plugins.
3. Запустите сервер для создания файлов конфигурации.
4. Выберите используемый голосовой движок в настройках плагина.
5. Выберите подходящий ZIP-ресурспак для версии Minecraft клиента.
6. Укажите ссылку и SHA-1 ресурспака в настройках сервера либо предложите игрокам установить его вручную.
7. Полностью перезапустите сервер.
8. Выдайте рацию: /rt give <игрок>.
9. При необходимости выдайте сканер: /rt give <игрок> scanner.
10. Назначьте клавишу передачи в настройках используемого голосового плагина.

После установки ресурспака нажмите F3 + T или перезапустите Minecraft.

НАСТРОЙКА

Основные файлы:

• config.yml — голосовой движок, механика, помехи, батарея, окружение, динамик, управление и производительность.
• channels.yml — каналы и ограничения.
• radio-types.yml — типы раций и их характеристики.
• repeaters.yml — ретрансляторы.
• messages.yml — сообщения и оформление.

В конфигурации настраиваются:

• используемый голосовой движок;
• количество каналов и начальный канал;
• максимальная дальность;
• параметры отдельных каналов и типов раций;
• момент появления слабых и сильных помех;
• влияние расстояния, препятствий, погоды, высоты и измерения;
• вероятность одиночных и серийных обрывов;
• звуки и громкость помех;
• режим коллизий передач;
• доступность и параметры SCAN;
• радиус внешнего динамика;
• ретрансляторы;
• батарея и зарядка;
• Action Bar и оформление сообщений;
• язык: ru, en, vi, zh или custom;
• sound events для озвучки и собственных ресурспаков;
• интервалы обновления и кэширования;
• действия сочетаний клавиш.

После изменения настроек используйте:


СОВМЕСТИМОСТЬ

• Minecraft: 1.16.5 и новее.
• Ядро: Paper и совместимые форки.
• Java: 17+.
• Голосовой чат: Plasmo Voice или Simple Voice Chat.

FAQ

• Как выдать обычную рацию через DeluxeMenus?
  rt give %player_name% 1
  Также можно указать тип: rt give %player_name% professional 1
• Как выдать сканер?
  rt give %player_name% scanner 1
• Можно ли добавить свою озвучку в ресурспак?
  Да. Добавьте файл .ogg в ресурспак, пропишите sound event в assets/<namespace>/sounds.json и укажите его в конфигурации плагина. После этого обновите SHA-1 серверного ресурспака.
• Как оставить собственный перевод и комментарии?
  Укажите language: custom. В этом режиме плагин использует пользовательские тексты.
• Какие языки доступны?
  Русский ru, английский en, вьетнамский vi и китайский zh. После смены языка выполните /rt reload.
• Можно ли отключить батарею?
  Да. По умолчанию батарея отключена; её можно включить или выключить в config.yml.
• Можно ли сделать отдельный канал для группы?
  Да. В channels.yml каналу можно назначить permission и указать разрешённые типы раций.

ПОДДЕРЖКА

При обращении приложите:

• версию Minecraft;
• версию и название ядра;
• версию Java;
• версию Plasmo Voice или Simple Voice Chat;
• версию RefontTransmitter;
• файл logs/latest.log.

---