Dokumentacja Pulse Phone

Frameworki

Dla Pulse Phone 1.4.28 min czytaniaAktualizacja

3. Krok po kroku dla twojego frameworka

Telefon sam znajduje twój framework: es_extended, qb-core, qbx_core, ox_core, ND_Core, vrp albo core od TMC. Config.Framework w config/config.lua potrzebujesz tylko wtedy, gdy działa więcej niż jeden, albo dla własnego frameworka.

Twój framework w skrócie

Framework Wykrywany po Przedmioty Bank i gotówka Warto wiedzieć
ESX Legacy es_extended Pulse sam dodaje swoje przedmioty do tabeli items w ESX (domyślny ekwipunek). Na ox_inventory wklej blok, który wypisuje sprawdzenie startowe Konta ESX Konta firm przez twój skrypt society
QBCore qb-core Pulse sam dodaje swoje przedmioty do shared items QBCore (qb-, ps-, lj-inventory) Pieniądze QBCore Stopnie z isboss prowadzą firmę
Qbox qbx_core (jego zastępczy qb-core liczy się jako Qbox, a nie drugi framework) Wklej wypisany blok ox_inventory Pieniądze Qbox Używa adaptera Qbox, nigdy adaptera QBCore
ox_core ox_core Wklej wypisany blok ox_inventory Konto postaci w ox_core; gotówka to money z ox_inventory Brak flagi służby: wszyscy liczą się jako na służbie
ND Core ND_Core Wklej wypisany blok ox_inventory bank i cash z ND Brak flagi służby; brak kont firm
TMC jego resource core, rozpoznawany po własnym obiekcie core TMC Każdy przedmiot musi być na liście przedmiotów TMC: sprawdzenie startowe je wypisuje Pieniądze TMC Działa przez własny mostek, nie ma nic do konfigurowania
vRP 2 vrp Zobacz sekcję vRP Portfel i bank vRP vRP 1 i forki nie są obsługiwane
Standalone nie działa nic z powyższych Nie są potrzebne Własny bank telefonu Dla serwerów testowych albo serwerów bez frameworka
Własny Config.Framework = 'custom' Przez twój mostek Przez twój mostek Zobacz "Własny framework"

Wymuszanie frameworka

Większość serwerów nigdy tego nie potrzebuje. Wymuś framework, gdy linia startowa podaje zły, albo gdy zainstalowane i uruchomione są dwa core'y frameworków. Dodaj jedną linię do server.cfg:

server.cfg
setr phone_framework qb
Wartość Framework
esx ESX Legacy (es_extended)
qb QBCore (qb-core)
qbox Qbox (qbx_core)
ox ox_core
nd ND Core (ND_Core)
vrp vRP 2 (vrp)
tmc TMC (core)
standalone Bez frameworka: telefon ma własną tożsamość i bank
custom Twój własny mostek (zobacz "Własny framework" poniżej)
auto To samo co pominięcie linii: decyduje Config.Framework
  • Ma pierwszeństwo przed Config.Framework. Po zmianie zrestartuj telefon.
  • Nazwy resource'ów też działają: qbcore, qb-core, qbx_core, es_extended, ox_core. Nieznane słowo jest odrzucane: sprawdzenie startowe to mówi, a funkcje pieniężne zostają wyłączone.
  • qb na serwerze, na którym działa qbx_core, używa adaptera Qbox. Qbox odpowiada też jako QBCore.
  • Jeśli wymuszony framework nie jest uruchomiony, telefony zostają na ekranie "not ready", dopóki nie wystartuje. Telefon nigdy sam nie przełącza się na inny framework.

Multicharacter działa na każdym frameworku. Config.IdentityScope = 'character' (domyślnie) daje każdej postaci własny telefon. 'player' daje jeden telefon na konto. Wybierz raz: zmiana na działającym serwerze zostawia w tyle każdy istniejący telefon.

Zarządzanie firmą (służba, pracownicy, rekrutacja, konto firmy w aplikacji Services) używa firm z Config.Services w config/apps.lua. Jeśli nazwy twoich prac różnią się od domyślnych (police, ambulance, mechanic, taxi, fire ...), dodaj swoje do listy job danej firmy. Żeby samemu wybrać stopnie szefa, dodaj do firmy bossGrade = <n>.

ESX Legacy

