Kendi FiveM sunucusunu kurmak isteyen ama nereden başlayacağını bilmeyenlerden misiniz? QBCore, ESX, Qbox, FXServer, txAdmin, MySQL... İnternette biraz araştırma yaptığınızda karşınıza çıkan kavramların sayısı giderek artıyor. Bir de kurulum videosu izleyip adamın yaptığı işlemleri kendi bilgisayarınızda tekrarlamaya çalıştığınızda her şeyin aynı şekilde ilerlemediğini görüyorsunuz.

FiveM sunucusu kurmak için yazılımcı olmanız gerekmiyor. İlk sunucunuzu çalıştırmak için temel birkaç programı tanımanız ve kurulum adımlarını takip etmeniz yeterli. İlerleyen aşamalarda script düzenlemek, veritabanı bağlantısı kurmak ve sunucu yapılandırmasıyla uğraşmak gerekecek. Bunları da zamanla öğrenebilirsiniz.

Bu rehberde Windows üzerinden ilerleyeceğiz. Önce temel FiveM sunucumuzu kuracağız. Ardından Roleplay altyapılarını inceleyecek, veritabanı bağlantısından script kurulumuna kadar ihtiyaç duyacağımız sistemleri tanıyacağız. Sunucuyu arkadaşlarımıza açmak ve oyuncuların erişimine hazırlamak için gereken ağ ayarlarına da bakacağız.

Rehberin sonunda bulunan etkileşimli kurulum yardımcısı ile kendi bilgisayarınıza, deneyiminize ve sunucu hedefinize uygun bir başlangıç planı da oluşturabilirsiniz.

1. FiveM nedir ve sunucu sistemi nasıl çalışır?

FiveM, Grand Theft Auto V için geliştirilmiş çok oyunculu bir platformdur. Oyuncuların kendi sunucularında farklı oyun modları, haritalar, araçlar, karakterler ve scriptlerle oyun deneyimini değiştirmesine imkân tanır.

Normal GTA Online deneyiminden farklı olarak FiveM sunucularında sunucu sahibi hangi sistemlerin kullanılacağını büyük ölçüde belirleyebilir. Bir Roleplay sunucusunda polis teşkilatı, hastane, banka, işletmeler ve oyunculara ait karakterler bulunabilir. Başka bir sunucuda ise sadece yarış ve araç sistemleri yer alabilir.

Bir FiveM sunucusunun temel çalışma yapısı şu şekildedir:

• FXServer: Sunucuyu çalıştıran ana yazılım.
• Resources: Oyun içerisindeki özellikleri sağlayan script ve kaynaklar.
• Framework: Karakter, meslek, ekonomi ve envanter gibi temel sistemleri bir araya getiren altyapı.
• Database: Oyuncuların ve sunucunun kalıcı verilerini saklayan veritabanı.
• txAdmin: Sunucuyu yönetmek ve izlemek için kullanılan kontrol paneli.
• FiveM Client: Oyuncuların sunucuya bağlanmasını sağlayan istemci.

Bu parçalar birlikte çalışır. Örneğin bir oyuncu karakter oluşturduğunda karakter bilgileri framework tarafından işlenir ve veritabanına kaydedilir. Oyuncu daha sonra tekrar bağlandığında kayıtlı bilgiler veritabanından alınır.

2. Hangi FiveM sunucu türünü seçmelisiniz?

Roleplay (RP)

Roleplay sunucuları, FiveM topluluğunda en çok karşılaşılan sunucu türlerinden biri. Oyuncular bir karakter oluşturur ve oyun içerisinde bu karakterin hayatını sürdürür. Polis, doktor, mekanik, taksici, avukat veya işletme sahibi olabilirler.

Bu sunucularda ekonomi, meslekler, araçlar, evler, envanter ve sosyal etkileşim sistemleri bulunur. Kapsamlı bir proje oluşturmak isteyenler için geniş geliştirme alanı sunar.

Hard Roleplay

