Documentazione di Pulse Phone
Framework
3. Passo per passo per il tuo framework
Il telefono trova il tuo framework da solo: es_extended, qb-core, qbx_core, ox_core, ND_Core, vrp o il core di TMC. Ti serve Config.Framework in config/config.lua solo se ne è attivo più di uno, o per un framework custom.
Il tuo framework in breve
| Framework | Rilevato tramite | Item | Banca e contanti | Da sapere |
|---|---|---|---|---|
| ESX Legacy | es_extended |
Pulse aggiunge da solo i suoi item alla tabella items di ESX (inventario predefinito). Su ox_inventory, incolla il blocco stampato dal controllo all'avvio |
Conti ESX | Conti aziendali tramite il tuo script society |
| QBCore | qb-core |
Pulse aggiunge da solo i suoi item agli shared items di QBCore (qb-, ps-, lj-inventory) | Soldi QBCore | I gradi isboss gestiscono l'azienda |
| Qbox | qbx_core (il suo sostituto qb-core conta come Qbox, non come un secondo framework) |
Incolla il blocco ox_inventory stampato | Soldi Qbox | Usa l'adapter Qbox, mai quello QBCore |
| ox_core | ox_core |
Incolla il blocco ox_inventory stampato | Il conto ox_core del personaggio; i contanti sono il money di ox_inventory |
Nessun flag di servizio: tutti contano come in servizio |
| ND Core | ND_Core |
Incolla il blocco ox_inventory stampato | bank e cash di ND |
Nessun flag di servizio; nessun conto aziendale |
| TMC | la sua risorsa core, riconosciuta dall'oggetto core di TMC |
Ogni item deve essere nella lista item di TMC: il controllo all'avvio li stampa | Soldi TMC | Passa dal bridge custom, niente da configurare |
| vRP 2 | vrp |
Vedi la sezione vRP | Portafoglio e banca di vRP | vRP 1 e i suoi fork non sono supportati |
| Standalone | nessuno dei precedenti attivo | Non servono | La banca del telefono | Per server di test o server senza framework |
| Custom | Config.Framework = 'custom' |
Tramite il tuo bridge | Tramite il tuo bridge | Vedi "Framework custom o fatto in casa" |
Forzare il framework
La maggior parte dei server non ne ha mai bisogno. Forza il framework quando la riga di avvio indica quello sbagliato, o quando sono installati e avviati due core di framework. Aggiungi una riga a server.cfg:
setr phone_framework qb| Valore | 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 |
Nessun framework: il telefono gestisce da solo identità e banca |
custom |
Il tuo bridge (vedi "Framework custom o fatto in casa" più sotto) |
auto |
Come omettere la riga: decide Config.Framework |
- Ha la precedenza su
Config.Framework. Riavvia il telefono dopo averlo cambiato. - Funzionano anche i nomi delle risorse:
qbcore,qb-core,qbx_core,es_extended,ox_core. Una parola che non conosce viene rifiutata: il controllo all'avvio lo segnala e le funzioni legate ai soldi restano disattivate. qbsu un server conqbx_coreusa l'adapter Qbox. Qbox risponde anche come QBCore.- Se il framework che forzi non è avviato, i telefoni restano sulla schermata "not ready" finché non lo è. Il telefono non passa mai da solo a un altro framework.
Multicharacter funziona su ogni framework. Config.IdentityScope = 'character' (il default) dà a ogni personaggio il suo telefono. 'player' dà un telefono per account. Scegli una volta sola: cambiarlo su un server attivo lascia indietro tutti i telefoni esistenti.
La gestione aziendale (servizio, personale, assunzioni, il conto aziendale nell'app Services) usa le aziende in Config.Services in config/apps.lua. Se i nomi dei tuoi lavori sono diversi da quelli predefiniti (police, ambulance, mechanic, taxi, fire ...), aggiungi i tuoi alla lista job di quell'azienda. Per scegliere tu i gradi da boss, aggiungi bossGrade = <n> all'azienda.
ESX Legacy
ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone- Item: con l'inventario ESX predefinito non c'è niente da fare. Il telefono aggiunge i suoi item alla tabella
itemsdi ESX all'avvio, e la console dice quali ha aggiunto.config/items/esx.sqlc'è se preferisci aggiungerli tu. Con un altro inventario, vedi la sezione 4. - Soldi: la banca è il conto
bankdi ESX, i contanti sono il contomoney. - Personaggio: il telefono segue l'
identifierdel giocatore di ESX, quindi esx_multicharacter funziona. - Boss: il grado chiamato
bossgestisce l'azienda, a meno che tu non impostibossGrade. - Conti aziendali: esx_addonaccount / esx_society, o uno script banking della sezione 7.
QBCore
ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone- Item: niente da incollare. Il telefono aggiunge gli item che gli servono agli shared items di QBCore all'avvio, e la console dice quali ha aggiunto. Copia le immagini da
config/items/images/aqb-inventory/html/images/; il controllo all'avvio indica quelle che mancano. - Soldi:
bankecash. - Personaggio: il
citizenid, quindi qb-multicharacter funziona. - Boss: i gradi con
isboss = truenei tuoi lavori, a meno che tu non impostibossGrade. - Conti aziendali: Renewed-Banking, qb-banking, o il vecchio qb-management.
- Multijob: con ps-multijob attivo, gli altri lavori del giocatore compaiono in Services e con un tocco si rende attivo un lavoro.
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- Item: Qbox usa ox_inventory, che non accetta item da un altro script. Avvia il server una volta: il controllo all'avvio stampa le voci mancanti, pronte da incollare in
ox_inventory/data/items.lua(sezione 4). Le immagini vanno inox_inventory/web/images/. - Soldi:
bankecash, tramite qbx_core. - Personaggio: il
citizenid. - Boss: i gradi con
isboss = true, a meno che tu non impostibossGrade. - Multijob: integrato. Gli altri lavori di un giocatore compaiono in Services.
- qbx_core risponde anche come
qb-core. È normale: il telefono tratta i due come un unico framework.
ox_core
ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone- Item: avvia il server una volta: il controllo all'avvio stampa le voci mancanti, pronte da incollare in
ox_inventory/data/items.lua(sezione 4). Le immagini vanno inox_inventory/web/images/. - Soldi: la banca è il conto ox_core del personaggio. I contanti sono l'item
moneyin ox_inventory. - Personaggio: il
charId. - Lavori: i gruppi di ox_core non hanno un flag di servizio, quindi il servizio lo gestisce il telefono. Gestione aziendale (personale, assunzioni, gradi) e valet non sono disponibili su 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- Rilevato da solo quando
ND_Coreè avviato. Per forzarlo:setr phone_framework nd. - Item: ND usa ox_inventory. Avvia il server una volta: il controllo all'avvio stampa le voci mancanti, pronte da incollare in
ox_inventory/data/items.lua(sezione 4). - Soldi: la
bankND del personaggio e ilcashND (ox_inventory tiene allineato l'itemmoney). - Personaggio: l'id del personaggio ND. Il numero di telefono mostrato è quello di ND quando il personaggio ne ha uno.
- Lavori: il lavoro e il grado ND del personaggio. ND non ha un flag di servizio, quindi tutti contano come in servizio. Gestione aziendale, conti aziendali e valet non sono disponibili su ND Core.
- Garage: le auto possedute arrivano dalla tabella
nd_vehiclesdi ND.
vRP
È supportato solo vRP 2 (non vRP 1 né i fork della community). Il telefono carica una piccola estensione in vRP da bridge/frameworks/vrp/. Niente da copiare.
ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone- Item: non esiste un file item per vRP, e vRP 2 non può rendere usabili gli item per il telefono. Lascia
Config.Item.required = false(il default) e impostaConfig.Store.box = falsecosì il negozio consegna i telefoni direttamente. I giocatori usano gli item di ricarica con/phonepacke/phonecable; con un inventario vRP questi richiedono che il giocatore abbiapulse_magpackepulse_cable, quindi aggiungi entrambi gli item alla tua lista item di vRP, oppure impostaConfig.Charging.enabled = false. - Soldi: banca e portafoglio di vRP.
- Personaggio: l'id del personaggio di vRP.
- Lavori: gestione aziendale e valet non sono disponibili su vRP. L'app Garage resta vuota a meno che tu non colleghi uno script garage.
TMC
TMC è integrato. Il telefono riconosce da solo il core di TMC: nessuna risorsa extra e nessuna modifica a config/config.lua (auto, tmc e custom funzionano tutti).
ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phoneIl controllo all'avvio mostra Framework: TMC.
- Item: aggiungi gli item Pulse alla lista item di TMC come aggiungi qualsiasi altro item. I nomi sono
phone,pulse_magpack,pulse_magpack_max,pulse_cable,pulse_router,pulse_burner,pulse_buds,pulse_ringlight,pulse_wallet(config/items/tmc.luacontiene le voci), e per le scatole del negoziopulse_phone_boxpiù una per ogni finitura (pulse_phone_box_black...). Etichette, pesi e descrizioni sono inconfig/items/qb-core.lua, e le immagini inconfig/items/images/. Un item che non è nella lista viene rifiutato, e il giocatore vede "inventory full": a quel punto la console indica l'item. Un item scatola mancante dalla lista non blocca la vendita: il negozio consegna quel telefono senza scatola e lo segnala in console. Se non vuoi affatto le scatole, impostaConfig.Store.box = false. - Soldi: i contanti del personaggio e la sua banca: la risorsa
bankingdi TMC quando è attiva (il suo conto personale), altrimenti i soldi in banca del core. Se i tuoi numeri di conto non hanno il formatoBNK123456, indica il campo che contiene il numero di conto inconfig/config.lua:Config.Providers.tmcBankAccount = 'charinfo.account'(usa il tuo campo). Wallet mostra un trattino, mai una cifra inventata, quando la banca non può essere letta. - Personaggio: il citizen id di TMC.
- Lavori: il lavoro in servizio (o il primo), con il suo grado e lo stato di servizio.
- Avevi il connettore temporaneo
pulse_tmc? Rimuoviensure pulse_tmced elimina quella cartella. La console te lo ricorda finché è ancora attivo.
Standalone (nessun framework)
ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone- Item: non servono. Ogni giocatore ha un telefono, un Reserve e un cavo.
- Soldi: il telefono ha una sua banca. Un nuovo giocatore parte con 5000 (
startingBalanceinconfig/apps.lua). - Personaggio: la licenza Rockstar del giocatore.
- Lavori, auto e case: li gestisce il telefono. Riempili con i comandi di test della sezione 9.
Framework custom o fatto in casa
- Imposta
Config.Framework = 'custom'inconfig/config.lua. - Dai al telefono una tabella bridge strutturata come
optional-developer-kit/custom_framework_bridge.lua: comeConfig.Providers.custominconfig/config.lua, oppure dalla tua risorsa conexports.phone:RegisterFrameworkBridge(MyBridge). - Serve solo
GetCharacterId. Se ometti una funzione per nome, lavoro, licenza o lista veicoli/case, il telefono si comporta come se il tuo server non avesse quei dati. Se ometti una funzione per soldi o item, quell'azione viene rifiutata: il telefono non paga mai da una sua banca. L'app Bank compare solo quando il tuo bridge haGetBankBalance. - Se il tuo core si riavvia mentre il telefono resta acceso, chiama
exports.phone:FrameworkRestarted()quando il core è pronto.
bridge/frameworks/custom.lua mostra come il telefono usa la tua tabella. Per collegare altri script fatti in casa (uno script banking o garage), vedi optional-developer-kit/custom_provider_template.lua e Export. I due template sono nel kit per sviluppatori facoltativo, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, non nella cartella del telefono.