GD656FrontVoice

Обзор

GD656FrontVoice — это мод для Minecraft, который добавляет динамическую систему боевых голосовых реплик на мультиплеерные серверы. Он воспроизводит фракционные голосовые сигналы — китайские (CN), американские (US) и русские (RU) — срабатывающие при боевых событиях: получение урона, бросок гранаты, перезарядка, убийство врагов, подавление огнём и другое.

Последнее обновление: 25 июля 2026 г. Некоторые функции могут быть не полностью задокументированы или могут измениться.

Совместимость

• Настоятельно рекомендуется TACZ (Timeless and Classics Zero) 1.1.7-hotfix или новее — большинство триггеров боевых событий зависят от системы событий и API типов оружия TACZ;
• Мягкая совместимость с LR Tactical — определяет метаемые сущности для предупреждения о гранатах и сигналов при броске, а также эффект огня для обнаружения горения;
• Мягкая совместимость с GD656Conquest — определяет информацию о фракции/лагере для маршрутизации голосовых пакетов;
• На данный момент поддерживается только Minecraft 1.20.1 Forge.

Установка на сервер

Этот мод разделён на клиентскую и серверную функциональность. Для полной работы требуется установка на обе стороны.

Функции только для сервера:

Функции только для клиента:

Короче говоря: сервер обнаруживает и запускает все голосовые события; клиент отвечает за воспроизведение, маршрутизацию и ограничение. Сетевой трафик минимален (единственный самоописывающий тип пакета, ClientboundPlayAudioPacket).

Конфигурация и команды

Все параметры можно настроить через экран конфигурации мода Forge или с помощью игровых команд:

/gdfv debug summary              Показать статистику аудиоманифеста
/gdfv debug list [filter]        Список зарегистрированных звуковых событий
/gdfv debug play local <sound_event> [volume] [pitch]
/gdfv debug play position <sound_event> <pos> [volume] [pitch] [distance]
/gdfv debug play entity <sound_event> <entity> [volume] [pitch] [distance]
/gdfv debug play cue <voice_cue> <camp> <entity> [volume]
/gdfv config reload              Горячая перезагрузка файлов конфигурации

Команды требуют уровень разрешений 2 (оператор сервера). Изменения конфигурации вступают в силу немедленно; поддерживается горячая перезагрузка во время работы через перезагрузку конфигурации на основе рефлексии.

Ключевые параметры конфигурации

Конфигурация сервера (common):

Клиентский конфиг:

Возможности

Голосовые реплики по событиям

Следующие голосовые реплики срабатывают от определённых игровых событий на сервере:

Коридор подавляющего огня

Когда игрок стреляет из оружия TACZ, сервер вычисляет коридор огня — цилиндрический объём, простирающийся на 24 блока вперёд от позиции глаз стрелка с радиусом 1.6 блока вдоль направления взгляда. Каждый враждебный, живой игрок, не находящийся в режиме наблюдателя, внутри этого коридора получает один стак подавления.

• Стаки подавления на цели истекают через 20 тиков (1 секунду) с момента первого стака
• 6 стаков: вызывает SUPPRESSED на цели (или MACHINE_GUN_ALERT, если все стаки пришли от пулемёта)
• 9 стаков: дополнительно вызывает SUPPRESSING_HOSTILE на стрелке
• Кулдауны предотвращают повторный спам: 4 секунды на цель для suppressed, 4 секунды на стрелка для suppressing hostile, с 1-секундным разделительным гейтом для агрессивного сигнала

Обнаружение близкого пролёта снарядов

Когда спавнятся сущности пуль TACZ (EntityJoinLevelEvent), сервер начинает их отслеживать. Каждый тик отслеживаемые снаряды классифицируются по типу оружия:

• Снайперские пули (тип оружия sniper): радиус близкого пролёта 5 блоков
• Ракеты RPG (тип оружия rpg): радиус близкого пролёта 10 блоков

Для каждого снаряда сегмент перемещения между его последней и текущей позицией проверяется на пересечение с хитбоксами ближайших враждебных игроков с помощью пересечения сегмента с расширенным боксом. Обнаружение также срабатывает при первом прямом попадании из снайперской винтовки или RPG. Оба сигнала имеют 3-секундный кулдаун на цель.