Hard RP sunucularında rol kuralları daha sıkıdır. Karakterlerin davranışları, olayların gelişimi ve oyuncuların birbirleriyle etkileşimi belirli kurallara bağlıdır. Yönetim ve moderasyon tarafında daha fazla çalışma gerektirir.

Semi Serious Roleplay

Roleplay kurallarının korunduğu ama oyunculara daha esnek bir deneyim sunulan sunucu türüdür. Yeni oyuncuların alışması genellikle daha kolaydır.

Freeroam ve Drift

Roleplay sistemleriyle uğraşmak istemeyenler için araç sürme, yarış, drift ve serbest dolaşım odaklı sunucular tercih edilebilir. Bu tür projelerde ekonomi ve karakter sistemleri yerine araçlar, haritalar ve yarış sistemleri ön plana çıkar.

Survival

Hayatta kalma, kaynak toplama, barınma ve mücadele sistemleri üzerine kurulur. Bazı sunucularda zombi veya benzeri özel oyun modları da kullanılabilir.

3. FiveM sunucusu için gereken bilgisayar özellikleri

Sunucuyu kendi bilgisayarınızda çalıştırmak ile sürekli oyuncu kabul eden bir sunucu işletmek aynı şey değil. İlkinde test yapmak ve scriptleri denemek yeterliyken ikincisinde bağlantı kalitesi, işlemci performansı, RAM miktarı ve kesintisiz çalışma önem kazanır.

Bu değerler kesin donanım gereksinimleri değildir. 10 oyunculu bir test sunucusu ile çok sayıda oyuncuya hizmet veren, yüzlerce resource çalıştıran bir Roleplay sunucusunun ihtiyaçları aynı olmaz.

Sunucuyu kendi bilgisayarınızda açacaksanız GTA V ve FiveM istemcisinin de aynı bilgisayarda çalışacağını unutmayın. Bu nedenle 8 GB RAM, özellikle oyun da çalışırken oldukça sınırlı kalabilir.

VPS mi, Dedicated Server mı?

VPS: Fiziksel bir sunucunun sanal olarak bölünmüş kaynaklarını kullanırsınız. Küçük ve orta ölçekli projeler için tercih edilebilir.

Dedicated Server: Fiziksel sunucunun kaynakları size ayrılır. Daha fazla kontrol ve kaynak ihtiyacı olan projelerde değerlendirilebilir.

Henüz scriptleri öğrenme aşamasındaysanız kendi bilgisayarınızda test sunucusu kurun. Oyuncuların sürekli erişebileceği bir proje hazırladığınızda barındırma hizmeti seçebilirsiniz.

4. FiveM sunucusu kurmak için gerekli programlar

FXServer

FiveM sunucusunun çalışmasını sağlayan ana yazılımdır. Server artifact olarak da adlandırılan sürümler halinde yayımlanır.

Windows FXServer indirme sayfası

Linux FXServer indirme sayfası

txAdmin

txAdmin, FiveM sunucusunun yönetim panelidir. Sunucu profilleri oluşturabilir, kaynakları yönetebilir, oyuncuları takip edebilir ve yönetici izinlerini düzenleyebilirsiniz.

txAdmin, güncel FXServer artifact paketlerine dahildir. Normal kurulumda ayrıca indirmeniz gerekmez.

txAdmin resmî dokümantasyonu

MariaDB / MySQL

Roleplay sunucularında karakterler, envanterler, banka hesapları ve araç kayıtları gibi verilerin saklanması gerekir. Bunun için ilişkisel veritabanı kullanılır.

MariaDB indirme sayfası

HeidiSQL, veritabanlarını grafik arayüz üzerinden yönetmek için kullanabileceğiniz araçlardan biridir.

Visual Studio Code

Script ve yapılandırma dosyalarını düzenlemek için kullanışlı bir kod editörüdür. Lua, JavaScript, JSON ve yapılandırma dosyalarıyla çalışırken işinizi kolaylaştırır.

Visual Studio Code

Git

Git, GitHub üzerindeki projeleri indirmek ve kaynak kod değişikliklerini takip etmek için kullanılır. Özellikle script geliştirirken ve güncellerken işinize yarar.

