Denne veiledningen forklarer hvordan du installerer ressurser (skript) på din FiveM-server, setter opp en MySQL-database for rammeverk som ESX eller QBCore, og forstår lasterekkefølgen for ressurser. Hvis du ikke har fullført innledende serveroppsett ennå, start med Oppsettsveiledning for FiveM-server først.
server.cfg. Se Oppsettsveiledning for FiveM-server for innledende oppsettstrinn.
Installere ressurser og skript
FiveM-servere utvides med ressurser (også kalt skript). Ressurser legger til funksjoner som bilforhandlere, jobber, HUD-elementer, rammeverk og mer.
Slik installerer du en ressurs
- Last ned ressursen fra dens kilde (GitHub, Cfx.re-forumene, Tebex osv.).
- Pakk ut ressursmappen fra ZIP-/arkivfilen om nødvendig.
- Last opp ressursmappen til serverens
resources/-katalog ved hjelp av GPanel-fanen Files eller via SFTP. - Åpne
server.cfgog legg til enensure-linje for ressursen:
# Add your custom resources
ensure my-new-resource
- Start serveren på nytt fra GPanel eller TXAdmin for at ressursen skal lastes.
ensure-linjen må samsvare nøyaktig med ressursmappenavnet (skiller mellom store og små bokstaver). Hvis mappen er my-cars, må linjen være ensure my-cars.
Ressursmanifest
Hver gyldig ressurs må inneholde en manifestfil. Moderne ressurser bruker fxmanifest.lua, mens eldre bruker __resource.lua. Hvis en nedlastet ressursmappe ikke inneholder noen av disse filene, vil ikke ressursen lastes. Noen nedlastinger nester den faktiske ressursmappen inne i en ytre mappe — sørg for at mappen du legger i resources/ er den som inneholder manifestet.
Lasterekkefølge for ressurser
Ressurser lastes i den rekkefølgen de vises i server.cfg. Hvis en ressurs er avhengig av en annen (for eksempel et jobbskript som er avhengig av et rammeverk som ESX eller QBCore), sørg for at avhengigheten står oppført før ressursen som trenger 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
Organisere ressurser med kategorimapper
Du kan organisere ressurser i undermapper inne i resources/-katalogen. Bruk klammenotasjon i server.cfg for å sikre en hel kategorimappe:
# Ensure all resources inside resources/[esx]/
ensure [esx]
# Ensure all resources inside resources/[standalone]/
ensure [standalone]
Dette laster hver ressurs innenfor den navngitte undermappen. Det er en praktisk måte å gruppere relaterte skript på uten å liste hvert enkelt individuelt.
Hot-lasting av ressurser via TXAdmin
Du trenger ikke alltid en full serveromstart for å laste en ny ressurs. TXAdmin kan starte, stoppe og starte enkeltressurser på nytt fra sin Resources-side. Etter at du har lastet opp en ny ressurs og lagt til dens ensure-linje, kan du kjøre følgende kommando i TXAdmins direktekonsoll:
refresh
ensure my-new-resource
refresh-kommandoen ber serveren om å skanne resources/-katalogen på nytt etter nye oppføringer.
Databaseoppsett (MySQL / MariaDB)
Mange FiveM-rammeverk og ressurser (som ESX, QBCore eller vRP) krever en MySQL- eller MariaDB-database. Legion Hosting gir deg databasepåloggingsinformasjon med serveren din.
Finne databasepåloggingsinformasjonen din
- I GPanel, gå til Databases-fanen.
- Hvis det ikke finnes noen database ennå, klikk New Database for å opprette en.
- Noter ned følgende detaljer:
- Database Host (adresse og port)
- Database Name
- Username
- Password (klikk på øyeikonet for å avsløre det)
Konfigurere databasetilkoblingen
Detaljer for databasetilkobling settes i server.cfg ved hjelp av en tilkoblingsstreng. Det nøyaktige formatet avhenger av hvilken MySQL-ressurs du bruker, men det vanligste formatet er:
# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"
Erstatt plassholderne med din faktiske påloggingsinformasjon 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 %, må du URL-kode dem i tilkoblingsstrengen. For eksempel blir @ til %40 og # blir %23.
Velge en MySQL-ressurs
| Ressurs | Status | Merknader |
|---|---|---|
| oxmysql | Anbefalt | Moderne, aktivt vedlikeholdt, best ytelse. Brukes av de fleste nåværende rammeverk. |
| mysql-async | Eldre | Eldre, men fungerer fortsatt. Noen eldre skript er spesifikt avhengige av den. |
| ghmattimysql | Eldre | Et annet eldre alternativ. Sjekk rammeverkets dokumentasjon hvis det krever dette. |
Uansett hvilken MySQL-ressurs du bruker, må den sikres i server.cfg før ressurser som er avhengige 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
Grunnleggende om rammeverk
Et rammeverk gir de grunnleggende spillsystemene som andre ressurser bygger på — ting som spilleridentitet, penger, inventar, jobber og kjøretøy. De to mest populære FiveM-rammeverkene er:
| Rammeverk | Ressursnavn | Beskrivelse |
|---|---|---|
| ESX | es_extended |
Det mest brukte rammeverket. Stort økosystem av gratis og betalte skript. Bra for rollespillservere. |
| QBCore | qb-core |
Moderne alternativ til ESX. Renere kodebase, aktiv utvikling. Voksende skriptøkosystem. |
De fleste rammeverk installeres via TXAdmins oppskriftssystem under innledende oppsett. Hvis du valgte en oppskrift som «QBCore» eller «ESX» under TXAdmin-oppsettet, er rammeverket og dets kjerneavhengigheter allerede installert. Hvis du trenger å installere et rammeverk manuelt, følg dets offisielle dokumentasjon:
Få hjelp
Hvis du trenger hjelp med ressursinstallasjon eller databasekonfigurasjon:
- Sjekk ressursens dokumentasjon eller GitHub-side for installasjonsinstruksjoner og kjente problemer.
- Se gjennom GPanel-konsollen eller TXAdmin-loggene for feilmeldinger.
- Åpne en supportsak på https://legionhosting.net/submitticket.php med feilmeldingene dine og navnet på ressursen du prøver å installere.