See juhend käsitleb, kuidas paigaldada ressursse (skripte) oma FiveM serverisse, seadistada MySQL andmebaasi raamistike nagu ESX või QBCore jaoks ning mõista ressursside laadimise järjekorda. Kui sa pole veel algset serveri seadistamist lõpetanud, alusta esmalt FiveM serveri seadistamise juhendiga.

Ressursside ja skriptide paigaldamine

FiveM servereid laiendatakse ressurssidega (nimetatakse ka skriptideks). Ressursid lisavad funktsioone nagu autokauplused, töökohad, HUD-i elemendid, raamistikud ja palju muud.

Kuidas ressurssi paigaldada

1. Laadi ressurss alla selle allikast (GitHub, Cfx.re foorum, Tebex jne).
2. Paki ressursi kaust vajadusel ZIP-/arhiivifailist välja.
3. Laadi ressursi kaust üles oma serveri resources/ kataloogi, kasutades GPanel-i Files vahekaarti või SFTP-d.
4. Ava server.cfg ja lisa ressursile rida ensure:

# Add your custom resources
ensure my-new-resource

5. Taaskäivita server GPanel-ist või TXAdmin-ist, et ressurss laaditaks.

Ressursi manifestid

Iga kehtiv ressurss peab sisaldama manifesti faili. Kaasaegsed ressursid kasutavad fxmanifest.lua, vanemad aga __resource.lua. Kui allalaaditud ressursi kaust ei sisalda kumbagi neist failidest, siis ressurss ei laadi. Mõned allalaadimised pesastavad tegeliku ressursi kausta välimise kausta sisse — veendu, et kaust, mille paigutad resources/ kataloogi, on see, mis sisaldab manifesti.

Ressursside laadimise järjekord

Ressursid laetakse järjekorras, nagu need esinevad server.cfg failis. Kui ressurss sõltub teisest (näiteks tööskript, mis sõltub raamistikust nagu ESX või QBCore), veendu, et sõltuvus on loetletud enne ressurssi, mis seda vajab:

# 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

Ressursside organiseerimine kategooria kaustadega

Saad ressursse organiseerida alamkaustadesse resources/ kataloogis. Kasuta sulgude süntaksit server.cfg failis, et tagada terve kategooria kaust:

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

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

See laadib kõik ressursid nimetatud alamkaustast. See on mugav viis seotud skripte grupeerida ilma igaüht eraldi loetlemata.

Ressursside kuum-laadimine TXAdmin-i kaudu

Sa ei pea alati uue ressursi laadimiseks serverit täielikult taaskäivitama. TXAdmin saab käivitada, peatada ja taaskäivitada üksikuid ressursse oma Resources lehelt. Pärast uue ressursi üleslaadimist ja selle ensure rea lisamist saad TXAdmin-i reaalajas konsoolis käivitada järgmise käsu:

refresh
ensure my-new-resource

Käsk refresh ütleb serverile, et see skanniks resources/ kataloogi uute kirjete leidmiseks uuesti.

Andmebaasi seadistamine (MySQL / MariaDB)

Paljud FiveM raamistikud ja ressursid (nagu ESX, QBCore või vRP) vajavad MySQL-i või MariaDB andmebaasi. Legion Hosting pakub andmebaasi mandaate koos sinu serveriga.

Oma andmebaasi mandaatide leidmine

1. GPanel-is mine Databases vahekaardile.
2. Kui andmebaasi veel pole, klõpsa New Database, et see luua.
3. Pane kirja järgmised andmed:
   • Andmebaasi host (aadress ja port)
   • Andmebaasi nimi
   • Kasutajanimi
   • Parool (klõpsa silma ikoonil selle kuvamiseks)

Andmebaasi ühenduse konfigureerimine

Andmebaasi ühenduse andmed määratakse server.cfg failis ühenduse stringi abil. Täpne vorming sõltub sellest, millist MySQL ressurssi sa kasutad, kuid kõige levinum vorming on:

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

Asenda kohahoidjad oma tegelike mandaatidega Databases vahekaardilt. Näiteks:

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

MySQL ressursi valimine

Ükskõik millist MySQL ressurssi sa kasutad, see peab olema tagatud server.cfg failis enne mis tahes ressursse, mis sellest sõltuvad:

# 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

Raamistiku põhitõed

Raamistik pakub põhilisi mängusüsteeme, millele teised ressursid tuginevad — sellised asjad nagu mängija identiteet, raha, inventar, töökohad ja sõidukid. Kaks kõige populaarsemat FiveM raamistikku on:

Enamik raamistikke paigaldatakse TXAdmin-i retseptisüsteemi kaudu algse seadistuse käigus. Kui valisid TXAdmin-i seadistuse ajal retsepti nagu "QBCore" või "ESX", on raamistik ja selle põhilised sõltuvused juba paigaldatud. Kui pead raamistiku käsitsi paigaldama, järgi selle ametlikku dokumentatsiooni:

• ESX dokumentatsioon
• QBCore dokumentatsioon

Abi saamine

Kui vajad abi ressursside paigaldamise või andmebaasi konfigureerimisega:

1. Kontrolli ressursi dokumentatsiooni või GitHub-i lehte paigaldusjuhiste ja teadaolevate probleemide osas.
2. Vaata üle GPanel-i konsool või TXAdmin-i logid veateadete osas.
3. Ava tugiteenuse pilet aadressil https://legionhosting.net/submitticket.php, lisades oma veateated ja ressursi nime, mida üritad paigaldada.

Seotud artiklid

• FiveM serveri seadistamise juhend
• FiveM tõrkeotsing
• Kuidas laadida faile üles SFTP kaudu
• Kuidas leida oma serveri IP-d ja porti