server.cfg
ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: z domyślnym ekwipunkiem ESX nie musisz nic robić. Telefon dodaje swoje przedmioty do tabeli items w ESX przy starcie, a konsola mówi, które dodał. config/items/esx.sql jest dostępny, jeśli wolisz dodać je sam. Z innym ekwipunkiem zobacz sekcję 4.
  • Pieniądze: bank to konto ESX bank, gotówka to konto money.
  • Postać: telefon podąża za identifier gracza w ESX, więc esx_multicharacter działa.
  • Szef: stopień o nazwie boss zarządza firmą, chyba że ustawisz bossGrade.
  • Konta firm: esx_addonaccount / esx_society albo skrypt bankowy z sekcji 7.

QBCore

server.cfg
ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: nie trzeba nic wklejać. Telefon przy starcie dodaje potrzebne przedmioty do shared items QBCore, a konsola mówi, które dodał. Skopiuj obrazki z config/items/images/ do qb-inventory/html/images/; sprawdzenie startowe wymienia brakujące.
  • Pieniądze: bank i cash.
  • Postać: citizenid, więc qb-multicharacter działa.
  • Szef: stopnie z isboss = true w twoich pracach, chyba że ustawisz bossGrade.
  • Konta firm: Renewed-Banking, qb-banking albo starszy qb-management.
  • Multijob: gdy działa ps-multijob, pozostałe prace gracza pokazują się w Services, a jedno dotknięcie ustawia pracę jako aktywną.

Qbox

server.cfg
ensure oxmysql
ensure qbx_core
ensure ox_inventory
# ... your other Qbox scripts, in Qbox's own order ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: Qbox używa ox_inventory, który nie przyjmuje przedmiotów z innego skryptu. Uruchom serwer raz: sprawdzenie startowe wypisze brakujące wpisy, gotowe do wklejenia do ox_inventory/data/items.lua (sekcja 4). Obrazki trafiają do ox_inventory/web/images/.
  • Pieniądze: bank i cash, przez qbx_core.
  • Postać: citizenid.
  • Szef: stopnie z isboss = true, chyba że ustawisz bossGrade.
  • Multijob: wbudowany. Pozostałe prace gracza pokazują się w Services.
  • qbx_core odpowiada też jako qb-core. To normalne: telefon traktuje je jako jeden framework.

ox_core

server.cfg
ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: uruchom serwer raz: sprawdzenie startowe wypisze brakujące wpisy, gotowe do wklejenia do ox_inventory/data/items.lua (sekcja 4). Obrazki trafiają do ox_inventory/web/images/.
  • Pieniądze: bank to konto postaci w ox_core. Gotówka to przedmiot money w ox_inventory.
  • Postać: charId.
  • Prace: grupy ox_core nie mają flagi służby, więc telefon sam pilnuje służby. Zarządzanie firmą (pracownicy, rekrutacja, stopnie) i valet nie są dostępne na ox_core.

ND Core

server.cfg
ensure oxmysql
ensure ox_lib
ensure ND_Core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Wykrywany sam, gdy ND_Core jest uruchomiony. Żeby go wymusić: setr phone_framework nd.
  • Przedmioty: ND używa ox_inventory. Uruchom serwer raz: sprawdzenie startowe wypisze brakujące wpisy, gotowe do wklejenia do ox_inventory/data/items.lua (sekcja 4).
  • Pieniądze: bank postaci w ND i cash w ND (ox_inventory trzyma przedmiot money w zgodzie).
  • Postać: id postaci w ND. Wyświetlany numer telefonu to numer z ND, jeśli postać go ma.
  • Prace: praca i ranga postaci w ND. ND nie ma flagi służby, więc wszyscy liczą się jako na służbie. Zarządzanie firmą, konta firm i valet nie są dostępne na ND Core.
  • Garaż: posiadane auta pochodzą z tabeli nd_vehicles w ND.

vRP

Obsługiwany jest tylko vRP 2 (nie vRP 1 ani forki społeczności). Telefon ładuje małe rozszerzenie do vRP z bridge/frameworks/vrp/. Nie trzeba nic kopiować.

