Tämä opas käsittelee resurssien (skriptien) asentamista FiveM-palvelimellesi, MySQL-tietokannan määrittämistä ESX:n tai QBCoren kaltaisille kehyksille sekä resurssien latausjärjestyksen ymmärtämistä. Jos et ole vielä suorittanut palvelimen alkuasennusta, aloita ensin FiveM-palvelimen asennusoppaasta.

Resurssien ja skriptien asentaminen

FiveM-palvelimia laajennetaan resursseilla (joita kutsutaan myös skripteiksi). Resurssit lisäävät ominaisuuksia kuten autokauppoja, työpaikkoja, HUD-elementtejä, kehyksiä ja paljon muuta.

Kuinka asentaa resurssi

1. Lataa resurssi sen lähteestä (GitHub, Cfx.re-foorumit, Tebex jne.).
2. Pura resurssikansio ZIP-tiedostosta/arkistosta tarvittaessa.
3. Lähetä resurssikansio palvelimesi resources/-hakemistoon käyttämällä GPanelin Files-välilehteä tai SFTP:n kautta.
4. Avaa server.cfg ja lisää ensure-rivi resurssille:

# Add your custom resources
ensure my-new-resource

5. Käynnistä palvelin uudelleen GPanelista tai TXAdminista, jotta resurssi latautuu.

Resurssimanifestit

Jokaisen kelvollisen resurssin on sisällettävä manifestitiedosto. Modernit resurssit käyttävät fxmanifest.lua-tiedostoa, kun taas vanhemmat käyttävät __resource.lua-tiedostoa. Jos ladattu resurssikansio ei sisällä kumpaakaan näistä tiedostoista, resurssi ei lataudu. Jotkin lataukset upottavat varsinaisen resurssikansion ulomman kansion sisään — varmista, että resources/-kansioon sijoittamasi kansio on se, joka sisältää manifestin.

Resurssien latausjärjestys

Resurssit ladataan siinä järjestyksessä, jossa ne näkyvät server.cfg-tiedostossa. Jos resurssi riippuu toisesta (esimerkiksi työskripti, joka riippuu kehyksestä kuten ESX tai QBCore), varmista, että riippuvuus on listattu ennen sitä tarvitsevaa resurssia:

# 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

Resurssien organisointi kategoriakansioilla

Voit organisoida resursseja alikansioihin resources/-hakemiston sisällä. Käytä hakasulkumerkintää server.cfg-tiedostossa varmistaaksesi koko kategoriakansion:

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

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

Tämä lataa jokaisen resurssin nimetyn alikansion sisällä. Se on kätevä tapa ryhmittää toisiinsa liittyviä skriptejä luettelematta jokaista erikseen.

Resurssien hot-lataus TXAdminin kautta

Et tarvitse aina täydellistä palvelimen uudelleenkäynnistystä uuden resurssin lataamiseksi. TXAdmin voi käynnistää, pysäyttää ja käynnistää uudelleen yksittäisiä resursseja Resources-sivultaan. Uuden resurssin lähettämisen ja sen ensure-rivin lisäämisen jälkeen voit suorittaa seuraavan komennon TXAdminin live-konsolissa:

refresh
ensure my-new-resource

refresh-komento käskee palvelinta skannaamaan uudelleen resources/-hakemiston uusien merkintöjen varalta.

Tietokannan asennus (MySQL / MariaDB)

Monet FiveM-kehykset ja resurssit (kuten ESX, QBCore tai vRP) vaativat MySQL- tai MariaDB-tietokannan. Legion Hosting tarjoaa tietokannan tunnukset palvelimesi mukana.

Tietokannan tunnusten löytäminen

1. Siirry GPanelissa Databases-välilehdelle.
2. Jos tietokantaa ei ole vielä olemassa, klikkaa New Database luodaksesi sellaisen.
3. Kirjaa seuraavat tiedot:
   • Database Host (osoite ja portti)
   • Database Name
   • Username
   • Password (klikkaa silmäkuvaketta paljastaaksesi sen)

Tietokantayhteyden määrittäminen

Tietokantayhteyden tiedot asetetaan server.cfg-tiedostossa käyttämällä yhteysmerkkijonoa. Tarkka muoto riippuu siitä, mitä MySQL-resurssia käytät, mutta yleisin muoto on:

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

Korvaa paikkamerkit todellisilla tunnuksillasi Databases-välilehdeltä. Esimerkiksi:

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

MySQL-resurssin valitseminen

Käytitpä mitä tahansa MySQL-resurssia, se on varmistettava server.cfg-tiedostossa ennen siitä riippuvia resursseja:

# 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

Kehyksen perusteet

Kehys tarjoaa ydinpeli järjestelmät, joiden päälle muut resurssit rakentuvat — asioita kuten pelaajan identiteetti, raha, inventaario, työpaikat ja ajoneuvot. Kaksi suosituinta FiveM-kehystä ovat:

Useimmat kehykset asennetaan TXAdminin reseptisysteemin kautta alkuasennuksen aikana. Jos valitsit reseptin kuten "QBCore" tai "ESX" TXAdmin-asennuksen aikana, kehys ja sen ydinriippuvuudet on jo asennettu. Jos sinun täytyy asentaa kehys manuaalisesti, seuraa sen virallista dokumentaatiota:

• ESX-dokumentaatio
• QBCore-dokumentaatio

Avun saaminen

Jos tarvitset apua resurssin asennuksessa tai tietokannan määrityksessä:

1. Tarkista resurssin dokumentaatio tai GitHub-sivu asennusohjeita ja tunnettuja ongelmia varten.
2. Tarkastele GPanel-konsolia tai TXAdmin-lokeja virheilmoituksia varten.
3. Avaa tukipyyntö osoitteessa https://legionhosting.net/submitticket.php ja sisällytä virheilmoituksesi ja sen resurssin nimi, jota yrität asentaa.

Aiheeseen liittyvät artikkelit

• FiveM-palvelimen asennusopas
• FiveM-vianmääritys
• Kuinka lähettää tiedostoja SFTP:n kautta
• Kuinka löytää palvelimesi IP-osoite ja portti