Näin asennat ESX:n tai QBCoren FiveM-palvelimelle

ESX ja QBCore ovat ne kaksi frameworkia, joiden päälle lähes jokainen FiveM-roolipelipalvelin rakennetaan. Ne tuovat työt, rahan, inventaarion ja sen yhteisen datakerroksen johon skriptit kiinnittyvät. Tämä opas näyttää miten kumman tahansa niistä asentaa DoomHostingin FiveM-palvelimelle, mukaan lukien molempien tarvitseman MySQL-tietokannan ja oikean ensure-järjestyksen server.cfg-tiedostossa.

ESX vai QBCore: kumman frameworkin valitsen?

Molemmat ovat ilmaisia, avointa lähdekoodia ja MySQL-pohjaisia, joten valinta koskee sitä ekosysteemiä jonka päälle haluat rakentaa:

• ESX on vanhempi ja laajemmin käytetty framework. Sille on kirjoitettu enemmän kolmannen osapuolen töitä, skriptejä ja ohjeita, joten se on turvallisempi valinta jos aiot ostaa tai ladata paljon valmiita resursseja.
• QBCore on uudempi ja modulaarisempi, ja moni kehittäjä pitää sen koodia siistimpänä laajentaa. Jos tiimissäsi on skriptaaja tai haluat kirjoittaa paljon omaa logiikkaa, QBCore on siihen suosittu.

Molempia ei voi ajaa yhtä aikaa. Valitse toinen, rakenna palvelimesi sen ympärille ja pysy siinä. Kumman tahansa valitsetkin, alla olevat asennusvaiheet ovat samanmuotoiset: luo tietokanta, lataa framework, kytke se server.cfg-tiedostoon.

Ennen kuin aloitat: lisenssiavain ja tietokanta

Kahden asian on oltava kunnossa ennen kuin framework suostuu latautumaan.

Ensinnäkin palvelimesi tarvitsee kelvollisen CFX-lisenssiavaimen tai FXServer ei käynnisty lainkaan. Paneeli kysyy sitä ensimmäisellä kerralla kun painat Käynnistä. Jos et ole vielä asettanut sitä, seuraa ensin ohjetta näin hankit FiveM-lisenssiavaimen.

Toiseksi ESX ja QBCore tallentavat kaiken MySQL-tietokantaan. DoomHostingin FiveM-palvelimessasi sellainen on mukana. Avaa paneelin Tietokannat-välilehti ja klikkaa Uusi tietokanta. Paneeli luo tietokannan ja näyttää sinulle osoitteen, tietokannan nimen, käyttäjätunnuksen ja salasanan. Pidä tämä välilehti auki, tarvitset noita neljää arvoa hetken päästä.

Palvelimella ei ole phpMyAdminia, joten frameworkin SQL:n tuomiseksi otat yhteyden samaan osoitteeseen ilmaisella MySQL-clientilla omalta koneeltasi (HeidiSQL, DBeaver tai MySQL Workbench). Käytä Tietokannat-välilehden osoitetta, käyttäjätunnusta ja salasanaa, ja aja sitten frameworkin .sql-tiedosto tietokantaasi vasten.

Näin asennat ESX:n FiveM-palvelimelle

1. Lataa uusin ESX-julkaisu (es_extended-resurssi) ja oxmysql niiden virallisista GitHub-julkaisuista.

2. Avaa Tiedostot-välilehti, mene resources-kansioon ja lataa es_extended ja oxmysql sinne. Siellä jokainen resurssi asuu.

   

3. Tuo ESX:n SQL-tiedosto tietokantaasi MySQL-clientilläsi (edellinen kohta). Se luo users- ja jobs-taulut sekä muut taulut joita ESX odottaa.

4. Avaa server.cfg tiedostoeditorissa ja lisää tietokantayhteys sekä ensure-rivit. Järjestyksellä on väliä: oxmysql ja es_extended on ladattava ennen mitään niistä riippuvaa.

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure es_extended
   

   

