FiveM Sunucu Nasıl Kurulur? txAdmin ile Adım Adım Rehber

FiveM sunucusu kurmak için neye ihtiyacın var?

FiveM sunucusu kurmak için bir Cfx.re hesabı, bu hesaba bağlı ücretsiz bir lisans anahtarı, FXServer adlı sunucu yazılımı ve 7/24 açık kalabilen bir makine yeterli. FXServer, Cfx.re'nin GTA V için geliştirdiği çok oyunculu platformun sunucu tarafıdır ve Windows ile Linux için ayrı paketler halinde yayımlanır. Oyuncuların kendi bilgisayarlarında ise yasal bir GTA V kopyası ve FiveM istemcisi bulunmalıdır. Roleplay framework'ü kuracaksan listeye MySQL uyumlu bir veritabanı, pratikte MariaDB, eklenir.

Donanım tarafında en belirleyici etken işlemcinin tek çekirdek performansıdır. Scriptlerin çalıştığı ana sunucu iş parçacığı (svMain) tek çekirdekte döner; yavaşlayan her script bütün oyuncuları aynı anda etkiler. RAM ihtiyacı kaynak ve oyuncu sayısıyla birlikte artar. Disk tarafında NVMe fark yaratır: araç, harita ve kıyafet paketleri büyüdükçe sunucu klasörü onlarca gigabayta çıkabilir ve bu dosyaların oyunculara hızlı aktarılması gerekir.

• Cfx.re hesabı ve Cfx.re Portal'dan oluşturulmuş lisans anahtarı
• FXServer sunucu dosyalarının önerilen (recommended) sürümü
• Açık portlar: oyun için 30120 TCP ve UDP, txAdmin paneli için 40120 TCP
• Framework kuracaksan MariaDB ve oxmysql kaynağı
• Dosya yüklemek için SFTP veya panel dosya yöneticisi

Cfx.re lisans anahtarı nasıl alınır?

Lisans anahtarını Cfx.re Portal üzerinden ücretsiz alırsın: Cfx.re hesabınla giriş yapar, sunucu kayıt anahtarları (server registration keys) bölümünden yeni bir anahtar oluşturursun. Anahtar olmadan FXServer oyuncu kabul etmez. Oluşturduğun anahtar server.cfg içindeki sv_licenseKey satırına yazılır; txAdmin kullanıyorsan kurulum sihirbazı anahtarı senden ister ve dosyaya kendisi ekler.

Anahtarı gizli tut; ekran görüntülerinde, Discord'da veya herkese açık GitHub depolarında paylaşma. Ele geçirildiğini düşünüyorsan Portal'dan silip yenisini oluştur. Ücretli, escrow korumalı script satın alacaksan önemli bir ayrıntı var: bu kaynaklar yalnızca lisans anahtarını oluşturan Cfx.re hesabına tanımlıysa çalışır. Yani sunucu anahtarı ile satın alımlar aynı hesapta olmalı; ekip arkadaşının hesabına tanımlanmış bir script senin anahtarınla çalışan sunucuda açılmaz.

txAdmin ile kurulum nasıl ilerler?

txAdmin, FXServer ile birlikte gelen web tabanlı yönetim panelidir ve ayrıca kurulmaz. FXServer'ı +exec server.cfg parametresi vermeden başlattığında txAdmin devreye girer; konsolda panel adresi ve tek kullanımlık bir PIN görünür. Tarayıcıdan sunucu IP'sinin 40120 portuna gidip PIN'i girer, Cfx.re hesabını bağlar ve panel için bir yönetici şifresi belirlersin. Windows'ta başlatılan dosya FXServer.exe, Linux'ta run.sh betiğidir.

Ardından sihirbaz sunucu adını ve kurulum tipini sorar. Popular Recipes seçeneği hazır şablonları listeler; framework'süz FiveM Basic Server, ESX Legacy, QBCore ve Qbox bunların başında gelir. Recipe seçtikten sonra sunucu verilerinin kurulacağı klasörü, lisans anahtarını ve şablon veritabanı kullanıyorsa MariaDB bağlantı bilgilerini girersin. Recipe Deployer gerekli kaynakları indirir, veritabanını hazırlar ve server.cfg dosyasını oluşturur; son ekranda dosyayı gözden geçirip sunucuyu başlatırsın.

