Server FiveM OneSync: guida completa a configurazione e comandi

Per abilitare OneSync avvia il server con il parametro +set onesync on (o infinity per la modalità estesa) nella riga di comando dell’eseguibile, non solo nel server.cfg. Verifica il risultato aprendo http://ip:porta/info.json oppure controllando la console del server all’avvio. Otterrai state awareness e più slot disponibili, ma testa sempre gli script critici prima di spostare la modifica in produzione.

In breve:

• Attivare OneSync richiede l’aggiunta del parametro +set onesync on nella riga di comando dell’eseguibile, preferibilmente tramite script di avvio, non solo nel file server.cfg.
• È fondamentale verificare l’attivazione tramite http://ip:porta/info.json o console, prima di spostare la configurazione in produzione, soprattutto quando si passa a mode Infinity.
• Per supportare più di 48 slot, è necessario un abbonamento Element Club e impostare correttamente sv_maxclients, oltre a attivare la variabile onesync_population true per la gestione della popolazione.
• In caso di problemi di desincronizzazione, bisogna controllare i log, disabilitare risorse non compatibili, aggiornare gli script obsoleti e testare prima in modalità legacy rispetto a onesync on.
• La corretta gestione delle entità e delle state bags con OneSync richiede script aggiornati e l’uso di native dedicate, come SET_ENTITY_ORPHAN_MODE e routing buckets, per evitare entità “orfane” o problemi di proprietà.

Indice

• Procedura passo passo per abilitare OneSync con FXServer e txAdmin
• Le variabili OneSync che devi conoscere
• Come risolvere i problemi più comuni segnalati dalla community
• Compatibilità degli script e comportamento delle entità con state bags
• Monitorare le prestazioni e mantenere il server stabile sotto carico
• Perché un hosting professionale riduce i rischi operativi di OneSync
• Prospettiva operativa sull’ordine delle operazioni prima di Infinity
• Un’opzione pratica per chi gestisce server FiveM con OneSync
• Documentazione e thread tecnici utili per approfondire
• Fonti
• Domande frequenti

Procedura passo passo per abilitare OneSync con FXServer e txAdmin

Il modo più affidabile per attivare OneSync passa dallo script di avvio del server, non dal file di configurazione. Su Windows si tratta del .bat, su Linux dello script .sh che lancia l’eseguibile FXServer: qui va inserito il parametro +set onesync on, seguito da +exec server.cfg per caricare il resto della configurazione. Secondo un thread della community su come abilitare OneSync, modificare solo il server.cfg spesso non basta: il parametro deve comparire nella riga di comando dell’eseguibile.

1. Apri lo script di avvio e aggiungi +set onesync on prima del richiamo al server.cfg.
2. Imposta sv_maxclients in base allo slot count desiderato: oltre i 48 slot è necessario un abbonamento Element Club tramite Cfx, come indicato nella documentazione ufficiale di OneSync.
3. Abilita la popolazione con +set onesync_population true per far spawnare peds e veicoli gestiti dal server.
4. Riavvia il server e controlla http://ip:porta/info.json per confermare che OneSync sia attivo.
5. Nella console di gioco usa F8 e il comando netgraph per osservare latenza e throughput durante i primi minuti di funzionamento.

Se usi txAdmin, la stessa configurazione si applica tramite il Portal, che permette di modificare la riga di avvio e monitorare i log senza accedere direttamente alla shell del server, come descritto nella guida ufficiale per l’impostazione con txAdmin. Per chi imposta un ambiente da zero, una guida passo passo alla creazione di un server copre la fase precedente all’abilitazione di OneSync.

Un consiglio: Attiva sempre onesync on prima di passare a infinity: isoli eventuali incompatibilità degli script senza aggiungere contemporaneamente la complessità del routing su larga scala.

Le variabili OneSync che devi conoscere

Ogni variabile OneSync ha un effetto specifico sul comportamento di sincronizzazione e va posizionata nel punto giusto della configurazione. Il parametro principale, onesync, accetta i valori on, off o legacy e determina se il server usa lo stato condiviso lato server o il vecchio modello peer to peer.

