FiveM Sunucu Kurma Rehberi: txAdmin, ESX ve QBCore 2026

FiveM sunucusu kurmanın resmî yolu sanıldığından kısa: Cfx’in kendi belgesi buna “Ultimate easy setup guide” diyor ve 14 adımda bitiriyor. Zorluk kurulumda değil, kurulumdan sonraki server.cfg ayarlarında: slot sayısı, senkronizasyon modu ve güvenlik değişkenleri yanlış ayarlandığında sunucu ya listeye düşmüyor ya da performans sorunları yaşıyor.

Bu rehberdeki her adım, değişken ve varsayılan değer docs.fivem.net’teki Setting Up a Server, Setting up a server using txAdmin, Server Commands ve OneSync sayfalarından alındı. ESX ve QBCore gibi topluluk altyapılarını resmî bir kaynak varmış gibi sunmuyoruz; o ayrımı da yazıda açıkça yapıyoruz.

İçindekiler

1. Başlamadan önce: lisans anahtarı
2. txAdmin ile kurulum
3. server.cfg: kritik değişkenler
4. Oyun yapısı: sv_enforceGameBuild
5. Sunucu konsol komutları
6. Sunucum listede görünmüyor
7. ESX ve QBCore: resmî değil
8. Sunucu sahibi olarak sorumluluklarınız
9. Artifact güncellemesi: üç aylık sessiz kural
10. Sık Sorulan Sorular
11. İlgili İçerikler

Başlamadan önce: lisans anahtarı

Cfx’in Setting Up a Server sayfasındaki ilk başlık “Before you begin” ve tek madde içeriyor: henüz yapmadıysanız Cfx Portal üzerinden ücretsiz bir lisans anahtarı kaydedin. Bu anahtar kurulumun ortasında isteniyor, bu yüzden önceden hazır olması gerekiyor.

Aynı sayfa dört farklı kurulum yolu listeliyor: oyun sunucusu barındırma sağlayıcıları, txAdmin ile kolay kurulum, Windows için elle kurulum ve Linux için elle kurulum. Bu yazı txAdmin yolunu anlatıyor, çünkü Cfx’in kendisi bunu en kolay yöntem olarak sunuyor.

txAdmin ile kurulum

Belgedeki sıranın tamamı şöyle işliyor:

1. Server Download sayfasını açın ve önerilen yapıyı indirin.
2. İndirdiğiniz server.7z dosyasını 7-Zip ya da WinRAR gibi bir arşiv aracıyla açın ve saklamak istediğiniz yere çıkarın. Belgedeki örnek konum C:\FXServer\server.
3. FXServer.exe dosyasına çift tıklayın. Tarayıcınızda txAdmin arayüzü açılıyor.
4. PIN alanının dolu olduğundan emin olup Link Account düğmesine basın.
5. Açılan sekmede Cfx hesabınıza giriş yapıp Yes, Allow deyin.
6. Sunucunuzun yönetici sayfası için bir şifre oluşturun ve Next deyin.
7. Sunucunuza bir ad yazıp Next deyin.
8. Popular Recipes bölümünü seçin.
9. CFX Default FiveM şablonunu seçin. Cfx burada uyarıyor: başka şablonlar da bulunabiliyor ancak bazıları veritabanı sunucusu gerektiriyor.
10. Save deyin ya da başka bir yol seçin, ardından Recipe Deployer bölümüne geçin.
11. Tarifin düzgün göründüğünden emin olunca Next deyin. Belgeye göre geldiği hâliyle sorunsuz olmalı.
12. Başlangıçta Portal’dan aldığınız anahtarı girip Run Recipe düğmesine basın.
13. Her şey doğruysa tekrar Next deyin.
14. Son adım: Save & Run Server.

Enhanced sunucusu kuruyorsanız

Belgede üç ayrı not var. FiveM for GTAV Enhanced sunucusu kuruyorsanız server.7z dosyasının adı cfx-server_win_x64, FXServer.exe dosyasının adı ise cfx-server.exe oluyor. Üstelik Microsoft Visual C++ 2017 Redistributable kurulu olmak zorunda; Cfx bunu sunucuyu çalıştırmadan önce indirip kurmanızı söylüyor.

Enhanced tarafında bir başka fark da gamebuild desteği: Cfx’in belgesine göre Enhanced şu an yalnızca en güncel yapıyı destekliyor ve başka bir yapı belirtilmezse o yükleniyor. İki sürüm arasındaki tüm farkları sistem gereksinimleri yazımızda karşılaştırdık.