Kurulumdan sonra txAdmin'in asıl değeri günlük yönetimde ortaya çıkar: canlı konsol, oyuncu listesi, ban, uyarı ve whitelist yönetimi, kaynakları yeniden başlatma, duyurulu zamanlanmış yeniden başlatmalar ve oyun içi admin menüsü tek panelde toplanır. Yönetilen bir oyun sunucusunda kurulum ve başlatma komutları genellikle sağlayıcının panelinden yürütülür. txAdmin'i ve veritabanını tamamen kendin yönetmek istiyorsan root erişimli bir VDS daha esnek bir zemin sunar.

server.cfg dosyasında hangi ayarlar olmalı?

server.cfg, FXServer'ın açılışta satır satır okuduğu yapılandırma dosyasıdır; sunucunun kimliğini, ağ ayarlarını ve başlatılacak kaynakları belirler. Aşağıdaki tablo, sağlıklı bir sunucuda neredeyse her zaman bulunan satırları özetler. Bir ayrıntıya dikkat et: sets ile tanımlanan değişkenler sunucu listesinde herkese görünür, set ile tanımlananlar ise yalnızca sunucu ve scriptler tarafından okunur. Şifre ve API anahtarlarını bu yüzden asla sets ile yazma.

Kaynakların sırası önemlidir. ensure satırları yukarıdan aşağıya çalıştığı için önce oxmysql ve ox_lib gibi bağımlılıklar, sonra framework çekirdeği, en son da meslekler, araçlar ve haritalar gelmelidir. Dosya büyüdükçe bölmek iyi bir alışkanlıktır; exec komutuyla permissions.cfg veya resources.cfg gibi ayrı dosyaları ana server.cfg içinden çağırabilirsin. sv_master1 değişkenini boş bir değerle tanımlarsan sunucu özel (private) olarak işaretlenir ve artık sunucu listesi üzerinden katılınamaz.

OneSync nedir, açman gerekir mi?

OneSync, Cfx.re'nin sunucu taraflı durum senkronizasyonu sistemidir ve bugün kurulan hemen her sunucuda açık olmalıdır. OneSync kapalıyken sunucu en fazla 32 slotla sınırlı kalır. Açıldığında slot sayısı yükselir ve araç, NPC ve obje gibi varlıkların durumu sunucu tarafında tutulur; bu da hem hile önleme hem de script geliştirme için daha sağlam bir temel demektir.

OneSync 48 slota kadar ücretsizdir; daha yüksek bir sv_maxclients değeri için Cfx.re Portal üzerinden Element Club Argentum veya üstü bir abonelik gerekir. Teknik üst sınır 2048 oyuncudur. Açmak için server.cfg'ye set onesync on satırını eklemen yeterli. OneSync'te oyuncular yalnızca yakınlarındaki varlıkları görür; bu culling yüzünden uzaktaki bir oyuncuya istemci tarafında erişmeye çalışan eski scriptler bozulabilir. Güncel ESX Legacy, QBCore ve Qbox kaynakları OneSync'e göre yazıldığı için genellikle sorun çıkarmaz.

ESX, QBCore ve Qbox arasındaki fark nedir?

Framework, roleplay sunucusunun iskeletidir: karakterler, meslekler, envanter, para ve araç sahipliği gibi temel sistemleri sağlar ve üzerine kuracağın her script onun API'sine göre yazılır. Üç büyük seçeneğin üçü de ücretsiz, açık kaynaklı ve txAdmin recipe'siyle kurulabiliyor. Doğru seçim, kullanmak istediğin scriptlerin hangi framework'ü desteklediğine bağlıdır; framework'ler arasında script taşımak çoğu zaman uyarlama gerektirir.

Kısa bir yol haritası: hazır script arşivinin genişliği önceliğinse ESX Legacy veya QBCore; daha modern bir kod tabanı ve ox kaynaklarıyla sıkı entegrasyon istiyorsan Qbox mantıklı. Hangisini seçersen seç, tek sunucuda iki framework'ü birlikte çalıştırma ve satın alacağın her scriptin hangi framework'ü desteklediğini açıklamasından kontrol et. Kurulumdan sonra framework değiştirmek veritabanını da taşımayı gerektirir.

Veritabanı: MariaDB ve oxmysql nasıl bağlanır?

Framework'ler oyuncu, envanter, araç ve banka verilerini MySQL uyumlu bir veritabanında tutar; FiveM tarafında bu bağlantıyı oxmysql kaynağı kurar. oxmysql dokümantasyonu uyumluluk ve performans için MariaDB'yi açıkça öneriyor, XAMPP gibi geliştirme paketlerini ise canlı sunucu için uygun görmüyor. Qbox en az MariaDB 10.9 istediği için güncel bir LTS sürümü kurmak üç framework için de en güvenli yol.

