Dokumentacja Pulse Phone

Pulse Phone — Szybki start

Zainstaluj jeden resource o nazwie phone. Zostaw swój obecny framework i obsługiwane skrypty; Pulse wykrywa je przy starcie.

Dla Pulse Phone 1.4.24 min czytaniaAktualizacja

PhoneHub + Pulse to osobna edycja z własną licencją i własną kopią tego telefonu. Jeśli kupiłeś tę edycję, zamiast tego postępuj według jej własnego poradnika instalacji: serwer używa jednego resource'a telefonu.

1. Sprawdź swój serwer

Co Potrzebne?
Włączony OneSync, game build 2699 lub nowszy Wymagane
Baza danych: oxmysql (albo mysql-async, ghmattimysql) na MariaDB 10.6+ lub MySQL 8 Zalecane. Bez resource'a SQL telefon trzyma dane w magazynie key/value serwera
Jeden resource głosowy: pma-voice, mumble-voip, SaltyChat, TokoVOIP albo YACA Zalecane. Bez niego połączenia się łączą, ale nie ma dźwięku
screenshot-basic Zalecane, żeby aparat mógł zapisywać zdjęcia. Działa standardowy resource
Framework i ekwipunek Opcjonalne. Bez nich telefon działa w trybie standalone

Uruchamiaj bazę danych, framework, ekwipunek, resource głosowy i screenshot-basic przed Pulse. Właściwą kolejność znajdziesz w wymaganiach i w sekcji twój framework.

Zrób kopię zapasową bazy danych przed pierwszym startem. Pulse tworzy własne tabele. Jeśli inny telefon zostawił tabele o tych samych nazwach, są przemianowywane na old_<name> (nic nie jest usuwane); szczegóły są w wymaganiach.

2. Skopiuj folder phone

Pobierz zakup ze swojego konta Cfx.re. Skopiuj folder phone zawierający fxmanifest.lua do resources swojego serwera. Zachowaj jego nazwę. Klucz twojego serwera musi należeć do konta, które posiada asset.

Wgrywasz przez FTP (serwer na hostingu): używaj trybu Binary (FileZilla: Transfer > Transfer Type > Binary) albo wgraj zip i rozpakuj go na serwerze. Tryb Auto zmienia zablokowane pliki i telefon odmawia startu; objawy i rozwiązanie są w Rozwiązywaniu problemów. Wgrany folder musi zgadzać się z tą tabelą; sprawdzenie startowe wymienia każdy brakujący plik albo plik o złym rozmiarze.

Paczka Pulse Phone 1.4.2 do pobrania:

Folder lub plik Pliki Rozmiar
ui/ 3,932 78,3 MB
stream/ 40 30,5 MB
config/ 138 23.2 MB
d6c1e95a/ (zablokowany kod; jego nazwa różni się w każdym wydaniu) 7 5,5 MB
data/ 2 1,4 MB
bridge/ 55 0,5 MB
guides/ 13 0,2 MB
phone.sql 1 0,2 MB
fxmanifest.lua 1 6 KB
cały folder phone 4,204 139.7 MB

Aktualizujesz istniejącą instalację? Najpierw postępuj według Aktualizacji, żeby zachować ustawienia i media graczy. Zatrzymaj poprzedni resource telefonu przed przejściem na Pulse.

3. Dodaj przedmioty do ekwipunku

Otwórz Ekwipunki i postępuj według instrukcji dla ekwipunku, którego już używasz. Dołączone definicje i obrazki są w config/items/. Dołącz wpisy do swojego ekwipunku; nie zastępuj całego jego pliku przedmiotów.

Domyślny ekwipunek ESX i QBCore potrafią automatycznie zarejestrować brakujące definicje. Inne ekwipunki mogą wymagać dołączonych wpisów. Skopiuj obrazki przedmiotów tam, gdzie oczekuje ich twój ekwipunek. Standalone bez ekwipunku nie potrzebuje przedmiotów.

4. Uruchom Pulse

