Den här guiden beskriver hur du installerar resurser (skript) på din FiveM-server, konfigurerar en MySQL-databas för ramverk som ESX eller QBCore samt förstår laddningsordningen för resurser. Om du ännu inte har slutfört den initiala serverkonfigurationen, börja först med FiveM Server Setup Guide.

Installera resurser och skript

FiveM-servrar utökas med resurser (även kallade skript). Resurser lägger till funktioner som bilhandlare, jobb, HUD-element, ramverk med mera.

Så här installerar du en resurs

1. Ladda ner resursen från dess källa (GitHub, Cfx.re-forumet, Tebex, etc.).
2. Extrahera resursmappen från ZIP-/arkivfilen om det behövs.
3. Ladda upp resursmappen till din servers katalog resources/ med fliken Files i GPanel eller via SFTP.
4. Öppna server.cfg och lägg till en ensure-rad för resursen:

# Add your custom resources
ensure my-new-resource

5. Starta om servern från GPanel eller TXAdmin för att resursen ska laddas.

Resursmanifest

Varje giltig resurs måste innehålla en manifestfil. Moderna resurser använder fxmanifest.lua, medan äldre använder __resource.lua. Om en nedladdad resursmapp inte innehåller någon av dessa filer kommer resursen inte att laddas. Vissa nedladdningar nästlar in den faktiska resursmappen i en yttre mapp — se till att mappen du placerar i resources/ är den som innehåller manifestet.

Laddningsordning för resurser

Resurser laddas i den ordning de förekommer i server.cfg. Om en resurs är beroende av en annan (till exempel ett jobbskript som är beroende av ett ramverk som ESX eller QBCore), se till att beroendet listas före resursen som behöver det:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organisera resurser med kategorimappar

Du kan organisera resurser i undermappar inuti katalogen resources/. Använd hakparentesnotation i server.cfg för att säkerställa en hel kategorimapp:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Detta laddar varje resurs inom den namngivna undermappen. Det är ett bekvämt sätt att gruppera relaterade skript utan att lista varje enskilt.

Hot-loading av resurser via TXAdmin

Du behöver inte alltid en fullständig omstart av servern för att ladda en ny resurs. TXAdmin kan starta, stoppa och starta om enskilda resurser från sin Resources-sida. Efter att du har laddat upp en ny resurs och lagt till dess ensure-rad kan du köra följande kommando i TXAdmins live-konsol:

refresh
ensure my-new-resource

Kommandot refresh säger åt servern att skanna om katalogen resources/ efter nya poster.

Databaskonfiguration (MySQL / MariaDB)

Många FiveM-ramverk och resurser (såsom ESX, QBCore eller vRP) kräver en MySQL- eller MariaDB-databas. Legion Hosting tillhandahåller databasuppgifter med din server.

Hitta dina databasuppgifter

1. Gå till fliken Databases i GPanel.
2. Om ingen databas finns ännu, klicka på New Database för att skapa en.
3. Notera följande uppgifter:
   • Database Host (adress och port)
   • Database Name
   • Username
   • Password (klicka på ögonikonen för att visa det)

Konfigurera databasanslutningen

Databasanslutningsuppgifterna ställs in i server.cfg med en anslutningssträng. Det exakta formatet beror på vilken MySQL-resurs du använder, men det vanligaste formatet är:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Ersätt platshållarna med dina faktiska uppgifter från fliken Databases. Till exempel:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Välja en MySQL-resurs

Oavsett vilken MySQL-resurs du använder måste den säkerställas i server.cfg före alla resurser som är beroende av den:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Grunderna i ramverk

Ett ramverk tillhandahåller de centrala spelsystemen som andra resurser bygger på — saker som spelaridentitet, pengar, inventarie, jobb och fordon. De två mest populära FiveM-ramverken är:

De flesta ramverk installeras via TXAdmins recept-system under den initiala konfigurationen. Om du valde ett recept som "QBCore" eller "ESX" under TXAdmin-konfigurationen är ramverket och dess kärnberoenden redan installerade. Om du behöver installera ett ramverk manuellt, följ dess officiella dokumentation:

• ESX Documentation
• QBCore Documentation

Få hjälp

Om du behöver hjälp med resursinstallation eller databaskonfiguration:

1. Kontrollera resursens dokumentation eller GitHub-sida för installationsinstruktioner och kända problem.
2. Granska GPanel-konsolen eller TXAdmin-loggarna efter felmeddelanden.
3. Öppna ett supportärende på https://legionhosting.net/submitticket.php med dina felmeddelanden och namnet på resursen du försöker installera.

Relaterade artiklar

• FiveM Server Setup Guide
• FiveM Troubleshooting
• How to Upload Files via SFTP
• How to Find Your Server IP and Port