Bağlantı, server.cfg'deki mysql_connection_string değişkeniyle kurulur ve iki biçimi vardır: kullanıcı, şifre, sunucu, port ve veritabanı adını içeren, mysql:// ile başlayan URI biçimi ya da user, password, host, port ve database alanlarının noktalı virgülle ayrıldığı biçim. Noktalı virgül, virgül, eğik çizgi, soru işareti, iki nokta, @, &, = ve + gibi karakterler biçimlerden birinde ayrılmış karakter sayıldığı için sorun çıkarır; şifreyi harf ve rakamlardan oluşturmak en güvenli seçenektir. Bağlantı kurulamazsa diğer biçimi denemek de işe yarayabilir.

Veritabanı yedeği dosya yedeğinden ayrı düşünülmelidir: sunucu klasörünü kopyalamak karakterleri ve envanterleri korumaz. Düzenli olarak mysqldump ile dışa aktarım al ve yedekleri sunucunun dışında sakla. Veritabanını oyun sunucusuyla aynı makinede çalıştırmak gecikmeyi en aza indirir. Büyük sunucularda yavaş sorguları indekslerle hızlandırmak, sunucu tarafındaki takılmaların sık görülen çözümüdür.

Kaynaklar ve streaming dosyaları nasıl eklenir?

FiveM'de her script, harita veya araç paketi bir kaynaktır (resource): resources klasörü altında kendi klasörü ve içinde fxmanifest.lua adlı bir manifest bulunur. Manifest, fx_version 'cerulean' ve game 'gta5' satırlarıyla başlar, ardından kaynağın hangi istemci ve sunucu scriptlerini çalıştıracağını tanımlar. Köşeli parantezli klasörler, örneğin [qb] veya [standalone], kategori görevi görür; ensure [qb] yazarak içindeki tüm kaynakları tek satırla başlatabilirsin.

Araç, kıyafet, MLO ve harita gibi özel içerikler streaming ile gelir: kaynağın içindeki stream klasörüne konan .ytd, .ydr, .yft, .ymap ve .ytyp dosyaları otomatik olarak oyunculara gönderilir. Eklenti araçlar ayrıca vehicles.meta, carvariations.meta ve handling.meta gibi dosyaların manifestte data_file satırlarıyla tanıtılmasını gerektirir. Konsolda oversized asset uyarısı görürsen o dosyanın dokularını küçült; aşırı büyük dosyalar oyuncularda doku kaybına ve modellerin hiç yüklenmemesine yol açabilir.

Yeni kaynağı dosya yöneticisi veya SFTP ile yükledikten sonra sunucuyu kapatman gerekmez: konsolda refresh komutu kaynak listesini yeniden tarar, ensure kaynak_adı da onu başlatır ya da yeniden başlatır. Büyük streaming paketleri oyuncuların ilk giriş süresini uzatır, bu yüzden her yeni aracı ve haritayı gerçekten gerekip gerekmediğini düşünerek ekle. Sızdırılmış (leak) scriptlerden uzak dur: kötü amaçlı kod barındırabilirler ve Cfx.re kurallarını ihlal ederler.

ACE yetkileriyle admin nasıl tanımlanır?

FiveM'in yerleşik yetki sistemi ACE (Access Control Entry) listesidir ve iki komutla çalışır: add_ace bir gruba veya kişiye izin verir, add_principal ise bir kişiyi bir gruba bağlar. Klasik örnekte add_ace group.admin command allow satırı admin grubuna tüm komutları açar; add_principal identifier.fivem:123456 group.admin satırı da o Cfx.re hesabını admin grubuna ekler. Tek bir komutu kısıtlamak istersen command.komut_adı nesnesini deny ile tanımlarsın.

Kimlik olarak license, fivem, discord veya steam tanımlayıcılarını kullanabilirsin; steam kimliklerinin görünmesi için sunucuda steam_webApiKey ayarlı olmalıdır. Oyuncunun tanımlayıcılarını txAdmin'in oyuncu penceresinden kopyalamak en kolay yoldur. txAdmin'in admin yöneticisi ayrı çalışır; panel ve oyun içi menü yetkilerini oradan verirsin. Framework'lerin de kendi rolleri vardır: ESX kullanıcı grubunu veritabanında tutar, QBCore ve Qbox ACE tabanlı gruplar kullanır. Bu yüzden bir yöneticiyi hem framework'te hem txAdmin'de tanımlaman gerekebilir.

