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

Cfx.re lisans anahtarı alma

Her FiveM sunucusu bir lisans anahtarı ile çalışır. Anahtar ücretsizdir ve Cfx.re hesabınıza bağlıdır.

1. Cfx.re hesabınızla Cfx.re'nin lisans anahtarı yönetim sayfasına (Keymaster) giriş yapın.
2. Yeni bir sunucu anahtarı oluşturun; sunucu adını ve sunucunun çalışacağı makinenin IP adresini girin.
3. Oluşan anahtarı bir yere kaydedin. Kurulum sihirbazı bu anahtarı isteyecek.

Anahtarı başkalarıyla paylaşmayın. Anahtar hesabınıza bağlı olduğu için, kötüye kullanımında sorumluluk sizde kalır.

Sunucu dosyalarını (artifacts) indirme

FXServer'ın derlenmiş sürümlerine "artifacts" denir ve Cfx.re'nin resmî artifacts sayfasında Windows ve Linux için ayrı ayrı yayınlanır. Listede genellikle bir önerilen (recommended) sürüm işaretlidir; yeni bir sunucu için onu seçin.

Windows'ta:

1. Örneğin C:\FXServer\server adında bir klasör oluşturun.
2. Windows artifacts sayfasından önerilen sürümün server.7z dosyasını indirin ve bu klasöre çıkarın.
3. Klasördeki FXServer.exe dosyasını çalıştırın. Bu, txAdmin'i başlatır.

Linux'ta:

1. Örneğin ~/FXServer/server adında bir klasör oluşturup içine girin.
2. Linux artifacts sayfasından önerilen sürümün fx.tar.xz dosyasını indirip çıkarın:

   tar xf fx.tar.xz
   

3. Sunucuyu başlatın:

   ./run.sh
   

Linux'ta sunucunun terminal kapandığında da çalışmaya devam etmesi için screen ya da tmux gibi bir araç kullanmanız gerekir.

txAdmin ile FiveM kurulumu ve recipe seçimi (ESX / QBCore)

txAdmin, FXServer ile birlikte gelen web tabanlı yönetim aracıdır. Sunucuyu başlatma ve durdurma, otomatik yeniden başlatma, oyuncu yönetimi ve kayıtlar tarayıcıdan yapılır.

1. FXServer'ı ilk kez başlattığınızda konsolda txAdmin'in adresi ve 4 haneli bir PIN görünür. Tarayıcıda http://localhost:40120 adresini açın (sunucu başka bir makinedeyse localhost yerine o makinenin IP adresini yazın).
2. PIN'i girin ve txAdmin'i Cfx.re hesabınıza bağlayın. Ardından txAdmin için bir yönetici şifresi belirleyin.
3. Kurulum sihirbazında sunucunuza bir ad verin ve kurulum türü olarak Popular Recipes seçeneğini işaretleyin.
4. Bir şablon (recipe) seçin:
   • CFX Default: Boş, temel bir sunucu.
   • ESX Legacy: Meslek, envanter ve ekonomi sistemleri hazır gelen yaygın RP framework'ü.
   • QBCore Framework: Modern yapısı ve hazır scriptleriyle öne çıkan RP framework'ü.
   • QBox: QBCore uyumluluğunu koruyan, performans odaklı devamı.
5. Sunucu dosyalarının kurulacağı klasörü onaylayın.
6. Sihirbaz lisans anahtarınızı ve veritabanı bilgilerinizi ister. Bunları girdiğinizde şablon; framework'ü, veritabanı tablolarını ve temel scriptleri otomatik kurar.
7. Kurulum bitince txAdmin üzerinden sunucuyu başlatın ve konsolda hata olup olmadığını kontrol edin.

server.cfg'de bilinmesi gereken satırlar

txAdmin kurulumu bir server.cfg dosyası oluşturur. Sunucunun temel ayarları bu dosyadadır ve en sık düzenlenen satırlar şunlardır:

sv_hostname "Sunucunuzun adı"
sets sv_projectName "Proje adı"
sets sv_projectDesc "Kısa açıklama"
sets tags "roleplay, turkce"
sets locale "tr-TR"
sv_maxclients 48
sv_licenseKey "lisans-anahtariniz"
set onesync on
ensure oxmysql

• sv_hostname, sv_projectName ve sv_projectDesc, sunucu listesinde görünen ad ve açıklamadır.
• sets tags ve sets locale, oyuncuların sunucunuzu listede filtreleyerek bulmasına yardım eder.
• sv_maxclients en fazla oyuncu sayısıdır. Ücretsiz lisansla 48'in üzerine çıkılamaz.
• set onesync on, sunucu tarafı senkronizasyonu açar; 32 oyuncunun üzerindeki sunucular için gereklidir.
• ensure satırları hangi scriptlerin hangi sırayla başlatılacağını belirler.

server.cfg dosyasındaki değişiklikler sunucu yeniden başlatıldığında geçerli olur.

Otomatik yeniden başlatma ve yedekleme

Uzun süre açık kalan bir FiveM sunucusunda bazı scriptler zamanla bellek biriktirebilir. txAdmin'in Restart Schedule ayarıyla sunucuyu her gün oyuncuların en az olduğu saatte otomatik yeniden başlatabilirsiniz; txAdmin oyuncuları önceden uyarır. Aynı şekilde veritabanınızın düzenli bir yedeğini almak, hatalı bir script güncellemesinden sonra karakterleri ve envanterleri geri yükleyebilmenizi sağlar.

