Ovaj vodič pokriva kako instalirati resurse (skripte) na svoj FiveM poslužitelj, postaviti MySQL bazu podataka za frameworke poput ESX ili QBCore te razumjeti redoslijed učitavanja resursa. Ako još niste završili početno postavljanje poslužitelja, najprije pogledajte Vodič za postavljanje FiveM poslužitelja.

Instalacija resursa i skripti

FiveM poslužitelji se proširuju resursima (također zvanim skripte). Resursi dodaju značajke poput prodavaonica automobila, poslova, HUD elemenata, frameworka i više.

Kako instalirati resurs

1. Preuzmite resurs s njegovog izvora (GitHub, Cfx.re forumi, Tebex, itd.).
2. Raspakirajte mapu resursa iz ZIP/arhive ako je potrebno.
3. Prenesite mapu resursa u direktorij resources/ svog poslužitelja koristeći GPanel karticu Files ili putem SFTP-a.
4. Otvorite server.cfg i dodajte ensure liniju za resurs:

# Add your custom resources
ensure my-new-resource

5. Ponovno pokrenite poslužitelj iz GPanel-a ili TXAdmin-a kako bi se resurs učitao.

Manifesti resursa

Svaki valjani resurs mora sadržavati datoteku manifesta. Moderni resursi koriste fxmanifest.lua, dok stariji koriste __resource.lua. Ako preuzeta mapa resursa ne sadrži nijednu od ovih datoteka, resurs se neće učitati. Neka preuzimanja ugnježđuju stvarnu mapu resursa unutar vanjske mape — provjerite da je mapa koju stavljate u resources/ ona koja sadrži manifest.

Redoslijed učitavanja resursa

Resursi se učitavaju redoslijedom kojim se pojavljuju u server.cfg. Ako resurs ovisi o drugom (na primjer, skripta za posao koja ovisi o frameworku poput ESX ili QBCore), osigurajte da je ovisnost navedena prije resursa koji ju treba:

# 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

Organiziranje resursa s kategorijskim mapama

Možete organizirati resurse u podmape unutar direktorija resources/. Koristite notaciju s uglatim zagradama u server.cfg za učitavanje cijele kategorijske mape:

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

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

Ovo učitava svaki resurs unutar imenovane podmape. To je praktičan način grupiranja povezanih skripti bez pojedinačnog navođenja svake.

Učitavanje resursa uživo putem TXAdmin-a

Ne trebate uvijek potpuno ponovno pokretanje poslužitelja za učitavanje novog resursa. TXAdmin može pokrenuti, zaustaviti i ponovno pokrenuti pojedinačne resurse sa svoje stranice Resources. Nakon prijenosa novog resursa i dodavanja njegove ensure linije, možete pokrenuti sljedeću naredbu u TXAdmin konzoli uživo:

refresh
ensure my-new-resource

Naredba refresh govori poslužitelju da ponovno pretraži direktorij resources/ za nove unose.

Postavljanje baze podataka (MySQL / MariaDB)

Mnogi FiveM frameworki i resursi (poput ESX, QBCore ili vRP) zahtijevaju MySQL ili MariaDB bazu podataka. Legion Hosting pruža vjerodajnice baze podataka uz vaš poslužitelj.

Pronalaženje vjerodajnica baze podataka

1. U GPanel-u, idite na karticu Databases.
2. Ako baza podataka još ne postoji, kliknite New Database za stvaranje nove.
3. Zabilježite sljedeće podatke:
   • Database Host (adresa i port)
   • Database Name
   • Username
   • Password (kliknite ikonu oka za prikaz)

Konfiguriranje veze s bazom podataka

Podaci za povezivanje s bazom podataka postavljaju se u server.cfg korištenjem connection stringa. Točan format ovisi o tome koji MySQL resurs koristite, ali najčešći format je:

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

Zamijenite rezervirana mjesta stvarnim vjerodajnicama iz kartice Databases. Na primjer:

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

Odabir MySQL resursa

Koji god MySQL resurs koristite, mora biti učitan u server.cfg prije bilo kojih resursa koji ovise o njemu:

# 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

Osnove frameworka

Framework pruža temeljne sustave igranja na kojima se grade drugi resursi — stvari poput identiteta igrača, novca, inventara, poslova i vozila. Dva najpopularnija FiveM frameworka su:

Većina frameworka instalira se putem TXAdmin-ovog sustava recepata tijekom početnog postavljanja. Ako ste odabrali recept poput "QBCore" ili "ESX" tijekom postavljanja TXAdmin-a, framework i njegove temeljne ovisnosti već su instalirani. Ako trebate ručno instalirati framework, slijedite njegovu službenu dokumentaciju:

• ESX dokumentacija
• QBCore dokumentacija

Pomoć

Ako trebate pomoć s instalacijom resursa ili konfiguracijom baze podataka:

1. Provjerite dokumentaciju resursa ili njegovu GitHub stranicu za upute za instalaciju i poznate probleme.
2. Pregledajte GPanel konzolu ili TXAdmin zapise za poruke o greškama.
3. Otvorite zahtjev za podršku na https://legionhosting.net/submitticket.php s porukama o greškama i nazivom resursa koji pokušavate instalirati.

Povezani članci

• Vodič za postavljanje FiveM poslužitelja
• FiveM rješavanje problema
• Kako prenijeti datoteke putem SFTP-a
• Kako pronaći IP adresu i port svog poslužitelja