Skip to Content
🔥 Nová dokumentace BlazeHost.cz je online — prohlédnout

OneSync

OneSync je síťový systém FiveM, který přesouvá vlastnictví entit (vozidel, NPC, objektů) z klienta na server. Bez něj drží stav entit jednotliví hráči, což omezuje počet slotů na 32 a je náchylné k podvádění.

Kdy ho potřebuješ

Pokud chceš víc než 32 hráčů, je OneSync povinný. Standardní model připojení bez OneSyncu neumí víc než 32 slotů bez ohledu na sv_maxclients.

Bez OneSyncu je strop 32 hráčů i tehdy, když v server.cfg nastavíš sv_maxclients 64. Server přijme jen prvních 32 připojení.

Režimy

RežimSlotyPopis
legacydo 32Starý model bez server-side ownership, na ústupu
ondo 128Standardní OneSync, server drží entity
infinity128+Rozšíření on pro velké populace (bigmode)

Hodnota on je synonymum pro moderní OneSync a pokrývá naprostou většinu serverů. Vyšší hodnoty aktivuješ implicitně vyšším sv_maxclients.

Zapnutí

V server.cfg přidej řádek set onesync on a nastav požadovaný počet slotů:

server.cfg
set onesync on sv_maxclients 64

Po restartu server naběhne s OneSyncem. Ověř to v konzoli — v startovacím logu uvidíš, že OneSync je aktivní.

Routing buckets

Routing buckety jsou oddělené „dimenze” na jednom serveru. Hráči v různých bucketech se navzájem nevidí a jejich entity se nesynchronizují napříč buckety. Hodí se na instancované interiéry, minihry nebo lobby.

server.lua
-- Presun hrace do bucketu 5 (izolovana instance) SetPlayerRoutingBucket(source, 5)

Routing buckety fungují jen s OneSyncem. Bez něj server o oddělených dimenzích neví.

Dopad na výkon a kompatibilitu

OneSync přesouvá výpočet entit na server, takže při vysokém počtu hráčů roste zátěž serverového CPU. Ladění zátěže popisuje Performance tuning.

  • Starší skripty psané pro legacy model mohou vyžadovat úpravy — typicky nahrazení client-side nativů jejich OneSync variantami.
  • Populace NPC a vozidel se řídí convary jako onesync_population.
  • Distance culling (onesync_distanceCullVehicles) sníží síťovou zátěž na velkých mapách.

Tipy

  • Zapni OneSync i pod 32 sloty. Získáš server-side ownership a lepší ochranu proti cheaterům, i když sloty nevyužiješ.
  • Testuj resources po zapnutí. Skript, který fungoval v legacy režimu, se může chovat jinak — hlavně u synchronizace entit.

Poznámka

OneSync je součást licence zdarma, neplatíš za něj nic navíc. Sloty jsou dané tarifem a hardwarem — víc hráčů znamená vyšší nároky na CPU jednoho jádra, ne na počet jader.

Související články