Нераспознанные снаряды удаляются после 5 тиков проверки; мёртвые или удалённые снаряды очищаются автоматически.

Оповещение о гранатах и обнаружение броска

• Сканирование оповещений: Каждые 5 тиков сервер сканирует радиус в 5 блоков вокруг каждого игрока на предмет сущностей ThrowableItemEntity из LR Tactical типа EXPLOSIVE_GRENADE. Свои гранаты исключаются.
• Обнаружение броска: Каждый тик проверяется, активно ли игрок использует (удерживает правую кнопку мыши) метательный предмет из LR Tactical. Когда игрок начинает подготовку или переключается на другой тип гранаты, срабатывает соответствующий сигнал — THROW_SMOKE для дымовых гранат, THROW_GRENADE для осколочных гранат и коктейлей Молотова.

Режимы воспроизведения звука

Клиент поддерживает три режима воспроизведения:

Для воспроизведения от первого лица громкость масштабируется на firstPersonVolume; для третьего лица — на thirdPersonVolume. Если у сигнала нет варианта звука от первого лица, клиент может откатиться к варианту от третьего лица (управляется fallbackThirdPersonForLocal).

Ограничение звуков

Чтобы предотвратить перегрузку звуком в интенсивных перестрелках, клиент применяет троттлинг:

• Лимит от первого лица на игрока: Одновременно активен только один звук от первого лица, кроме BURNING (собственный список на сигнал) и сигналов с неограниченным приоритетом (DEATH, FINAL_DEATH и все звуки возрождения)
• Лимит от третьего лица на игрока: У одного игрока не может быть двух активных звуков от третьего лица
• Лимит от третьего лица на тип: Не более maxSimultaneousSingleTpSound (по умолчанию 2) экземпляров одного типа сигнала глобально
• Лимит игроков на лагерь: Не более maxSimultaneousTpPlayersFriendly (по умолчанию 3) дружественных и maxSimultaneousTpPlayersEnemy (по умолчанию 3) враждебных игроков, издающих звуки от третьего лица. При достижении лимита самый дальний игрок вытесняется, если новый игрок ближе

Наложение звуков

Некоторые сигналы воспроизводят несколько звуковых слоёв одновременно:

• DEATH: слой от первого лица fp.death.death + слой SFX fp.death.sfx; реакция союзника от третьего лица через tp.{camp}.death
• BURNING: три слоя от первого лица — fp.burning.scream + fp.burning.flame + fp.burning.spark

Интеграция с GD656Conquest

Когда на сервере установлен GD656Conquest, GD656FrontVoice автоматически обнаруживает его через reflection и использует его API для трёх целей:

1. Определение фракции: resolveCamp(player) возвращает фракцию игрока (CN/US/RU) из командной системы Conquest. Назначенный голосовой пак следует за фактической фракцией игрока, а не откатывается к значениям по умолчанию.
2. Проверка враждебности: isSameCamp(left, right) определяет, принадлежат ли два игрока к одной команде Conquest. Это заменяет ванильную проверку isAlliedTo для враждебности, то есть враждебными для подавления, предупреждения снайпера и предупреждения об RPG считаются только игроки из разных команд Conquest.
3. Отложка сигнала смерти: shouldDeferDeathCue(player) позволяет Conquest управлять тем, воспроизводится ли голосовой сигнал смерти сразу или откладывается (например, для систем downed/revive).

Без GD656Conquest: все игроки по умолчанию используют голосовой пак CN; враждебность по фракциям откатывается к ванильным проверкам альянса.

На клиенте опция конфига ignoreConquestCamp позволяет игрокам переопределить фракцию, полученную от сервера, и вместо неё использовать свои настройки friendlyVoicePack / enemyVoicePack.

Примечания

• Для полной функциональности мод требует установки как на клиенте, так и на сервере;
• Мод находится в активной разработке (0.x); функции могут продолжать развиваться;
• Часть кода была создана с помощью ИИ-технологий;
• Лицензировано под MIT License.