Pulse Phone dokumentacija
Detalji instalacije
1. Brza instalacija
Prije nego što išta kopirate
Koristite server artifact koji ispunjava zahtjeve ispod, s uključenim OneSyncom i game buildom 2699 ili novijim. Za običan roleplay server, prvo osigurajte da rade framework, inventar, oxmysql, voice resurs i screenshot-basic. Standalone radi i bez frameworka; predmeti u inventaru su tamo opcionalni.
Preuzmite resurs sa svog Cfx.re računa nakon što preuzmete kupovinu. Koristite ključ servera koji pripada računu koji posjeduje asset. Ako Cfx.re prijavi grešku prava korištenja (entitlement), popravite vezu računa i ključa; promjena postavki telefona ne može dati to pravo.
Korak 1 — Stavite resurs na svoj server
Raspakujte paket i kopirajte folder resursa phone, koji sadrži fxmanifest.lua, u direktorij resources svog servera. Ne preimenujte ga i ne stavljajte vanjski ZIP/folder paketa na njegovo mjesto.
Na hostovanom serveru otpremajte u Binary načinu ili otpremite zip i tamo ga raspakujte (zašto). Brzi početak (korak 2) navodi broj fajlova i veličinu svakog foldera za ovaj build, a provjera pri pokretanju navodi svaki fajl koji nedostaje ili ima pogrešnu veličinu.
Zaustavite prethodni resurs telefona prije testiranja Pulsea, kako se dva telefona ne bi borila za istu tipku i predmet. Napravite rezervnu kopiju njegovih podataka ako ih planirate kasnije uvesti.
Korak 2 — Dodajte predmete u inventar
Odaberite svoj postojeći inventar; ne morate ga zamijeniti.
| Vaš inventar | Potrebna radnja |
|---|---|
| ox_inventory | Otvorite isporučeni config/items/ox_inventory.lua. Spojite njegove unose u ox_inventory/data/items.lua, unutar postojeće tabele. Ne zamjenjujte cijeli fajl inventara. Zadržite vlastiti ox_inventory unos phone: njegovo korištenje otvara Pulse Phone, a linija Phone item u provjeri pri pokretanju to potvrđuje. Zamijenite ga ispisanim unosom samo kada ta linija kaže da otvara drugu skriptu. Kopirajte slike iz config/items/images/ u ox_inventory/web/images/. Restartujte server nakon izmjena. |
| qb-inventory s QBCore | Definicije predmeta koje nedostaju automatski se registruju pri pokretanju. Kopirajte config/items/images/ u qb-inventory/html/images/. Ako vaš inventar zahtijeva trajne shared unose, isporučeni config/items/qb-core.lua spreman je za spajanje u qb-core/shared/items.lua. |
| Zadani ESX inventar | Predmeti koji nedostaju dodaju se automatski. Ako konzola traži restart, restartujte jednom kako bi ih ESX pročitao. Ako vaš korisnik baze podataka ne može da ih doda, koristite config/items/esx.sql. |
| qs-inventory ili drugi podržani inventar | Pratite kratki red za svoj inventar u Predmetima i inventarima. Koristite njegovu vlastitu listu predmeta i folder sa slikama. |
| Standalone bez inventara | Unosi u inventar nisu potrebni. Ostavite zahtjeve za predmete isključenim. |
Provjera pri pokretanju prepoznaje unose koji nedostaju i ispisuje samo definicije koje vam još trebaju. Inventar koji definicije predmeta učitava pri pokretanju, kao što je ox_inventory, treba gornje unose; Pulse ne prepisuje fajlove drugog resursa.
Korak 3 — Provjerite glavnu konfiguraciju
Otvorite config/config.lua. Zadane vrijednosti prepoznaju vašu postojeću postavku:
Config.Framework = 'auto'Ostavite inventory = 'auto' u postojećoj tabeli Config.Providers. Ako pokrećete više resursa za inventar, postavite tu vrijednost na inventar koji namjeravate koristiti, na primjer 'ox_inventory'. Ne dodajte drugu tabelu Config.Providers ili Config.Item na dno fajla.
U postojećoj tabeli Config.Item odaberite kako telefoni rade:
| Postavka | Šta radi |
|---|---|
required = false, unique = false |
Svaki lik ima telefon bez nošenja predmeta. Korisno za prvi test. |
required = true, unique = false |
Lik treba predmet phone da otvori svoj telefon. Davanje tog predmeta nekom drugom ne prenosi njegove podatke. |
unique = true |
Svaki predmet telefona ima vlastiti broj i podatke. Predaja predmeta prenosi taj telefon. Zahtijeva ox_inventory, qb-inventory, qs-inventory, core_inventory ili codem-inventory. |
name = 'phone' |
Ime predmeta u inventaru. Zadržite ga osim ako ne mijenjate i isporučenu definiciju predmeta. |
Jedinstveni telefoni prate odabrani most za inventar. Ostavite Config.Item.inventory = 'auto'; ova starija postavka služi samo za postojeće napredne instalacije. Config.Providers.inventory ima prednost kada je eksplicitno postavljen.
Ne mijenjajte Config.IdentityScope na postojećem serveru. Zadana vrijednost, 'character', drži telefone različitih likova odvojenim.
Opcionalno: telefoni u inventaru i plaćena usluga
Da zahtijevate zaseban predmet telefona za svaki telefon, postavite required = true i unique = true unutar postojeće tabele Config.Item u config/config.lua, nakon što dodate unose u inventar. Koristite jedan od inventara za jedinstvene telefone navedenih iznad.
Da prodajete telefonsku uslugu, postavite Config.Carrier.enabled = true u istom fajlu. To uključuje aplikaciju Carrier, u kojoj igrači kupuju svoj plan. Novi telefoni trebaju plan prije nego što obični pozivi, poruke i aplikacije s mobilnim podacima postanu dostupni. App Hub je mjesto gdje igrači instaliraju aplikacije, a ne prodavnica usluga. Postavite Config.Coverage.enabled = true ako želite i zone pokrivenosti. Pokrivenost i plaćeni planovi su zasebne opcije; ostavite bilo koju isključenu ako tu funkciju ne želite.
Uređujte postojeće postavke umjesto dodavanja duplih tabela. Restartujte server nakon spremanja. Ako je postavka u igri ranije spremljena, poništite je u Settings → Server kako bi se primijenila vrijednost iz vašeg fajla.
Korak 4 — Pokrenite zavisnosti prije Pulsea
Zadržite postojeću vezu s bazom podataka i postavke frameworka. Dodajte samo linije koje nedostaju; ne pokrećite drugu kopiju bilo koje zavisnosti.
Koristite ovaj redoslijed s resursima koji su već instalirani na vašem serveru:
- Resurs baze podataka i njegove postojeće postavke veze.
- Framework i njegove potrebne biblioteke, resursi za identitet i likove.
- Inventar, uz konfiguraciju tog inventara za vaš framework.
- Jedan podržani voice resurs i
screenshot-basic. ensure phone.
Ne instalirajte ESX, QBCore ili drugi inventar samo zbog Pulsea. Odaberite svoju postojeću postavku u Vašem frameworku za primjer redoslijeda pokretanja. Qbox se prepoznaje kao Qbox čak i kad drugi resurs koristi njegove exporte kompatibilne s QBCore.
Za administratorski pristup Pulseu dodajte add_ace group.admin phone.admin allow. Vaš administratorski račun već mora pripadati group.admin da bi se ta dozvola primijenila.
Korak 5 — Pročitajte provjeru pri prvom pokretanju
Restartujte server. Pulse ispisuje izvještaj pri pokretanju i automatski kreira tabele u bazi podataka kada je SQL veza dostupna.
- FIX / FAIL: potreban dio ne može raditi. Pratite liniju za ispravku prije nego što dozvolite igračima da ga koriste.
- NOTE / WARN: pročitajte na koju funkciju se odnosi; neka upozorenja opisuju opcionalne funkcije koje niste podesili.
- Pokrenite
phone:healthu konzoli servera da ponovite provjeru. - Pokrenite
phone:diagda vidite odabrani framework/inventar/providere. - Kao admin, uđite, otvorite F8 i pokrenite
phone:setupza postojeće vođeno postavljanje.
Postavke spremljene u admin postavljanju u igri imaju prednost nad odgovarajućim postavkama iz fajla. Ako se čini da se izmjena u fajlu ignoriše, provjerite Settings → Server i poništite tu spremljenu postavku prije nego što mijenjate druge fajlove.
Korak 6 — Testirajte kao igrač
- Učitajte lika, pritisnite F1 i završite postavljanje telefona. Ako su zahtjevi za predmete uključeni, prvo kupite telefon u prodavnici ili dajte liku podešeni predmet telefona.
- Ako ste kupili zapečaćenu kutiju, iskoristite kutiju iz inventara da je raspakujete, a zatim završite postavljanje. Telefon stiže uključen; uz
Config.Device.arrivesOn = falseprvo držite End ili O. - Otvorite Messages, Contacts i Phone. Vratite se na Home, otvorite app switcher i zatvorite svaku aplikaciju redom.
- Napravite fotografiju i kratak video. Otvorite oboje u Photos, zatvorite i ponovo otvorite telefon i potvrdite da su ostali.
- Ponovo se povežite i provjerite da isti lik i dalje ima isti telefon. Testirajte pozive s drugim igračem koristeći instalirani voice resurs.
Gdje se šta mijenja
| Šta želite promijeniti | Fajl ili mjesto |
|---|---|
| Framework, provider inventara, predmet telefona, prodavnica, modeli, dodjela tipke | config/config.lua |
| Voice provider | config/config.lua |
| Postavke aplikacija i usluga/poslova | config/apps.lua |
| Unosi u inventar i slike | config/items/ |
| Veza s bazom podataka, redoslijed pokretanja resursa, pristupni podaci za media host | server.cfg (privatne pristupne podatke držite na strani servera) |
| Integracije za developere | Napredne integracije, opcionalni Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) i postojeći fajlovi u bridge/; obična instalacija ne zahtijeva njihovo uređivanje |
| Fotografije/videi igrača uz ugrađeno skladište | media/; sačuvajte ovaj folder pri ažuriranju |
Odjeljci ispod sadrže detaljnu referencu. Ne morate čitati svaku postavku funkcija da biste završili prvu instalaciju.