Ovaj vodič objašnjava kako da instalirate resurse (skripte) na svoj FiveM server, podesite MySQL bazu podataka za framework-e poput ESX-a ili QBCore-a i razumete redosled učitavanja resursa. Ako još niste završili početno podešavanje servera, prvo počnite sa Vodičem za podešavanje FiveM servera.
server.cfg. Pogledajte Vodič za podešavanje FiveM servera za korake početnog podešavanja.
Instalacija resursa i skripti
FiveM serveri se proširuju pomoću resursa (koji se nazivaju i skripte). Resursi dodaju funkcije poput prodavaca automobila, poslova, HUD elemenata, framework-a i još mnogo toga.
Kako instalirati resurs
- Preuzmite resurs sa njegovog izvora (GitHub, Cfx.re forumi, Tebex, itd.).
- Raspakujte folder resursa iz ZIP-a/arhive ako je potrebno.
- Otpremite folder resursa u
resources/direktorijum svog servera koristeći GPanel karticu Files ili putem SFTP-a. - Otvorite
server.cfgi dodajteensurered za resurs:
# Add your custom resources
ensure my-new-resource
- Ponovo pokrenite server iz GPanel ili TXAdmin-a da bi se resurs učitao.
ensure redu mora se tačno podudarati sa imenom foldera resursa (razlikuje velika i mala slova). Ako je folder my-cars, red mora biti ensure my-cars.
Manifesti resursa
Svaki važeći resurs mora sadržati manifest datoteku. Moderni resursi koriste fxmanifest.lua, dok stariji koriste __resource.lua. Ako preuzeti folder resursa ne sadrži nijednu od ovih datoteka, resurs se neće učitati. Neka preuzimanja smeštaju stvarni folder resursa unutar spoljnog foldera — uverite se da je folder koji stavljate u resources/ onaj koji sadrži manifest.
Redosled učitavanja resursa
Resursi se učitavaju redosledom kojim se pojavljuju u server.cfg. Ako resurs zavisi od drugog (na primer, skripta za posao koja zavisi od framework-a poput ESX-a ili QBCore-a), uverite se da je zavisnost navedena pre resursa koji je zahteva:
# 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
Organizovanje resursa pomoću foldera kategorija
Resurse možete organizovati u podfoldere unutar resources/ direktorijuma. Koristite notaciju sa zagradama u server.cfg da biste osigurali ceo folder kategorije:
# Ensure all resources inside resources/[esx]/
ensure [esx]
# Ensure all resources inside resources/[standalone]/
ensure [standalone]
Ovo učitava svaki resurs unutar imenovanog podfoldera. To je zgodan način da grupišete povezane skripte bez navođenja svake pojedinačno.
Učitavanje resursa u toku rada putem TXAdmin-a
Nije vam uvek potrebno potpuno ponovno pokretanje servera da biste učitali novi resurs. TXAdmin može pokrenuti, zaustaviti i ponovo pokrenuti pojedinačne resurse sa svoje Resources stranice. Nakon otpremanja novog resursa i dodavanja njegovog ensure reda, možete pokrenuti sledeću komandu u TXAdmin live konzoli:
refresh
ensure my-new-resource
Komanda refresh nalaže serveru da ponovo skenira resources/ direktorijum za nove stavke.
Podešavanje baze podataka (MySQL / MariaDB)
Mnogi FiveM framework-i i resursi (poput ESX-a, QBCore-a ili vRP-a) zahtevaju MySQL ili MariaDB bazu podataka. Legion Hosting obezbeđuje akreditive baze podataka uz vaš server.
Pronalaženje akreditiva baze podataka
- U GPanel, idite na karticu Databases.
- Ako baza podataka još ne postoji, kliknite na New Database da biste je kreirali.
- Zabeležite sledeće detalje:
- Database Host (adresa i port)
- Database Name
- Username
- Password (kliknite na ikonu oka da biste je otkrili)
Konfigurisanje veze sa bazom podataka
Detalji veze sa bazom podataka se postavljaju u server.cfg pomoću connection string-a. Tačan format zavisi od toga 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"
Zamenite čuvare mesta svojim stvarnim akreditivima sa kartice Databases. Na primer:
set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"
localhost ili 127.0.0.1.
@, # ili %, morate ih URL-enkodirati u connection string-u. Na primer, @ postaje %40, a # postaje %23.
Izbor MySQL resursa
| Resurs | Status | Napomene |
|---|---|---|
| oxmysql | Preporučeno | Moderan, aktivno održavan, najbolje performanse. Koristi ga većina aktuelnih framework-a. |
| mysql-async | Zastareo | Stariji, ali i dalje radi. Neke starije skripte zavise specifično od njega. |
| ghmattimysql | Zastareo | Još jedna starija opcija. Proverite dokumentaciju svog framework-a ako zahteva ovo. |
Koji god MySQL resurs koristite, mora biti osiguran u server.cfg pre bilo kojih resursa koji zavise od njega:
# 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 framework-a
Framework obezbeđuje osnovne sisteme igranja na kojima se grade drugi resursi — stvari poput identiteta igrača, novca, inventara, poslova i vozila. Dva najpopularnija FiveM framework-a su:
| Framework | Ime resursa | Opis |
|---|---|---|
| ESX | es_extended |
Najšire korišćen framework. Veliki ekosistem besplatnih i plaćenih skripti. Pogodan za roleplay servere. |
| QBCore | qb-core |
Moderna alternativa ESX-u. Čistiji kod, aktivan razvoj. Rastući ekosistem skripti. |
Većina framework-a se instalira putem TXAdmin recipe sistema tokom početnog podešavanja. Ako ste izabrali recipe poput „QBCore" ili „ESX" tokom TXAdmin podešavanja, framework i njegove osnovne zavisnosti su već instalirani. Ako treba da ručno instalirate framework, pratite njegovu zvaničnu dokumentaciju:
Dobijanje pomoći
Ako vam je potrebna pomoć pri instalaciji resursa ili konfiguraciji baze podataka:
- Proverite dokumentaciju resursa ili njegovu GitHub stranicu za uputstva za instalaciju i poznate probleme.
- Pregledajte GPanel konzolu ili TXAdmin logove za poruke o greškama.
- Otvorite tiket podrške na https://legionhosting.net/submitticket.php sa svojim porukama o greškama i imenom resursa koji pokušavate da instalirate.