RefontTransmitter - Реалистичные рации с каналами и помехами

О ПЛАГИНЕ

RefontTransmitter добавляет на сервер полноценную систему ручных раций, работающую через Plasmo Voice.

Игроки включают рацию, выбирают канал и могут общаться на больших расстояниях. Чем хуже сигнал, тем заметнее становятся обрывы, щелчки и помехи.

В версии 1.2 появились разные типы раций, именованные и закрытые каналы, SCAN, BUSY, ретрансляторы, влияние окружения на сигнал и опциональная система батареи.

ВОЗМОЖНОСТИ

• До 999 каналов с настраиваемым количеством.
• Именованные каналы со своей дальностью, permission и ограничениями по типу рации.
• Закрытые каналы для полиции, армии, администрации, фракций и других групп.
• Разные типы раций: Basic, Professional и Military.
• Для каждого типа отдельно настраиваются дальность, внешний динамик, батарея, SCAN и доступные каналы.
• Дальность до 1800 блоков по умолчанию с возможностью полной настройки.
• Динамические помехи в зависимости от качества сигнала.
• Выпадения голосовых кадров, серии обрывов, щелчки, шипение и треск.
• Реалистичное «пш-пш» при начале и завершении передачи.
• Коллизии передач: при одновременном разговоре нескольких игроков на одном канале могут появляться сильные помехи или приоритет более сильного сигнала.
• BUSY — отдельная индикация занятого или конфликтующего канала.
• SCAN — приём передач с доступных каналов без постоянного ручного переключения.
• Ретрансляторы для увеличения дальности связи на выбранных каналах.
• Влияние окружения на сигнал: подземелья, перепад высоты, Overworld, Nether и End.
• Отдельный расчёт качества сигнала для каждого принимающего игрока.
• Пространственный внешний динамик: окружающие слышат принятый голос прямо от игрока с рацией.
• Опциональная система батареи с разным расходом при ожидании, приёме, передаче и SCAN.
• Зарядка раций настраиваемым предметом.
• Автоматическое выключение полностью разряженной рации.
• Поддержка основной и левой руки.
• Отображение состояний OFF, ON, TX, RX, SCAN и BUSY на модели.
• Экран показывает каналы 01-99 и компактные диапазоны 1xx-9xx.
• Индикация приёма и передачи в Action Bar.
• Русская, английская, китайская и вьетнамская локализация.
• Подробный конфиг с комментариями и большим количеством настраиваемых параметров.
• Оптимизированная пересылка исходных Opus-кадров без тяжёлого декодирования голоса на сервере.

УПРАВЛЕНИЕ

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

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

Действия можно изменить через config.yml.

Для разных сочетаний клавиш доступны включение/выключение, следующий канал, предыдущий канал, SCAN или отсутствие действия.

Рация поддерживается как в основной, так и в левой руке.

КОМАНДЫ

Основные команды:



Выдача раций:



Примеры:



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



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



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

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

ТИПЫ РАЦИЙ

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

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

Все параметры типов находятся в radio-types.yml.

Можно создавать собственные типы и задавать для них:

• множитель дальности;
• радиус внешнего динамика;
• расход батареи;
• поддержку SCAN;
• permission;
• список разрешённых каналов.

КАНАЛЫ

Каналы настраиваются в channels.yml.

Для канала можно указать:

• название;
• локализованные названия;
• собственную дальность;
• permission;
• разрешённые типы раций.

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

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

Ретрансляторы позволяют увеличить дальность радиосвязи.

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

Созданные ретрансляторы сохраняются в:

repeaters.yml

БАТАРЕЯ

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

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

• ожидании;
• приёме;
• передаче;
• работе SCAN.

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

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



По умолчанию требуется Redstone, а одна зарядка восстанавливает 25%.

Предмет и количество восстанавливаемого заряда можно изменить в конфиге.

ПОМЕХИ И КОЛЛИЗИИ

Чем дальше находятся игроки друг от друга, тем хуже становится сигнал.

Можно настроить:

• начало слабых помех;
• начало сильных помех;
• критическую дистанцию;
• вероятность потери голосовых кадров;
• серии обрывов;
• звуки помех;
• поведение при одновременных передачах.

Доступные режимы коллизий:

• static — сильные помехи при конфликте передач.
• strongest — принимается более сильный сигнал.
• mix — обычное одновременное воспроизведение.

Также можно запретить второму игроку начинать передачу, пока канал уже занят.

ПРАВА

• refonttransmitter.use — использование рации, доступно всем по умолчанию.
• refonttransmitter.give — выдача раций, только операторам по умолчанию.
• refonttransmitter.admin — управление плагином, ретрансляторами и админ-командами.

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

ЗАВИСИМОСТИ

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

• Paper или совместимое ядро версии 1.16.5 и новее.
• Java 17 или новее.
• Plasmo Voice 2.1.6 или новее.

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

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

РЕСУРСПАКИ

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

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

Ресурспаки содержат:

• 327 состояний моделей;
• 334 текстуры;
• 8 звуков.

Включены модели OFF, обычного режима, TX, RX, SCAN, BUSY и отображение каналов.

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

УСТАНОВКА

1. Установите Plasmo Voice 2.1.6+.
2. Поместите pv-refonttransmitter-Paper-1.2.jar в папку plugins.
3. Запустите сервер для создания файлов конфигурации.
4. Выберите подходящий ZIP-ресурспак.
5. Укажите ссылку и SHA-1 ресурспака в настройках сервера либо предложите игрокам установить его вручную.
6. Полностью перезапустите сервер.
7. Выдайте рацию: /rt give <игрок>.
8. Назначьте клавишу активации «Рация» в настройках Plasmo Voice.

При обновлении с версии 1.1 старые рации продолжают работать — перевыдавать их игрокам не требуется.

ФАЙЛЫ НАСТРОЙКИ

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

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



ОСНОВНАЯ НАСТРОЙКА

Через конфиги можно изменить:

• количество и начальный канал;
• названия и параметры отдельных каналов;
• типы раций;
• максимальную дальность;
• слабые и сильные помехи;
• критическую дистанцию;
• вероятность одиночных и серийных обрывов;
• звуки и громкость помех;
• режим коллизий передач;
• радиус внешнего динамика;
• ретрансляторы;
• влияние подземелий и разных миров на сигнал;
• систему батареи;
• Action Bar;
• интервалы обновления и кэширования;
• действия ПКМ, ЛКМ, Shift + ПКМ и Shift + ЛКМ.

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

• Minecraft: 1.16.5 - актуальные версии.
• Ядро: Paper и совместимые форки.
• Java: 17+.
• Plasmo Voice: 2.1.6+.

ПОДДЕРЖКА

Если вы нашли ошибку, приложите:

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

Сообщить о проблеме можно в обсуждении плагина или в Telegram.

Модель основана на «Walkie Talkie / BT 72.74» от sanekcloff и используется по лицензии CC BY 4.0. Модель была дополнительно переработана для RefontTransmitter.