Sådan forbinder du en database til din FiveM-server

Sådan forbinder du en database til din FiveM-server

Alle roleplay-frameworks, der er værd at køre på FiveM, gemmer deres data i MySQL: karakterer, jobs, køretøjer, inventory og bankkonti. Din FiveM-server hos DoomHosting har en MySQL-databaseplads, som du selv opretter under fanen Databaser i panelet, og det kræver kun én linje i server.cfg at forbinde den. Denne guide dækker oprettelsen af databasen, den connection string oxmysql forventer, hvor linjen skal stå, og hvordan du importerer et ESX- eller QBCore-skema.

Det skal du have

• En FiveM-server hos DoomHosting, der allerede booter. Hvis den ikke starter endnu, skal licensnøglen sættes først: sådan får du en FiveM-licensnøgle.
• oxmysql, den resource alle moderne frameworks bruger til at tale med MySQL. Både ESX og QBCore leveres med den.
• En MySQL-klient på din pc, hvis du skal importere et framework-skema. HeidiSQL (Windows) og DBeaver (alle platforme) er gratis.

Opret databasen i panelet

1. Åbn dine gameservere og klik på din FiveM-server.
2. Under Avanceret i sektionsmenuen åbner du Databaser.
3. Klik på Ny database, skriv et kort navn (kun bogstaver, tal og underscores), og bekræft.

Vi opretter databasen og en tilhørende bruger med en genereret adgangskode. Navnet får automatisk et præfiks, så en database du kalder esx ender som noget i stil med s1708_esx, og brugeren ser ud som u1708_esxdemo.

Rækken viser tre felter med legitimationsoplysninger. Vært er databaseadressen inklusive port, Brugernavn er den genererede bruger, og Adgangskode er skjult, indtil du klikker på øje-ikonet. Klik på et felt for at kopiere værdien. Til højre sidder to knapper: Ny adgangskode roterer adgangskoden (alt der stadig bruger den gamle, holder op med at virke med det samme), og skraldespanden sletter databasen og alle dens data permanent.

Overskriften på kortet tæller dine pladser, for eksempel 1 af 1 databaser brugt. Én plads dækker en normal ESX- eller QBCore-opsætning, for et framework og alle dets resources deler den samme database. Kontakt support, hvis din opsætning virkelig har brug for en ekstra.

Find din connection string

oxmysql læser én convar, mysql_connection_string, og accepterer to formater:

set mysql_connection_string "mysql://u1708_esxdemo:[email protected]:3306/s1708_esx"
set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"

Hent de fire værdier direkte fra fanen Databaser: brugeren fra Brugernavn, adgangskoden fra Adgangskode, databasenavnet fra rækkens titel og værten fra Vært. Vært-feltet indeholder allerede porten i formen adresse:port. I URI-formatet indsætter du det, som det er, efter @. I nøgle- og værdiformatet deler du det ved kolonet: adressen i host= og porten i port=.

Brug det andet format. De adgangskoder vi genererer, blander bogstaver og tal med tegn fra sættet ! @ = . + ^, og oxmysql angiver ; , / ? : @ & = + $ # som reserverede tegn i en connection string. En adgangskode med @, = eller + ødelægger mysql://-formatet lydløst: parseren læser en del af adgangskoden som værtsnavn, og forbindelsen fejler med legitimationsoplysninger, der ellers er helt korrekte. Formen user=...;password=... har ikke den fælde.

Sæt den ind i server.cfg

1. Åbn fanen Filer og klik på server.cfg for at redigere den i browseren.
2. Placer connection stringen over alle resource-linjer, og start oxmysql før dit framework:

set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"

ensure oxmysql
ensure es_extended

3. Gem filen, og genstart derefter serveren øverst i panelet. Convars læses kun ved boot, så en ændring gør ingenting, før serveren er genstartet.

To ting skal du lade være. Vores opstart skriver linjerne endpoint_add_tcp og endpoint_add_udp om til din tildelte port ved hver boot, så der er ingen grund til at rette i dem. Og behandl server.cfg som en hemmelig fil: den indeholder nu din databaseadgangskode ved siden af din licensnøgle, så indsæt den aldrig i en Discord-supportkanal uden at slette begge dele.

