Основноеai-voice
ai-voice
Голос по близости с дальностями, рация с несколькими частотами и телефонные звонки с громкой связью, на FiveM Legacy и Enhanced. Заменяет pma-voice.
ai-voice позволяет игрокам говорить друг с другом. Игроки рядом слышат друг друга в зависимости от расстояния, игроки на одной радиочастоте слышат друг друга где угодно, пока удерживается клавиша рации, а игроки в одном телефонном звонке слышат друг друга где угодно. Он работает и на FiveM Legacy (Mumble), и на FiveM для GTA V Enhanced (серверные голосовые каналы).
Что он делает в игре
- Дальности голоса. Игроки переключаются между заданными вами дальностями (по умолчанию Whisper 1.5 м, Normal 3 м, Shouting 6 м) клавишей дальности голоса. HUD показывает дальность.
- Рация. Игрок может слушать несколько частот одновременно (по умолчанию 3) и говорит на активной, удерживая клавишу рации. Когда кто-то начинает и заканчивает говорить, звучит щелчок (каждый игрок может его отключить).
- Рабочие частоты. Диапазоны частот можно закрепить за работами или бандами (полиция на 1–10). Игрок, который теряет работу или уходит с дежурства, автоматически покидает эти частоты.
- Анимация рации (по умолчанию выключена): персонаж держит наплечную рацию или рацию в руке во время разговора. Рабочие частоты могут выбрать свою анимацию.
- Телефонные звонки. Игроки в одном звонке слышат друг друга где угодно. Игроков в звонки помещают скрипты телефона.
- Громкая связь. Скрипт телефона может включить громкую связь звонка: игроки рядом с телефоном слышат звонок, и (по умолчанию) звонок тоже слышит их.
- Звуковые эффекты. Голоса по рации и телефону фильтруются как через динамик или телефон.
- Заглушение администратором.
/muteplyзаглушает игрока на некоторое время. Заглушение сохраняется после переподключения. - Громкость игрока. Каждый игрок может задать свою громкость рации и звонков; панель задаёт начальные значения.
Установка
Его устанавливает рецепт AI Core для txAdmin. Вручную: положите папку в resources/[ai]/ и добавьте ensure ai-voice в server.cfg после ensure ai-core. Ему нужен ai-core. Таблицы в базе данных у него нет.
- Удалите pma-voice, mumble-voip и TokoVOIP: ai-voice отвечает на их имена.
- ai-voice сам выставляет
voice_useNativeAudioиvoice_useSendingRangeOnly. - На FiveM Enhanced звуковым эффектам рации и телефона, а также скриптам, которые используют Mumble напрямую (tgiann-radio-v2, tgiann-phone, эффекты lb-phone), нужен
setr sv_mumble trueв вашем cfg. - Уже имеющиеся у вас convar’ы pma-voice (
voice_defaultVoiceMode,voice_enableRadios,voice_defaultRadioVolumeи другие) читаются один раз при первом запуске и копируются в панель для каждой настройки, которая ещё имеет значение по умолчанию. После этого приоритет у панели. voice_defaultCycleиvoice_defaultRadioзадают клавиши по умолчанию для привязок.
Настройки панели
Откройте админ-панель (F10) и выберите Voice.
Вкладка Settings
Voice system (голосовая система): FiveM Legacy говорит через Mumble; FiveM для GTA V Enhanced через серверные голосовые каналы.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Voice system | Automatic выбирает серверные голосовые каналы, если они есть у сервера (Enhanced), иначе Mumble. Изменение применяется при следующем запуске ai-voice. | Automatic / Server voice channels (Enhanced) / Mumble (Legacy) | Automatic |
| In use now | Только чтение: система, на которой ai-voice работает сейчас. |
Voice ranges (дальности голоса): на каком расстоянии слышно игрока. Игроки переключаются между этими дальностями клавишей дальности голоса.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Ranges | Список дальностей, у каждой Name и Distance (как далеко слышно на этой дальности). | от 1 до 6 дальностей, от 0.5 до 100 м каждая | Whisper 1.5 м, Normal 3 м, Shouting 6 м |
| Starting range | Позиция в списке, с которой начинает игрок (1 = первая дальность). | от 1 до 6 | 2 |
| Players can change their range | Выкл. оставляет всех на начальной дальности (скрипты всё равно могут её менять). | вкл. / выкл. | вкл. |
| Mumble reach factor | Только FiveM Legacy: голос получают игроки в пределах дальности, умноженной на это число (звук Mumble затухает на большем расстоянии, чем дальность). 3 является значением pma-voice. | от 1 до 5 x | 3 |
Radio (рация): игроки на одной частоте слышат друг друга где угодно, пока удерживается клавиша рации.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Radio on | Включает или выключает рацию для всех. | вкл. / выкл. | вкл. |
| Radio volume | Насколько громко звучат другие по рации, в процентах. Игроки могут изменить для себя. | от 0 до 100 % | 30 |
| Frequencies at once | Сколько частот игрок может слушать одновременно; говорит он на одной из них. | от 1 до 10 | 3 |
| Radio sound effect | Фильтрует голос как через динамик. На FiveM Enhanced для этого нужен setr sv_mumble true. | вкл. / выкл. | вкл. |
| Effect taken over by | Только чтение: запущенный скрипт, который приносит собственный эффект (tgiann-radio, tgiann-radio-v2). Пока он работает, эффект ai-voice остаётся выключенным. | ||
| Radio clicks | Щелчок, когда кто-то начинает и заканчивает говорить по рации. Игроки могут отключить его для себя. | вкл. / выкл. | вкл. |
| Send names to radio members | Скрипты раций, которые показывают список участников, получают имя персонажа каждого участника. | вкл. / выкл. | выкл. |
Radio animation (анимация рации): что делает персонаж, пока говорит по рации.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Radio animation on | Выкл.: никакой анимации ни на одной частоте. Скрипты также могут отключить её для одного игрока. | вкл. / выкл. | выкл. |
| Animation | Используется на каждой частоте без собственной анимации. | Hand on the shoulder radio / Talking into the shoulder radio / Radio held in the hand / Custom | Hand on the shoulder radio |
| Animation dictionary | Только Custom: словарь анимаций. | текст | random@arrests |
| Animation name | Только Custom: клип анимации. | текст | generic_radio_enter |
| Animation flag | Только Custom: флаг TaskPlayAnim. 49 = верхняя часть тела, по кругу, можно идти; 50 = верхняя часть тела, держит последний кадр, можно идти. | от 0 до 1023 | 49 |
| Radio animation in vehicles | Проигрывает анимацию и сидя в транспорте. | вкл. / выкл. | вкл. |
Phone calls (телефонные звонки): игроки в одном звонке слышат друг друга где угодно.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Phone calls on | Включает или выключает звонки. | вкл. / выкл. | вкл. |
| Call volume | Насколько громко звучит другая сторона, в процентах. Игроки могут изменить для себя. | от 0 до 100 % | 60 |
| Phone sound effect | Фильтрует голоса в звонке как через телефон. Выключите, если ваш скрипт телефона приносит собственный эффект звонка (lb-phone с CallEffects не определяется). | вкл. / выкл. | вкл. |
| Effect taken over by | Только чтение: запущенный скрипт с собственным эффектом звонка (tgiann-phone). | ||
| Let players' games join calls | Выкл. (безопасно): игроков в звонки помещают только серверные скрипты или скрипт телефона, который проверяет каждое присоединение. Вкл.: любой игрок мог бы присоединиться к любому звонку; нужно телефонам, которые присоединяются к звонкам из игры игрока, например lb-phone. | вкл. / выкл. | выкл. |
| Phone loudspeaker | Скрипты телефона могут включить громкую связь звонка: игроки рядом с телефоном слышат другую сторону. | вкл. / выкл. | вкл. |
| Loudspeaker reach | Игроки в пределах стольких метров от телефона слышат звонок. | от 0.5 до 15 м | 3 |
| Loudspeaker volume | Насколько громко звучит громкая связь, в процентах. | от 0 до 100 % | 60 |
| The call hears the people around | Другая сторона звонка также слышит игроков рядом с телефоном. | вкл. / выкл. | вкл. |
В игре небольшое фиксированное число слотов звуковых эффектов, и удалить слот нельзя. Выключение эффекта прекращает его использование; игроки освобождают его слот, только перезапустив игру.
Вкладка Frequencies
Радиочастоты, к которым могут присоединяться только некоторые работы, и их анимация. Каждая запись является диапазоном частот; нажмите New frequency range, чтобы добавить. Частоты вне всех диапазонов открыты для всех.
| Настройка | Что меняет | Значения | По умолчанию для нового диапазона |
|---|---|---|---|
| Name | Название в списке (например, "Police radio"). | от 1 до 48 символов | |
| From frequency | Первая частота, как её показывает рация (1, 1.5...). | от 0.01 до 1,000,000 | 1 |
| To frequency | Последняя частота. Не может быть ниже первой. | от 0.01 до 1,000,000 | 10 |
| Jobs | Присоединяться могут только участники этих работ. Оставьте работы и банды пустыми, чтобы было доступно всем. | названия работ | police |
| Gangs | Участники этих банд тоже могут присоединяться. | названия банд | пусто |
| Only on duty | Участники работы должны быть на дежурстве в этой работе. | вкл. / выкл. | вкл. |
| Animation | Анимация рации на этих частотах: по умолчанию, никакой или набор. | default / none / набор | default |
Команды
| Команда | Аргументы | Кто | Что делает |
|---|---|---|---|
/muteply | <id> [seconds] | администраторы | Заглушает голос игрока или снимает заглушение. seconds по умолчанию 900 (15 минут), не больше года. Игроку сообщают. |
/voicedebug | нет | администраторы | Печатает в консоль сервера дальность, частоты и звонок каждого игрока. |
Привязки клавиш
| Клавиша по умолчанию | Что делает | Название в настройках GTA |
|---|---|---|
| F11 | Меняет дальность голоса | Change voice range |
| Левый Alt | Говорить на активной радиочастоте, пока удерживается | Talk on the radio |
Значения по умолчанию берутся из convar’ов voice_defaultCycle и voice_defaultRadio, если вы их задали. Обе показываются в подсказках клавиш HUD ("Voice range", "Radio").
Работа с другими скриптами
- Заменяет pma-voice (делает
provideдляpma-voice,mumble-voip,tokovoip,toko-voip,tokovoip_script): его экспорты, state bags и события, поэтому скрипты раций, телефонов и HUD, написанные для pma-voice, работают без изменений. - tgiann-radio работает. tgiann-radio-v2 и tgiann-phone работают без своих особых файлов pma-voice; ai-voice выключает свой эффект рации или телефона, пока они работают.
- lb-phone нужно включённое Let players' games join calls и выключенный эффект телефона ai-voice, если вы используете собственные эффекты звонков lb-phone.
- ai-hud показывает дальность, разговор и рацию.
Известные ограничения
- Команд игрока из pma-voice (
/vol,/setvoiceintent) нет; игроки используют свои привязки клавиш и настройки скрипта рации. - На Enhanced дальность скрипта из собственной игры игрока (
overrideProximityRange) отклоняется: там дальности задают серверные скрипты. - Перезапуск ai-voice сохраняет дальность, активную частоту и звонок каждого игрока, но не дополнительные частоты, которые он слушал, и не громкую связь.
- Изменённая Voice system применяется при следующем запуске ai-voice.