Dokumentacja Pulse Phone
Szczegóły instalacji
1. Szybka instalacja
Zanim cokolwiek skopiujesz
Używaj artefaktu serwera, który spełnia poniższe wymagania, z włączonym OneSync i game buildem 2699 lub nowszym. Na zwykłym serwerze roleplay najpierw doprowadź do działania framework, ekwipunek, oxmysql, resource głosowy i screenshot-basic. Standalone działa też bez frameworka; przedmioty ekwipunku są tam opcjonalne.
Pobierz resource ze swojego konta Cfx.re po odebraniu zakupu. Używaj klucza serwera należącego do konta, które posiada asset. Jeśli Cfx.re zgłasza błąd uprawnień (entitlement), napraw powiązanie konta z kluczem; zmiana ustawień telefonu nie da ci uprawnienia.
Krok 1 — Wrzuć resource na serwer
Rozpakuj paczkę i skopiuj folder resource'a phone, zawierający fxmanifest.lua, do katalogu resources swojego serwera. Nie zmieniaj jego nazwy i nie wstawiaj w jego miejsce zewnętrznego folderu ZIP/paczki.
Na serwerze na hostingu wgrywaj w trybie Binary albo wgraj zip i rozpakuj go tam (dlaczego). Szybki start (krok 2) podaje liczbę plików i rozmiar każdego folderu dla tego builda, a sprawdzenie startowe wymienia każdy brakujący plik albo plik o złym rozmiarze.
Zatrzymaj poprzedni resource telefonu przed testowaniem Pulse, żeby dwa telefony nie walczyły o ten sam klawisz i przedmiot. Zrób kopię jego danych, jeśli planujesz je później zaimportować.
Krok 2 — Dodaj przedmioty do ekwipunku
Wybierz swój obecny ekwipunek; nie musisz go zastępować.
| Twój ekwipunek | Wymagane działanie |
|---|---|
| ox_inventory | Otwórz dołączony config/items/ox_inventory.lua. Dołącz jego wpisy do ox_inventory/data/items.lua, wewnątrz istniejącej tabeli. Nie zastępuj całego pliku ekwipunku. Zostaw własny wpis phone z ox_inventory: jego użycie otwiera Pulse Phone, a linia Phone item w sprawdzeniu startowym to potwierdza. Zastąp go wypisanym wpisem tylko wtedy, gdy ta linia mówi, że otwiera inny skrypt. Skopiuj obrazki z config/items/images/ do ox_inventory/web/images/. Po edycji zrestartuj serwer. |
| qb-inventory z QBCore | Brakujące definicje przedmiotów są rejestrowane automatycznie przy starcie. Skopiuj config/items/images/ do qb-inventory/html/images/. Jeśli twój ekwipunek wymaga stałych wpisów shared, dołączony config/items/qb-core.lua jest gotowy do dołączenia do qb-core/shared/items.lua. |
| Domyślny ekwipunek ESX | Brakujące przedmioty są dodawane automatycznie. Jeśli konsola prosi o restart, zrestartuj raz, żeby ESX je wczytał. Jeśli twoje konto bazy nie może ich dodać, użyj config/items/esx.sql. |
| qs-inventory albo inny obsługiwany ekwipunek | Postępuj według krótkiego wiersza dla twojego ekwipunku w Przedmiotach i ekwipunkach. Używaj jego własnej listy przedmiotów i folderu obrazków. |
| Standalone bez ekwipunku | Nie potrzeba wpisów w ekwipunku. Zostaw wymaganie przedmiotów wyłączone. |
Sprawdzenie startowe wykrywa brakujące wpisy i wypisuje tylko definicje, których jeszcze potrzebujesz. Ekwipunek, który wczytuje definicje przedmiotów przy starcie, jak ox_inventory, potrzebuje powyższych wpisów; Pulse nie nadpisuje plików innego resource'a.
Krok 3 — Sprawdź główną konfigurację
Otwórz config/config.lua. Wartości domyślne wykrywają twoją obecną konfigurację:
Config.Framework = 'auto'Zostaw inventory = 'auto' w istniejącej tabeli Config.Providers. Jeśli masz kilka resource'ów ekwipunku, ustaw tę wartość na ekwipunek, którego chcesz używać, na przykład 'ox_inventory'. Nie dodawaj drugiej tabeli Config.Providers ani Config.Item na końcu pliku.
W istniejącej tabeli Config.Item wybierz, jak działają telefony:
| Ustawienie | Co robi |
|---|---|
required = false, unique = false |
Każda postać ma telefon bez noszenia przedmiotu. Przydatne przy pierwszym teście. |
required = true, unique = false |
Postać potrzebuje przedmiotu phone, żeby otworzyć swój telefon. Oddanie tego przedmiotu nie przenosi jej danych. |
unique = true |
Każdy przedmiot telefonu ma własny numer i dane. Przekazanie przedmiotu przekazuje ten telefon. Wymaga ox_inventory, qb-inventory, qs-inventory, core_inventory albo codem-inventory. |
name = 'phone' |
Nazwa przedmiotu w ekwipunku. Zostaw ją, chyba że zmieniasz też dołączoną definicję przedmiotu. |
Unikalne telefony idą za wybranym mostkiem ekwipunku. Zostaw Config.Item.inventory = 'auto'; to starsze nadpisanie jest tylko dla istniejących zaawansowanych instalacji. Config.Providers.inventory ma pierwszeństwo, gdy jest jawnie ustawione.
Nie zmieniaj Config.IdentityScope na istniejącym serwerze. Domyślne 'character' trzyma telefony różnych postaci osobno.
Opcjonalnie: telefony jako przedmioty i płatne usługi
Żeby wymagać osobnego przedmiotu dla każdego telefonu, ustaw required = true i unique = true w istniejącej tabeli Config.Item w config/config.lua, po dodaniu wpisów do ekwipunku. Użyj jednego z wymienionych wyżej ekwipunków obsługujących unikalne telefony.
Żeby sprzedawać usługi telefoniczne, ustaw Config.Carrier.enabled = true w tym samym pliku. Włącza to aplikację Carrier, w której gracze kupują plan. Nowe telefony potrzebują planu, zanim dostępne będą zwykłe połączenia, wiadomości i aplikacje korzystające z danych mobilnych. App Hub to miejsce, gdzie gracze instalują aplikacje, a nie sklep z usługami. Ustaw Config.Coverage.enabled = true, jeśli chcesz też strefy zasięgu. Zasięg i płatne plany to osobne opcje; zostaw dowolną wyłączoną, jeśli nie chcesz tej funkcji.
Edytuj istniejące ustawienia zamiast dodawać zduplikowane tabele. Po zapisaniu zrestartuj serwer. Jeśli ustawienie było wcześniej zapisane w grze, zresetuj je w Settings → Server, żeby obowiązywała wartość z pliku.
Krok 4 — Uruchom zależności przed Pulse
Zostaw swoje obecne połączenie z bazą i ustawienia frameworka. Dodaj tylko brakujące linie; nie uruchamiaj drugiej kopii żadnej zależności.
Użyj tej kolejności z resource'ami, które już są zainstalowane na twoim serwerze:
- Resource bazy danych i jego obecne ustawienia połączenia.
- Framework i jego wymagane biblioteki, resource'y tożsamości i postaci.
- Ekwipunek, z konfiguracją tego ekwipunku dla twojego frameworka.
- Jeden obsługiwany resource głosowy i
screenshot-basic. ensure phone.
Nie instaluj ESX, QBCore ani innego ekwipunku tylko dla Pulse. Wybierz swoją obecną konfigurację w Twój framework, żeby zobaczyć przykład kolejności startu. Qbox jest wykrywany jako Qbox, nawet gdy inny resource używa jego eksportów zgodnych z QBCore.
Dla dostępu administratora Pulse dodaj add_ace group.admin phone.admin allow. Twoje konto administratora musi już należeć do group.admin, żeby to uprawnienie zadziałało.
Krok 5 — Przeczytaj sprawdzenie pierwszego startu
Zrestartuj serwer. Pulse wypisuje raport startowy i automatycznie tworzy tabele w bazie, gdy połączenie SQL jest dostępne.
- FIX / FAIL: wymagana część nie może działać. Wykonaj linię naprawczą, zanim pozwolisz graczom z tego korzystać.
- NOTE / WARN: sprawdź, której funkcji to dotyczy; niektóre ostrzeżenia opisują opcjonalne funkcje, których nie skonfigurowałeś.
- Uruchom
phone:healthw konsoli serwera, żeby powtórzyć sprawdzenie. - Uruchom
phone:diag, żeby zobaczyć wybrany framework/ekwipunek/dostawców. - Jako admin wejdź na serwer, otwórz F8 i uruchom
phone:setup, żeby przejść istniejącą konfigurację z przewodnikiem.
Ustawienia zapisane w konfiguracji admina w grze nadpisują odpowiadające im ustawienia z plików. Jeśli zmiana w pliku wydaje się ignorowana, sprawdź Settings → Server i zresetuj zapisane nadpisanie, zanim zmienisz kolejne pliki.
Krok 6 — Przetestuj jako gracz
- Wczytaj postać, naciśnij F1 i dokończ konfigurację telefonu. Jeśli wymaganie przedmiotów jest włączone, najpierw kup telefon w sklepie albo daj postaci skonfigurowany przedmiot telefonu.
- Jeśli kupiłeś zaplombowane pudełko, użyj pudełka z ekwipunku, żeby je rozpakować, a potem dokończ konfigurację. Telefon przychodzi włączony; z
Config.Device.arrivesOn = falsenajpierw przytrzymaj End albo O. - Otwórz Messages, Contacts i Phone. Wróć do ekranu głównego, otwórz przełącznik aplikacji i zamknij po kolei każdą aplikację.
- Zrób zdjęcie i krótki film. Otwórz oba w Photos, zamknij i ponownie otwórz telefon i sprawdź, czy zostały.
- Połącz się ponownie i sprawdź, czy ta sama postać ma ten sam telefon. Przetestuj połączenia z drugim graczem, używając zainstalowanego resource'a głosowego.
Gdzie co zmienić
| Co chcesz zmienić | Plik lub miejsce |
|---|---|
| Framework, dostawca ekwipunku, przedmiot telefonu, sklep, modele, przypisanie klawiszy | config/config.lua |
| Dostawca voice | config/config.lua |
| Ustawienia aplikacji i usług/prac | config/apps.lua |
| Wpisy ekwipunku i obrazki | config/items/ |
| Połączenie z bazą, kolejność startu resource'ów, dane dostępowe do hostingu mediów | server.cfg (trzymaj prywatne dane dostępowe po stronie serwera) |
| Integracje dla deweloperów | Zaawansowane integracje, opcjonalny zestaw deweloperski (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) i istniejące pliki bridge/; zwykła instalacja nie wymaga ich edytowania |
| Zdjęcia/filmy graczy we wbudowanym magazynie | media/; zachowaj ten folder przy aktualizacji |
Sekcje poniżej zawierają szczegółową dokumentację. Nie musisz czytać każdego ustawienia funkcji, żeby dokończyć pierwszą instalację.