FiveM Sunucu Kurma: txAdmin ile Adım Adım Kurulum

Kendi Grand Theft Auto V rol yapma ya da serbest dolaşma topluluğunuzu yönetmek istiyorsanız, fivem sunucu kurma süreci modern araçlarla pratik bir yapıya kavuşmuştur. txAdmin yönetim paneli sayesinde sunucu çekirdeğini, kaynak dosyalarını ve konfigürasyonları dakikalar içinde hazır hale getirebilirsiniz. Kararlı bir sunucu altyapısı için oyun sunucusu için VDS tercih etmek, oyuncuların düşük gecikmeyle dünyaya erişmesini sağlar.

Kısa cevap:

• İhtiyacınıza uygun işlemci ve belleğe sahip bir sanal sunucu hazırlayın.
• Windows veya Linux işletim sistemine güncel FXServer ve txAdmin ikili dosyalarını yükleyin.
• Veritabanı servisini kurup txAdmin paneli üzerinden lisans anahtarınızı ve paket ayarlarınızı girin.
• Güvenlik duvarı kurallarını ve port yönlendirmelerini tamamlayarak sunucuyu yayına alın.

FiveM sunucusu için sistem gereksinimleri

FiveM sunucusunun donanım ihtiyacı; eşzamanlı oyuncu sayısına, harita modifikasyonlarına, özel araç paketlerine ve kullanılan komut dosyası (script) yoğunluğuna göre değişir. Varsayılan kaynaklarla çalışan küçük bir sunucu düşük donanımla yönetilebilirken, yüzlerce eklenti barındıran rol yapma (roleplay) platformları yüksek tek çekirdek performansına ve yüksek hızlı disklere gereksinim duyar.

Oyun sunucularında işlemcinin tek çekirdek hızı, saat frekansı ve önbellek kapasitesi genel işlem verimliliğini doğrudan belirler. FXServer çekirdeği bazı görevleri çoklu iş parçacıklarına dağıtsa da ana oyun döngüsü tek bir iş parçacığı üzerinden yürütülür. Bu nedenle çok çekirdekli ancak çekirdek başına saat frekansı düşük sistemler yerine, yüksek saat hızına sahip donanımlar tercih edilmelidir. NVMe SSD kullanımı ise sunucu açılış sürelerini kısaltır ve disk kaynaklı gecikme darboğazı yaşanan durumlarda istemcilerin varlık yükleme sürecine katkı sağlar.

Aşağıdaki tabloda başlangıç, orta ve yüksek ölçekli projeler için önerilen donanım kaynakları özetlenmiştir:

Sunucu Ölçeği	İşlemci Mimarisi	Bellek Türü	Depolama Türü
Başlangıç ve Test	Yüksek tek çekirdek frekanslı vCPU	DDR4 / DDR5 RAM	NVMe SSD
Orta Ölçekli Topluluk	Yüksek saat hızlı çoklu vCPU	DDR4 / DDR5 RAM	NVMe SSD
Geniş Çaplı Rol Yapma	Özel tahsisli yüksek frekanslı CPU	Yüksek kapasiteli ECC / Non-ECC RAM	NVMe SSD

Projenizin büyüklüğüne bağlı olarak bir VDS sanal özel sunucu yapısı başlangıç ve büyüme evresi için dengeli kaynak dağılımı sunar. Yüzlerce aktif oyuncunun bulunduğu ve özel harita paketlerinin yoğun kullanıldığı büyük topluluklarda ise kaynakların paylaşımsız olduğu adanmış sunucu çözümleri tercih edilir.

Windows VDS'te kurulum

Windows ortamında FiveM sunucusu kurmak, görsel arayüz desteği sayesinde yönetim kolaylığı sunar. İlk olarak sunucunuzda Visual C++ Redistributable paketlerinin güncel olduğundan emin olmanız gerekir. 2019 veya daha yeni sürümlerin x64 kütüphaneleri kurulu değilse sunucu çekirdeği çalışırken hata verebilir.

İlk adım olarak dosya düzenini sağlayacak bir dizin hiyerarşisi oluşturun. Ana sürücünüzde boşluk içermeyen yollar seçmek dosya okuma hatalarını önler. Örneğin C:\FXServer adında bir ana klasör açabilir, altına ikili dosyalar ve sunucu verileri için ayrı bölümler ekleyebilirsiniz.

C:\FXServer\
  ├── artifacts\
  └── server-data\

Sunucu çekirdeğini kurmak için aşağıdaki sıralı adımları uygulayın:

