Sådan opretter du en MySQL-database til din server

Meget serversoftware vil have et ordentligt sted at gemme sine data. Rettighedsplugins, økonomiplugins, webkort, banlister der deles mellem servere og alle ESX- og QBCore-opsætninger på FiveM forventer en MySQL-database. Du kan selv oprette en fra panelet på under et minut, og panelet giver dig alle de værdier, du skal bruge for at forbinde.

Det skal du bruge

• Din server i spilpanelet
• Konfigurationsfilen for det plugin eller den ressource, der skal bruge databasen, åben i en anden fane

Trin 1: åbn fanen Databaser

Åbn spilpanelet, vælg din server, og klik på Databaser i menuen til venstre. Den ligger i gruppen Avanceret sammen med Netværk, Planlægning, Aktivitet og Adgang.

Øverst på kortet kan du se, hvor mange pladser du har, for eksempel 0 af 1 databaser brugt. Nye servere har én databaseplads, og det rækker til de fleste opsætninger: én database kan sagtens rumme tabellerne fra flere plugins, fordi hvert plugin navngiver sine egne tabeller.

Står der Databaser er ikke tilgængelige, har serveren ingen databasepladser. Opret en ticket via supportsiden, så kigger vi på det sammen med dig.

Trin 2: opret databasen

1. Klik på Ny database
2. Skriv et kort navn, for eksempel survival eller economy. Kun bogstaver, tal og underscores er tilladt.
3. Klik på Ny database i dialogen for at bekræfte

Panelet opretter databasen og en bruger til den med en genereret adgangskode og viser derefter den nye database på listen med adgangskoden allerede synlig.

Læg mærke til det navn, du ender med. Der sættes automatisk et præfiks foran, så survival bliver til noget i retning af s1234_survival. Det er hele det navn, dit plugin skal have.

Trin 3: kopier forbindelsesoplysningerne

Hver database på listen viser fem værdier, og hver af dem har sin egen kopiér-knap:

Kopier dem med knapperne i stedet for at skrive dem af. Tre fejl står bag næsten alle mislykkede forbindelser:

• Du bruger localhost eller root. Databasen kører ikke inde i din spilserver, men på en separat databaseserver. localhost, 127.0.0.1 og brugeren root virker aldrig.
• Du sætter porten ind i værtsfeltet. De fleste konfigurationer har deres egen portindstilling. Værten skal i det ene felt og porten i det andet.
• Du finder selv på et databasenavn. Installationsguider foreslår ofte deres eget navn. Brug i stedet navnet med præfiks fra panelet.

Trin 4: indsæt oplysningerne i din plugin-konfiguration

Hvert plugin kalder indstillingerne noget lidt forskelligt, men de svarer altid til de samme fem værdier. Sådan ser det ud i LuckPerms, et udbredt rettighedsplugin til Minecraft, i plugins/LuckPerms/config.yml:

storage-method: MySQL
data:
  address: DIN_VAERT:3306
  database: s1234_survival
  username: DIT_BRUGERNAVN
  password: 'DIN_ADGANGSKODE'

LuckPerms har ingen separat portindstilling, så det er den ene slags konfiguration, hvor vært og port skrives sammen som vært:port. Har konfigurationen et portfelt, holder du dem adskilt.

Gem filen, og genstart serveren. De fleste plugins læser kun deres databaseindstillinger, når de indlæses, så ændrer du filen, mens serveren kører, sker der intet før næste genstart. Hold øje med fanen Konsol, mens serveren starter: et plugin, der ikke kan forbinde, siger det som regel der, ofte med Access denied eller Communications link failure i beskeden.

FiveM: oxmysql-forbindelsesstrengen

På en FiveM-server gør fanen Databaser en ting mere. Under listen får du en oxmysql forbindelsesstreng til din første database: en komplet linje set mysql_connection_string "..." med vært, port, navn, brugernavn og adgangskode udfyldt. Kopier den med knappen, og indsæt den i toppen af server.cfg. Styrer txAdmin din server, skal den i stedet ind i txAdmin-indstillingerne.

I det sjældne tilfælde, at adgangskoden indeholder et tegn, som oxmysql ikke kan læse, advarer panelet dig i stedet for at vise en linje, der ikke virker, og der sidder en knap Generér ny adgangskode ved siden af advarslen.

Forbind fra din egen computer

De samme fem værdier virker i en MySQL-klient på din computer, for eksempel HeidiSQL eller DBeaver. Det er praktisk, når du vil kigge i tabellerne eller importere en eksisterende database. Vælg MySQL (eller MariaDB) som forbindelsestype, og udfyld felterne ét ad gangen.

Skift adgangskoden

Klik på Ny adgangskode på databasens række. Der genereres en ny adgangskode, som vises med det samme, og den gamle holder op med at virke med det samme. Opdatér alle konfigurationer, der bruger databasen, og genstart serveren, ellers bliver dine plugins ved med at prøve den gamle.

Gør det, hver gang adgangskoden kan være blevet delt ved et uheld, for eksempel på et skærmbillede eller i en offentlig kopi af din konfiguration.

Slet en database

Klik på skraldespandsikonet på rækken, og bekræft i dialogen Slet database. Databasen og alle dens tabeller fjernes permanent og kan ikke gendannes. Pladsen bliver fri igen, så du kan oprette en ny med det samme.

Serverens sikkerhedskopier under fanen Sikkerhedskopier indeholder serverens filer, ikke databasen, som ligger på databaseserveren. Betyder dataene noget, så eksporter dem med en klient på din computer, før du sletter noget.

Fejlfinding

Access denied for user. Brugernavn eller adgangskode passer ikke. Kopier begge igen fra panelet, tjek for et mellemrum i starten eller slutningen, og sørg for, at du ikke har klikket på Ny adgangskode, efter at du skrev konfigurationen.

Unknown database. Navnet mangler sit præfiks. Kopier Databasenavn fra panelet.

Connection refused eller timeout. Værten er forkert, som regel localhost, eller porten er sat sammen med værten i et felt, der kun forventer værten.

Knappen Ny database er grå. Alle dine pladser er i brug. Slet en database, du ikke længere bruger, eller lad flere plugins dele én database.

Navnet bliver afvist. Kun bogstaver, tal og underscores er tilladt, og et navn, du allerede har brugt, kan ikke bruges to gange.

Sidder du fast? Opret en ticket via supportsiden med navnet på din server og fejlen fra konsollen, så tjekker vi det sammen med dig.