FiveM OneSync Nedir? OneSync Infinity, Routing Buckets ve Senkronizasyon Rehberi

GTA V rol yapma (Roleplay) dünyasında sunucu yöneticilerinin ve geliştiricilerin en sık araştırdığı konuların başında FiveM OneSync nedir sorusu gelir. Orijinal GTA Online altyapısı maksimum 30-32 oyuncuyu eşzamanlı destekleyecek şekilde tasarlanmış eşler arası (Peer-to-Peer / P2P) bir ağ mimarisine dayanır. Ancak modern FiveM roleplay topluluklarında 64, 128, 256 ve hatta 1000’in üzerinde oyuncunun aynı haritada sorunsuz etkileşime girmesi gerekir. İşte bu noktada Cfx.re ekibinin geliştirdiği OneSync teknolojisi devreye girerek GTA V’in ağ motorunu baştan aşağı yeniden yazar.
Birçok sunucu sahibi sunucu kapasitesini artırmak istediğinde desync (senkronizasyon kaybı), görünmez oyuncular, patlayan araçlar ve sunucu kilitlenmeleri gibi can sıkıcı problemlerle karşılaşır. Bu sorunların temel kaynağı, FiveM OneSync nedir tam olarak kavranmadan yapılan hatalı server.cfg ayarları ve eski nesil scriptlerin getirdiği ağ yüküdür. Bu kapsamlı teknik rehberde; OneSync’in çalışma prensibini, OneSync Legacy ile OneSync Infinity arasındaki farkları, Routing Buckets (sanal boyutlar) sistemini, State Bags kullanımını ve yüksek oyunculu sunucularda performans optimizasyonunu tüm ayrıntılarıyla inceleyeceğiz.
🌐 1. FiveM OneSync Nedir? Senkronizasyon Mimarisinin Temeli
Teknik tanımıyla OneSync; GTA V’in varsayılan P2P ağ mimarisini, sunucu merkezli (Server-Authoritative) bir istemci-sunucu modeline dönüştüren Cfx.re’ye özel bir senkronizasyon çerçevesidir.
Geleneksel GTA Online veya standart FiveM mimarisinde her oyuncunun bilgisayarı (istemci), haritada gördüğü araçların, yayaların ve kendi hareketlerinin verisini sunucudaki diğer tüm oyunculara doğrudan yayınlamak (broadcast) zorundaydı. Bu modelde oyuncu sayısı 32’yi aştığında, ağ trafiği geometrik olarak katlanarak istemcilerin ağ bağlantısını ve bilgisayar işlemcilerini kilitliyordu.
OneSync ile birlikte tüm bu oyun dünyası yönetimi sunucuya (FXServer) devredilmiştir:
- Sunucu Otoritesi (Server Authority): Haritadaki araçlar, NPC’ler (pedler) ve nesneler artık tek bir oyuncunun bilgisayarında değil, doğrudan FXServer üzerinde birer varlık (entity) olarak oluşturulur ve takip edilir.
- Merkezi Ağ Dağıtımı: Oyuncular verilerini diğer oyunculara doğrudan göndermez; tüm veriler önce sunucuya ulaşır, sunucu veriyi doğrular ve yalnızca gerekli oyunculara iletir.
- Ağ Tıkanıklığının Önlenmesi: 32 oyuncunun birbirine veri yollaması $32 \times 31 = 992$ bağlantı paketi üretirken, OneSync mimarisinde istemciler sadece sunucuyla tek bir TCP/UDP soketi üzerinden haberleşir.
FiveM sunucu dosyalarının temel çalışma mantığı ve FXServer altyapısı hakkında temel bilgi edinmek için FiveM Sunucusu Nasıl Kurulur rehberimizi ziyaret edebilirsiniz.

