Документація Pulse Phone
Деталі встановлення
1. Швидке встановлення
Перш ніж щось копіювати
Використовуйте серверний артефакт, що відповідає вимогам нижче, з увімкненим OneSync і game build 2699 або новішим. Для звичайного RP-сервера спершу переконайтеся, що працюють фреймворк, інвентар, oxmysql, голосовий ресурс і screenshot-basic. Режим standalone працює й без фреймворку; предмети в інвентарі там необов'язкові.
Завантажте ресурс зі свого акаунту Cfx.re після отримання покупки. Використовуйте ключ сервера, що належить акаунту, якому належить асет. Якщо Cfx.re повідомляє про помилку прав (entitlement), виправте зв'язок акаунта й ключа; зміна налаштувань телефона не може надати ці права.
Крок 1 — Додайте ресурс на сервер
Розпакуйте пакет і скопіюйте папку ресурсу phone, що містить fxmanifest.lua, у каталог resources свого сервера. Не перейменовуйте її й не кладіть на її місце зовнішню папку ZIP/пакета.
На сервері на хостингу вивантажуйте в режимі Binary або вивантажте zip і розпакуйте його там (чому). Швидкий старт (крок 2) наводить кількість файлів і розмір кожної папки для цієї збірки, а перевірка під час запуску називає кожен файл, якого бракує або який має неправильний розмір.
Зупиніть попередній ресурс телефона перед тестуванням Pulse, щоб два телефони не конкурували за ту саму клавішу й предмет. Зробіть резервну копію його даних, якщо плануєте імпортувати їх пізніше.
Крок 2 — Додайте предмети в інвентар
Оберіть свій наявний інвентар; замінювати його не потрібно.
| Ваш інвентар | Що потрібно зробити |
|---|---|
| ox_inventory | Відкрийте наданий config/items/ox_inventory.lua. Додайте його записи в ox_inventory/data/items.lua, усередину наявної таблиці. Не замінюйте весь файл інвентаря. Залиште власний запис phone в ox_inventory: його використання відкриває Pulse Phone, і рядок Phone item у перевірці під час запуску це підтверджує. Замінюйте його виведеним записом лише тоді, коли цей рядок каже, що він відкриває інший скрипт. Скопіюйте зображення з config/items/images/ у ox_inventory/web/images/. Після редагування перезапустіть сервер. |
| qb-inventory з QBCore | Відсутні визначення предметів реєструються автоматично під час запуску. Скопіюйте config/items/images/ у qb-inventory/html/images/. Якщо вашому інвентарю потрібні постійні shared-записи, наданий config/items/qb-core.lua готовий до додавання в qb-core/shared/items.lua. |
| Стандартний інвентар ESX | Відсутні предмети додаються автоматично. Якщо консоль просить перезапуск, перезапустіть один раз, щоб ESX їх прочитав. Якщо ваш обліковий запис бази даних не може їх додати, використайте config/items/esx.sql. |
| qs-inventory або інший підтримуваний інвентар | Дотримуйтеся короткого рядка для вашого інвентаря в розділі Предмети та інвентарі. Використовуйте його власний список предметів і папку зображень. |
| Standalone без інвентаря | Записи в інвентарі не потрібні. Залиште вимоги до предметів вимкненими. |
Перевірка під час запуску визначає відсутні записи й виводить лише ті визначення, які вам ще потрібні. Інвентарю, що завантажує визначення предметів під час запуску, як-от ox_inventory, потрібні записи вище; Pulse не перезаписує файли іншого ресурсу.
Крок 3 — Перевірте основну конфігурацію
Відкрийте config/config.lua. Значення за замовчуванням визначають вашу наявну конфігурацію:
Config.Framework = 'auto'Залиште inventory = 'auto' у наявній таблиці Config.Providers. Якщо у вас кілька ресурсів інвентаря, задайте в цьому значенні той інвентар, який збираєтеся використовувати, наприклад 'ox_inventory'. Не додавайте другу таблицю Config.Providers чи Config.Item у кінець файлу.
У наявній таблиці Config.Item оберіть, як працюють телефони:
| Налаштування | Що воно робить |
|---|---|
required = false, unique = false |
Кожен персонаж має телефон без потреби носити предмет. Зручно для першого тесту. |
required = true, unique = false |
Персонажу потрібен предмет phone, щоб відкрити свій телефон. Передача цього предмета не переносить його дані. |
unique = true |
Кожен предмет телефона має власний номер і дані. Передача предмета передає цей телефон. Потрібен ox_inventory, qb-inventory, qs-inventory, core_inventory або codem-inventory. |
name = 'phone' |
Назва предмета в інвентарі. Не змінюйте її, якщо не змінюєте також наданого визначення предмета. |
Унікальні телефони використовують вибраний міст інвентаря. Залиште Config.Item.inventory = 'auto'; це старе перевизначення потрібне лише для наявних розширених установлень. Config.Providers.inventory має пріоритет, якщо задане явно.
Не змінюйте Config.IdentityScope на наявному сервері. Значення за замовчуванням, 'character', тримає телефони різних персонажів окремо.
Необов'язково: телефони як предмети й платний зв'язок
Щоб вимагати окремий предмет-телефон для кожного телефона, задайте required = true і unique = true у наявній таблиці Config.Item у config/config.lua після додавання записів в інвентар. Використовуйте один з інвентарів для унікальних телефонів, перелічених вище.
Щоб продавати мобільний зв'язок, задайте Config.Carrier.enabled = true у тому самому файлі. Це вмикає застосунок Carrier, де гравці купують тариф. Новим телефонам потрібен тариф, перш ніж стануть доступні звичайні дзвінки, повідомлення та застосунки з мобільними даними. App Hub — це місце, де гравці встановлюють застосунки, а не магазин зв'язку. Задайте Config.Coverage.enabled = true, якщо вам також потрібні зони покриття. Покриття й платні тарифи — окремі опції; залиште будь-яку з них вимкненою, якщо ця функція вам не потрібна.
Редагуйте наявні налаштування, а не додавайте дублікати таблиць. Після збереження перезапустіть сервер. Якщо налаштування раніше зберігали в грі, скиньте його в Settings → Server, щоб діяло значення з вашого файлу.
Крок 4 — Запускайте залежності раніше за Pulse
Залиште наявні налаштування підключення до бази даних і фреймворку. Додавайте лише відсутні рядки; не запускайте другу копію жодної залежності.
Використовуйте такий порядок для ресурсів, уже встановлених на вашому сервері:
- Ресурс бази даних і його наявні налаштування підключення.
- Фреймворк і його обов'язкові бібліотеки, ресурси ідентичності та персонажів.
- Інвентар із конфігурацією цього інвентаря для вашого фреймворку.
- Один підтримуваний голосовий ресурс і
screenshot-basic. ensure phone.
Не встановлюйте ESX, QBCore чи інший інвентар лише заради Pulse. Оберіть свою наявну конфігурацію в розділі Ваш фреймворк, щоб побачити приклад порядку запуску саме для неї. Qbox визначається як Qbox, навіть коли інший ресурс використовує його QBCore-сумісні exports.
Для адміністраторського доступу до Pulse додайте add_ace group.admin phone.admin allow. Ваш обліковий запис адміністратора вже має належати до group.admin, щоб цей дозвіл діяв.
Крок 5 — Прочитайте перевірку першого запуску
Перезапустіть сервер. Pulse виводить звіт про запуск і автоматично створює таблиці бази даних, коли доступне SQL-з'єднання.
- FIX / FAIL: обов'язкова частина не може працювати. Виконайте вказане виправлення, перш ніж дозволяти гравцям нею користуватися.
- NOTE / WARN: прочитайте, якої функції це стосується; деякі попередження описують необов'язкові функції, які ви не налаштовували.
- Запустіть
phone:healthу консолі сервера, щоб повторити перевірку. - Запустіть
phone:diag, щоб побачити вибрані фреймворк/інвентар/постачальників. - Як адміністратор зайдіть на сервер, відкрийте F8 і запустіть
phone:setupдля наявного покрокового налаштування.
Налаштування, збережені в адміністраторському налаштуванні в грі, мають пріоритет над відповідними налаштуваннями у файлах. Якщо зміна у файлі ніби ігнорується, перевірте Settings → Server і скиньте збережене значення, перш ніж змінювати інші файли.
Крок 6 — Перевірте як гравець
- Завантажте персонажа, натисніть F1 і пройдіть налаштування телефона. Якщо ввімкнено вимоги до предметів, спершу купіть телефон у магазині або видайте персонажу налаштований предмет телефона.
- Якщо ви купили запечатану коробку, використайте коробку з інвентаря, щоб розпакувати її, потім завершіть налаштування. Телефон надходить увімкненим; з
Config.Device.arrivesOn = falseспершу утримуйте End або O. - Відкрийте Messages, Contacts і Phone. Поверніться на головний екран, відкрийте перемикач застосунків і закрийте кожен застосунок по черзі.
- Зробіть фото й коротке відео. Відкрийте обидва в Photos, закрийте й знову відкрийте телефон і переконайтеся, що вони залишилися.
- Перепідключіться й перевірте, що той самий персонаж має той самий телефон. Перевірте дзвінки з другим гравцем через встановлений голосовий ресурс.
Де що змінювати
| Що ви хочете змінити | Файл або місце |
|---|---|
| Фреймворк, постачальник інвентаря, предмет телефона, магазин, моделі, призначення клавіш | config/config.lua |
| Постачальник голосу | config/config.lua |
| Налаштування застосунків і служб/робіт | config/apps.lua |
| Записи в інвентарі та зображення | config/items/ |
| Підключення до бази даних, порядок запуску ресурсів, облікові дані медіахостингу | server.cfg (тримайте приватні облікові дані на стороні сервера) |
| Інтеграції для розробників | Розширені інтеграції, необов'язковий Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) і наявні файли bridge/; звичайне встановлення не потребує їх редагування |
| Фото/відео гравців у вбудованому сховищі | media/; зберігайте цю папку під час оновлення |
Розділи нижче містять докладний довідник. Щоб завершити перше встановлення, не потрібно читати налаштування кожної функції.