server.cfg
ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: dla vRP nie ma pliku przedmiotów, a vRP 2 nie potrafi uczynić przedmiotów używalnymi dla telefonu. Zostaw Config.Item.required = false (domyślnie) i ustaw Config.Store.box = false, żeby sklep wydawał telefony bezpośrednio. Gracze używają przedmiotów do ładowania przez /phonepack i /phonecable; z ekwipunkiem vRP wymaga to, żeby gracz miał przy sobie pulse_magpack i pulse_cable, więc dodaj oba przedmioty do swojej listy przedmiotów vRP albo ustaw Config.Charging.enabled = false.
  • Pieniądze: bank i portfel vRP.
  • Postać: id postaci w vRP.
  • Prace: zarządzanie firmą i valet nie są dostępne na vRP. Aplikacja Garage zostaje pusta, dopóki nie podłączysz skryptu garaży.

TMC

TMC jest wbudowany. Telefon sam rozpoznaje core od TMC: bez dodatkowego resource'a i bez zmian w config/config.lua (auto, tmc i custom działają).

server.cfg
ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Sprawdzenie startowe pokazuje Framework: TMC.

  • Przedmioty: dodaj przedmioty Pulse do listy przedmiotów TMC tak samo jak każdy inny przedmiot. Nazwy to phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (config/items/tmc.lua ma wpisy), a dla pudełek ze sklepu pulse_phone_box plus po jednym na wykończenie (pulse_phone_box_black ...). Etykiety, wagi i opisy są w config/items/qb-core.lua, a obrazki w config/items/images/. Przedmiot, którego nie ma na liście, jest odrzucany, a gracz widzi "inventory full": konsola wtedy podaje nazwę przedmiotu. Brak przedmiotu pudełka na liście nie blokuje sprzedaży: sklep wydaje telefon bez pudełka i informuje o tym w konsoli. Jeśli w ogóle nie chcesz pudełek, ustaw Config.Store.box = false.
  • Pieniądze: gotówka postaci i jej bank: resource banking od TMC, gdy działa (jej osobiste konto), w przeciwnym razie pieniądze bankowe z core'a. Jeśli twoje numery kont nie mają formatu BNK123456, podaj pole z numerem konta w config/config.lua: Config.Providers.tmcBankAccount = 'charinfo.account' (użyj swojego pola). Gdy nie da się odczytać banku, Wallet pokazuje kreskę, nigdy wymyśloną kwotę.
  • Postać: citizen id w TMC.
  • Prace: praca na służbie (albo pierwsza), z jej stopniem i stanem służby.
  • Miałeś tymczasowy konektor pulse_tmc? Usuń ensure pulse_tmc i skasuj ten folder. Konsola przypomina o tym, dopóki on działa.

Standalone (bez frameworka)

server.cfg
ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone
  • Przedmioty: nie są potrzebne. Każdy gracz ma telefon, Reserve i kabel.
  • Pieniądze: telefon ma własny bank. Nowy gracz zaczyna z 5000 (startingBalance w config/apps.lua).
  • Postać: licencja Rockstar gracza.
  • Prace, auta i domy: telefon ma własne. Wypełnisz je komendami testowymi z sekcji 9.

Własny framework

  1. Ustaw Config.Framework = 'custom' w config/config.lua.
  2. Daj telefonowi tabelę mostka w kształcie optional-developer-kit/custom_framework_bridge.lua: albo jako Config.Providers.custom w config/config.lua, albo ze swojego resource'a przez exports.phone:RegisterFrameworkBridge(MyBridge).
  3. Wymagana jest tylko GetCharacterId. Jeśli pominiesz funkcję imienia, pracy, licencji albo listy pojazdów/domów, telefon zachowuje się tak, jakby twój serwer nie miał takich danych. Jeśli pominiesz funkcję pieniędzy albo przedmiotów, ta akcja jest odrzucana: telefon nigdy nie płaci z własnego banku. Aplikacja Bank pojawia się tylko wtedy, gdy twój mostek ma GetBankBalance.
  4. Jeśli twój core restartuje się, gdy telefon dalej działa, wywołaj exports.phone:FrameworkRestarted(), gdy core będzie gotowy.

bridge/frameworks/custom.lua pokazuje, jak telefon używa twojej tabeli. Żeby podłączyć inne własne skrypty (skrypt bankowy albo garaży), zobacz optional-developer-kit/custom_provider_template.lua i Eksporty. Oba szablony są w opcjonalnym zestawie deweloperskim, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, a nie w folderze telefonu.

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