Veritabanı (MariaDB)

ESX ve QBCore şablonları bir MySQL veritabanına ihtiyaç duyar. Bunun için MySQL ile uyumlu, açık kaynak MariaDB'yi öneririz.

1. MariaDB'yi kurun. Windows'ta resmî kurulum dosyasını kullanabilir, Linux'ta dağıtımınızın paket yöneticisiyle kurabilirsiniz.
2. Kurulumda root kullanıcısı için güçlü bir şifre belirleyin.
3. txAdmin sihirbazı veritabanı bilgilerini sorduğunda sunucu adresi olarak localhost, kullanıcı adı ve şifre olarak az önce belirlediğiniz bilgileri girin. Şablon veritabanını kendisi oluşturur.

Kurulum tamamlandığında scriptler veritabanına oxmysql üzerinden bağlanır. Bağlantı bilgisi server.cfg içinde şu satırda durur:

set mysql_connection_string "mysql://kullanici:sifre@localhost/veritabani?charset=utf8mb4"

Veritabanını oyun sunucusuyla aynı makinede çalıştırmak, sorguların ağ gecikmesi olmadan cevaplanmasını sağlar. Veritabanınızı düzenli olarak yedekleyin; karakterler, araçlar ve envanterler burada tutulur.

Port 30120 ve güvenlik duvarı

FiveM sunucusu varsayılan olarak 30120 portunu hem TCP hem UDP için kullanır. txAdmin ise 40120 TCP portunda çalışır.

• Windows: Windows Defender Güvenlik Duvarı'nda 30120 TCP ve 30120 UDP için gelen bağlantı kuralı oluşturun.
• Linux (ufw):

  sudo ufw allow 30120/tcp
  sudo ufw allow 30120/udp
  

• Ev bağlantısında: Modeminizde 30120 TCP ve UDP portlarını sunucunun yerel IP adresine yönlendirmeniz gerekir.

40120 portunu herkese açmak yerine yalnızca kendi IP adresinize izin vermeniz daha güvenlidir. Oyun sunucuları sık saldırı hedefi olduğu için sunucunuzun önünde bir DDoS koruması olması da önemlidir; nedenini DDoS nedir? yazımızda anlattık.

Sunucuya bağlanma

1. FiveM istemcisini açın ve F8 tuşuyla konsolu açın.
2. connect sunucu-ip:30120 yazıp Enter'a basın. Sunucu aynı bilgisayardaysa connect localhost yeterlidir.
3. Sunucunuz listeye kaydolduktan sonra oyuncular sunucuyu FiveM'in sunucu listesinde adıyla aratarak da bulabilir.

Kendinizi oyunda yönetici yapmak için txAdmin'in yönetici panelini (oyunda /tx komutu) kullanabilir ya da framework'ünüzün yetki komutlarından yararlanabilirsiniz.

Sık karşılaşılan hatalar

• Lisans anahtarı doğrulanamadı: Anahtar hatalı kopyalanmış ya da başka bir IP adresi için oluşturulmuş olabilir. Keymaster'da anahtarın IP adresini kontrol edin.
• Veritabanına bağlanılamıyor: oxmysql konsolda bağlantı hatası veriyorsa MariaDB'nin çalıştığından ve mysql_connection_string satırındaki kullanıcı adı, şifre ve veritabanı adının doğru olduğundan emin olun.
• Script yüklenmiyor: server.cfg içinde bir scriptin, bağımlı olduğu başka bir scriptten önce ensure edilmesi bu hataya yol açar. Bağımlılıkları önce başlatın.
• Port kullanımda: Aynı makinede başka bir FXServer ya da program 30120 portunu kullanıyorsa sunucu açılmaz. Eski süreci kapatın ya da portu değiştirin.
• Oyuncular bağlanamıyor: Güvenlik duvarında 30120 portunun hem TCP hem UDP olarak açık olduğunu ve ev bağlantısında port yönlendirmenin yapıldığını kontrol edin.
• Sunucu takılıyor: Oyunda F8 konsolunda resmon 1 yazarak hangi scriptin ne kadar kaynak harcadığını görebilirsiniz. Boştayken yüksek süre harcayan scriptler genellikle optimize edilmesi gereken scriptlerdir.
• Sunucu listede eski adla görünüyor: Liste bilgileri belirli aralıklarla güncellenir. server.cfg'de adı değiştirdikten sonra sunucuyu yeniden başlatın ve birkaç dakika bekleyin.
• Oyuncular "Couldn't load resource" uyarısı alıyor: Genellikle bir scriptin dosyası eksik ya da bozuktur. Scripti yeniden indirip yükleyin ve fxmanifest.lua dosyasının mevcut olduğundan emin olun.

Tek başına kurulum yapmak öğreticidir. Ama sunucunuz büyüdükçe 7/24 açık, yüksek saat hızlı ve DDoS korumalı bir makine ihtiyacı belirginleşir. Nodesty'nin FiveM sunucu kiralama paketleri txAdmin, OneSync, ESX ve QBCore için Ryzen 9 9950X işlemci ve DDoS korumasıyla geliyor. Bir Minecraft sunucusu da açmak isterseniz Minecraft sunucu nasıl kurulur? rehberimiz adım adım yol gösterir.