Näin lisäät omia autoja ja skriptejä FiveM-palvelimelle

Jokainen FiveM-palvelin on oikeastaan pino resourceja: skriptejä, autoja, karttoja ja työpaikkoja, jotka kukin asuvat omassa kansiossaan ja kytketään päälle server.cfg-tiedostossa. Tässä oppaassa käydään läpi, miten resourcet on rakennettu, miten skripti asennetaan oikein ja miten lisäät streamattuja ajoneuvolisäyksiä DoomHostingin FiveM-palvelimelle rikkomatta käynnistysjärjestystä.

Minne resourcet menevät FiveM-palvelimella?

Kaikki on yhdessä paikassa: resources-kansiossa. Avaa paneelin Tiedostot-välilehti ja mene resources-kansioon. Jokainen skripti, auto tai kartta on oma alikansionsa, jonka sisällä on fxmanifest.lua.

Hakasulkeisiin kääritty kansio, kuten [cars] tai [esx], on pelkkä ryhmittelykansio. FiveM lataa automaattisesti jokaisen hakasulkekansion sisällä olevan resourcen, mikä on siisti tapa pitää kaikki ajoneuvot tai kaikki framework-resourcet yhdessä. Hakasulkekansio ei voi sisältää toista hakasulkekansiota, eikä siinä pitäisi olla irrallisia tiedostoja, vain resource-alikansioita.

Miten asennan skriptin FiveM-palvelimelle?

1. Lataa skripti. Laadukkaat resourcet löytyvät Cfx.re:n virallisen foorumin julkaisuista ja tunnettujen kehittäjien GitHub-repositorioista.

2. Avaa Tiedostot-välilehdellä resources-kansio ja lataa skriptin kansio sinne. Isot lataukset kannattaa tehdä SFTP:llä (tiedot löytyvät Tiedostot-välilehden SFTP-painikkeesta) selainlatauksen sijaan.

3. Lue skriptin oma README riippuvuuksien varalta. Useimmat skriptit tarvitsevat frameworkin (es_extended tai qb-core) ja usein myös valmiiksi käynnissä olevan oxmysql:n.

4. Lisää ensure-rivi server.cfg-tiedostoon riippuvuuksiensa jälkeen:

   ensure oxmysql
   ensure es_extended
   ensure your-new-script
   

   

5. Käynnistä palvelin uudelleen ja seuraa Console-välilehdeltä, että käynnistys menee puhtaasti läpi ilman punaisia virheitä.

Kannattaako server.cfg-tiedostossa käyttää komentoa start vai ensure?

Käytä komentoa ensure. Se käynnistää resourcen, jos se on pysäytettynä, ja käynnistää sen uudelleen, jos se on jo käynnissä. Juuri sitä käynnistyksessä halutaan. start ainoastaan käynnistää resourcen ja on vanhempaa syntaksia. Näiden sekoittamiseen ei ole mitään syytä, joten tee jokaisesta asetustiedostosi rivistä ensure.

Miten lisään oman auton FiveM-palvelimelle?

Lisäajoneuvot ovat "streamattuja" resourceja: mallitiedostot streamataan pelaajille, kun he liittyvät. Kansiorakenne on se, millä on merkitystä.

1. Luo autolle resource-kansio (tai pudota se [cars]-ryhmäkansioosi), esimerkiksi resources/[cars]/police_charger.

2. Laita sen sisällä ajoneuvon mallitiedostot (.yft, .ytd) stream-alikansioon ja metatiedostot (vehicles.meta, carvariations.meta, handling.meta ja niin edelleen) fxmanifest.lua-tiedoston viereen:

   police_charger/
     fxmanifest.lua
     stream/
       police_charger.yft
       police_charger.ytd
     vehicles.meta
     carvariations.meta
     handling.meta
   

3. fxmanifest.lua kertoo FiveM:lle, että malli streamataan ja metatiedostot ladataan:

   fx_version 'cerulean'
   game 'gta5'
   
   files {
     'vehicles.meta',
     'carvariations.meta',
     'handling.meta'
   }
   
   data_file 'VEHICLE_METADATA_FILE' 'vehicles.meta'
   data_file 'CARCOLS_FILE' 'carvariations.meta'
   data_file 'HANDLING_FILE' 'handling.meta'
   

4. Lisää ensure police_charger server.cfg-tiedostoon, käynnistä uudelleen, ja vehicles.meta-tiedoston spawn-nimi toimii nyt pelissä.

Useimmat ladattavat autot sisältävät jo toimivan fxmanifest.lua-tiedoston ja oikeat kansiot, joten käytännössä lataat kansion palvelimelle ja lisäät yhden ensure-rivin. Rakenna rakenne käsin vain, jos auto tuli irrallisina tiedostoina.

Pitääkö FiveM-artifactin tai gamebuildin täsmätä?

Joskus. Kaksi versioasetusta vaikuttaa siihen, latautuuko resource:

• Artifact (palvelimen versio): asetetaan paneelin Käynnistys-välilehden fivem version -muuttujalla. Jätä se arvoon recommended, ellei jokin skripti vaadi uudempaa buildia.
• Gamebuild: osa uudemmista ajoneuvoista ja MLO:ista vaatii tietyn pelibuildin. Aseta se server.cfg-tiedostossa, esimerkiksi sv_enforceGameBuild 2802. Jos auto tai kartta on näkymätön tai kaataa pelaajat spawnissa, syynä on usein väärä gamebuild.

Nosta näitä vain, kun jokin resource nimenomaan pyytää sitä. Resourcejesi tukemaa korkeamman gamebuildin pakottaminen aiheuttaa helposti enemmän ongelmia kuin ratkaisee.

Yleisimmät virheet

• Resource ei käynnisty: kansion nimen on vastattava ensure-riviä täsmälleen, ja fxmanifest.lua-tiedoston on oltava suoraan resource-kansion sisällä, ei tasoa syvemmällä. Kansio kansion sisällä on syy numero yksi.
• Failed to load streamatulle mallille: mallitiedostot eivät ole stream-kansiossa, tai .yft- ja .ytd-nimet eivät vastaa sitä, mihin metatiedostot viittaavat.
• Puuttuva riippuvuus: konsoli nimeää puuttuvan exportin tai resourcen. Lisää sen ensure-rivi kaatuvan resourcen yläpuolelle.
• Auto spawnaa, mutta ajaa väärin tai on näkymätön: puuttuva tai yhteensopimaton handling.meta tai vehicles.meta, tai gamebuild-ristiriita.

Sananen siitä, mistä resourceja kannattaa ladata

Pysy Cfx.re:n virallisella julkaisufoorumilla ja alkuperäisten kehittäjien GitHub-sivuilla. Vuodetut tai "ilmaiset" kopiot maksullisista resourceista ovat yleisin tapa, jolla FiveM-palvelimiin päätyy takaovi, joka voi varastaa tietokantasi tai kaapata palvelimesi. Jos resource on obfuskoitu tai tulee satunnaisesta Discordista, älä aja sitä.

Seuraavat askeleet

Jos haluat kytkeä autot ja skriptit täyteen roleplay-pohjaan, asenna ensin ESX tai QBCore FiveM-palvelimellesi. Jos kaipaat verkkonäkymää resourcejen ja uudelleenkäynnistysten hallintaan, ota txAdmin käyttöön FiveM-palvelimellasi.

Uusi täällä? Katso FiveM-palvelimet tai koko pelipalvelimien hallintapaneeli.