Dokumentacja Pulse Phone
Frameworki
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:
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. qbna serwerze, na którym działaqbx_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
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
itemsw ESX przy starcie, a konsola mówi, które dodał.config/items/esx.sqljest dostępny, jeśli wolisz dodać je sam. Z innym ekwipunkiem zobacz sekcję 4. - Pieniądze: bank to konto ESX
bank, gotówka to kontomoney. - Postać: telefon podąża za
identifiergracza w ESX, więc esx_multicharacter działa. - Szef: stopień o nazwie
bosszarządza firmą, chyba że ustawiszbossGrade. - Konta firm: esx_addonaccount / esx_society albo skrypt bankowy z sekcji 7.
QBCore
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/doqb-inventory/html/images/; sprawdzenie startowe wymienia brakujące. - Pieniądze:
bankicash. - Postać:
citizenid, więc qb-multicharacter działa. - Szef: stopnie z
isboss = truew twoich pracach, chyba że ustawiszbossGrade. - 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
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ą doox_inventory/web/images/. - Pieniądze:
bankicash, przez qbx_core. - Postać:
citizenid. - Szef: stopnie z
isboss = true, chyba że ustawiszbossGrade. - 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
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ą doox_inventory/web/images/. - Pieniądze: bank to konto postaci w ox_core. Gotówka to przedmiot
moneyw 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
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_Corejest 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:
bankpostaci w ND icashw ND (ox_inventory trzyma przedmiotmoneyw 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_vehiclesw 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ć.
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 ustawConfig.Store.box = false, żeby sklep wydawał telefony bezpośrednio. Gracze używają przedmiotów do ładowania przez/phonepacki/phonecable; z ekwipunkiem vRP wymaga to, żeby gracz miał przy sobiepulse_magpackipulse_cable, więc dodaj oba przedmioty do swojej listy przedmiotów vRP albo ustawConfig.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ą).
ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phoneSprawdzenie 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.luama wpisy), a dla pudełek ze sklepupulse_phone_boxplus po jednym na wykończenie (pulse_phone_box_black...). Etykiety, wagi i opisy są wconfig/items/qb-core.lua, a obrazki wconfig/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, ustawConfig.Store.box = false. - Pieniądze: gotówka postaci i jej bank: resource
bankingod TMC, gdy działa (jej osobiste konto), w przeciwnym razie pieniądze bankowe z core'a. Jeśli twoje numery kont nie mają formatuBNK123456, podaj pole z numerem konta wconfig/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_tmci skasuj ten folder. Konsola przypomina o tym, dopóki on działa.
Standalone (bez frameworka)
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 (
startingBalancewconfig/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
- Ustaw
Config.Framework = 'custom'wconfig/config.lua. - Daj telefonowi tabelę mostka w kształcie
optional-developer-kit/custom_framework_bridge.lua: albo jakoConfig.Providers.customwconfig/config.lua, albo ze swojego resource'a przezexports.phone:RegisterFrameworkBridge(MyBridge). - 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 maGetBankBalance. - 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.