Bu təlimat FiveM serverinizə resursların (skriptlərin) necə quraşdırılacağını, ESX və ya QBCore kimi freymvorklər üçün MySQL verilənlər bazasının necə qurulacağını və resurs yükləmə sırasını əhatə edir. Əgər hələ ilkin server quraşdırmasını tamamlamamısınızsa, əvvəlcə FiveM Server Quraşdırma Təlimatı ilə başlayın.

Resursların və Skriptlərin Quraşdırılması

FiveM serverləri resurslarla (həmçinin skriptlər adlanır) genişləndirilir. Resurslar avtomobil satıcıları, peşələr, HUD elementləri, freymvorklər və daha çox kimi xüsusiyyətlər əlavə edir.

Resursu Necə Quraşdırmaq Olar

1. Resursu mənbəyindən yükləyin (GitHub, Cfx.re forumları, Tebex və s.).
2. Lazım olduqda resurs qovluğunu ZIP/arxivdən çıxarın.
3. Resurs qovluğunu GPanel Files tabı və ya SFTP vasitəsilə serverinizin resources/ qovluğuna yükləyin.
4. server.cfg faylını açın və resurs üçün ensure sətri əlavə edin:

# Add your custom resources
ensure my-new-resource

5. Resursun yüklənməsi üçün serveri GPanel və ya TXAdmin vasitəsilə yenidən başladın.

Resurs Manifestləri

Hər etibarlı resurs manifest faylı ehtiva etməlidir. Müasir resurslar fxmanifest.lua, köhnə olanlar isə __resource.lua istifadə edir. Əgər yüklənmiş resurs qovluğunda bu fayllardan heç biri yoxdursa, resurs yüklənməyəcək. Bəzi yüklənmələr əsl resurs qovluğunu xarici qovluğun içinə yerləşdirir — resources/ qovluğuna yerləşdirdiyiniz qovluğun manifesti ehtiva edən qovluq olduğundan əmin olun.

Resurs Yükləmə Sırası

Resurslar server.cfg-dəki görünmə sırasına görə yüklənir. Əgər bir resurs digərindən asılıdırsa (məsələn, ESX və ya QBCore kimi freymvorkdan asılı olan peşə skripti), asılılığın ehtiyac duyan resursdan əvvəl siyahıda olduğundan əmin 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

Kateqoriya Qovluqları ilə Resursların Təşkili

resources/ qovluğu daxilində resursları alt qovluqlara təşkil edə bilərsiniz. Bütün kateqoriya qovluğunu yükləmək üçün server.cfg-də mötərizə notasiyası istifadə edin:

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

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

Bu, adlandırılmış alt qovluq daxilindəki hər resursu yükləyir. Hər birini ayrıca siyahılamadan əlaqəli skriptləri qruplaşdırmağın rahat yoludur.

TXAdmin vasitəsilə Resursların Canlı Yüklənməsi

Yeni resursu yükləmək üçün həmişə tam server yenidən başlatması tələb olunmur. TXAdmin Resources səhifəsindən ayrı-ayrı resursları başlada, dayandıra və yenidən başlada bilər. Yeni resursu yüklədikdən və ensure sətirini əlavə etdikdən sonra TXAdmin canlı konsolunda aşağıdakı əmri icra edə bilərsiniz:

refresh
ensure my-new-resource

refresh əmri serverə yeni girişlər üçün resources/ qovluğunu yenidən skan etməyi bildirir.

Verilənlər Bazası Quraşdırması (MySQL / MariaDB)

Bir çox FiveM freymvorkları və resursları (ESX, QBCore və ya vRP kimi) MySQL və ya MariaDB verilənlər bazası tələb edir. Legion Hosting serverinizlə birlikdə verilənlər bazası etimadnaməsini təmin edir.

Verilənlər Bazası Etimadnaməsinin Tapılması

1. GPanel-də Databases tabına keçin.
2. Əgər hələ verilənlər bazası yoxdursa, yaratmaq üçün New Database düyməsini basın.
3. Aşağıdakı məlumatları qeyd edin:
   • Verilənlər Bazası Hostu (ünvan və port)
   • Verilənlər Bazası Adı
   • İstifadəçi adı
   • Parol (görmək üçün göz ikonuna klikləyin)

Verilənlər Bazası Bağlantısının Konfiqurasiyası

Verilənlər bazası bağlantı məlumatları server.cfg-də bağlantı sətri vasitəsilə təyin edilir. Dəqiq format istifadə etdiyiniz MySQL resursundan asılıdır, lakin ən ümumi format budur:

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

Yer tutucuları Databases tabından əldə etdiyiniz real etimadnamə ilə əvəz edin. Məsələn:

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

MySQL Resursunun Seçilməsi

Hansı MySQL resursundan istifadə etsəniz, o, server.cfg-də ona asılı olan hər hansı resursdan əvvəl yüklənməlidir:

# 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

Freymvork Əsasları

Freymvork digər resursların üzərində qurulduğu əsas oyun sistemlərini təmin edir — oyunçu kimliyi, pul, inventar, peşələr və nəqliyyat vasitələri kimi şeylər. Ən populyar iki FiveM freymvorku bunlardır:

Əksər freymvorklər ilkin quraşdırma zamanı TXAdmin-in resept sistemi vasitəsilə quraşdırılır. Əgər TXAdmin quraşdırması zamanı "QBCore" və ya "ESX" kimi resept seçmisinizsə, freymvork və onun əsas asılılıqları artıq quraşdırılıb. Freymvorku əl ilə quraşdırmalısınızsa, rəsmi sənədlərinə müraciət edin:

• ESX Sənədləri
• QBCore Sənədləri

Kömək Almaq

Resurs quraşdırması və ya verilənlər bazası konfiqurasiyası ilə bağlı köməyə ehtiyacınız varsa:

1. Quraşdırma təlimatları və məlum problemlər üçün resursun sənədlərini və ya GitHub səhifəsini yoxlayın.
2. Xəta mesajları üçün GPanel konsolunu və ya TXAdmin jurnallarını nəzərdən keçirin.
3. https://legionhosting.net/submitticket.php ünvanında xəta mesajlarınız və quraşdırmağa çalışdığınız resursun adı ilə dəstək bileti açın.

Əlaqəli Məqalələr

• FiveM Server Quraşdırma Təlimatı
• FiveM Problemlərin Həlli
• SFTP vasitəsilə Fayl Yükləmə
• Server IP və Portunuzu Necə Tapmalı