GameVox для FiveM

Позиционный голосовой чат с пространственным 3D-звуком для вашего ролевого сервера FiveM. Игроки слышат друг друга с учётом расстояния и направления. Без TeamSpeak и без плагина SaltyChat.

Как это работает

GameVox GameLink связывает ваш сервер FiveM с голосовым чатом GameVox

Позиционный голос

Игроки слышат голоса рядом с собой, и чем дальше собеседник, тем тише. Дальность голоса настраивается: от шёпота (3m) до крика (15m) и мегафона (32m).

Пространственный 3D-звук

Вы слышите игроков в стерео с учётом того, в какой стороне они от вас. Голоса звучат слева, справа или по центру в зависимости от того, где стоит игрок.

Прямая замена

Заменяет SaltyChat без лишней возни. Установите ресурс, скажите игрокам пользоваться GameVox, и готово. TeamSpeak не нужен.

Требования

✓
Сервер FiveM с OneSync

Для синхронизации позиций игроков должен быть включён OneSync. Добавьте set onesync on в свой server.cfg. Если вы используете txAdmin, убедитесь, что он не переопределяет эту настройку.

✓
Десктопное приложение GameVox

У каждого игрока должно быть установлено десктопное приложение GameVox. Скачать здесь.

✓
Голосовой канал GameVox

Во время игры на сервере FiveM игроки должны находиться в одном и том же голосовом канале GameVox.

Настройка сервера

Установите ресурс GameVox на свой сервер FiveM за 3 шага

1

Скачайте ресурс

Скачайте ресурс gamevox и распакуйте его в папку resources/ вашего сервера.

2

Обновите server.cfg

Добавьте эти строки в свой server.cfg:

# Enable OneSync (required for GameVox proximity voice)
set onesync on

# Start the GameVox resource
ensure gamevox
3

Перезапустите сервер

Перезапустите сервер FiveM. В консоли сервера должно появиться [Gamevox] Server started. OneSync is enabled.. Если вместо этого вы видите ошибку OneSync, ещё раз проверьте свой server.cfg.

Настройка для игроков

Игроку на старт нужно около 30 секунд

1

Установите GameVox

Скачайте и установите десктопное приложение GameVox.

2

Зайдите в голосовой канал

Откройте GameVox и зайдите в тот же голосовой канал, что и ваши друзья по FiveM.

3

Запустите FiveM

Запустите FiveM и зайдите на сервер. GameVox автоматически распознаёт FiveM и включает позиционный голос. Когда вы перемещаетесь, игроки рядом звучат то громче, то тише.

4

Переключайте дальность голоса

Нажимайте F1, чтобы переключаться между уровнями дальности голоса:

3m Шёпот8m Обычный15m Крик32m Мегафон

Клавишу можно изменить в разделе Настройки FiveM > Назначение клавиш > GameVox.

5

Мегафон

Удерживайте B, чтобы включить мегафон: он увеличивает дальность вашего голоса до 100m. Отпустите клавишу, чтобы вернуться к обычной дальности. Пригодится для объявлений и ролевых сцен.

Клавишу можно изменить в разделе Настройки FiveM > Назначение клавиш > GameVox.

Настройка

Дальность голоса, клавиши и интервалы обновления настраиваются в config.lua

Config = {}

-- Voice ranges in meters (players cycle through these with F1)
Config.VoiceRanges = { 3.0, 8.0, 15.0, 32.0 }

-- Default voice range (1-based index, 2 = 8m normal)
Config.DefaultVoiceRangeIndex = 2

-- Keybind to cycle voice range (rebindable in FiveM settings)
Config.VoiceRangeKey = "F1"

-- Position update interval in milliseconds (280ms = SaltyChat standard)
Config.UpdateInterval = 280

-- Show voice range notification when cycling
Config.ShowVoiceRangeNotification = true

-- Megaphone: hold-to-use keybind that extends voice range
Config.MegaphoneRange = 100.0
Config.MegaphoneKey = "B"

API для разработчиков

Интеграция с системой смерти, пользовательскими именами и не только

SetPlayerAlive

Определяет, слышно ли игрока (для скриптов смерти и возрождения).

-- In your death script:
exports['gamevox']:SetPlayerAlive(playerId, false)

-- In your respawn script:
exports['gamevox']:SetPlayerAlive(playerId, true)

SetPlayerGameName

Задаёт игроку собственное игровое имя (для систем имён персонажей).

-- Set a custom name for voice identification
exports['gamevox']:SetPlayerGameName(playerId, "John_Doe")

Игровой оверлей

Смотрите, кто говорит, не выходя из игры

Режимы оверлея

Оверлей GameVox показывает участников голосового канала поверх игры. Если участников 5 или меньше, он показывает всех с аватарами, именами и индикаторами речи.

Если участников 6 и больше, оверлей переключается в режим «только говорящие»:

  • Говорит зелёный текст со значком звуковой волны
  • Недавно говорил белый текст, виден 3 секунды
  • Молчит убирается через 3 секунды
  • Когда никто не говорит, показывается «X пользователей в голосовом канале»

Оверлей автоматически меняет размер в зависимости от того, кто говорит. Позиция, размер, прозрачность и порог режима говорящих настраиваются в разделе Настройки GameVox > Игровой оверлей.

Готовы добавить позиционный голос?

Скачайте ресурс, установите его на сервер, и всё заработает