Documentazione di Pulse Phone

Dettagli di installazione

Per Pulse Phone 1.4.26 min di letturaAggiornato il

1. Installazione rapida

Prima di copiare qualsiasi cosa

Usa un artifact del server che soddisfi i requisiti qui sotto, con OneSync attivo e game build 2699 o successiva. Per un normale server roleplay, fai funzionare prima framework, inventario, oxmysql, risorsa voce e screenshot-basic. Funziona anche in standalone senza framework; lì gli item dell'inventario sono facoltativi.

Scarica la risorsa dal tuo account Cfx.re dopo aver riscattato l'acquisto. Usa la key del server che appartiene all'account che possiede l'asset. Se Cfx.re segnala un errore di entitlement, correggi l'associazione account/key; cambiare le impostazioni del telefono non può concedere l'entitlement.

Passaggio 1 — Metti la risorsa nel tuo server

Estrai il pacchetto e copia la cartella della risorsa phone, che contiene fxmanifest.lua, nella cartella resources del tuo server. Non rinominarla e non mettere al suo posto la cartella esterna dello ZIP/pacchetto.

Su un server in hosting, carica in modalità Binary oppure carica lo zip ed estrailo lì (perché). La guida rapida (passaggio 2) elenca numero di file e dimensione di ogni cartella per questa build, e il controllo all'avvio indica ogni file mancante o con dimensione sbagliata.

Ferma la tua precedente risorsa telefono prima di provare Pulse, così due telefoni non si contendono lo stesso tasto e lo stesso item. Fai un backup dei suoi dati se pensi di importarli in seguito.

Passaggio 2 — Aggiungi gli item all'inventario

Scegli il tuo inventario attuale; non devi sostituirlo.

Il tuo inventario Azione richiesta
ox_inventory Apri il file fornito config/items/ox_inventory.lua. Unisci le sue voci in ox_inventory/data/items.lua, dentro la tabella esistente. Non sostituire l'intero file dell'inventario. Mantieni la voce phone di ox_inventory: usarla apre Pulse Phone, e la riga Phone item del controllo all'avvio lo conferma. Sostituiscila con la voce stampata solo quando quella riga dice che apre un altro script. Copia le immagini da config/items/images/ in ox_inventory/web/images/. Riavvia il server dopo la modifica.
qb-inventory con QBCore Le definizioni degli item mancanti vengono registrate automaticamente all'avvio. Copia config/items/images/ in qb-inventory/html/images/. Se il tuo inventario richiede voci condivise permanenti, il file fornito config/items/qb-core.lua è pronto da unire in qb-core/shared/items.lua.
Inventario predefinito di ESX Gli item mancanti vengono aggiunti automaticamente. Se la console chiede un riavvio, riavvia una volta così ESX li legge. Se il tuo account del database non può aggiungerli, usa config/items/esx.sql.
qs-inventory o un altro inventario supportato Segui la breve riga del tuo inventario in Item e inventari. Usa la sua lista item e la sua cartella immagini.
Standalone senza inventario Nessuna voce di inventario necessaria. Lascia disattivati i requisiti degli item.

Il controllo all'avvio individua le voci mancanti e stampa solo le definizioni che ti servono ancora. Un inventario che carica le definizioni degli item all'avvio, come ox_inventory, ha bisogno delle voci sopra; Pulse non sovrascrive i file di un'altra risorsa.

Passaggio 3 — Controlla la configurazione principale

Apri config/config.lua. I valori predefiniti rilevano la tua configurazione attuale:

Lua
Config.Framework = 'auto'

Lascia inventory = 'auto' nella tabella Config.Providers esistente. Se usi più risorse inventario, imposta quel valore sull'inventario che vuoi usare, per esempio 'ox_inventory'. Non aggiungere una seconda tabella Config.Providers o Config.Item in fondo al file.

Nella tabella Config.Item esistente scegli come funzionano i telefoni:

Impostazione Cosa fa
required = false, unique = false Ogni personaggio ha un telefono senza dover portare un item. Utile per il primo test.
required = true, unique = false Il personaggio ha bisogno di un item phone per aprire il proprio telefono. Dare via quell'item non trasferisce i suoi dati.
unique = true Ogni item telefono ha il suo numero e i suoi dati. Passare l'item trasferisce quel telefono. Richiede ox_inventory, qb-inventory, qs-inventory, core_inventory o codem-inventory.
name = 'phone' Nome dell'item nell'inventario. Lascialo così, a meno che tu non cambi anche la definizione dell'item fornita.

I telefoni unici seguono il bridge dell'inventario selezionato. Lascia Config.Item.inventory = 'auto'; questo vecchio override serve solo per installazioni avanzate esistenti. Config.Providers.inventory ha la precedenza quando è impostato esplicitamente.

Non cambiare Config.IdentityScope su un server già avviato. Il default, 'character', tiene separati i telefoni dei diversi personaggi.