1. FiveM resmi yapım sayfasından (artifacts) "Latest Recommended" etiketli Windows sunucu derlemesini indirin.
2. İndirilen .7z veya .zip arşivini C:\FXServer\artifacts dizini içerisine bir arşiv yöneticisiyle açın.
3. Arşivden çıkan dosyalar arasında yer alan FXServer.exe dosyasını bulun.
4. Dosyaya çift tıklayarak ilk başlatmayı gerçekleştirin.
5. Otomatik olarak komut istemcisi açılacak ve txAdmin web panelinin yerel adresi ile dört haneli doğrulama PIN kodu görüntülenecektir.

Açılan konsol ekranında [txAdmin] Pin: XXXX formatında dört haneli bir güvenlik kodu yer alır. Bu kodu not edin ve konsolu kapatmayın. Tarayıcınız üzerinden sunucu IP adresini ve belirtilen portu kullanarak yapılandırma ekranına geçiş yapacaksınız. Sunucuyu grafik masaüstü üzerinden yönetmek için dilerseniz VNC ile uzak masaüstü bağlantısı protokollerini de kullanabilirsiniz.

Linux VDS'te kurulum

Linux dağıtımları, düşük kaynak tüketimi ve yüksek arka plan servis kararlılığı nedeniyle FiveM sunucuları için sıklıkla tercih edilir. Ubuntu 22.04 LTS veya Debian 12 sürümleri bu kurulum için uygun dağıtımlardır. Kuruluma başlamadan önce işletim sisteminin paket depolarını güncelleyin ve gerekli temel araçları sisteme dahil edin.

Uçbirim (terminal) üzerinden yetkili kullanıcıyla oturum açtıktan sonra paket listesini güncelleyip indirme ve yönetim araçlarını yükleyin:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git tar xz-utils screen

Güvenlik amacıyla sunucu dosyalarını ayrı bir kullanıcı altında çalıştırmak doğru bir yaklaşımdır. Yeni bir sistem kullanıcısı açın ve dizin sahipliğini indirme öncesinde düzenleyin:

sudo adduser --disabled-password --gecos "" fivem
sudo mkdir -p /home/fivem/server
sudo chown -R fivem:fivem /home/fivem

Kullanıcı yetkilerine geçiş yaparak FiveM artifacts deposundaki güncel önerilen derleme arşivini indirin ve açın:

sudo -iu fivem
cd /home/fivem/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/$(curl -s https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/ | grep -oE '[0-9]+-[a-f0-9]+/fx.tar.xz' | head -n 1)
tar -xvf fx.tar.xz
rm fx.tar.xz

FiveM sunucusunu ve txAdmin modülünü arka planda başlatmak için run.sh betiğini çalıştırın. Konsolun oturum kapandığında kapanmaması için screen aracını devreye alabilirsiniz:

screen -S fivem
./run.sh

Terminalde txAdmin arayüzünün erişim bağlantısı ve dört haneli tek seferlik PIN kodu görünecektir. Bu çıktıyı aldıktan sonra tarayıcınızdan yapılandırma adımına geçebilirsiniz. Arka plandaki screen oturumundan Ctrl+A ve ardından D tuşlarına basarak ayrılabilirsiniz.

txAdmin ile ilk yapılandırma