🔄 2. OneSync Türleri: Legacy (On) ve OneSync Infinity Farkları
FiveM ekosisteminde OneSync terimi genellikle iki farklı çalışma modunu ifade eder: OneSync On (Legacy) ve OneSync Infinity. Bu iki mod arasındaki farkları doğru anlamak sunucunuzun kaldırabileceği oyuncu sayısını ve script uyumluluğunu doğrudan belirler:
OneSync On (Legacy Modu – Maksimum 64 Slot)
OneSync’in ilk nesil versiyonudur. Sunucu haritadaki tüm varlıkları yönetir ancak her oyuncu haritanın neresinde olursa olsun sunucudaki diğer tüm 64 oyuncunun koordinatlarını ve varlıklarını bilmeye devam eder. Bu mod eski ESX scriptleriyle son derece uyumludur; ancak 64 oyuncunun üzerine çıkıldığında istemci bellek sınırları aşıldığı için oyun çökmelerine (crash) neden olur.
OneSync Infinity (Gelişmiş Mod – 128 ila 2048 Slot)
Günümüzün büyük roleplay projelerinin kullandığı modern standarttır. Infinity modunda Mesafe Ayıklaması (Distance Culling) adı verilen özel bir algoritma çalışır. Sunucu haritayı sanal ızgaralara (grid) böler:
- Oyuncular yalnızca kendilerine yaklaşık 300 metre mesafede bulunan diğer oyuncuları ve araçları tam detaylı olarak görürler.
- 300 metrenin dışındaki oyuncular istemcinin oyun belleğine yüklenmez; yalnızca harita (minimap) üzerinde birer oyuncu noktası (player blip) olarak gösterilir.
- Bu sayede haritada 500 kişi olsa dahi sizin bilgisayarınız yalnızca çevrenizdeki 15-20 kişiyi işler. İstemci tarafında FPS düşüşü yaşanmaz ve ağ trafiği devasa oranda rahatlar.
🪣 3. Routing Buckets (Sanal Boyutlar / Dünyalar) ve Kullanım Alanları
OneSync’in sunucu performansına kazandırdığı en devrimsel özelliklerden biri Routing Buckets (Yönlendirme Kovaları / Boyutlar) sistemidir. Geleneksel FiveM sunucularında bir apartman dairesi, garaj veya motel odası oluşturmak için oyuncular haritanın görünmeyen bir köşesine ışınlanırdı; ancak yine de aynı dünyada oldukları için birbirlerinin sesini duyabilir veya ağ paketlerini alabilirlerdi.
Routing Buckets sistemi, sunucu içinde birbirinden tamamen izole edilmiş binlerce bağımsız paralel evren oluşturulmasını sağlar:
- Varsayılan Dünya (Bucket 0): Tüm standart harita trafiği, sokaklar ve açık dünya 0 numaralı bucket üzerinde akar.
- İzole Odalar (Bucket 1 – 65535): Bir oyuncu eve, garaja veya banka soygunu görevine girdiğinde script tarafından geçici olarak örneğin
Bucket 42‘ye atanır. - Görünmezlik ve Ayrışma: Bucket 42’deki oyuncular, 0 numaralı ana dünyadaki oyuncuları göremez, duyamaz ve onlarla çarpışamaz. Aynı fiziksel koordinatta olsalar dahi farklı boyutlarda bulunurlar.
- Ağ Tasarrufu: İç mekanlarda bulunan yüzlerce oyuncunun araç ve hareket verileri açık dünyadaki oyunculara hiç gönderilmez; böylece sunucu gecikmesi (tick latency) sıfıra yaklaşır.
FiveM Lua scriptlerinde bir oyuncuyu veya aracı farklı bir boyuta almak son derece basittir:
-- Bir oyuncuyu özel bir apartman boyutuna aktarma (Server-side):
local targetBucket = 105
SetPlayerRoutingBucket(playerId, targetBucket)
-- İlgili boyutta yapay zeka (NPC/Araç) trafiğini kapatma:
SetRoutingBucketPopulationEnabled(targetBucket, false)🎒 4. State Bags ile Veri Senkronizasyonu: Ağ Yükünü Sıfırlama
Eski nesil FiveM scriptlerinin en büyük performans katili, bir oyuncunun veya aracın durumunu güncellemek için sürekli TriggerServerEvent ve TriggerClientEvent çağrıları yapmasıydı. Örneğin bir aracın motor sıcaklığını veya bir oyuncunun kelepçeli olup olmadığını her saniye 100 kişiye broadcast etmek sunucunun ağ kuyruğunu kilitlerdi.
OneSync ile gelen State Bags (Durum Çantaları) özelliği, nesnelerin üzerine doğrudan senkronize değişkenler tanımlamayı sağlar:
-- Sunucu tarafında bir aracın yakıt seviyesini state bag ile kaydetme:
Entity(vehicleNetId).state:set('fuelLevel', 85.5, true) -- Son parametre true: Tüm istemcilere senkronize et
-- İstemci tarafında bu veriyi hiçbir ağ eventi tetiklemeden anında okuma:
local currentFuel = Entity(vehicleNetId).state.fuelLevelState Bags verileri doğrudan OneSync paketinin içerisine gömüldüğü için bağımsız event trafiği üretmez. Sunucunuzdaki scriptlerin bu modern yapıları kullanıp kullanmadığını analiz etmek için FiveM Resmon ve Kaynak Kullanımı rehberimizden faydalanabilirsiniz.
⚙️ 5. OneSync Nasıl Açılır? server.cfg ve txAdmin Yapılandırması
OneSync Infinity’yi FiveM sunucunuzda aktif etmek için hem server.cfg dosyasını hem de txAdmin yönetim panelini doğru yapılandırmanız gerekir:
1. server.cfg Dosyasına Parametreleri Ekleyin
Sunucunuzun kök dizininde bulunan server.cfg dosyasını açın ve en üst satırlara şu parametreleri tanımlayın:
# OneSync Infinity Temel Yapılandırması
set onesync on
set onesync_infinity 1
set onesync_enableBeyond true # 300 metre ötesindeki oyuncu blip'lerini haritada gösterir
set onesync_distanceCulling true # Mesafe ayıklama motorunu aktif eder
set onesync_forceMigration true # Varlık sahipliği geçişlerini hızlandırır
set onesync_population false # Sunucu taraflı rastgele NPC trafiğini kapatır (Performans için önerilir)
# Maksimum Oyuncu Sayısı (Lisans anahtarınıza uygun olarak)
sv_maxclients 64 # 64, 128 veya 2562. txAdmin Üzerinden OneSync Doğrulaması
Eğer sunucunuzu txAdmin üzerinden başlatıyorsanız, txAdmin panelinizde FXServer Settings sekmesine gidin. OneSync ayarını On (Infinity) olarak seçin ve kaydedin. txAdmin parametreleri ve web konsolu hakkında detaylı adımlar için txAdmin Kullanım Rehberimizi inceleyebilirsiniz.
set onesync_population true yapıldığında sunucu haritadaki tüm NPC araç ve yayalarını kendisi hesaplar. 64 oyuncunun üzerindeki sunucularda bu ayarın açık bırakılması sunucu işlemcisine (CPU) devasa bir yük bindirir. Roleplay sunucularında trafik ihtiyacı genellikle özel scriptlerle kontrollü olarak karşılanmalıdır.🔑 6. Slot Yükseltme ve Cfx.re Element Club Lisans Gereksinimleri
Birçok sunucu sahibinin düştüğü yanılgı, OneSync açıldığında ücretsiz lisans anahtarıyla doğrudan 128 veya 256 oyuncuya ulaşılabileceğidir. FiveM’de slot limitleri Cfx.re’nin resmi Element Club (Patreon) üyelik seviyelerine bağlıdır:
- Ücretsiz Lisans (Free): Maksimum 48 slot (OneSync Infinity açılabilir ancak slot 48 ile sınırlıdır).
- Element Club Argentum ($15/ay): Maksimum 64 slot desteği ve özel sunucu renkleri.
- Element Club Aurum ($25/ay): Maksimum 128 slot desteği ve sunucu listesinde öne çıkma.
- Element Club Platinum ($50/ay): Maksimum 2048 slot desteği ve EUP (özel kıyafet paketleri) stream yetkisi.
Patreon üzerinden lisans satın alındıktan sonra keymaster.fivem.net adresinden oluşturulan lisans anahtarı (license key) server.cfg içerisindeki sv_licenseKey alanına yazılmalıdır.
🖥️ 7. Yüksek Oyunculu OneSync Sunucuları İçin VDS Donanım İhtiyaçları
OneSync Infinity ile birlikte oyun varlıklarının hesaplanması istemcilerden alınıp sunucuya yüklendiği için sunucunun donanım mimarisi hayati önem taşır. Yetersiz bir sanal sunucuda OneSync çalıştırmak, konsolda sürekli ‘Server thread hitch warning: timer took X ms’ uyarılarına yol açar:
- Tek Çekirdek İşlemci Gücü (Single-Core IPC): FiveM FXServer ana oyun döngüsünü (main tick) tek bir CPU çekirdeği üzerinde yürütür. Çok çekirdekli ancak düşük frekanslı eski nesil sunucular yerine 4.5 GHz+ tek çekirdek hızına sahip AMD Ryzen 9 veya Intel Xeon işlemciler zorunludur.
- RAM Miktarı: 64 oyunculu bir OneSync sunucusu için minimum 8 GB – 12 GB RAM gerekirken; 128+ oyunculu sunucularda harita ve araç veritabanı önbelleği için en az 16 GB – 24 GB RAM tahsis edilmelidir.
- Saf NVMe Disk: Oyuncuların haritaya anlık giriş çıkışlarında (streaming) disk I/O darboğazı yaşamamak için okuma/yazma hızları 3000 MB/s üzerindeki kurumsal NVMe diskler kullanılmalıdır.
- Ağ Gecikmesi ve Bant Genişliği: OneSync sunucuları yüksek oranda UDP paketi taşır. Düşük ping ve sıfır paket kaybı için Türkiye lokasyonlu kurumsal veri merkezi altyapısı tercih edilmelidir. Ağ optimizasyonunun detayları için VDS Network Latency ve Jitter rehberimizi okuyabilirsiniz.
📊 8. FiveM Senkronizasyon Modları Karşılaştırması
Sunucu altyapınızı seçerken doğru kararı vermeniz için standart P2P, OneSync On ve OneSync Infinity modellerini karşılaştırdığımız teknik tablo:
| Özellik / Kriter | Geleneksel P2P (Eski) | OneSync On (Legacy) | OneSync Infinity (Önerilen) |
|---|---|---|---|
| Maksimum Oyuncu Sınırı | 32 Oyuncu | 64 Oyuncu | 128 – 2048 Oyuncu |
| Ağ Mimarisi | İstemciden İstemciye (P2P) | Sunucu Merkezli (Tüm Harita) | Sunucu Merkezli + Grid Culling |
| Mesafe Ayıklaması (Culling) | Yok | Yok | Var (~300 metre dinamik alan) |
| Routing Buckets Desteği | Desteklenmez | Sınırlı | Tam Destek (65.535 Boyut) |
| İstemci FPS Etkisi | Oyuncu sayısı arttıkça düşer | Orta derecede stabil | Maksimum İstemci FPS’i |
| Sunucu CPU Gereksinimi | Çok Düşük | Orta | Yüksek Tek Çekirdek Performansı |
| Framework Uyumluluğu | Eski ESX | ESX & QBCore | Modern QBCore, ESX Legacy, Qbox |
Modern rol yapma paketlerinde hangi framework’ün tercih edilmesi gerektiği hakkında kapsamlı bir analiz için ESX vs QBCore Karşılaştırma rehberimizi inceleyebilirsiniz.