Hvis du har slået txAdmin til med chippen Aktivér txAdmin på Oversigt, kører FXServer ikke længere /home/container/server.cfg direkte. txAdmin styrer boot og kører serveren fra sin egen datamappe, /home/container/txData, så du skal rette den server.cfg, der ligger i deployment-mappen dér, eller bruge den CFG-editor, der er indbygget i txAdmin. Du kommer til webpanelet med Åbn txAdmin på Oversigt.

Installer oxmysql

Se i resources først. ESX- og QBCore-recipes indeholder næsten altid oxmysql i forvejen, og en ekstra kopi giver en navnekonflikt mellem resources, ikke en hurtigere server.

Mangler den, henter du den nyeste release fra oxmysql-repositoriet, pakker den ud og uploader mappen oxmysql til din resources-mappe fra Filer-fanen. Tilføj derefter ensure oxmysql over dine framework-resources som vist ovenfor. Ligger der stadig mysql-async eller ghmattimysql i opsætningen, så slet dem: oxmysql leverer deres exports, og kører du begge, får du dobbelte query handlers.

oxmysql-dokumentationen dækker resten, blandt andet set mysql_debug true, der printer hver query i konsollen, og set mysql_slow_query_warning 150, der markerer de langsomme.

Om ESX og QBCore

Begge frameworks kører deres queries gennem oxmysql, så én connection string dækker både frameworket og alle resources ovenpå. Hvad ingen af dem gør for dig, er at oprette tabellerne. Dem importerer du selv:

1. Installer HeidiSQL eller DBeaver på din pc.
2. Opret en ny MySQL- eller MariaDB-forbindelse med adressen og porten fra Vært plus Brugernavn og Adgangskode fra Databaser-fanen. Den bruger vi opretter, må forbinde fra enhver adresse, så en klient på din hjemmeforbindelse virker uden yderligere opsætning.
3. Vælg din database, åbn frameworkets .sql-fil, og kør den.

For ESX er det SQL-filen til es_extended plus det, hvert addon selv leverer. Se ESX-dokumentationen. For QBCore importerer du først dumpet til qb-core og derefter filerne for de enkelte resources, som beskrevet i QBCore-dokumentationen. Importer skemaet, før du booter med frameworket slået til, ellers fylder konsollen med fejl om manglende tabeller ved opstart.

Én ting er værd at vide om backups: panelets backups arkiverer dine serverfiler, ikke MySQL-databasen. Eksporter et .sql-dump fra din klient før en større framework-opdatering eller en wipe.

Almindelige problemer

Failed to connect eller nægtet adgang ved boot. Ni ud af ti gange står der stadig localhost i stringen. Der kører ingen MySQL-server inde i din gamecontainer, så værten skal være adressen fra Databaser-fanen.

Legitimationsoplysningerne er rigtige, men login fejler alligevel. Adgangskoden indeholder @, = eller +, og du bruger mysql://-formatet. Skift til formen user=...;password=...;host=.... Et klik på Ny adgangskode kan også give dig en pænere adgangskode, men det andet format er den sikre løsning.

Resources starter, før convaren er sat. oxmysql forbinder, når den starter, så linjen set mysql_connection_string skal stå over ensure oxmysql. Brug set, ikke sets eller setr: de sender værdien ud til alle spillere, der forbinder.

Ingenting ændrede sig efter rettelsen i konfigurationen. Genstart serveren. En kørende server læser aldrig server.cfg igen.

Fejl om ukendte tabeller eller kolonner. Forbindelsen virker, men skemaet blev aldrig importeret, eller det blev importeret i den forkerte database. Bekræft i HeidiSQL, at tabellerne ligger i din præfiksede database og ikke i en anden, du selv har oprettet.

Du rettede server.cfg, men txAdmin er slået til. txAdmin kører sin egen kopi under /home/container/txData. Ret den fil, ellers bliver den, du ændrede, simpelthen aldrig læst.

Databaser-fanen siger, at databaser ikke er tilgængelige. Din server har ingen databaseplads. Kontakt support, så ser vi på servicen.

Næste skridt

Dit framework har nu et sted at gemme sine data. Er du stadig midt i opsætningen, ligger guiden til licensnøglen her: sådan får du en FiveM-licensnøgle. Alle detaljer om planer, hardware og priser finder du på siden FiveM server hosting.