Documentazione di Pulse Phone
Pulse Phone — Guida rapida
Installa una sola risorsa chiamata phone. Mantieni il tuo framework e gli script supportati che già usi; Pulse li rileva all'avvio.
PhoneHub + Pulse è un'edizione separata con una sua licenza e una sua copia di questo telefono. Se hai acquistato quell'edizione, segui invece la sua guida all'installazione: un server usa una sola risorsa telefono.
1. Controlla il tuo server
| Cosa | Necessario? |
|---|---|
| OneSync attivo, game build 2699 o successiva | Obbligatorio |
| Un database: oxmysql (o mysql-async, ghmattimysql) su MariaDB 10.6+ o MySQL 8 | Consigliato. Senza una risorsa SQL il telefono salva i dati nel key/value store del server |
| Una risorsa voce: pma-voice, mumble-voip, SaltyChat, TokoVOIP o YACA | Consigliata. Senza, le chiamate si collegano ma senza audio |
| screenshot-basic | Consigliato, così la fotocamera può salvare le foto. La risorsa standard funziona |
| Un framework e un inventario | Facoltativi. Senza, il telefono funziona in standalone |
Avvia database, framework, inventario, risorsa voce e screenshot-basic prima di Pulse. Vedi requisiti e il tuo framework per l'ordine corretto.
Fai un backup del database prima del primo avvio. Pulse crea le sue tabelle. Se un altro telefono ha lasciato tabelle con gli stessi nomi, vengono rinominate in old_<name> (non viene eliminato nulla); i dettagli sono nei requisiti.
2. Copia la cartella phone
Scarica il tuo acquisto dal tuo account Cfx.re. Copia la cartella phone che contiene fxmanifest.lua nelle resources del tuo server. Mantieni il suo nome. La key del tuo server deve appartenere all'account che possiede l'asset.
Upload via FTP (server in hosting): usa la modalità Binary (FileZilla: Transfer > Transfer Type > Binary), oppure carica lo zip ed estrailo sul server. La modalità Auto modifica i file protetti e il telefono si rifiuta di partire; sintomi e soluzione sono in Risoluzione dei problemi. La cartella che carichi deve corrispondere a questa tabella; il controllo all'avvio indica ogni file mancante o con dimensione sbagliata.
Il download di Pulse Phone 1.4.2:
| Cartella o file | File | Dimensione |
|---|---|---|
ui/ |
3,932 | 78,3 MB |
stream/ |
40 | 30,5 MB |
config/ |
138 | 23.2 MB |
d6c1e95a/ (il codice bloccato; il nome cambia a ogni release) |
7 | 5,5 MB |
data/ |
2 | 1,4 MB |
bridge/ |
55 | 0,5 MB |
guides/ |
13 | 0,2 MB |
phone.sql |
1 | 0,2 MB |
fxmanifest.lua |
1 | 6 KB |
intera cartella phone |
4,204 | 139.7 MB |
Stai aggiornando un'installazione esistente? Segui prima Aggiornamenti per mantenere impostazioni e media dei giocatori. Ferma la risorsa telefono precedente prima di passare a Pulse.
3. Aggiungi gli item all'inventario
Apri Inventari e segui le istruzioni per l'inventario che usi già. Le definizioni e le immagini fornite sono in config/items/. Unisci le voci al tuo inventario; non sostituire il suo intero file degli item.
L'inventario predefinito di ESX e QBCore possono registrare automaticamente le definizioni mancanti. Altri inventari possono richiedere le voci fornite. Copia le immagini degli item dove le aspetta il tuo inventario. In standalone senza inventario non servono item.
4. Avvia Pulse
Mantieni il rilevamento automatico in config/config.lua. La prima sezione contiene framework, lingua, scelta dell'inventario, item telefono e tasti. Le impostazioni facoltative sono elencate in Configurazione.
Aggiungi questo dopo le dipendenze già presenti in server.cfg:
ensure phone
add_ace group.admin phone.admin allowRiavvia il server. Pulse crea le sue tabelle nel database quando la connessione SQL è disponibile. Leggi il suo controllo in console e segui eventuali istruzioni correttive. Esegui phone:health per ripeterlo.
5. Apri il telefono
Entra come amministratore, apri F8 e scrivi phone:setup. Conferma il framework e l'inventario rilevati, poi completa la configurazione guidata. Premi F1 o usa /phone per aprire il telefono. Se le tue impostazioni richiedono un item, compra prima un telefono e usa la sua scatola dall'inventario.
Le impostazioni salvate in Settings → Server hanno la precedenza sulle stesse impostazioni nei file. Reimposta lì un valore salvato se vuoi che torni a valere quello del file.
6. Facoltativo: lo screenshot-basic più leggero
Il tuo download contiene anche una cartella screenshot-basic. È lo screenshot-basic di CitizenFX (licenza MIT) con una sola modifica: l'originale continua a ridisegnare l'immagine del gioco per il suo livello di cattura a ogni frame, anche quando nessuno sta scattando una foto, mentre questa copia disegna solo mentre si scatta una foto. Il nome della risorsa, i suoi export (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) e i suoi eventi non cambiano, ed è già compilata, quindi non deve compilarsi da sola al primo avvio. I file modificati sono elencati in screenshot-basic/ZERODEV-CHANGES.md.
Pulse funziona con entrambe le copie, quindi questo passaggio è facoltativo. Anche altri script sul tuo server usano screenshot-basic, quindi se hai un server di test fai il cambio prima lì:
- Rinomina la tua cartella
screenshot-basicattuale (per esempio inscreenshot-basic.bak) e spostala fuori daresources, così puoi rimetterla. - Copia la nostra in
resourcescon lo stesso nome,screenshot-basic, e mantieni la stessa rigaensure screenshot-basic. - Riavvia il server e prova ogni script che fa screenshot: la fotocamera del telefono e qualsiasi strumento di report, prove o bodycam che usi.
- Se qualcosa si comporta in modo diverso, elimina la nostra copia, rimetti la tua vecchia cartella come
screenshot-basice riavvia.
Configura le funzioni che usi
- Chiamate, video e Live: risorse voce supportate, controlli delle chiamate e configurazione della connessione video in produzione.
- Foto e video: storage integrato, FiveManage e altre opzioni di upload. Le chiavi private dei servizi restano nella configurazione del tuo server. Su un server in hosting la cui porta web non è raggiungibile, le foto richiedono FiveManage: due righe in
server.cfg(set phone_media_provider "fivemanage"eset phone_fivemanage_token "<token>"). - Configurazione: negozi, app, accessori, lingue e funzioni facoltative.
- Risoluzione dei problemi: trova il sintomo e segui la sua soluzione.
- Integrazioni per sviluppatori: script custom e impostazioni di connessione avanzate.
Un'installazione normale non richiede di modificare bridge/, ui/ o stream/. Tieni insieme la risorsa completa, compresi i modelli e gli asset della mappa.