Fivem Sunucu Nasıl Kurulur ? Fivem Sunucu Kurulumu - Güncel txAdmin , ESX ve QBCore Rehberi

[ExxDev]

FIVEM SUNUCU KURULUMU

Windows VDS, txAdmin, ESX ve QBCore için anlaşılır kurulum rehberi

Bu rehber sayesinde sıfırdan bir FiveM sunucusu kurabilir, sunucunuzu internete açabilir ve yeni scriptler ekleyebilirsiniz.
​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Bu Rehberde Neler Var?

• Windows VDS üzerine FiveM kurulumu
• FXServer ve txAdmin kurulumu
• Cfx.re lisans anahtarı oluşturma
• FiveM portlarını açma
• server.cfg ayarlarını düzenleme
• Sunucuya bağlanma
• Script ve araç paketi yükleme
• ESX ve QBCore altyapısı kurma
• MySQL bağlantısı oluşturma
• Sunucu güncelleme ve yedekleme
• Yaygın hataların çözümleri
• Temel güvenlik ayarları

Önemli: Bu anlatım ağırlıklı olarak Windows Server kurulu bir VDS üzerinden hazırlanmıştır. Kendi bilgisayarınızda test sunucusu kurarken de aynı adımları uygulayabilirsiniz.

Güvenlik uyarısı: Cfx.re lisans anahtarınızı, veritabanı şifrenizi ve txAdmin giriş bilgilerinizi hiç kimseyle paylaşmayın.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. FiveM Sunucusu İçin Gerekenler

Kuruluma başlamadan önce aşağıdaki bileşenlere sahip olmanız gerekir:

• Windows Server kurulu VDS veya fiziksel sunucu
• Cfx.re hesabı
• Sabit ve dışarıdan erişilebilir IP adresi
• 7-Zip veya WinRAR
• FiveM FXServer dosyaları
• Cfx.re sunucu lisans anahtarı
• ESX veya QBCore kurulacaksa MySQL/MariaDB

Önerilen başlangıç sistemi

Küçük ve orta ölçekli bir Roleplay sunucusu için aşağıdaki sistem başlangıç noktası olarak kullanılabilir:

• İşlemci: En az 4 güçlü sanal çekirdek
• RAM: En az 8 GB
• Disk: En az 80 GB NVMe SSD
• İşletim sistemi: Windows Server 2019, 2022 veya daha güncel desteklenen sürüm
• İnternet: Düşük gecikmeli ve DDoS korumalı bağlantı

Bu değerler kesin bir gereksinim değildir. Script sayısı, oyuncu sayısı, harita paketleri ve araçların optimizasyonu kaynak kullanımını doğrudan etkiler.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2. FiveM FXServer Dosyalarını İndirme

Öncelikle VDS’ye Uzak Masaüstü Bağlantısı ile giriş yapın.

FiveM’in resmi Windows server artifact sayfasını açın:

FiveM Windows Server Artifacts

Sayfada LATEST RECOMMENDED olarak işaretlenen sürümü indirin.

Ardından aşağıdaki klasörleri oluşturun:

C:\FXServer
C:\FXServer\server

İndirdiğiniz server.7z dosyasının içerisindeki bütün dosyaları şu klasöre çıkartın:

C:\FXServer\server

Dosyaların başka bir klasörün içinde kalmadığından emin olun. Doğru yapıda FXServer.exe doğrudan server klasörünün içerisinde görünmelidir.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3. FXServer ve txAdmin’i Başlatma

C:\FXServer\server\FXServer.exe

dosyasına çift tıklayın.

FXServer açıldığında txAdmin kurulum ekranı tarayıcıda otomatik olarak açılacaktır.

Otomatik açılmazsa VDS içerisindeki tarayıcıya şu adresi yazın:

http://localhost:40120

Konsol ekranında gösterilen dört haneli PIN kodunu txAdmin ekranına girin.

Daha sonra:

1. Link Account butonuna basın.
2. Cfx.re hesabınızla giriş yapın.
3. txAdmin erişimine izin verin.
4. Güçlü bir yedek giriş şifresi belirleyin.
5. Lisans sözleşmelerini okuyup kabul edin.
6. Sunucunuz için bir profil adı oluşturun.

Not: txAdmin, FXServer ile birlikte gelir. Ayrı bir txAdmin dosyası indirmeniz gerekmez.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