txAdmin, FXServer ile tümleşik olarak gelen web tabanlı bir yönetim panelidir. Konsol üzerinde belirtilen adrese (genellikle http://sunucu-ip-adresi:40120) tarayıcınızdan giriş yapın. Karşınıza çıkan ekranda terminalde verilen dört haneli PIN kodunu yazarak oturum açma işlemine başlayın.

İlk aşamada txAdmin sizden bir ana yönetici hesabı oluşturmanızı ve Cfx.re hesabınızla bağlantı kurmanızı ister. Bu işlem txAdmin paneli için yönetici kimlik doğrulaması sağlar; sunucu lisansı ise sv_licenseKey değişkeniyle ayrıca doğrulanır. Yönetici şifrenizi tanımladıktan sonra sunucu dağıtım sihirbazı (Deployment Wizard) başlayacaktır.

Popüler rol yapma paketleri (ESX Legacy veya QBCore) dağıtım esnasında veritabanı şemasını otomatik olarak yükler. Bu nedenle sihirbazda ilerlemeden önce MariaDB servisinin kurulu, çalışır ve yetkilendirilmiş bir kullanıcıya sahip olması gerekir.

Sihirbaz adımları şu sırayla ilerler:

1. Sunucu Adı (Server Name): Sunucunuz için kısa bir tanımlayıcı isim belirleyin. Bu isim txAdmin panelinde proje adı olarak görüntülenir.
2. Dağıtım Türü (Deployment Type): Sıfırdan bir şablon kuracaksanız "Popular Recipes" seçeneğini tıklayın. Hazır bir dosya paketiniz varsa "Local Server Data" seçeneğini kullanabilirsiniz.
3. Paket Seçimi (Recipe): İhtiyacınıza göre QBCore Framework, ESX Legacy veya temel test ortamı sunan CFX Default şablonlarından birini belirleyin.
4. Veri Yolu (Data Location): Sunucu kaynak dosyalarının (resources) ve ayar dosyalarının tutulacağı hedef dizini onaylayın.
5. Veritabanı ve Lisans Ayarları: Önceden hazırladığınız MariaDB bağlantı bilgilerini ve Cfx.re Portal üzerinden oluşturduğunuz lisans anahtarını girin.

Gerekli veritabanı ve lisans bilgileri doğrulandıktan sonra "Run Recipe" adımıyla paket kurulumunu tamamlayabilirsiniz.

Veritabanı bağlantısı ve temel kaynaklar

Gelişmiş FiveM paketleri, oyuncu envanterleri, araç sahiplikleri ve karakter verilerini saklamak için ilişkisel bir veritabanına ihtiyaç duyar. MariaDB, FiveM paketlerinde kullanılabilen bir veritabanı motorudur. Veritabanı iletişimini sağlamak için modern paketler oxmysql eklentisini kullanır.

Linux sunucuda bir önceki adımda fivem kullanıcısına geçtiyseniz, exit komutunu kullanarak sudo yetkisine sahip ana kullanıcınıza dönün. Ardından paket yöneticisiyle MariaDB kurulumunu yapın:

exit
sudo apt install -y mariadb-server
sudo mysql_secure_installation

Windows üzerinde ise resmi MariaDB MSI yükleyicisini indirerek kurulumu tamamlayabilirsiniz. Veritabanı servisini başlattıktan sonra FiveM için özel bir veritabanı ve kullanıcı hesabı açın. Buradaki örnek parolayı kendinize ait güçlü bir parolayla değiştirin:

CREATE DATABASE fivem_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem_user'@'127.0.0.1' IDENTIFIED BY 'OrnekGucluSifre.123';
GRANT ALL PRIVILEGES ON fivem_db.* TO 'fivem_user'@'127.0.0.1';
FLUSH PRIVILEGES;

Oluşturduğunuz kimlik bilgilerini sunucunuzun ana yapılandırma dosyası olan server.cfg içerisindeki bağlantı dizesine ekleyin. Bu dizede yer alan parola SQL komutunda tanımlanan parolayla eşleşmeli, parolada URI özel karakterleri yer alıyorsa yüzde kodlaması uygulanmalı ve üretim ortamında her iki alandaki parola birlikte güncellenmelidir:

set mysql_connection_string "mysql://fivem_user:OrnekGucluSifre.123@localhost/fivem_db?charset=utf8mb4"

Ardından temel kaynakların başlatma sırasını kontrol edin. oxmysql kaynağının veritabanı ihtiyacı olan diğer eklentilerden önce başlatılması zorunludur:

ensure oxmysql
ensure es_extended # ESX kullanılıyorsa
# veya
ensure qb-core # QBCore kullanılıyorsa

Yanlış sıralama kaynakların veritabanına erişememesine ve sunucu açılışında betik hatalarına neden olur. Bu doğrulamaları yaptıktan sonra txAdmin panelindeki canlı konsol sekmesinden sunucuyu yeniden başlatabilirsiniz. Benzer altyapı adımları diğer çok oyunculu yapımlar için de geçerlidir; örneğin VDS ile oyun sunucusu kurma rehberi üzerinden farklı oyun motorlarının sunucu yapılarını inceleyebilirsiniz.

Port ayarları ve bağlantı testi

FiveM sunucunuzun dış dünyadan erişilebilir olması ve oyuncuların listelerde sunucunuzu görebilmesi için ağ geçitlerinin doğru yapılandırılması gerekir. FiveM varsayılan olarak hem TCP hem de UDP protokollerinde 30120 portunu kullanır. txAdmin web yönetim arayüzü ise varsayılan olarak 40120 portundan hizmet verir. Yönetim panelinin güvenliği için 40120 portunu tüm internete açmak yerine yalnızca kendi sabit genel IP adresinize izin vermeli veya sunucuya WireGuard VPN kurulumu ya da SSH tüneli üzerinden erişmelisiniz.

Aşağıdaki komutlarda yer alan 198.51.100.50 adresi temsilidir; komutları çalıştırmadan önce bu adresi kendi internet çıkış IP adresinizle değiştirmeniz gerekir.

Windows sunucularda "Gelişmiş Güvenlik Özellikli Windows Defender Güvenlik Duvarı" üzerinden gelen kuralları (inbound rules) tanımlamak için PowerShell komutlarını kullanabilirsiniz:

New-NetFirewallRule -DisplayName "FiveM Server TCP" -Direction Inbound -LocalPort 30120 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "FiveM Server UDP" -Direction Inbound -LocalPort 30120 -Protocol UDP -Action Allow
New-NetFirewallRule -DisplayName "txAdmin Web Port" -Direction Inbound -LocalPort 40120 -Protocol TCP -RemoteAddress 198.51.100.50 -Action Allow

Linux sistemlerde UFW (Uncomplicated Firewall) kullanılıyorsa, oyun portunu herkese açıp panel portunu yalnızca kendi IP adresinizle sınırlandıracak kuralları uygulayın:

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from 198.51.100.50 to any port 40120 proto tcp
sudo ufw reload

Portların durumunu doğrulamak için terminal üzerinden soket istatistikleri aracını kullanabilirsiniz:

ss -tulnp | grep -E '30120|40120'

Port tanımları tamamlandıktan sonra FiveM istemcinizi açın, F8 tuşuna basarak istemci konsolunu görüntüleyin ve doğrudan bağlantı komutunu yazın:

connect sunucu-ip-adresiniz:30120

Bağlantı kuruluyorsa sunucunuz genel ağ trafiğine hazır durumdadır. Bu aşamadan sonra sunucu adınızı, eklenti listelerinizi ve topluluk kurallarınızı server.cfg içerisinden yapılandırarak geliştirme sürecinize devam edebilirsiniz. İhtiyaçlarınıza uygun donanım kaynağını seçmek için Büyükweb VDS paketlerini inceleyerek ilk adımı atabilirsiniz.

Sık Sorulan Sorular

txAdmin PIN kodunu unuttum, nasıl sıfırlayabilirim?

Konsol açık durumdaysa txAdmin başlangıç satırlarını inceleyerek mevcut PIN kodunu görebilirsiniz. Konsola erişiminiz yoksa txAdmin başlangıç çıktısında belirtilen etkin txData yolundaki admins.json dosyasını silmeniz gerekir. Bu dosya silindiğinde mevcut tüm yönetici hesapları sıfırlanır ve txAdmin yeniden başladığında panel kurulumu için yeni bir PIN kodu üretir.

FiveM sunucusu için lisans anahtarı nereden alınır?

Lisans anahtarı Cfx.re Portal üzerinden oluşturulur. Bir Cfx.re hesabı ile portala giriş yaptıktan sonra yeni bir sunucu kaydı oluşturmanız gerekir. Kayıt adımlarını takip ederek oluşturduğunuz anahtarı sunucunuzun server.cfg dosyasına sv_licenseKey değişkeniyle ekleyerek kullanabilirsiniz.

Sunucumda "sv_licenseKey token is invalid" hatası alıyorum, nedeni nedir?

Bu hata, server.cfg dosyasına girilen lisans anahtarının geçersiz, eksik kopyalanmış veya Cfx.re Portal üzerinde iptal edilmiş olduğunu gösterir. Cfx.re Portal arayüzüne giderek anahtarın durumunu kontrol etmeli, anahtar dizesini başında veya sonunda boşluk kalmayacak biçimde kopyalayıp yapılandırma dosyasına tırnak işaretleriyle yeniden eklemelisiniz.

64 oyuncudan fazla kapasiteye sahip bir sunucu açabilir miyim?

Evet, ancak 48 oyuncu sınırını aşmak için yalnızca OneSync altyapısını aktif hale getirmek yeterli değildir. 48 oyuncunun üzerindeki kapasite için uygun bir Cfx.re Element Club üyeliğine sahip olmanız ve buna bağlı lisans anahtarını kullanmanız gerekir.

Sunucu performansını izlemek için hangi araçları kullanmalıyım?

txAdmin panelinde yer alan dahili performans sekmesi işlemci, bellek ve anlık FPS değerlerini izlemenizi sağlar. Sunucu işletim sistemi düzeyinde detaylı kaynak takibi ve ağ trafiği analizi yapmak için harici izleme yazılımlarından yararlanabilirsiniz. Ayrıntılı altyapı izleme yöntemleri için sunucu izleme araçları rehberi içeriğini inceleyebilirsiniz.