Git indirme sayfası

5. Windows üzerinde FXServer ve txAdmin kurulumu

İlk sunucumuzu Windows üzerinde kuracağız. Bu yöntem başlangıçta daha kolay takip edilebilir. Linux kullanıyorsanız resmî Cfx.re kurulum dokümantasyonundaki Linux adımlarını takip etmeniz gerekir.

C:\FXServer\
    server\
    server-data\

http://localhost:40120

6. QBCore, Qbox ve ESX karşılaştırması

Temel sunucu çalışıyor. Artık Roleplay sistemlerine geçebiliriz. Bunun için bir framework seçmemiz gerekiyor.

Framework, sunucunun ana oyun sistemlerini bir arada tutar. Karakter, para, envanter, meslek ve oyuncu verileri gibi özellikler bu altyapıya bağlı çalışır.

QBCore

QBCore, FiveM Roleplay sunucularında yaygın olarak kullanılan framework'lerden biridir. Karakter yönetimi, meslekler, ekonomi ve diğer temel sistemler için geniş bir kaynak ekosistemi bulunur.

Hazır scriptlerle sunucusunu geliştirmek isteyenler için değerlendirilebilir. Scriptlerin sürümlerini ve bağımlılıklarını kontrol etmek gerekir.

QBCore GitHub organizasyonu

Qbox

Qbox, QBCore ekosisteminden gelen modern ve modüler bir framework projesidir. Kendi kaynakları ve txAdmin recipe sistemi bulunur.

Yeni bir proje oluşturmak isteyenler için değerlendirilebilir. Özellikle kullandığınız scriptlerin Qbox desteğini kontrol edin.

Qbox GitHub organizasyonu

ESX Legacy

ESX, FiveM dünyasının uzun süredir kullanılan Roleplay altyapılarından biridir. Meslek, ekonomi ve karakter sistemleri için çok sayıda kaynak bulunur.

ESX ile hazırlanmış eski veya yeni scriptlerle karşılaşabilirsiniz. Her scriptin güncel ESX sürümüyle uyumlu olduğunu varsaymayın.

ESX GitHub organizasyonu

Ben ilk sunucusunu kuracak birine QBCore veya Qbox ile başlamasını öneririm. Hazır scriptleri kullanmak ve topluluk kaynaklarından yararlanmak öğrenme sürecini kolaylaştırabilir.

7. MariaDB ve MySQL kurulumu

Roleplay sunucusunun oyunculara ait verileri saklaması gerekir. Oyuncu karakterini oluşturduktan sonra sunucudan çıktığında bilgilerinin kaybolmasını istemeyiz. Banka bakiyesi, envanter, araçlar ve karakter bilgileri veritabanında saklanır.

Bu amaçla MariaDB veya MySQL kullanabilirsiniz. FiveM ekosisteminde oxmysql de sık karşılaşılan veritabanı bağlantı kaynaklarından biridir.

MariaDB kurulumu

1. MariaDB resmî indirme sayfasını açın.
2. Windows sürümünü indirin ve kurulum dosyasını çalıştırın.
3. Yönetici parolası belirleyin.
4. Kurulum tamamlandığında MariaDB servisinin çalıştığını kontrol edin.
5. HeidiSQL gibi bir araçla veritabanına bağlanın.

Veritabanı oluşturma

HeidiSQL üzerinden yeni bir veritabanı oluşturabilirsiniz. Örneğin veritabanı adını fivem olarak belirleyelim.

CREATE DATABASE fivem
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

Bu komut yeni bir veritabanı oluşturur. Framework kurulumu sırasında gerekli tablolar ve diğer veriler ilgili SQL dosyaları veya txAdmin recipe üzerinden eklenir.

oxmysql nedir?

oxmysql, FiveM kaynaklarının MySQL veya MariaDB veritabanlarıyla iletişim kurmasını sağlayan bir resource'dur.

oxmysql GitHub sayfası