• onesync on attiva la sincronizzazione moderna con state awareness e supporta un elevato numero di giocatori in modalità Infinity, secondo la documentazione ufficiale OneSync.
• onesync_enableInfinity true estende i limiti oltre i 128 slot storici, ma richiede script già compatibili e testati in modalità on.
• onesync_population true abilita la generazione di peds e veicoli casuali gestiti dal server; senza questa variabile la popolazione resta gestita lato client.
• onesync_forceMigration forza la migrazione della proprietà delle entità tra i client quando il proprietario originale esce dallo scope, riducendo veicoli o oggetti “orfani”.
• onesync_distanceCullVehicles controlla a quale distanza i veicoli non occupati vengono rimossi dallo stato del server, utile per contenere il carico su mappe grandi.
• onesync_migrateDataTimeout regola il tempo massimo concesso per la migrazione dei dati di un’entità prima che il server intervenga.

Queste variabili vanno impostate nella riga di comando di avvio quando riguardano il comportamento core di OneSync (come onesync stesso), mentre le variabili ausiliarie di culling e migrazione si possono gestire comodamente nel server.cfg tramite set. Un esempio minimo di configurazione nel server.cfg:

set onesync_population true
set onesync_distanceCullVehicles 500
set onesync_forceMigration true

La documentazione dei comandi server descrive nel dettaglio l’effetto di ciascuna variabile e le native collegate, come SetPedPopulationBudget e SetVehiclePopulationBudget, utili per calibrare la densità della popolazione una volta attivata.

Come risolvere i problemi più comuni segnalati dalla community

I sintomi tipici di una configurazione OneSync problematica sono facili da riconoscere ma spesso mal diagnosticati. Veicoli che spariscono, peds che non spawnano, giocatori che si vedono in posizioni diverse rispetto a quelle reali: sono tutti segnali di desincronizzazione tra client e server, spesso legati a script pensati per il vecchio modello peer to peer.

1. Controlla i log del server all’avvio e durante il gioco per individuare errori ripetuti legati a risorse specifiche.
2. Disabilita le risorse una alla volta, partendo da quelle più recenti o meno testate, per isolare la causa della desincronizzazione.
3. Confronta il comportamento in modalità onesync legacy rispetto a on: se il problema scompare in legacy, lo script coinvolto non è ancora compatibile.
4. Aggiorna o correggi gli script che chiamano GetPlayerFromServerId senza verificare il valore restituito: quando il giocatore non è nello scope, la funzione restituisce -1, e uno script che non controlla questo caso può generare falsi positivi, come segnalato in un thread su OneSync Infinity.
5. Se il problema riguarda la popolazione, verifica che onesync_population true sia effettivamente attivo e valuta onesync_forceMigration per ridurre entità orfane.

L’hitching del sync thread, ovvero microblocchi percepibili quando molti giocatori o veicoli si concentrano nella stessa area, è un problema segnalato ripetutamente sul forum della community: monitorare la densità per zona e limitare i carichi concentrati riduce la frequenza del fenomeno. Una causa ricorrente, secondo un report su problemi di sincronizzazione, resta l’uso di script obsoleti progettati per architetture P2P: la raccomandazione è testare sempre in modalità on prima di passare a infinity.

Un consiglio: Tieni una copia della configurazione funzionante prima di ogni modifica: ripristinarla in pochi secondi vale più di qualsiasi ipotesi sulla causa del problema.

Compatibilità degli script e comportamento delle entità con state bags

OneSync cambia radicalmente il modo in cui il server tratta la proprietà delle entità, e questo richiede attenzione da parte di chi scrive o mantiene script. Con la sincronizzazione moderna, un’entità fuori dallo scope di qualsiasi client può diventare “unowned”: il server la gestisce direttamente, riassegnandola o rimuovendola secondo le regole di culling, come spiegato nella nota ufficiale sulla persistenza server-side. Questo comportamento risolve molti casi storici di veicoli non utilizzabili, ma richiede che gli script gestiscano correttamente la proprietà, specialmente per le mission entities create con CREATE_VEHICLE.

