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

En FiveM-server behöver tre saker för att köras: en gratis Cfx.re-licensnyckel, en fungerande server.cfg och dina resurser (skript, kartor och ramverk). Den här guiden hjälper dig att få alla tre rätt 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 – det ä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 olistad nyckel (fungerar för de flesta installationer). Obs: en nyckel är kopplad till hur du registrerar den, så om du någonsin 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å File Manager.

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 Console.

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.

Ändra inte endpoint-porten om du inte känner till din allokering. FiveM:s spelport ställs in av din ServerPrism-allokering – standard 30120 är korrekt för de flesta servrar. Kontrollera fliken Startup/Network om du är osäker.

4. Lägg till resurser

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

1. Ladda upp resursmappen till resources/ via File Manager 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. Håll ett öga på 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 Databases och peka ramverkets konfiguration (vanligtvis via mysql_connection_string i server.cfg eller en ramverkskonfigurationsfil) mot autentiseringsuppgifterna. 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, utgången eller registrerad till en annan IP-adress – generera den på nytt i keymaster.
• Servern visas inte i webbläsaren: den startar fortfarande, sv_hostname är inte inställt, eller en resurs orsakar 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 autentiseringsuppgifterna på nytt från fliken Databases.

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.