4. Kurulum Şablonunu Seçme

txAdmin size hangi yöntemle sunucu kurmak istediğinizi soracaktır.

Deployment Type bölümünde:

Popular Recipes

seçeneğini seçin.

Karşınıza çıkan şablonların amacı şöyledir:

• CFX Default / FiveM Basic Server: Framework bulunmayan temel ve boş FiveM sunucusudur.
• QBCore: Roleplay sunucuları için QBCore tabanlı altyapı kurar.
• ESX: Roleplay sunucuları için ESX tabanlı altyapı kurar.
• Özel Recipe: Hazır satın alınan veya geliştirilen özel sunucu paketlerini kurar.

Sadece kurulum testi yapmak istiyorsanız CFX Default FiveM şablonunu seçebilirsiniz.

Roleplay sunucusu açacaksanız ESX veya QBCore şablonlarından birini kullanabilirsiniz. Kullanılabilir şablonlar zamanla değişebilir.

Dikkat: ESX ve QBCore farklı altyapılardır. İki framework’ü aynı sunucuda birlikte kurmaya çalışmayın. Satın aldığınız scriptlerin seçtiğiniz framework ile uyumlu olması gerekir.

Verilerin kaydedileceği klasörü seçtikten sonra:

1. Save butonuna basın.
2. Go to Recipe Deployer seçeneğine girin.
3. Recipe içeriğini kontrol edin.
4. Next butonuyla lisans aşamasına ilerleyin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5. Cfx.re Lisans Anahtarı Oluşturma

FiveM sunucusunu çalıştırabilmek için bir Cfx.re lisans anahtarına ihtiyacınız vardır.

Lisans işlemleri için:

Cfx.re Portal

adresine giriş yapın.

Ardından:

1. Create a Key seçeneğine basın.
2. Anahtarı ayırt edebileceğiniz bir isim yazın.
3. Generate butonuna basın.
4. Oluşturulan lisans anahtarını kopyalayın.
5. txAdmin Recipe Deployer ekranındaki lisans alanına yapıştırın.
6. Run Recipe butonuna basın.

Kurulum tamamlandığında:

Save & Run Server

butonuna basın.

Her şey doğruysa FXServer başlayacak ve txAdmin üzerinde sunucunun çalıştığını göreceksiniz.

Lisans anahtarınızı forumlarda, Discord sunucularında veya ekran görüntülerinde paylaşmayın.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

6. Windows Güvenlik Duvarı Portlarını Açma

FiveM’in varsayılan bağlantı portu 30120 olarak kullanılır. Bu portun hem TCP hem de UDP protokolü için açık olması gerekir.

Başlat menüsüne PowerShell yazın ve Yönetici olarak çalıştır seçeneğini kullanın.

Aşağıdaki komutları ayrı ayrı çalıştırın:

New-NetFirewallRule -DisplayName "FiveM TCP 30120" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM UDP 30120" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow

VDS kullanıyorsanız hosting firmanızın ayrıca bir harici firewall paneli olabilir. Bu panelde de 30120 TCP/UDP portlarına izin vermeniz gerekebilir.

Kendi ev bilgisayarınızda sunucu açıyorsanız modem üzerinden port yönlendirme yapmanız gerekir. 30120 portunu sunucunun yerel IP adresine TCP ve UDP olarak yönlendirin.

txAdmin portu: txAdmin varsayılan olarak 40120 portunu kullanır. Bu portu herkese açık hale getirmek yerine panele VDS içerisinden erişin. Uzaktan erişim gerekiyorsa firewall üzerinden yalnızca kendi IP adresinize izin verin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

7. server.cfg Ayarları

server.cfg, sunucunun temel ayarlarını içeren dosyadır. txAdmin panelinde CFG Editor bölümünden düzenlenebilir.

Aşağıda örnek bir temel yapılandırma bulunmaktadır:

# FiveM bağlantı portları
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Sunucu bilgileri
sv_hostname "Sunucu Adı | Türkçe Roleplay"
sets sv_projectName "Sunucu Adı"
sets sv_projectDesc "Kaliteli ve gelişmiş Türkçe Roleplay deneyimi."
sets tags "roleplay, türkçe, whitelist, ekonomi"
sets locale "tr-TR"

# Sunucu logosu
load_server_icon logo.png