• Le state bags permettono di associare dati persistenti a entità o giocatori, sincronizzati automaticamente dal server verso i client interessati.
• Attivare sv_stateBagStrictMode riduce il rischio che script non autorizzati scrivano su state bags che non dovrebbero modificare, migliorando la sicurezza generale.
• Per entità che devono restare disponibili indipendentemente dallo scope client, la documentazione consiglia di usare SET_ENTITY_ORPHAN_MODE con il valore KeepEntity, assicurandosi che lo script gestisca l’ownership in modo esplicito.
• I routing buckets permettono di isolare stato e popolazione per istanze virtuali separate, una funzione che richiede OneSync on e che si appoggia a native dedicate, come descritto nella documentazione sui routing buckets.

Chi gestisce una libreria di script complessa trova utile una revisione sistematica delle risorse più vecchie prima di attivare Infinity: una guida sulla qualità degli script FiveM approfondisce come individuare pattern di codice incompatibili con il modello di ownership moderno.

Monitorare le prestazioni e mantenere il server stabile sotto carico

Una volta attivo OneSync, il monitoraggio delle prestazioni diventa la differenza tra un server stabile e uno che degrada progressivamente sotto carico. Le metriche da osservare con costanza includono il tempo CPU per tick (msec), l’uso di memoria, il packet loss e i dati forniti dal comando netgraph in console.

• Usa resmon in console per identificare rapidamente le risorse che consumano più tempo CPU per frame.
• Limita i budget di popolazione (SetPedPopulationBudget, SetVehiclePopulationBudget) su mappe con alta densità di giocatori, invece di lasciare i valori predefiniti.
• Introduci nuove risorse o aumenti di slot in modo incrementale, misurando l’impatto prima di aggiungere il carico successivo.
• Prima di ogni deploy importante, esegui un test in staging con condizioni simili alla produzione, incluso un numero realistico di giocatori simulati.

Un consiglio: Prendi uno snapshot completo del server (file, database, configurazione) prima di ogni aggiornamento di OneSync: un piano di rollback pronto riduce il tempo di inattività in caso di regressione.

Una checklist di deploy solida prevede anche un backup automatico programmato e non solo manuale, così da avere sempre un punto di ripristino recente anche quando l’aggiornamento avviene fuori orario. Una checklist pratica di ottimizzazione per server FiveM raccoglie i passaggi utili per chi vuole formalizzare questo processo.

Perché un hosting professionale riduce i rischi operativi di OneSync

Gestire OneSync richiede accesso rapido ai log, possibilità di modificare la riga di avvio senza vincoli e un piano di ripristino immediato in caso di errore. Un’infrastruttura pensata per questo tipo di operatività riduce il tempo perso nella diagnosi e nel ripristino.

• I server si attivano rapidamente, un vantaggio concreto quando serve testare rapidamente una modifica a OneSync in un ambiente separato dalla produzione.
• La protezione DDoS riduce il rischio che un attacco esterno si sovrapponga a un problema di sincronizzazione già in corso, complicando la diagnosi.
• Il pannello Pterodactyl con moduli sviluppati ad hoc semplifica la modifica della riga di avvio, la gestione dei file di configurazione e l’accesso ai backup senza passare dalla shell.
• Il supporto tecnico in italiano via Discord è disponibile nei giorni lavorativi per chi ha bisogno di un confronto rapido durante una migrazione a Infinity o un troubleshooting complesso.

Chi valuta un piano gestito per un server FiveM può consultare la pagina dedicata ai piani FiveM di AtomSync per i dettagli su risorse e configurazione disponibili.

Prospettiva operativa sull’ordine delle operazioni prima di Infinity

La sequenza con cui si attivano le funzionalità OneSync conta più delle singole variabili. Molti amministratori saltano direttamente a Infinity per ottenere più slot, ma questo aggiunge complessità di routing e popolazione proprio mentre si stanno ancora isolando le incompatibilità degli script di base. L’ordine corretto resta: testare in staging, aggiornare gli script critici, abilitare onesync on da solo, verificare la stabilità, poi introdurre la popolazione a fasi e solo infine valutare Infinity.

