Bu kılavuz, FiveM sunucunuza kaynaklar (scriptler) nasıl kurulur, ESX veya QBCore gibi çerçeveler için bir MySQL veritabanı nasıl kurulur ve kaynak yükleme sırası nasıl anlaşılır konularını anlatır. İlk sunucu kurulumunu henüz tamamlamadıysanız, önce FiveM Sunucu Kurulum Kılavuzu ile başlayın.

Kaynak ve Script Kurulumu

FiveM sunucuları kaynaklar (scriptler olarak da adlandırılır) ile genişletilir. Kaynaklar; araba bayileri, meslekler, HUD öğeleri, çerçeveler ve daha fazlası gibi özellikler ekler.

Bir Kaynak Nasıl Kurulur

1. Kaynağı kaynağından indirin (GitHub, Cfx.re forumları, Tebex vb.).
2. Gerekirse ZIP/arşivden kaynak klasörünü çıkarın.
3. Kaynak klasörünü, GPanel Files sekmesini kullanarak veya SFTP ile sunucunuzun resources/ dizinine yükleyin.
4. server.cfg dosyasını açın ve kaynak için bir ensure satırı ekleyin:

# Add your custom resources
ensure my-new-resource

5. Kaynağın yüklenmesi için sunucuyu GPanel'den veya TXAdmin'den yeniden başlatın.

Kaynak Manifestoları

Her geçerli kaynak bir manifest dosyası içermelidir. Modern kaynaklar fxmanifest.lua kullanırken, eski olanlar __resource.lua kullanır. İndirilen bir kaynak klasörü bu dosyalardan birini içermiyorsa, kaynak yüklenmez. Bazı indirmeler asıl kaynak klasörünü dıştaki bir klasörün içine yerleştirir — resources/ dizinine yerleştirdiğiniz klasörün manifesto içeren klasör olduğundan emin olun.

Kaynak Yükleme Sırası

Kaynaklar server.cfg içinde göründükleri sırayla yüklenir. Bir kaynak başka birine bağımlıysa (örneğin, ESX veya QBCore gibi bir çerçeveye bağımlı bir meslek scripti), bağımlılığın ona ihtiyaç duyan kaynaktan önce listelendiğinden emin olun:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Kaynakları Kategori Klasörleriyle Düzenleme

Kaynakları resources/ dizini içindeki alt klasörlere düzenleyebilirsiniz. Tüm bir kategori klasörünü ensure etmek için server.cfg içinde köşeli parantez gösterimini kullanın:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Bu, adlandırılan alt klasördeki her kaynağı yükler. İlgili scriptleri her birini tek tek listelemeden gruplamanın kullanışlı bir yoludur.

TXAdmin ile Kaynakları Anlık Yükleme

Yeni bir kaynağı yüklemek için her zaman tam bir sunucu yeniden başlatmasına ihtiyacınız yoktur. TXAdmin, Resources sayfasından bireysel kaynakları başlatabilir, durdurabilir ve yeniden başlatabilir. Yeni bir kaynak yükledikten ve ensure satırını ekledikten sonra, TXAdmin canlı konsolunda aşağıdaki komutu çalıştırabilirsiniz:

refresh
ensure my-new-resource

refresh komutu, sunucuya yeni girişler için resources/ dizinini yeniden taramasını söyler.

Veritabanı Kurulumu (MySQL / MariaDB)

Birçok FiveM çerçevesi ve kaynağı (ESX, QBCore veya vRP gibi) bir MySQL veya MariaDB veritabanı gerektirir. Legion Hosting, sunucunuzla birlikte veritabanı kimlik bilgileri sağlar.

Veritabanı Kimlik Bilgilerinizi Bulma

1. GPanel'de Databases sekmesine gidin.
2. Henüz bir veritabanı yoksa, bir tane oluşturmak için New Database'e tıklayın.
3. Aşağıdaki ayrıntıları not edin:
   • Veritabanı Sunucusu (Host) (adres ve port)
   • Veritabanı Adı
   • Kullanıcı Adı
   • Parola (görmek için göz simgesine tıklayın)

Veritabanı Bağlantısını Yapılandırma

Veritabanı bağlantı ayrıntıları, bir bağlantı dizesi kullanılarak server.cfg içinde ayarlanır. Tam format, hangi MySQL kaynağını kullandığınıza bağlıdır, ancak en yaygın format şudur:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Yer tutucuları, Databases sekmesinden gelen gerçek kimlik bilgilerinizle değiştirin. Örneğin:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Bir MySQL Kaynağı Seçme

Hangi MySQL kaynağını kullanırsanız kullanın, server.cfg içinde ona bağımlı olan herhangi bir kaynaktan önce ensure edilmelidir:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Çerçeve Temelleri

Bir çerçeve, diğer kaynakların üzerine inşa edildiği temel oynanış sistemlerini sağlar — oyuncu kimliği, para, envanter, meslekler ve araçlar gibi şeyler. En popüler iki FiveM çerçevesi şunlardır:

Çoğu çerçeve, ilk kurulum sırasında TXAdmin'in recipe sistemi aracılığıyla kurulur. TXAdmin kurulumu sırasında "QBCore" veya "ESX" gibi bir recipe seçtiyseniz, çerçeve ve temel bağımlılıkları zaten kurulmuştur. Bir çerçeveyi manuel olarak kurmanız gerekiyorsa, resmi belgelerini izleyin:

• ESX Belgeleri
• QBCore Belgeleri

Yardım Alma

Kaynak kurulumu veya veritabanı yapılandırması konusunda yardıma ihtiyacınız varsa:

1. Kurulum talimatları ve bilinen sorunlar için kaynağın belgelerini veya GitHub sayfasını kontrol edin.
2. Hata mesajları için GPanel konsolunu veya TXAdmin günlüklerini inceleyin.
3. https://legionhosting.net/submitticket.php adresinde, hata mesajlarınız ve kurmaya çalıştığınız kaynağın adıyla birlikte bir destek talebi açın.

İlgili Makaleler

• FiveM Sunucu Kurulum Kılavuzu
• FiveM Sorun Giderme
• SFTP ile Dosya Nasıl Yüklenir
• Sunucu IP ve Portunuzu Nasıl Bulursunuz