Näin otat FiveM Enhanced -palvelimen käyttöön

FiveM Enhanced on Cfx.re:n early access -versio FiveM:stä GTA V Enhancedille, pelin uudelle PC-painokselle, ja tämä opas vie uuden FiveM Enhanced -palvelimen DoomHostingissa ensimmäisestä käynnistyksestä toimivaan kokoonpanoon. Valitse Enhanced, kun yhteisösi pelaa jo GTA V Enhancedia ja skriptisi ovat avointa lähdekoodia. Pysy FiveM Legacyssa, jos käytät escrow-suojattuja resursseja tai pelaajat omistavat vanhemman painoksen, sillä versiot eivät jaa pelaajia keskenään.

Enhanced vai Legacy: kumpi sopii sinulle?

Enhanced ja Legacy ovat erillisiä tuotteita, joilla on omat clientinsa ja omat palvelinohjelmistonsa. Enhanced-palvelimelle pääsee vain FiveM for GTAV Enhanced -clientilla ja Legacy-palvelimelle vain perinteisellä clientilla. Ennen päätöstä huomioi nämä early accessin rajoitukset:

• Asset Escrow puuttuu vielä. Tebexin kautta ostetut salatut resurssit eivät lataudu Enhancedissa. Avoimen lähdekoodin resurssit toimivat normaalisti.
• OneSync on aina päällä big-tilassa, ja client-server-synkronointi korvaa vanhan peer-to-peer-mallin.
• Pure mode on aina päällä, joten grafiikkamodeja ei voi käyttää early accessin aikana.
• Vain uusin gamebuild on tuettu.

Jos tämä sopii projektiisi, tilaa FiveM Enhanced -palvelin. Hinta on sama kuin Legacyssa, ja kaikki alla oleva tehdään pelipaneelissamme.

Ensimmäinen käynnistys: lisää lisenssiavain

Enhanced tarvitsee saman ilmaisen Cfx.re-lisenssiavaimen kuin Legacy. Jos sinulla ei vielä ole avainta, lisenssiavainoppaassamme kerrotaan, miten se luodaan portal.cfx.re-sivustolla.

Paina uudella palvelimellasi Start. Koska avainta ei ole vielä tallennettu, avautuu ikkuna nimeltä Add your FiveM license key. Liitä avain (se alkaa merkeillä cfxk_ ja on 33 merkkiä pitkä) ja paina Save and start. Paneeli tallentaa avaimen ja käynnistää palvelimen samalla kertaa.

Startup-välilehden asetukset

Startup-välilehdellä ovat arvot, jotka palvelin lukee käynnistyessään:

• fivem license: juuri tallentamasi avain. Vaihda se tähän, jos luot avaimen uudelleen.
• Max Players: kuinka monta pelaajapaikkaa palvelin tarjoaa.
• Server Hostname: nimi, joka näkyy FiveM:n palvelinlistassa.
• Steam Web Api Key: jätä arvoksi none, ellei jokin resurssisi hae pelaajia Steamista.
• Enable txadmin: kytkee txAdminin päälle tai pois.
• txAdmin Port: vain luku. Paneeli määrittää tämän toisen portin automaattisesti txAdminin verkkokäyttöliittymää varten.

Tämän välilehden muutokset tulevat voimaan seuraavan uudelleenkäynnistyksen jälkeen.

txAdmin päälle vai pois

Oletuksena palvelin käynnistyy suoraan tiedostosta server.cfg. Paina otsikkopalkin Enable txAdmin -painiketta (tai käytä Startup-välilehden kytkintä) ja käynnistä uudelleen, jolloin txAdmin ottaa ohjat: server.cfg ei enää suoritu, ja asetuksia hallitaan txAdminin verkkokäyttöliittymässä. Ensimmäisen käynnistyksen PIN, reseptit ja ajastetut uudelleenkäynnistykset toimivat kuten Legacyssa, joten niistä kerrotaan txAdmin-oppaassamme.

Network-välilehti näyttää molemmat portit. Ensimmäinen on peliportti, johon pelaajat yhdistävät, ja txAdmin-merkillä varustettu portti on verkkokäyttöliittymää varten.

Config-välilehti ja server.cfg

Kun txAdmin on pois päältä, Config-välilehdellä voit muokata palvelimen listaustietoja avaamatta tiedostoa: Project name, Project description, Tags, Locale ja Allow ScriptHook. Palvelimen nimi ja pelaajapaikat puuttuvat tältä välilehdeltä tarkoituksella. Molemmat tulevat Startup-välilehdeltä ja kirjoitetaan tiedostoon server.cfg jokaisessa käynnistyksessä, joten käsin tehty muutos ylikirjoitettaisiin.