Facoltativo: telefoni come item e servizio a pagamento

Per richiedere un item telefono separato per ogni telefono, imposta required = true e unique = true nella tabella Config.Item esistente in config/config.lua, dopo aver aggiunto le voci all'inventario. Usa uno degli inventari per telefoni unici elencati sopra.

Per vendere il servizio telefonico, imposta Config.Carrier.enabled = true nello stesso file. Questo attiva l'app Carrier, dove i giocatori acquistano il loro piano. I nuovi telefoni hanno bisogno di un piano prima che chiamate normali, messaggi e app con dati mobili siano disponibili. App Hub è dove i giocatori installano le app, non il negozio del servizio. Imposta Config.Coverage.enabled = true se vuoi anche le zone di copertura. Copertura e piani a pagamento sono opzioni separate; lascia disattivata quella che non ti serve.

Modifica le impostazioni esistenti invece di aggiungere tabelle duplicate. Riavvia il server dopo aver salvato. Se un'impostazione in gioco era stata salvata in precedenza, reimpostala in Settings → Server così vale il valore del tuo file.

Passaggio 4 — Avvia le dipendenze prima di Pulse

Mantieni la connessione al database e le impostazioni del framework che hai già. Aggiungi solo le righe mancanti; non avviare una seconda copia di nessuna dipendenza.

Usa questo ordine con le risorse già installate sul tuo server:

  1. La risorsa del database e le sue impostazioni di connessione esistenti.
  2. Il framework e le sue librerie richieste, le risorse di identità e dei personaggi.
  3. L'inventario, con la configurazione di quell'inventario per il tuo framework.
  4. Una risorsa voce supportata e screenshot-basic.
  5. ensure phone.

Non installare ESX, QBCore o un inventario diverso solo per Pulse. Scegli la tua configurazione attuale in Il tuo framework per l'esempio di ordine di avvio specifico. Qbox viene rilevato come Qbox anche quando un'altra risorsa usa i suoi export compatibili con QBCore.

Per l'accesso da amministratore a Pulse, aggiungi add_ace group.admin phone.admin allow. Il tuo account amministratore deve già appartenere a group.admin perché il permesso valga.

Passaggio 5 — Leggi il controllo del primo avvio

Riavvia il server. Pulse stampa un report di avvio e crea automaticamente le sue tabelle nel database quando la connessione SQL è disponibile.

  • FIX / FAIL: una parte necessaria non può funzionare. Segui la riga di correzione prima di farla usare ai giocatori.
  • NOTE / WARN: leggi quale funzione è interessata; alcuni avvisi riguardano funzioni facoltative che non hai configurato.
  • Esegui phone:health nella console del server per ripetere il controllo.
  • Esegui phone:diag per vedere framework/inventario/provider scelti.
  • Da admin, entra, apri F8 ed esegui phone:setup per la configurazione guidata.

Le impostazioni salvate nella configurazione admin in gioco hanno la precedenza sulle impostazioni corrispondenti nei file. Se una modifica a un file sembra ignorata, controlla Settings → Server e reimposta quel valore salvato prima di modificare altri file.

Passaggio 6 — Prova come giocatore

  1. Carica un personaggio, premi F1 e completa la configurazione del telefono. Se i requisiti degli item sono attivi, compra prima un telefono dal negozio o dai al personaggio l'item telefono configurato.
  2. Se hai acquistato una scatola sigillata, usa la scatola dall'inventario per aprirla, poi completa la configurazione. Il telefono arriva acceso; con Config.Device.arrivesOn = false tieni premuto prima End o O.
  3. Apri Messages, Contacts e Phone. Torna alla Home, apri l'app switcher e chiudi un'app alla volta.
  4. Scatta una foto e un breve video. Aprili entrambi in Photos, chiudi e riapri il telefono e verifica che ci siano ancora.
  5. Riconnettiti e controlla che lo stesso personaggio abbia ancora lo stesso telefono. Prova le chiamate con un secondo giocatore usando la risorsa voce installata.

Dove modificare le cose

Cosa vuoi modificare File o posizione
Framework, provider dell'inventario, item telefono, negozio, modelli, assegnazione tasti config/config.lua
Provider voce config/config.lua
Impostazioni di app e servizi/lavori config/apps.lua
Voci e immagini dell'inventario config/items/
Connessione al database, ordine di avvio delle risorse, credenziali dell'host media server.cfg (tieni le credenziali private lato server)
Integrazioni per sviluppatori Integrazioni avanzate, il Developer Kit facoltativo (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) e i file bridge/ esistenti; un'installazione normale non richiede di modificarli
Foto/video dei giocatori con lo storage integrato media/; conserva questa cartella quando aggiorni

Le sezioni qui sotto contengono il riferimento dettagliato. Non devi leggere tutte le impostazioni delle funzioni per completare la prima installazione.

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