Documentazione di Pulse Phone

Framework

Per Pulse Phone 1.4.28 min di letturaAggiornato il

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:

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.
  • qb su un server con qbx_core usa 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

server.cfg
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 items di ESX all'avvio, e la console dice quali ha aggiunto. config/items/esx.sql c'è se preferisci aggiungerli tu. Con un altro inventario, vedi la sezione 4.
  • Soldi: la banca è il conto bank di ESX, i contanti sono il conto money.
  • Personaggio: il telefono segue l'identifier del giocatore di ESX, quindi esx_multicharacter funziona.
  • Boss: il grado chiamato boss gestisce l'azienda, a meno che tu non imposti bossGrade.
  • Conti aziendali: esx_addonaccount / esx_society, o uno script banking della sezione 7.

QBCore

server.cfg
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/ a qb-inventory/html/images/; il controllo all'avvio indica quelle che mancano.
  • Soldi: bank e cash.
  • Personaggio: il citizenid, quindi qb-multicharacter funziona.
  • Boss: i gradi con isboss = true nei tuoi lavori, a meno che tu non imposti bossGrade.
  • 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

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
  • 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 in ox_inventory/web/images/.
  • Soldi: bank e cash, tramite qbx_core.
  • Personaggio: il citizenid.
  • Boss: i gradi con isboss = true, a meno che tu non imposti bossGrade.
  • 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

server.cfg
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 in ox_inventory/web/images/.
  • Soldi: la banca è il conto ox_core del personaggio. I contanti sono l'item money in 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

server.cfg
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 bank ND del personaggio e il cash ND (ox_inventory tiene allineato l'item money).
  • 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_vehicles di 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.

server.cfg
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 imposta Config.Store.box = false così il negozio consegna i telefoni direttamente. I giocatori usano gli item di ricarica con /phonepack e /phonecable; con un inventario vRP questi richiedono che il giocatore abbia pulse_magpack e pulse_cable, quindi aggiungi entrambi gli item alla tua lista item di vRP, oppure imposta Config.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).

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

Il 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.lua contiene le voci), e per le scatole del negozio pulse_phone_box più una per ogni finitura (pulse_phone_box_black ...). Etichette, pesi e descrizioni sono in config/items/qb-core.lua, e le immagini in config/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, imposta Config.Store.box = false.
  • Soldi: i contanti del personaggio e la sua banca: la risorsa banking di TMC quando è attiva (il suo conto personale), altrimenti i soldi in banca del core. Se i tuoi numeri di conto non hanno il formato BNK123456, indica il campo che contiene il numero di conto in config/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? Rimuovi ensure pulse_tmc ed elimina quella cartella. La console te lo ricorda finché è ancora attivo.

Standalone (nessun framework)

server.cfg
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 (startingBalance in config/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

  1. Imposta Config.Framework = 'custom' in config/config.lua.
  2. Dai al telefono una tabella bridge strutturata come optional-developer-kit/custom_framework_bridge.lua: come Config.Providers.custom in config/config.lua, oppure dalla tua risorsa con exports.phone:RegisterFrameworkBridge(MyBridge).
  3. 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 ha GetBankBalance.
  4. 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.

Tradotto dall'inglese. Se qualcosa qui non corrisponde alla pagina in inglese, vale la pagina in inglese. English