Framework'ünüzün gerektirdiği bağlantı ayarlarını ve resource başlatma sırasını takip etmelisiniz. Kullanıcı adı, parola ve veritabanı bilgilerini herkese açık biçimde paylaşmayın.

Örnek bağlantı satırı şu şekildedir:

set mysql_connection_string "mysql://USER:PASSWORD@127.0.0.1/fivem?charset=utf8mb4"

Buradaki kullanıcı adı, parola ve veritabanı adını kendi kurulumunuza göre değiştirmelisiniz. Gerçek parolanızı örnek dosyalara veya internet üzerinde paylaştığınız ekran görüntülerine koymayın.

8. FiveM script ve resource yönetimi

FiveM sunucusunda gördüğünüz özelliklerin büyük bölümü resource adı verilen kaynaklar üzerinden çalışır. Araç galerisi, polis sistemi, telefon, envanter, harita ve benzeri özellikler ayrı kaynaklar halinde bulunabilir.

Resource dosyaları genellikle sunucunun resources klasörü içerisinde tutulur.

Örnek klasör yapısı:

resources/
    [standalone]/
    [framework]/
    [jobs]/
    [vehicles]/
    [maps]/
    [scripts]/

Köşeli parantez içindeki klasörler kaynakları gruplandırmak için kullanılabilir. Her grubun içinde birden fazla resource bulunabilir.

Resource nasıl başlatılır?

Bir kaynağı başlatmak için server.cfg dosyasına ensure komutu eklenebilir.

ensure ornek-resource

Buradaki ornek-resource yerine kaynak klasörünün gerçek adını yazmalısınız.

Script indirirken nelere dikkat edilmeli?

• Scriptin kullandığınız framework ile uyumlu olduğundan emin olun.
• Gerekli bağımlılıkları kontrol edin.
• Kurulum için SQL dosyası gerekip gerekmediğine bakın.
• Resource manifest dosyasının bulunup bulunmadığını kontrol edin.
• Scriptin lisansını ve kullanım koşullarını inceleyin.
• İndirdiğiniz dosyaların kaynağını kontrol edin.
• Yeni scriptleri önce test sunucusunda deneyin.

Ücretsiz olması, bir scriptin güvenli veya sorunsuz olduğu anlamına gelmez. Özellikle kaynağı belli olmayan hazır sunucu paketlerini doğrudan ana sunucunuza yüklemeyin.

9. server.cfg dosyası nasıl düzenlenir?

server.cfg, FiveM sunucusunun temel ayarlarını içeren yapılandırma dosyasıdır. Sunucu adı, oyuncu sınırı, lisans anahtarı, ağ portları ve başlatılacak kaynaklar gibi bilgiler burada bulunabilir.

Basit bir örnek yapılandırma:

sv_hostname "My First RP Server"

sets sv_projectName "My RP Project"
sets sv_projectDesc "FiveM Roleplay Server"

sv_maxclients 32

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

set onesync on

sv_licenseKey "LISANS_ANAHTARINIZ"

Bu örnek temel yapılandırma içindir. Framework recipe tarafından oluşturulan dosyayı kullanıyorsanız mevcut ayarları silerek bu örneği yapıştırmayın. Recipe tarafından eklenen resource sırası ve veritabanı ayarları korunmalıdır.

Önemli server.cfg komutları

10. FiveM sunucusunu internete açma

Sunucuyu kendi bilgisayarınızda çalıştırdığınızda yerel bağlantı üzerinden test edebilirsiniz. Başka oyuncuların internet üzerinden bağlanabilmesi için ağ ayarlarının yapılması gerekir.

30120 portu

FiveM sunucularında varsayılan oyun bağlantı portu 30120'dir. TCP ve UDP trafiği için gerekli kuralların tanımlanması gerekir.

30120 portu için Windows Güvenlik Duvarı'nda gerekli izinleri tanımlayın. VPS kullanıyorsanız sağlayıcının ağ güvenlik duvarını da kontrol edin.

