Konfigurera din FiveM-server: licensnyckel, server.cfg och resurser

En FiveM-server behöver tre saker för att fungera: en gratis Cfx.re-licensnyckel, en fungerande server.cfg och dina resurser (skript, kartor och ramverk). Den här guiden hjälper dig med alla tre så att din server startar och visas i serverlistan.

1. Generera en Cfx.re-licensnyckel

Varje FiveM-server behöver en licensnyckel från Cfx.re:s keymaster. Den är gratis.

1. Gå till keymaster.fivem.net och logga in med ditt Cfx.re (Forum)-konto.
2. Klicka på New server key / Register.
3. För IP-adressen kan du registrera en nyckel till din servers IP-adress eller generera en olista nyckel (fungerar för de flesta installationer). Obs: en nyckel är kopplad till hur du registrerar den, så om du byter server kan du behöva en ny nyckel.
4. Kopiera nyckeln. Den ser ut som en lång slumpmässig sträng.

2. Lägg till nyckeln i server.cfg

1. Öppna din server och klicka på Filhanterare.

2. Öppna server.cfg i roten.

3. Hitta raden sv_licenseKey (eller lägg till en) och klistra in din nyckel:

   sv_licenseKey your_key_here
   

4. Spara och starta om från fliken Konsol.

Utan en giltig nyckel kommer konsolen att skriva ut Invalid license key och servern kommer inte att gå online.

3. Förstå server.cfg

server.cfg är hjärtat i din server. Raderna du kommer att ändra mest:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My ServerPrism FiveM Server"
sv_maxclients 32
sets locale "en-US"

# Load resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey your_key_here

• sv_hostname: din servers namn i FiveM-serverbläddraren.
• sv_maxclients: spelarplatser (upp till 48 på standardbyggen).
• ensure <name>: startar en resurs vid uppstart. Det är så du aktiverar skript.

Du behöver inte redigera endpoint-raderna. De ställs in automatiskt till din servers egen port (den som finns i Address på Overview) vid varje start, så 30120 i exemplet ovan ersätts av din riktiga port.

4. Lägg till resurser

Resurser (skript, kartor, ramverk som ESX eller QBCore) placeras i mappen resources/.

1. Ladda upp resursmappen till resources/ via Filhanterare eller SFTP (SFTP är bättre för stora ramverk, se Filhanterare och SFTP).
2. Lägg till en ensure <resource-name>-rad i server.cfg för varje resurs du vill köra.
3. Starta om. Titta i konsolen: varje resurs skriver ut Started resource <name> när den laddas.

För ett komplett rollspelsramverk, installera dess basresurser i den ordning som dess dokumentation anger (vanligtvis en databas + kärnramverk först, sedan beroende skript).

Databaser (ESX/QBCore)

Rollspelsramverk behöver en MySQL-databas. Skapa en på fliken Databaser och peka ramverkets konfiguration (vanligtvis via mysql_connection_string i server.cfg eller en ramverkskonfigurationsfil) mot inloggningsuppgifterna. Se Skapa och ansluta till en MySQL-databas.

Databasproblem på samma nod: om din databas och FiveM-server finns på samma nod och ramverket inte kan ansluta via den publika IP-adressen, öppna ett supportärende. Detta är ett känt nätverksfall som vi snabbt kan åtgärda genom att brygga containrarna.

Vanliga problem

• Invalid license key: nyckeln är felaktig, har gått ut eller är registrerad till en annan IP-adress. Generera den igen i keymaster.
• Servern visas inte i webbläsaren: den startar fortfarande, sv_hostname är inte inställt, eller en resurs ger fel. Läs konsolen för det första error.
• En resurs misslyckas med att starta: kontrollera konsolen för den första felraden under den resursen; det är vanligtvis ett saknat beroende eller en databas den inte kan nå.
• ghmattimysql/oxmysql-fel: databasanslutningssträngen är felaktig. Kopiera inloggningsuppgifterna på nytt från fliken Databaser.

Fortfarande fast?

Öppna ett supportärende med den första error-raden från din konsol och den resurs den nämner. Vi kan gräva i konfigurationen direkt på noden.