Denne guide dækker, hvordan du installerer ressourcer (scripts) på din FiveM-server, opsætter en MySQL-database til frameworks som ESX eller QBCore, og forstår rækkefølgen for indlæsning af ressourcer. Hvis du endnu ikke har gennemført den indledende serveropsætning, start med FiveM Server Opsætningsguide først.
server.cfg. Se FiveM Server Opsætningsguide for indledende opsætningstrin.
Installation af ressourcer og scripts
FiveM-servere udvides med ressourcer (også kaldet scripts). Ressourcer tilføjer funktioner som bilforhandlere, jobs, HUD-elementer, frameworks og mere.
Sådan installerer du en ressource
- Download ressourcen fra dens kilde (GitHub, Cfx.re-fora, Tebex, osv.).
- Udpak ressourcemappen fra ZIP/arkivet hvis nødvendigt.
- Upload ressourcemappen til din servers
resources/-mappe ved hjælp af GPanel-fanen Files eller via SFTP. - Åbn
server.cfgog tilføj enensure-linje for ressourcen:
# Add your custom resources
ensure my-new-resource
- Genstart serveren fra GPanel eller TXAdmin for at indlæse ressourcen.
ensure-linjen skal matche ressourcemappens navn nøjagtigt (der skelnes mellem store og små bogstaver). Hvis mappen hedder my-cars, skal linjen være ensure my-cars.
Ressource-manifester
Hver gyldig ressource skal indeholde en manifestfil. Moderne ressourcer bruger fxmanifest.lua, mens ældre bruger __resource.lua. Hvis en downloadet ressourcemappe ikke indeholder nogen af disse filer, vil ressourcen ikke blive indlæst. Nogle downloads indlejrer den faktiske ressourcemappe inde i en ydre mappe — sørg for, at mappen du placerer i resources/ er den, der indeholder manifestet.
Rækkefølge for indlæsning af ressourcer
Ressourcer indlæses i den rækkefølge, de optræder i server.cfg. Hvis en ressource afhænger af en anden (for eksempel et job-script der afhænger af et framework som ESX eller QBCore), skal afhængigheden være angivet før den ressource, der har brug for den:
# 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
Organisering af ressourcer med kategorimapper
Du kan organisere ressourcer i undermapper inde i resources/-mappen. Brug klammenotation i server.cfg for at ensure en hel kategorimappe:
# Ensure all resources inside resources/[esx]/
ensure [esx]
# Ensure all resources inside resources/[standalone]/
ensure [standalone]
Dette indlæser alle ressourcer i den navngivne undermappe. Det er en praktisk måde at gruppere relaterede scripts uden at angive hver enkelt individuelt.
Hot-loading af ressourcer via TXAdmin
Du behøver ikke altid en fuld servergenstart for at indlæse en ny ressource. TXAdmin kan starte, stoppe og genstarte individuelle ressourcer fra sin Resources-side. Efter upload af en ny ressource og tilføjelse af dens ensure-linje, kan du køre følgende kommando i TXAdmin live-konsollen:
refresh
ensure my-new-resource
Kommandoen refresh fortæller serveren at scanne resources/-mappen igen for nye indgange.
Databaseopsætning (MySQL / MariaDB)
Mange FiveM-frameworks og ressourcer (såsom ESX, QBCore eller vRP) kræver en MySQL- eller MariaDB-database. Legion Hosting leverer databaselegitimationsoplysninger med din server.
Find dine databaselegitimationsoplysninger
- I GPanel, gå til fanen Databases.
- Hvis der endnu ikke findes en database, klik på New Database for at oprette en.
- Notér følgende detaljer:
- Database Host (adresse og port)
- Database Name
- Username
- Password (klik på øje-ikonet for at vise det)
Konfiguration af databaseforbindelsen
Databaseforbindelsesoplysninger indstilles i server.cfg ved hjælp af en forbindelsesstreng. Det præcise format afhænger af, hvilken MySQL-ressource du bruger, men det mest almindelige format er:
# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"
Erstat pladsholderne med dine faktiske legitimationsoplysninger fra Databases-fanen. For eksempel:
set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"
localhost eller 127.0.0.1.
@, # eller %, skal du URL-kode dem i forbindelsesstrengen. For eksempel bliver @ til %40 og # bliver til %23.
Valg af MySQL-ressource
| Ressource | Status | Bemærkninger |
|---|---|---|
| oxmysql | Anbefalet | Moderne, aktivt vedligeholdt, bedste ydeevne. Bruges af de fleste nuværende frameworks. |
| mysql-async | Ældre | Ældre men virker stadig. Nogle ældre scripts afhænger specifikt af den. |
| ghmattimysql | Ældre | En anden ældre mulighed. Tjek dit frameworks dokumentation, hvis det kræver denne. |
Uanset hvilken MySQL-ressource du bruger, skal den ensures i server.cfg før alle ressourcer, der afhænger af 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
Framework-grundlæggende
Et framework leverer de centrale gameplay-systemer, som andre ressourcer bygger på — ting som spilleridentitet, penge, inventar, jobs og køretøjer. De to mest populære FiveM-frameworks er:
| Framework | Ressourcenavn | Beskrivelse |
|---|---|---|
| ESX | es_extended |
Det mest udbredte framework. Stort økosystem af gratis og betalte scripts. Godt til rollespilsservere. |
| QBCore | qb-core |
Moderne alternativ til ESX. Renere kodebase, aktiv udvikling. Voksende script-økosystem. |
De fleste frameworks installeres via TXAdmins opskriftssystem under den indledende opsætning. Hvis du valgte en opskrift som "QBCore" eller "ESX" under TXAdmin-opsætningen, er frameworket og dets kerneafhængigheder allerede installeret. Hvis du har brug for at installere et framework manuelt, følg dets officielle dokumentation:
Få hjælp
Hvis du har brug for hjælp med ressourceinstallation eller databasekonfiguration:
- Tjek ressourcens dokumentation eller GitHub-side for installationsinstruktioner og kendte problemer.
- Gennemgå GPanel-konsollen eller TXAdmin-logfilerne for fejlmeddelelser.
- Opret en supportbillet på https://legionhosting.net/submitticket.php med dine fejlmeddelelser og navnet på den ressource, du forsøger at installere.