⚠️ 9. Sık Karşılaşılan OneSync Hataları ve Çözüm Yolları
OneSync Infinity’ye geçiş sürecinde en sık yaşanan problemler ve bunların profesyonel çözüm yolları:
1. Hayalet Oyuncu (Invisible Players) ve Desync Sorunu
Oyuncuların birbirini haritada görmesine rağmen fiziksel olarak görünmez olması durumudur. Genellikle eski bir kıyafet (skin) veya karakter scriptinin GetPlayerPed(-1) fonksiyonunu yanlış kullanmasından kaynaklanır. OneSync Infinity’de oyuncu pedlerine doğrudan yerel istemci üzerinden değil, ağ kimliği (Network ID) üzerinden erişilmelidir:
-- Hatalı Eski Kullanım (OneSync'te kırılır):
local ped = GetPlayerPed(GetPlayerFromServerId(serverId))
-- Doğru OneSync Infinity Kullanımı:
local player = GetPlayerFromServerId(serverId)
local ped = GetPlayerPed(player)
if DoesEntityExist(ped) then
-- İşlemi güvenle gerçekleştirin
end2. Ses Sistemi (Voice Chat) Senkronizasyon Kaybı
OneSync Infinity’de oyuncular 300 metreden uzaklaştığında istemci tarafında silindikleri için eski 3D ses eklentileri (TokoVOIP, mumble eski sürümleri) çöker. Çözüm olarak OneSync Routing Buckets ve Grid sistemini yerel olarak destekleyen pma-voice kütüphanesine geçiş yapılmalıdır.
3. Sonsuz Yükleme Ekranı (Infinite Loading Screen)
Sunucuya bağlanırken yükleme ekranında takılı kalma sorunu, sunucu tarafında sv_maxclients değerinin Keymaster lisans sınırının üzerinde ayarlanmasından kaynaklanır. Lisans seviyenizi kontrol ederek server.cfg dosyasındaki slot sayısını lisans sınırınıza eşitleyin.
4. Reliable Network Event Overflow Hatası
Oyuncu sayısı 100’ün üzerine çıktığında bazı oyuncuların aniden oyundan düşerek ‘Reliable network event overflow’ hatası alması, bir scriptin her karede (frame) kontrolsüz şekilde istemcilere toplu veri göndermesinden kaynaklanır. Bu tür veri akışları doğrudan State Bags mimarisine dönüştürülmeli veya event gönderimleri arasına milisaniyelik gecikmeler (rate limit) eklenmelidir.
❓ 10. FiveM OneSync Hakkında Sık Sorulan Sorular (SSS)
OneSync kullanmak tamamen ücretsiz midir?
Evet. Cfx.re, OneSync ve OneSync Infinity altyapısını tüm sunucu sahiplerine ücretsiz olarak sunar. 48 oyuncuya kadar hiçbir ücret ödemeden OneSync Infinity özelliklerinden faydalanabilirsiniz. Yalnızca 48 slotun üzerine çıkmak (64, 128, 256+) istediğinizde resmi Cfx.re Patreon aboneliği gerekir.
OneSync açtığımda mevcut ESX veya QBCore paketim bozulur mu?
Modern framework sürümleri (ESX Legacy 1.8+, QBCore, Qbox) tamamen OneSync Infinity mimarisine göre kodlanmıştır ve sorunsuz çalışır. Ancak 2018-2020 yıllarından kalma eski ‘ESX v1 Final’ scriptleri OneSync mesafesini algılayamayacağı için bu scriptlerin güncel sürümleriyle değiştirilmesi gerekir.
OneSync Infinity aktifken NPC araç ve yaya trafiği açılabilir mi?
Evet, set onesync_population true komutuyla açılabilir. Ancak sunucu tarafında yüzlerce aracın fiziksel senkronizasyonu işlemciye büyük bir yük getireceğinden, 64’ten fazla oyuncusu olan sunucularda nüfusun kapatılması veya yalnızca belirli bölgelerde kontrollü açılması önerilir.
Oyuncular haritada neden birbirini 300 metreden sonra göremiyor?
Bu bir hata değil, OneSync Infinity’nin temel çalışma prensibidir (Distance Culling). Haritanın diğer ucundaki bir oyuncunun bilgisayarınızda render edilmesi anlamsızdır ve FPS’inizi düşürür. İstemciler yalnızca etkileşime girebilecekleri mesafedeki varlıkları çeker.
OneSync sunucusu için Linux mu yoksa Windows mu tercih edilmelidir?
FXServer çekirdeği Linux (Ubuntu/Debian) ortamında çok daha düşük CPU çekirdek gecikmesiyle (tick latency) çalışır ve bellek yönetimi daha verimlidir. Profesyonel yüksek slotlu FiveM sunucularında Linux VDS altyapısı önerilir.
🏆 11. Sonuç ve AydınCloud Yüksek Performanslı FiveM Sunucu Çözümleri
Özetle; FiveM OneSync nedir sorusunun yanıtı, modern FiveM topluluklarının büyümesini, yüzlerce oyuncunun aynı anda lag ve desync yaşamadan rol yapabilmesini sağlayan teknolojik omurgadır. Doğru yapılandırılmış bir OneSync Infinity kurulumu, Routing Buckets ile izole edilmiş iç mekanlar ve State Bags kullanan optimize scriptler, sunucunuzu oyuncuların vazgeçemeyeceği akıcı bir roleplay merkezine dönüştürür.
AydınCloud olarak, OneSync Infinity projelerinizin gereksinim duyduğu en yüksek tek çekirdek performansını sunan donanımlarla FiveM sunucu hizmeti sağlıyoruz. Yüksek frekanslı AMD Ryzen işlemciler, kurumsal NVMe disk dizilimleri, düşük pingli Türkiye omurgası ve yurt içi/yurt dışı gelişmiş FiveM DDoS korumamızla sunucunuz 7/24 kesintisiz çalışır. Hayalinizdeki büyük FiveM topluluğunu bugün kurmak için AydınCloud FiveM Sunucu paketlerimizi inceleyebilir, ihtiyacınıza en uygun VDS Sunucu yapılandırmasını hemen sipariş verebilirsiniz.
🚀 Yüksek Slotlu ve Kesintisiz FiveM VDS Sunucu Altyapısı
OneSync Infinity projelerinizde desync, hayalet oyuncu ve FPS düşüşü yaşamayın. AydınCloud’un yüksek tek çekirdek frekanslı AMD Ryzen işlemcileri, saf kurumsal NVMe diskleri ve limitsiz DDoS korumalı ağ altyapısıyla 128+ oyunculu FiveM topluluğunuzu hemen kurun.
AydınCloud FiveM Sunucu Paketlerini İnceleyin →
