Pulse Phone — Быстрый старт

PhoneHub + Pulse — отдельная редакция со своей лицензией и собственной копией этого телефона. Если вы купили эту редакцию, следуйте её собственному руководству по установке: на сервере работает один ресурс телефона.

1. Проверьте сервер

Запускайте базу данных, framework, инвентарь, голосовой ресурс и screenshot-basic раньше Pulse. Правильный порядок смотрите в разделах требования и ваш framework.

Сделайте резервную копию базы данных перед первым запуском. Pulse создаёт собственные таблицы. Если другой телефон оставил таблицы с такими же именами, они переименовываются в old_<name> (ничего не удаляется); подробности — в разделе требования.

2. Скопируйте папку phone

Скачайте покупку в своём аккаунте Cfx.re. Скопируйте папку phone с файлом fxmanifest.lua в ресурсы сервера. Не меняйте её имя. Ключ вашего сервера должен принадлежать аккаунту, которому принадлежит ассет.

Загрузка по FTP (сервер на хостинге): используйте режим Binary (FileZilla: Transfer > Transfer Type > Binary) или загрузите zip и распакуйте его на сервере. Режим Auto изменяет защищённые файлы, и телефон отказывается запускаться; симптомы и решение — в разделе Устранение неполадок. Загружаемая папка должна соответствовать этой таблице; проверка при запуске называет любой отсутствующий файл или файл неверного размера.

Загрузка Pulse Phone 1.4.2:

Обновляете существующую установку? Сначала следуйте разделу Обновление, чтобы сохранить настройки и медиафайлы игроков. Остановите предыдущий ресурс телефона, прежде чем переходить на Pulse.

3. Добавьте предметы в инвентарь

Откройте раздел Инвентари и следуйте инструкциям для инвентаря, который вы уже используете. Прилагаемые определения и картинки лежат в config/items/. Добавляйте записи в свой инвентарь; не заменяйте весь его файл предметов.

Стандартный инвентарь ESX и QBCore могут регистрировать недостающие определения автоматически. Другим инвентарям могут понадобиться прилагаемые записи. Скопируйте картинки предметов туда, где их ожидает ваш инвентарь. В режиме standalone без инвентаря предметы не нужны.

4. Запустите Pulse

Оставьте автоматическое определение в config/config.lua. В первом разделе — framework, язык, выбор инвентаря, предмет телефона и клавиши. Необязательные настройки собраны в разделе Конфигурация.

Добавьте это после существующих зависимостей в server.cfg:

ensure phone
add_ace group.admin phone.admin allow

Перезапустите сервер. Pulse создаёт таблицы базы данных, когда доступно SQL-соединение. Прочитайте проверку в консоли и выполните указанные исправления. Запустите phone:health, чтобы повторить её.

5. Откройте телефон

Зайдите как администратор, откройте F8 и введите phone:setup. Подтвердите определённые framework и инвентарь, затем пройдите пошаговую настройку. Нажмите F1 или используйте /phone, чтобы открыть телефон. Если по вашим настройкам нужен предмет, сначала купите телефон и откройте его коробку из инвентаря.

Настройки, сохранённые в Settings → Server, переопределяют соответствующие настройки из файлов. Сбросьте там сохранённое переопределение, если хотите, чтобы снова применялось значение из файла.

6. По желанию: облегчённый screenshot-basic

В вашей загрузке также есть папка screenshot-basic. Это screenshot-basic от CitizenFX (лицензия MIT) с одним изменением: оригинал перерисовывает изображение игры для своего слоя захвата каждый кадр, даже когда никто не фотографирует, а эта копия рисует только во время съёмки фото. Имя ресурса, его экспорты (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) и события не изменились, и он поставляется уже собранным, поэтому ему не нужно собираться при первом запуске. Изменённые файлы перечислены в screenshot-basic/ZERODEV-CHANGES.md.

Pulse работает с любой копией, так что этот шаг необязателен. Другие скрипты на вашем сервере тоже используют screenshot-basic, поэтому, если есть тестовый сервер, сначала переключитесь на нём:

1. Переименуйте текущую папку screenshot-basic (например, в screenshot-basic.bak) и вынесите её из resources, чтобы можно было вернуть её обратно.
2. Скопируйте нашу в resources с тем же именем, screenshot-basic, и оставьте ту же строку ensure screenshot-basic.
3. Перезапустите сервер и проверьте каждый скрипт, который делает скриншоты: камеру телефона и любые инструменты для репортов, улик или бодикамер, которые у вас стоят.
4. Если что-то работает иначе, удалите нашу копию, верните старую папку под именем screenshot-basic и перезапустите сервер.

Настройте нужные вам функции

• Звонки, видео и Live: поддерживаемые голосовые ресурсы, управление звонками и настройка видеосоединения для продакшена.
• Фото и видео: встроенное хранилище, FiveManage и другие варианты загрузки. Приватные ключи сервисов остаются в конфигурации вашего сервера. На сервере на хостинге, чей веб-порт недоступен, для фото нужен FiveManage: две строки в server.cfg (set phone_media_provider "fivemanage" и set phone_fivemanage_token "<token>").
• Конфигурация: магазины, приложения, аксессуары, языки и необязательные функции.
• Устранение неполадок: найдите симптом и выполните его решение.
• Интеграции для разработчиков: кастомные скрипты и продвинутые настройки подключения.

Для обычной установки не нужно редактировать bridge/, ui/ или stream/. Держите ресурс целиком, включая его модели и ассеты карты.