Acest ghid acoperă modul de instalare a resurselor (scripturilor) pe serverul dvs. FiveM, configurarea unei baze de date MySQL pentru framework-uri precum ESX sau QBCore și înțelegerea ordinii de încărcare a resurselor. Dacă nu ați finalizat încă configurarea inițială a serverului, începeți mai întâi cu Ghidul de configurare a serverului FiveM.

Instalarea resurselor și a scripturilor

Serverele FiveM sunt extinse cu resurse (numite și scripturi). Resursele adaugă funcții precum dealeri auto, locuri de muncă, elemente HUD, framework-uri și multe altele.

Cum să instalați o resursă

1. Descărcați resursa de la sursa sa (GitHub, forumurile Cfx.re, Tebex etc.).
2. Extrageți folderul resursei din arhiva ZIP, dacă este necesar.
3. Încărcați folderul resursei în directorul resources/ al serverului dvs. folosind fila Files din GPanel sau prin SFTP.
4. Deschideți server.cfg și adăugați o linie ensure pentru resursă:

# Add your custom resources
ensure my-new-resource

5. Reporniți serverul din GPanel sau TXAdmin pentru ca resursa să se încarce.

Manifestele resurselor

Fiecare resursă validă trebuie să conțină un fișier manifest. Resursele moderne folosesc fxmanifest.lua, în timp ce cele mai vechi folosesc __resource.lua. Dacă un folder de resursă descărcat nu conține niciunul dintre aceste fișiere, resursa nu se va încărca. Unele descărcări încadrează folderul real al resursei într-un folder exterior — asigurați-vă că folderul pe care îl plasați în resources/ este cel care conține manifestul.

Ordinea de încărcare a resurselor

Resursele se încarcă în ordinea în care apar în server.cfg. Dacă o resursă depinde de alta (de exemplu, un script de job care depinde de un framework precum ESX sau QBCore), asigurați-vă că dependența este listată înainte de resursa care are nevoie de ea:

# 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

Organizarea resurselor cu foldere de categorii

Puteți organiza resursele în subfoldere în interiorul directorului resources/. Folosiți notația cu paranteze drepte în server.cfg pentru a asigura un întreg folder de categorie:

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

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

Aceasta încarcă fiecare resursă din subfolderul numit. Este o modalitate convenabilă de a grupa scripturi conexe fără a le lista individual pe fiecare.

Încărcarea la cald a resurselor prin TXAdmin

Nu aveți întotdeauna nevoie de o repornire completă a serverului pentru a încărca o resursă nouă. TXAdmin poate porni, opri și reporni resurse individuale din pagina sa Resources. După încărcarea unei resurse noi și adăugarea liniei sale ensure, puteți rula următoarea comandă în consola live TXAdmin:

refresh
ensure my-new-resource

Comanda refresh îi spune serverului să rescaneze directorul resources/ pentru intrări noi.

Configurarea bazei de date (MySQL / MariaDB)

Multe framework-uri și resurse FiveM (cum ar fi ESX, QBCore sau vRP) necesită o bază de date MySQL sau MariaDB. Legion Hosting oferă acreditări pentru baza de date împreună cu serverul dvs.

Găsirea acreditărilor bazei de date

1. În GPanel, accesați fila Databases.
2. Dacă nu există încă nicio bază de date, faceți clic pe New Database pentru a crea una.
3. Notați următoarele detalii:
   • Database Host (adresă și port)
   • Database Name
   • Username
   • Password (faceți clic pe pictograma ochi pentru a o dezvălui)

Configurarea conexiunii la baza de date

Detaliile conexiunii la baza de date sunt setate în server.cfg folosind un șir de conexiune. Formatul exact depinde de resursa MySQL pe care o utilizați, dar cel mai comun format este:

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

Înlocuiți substituenții cu acreditările dvs. reale din fila Databases. De exemplu:

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

Alegerea unei resurse MySQL

Indiferent de resursa MySQL pe care o utilizați, aceasta trebuie asigurată în server.cfg înainte de orice resurse care depind de ea:

# 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

Noțiuni de bază despre framework

Un framework oferă sistemele de joc de bază pe care se construiesc alte resurse — lucruri precum identitatea jucătorului, banii, inventarul, locurile de muncă și vehiculele. Cele mai populare două framework-uri FiveM sunt:

Majoritatea framework-urilor sunt instalate prin sistemul de rețete al TXAdmin în timpul configurării inițiale. Dacă ați ales o rețetă precum „QBCore” sau „ESX” în timpul configurării TXAdmin, framework-ul și dependențele sale de bază sunt deja instalate. Dacă trebuie să instalați un framework manual, urmați documentația sa oficială:

• Documentația ESX
• Documentația QBCore

Obținerea de ajutor

Dacă aveți nevoie de asistență pentru instalarea resurselor sau configurarea bazei de date:

1. Verificați documentația resursei sau pagina sa de GitHub pentru instrucțiuni de instalare și probleme cunoscute.
2. Examinați consola GPanel sau jurnalele TXAdmin pentru mesaje de eroare.
3. Deschideți un tichet de suport la https://legionhosting.net/submitticket.php cu mesajele dvs. de eroare și numele resursei pe care încercați să o instalați.

Articole conexe

• Ghidul de configurare a serverului FiveM
• Depanarea FiveM
• Cum să încărcați fișiere prin SFTP
• Cum să găsiți IP-ul și portul serverului dvs.