🇷🇺 Русский · 🇬🇧 English

PlasmoParrots

PlasmoParrots — это плагин для Paper и Plasmo Voice (аддон к PlasmoVoice), который позволяет попугаям поблизости подслушивать фрагменты реальной речи игроков и повторять их забавными писклявыми «попугайскими» голосами.

Плагин не генерирует текст, субтитры, шутки или заранее записанные реплики. Каждый повтор создаётся исключительно из настоящего голосового сообщения игрока, только что произнесённого через Plasmo Voice.

Возможности

• Буферизует короткие фрагменты речи игроков из Plasmo Voice.
• Позволяет одному или нескольким попугаям отвечать со своих позиций.
• Повторяет фразы с повышенным тоном, дрожащим тремоло, яркими «чирикающими» всплесками и характерными «попугайскими» хвостами.
• Добавляет отдельный ползунок громкости Parrots в интерфейс Plasmo Voice.
• Поставляется с набором весёлых пресетов, делающих звучание более игрушечным, хаотичным и высоким.

Требования

• Paper от 1.21.11 до 26.2 (сборка проверяется CI на обеих границах диапазона).
• Java 21 для Paper 1.21.11; для новых версий Paper используйте требуемую ими версию Java.
• Серверный плагин Plasmo Voice 2.1.13 или совместимая версия.
• Для прослушивания повторов игрокам необходим клиентский мод Plasmo Voice.

Установка

1. Для основной сборки установите JDK 25+ и выполните:

./scripts/build-plugin.sh --clean

Для проверки совместимости с Paper 1.21.11 и Java 21:

./scripts/build-plugin.sh --clean --compat-1.21.11

Обе сборки создают Java 21-совместимый JAR.

2. Скопируйте файл target/PlasmoParrots-*.jar в папку plugins/ вашего сервера.
3. Убедитесь, что Plasmo Voice установлен на сервере.
4. Запустите или перезапустите сервер.

Поведение по умолчанию

Стандартная конфигурация специально настроена так, чтобы попугаи были активными и забавными:

• повторяют речь немного чаще;
• используют более короткие и выразительные фрагменты;
• несколько попугаев могут отвечать одновременно;
• звук заметно выше по тону;
• эффекты сильнее склоняются к пискам, чириканью, «гелиевым» голосам и игрушечным свисткам.

В результате плагин сразу создаёт ощущение «одержимых плюшевых попугаев», не превращая голосовой чат в полный хаос.

Настройка

После первого запуска создаётся файл:

plugins/PlasmoParrots/config.yml

Полезные параметры

• repeat-chance — вероятность того, что выбранный попугай решит повторить фразу.
• repeat-duration-* — длина повторяемого фрагмента речи.
• pitch-factor — общий множитель высоты голоса перед применением эффектов.
• parrots-max и parrot-stagger-* — определяют, будут ли отвечать одиночные попугаи или целая стая.
• effects — набор эффектов, отвечающих за степень «сломанных игрушек» в звучании.
• phrase-idle-millis — пауза, после которой фраза считается законченной.
• max-concurrent-replays — ограничение одновременной обработки повторов.

Если сервер начинает звучать слишком шумно, сначала уменьшите:

• repeat-chance
• parrots-max
• pitch-factor

Команды

/plasmoparrots status

Показывает состояние интеграции и текущие настройки плагина.

/plasmoparrots reload

Перезагружает config.yml, очищает буферы и заново регистрирует источник звука.

/plasmoparrots debug on|off

Включает или отключает режим отладки и сохраняет настройку в конфигурации.

Алиасы

/pparrots
/parrots

Права

plasmoparrots.admin
plasmoparrots.reload

Интеграция с Plasmo Voice

PlasmoParrots регистрирует отдельный источник звука под названием Parrots.

Игроки могут изменить его громкость через меню:

Plasmo Voice → Volume → Sources Volume → Parrots

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

Конфиденциальность

Аудио хранится только в оперативной памяти на короткое время и никогда не записывается на диск. Плагин принимает звук только через штатную proximity-активацию Plasmo Voice после проверки её требований и не перехватывает общий поток сырых голосовых событий.

Автор

Lazarrew