Tenere traccia delle build del server e dei relativi changelog evita sorprese quando un aggiornamento cambia il comportamento di una variabile che si considerava stabile. Un piano di rollback e uno snapshot recente non sono un’opzione da attivare dopo il primo incidente: devono essere pronti prima di ogni modifica, non dopo.

— Fabio Turi

Un’opzione pratica per chi gestisce server FiveM con OneSync

Configurare OneSync in modo stabile richiede tempo dedicato a test, log e rollback, tempo che molti amministratori preferirebbero investire nella community piuttosto che nell’infrastruttura. AtomSync riduce questo carico operativo con server FiveM attivabili in meno di 60 secondi, backup automatici quotidiani e un pannello Pterodactyl personalizzato che semplifica l’accesso a file e configurazioni senza passare dalla riga di comando ogni volta.

• Attivazione del server in meno di 60 secondi, utile per creare rapidamente un ambiente di staging separato dalla produzione.
• Protezione DDoS dichiarata fino a 1 Tbps, pensata per mantenere il server online durante i picchi di traffico o tentativi di attacco.
• Supporto tecnico in italiano via Discord nei giorni lavorativi, per chi vuole un confronto diretto durante una migrazione a Infinity.

Chi vuole verificare i piani disponibili per FiveM, tra cui Citizen Plan e Detective Plan, può consultare la pagina piani FiveM di AtomSync e valutare quale configurazione si adatta meglio al proprio ambiente di test o produzione.

Documentazione e thread tecnici utili per approfondire

Per chi vuole verificare ogni comando alla fonte, la documentazione ufficiale OneSync e la documentazione sui comandi server restano i riferimenti primari. I thread della community su forum.cfx.re citati nelle sezioni precedenti raccolgono casi reali di desincronizzazione, hitching e migrazione, utili per confrontare i propri sintomi con esperienze già documentate.

Fonti

• OneSync - Cfx Documentation
• How to enable OneSync on FiveM server (forum thread)

Domande frequenti

Come si abilita OneSync su un server FiveM?

Si abilita aggiungendo +set onesync on (o infinity per la modalità estesa) nella riga di comando dello script di avvio del server, non solo nel server.cfg. Dopo il riavvio, la verifica avviene controllando http://ip:porta/info.json o la console del server, come indicato nella documentazione ufficiale OneSync.

FiveM ha restrizioni di età per l’accesso ai server?

FiveM è una modifica non ufficiale di un gioco con classificazione per adulti, quindi l’accesso ai server dipende dalle politiche della piattaforma e dei singoli server di gioco di ruolo. Non è un tema legato alla configurazione tecnica di OneSync trattata in questa guida.

Qual è il miglior server FiveM da scegliere?

Non esiste un server “migliore” in assoluto: la scelta dipende dal tipo di gioco di ruolo, dagli script installati e dalla qualità della community. Dal punto di vista tecnico, un server stabile è quello con OneSync configurato correttamente, script aggiornati e un’infrastruttura di hosting con backup e supporto adeguati.

Cos’è OneSync e a cosa serve?

OneSync è il sistema di sincronizzazione che sposta la gestione dello stato di gioco dal modello peer to peer a un modello centrato sul server, introducendo state awareness e aumentando il limite massimo di slot. Secondo la documentazione ufficiale, è gratuito fino a 48 slot e supporta un elevato numero di giocatori nella modalità Infinity, ma superare i 48 slot richiede un abbonamento Element Club.

Serve aggiornare gli script quando si attiva OneSync?

Sì: gli script pensati per il vecchio modello peer to peer spesso causano desincronizzazioni o entità mancanti una volta attivato OneSync. La nota ufficiale sulla persistenza server-side spiega perché la gestione della proprietà delle entità cambia e richiede script aggiornati per gestirla correttamente.

Raccomandati

• Server FiveM online in 30 minuti: checklist, txAdmin e
• Script FiveM: guida alla qualità e gestione server
• Ottimizzare server FiveM: la checklist che riduce davvero
• Costo di un server FiveM: guida prezzi 2026