Zostaw automatyczne wykrywanie w config/config.lua. Pierwsza sekcja zawiera framework, język, wybór ekwipunku, przedmiot telefonu i klawisze. Opcjonalne ustawienia są opisane w Konfiguracji.

Dodaj to po swoich obecnych zależnościach w server.cfg:

server.cfg
ensure phone
add_ace group.admin phone.admin allow

Zrestartuj serwer. Pulse tworzy tabele w bazie, gdy połączenie SQL jest dostępne. Przeczytaj jego sprawdzenie w konsoli i wykonaj ewentualne instrukcje naprawcze. Uruchom phone:health, żeby je powtórzyć.

5. Otwórz telefon

Wejdź jako administrator, otwórz F8 i wpisz phone:setup. Potwierdź wykryty framework i ekwipunek, a potem dokończ konfigurację z przewodnikiem. Naciśnij F1 albo użyj /phone, żeby otworzyć telefon. Jeśli twoje ustawienia wymagają przedmiotu, najpierw kup telefon i użyj jego pudełka z ekwipunku.

Ustawienia zapisane w Settings → Server nadpisują odpowiadające im ustawienia z plików. Zresetuj tam zapisane nadpisanie, jeśli chcesz, żeby znowu obowiązywała wartość z pliku.

6. Opcjonalnie: lżejszy screenshot-basic

Twoje pobranie zawiera też folder screenshot-basic. To screenshot-basic od CitizenFX (licencja MIT) z jedną zmianą: oryginał co klatkę przerysowuje obraz gry dla swojej warstwy przechwytywania, nawet gdy nikt nie robi zdjęcia, a ta kopia rysuje tylko podczas robienia zdjęcia. Nazwa resource'a, jego eksporty (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) i eventy są bez zmian, a do tego jest już zbudowany, więc nie musi budować się przy pierwszym starcie. Zmienione pliki są wymienione w screenshot-basic/ZERODEV-CHANGES.md.

Pulse działa z każdą z kopii, więc ten krok jest opcjonalny. Inne skrypty na twoim serwerze też używają screenshot-basic, więc jeśli masz serwer testowy, najpierw zmień to tam:

  1. Zmień nazwę obecnego folderu screenshot-basic (na przykład na screenshot-basic.bak) i przenieś go poza resources, żeby móc go przywrócić.
  2. Skopiuj naszą wersję do resources pod tą samą nazwą, screenshot-basic, i zostaw tę samą linię ensure screenshot-basic.
  3. Zrestartuj serwer i sprawdź każdy skrypt, który robi zrzuty ekranu: aparat telefonu i każde narzędzie do raportów, dowodów czy bodycamów, którego używasz.
  4. Jeśli coś działa inaczej, usuń naszą kopię, przywróć swój stary folder jako screenshot-basic i zrestartuj.

Skonfiguruj funkcje, których używasz

  • Połączenia, wideo i Live: obsługiwane resource'y głosowe, sterowanie połączeniami i konfiguracja połączenia wideo na produkcji.
  • Zdjęcia i filmy: wbudowany magazyn, FiveManage i inne opcje uploadu. Prywatne klucze usług zostają w konfiguracji twojego serwera. Na serwerze na hostingu, którego port web jest nieosiągalny, zdjęcia wymagają FiveManage: dwie linie w server.cfg (set phone_media_provider "fivemanage" i set phone_fivemanage_token "<token>").
  • Konfiguracja: sklepy, aplikacje, akcesoria, języki i opcjonalne funkcje.
  • Rozwiązywanie problemów: znajdź objaw i zastosuj rozwiązanie.
  • Integracje dla deweloperów: własne skrypty i zaawansowane ustawienia połączeń.

Zwykła instalacja nie wymaga edytowania bridge/, ui/ ani stream/. Trzymaj cały resource razem, łącznie z modelami i assetami mapy.

Przetłumaczone z angielskiego. Jeśli coś tutaj różni się od strony angielskiej, rację ma strona angielska. English