Performans nasıl ölçülür, sunucu nasıl güncel ve kurallara uygun tutulur?

Performans sorunlarının çoğu donanımdan değil scriptlerden gelir ve ilk teşhis aracı resmon'dur. Oyun içinde F8 konsoluna resmon 1 yazdığında her kaynağın istemci tarafında harcadığı süreyi ve belleği görürsün; boşta dururken sürekli yüksek değer gösteren bir kaynak genellikle Wait(0) ile dönen gereksiz döngüler içerir. Sunucu tarafında profiler record komutuyla birkaç yüz karelik kayıt alıp profiler view ile inceleyebilir, txAdmin'in performans grafiğinde svMain, svNetwork ve svSync iş parçacıklarını oyuncu sayısıyla birlikte izleyebilirsin. Konsolda sık görülen server thread hitch uyarıları, ana döngüyü tıkayan bir script veya yavaş bir sorgu olduğuna işaret eder.

Cfx.re sunucu dosyalarını sık yayımlar; canlı sunucuda en yeni deneme sürümü yerine önerilen (recommended) sürümü kullan. txAdmin sunucu dosyalarıyla birlikte güncellenir. Framework ve scriptleri GitHub sürümlerinden takip et, her güncellemeden önce dosya ve veritabanı yedeği al, değişiklikleri mümkünse önce bir test sunucusunda dene. txAdmin'in zamanlanmış yeniden başlatmaları bellek sızdıran kaynakların etkisini de sınırlar. TheCrewHost'un Ryzen 9 9950X tabanlı FiveM sunucuları yüksek tek çekirdek performansı sunar, ama optimize edilmemiş bir scripti hiçbir donanım tek başına kurtaramaz.

FiveM kuralları olan bir platformdur: sunucunu Cfx.re'nin platform lisans sözleşmesine ve hizmet şartlarına uygun işletmekle yükümlüsün. Bağış, VIP veya oyun içi satış gibi para kazanma yöntemleri yalnızca Cfx.re'nin izin verdiği yollar ve sınırlar içinde mümkündür; izinsiz telifli içerik ve sızdırılmış kaynak kullanmak sunucunun yaptırımla karşılaşmasına yol açabilir. Kuralların güncel metnini Cfx.re'nin resmî sitesinden okumak, uzun ömürlü bir topluluğun ön koşuludur.

txAdmin ile FiveM sunucusu kurulumu: 8 adım

1. 1

   Lisans anahtarını oluştur

   Cfx.re hesabınla Cfx.re Portal'a giriş yap, sunucu kayıt anahtarları bölümünden yeni bir anahtar oluştur ve anahtarı güvenli bir yere kaydet.

2. 2

   Sunucu ortamını hazırla

   Yönetilen bir oyun sunucusu veya root erişimli bir VDS seç; oyun için 30120 TCP ve UDP, txAdmin için 40120 TCP portlarının açık olduğundan emin ol.

3. 3

   FXServer'ı indir

   Windows veya Linux için FXServer'ın önerilen (recommended) sürümünü indirip boş bir klasöre çıkar. Framework kuracaksan MariaDB'yi de bu aşamada kur ve bir veritabanı kullanıcısı oluştur.

4. 4

   txAdmin'i başlat

   FXServer.exe'yi ya da Linux'ta run.sh'yi +exec parametresi olmadan çalıştır, konsoldaki PIN ile 40120 portundaki panele gir ve Cfx.re hesabını bağla.

5. 5

   Recipe seç ve dağıt

   Popular Recipes altından FiveM Basic Server, ESX Legacy, QBCore veya Qbox'ı seç; lisans anahtarını ve veritabanı bilgilerini gir, Recipe Deployer'ın kurulumu bitirmesini bekle.

6. 6

   server.cfg'yi düzenle

   Sunucu adını, açıklamayı, etiketleri, sets locale değerini, sv_maxclients ve set onesync on satırlarını kontrol et; sunucu simgesi olarak 96x96 bir PNG ekle.

7. 7

   Yetkileri ayarla

   txAdmin'in admin yöneticisinden panel yetkilerini ver, add_principal satırıyla kendini ACE admin grubuna ekle ve framework'ün kendi admin rolünü tanımla.

8. 8

   Test et ve yedekle

   F8 konsolunda connect komutuyla IP ve 30120 portuna bağlan, resmon ile kaynakları kontrol et, ilk dosya ve veritabanı yedeğini al; yeni kaynakları sonra tek tek ekle.

Sık Sorulan Sorular