Kendi bilgisayarınızda sunucu çalıştırıyorsanız modem üzerinden port yönlendirmesi gerekebilir. Yerel IP adresinize doğru yönlendirme yapmalısınız. İnternet sağlayıcınız CGNAT kullanıyorsa gelen bağlantılar için normal port yönlendirmesi yeterli olmayabilir.

VPS üzerinde sunucu açmak

VPS kullanıyorsanız modem ayarlarıyla uğraşmanız gerekmez. Ancak hosting firmasının güvenlik duvarında gerekli oyun bağlantı kurallarını tanımlamalısınız.

Sunucuya bağlanırken VPS'in herkese açık IP adresi ve yapılandırılmış port kullanılır. Sunucunun FiveM istemcisinde görünmesi için ilgili ağ ve listeleme ayarlarının da doğru olması gerekir.

11. FiveM sunucusunda güvenlik ve yedekleme

Sunucu kurulduktan sonra güvenlik ayarlarını ertelemeyin. Özellikle Roleplay sunucularında oyuncuların saatlerce emek vererek oluşturduğu karakterler ve envanterler bulunur. Veritabanının kaybolması bütün bu verilerin silinmesine neden olabilir.

Yedekleme

• Veritabanını düzenli olarak dışa aktarın.
• Sunucu yapılandırma dosyalarının yedeğini alın.
• txAdmin veri klasörünü koruyun.
• Yedekleri mümkünse sunucudan ayrı bir yerde saklayın.
• Büyük güncellemelerden önce mutlaka yedek alın.
• Yedek dosyalarının gerçekten geri yüklenebildiğini test edin.

Yönetici izinleri

Her oyuncuya yönetici yetkisi vermeyin. Sunucu yönetimi için görevleri belirlenmiş ayrı gruplar oluşturun. Yönetici komutlarına erişim, gerçekten ihtiyaç duyan kişilerle sınırlandırılmalıdır.

Script güvenliği

Kaynağı belirsiz scriptleri incelemeden yüklemeyin. Özellikle veritabanına erişen, oyuncu bilgilerini işleyen veya dış bağlantılar kullanan kaynakları kontrol edin. Ücretli scriptleri yalnızca güvenilir satıcılardan ve kullanım lisanslarına uygun şekilde edinin.

12. FiveM sunucu performansı nasıl artırılır?

Sunucunun performansı sadece işlemci ve RAM miktarına bağlı değil. Kullanılan scriptlerin kalitesi, gereksiz sorgular, araç ve harita dosyaları, oyuncu sayısı ve ağ gecikmesi de deneyimi etkiler.

• Kullanılmayan resource'ları kaldırın.
• Gereksiz yere sürekli çalışan döngülerden kaçının.
• Veritabanı sorgularını optimize edin.
• Çok büyük ve gereksiz araç paketleri kullanmayın.
• Scriptlerin konsola sürekli hata yazmadığını kontrol edin.
• Oyuncu sayısı arttıkça CPU ve RAM kullanımını takip edin.
• Güncellemeleri önce test sunucusunda deneyin.

Bir sunucuya 100 farklı script eklemek, onu otomatik olarak daha iyi yapmaz. Kullanılan kaynakların birbirleriyle uyumlu olması ve gereksiz yük oluşturmaması çok daha değerlidir.

13. FiveM sunucusu kurarken karşılaşılan hatalar

14. FiveM sunucusu kurulum kontrol listesi

Kurulumu tamamladığınızda aşağıdaki listeyi kullanarak eksiklerinizi kontrol edebilirsiniz. Kutuları işaretledikçe ilerlemenizi görebilirsiniz.

• FXServer indirildi ve kuruldu.
• txAdmin paneline erişildi.
• Cfx.re lisans anahtarı oluşturuldu.
• Temel sunucu başarıyla başlatıldı.
• Framework seçildi.
• MariaDB veya MySQL kuruldu.
• Veritabanı bağlantısı yapıldı.
• Karakter oluşturma sistemi test edildi.
• Envanter ve meslek sistemleri kuruldu.
• Scriptlerin uyumluluğu kontrol edildi.
• Sunucu güvenlik ayarları yapıldı.
• Yedekleme sistemi oluşturuldu.
• Dış bağlantı testi yapıldı.