# İsteğe bağlı banner bağlantıları
# sets banner_detail "https://siteadresiniz.com/banner.png"
# sets banner_connecting "https://siteadresiniz.com/banner.png"

# Oyuncu kapasitesi
sv_maxclients 48

# OneSync
set onesync on

# Oyuncu IP bilgilerinin raporlarda gizlenmesi
sv_endpointPrivacy true

# ScriptHook kapalı
sv_scriptHookAllowed 0

# Temel FiveM kaynakları
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

# Kendi script klasörleriniz
# ensure [standalone]
# ensure [core]
# ensure [jobs]
# ensure [vehicles]

# Cfx.re lisans anahtarı
sv_licenseKey "LISANS_ANAHTARINIZI_BURAYA_YAZIN"

Önemli ayarların açıklaması

• sv_hostname: Sunucu bağlantı ekranındaki sunucu adıdır.
• sv_projectName: Projenizin veya topluluğunuzun adıdır.
• sv_projectDesc: Sunucunun kısa açıklamasıdır.
• sets tags: Sunucunun aramalarda bulunmasını kolaylaştıran etiketlerdir.
• sets locale: Sunucunun ana dilini belirtir.
• sv_maxclients: Sunucuya aynı anda bağlanabilecek oyuncu sayısıdır.
• set onesync on: Sunucu taraflı entity yönetimini etkinleştirir.
• sv_licenseKey: Cfx.re üzerinden oluşturulan gizli lisans anahtarıdır.
• ensure: Belirtilen script veya resource’un başlatılmasını sağlar.

Sunucu logosu kullanacaksanız 96x96 PNG formatındaki görseli server.cfg ile aynı sunucu veri dizinine yerleştirin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

8. FiveM Sunucusuna Bağlanma

Sunucuyu txAdmin üzerinden başlattıktan sonra FiveM’i açın.

F8 tuşuna basarak konsolu açın ve aşağıdaki komutu yazın:

connect SUNUCU_IP_ADRESI:30120

Örnek:

connect 192.0.2.10:30120

Alan adı bağladıysanız:

connect play.siteadresiniz.com:30120

Sunucuya bağlanabiliyor fakat başka oyuncular bağlanamıyorsa sorun çoğunlukla firewall, modem port yönlendirmesi veya hosting firmasının harici güvenlik duvarıyla ilgilidir.

txAdmin oyun içi yönetim menüsünü açmak için F8 konsoluna şu komutu yazabilirsiniz:

tx

Bu komutun çalışması için hesabınıza txAdmin üzerinden gerekli yetkinin verilmiş olması gerekir.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

9. FiveM Script Kurulumu

Scriptler, sunucunun resources klasörüne yüklenir. txAdmin kurulumu kullanıyorsanız klasör genellikle şu yapıya benzer:

C:\FXServer\txData\ProfilAdi\resources

Bir script yüklemek için:

1. Sunucuyu durdurun.
2. İndirdiğiniz script arşivini çıkartın.
3. Script klasörünü resources içerisine taşıyın.
4. Klasörün içerisinde fxmanifest.lua dosyası bulunduğunu kontrol edin.
5. server.cfg dosyasına scriptin başlangıç komutunu ekleyin.
6. Sunucuyu yeniden başlatın.

Örnek script klasörü:

resources\[local]\ornek-script

server.cfg başlangıç satırı:

ensure ornek-script

Sunucu çalışırken yeni resource eklediyseniz konsolda şunları kullanabilirsiniz:

refresh
ensure ornek-script

Klasör yapısına dikkat edin:

Yanlış:

resources\ornek-script\ornek-script\fxmanifest.lua

Doğru:

resources\ornek-script\fxmanifest.lua

Bir script başka bir scripte bağlıysa bağımlılık olan resource önce başlatılmalıdır.

Örnek:

ensure ox_lib
ensure ox_target
ensure ornek-script

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

10. ESX veya QBCore Kurulumu

ESX ve QBCore; meslekler, karakter sistemi, envanter, ekonomi ve veritabanı işlemleri sağlayan Roleplay framework’leridir.

En kolay kurulum yöntemi txAdmin içerisindeki hazır Recipe sistemini kullanmaktır.