Kaikki muut asetukset ovat palvelimen juuressa olevassa tiedostossa server.cfg, jonka avaat Files-välilehdeltä. Tiedostonhallinnassa näkyy myös alpine-kansio, jossa cfx-server-ohjelma sijaitsee (Legacyn vastine on FXServer), sekä resources, johon skriptisi ja karttasi kuuluvat.

Dataa tallentavat skriptit tarvitsevat MySQL-tietokannan. Luo sellainen Databases-välilehdellä ja yhdistä se tietokantaoppaamme mukaisesti. Enhancedissa tämä toimii samalla tavalla.

Resurssien siirtäminen Legacysta

Useimmat avoimen lähdekoodin skriptit toimivat sellaisenaan, mutta monet Enhancedin muutokset yllättävät vanhemmat kokoonpanot. Käy tämä lista läpi ennen kuin kopioit Legacy-palvelimen sisällön:

• Escrow-suojatut resurssit pysyvät estettyinä, kunnes Cfx.re julkaisee Asset Escrow'n Enhancedille. Pyydä tekijältä salaamaton versio tai pidä kyseinen projekti Legacyssa.
• Streamattavat assetit (ajoneuvot, kartat, vaatteet) pitää muuntaa Cfx.re:n Alchemist-työkalulla. Aseta muunnetut tiedostot stream_enhanced-kansioon nykyisen stream-kansion viereen. Enhanced lataa stream_enhanced-kansion stream-kansion sijaan, joten yksi resurssi voi palvella molempia versioita.
• KVP-data pitää siirtää kvdb-migratorilla, muuten tallennettu avain-arvo-data näkyy tyhjänä.
• Pelaajien server ID:t otetaan uudelleen käyttöön, kun pelaaja katkaisee yhteyden. Tarkista kaikki skriptit, jotka muistavat ID:itä erottaakseen pelaajat toisistaan.
• NUI callbackit toimivat oletuksena strict-tilassa. Jos resurssi rikkoutuu sen takia, se voi kytkeä tilan pois tiedostossa fxmanifest.lua:

nui_callback_strict_mode 'false'

• C#-resurssit pyörivät nyt .NET 10:llä Monon sijaan, joten testaa ne ennen julkaisua.
• Endpointit: endpoint_add_tcp ja endpoint_add_udp ottavat kumpikin vain yhden endpointin.
• Dev mode vaatii rivin sv_devMode true tiedostoon server.cfg.
• Peruspeli ilman DLC:itä: aseta sv_enforceGameBuild 1.

Palvelimen päivittäminen

Cfx.re julkaisee yhden ajantasaisen Enhanced-buildin, joten Legacy-palvelinten kaltaista build-valitsinta ei ole. Saat uusimman buildin avaamalla Settings-välilehden ja napsauttamalla Reinstall server: uudelleenasennus lataa palvelinohjelmiston uudelleen ja säilyttää tiedostosi (resources, server.cfg, txData), kunhan jätät wipe-ruudun valitsematta. Varmuuskopio Backups-välilehdellä etukäteen on silti fiksu ratkaisu.

Yleisiä ongelmia

Command not found (sv_endpointprivacy): tätä komentoa ei ole Enhancedissa. Poista rivi tiedostosta server.cfg ja käynnistä uudelleen.

Escrow-suojattu resurssi ei lataudu: Asset Escrow ei ole vielä käytettävissä Enhancedissa. Korvaa resurssi avoimen lähdekoodin vaihtoehdolla tai aja se Legacy-palvelimella.

Legacy-pelaajat eivät pääse yhdistämään: perinteistä FiveM:ää käyttävä pelaaja ei voi koskaan liittyä Enhanced-palvelimelle. Hän tarvitsee GTA V Enhancedin ja FiveM for GTAV Enhanced -clientin, kuten kerrotaan oppaassa näin liityt FiveM Enhanced -palvelimelle.

"A valid license check is required to run this server": tallennettu avain on tyhjä, kirjoitettu väärin tai virheellinen. Avaa Startup, liitä avain kenttään fivem license ilman välilyöntejä ja käynnistä palvelin uudelleen.

Muutokset tiedostoon server.cfg eivät vaikuta mihinkään: txAdmin on päällä, eikä se suorita tiedostoa server.cfg. Tee muutos txAdminissa tai kytke txAdmin pois ja käynnistä uudelleen.