5. Käynnistä palvelin uudelleen paneelista. Seuraa Console-välilehteä: sinun pitäisi nähdä oxmysql-yhteyden muodostuvan ja es_extended-resurssin käynnistyvän ilman punaisia virheitä.

Näin asennat QBCoren FiveM-palvelimelle

Vaiheet mukailevat ESX:ää:

1. Lataa QBCore-framework (qb-core) ja oxmysql virallisesta QBCoren GitHubista.

2. Lataa molemmat resources-kansioon Tiedostot-välilehden kautta.

3. Tuo QBCoren SQL-dump tietokantaasi MySQL-clientilläsi.

4. Aseta server.cfg-tiedostoon yhteysmerkkijono ja varmista että oxmysql on ennen qb-core-riviä:

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure qb-core
   

5. Käynnistä uudelleen ja tarkista konsolista että käynnistys menee puhtaasti läpi.

Missä järjestyksessä resurssit menevät server.cfg-tiedostoon?

Riippuvuudet ensin, niistä riippuvat perässä. Tietokantaa kutsuva resurssi tarvitsee oxmysql-resurssin jo käyntiin, ja työskripti tarvitsee frameworkin jo käyntiin. Turvallinen malli:

ensure oxmysql
ensure es_extended     # or qb-core
ensure your-inventory
ensure your-jobs
ensure your-other-scripts

Jos laitat työresurssin ensure-riville ennen frameworkia, se antaa virheen käynnistyksessä, koska frameworkin exportteja ei ole vielä olemassa.

Näin teet itsestäsi adminin

ESX:ssä admin-ryhmät määritetään tietokannassa tai oikeusresurssin kautta, ja frameworkin oma dokumentaatio kertoo tarkan taulun. QBCoressa lisäät license-tunnisteesi tiedostoon qb-core/shared/config.lua tai käytät pelinsisäisiä oikeuksia. Nopein tapa löytää tunnisteesi: liity palvelimelle kerran ja katso sitten Console-välilehteä, jossa FXServer tulostaa license:-tunnisteesi liittymisen yhteydessä. Kopioi arvo frameworkin admin-konfiguraatioon ja käynnistä uudelleen.

Yleiset virheet

• [oxmysql] failed to connect: mysql_connection_string on väärin. Kopioi osoite, tietokannan nimi, käyttäjätunnus ja salasana uudelleen Tietokannat-välilehdeltä. Tietokannan nimi on siellä näkyvä täysi sNNN_name, ei pelkkä lyhyt nimi jonka itse kirjoitit.
• Unable to load resource es_extended / qb-core: kansion nimi resources-kansiossa ei vastaa ensure-riviä, tai purit paketin yhtä tasoa liian syvälle (kansio kansion sisällä). Resurssikansion on sisällettävä fxmanifest.lua suoraan.
• Framework käynnistyy mutta tauluja ei ole: ohitit SQL-tuonnin tai toit sen eri tietokantaan. Aja frameworkin .sql uudelleen juuri siihen tietokantaan joka näkyy Tietokannat-välilehdellä.
• Kaikki latautuu mutta pelaajat spawnaavat ilman rahaa tai työtä: yleensä puuttuva riippuvuus (inventaario tai jokin esx_*-resurssi) tai väärä latausjärjestys. Lue konsoli ylhäältä alas, ensimmäinen punainen rivi on se oikea syy.

Seuraavat askeleet

Kun framework pyörii, alat lisätä sen päälle autoja, töitä ja skriptejä. Katso näin lisäät omia autoja ja skriptejä FiveM-palvelimelle, jossa käydään läpi resurssirakenne ja streamatut ajoneuvot. Jos haluat mieluummin selainkäyttöisen hallintapaneelin ja yhden klikkauksen recipe-asennukset, ota txAdmin käyttöön FiveM-palvelimellasi. Se osaa asentaa sinulle valmiin ESX- tai QBCore-pohjan.

Tarvitsetko ensin palvelimen? Katso FiveM-palvelimen vuokraus tai tutustu koko pelipaneeliin.