1. txAdmin üzerinde yeni bir server profile oluşturun.
2. Popular Recipes seçeneğini seçin.
3. ESX veya QBCore şablonlarından birini seçin.
4. Recipe tarafından istenen bilgileri doldurun.
5. MySQL bağlantı bilgilerini girin.
6. Recipe kurulumunu çalıştırın.
7. Kurulum tamamlandıktan sonra server.cfg dosyasını kontrol edin.

Önemli: Hazır framework paketlerinin ihtiyaç duyduğu database sürümü ve resource bağımlılıkları farklı olabilir. Her zaman kullandığınız Recipe veya paketin kendi kurulum belgesini okuyun.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

11. MySQL Veritabanı Bağlantısı

ESX ve QBCore sunucularında oyuncu karakterleri, araçlar, evler, envanter ve para bilgileri genellikle MySQL/MariaDB veritabanında saklanır.

MySQL veya MariaDB kurduktan sonra:

1. Sunucu için yeni bir veritabanı oluşturun.
2. Sadece bu veritabanına erişebilen ayrı bir kullanıcı oluşturun.
3. Framework ile gelen SQL dosyalarını doğru sırayla içeri aktarın.
4. server.cfg dosyasına bağlantı adresini ekleyin.

Örnek veritabanı adı:

fivem_roleplay

Örnek bağlantı satırı:

set mysql_connection_string "mysql://fivem_user:SIFRENIZ@127.0.0.1/fivem_roleplay?charset=utf8mb4"

oxmysql kullanılıyorsa başlangıç sırası şu şekilde olmalıdır:

ensure oxmysql
ensure qb-core

veya ESX için:

ensure oxmysql
ensure es_extended

Framework resource’u, veritabanı resource’undan önce başlatılırsa bağlantı hataları oluşabilir.

Güvenlik uyarısı: Veritabanında root kullanıcısını kullanmayın. Sunucuya özel bir kullanıcı oluşturun ve veritabanı portunu internete açık bırakmayın.

Şifrenizde özel karakter bulunuyorsa bağlantı adresinde URL kodlaması gerekebilir. “Access denied” hatası alırsanız kullanıcı adı, şifre, veritabanı adı ve yetkileri kontrol edin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

12. txAdmin ile Sunucu Yönetimi

txAdmin üzerinden aşağıdaki işlemleri gerçekleştirebilirsiniz:

• Sunucuyu başlatma, durdurma ve yeniden başlatma
• Resource başlatma ve durdurma
• Canlı konsol takibi
• Oyuncuları görüntüleme
• Oyuncuya uyarı, kick veya ban uygulama
• Yetkili hesapları oluşturma
• Planlı restart ayarlama
• Sunucu CPU ve RAM kullanımını görüntüleme
• Crash veya donma durumlarını takip etme
• İşlem ve yönetici loglarını inceleme

Her yetkiliye tam erişim vermeyin. txAdmin izinlerini kişinin görevine göre sınırlandırın.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

13. FiveM Sunucusunu Güncelleme

FXServer sürümünüz eski kaldığında artifact uyarısı veya uyumsuzluk hataları görebilirsiniz.

Güncelleme işlemi:

1. Sunucuyu tamamen durdurun.
2. Sunucu dosyalarının yedeğini alın.
3. Resmi artifact sayfasından güncel önerilen sürümü indirin.
4. FXServer binary dosyalarını güncelleyin.
5. server-data, resources ve txData klasörlerini silmeyin.
6. Sunucuyu açıp konsol hatalarını kontrol edin.

Güncelleme öncesinde mutlaka aşağıdaki verileri yedekleyin:

• resources klasörü
• server.cfg ve diğer yapılandırma dosyaları
• txData profil klasörü
• MySQL/MariaDB veritabanı
• Scriptlere ait config dosyaları
• Yetki ve allowlist dosyaları

Framework, envanter veya veritabanı scriptlerini güncellerken doğrudan eski dosyaların üzerine yazmayın. Önce değişiklik notlarını ve migration dosyalarını kontrol edin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

14. Yaygın FiveM Hataları ve Çözümleri

“Couldn’t authenticate server license key”

• Cfx.re lisans anahtarını kontrol edin.
• Anahtarın başında veya sonunda boşluk olmadığından emin olun.
• server.cfg içerisinde doğru satırda bulunduğunu kontrol edin.
• Portal üzerinden anahtar durumunu inceleyin.

“Failed to bind socket”