server.cfg: kritik değişkenler

Slot sayısı ve senkronizasyon

Burada bir zincir var ve halkalarından birini atlarsanız sunucu beklediğiniz gibi çalışmıyor:

• sv_maxClients 1 ile 2048 arasında bir tam sayı alıyor. Belgedeki kural net: 32’den başlayan değerler onesync’in on ya da legacy olmasını, 64 üzerindeki değerler ise onesync’in mutlaka on olmasını gerektiriyor.
• onesync üç değer alıyor. Off: hiç durum farkındalığı yok, istemciler standart GTA/RAGE P2P ağ modelini kullanıyor ve sunucu yalnızca aktarıcı olarak çalışıyor. On: tam durum farkındalığı ve sunucu tarafından belirlenen varlık yönlendirmesi. Legacy: tüm oyuncuların her istemcide var olmasını bekleyen betikler için uyumluluk modu; Cfx bunu performans sorunları ve grafik hataları sebebiyle önermiyor.
• OneSync belgesine göre OneSync 48 slota kadar ücretsiz; üstü için Cfx Portal üzerinden bir abonelik gerekiyor.

OneSync ince ayarları

OneSync belgesine göre Infinity modunda oyuncu çevresindeki odak bölgesi 424 birim olarak sabitlenmiş durumda ve bu bölgenin dışında istemcilerde varlık oluşturulmuyor. Aynı belge nesne kimliği uzunluğunun 8192’den 65535‘e çıkarıldığını da belirtiyor. Araçların neden kaybolduğunu araç işlemleri yazımızda ayrıntılandırdık.

Güvenlik

• sv_scriptHookAllowed varsayılan olarak false. Cfx’in notu açık: true yapmak Script Hook V kullanan istemcilerin bağlanmasına izin veriyor ve önerilmiyor, çünkü sunucuyu güvenlik sorunlarına karşı savunmasız bırakıyor.
• sv_entityLockdown varsayılan olarak inactive ve dört değer alıyor: full (sahte nesne oluşturmayı kapatıyor, yalnızca Enhanced’de kullanılabiliyor), strict (istemciler hiç varlık oluşturamıyor), relaxed (yalnızca istemcilerin oluşturduğu betik sahipli varlıklar engelleniyor) ve inactive (istemciler her türlü varlığı oluşturabiliyor).
• sv_endpointPrivacy true yapıldığında sunucunun ürettiği genel raporlarda oyuncu IP adresleri gizleniyor.
• sv_licenseKey Portal’dan aldığınız anahtarı tutuyor.

Oyun yapısı: sv_enforceGameBuild

Sunucunuzun hangi DLC içeriğiyle çalışacağını belirleyen değişken bu ve belgeye göre yalnızca başlangıçta ayarlanabiliyor, çalışma sırasında değiştirilemiyor. Belgedeki önemli not: her yapı kendinden önceki yapıların tüm içeriğini ve değişikliklerini içeriyor.

Kullanımı sv_enforceGameBuild 3407 ya da takma adıyla sv_enforceGameBuild mp2024_02 biçiminde. DLC’siz temel oyunu zorlamak için sv_enforceGameBuild 1 kullanılıyor.

Oyuncular bu yüzden “build transition” ekranıyla karşılaşıyor. İstemci tarafında bu bekleme, kısayola -bXXXX parametresi eklenerek atlanabiliyor; ayrıntısı kurulum rehberimizde.

Sunucu konsol komutları

Belgeye göre bu komutlar bir RCon aracından, doğrudan sunucu konsolundan, bir yapılandırma dosyasından, sunucu komut satırından ya da ACL izin veriyorsa bir kaynağın içinden çalıştırılabiliyor.

Sunucum listede görünmüyor

Cfx’in Server Issues sayfası bu sorunu baştan sona ele alıyor ve kök sebep olarak hatalı port yönlendirme ile güvenlik duvarı yapılandırma sorunlarını gösteriyor. Belgedeki kontrol sırası:

