Документація Pulse Phone
Pulse Phone — Швидкий старт
Установіть один ресурс під назвою phone. Залиште свій наявний фреймворк і підтримувані скрипти; Pulse визначить їх під час запуску.
PhoneHub + Pulse — окреме видання з власною ліцензією та власною копією цього телефона. Якщо ви купили це видання, натомість дотримуйтеся його власного посібника зі встановлення: сервер запускає один ресурс телефона.
1. Перевірте свій сервер
| Що | Потрібно? |
|---|---|
| OneSync увімкнено, game build 2699 або новіший | Обов'язково |
| База даних: oxmysql (або mysql-async, ghmattimysql) на MariaDB 10.6+ або MySQL 8 | Рекомендовано. Без SQL-ресурсу телефон зберігає дані в сховищі ключ/значення сервера |
| Один голосовий ресурс: pma-voice, mumble-voip, SaltyChat, TokoVOIP або YACA | Рекомендовано. Без нього дзвінки з'єднуються, але без звуку |
| screenshot-basic | Рекомендовано, щоб камера могла зберігати фото. Стандартний ресурс працює |
| Фреймворк та інвентар | Необов'язково. Без них телефон працює в режимі standalone |
Запускайте базу даних, фреймворк, інвентар, голосовий ресурс і screenshot-basic раніше за Pulse. Правильний порядок див. у розділах вимоги та ваш фреймворк.
Перед першим запуском зробіть резервну копію бази даних. Pulse створює власні таблиці. Якщо інший телефон залишив таблиці з тими самими назвами, їх перейменовують на old_<name> (нічого не видаляється); подробиці — у розділі вимоги.
2. Скопіюйте папку phone
Завантажте свою покупку з акаунту Cfx.re. Скопіюйте папку phone, що містить fxmanifest.lua, у ресурси свого сервера. Не змінюйте її назву. Ключ вашого сервера має належати акаунту, якому належить асет.
Вивантаження через FTP (сервер на хостингу): використовуйте режим Binary (FileZilla: Transfer > Transfer Type > Binary) або вивантажте zip і розпакуйте його на сервері. Режим Auto змінює захищені файли, і телефон відмовляється запускатися; симптоми та рішення — в Усуненні несправностей. Вивантажена папка має відповідати цій таблиці; перевірка під час запуску називає кожен файл, якого бракує або який має неправильний розмір.
Завантаження Pulse Phone 1.4.2:
| Папка або файл | Файли | Розмір |
|---|---|---|
ui/ |
3,932 | 78,3 МБ |
stream/ |
40 | 30,5 МБ |
config/ |
138 | 23.2 MB |
d6c1e95a/ (заблокований код; його назва відрізняється в кожному релізі) |
7 | 5,5 МБ |
data/ |
2 | 1,4 МБ |
bridge/ |
55 | 0,5 МБ |
guides/ |
13 | 0,2 МБ |
phone.sql |
1 | 0,2 МБ |
fxmanifest.lua |
1 | 6 КБ |
уся папка phone |
4,204 | 139.7 MB |
Оновлюєте наявне встановлення? Спершу виконайте кроки з Оновлення, щоб зберегти налаштування й медіафайли гравців. Зупиніть попередній ресурс телефона, перш ніж переходити на Pulse.
3. Додайте предмети в інвентар
Відкрийте Інвентарі й дотримуйтеся інструкцій для інвентаря, яким ви вже користуєтеся. Надані визначення та зображення лежать у config/items/. Додавайте записи у свій інвентар; не замінюйте весь його файл предметів.
Стандартний інвентар ESX і QBCore можуть автоматично реєструвати відсутні визначення. Іншим інвентарям можуть знадобитися надані записи. Скопіюйте зображення предметів туди, де їх очікує ваш інвентар. Режим standalone без інвентаря не потребує предметів.
4. Запустіть Pulse
Залиште автоматичне визначення в config/config.lua. Перший розділ містить фреймворк, мову, вибір інвентаря, предмет телефона й клавіші. Необов'язкові налаштування перелічено в Конфігурації.
Додайте це після наявних залежностей у server.cfg:
ensure phone
add_ace group.admin phone.admin allowПерезапустіть сервер. Pulse створює таблиці бази даних, коли доступне SQL-з'єднання. Прочитайте перевірку в консолі й виконайте вказані виправлення. Запустіть phone:health, щоб повторити її.
5. Відкрийте телефон
Зайдіть як адміністратор, відкрийте F8 і введіть phone:setup. Підтвердьте визначені фреймворк та інвентар, потім пройдіть покрокове налаштування. Натисніть F1 або скористайтеся /phone, щоб відкрити телефон. Якщо ваші налаштування вимагають предмет, спершу купіть телефон і відкрийте його коробку з інвентаря.
Налаштування, збережені в Settings → Server, мають пріоритет над відповідними налаштуваннями у файлах. Скиньте там збережене значення, якщо хочете, щоб знову діяло значення з файлу.
6. Необов'язково: полегшений screenshot-basic
Ваше завантаження також містить папку screenshot-basic. Це screenshot-basic від CitizenFX (ліцензія MIT) з однією зміною: оригінал щокадру перемальовує зображення гри для свого шару захоплення, навіть коли ніхто не фотографує, а ця копія малює лише під час зйомки фото. Назва ресурсу, його exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) та events не змінилися, і він постачається вже зібраним, тож йому не потрібно збиратися під час першого запуску. Змінені файли перелічено в screenshot-basic/ZERODEV-CHANGES.md.
Pulse працює з будь-якою копією, тож цей крок необов'язковий. Інші скрипти на вашому сервері теж використовують screenshot-basic, тому спершу перейдіть на тестовому сервері, якщо він у вас є:
- Перейменуйте свою поточну папку
screenshot-basic(наприклад, наscreenshot-basic.bak) і перенесіть її зresources, щоб її можна було повернути. - Скопіюйте нашу в
resourcesпід тією самою назвою,screenshot-basic, і залиште той самий рядокensure screenshot-basic. - Перезапустіть сервер і перевірте кожен скрипт, що робить знімки екрана: камеру телефона та будь-які інструменти для репортів, доказів чи бодикамер, які у вас є.
- Якщо щось працює інакше, видаліть нашу копію, поверніть свою стару папку як
screenshot-basicі перезапустіть.
Налаштуйте функції, якими користуєтеся
- Дзвінки, відео та Live: підтримувані голосові ресурси, керування дзвінками й налаштування відеоз'єднання для продакшну.
- Фото й відео: вбудоване сховище, FiveManage та інші варіанти вивантаження. Приватні ключі сервісів залишаються в конфігурації вашого сервера. На сервері на хостингу, веб-порт якого недоступний, для фото потрібен FiveManage: два рядки в
server.cfg(set phone_media_provider "fivemanage"іset phone_fivemanage_token "<token>"). - Конфігурація: магазини, застосунки, аксесуари, мови та необов'язкові функції.
- Усунення несправностей: знайдіть симптом і виконайте його рішення.
- Інтеграції для розробників: власні скрипти й розширені налаштування підключення.
Звичайне встановлення не потребує редагування bridge/, ui/ чи stream/. Тримайте ресурс цілим, разом із його моделями та ресурсами мапи.