• 30120 portunu başka bir uygulama kullanıyor olabilir.
• Aynı anda iki FXServer işlemi çalışıyor olabilir.
• Görev Yöneticisi üzerinden eski FXServer işlemlerini kontrol edin.
• server.cfg içerisindeki port tanımlarını kontrol edin.

“Connection timed out”

• Windows Firewall kurallarını kontrol edin.
• 30120 TCP ve UDP portlarının ikisini de açın.
• Hosting firmasının harici firewall ayarlarını kontrol edin.
• Ev bağlantısında modem port yönlendirmesini kontrol edin.
• Sunucunun gerçekten çalıştığından emin olun.

“Couldn’t load resource”

• Script klasörünün iç içe geçmediğini kontrol edin.
• fxmanifest.lua dosyasının bulunduğundan emin olun.
• Scriptin bağımlılıklarını kontrol edin.
• Resource adını server.cfg içerisinde doğru yazın.
• Konsoldaki ilk hata satırını inceleyin.

“Access denied for user”

• MySQL kullanıcı adı ve şifresini kontrol edin.
• Kullanıcının veritabanına yetkisi olduğundan emin olun.
• Veritabanı adını kontrol edin.
• MySQL servisinin çalıştığından emin olun.
• Bağlantı adresindeki özel karakterleri kontrol edin.

Sunucu listede görünmüyor

• sv_projectName ve sv_projectDesc satırlarını doldurun.
• 30120 TCP/UDP portlarını kontrol edin.
• Sunucunun internete açık bir IP adresi kullandığından emin olun.
• Yeni açılan sunucunun listeye düşmesi için kısa süre bekleyin.
• Önce F8 üzerinden doğrudan IP bağlantısını test edin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

15. FiveM Sunucusu Güvenlik Kontrol Listesi

• Cfx.re lisans anahtarınızı paylaşmayın.
• txAdmin için güçlü ve benzersiz bir şifre kullanın.
• txAdmin 40120 portunu herkese açık bırakmayın.
• MySQL portunu dış internete kapatın.
• Veritabanında root yerine sınırlı kullanıcı kullanın.
• Yalnızca gerekli TCP ve UDP portlarını açın.
• Kaynağı belirsiz veya şifreli scriptleri kurmayın.
• Crack veya leak scriptlerden uzak durun.
• Scriptlerin içerisinde zararlı kod ve webhook kontrolü yapın.
• Her gün düzenli dosya ve veritabanı yedeği alın.
• Yetkililere ihtiyaçlarından fazla txAdmin izni vermeyin.
• FXServer ve framework sürümlerini kontrollü şekilde güncelleyin.
• DDoS korumalı ve güvenilir bir sunucu sağlayıcısı kullanın.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

16. Kullanışlı Sunucu Komutları

status

Bağlı oyuncuları ve sunucu durumunu gösterir.

refresh

Resources klasörünü yeniden tarar.

ensure script-adi

Script çalışmıyorsa başlatır; çalışıyorsa yeniden başlatır.

restart script-adi

Belirtilen scripti yeniden başlatır.

stop script-adi

Belirtilen scripti durdurur.

start script-adi

Durdurulmuş scripti başlatır.

say Sunucu kısa süre içerisinde yeniden başlatılacaktır.

Sunucu sohbetine konsol üzerinden mesaj gönderir.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Sonuç

Bu işlemlerin ardından temel FiveM sunucunuz kurulmuş olacaktır. Bundan sonraki aşamada seçtiğiniz altyapıya uygun meslekler, araçlar, kıyafetler, haritalar, envanter sistemi, telefon ve diğer Roleplay scriptlerini ekleyebilirsiniz.

Sunucuya yeni sistemler eklerken her işlemi tek tek gerçekleştirin. Aynı anda çok sayıda script kurmak, oluşan hatanın kaynağını bulmayı zorlaştırır.

Her önemli değişiklikten önce dosya ve veritabanı yedeği almayı unutmayın.

Kurulum sırasında aldığınız hataları konu altında paylaşabilirsiniz.

Hata bildirirken konsoldaki ilk hata satırını ve kullandığınız altyapıyı belirtmeniz çözüm sürecini hızlandıracaktır.
​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Resmî Kaynaklar

• Cfx.re FiveM Sunucu Kurulumu
• txAdmin ile Sunucu Kurulumu
• FiveM Sunucu Komutları
• Cfx.re Portal ve Lisans İşlemleri