1. Doğrudan bağlantı testi: FiveM’de F8 ile konsolu açıp connect IP:Port yazın (örnek: connect 127.0.0.1:30120). Doğrudan bağlantı başarısızsa sorun büyük olasılıkla port yönlendirme ya da güvenlik duvarıdır.
2. sv_master1 satırını kontrol edin: server.cfg dosyanızda #sv_master1 “” satırı bulunmalı. Başındaki # eksikse sunucunuz listede özel görünebiliyor ve tarayıcıdan katılmak isteyenler için katılma düğmesi devre dışı kalıyor. Satır hiç yoksa eklemenize gerek yok, varsayılan olarak devre dışı.
3. Sunucunun çalıştığını doğrulayın: tarayıcınızda http://ip:port/info.json adresini açın (örnek: http://127.0.0.1:30120/info.json). Sayfa sunucunuzla ilgili bilgi içeren bir JSON nesnesi döndürmeli. Dışarıdan erişilebildiğini sınamak için yerel adres yerine genel IP adresinizi kullanın.
4. Gerekli değişkenleri doğrulayın: server.cfg içinde sets sv_projectName ve sets sv_projectDesc tanımlı olmalı. Belgeye göre bu değişkenlerden biri eksikse sunucu başlangıçta hata gösteriyor ve listede görünmeyebiliyor.
5. Sabırlı olun: başka bir sinyal gönderilmediyse sunucunun listede görünmesi başlatmadan sonra 8 dakikaya kadar sürebiliyor.

Belge bir uyarı daha ekliyor: UDP kaynak portlarını maskeleyen bir NAT ya da ağ geçidi arkasındaysanız sunucunuz görünmeyebiliyor. Port testinin varsayılan portu 30120.

ESX ve QBCore: resmî değil

Türkiye’deki rol yapma sunucularının çoğu ESX ya da QBCore altyapısını kullanıyor. Burada dürüst olmak gerekiyor: bunların ikisi de topluluk tarafından geliştirilen altyapılar ve Cfx’in resmî belgelerinde kurulum tarifleri bulunmuyor. Belgelerde geçen şey, kaynak (resource) kavramı ve txAdmin’in “recipe” sistemi.

Cfx’in txAdmin sayfasındaki uyarı tam da bu noktada önemli: Popular Recipes bölümünde başka şablonlar bulunabiliyor ancak bazıları veritabanı sunucusu gerektiriyor. ESX ve QBCore tam olarak bu gruba giriyor; kurulumlarından önce bir MySQL sunucusu hazırlamanız gerekiyor. Başlangıç için Cfx’in önerdiği şablon CFX Default FiveM.

Bir de hukuki taraf var. Rockstar’ın 10 Eylül 2026 tarihli Creator Platform License Agreement metni, üçüncü kişilerin ürettiği sunucu içeriğini toplayıp sunucu yöneticilerine gerçek para karşılığında satan ya da lisanslayan bir site veya pazar yeri işletmeyi yasaklı ticari kullanım biçimleri arasında sayıyor. Satın aldığınız kaynaklarda da bir sınır var: You lack the required entitlement hatası alıyorsanız Cfx sunucuyu yeniden başlatmanızı ve sunucu anahtarınızın doğru olduğundan emin olmanızı söylüyor; kaynağı başka bir hesapla aldıysanız Portal üzerinden aktarabiliyorsunuz.

Sunucu sahibi olarak sorumluluklarınız

Aynı sözleşme, sunucu işletenlere somut yükümlülükler getiriyor. Özel bir sunucuyla ilgili tüm web siteleri, ürün listeleri, mağazalar ve kullanıcıya görünen diğer bilgiler sunucuyu işleten kişi ya da kurumu açık ve göze çarpar biçimde belirtmeli, geçerli bir e-posta iletişim adresi vermeli ve şu ifadeye büyük ölçüde benzeyen bir sorumluluk reddi içermeli: “[SUNUCU ADI] ROCKSTAR GAMES TARAFINDAN ONAYLANMAMIŞ, DESTEKLENMEMİŞ VEYA TAVSİYE EDİLMEMİŞTİR.”

Ticari tarafta yasaklı sayılan başlıklar arasında gerçek para çıkışı sağlayan mekanikler ve her türlü gerçek parayla kumar, loot box ile gacha benzeri şansa dayalı mekanikler, oyun içi sanal paranın gerçek para karşılığında satılması ve kripto varlıkların tanıtımı var. Listenin tamamını ve yaptırımları ban türleri ve itiraz rehberimizde ele aldık.

Artifact güncellemesi: üç aylık sessiz kural

Sunucu kurulumunun en çok ihmal edilen bakım işi artifact güncellemesi. Cfx’in resmî belgesi bunun için yazılı bir takvim veriyor ve son maddesi doğrudan sunucunuzun görünürlüğünü etkiliyor:

Belgedeki örnek kuralı somutlaştırıyor: 5001 numaralı artifact 1 Ocak’ta, 5002 ise 6 Ocak’ta çıkarsa 5001 için destek 20 Ocak’a kadar sürüyor (6 Ocak + 14 gün).

