Документація Pulse Phone
Вимоги
2. Вимоги
| Що | Обов'язково? | Що буде без цього |
|---|---|---|
| OneSync увімкнено | Обов'язково | Перевірка під час запуску завершується помилкою OneSync ... off. Додайте set onesync on. |
| Game build 2699 або новіший | Обов'язково | Модель телефона не стрімиться. Задайте sv_enforceGameBuild. |
| oxmysql (або ghmattimysql, mysql-async) на MariaDB 10.6+ або MySQL 8 | Рекомендовано | Без запущеного SQL-ресурсу дані зберігаються в сховищі ключ/значення сервера. Вони зберігаються, але робити запити до них не можна, а якщо гравців більше приблизно 30, варто використовувати базу даних. |
| Голосовий скрипт: pma-voice, mumble-voip, SaltyChat, TokoVOIP або YACA | Рекомендовано | Дзвінки з'єднуються, але без звуку. |
| screenshot-basic | Рекомендовано (стандартний ресурс або полегшена копія з вашого завантаження: див. швидкий старт, крок 6) | Камера кадрує знімки, але не може зберігати фото. |
| Фреймворк | Необов'язково | Телефон працює в режимі standalone: телефони прив'язуються до ліцензії гравця, а телефон має власний банк. |
Повний блок server.cfg:
set onesync on
set sv_enforceGameBuild 2699 # or newer
ensure oxmysql
# ... your framework, then your inventory, banking, garage and housing scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
# ... scripts that use the phone ...База даних. Яке сховище використовує телефон, визначається під час кожного запуску:
| Ваш сервер | Де телефон зберігає дані |
|---|---|
| Запущено oxmysql, mysql-async або ghmattimysql, і база даних відповідає | База даних. Таблиці створюються під час першого запуску, а нові додаються самі після кожного оновлення. |
| Жодного SQL-ресурсу не запущено | Сховище ключ/значення сервера, автоматично. Воно зберігається після перезапусків, але запитів до нього робити не можна. Якщо гравців більше приблизно 30 або консоль попереджає, що збереження сховища повільне, використовуйте базу даних. |
| SQL-ресурс запущено, але база даних не відповідає протягом 30 секунд | Нічого не зберігається, доки вона не відповість. Консоль пояснює причину, а телефон повторює спробу кожні 15–60 секунд і сам завершує запуск, щойно база даних відповість. |
В останньому випадку можна наказати телефону використовувати натомість сховище ключ/значення через set phone_db_fallback "kvp" у server.cfg; ці дані залишаються в сховищі ключ/значення й ніколи не копіюються в базу даних пізніше, тож використовуйте це на тестовому сервері, а не як обхід зламаного з'єднання. Кожен запит також має 10-секундний ліміт: запит, на який база даних так і не відповіла, повертається як невдалий застосунку, що його надіслав, а консоль один раз називає цей запит.
Підтримувані бази даних: MariaDB 10.6 або новіша чи MySQL 8.0 або новіша. phone.sql кожного релізу перевіряється на свіжій базі MariaDB у SQL mode від MySQL 8, перш ніж збирається пакет. Старіші версії (MariaDB 10.4 або 10.5, MySQL 5.7) не тестуються й не підтримуються, навіть якщо можуть працювати.
phone.sql потрібен лише для хостингів, які не дозволяють ресурсу створювати таблиці. Collation у ньому не вказано: діє стандартний utf8mb4 вашого сервера, як і тоді, коли телефон сам створює таблиці. Його безпечно запускати на наявній базі даних, а повторний запуск нового файлу після оновлення додає лише те, чого бракує.
sv_stateBagStrictMode можна не вимикати. Усе, що інші гравці бачать щодо телефона (анімацію тримання, телефон у руці, його екран, ліхтарик), встановлює сервер після перевірки значення, а не гра гравця.
Перехід з іншого телефона
Таблиці іншого телефона. Якщо телефон, яким ви користувалися раніше, залишив таблиці з тими самими назвами (наприклад, phone_messages), під час першого запуску їх перейменовують на old_<name>, щоб Pulse Phone міг створити власні. Нічого не видаляється. Якщо вашому користувачу бази даних не дозволено перейменовувати таблиці, перевірка під час запуску показує [FAIL] Database з назвами таблиць: надайте користувачу права ALTER або перейменуйте кожну на old_<name> у своєму інструменті для бази даних (HeidiSQL, phpMyAdmin) і перезапустіть.