0 / 13 görev tamamlandı.

15. Size uygun FiveM sunucu kurulum planını oluşturun

Herkesin kurulum ihtiyacı aynı değil. Kendi bilgisayarında test sunucusu kuracak biriyle Linux VPS üzerinde oyunculara açık bir Roleplay sunucusu hazırlayan kişinin izleyeceği yol farklı.

Aşağıdaki soruları cevaplayın. Seçimlerinize göre size uygun framework önerisini, gerekli programları ve takip etmeniz gereken kurulum sırasını hazırlayalım.

16. Kurulumdan sonra öğrenmeniz gerekenler

İlk sunucunuz çalıştıktan sonra öğrenme süreci bitmiyor. Hatta sunucuyu çalıştırmak, geliştirme sürecinin başlangıcı sayılabilir.

Lua programlama

FiveM scriptlerinin önemli bir bölümü Lua ile hazırlanır. Kendi mesleklerinizi, etkileşimlerinizi veya oyun sistemlerinizi oluşturmak istiyorsanız Lua öğrenmeniz faydalı olacaktır.

Lua resmî dokümantasyonu

FiveM Native Functions

Native fonksiyonlar, GTA V ve FiveM içerisindeki oyun özelliklerine erişmek için kullanılır. Araç oluşturma, oyuncu konumu alma, animasyon oynatma ve benzeri işlemler bu fonksiyonlarla yapılabilir.

FiveM Native Reference

Resource geliştirme

Bir resource oluştururken genellikle fxmanifest.lua dosyası kullanılır. Bu dosya kaynağın hangi dosyaları içerdiğini ve nasıl çalışacağını tanımlar.

Basit bir resource manifest örneği:

fx_version 'cerulean'
game 'gta5'

author 'Server Developer'
description 'My First Resource'
version '1.0.0'

client_script 'client.lua'
server_script 'server.lua'

Bu örnek temel bir resource yapısını gösterir. Aynı klasörde tanımladığınız dosyaların da bulunması gerekir.

17. FiveM sunucu kurulumunda kullanabileceğiniz resmî kaynaklar

Kurulum sırasında karşılaştığınız sorunları çözmek ve yeni sistemler öğrenmek için aşağıdaki kaynakları kullanabilirsiniz.

• Cfx.re Documentation - FiveM ve FXServer dokümantasyonu.
• Setting Up a Server - Sunucu kurulum rehberi.
• txAdmin Documentation - Sunucu yönetim paneli.
• QBCore GitHub - QBCore kaynakları.
• Qbox GitHub - Qbox kaynakları.
• ESX GitHub - ESX kaynakları.
• Cfx.re Forum - Topluluk ve teknik destek.

Son olarak...

FiveM sunucusu kurmak ilk başta biraz karmaşık görünebilir. Bir tarafta FXServer, diğer tarafta txAdmin, framework, veritabanı, resource ve yapılandırma dosyaları... Hepsini aynı anda öğrenmeye çalışırsanız nereden başlayacağınızı şaşırmanız gayet normal.

Benim önerim, önce temel sunucuyu çalıştırmanız. Ardından framework seçip veritabanı bağlantısını kurun. Karakter, envanter ve meslek sistemleri sorunsuz çalıştıktan sonra diğer scriptleri ekleyebilirsiniz.

İlk günden yüzlerce araç, onlarca meslek ve birbirinden farklı sistemlerle dolu bir sunucu oluşturmaya çalışmayın. Önce çalışan bir altyapı hazırlayın. Geri kalanını geliştirmek için yeterince zamanınız olacak.

Bu rehberdeki etkileşimli kurulum yardımcısını kullanarak kendi başlangıç planınızı oluşturabilir, ardından seçtiğiniz altyapıya uygun kurulum adımlarını takip edebilirsiniz.

Keyifli günler!