Sunucu yavaş açılıyorsa: Defender istisnası

Resmî belgede sık sorulan bir başlık daha var: yavaş sunucu başlangıcı. Belirtilen sebep Windows sunucularında Microsoft Defender Antivirus’ün FXServer dosyalarını taraması. Resmî çözüm adım adım veriliyor:

1. Başlat’a tıklayın ya da Windows tuşuna basın.
2. Arama çubuğuna PowerShell yazın.
3. Sonuçlarda Windows PowerShell’e sağ tıklayın.
4. Yönetici olarak çalıştır deyin; Kullanıcı Hesabı Denetimi sorarsa Evet’i seçin.
5. Şu komutu çalıştırın (yolu kendi kurulumunuzla değiştirin):
   Add-MpPreference -ExclusionPath 'C:\FXServer\'

Belge bir uyarı da ekliyor: sunucuya kaynak ekledikçe başlangıç süresi uzuyor. Olağandışı uzun süreler yaşıyorsanız sunucu konsolunda hata ve uyarı mesajlarına bakmak gerekiyor.

48 slot sınırını aşmak

Yukarıda OneSync’in 48 slota kadar ücretsiz olduğunu anlattık. Resmî belge sınırı aşmanın adımlarını da veriyor: 48’den fazla slot Element Club Argentum aboneliği ya da üstünü gerektiriyor. Ardından en son artifact kullanılıyor, sv_maxclients abonelik kademesine göre 48’in üstüne ayarlanıyor ve sunucu yeniden başlatılıyor.

Sık Sorulan Sorular

FiveM sunucusu kurmak için ne gerekiyor?

Cfx’in belgesine göre önce Cfx Portal üzerinden ücretsiz bir lisans anahtarı kaydetmeniz gerekiyor. Ardından Server Download sayfasından önerilen yapıyı indirip çıkarıyor ve FXServer.exe dosyasını çalıştırıyorsunuz; gerisi txAdmin arayüzünden ilerliyor.

txAdmin’de hangi şablonu seçmeliyim?

Cfx başlangıç için Popular Recipes bölümündeki CFX Default FiveM şablonunu öneriyor. Belgedeki uyarı şu: başka şablonlar da bulunabiliyor ancak bazıları veritabanı sunucusu gerektiriyor.

Kaç slotluk sunucu açabilirim?

sv_maxClients 1 ile 2048 arasında bir değer alıyor. Belgedeki kural: 32’den başlayan değerler onesync’in on ya da legacy olmasını, 64 üzerindeki değerler ise onesync’in mutlaka on olmasını gerektiriyor. OneSync belgesine göre OneSync 48 slota kadar ücretsiz.

onesync legacy modunu kullanmalı mıyım?

Cfx önermiyor. Belgedeki tanıma göre legacy, tüm oyuncuların her istemcide var olmasını bekleyen betikler için bir uyumluluk modu ve performans sorunları ile grafik hataları sebebiyle tavsiye edilmiyor.

Sunucum listede görünmüyor, ne yapmalıyım?

Cfx bunu genelde hatalı port yönlendirme ya da güvenlik duvarı yapılandırmasına bağlıyor. Sırasıyla F8 konsolundan connect IP:Port ile doğrudan bağlantıyı test edin, server.cfg içindeki #sv_master1 satırının başındaki diyez işaretini kontrol edin, tarayıcıdan http://ip:port/info.json adresinin yanıt verdiğini doğrulayın ve sets sv_projectName ile sets sv_projectDesc değişkenlerinin tanımlı olduğundan emin olun.

Sunucunun listede görünmesi ne kadar sürer?

Cfx’in Server Issues sayfasına göre başka bir sinyal gönderilmediyse sunucunun listede görünmesi başlatmadan sonra 8 dakikaya kadar sürebiliyor.

Oyun yapısını nasıl seçerim?

server.cfg içinde sv_enforceGameBuild değişkeniyle. Belgeye göre bu yalnızca başlangıçta ayarlanabiliyor ve çalışma sırasında değiştirilemiyor. Örnek kullanımlar: sv_enforceGameBuild 3889, sv_enforceGameBuild mp2026_01 ya da DLC’siz temel oyun için sv_enforceGameBuild 1.

ESX ve QBCore resmî altyapılar mı?

Hayır. İkisi de topluluk tarafından geliştirilen altyapılar ve Cfx’in resmî belgelerinde kurulum tarifleri bulunmuyor. Bu tür şablonlar genelde bir veritabanı sunucusu gerektiriyor; Cfx başlangıç için CFX Default FiveM şablonunu öneriyor.

Artifact’lerimi ne sıklıkla güncellemeliyim?

Resmî takvime göre Recommended artifact’ler sıradaki sürümün çıkışından altı hafta sonrasına, Latest artifact’ler ise iki hafta sonrasına kadar destekleniyor. En kritik madde şu: üç aydan eski ve desteklenmeyen artifact’ler sunucu tarayıcısından katılınabilir olmaktan çıkıyor.

Oyuncular “listede var ama giremiyorum” diyor, ne yapmalıyım?

Artifact sürümünüze bakın. Oyuncu tarafında gri EOS uyarısı sunucunun hâlâ girilebilir olduğunu, kırmızı EOL uyarısı ise bağlantının başarısız olacağını ve artifact güncellemesinin şart olduğunu gösteriyor. Üç ayı geçen bir artifact ile sunucu çalışmaya devam etse de tarayıcıdan girilemiyor.

Sunucu çok yavaş açılıyor, sebebi ne olabilir?

Resmî belgedeki ilk sebep Microsoft Defender Antivirus’ün FXServer dosyalarını taraması. Çözüm olarak PowerShell’i yönetici olarak açıp şu komutu çalıştırmak öneriliyor: Add-MpPreference -ExclusionPath ardından kendi FXServer yolunuz. Belge ayrıca sunucuya kaynak ekledikçe başlangıç süresinin uzadığını, olağandışı sürelerde konsoldaki hata ve uyarı mesajlarına bakmak gerektiğini belirtiyor.

48’den fazla slot için ne gerekiyor?

Resmî belgeye göre Element Club Argentum aboneliği ya da üstü. Ardından en son artifact kullanılıyor, sv_maxclients abonelik kademesine göre 48’in üstüne ayarlanıyor ve sunucu yeniden başlatılıyor. Belge kademelerin hangi slot sayısına denk geldiğini tek tek yazmıyor.

Bilgileri nasıl topladık? Ücretsiz lisans anahtarı şartı ve dört kurulum yolu docs.fivem.net’teki Setting Up a Server sayfasından, 14 adımlık txAdmin kurulum sırası, C:\FXServer\server örnek konumu, CFX Default FiveM şablonu ile veritabanı uyarısı ve Enhanced sunucusundaki cfx-server_win_x64, cfx-server.exe ile Microsoft Visual C++ 2017 Redistributable şartı Setting up a server using txAdmin sayfasından alındı. sv_maxClients aralığı ve onesync kuralları, onesync modlarının tanımları, onesync_enableInfinity, onesync_population, onesync_forceMigration, onesync_distanceCulling, onesync_distanceCullVehicles, onesync_radiusFrequency ve sv_useAccurateSends varsayılanları, sv_entityLockdown modları, sv_scriptHookAllowed, sv_endpointPrivacy, sv_licenseKey, sv_lan değişkenleri, sv_enforceGameBuild ile oyun yapısı tablosu ve start, stop, ensure, restart, refresh, exec, status, clientkick, say, quit komutları Server Commands sayfasından geldi. Doğrudan bağlantı testi, sv_master1 satırı, info.json kontrolü, sets sv_projectName ile sets sv_projectDesc şartı, 8 dakikalık listelenme süresi ve NAT uyarısı Server Issues sayfasından, OneSync’in 48 slota kadar ücretsiz olması, 424 birimlik odak bölgesi ve nesne kimliğinin 65535’e çıkarılması OneSync sayfasından aktarıldı. You lack the required entitlement çözümü Cfx’in support.cfx.re adresindeki makaleden, sunucu sitelerinde zorunlu tutulan işletmeci bilgisi, sorumluluk reddi ibaresi ve yasaklı ticari kullanım başlıkları Rockstar’ın 10 Eylül 2026 tarihli Creator Platform License Agreement metninden alındı. ESX ve QBCore resmî belgelerde geçmediği için topluluk altyapısı olarak belirtildi. 2 Kasım 2026 eki: Cfx’in resmî belgeleri (docs.fivem.net) okundu. Artifact destek takvimi, üç aylık tarayıcı sınırı, Defender istisnası komutu ve 48 üstü slot için gereken abonelik kademesi buradan alındı. Son güncelleme: 2 Kasım 2026.

İlgili İçerikler

• FiveM Araç İşlemleri
• FiveM Ban Türleri ve İtiraz
• FiveM Sistem Gereksinimleri
• FiveM Hata Kodları ve Çözümleri