Så ansluter du en databas till din FiveM-server

Så ansluter du en databas till din FiveM-server

Varje roleplay-framework som är värt att köra på FiveM sparar sina data i MySQL: karaktärer, jobb, fordon, inventory och bankkonton. Din FiveM-server hos DoomHosting har en MySQL-databasplats som du skapar själv under fliken Databaser i panelen, och det räcker med en rad i server.cfg för att ansluta den. Den här guiden går igenom hur du skapar databasen, sätter samman den connection string oxmysql vill ha, var raden ska stå och hur du importerar ett ESX- eller QBCore-schema.

Det här behöver du

• En FiveM-server hos DoomHosting som redan startar. Om den inte bootar än, sätt licensnyckeln först: så skaffar du en FiveM-licensnyckel.
• oxmysql, den resource alla moderna frameworks använder för att prata med MySQL. Både ESX och QBCore levereras med den.
• En MySQL-klient på datorn om du ska importera ett framework-schema. HeidiSQL (Windows) och DBeaver (alla plattformar) är gratis.

Skapa databasen i panelen

1. Öppna dina spelservrar och klicka på din FiveM-server.
2. Under Avancerat i sektionsmenyn öppnar du Databaser.
3. Klicka på Ny databas, skriv ett kort namn (bara bokstäver, siffror och understreck) och bekräfta.

Vi skapar databasen och en tillhörande användare med ett genererat lösenord. Namnet får automatiskt ett prefix, så en databas du kallar esx blir något i stil med s1708_esx, och användaren ser ut som u1708_esxdemo.

Raden visar fem knappar med inloggningsuppgifter: Databasnamn, Host, Port, Användarnamn och Lösenord, där det sista är dolt tills du klickar på ögonikonen. Klicka på någon av dem för att kopiera värdet. Till höger sitter två knappar: Nytt lösenord roterar lösenordet (allt som fortfarande använder det gamla slutar fungera direkt), och papperskorgen tar bort databasen och all dess data permanent.

Kortets rubrik räknar dina platser, till exempel 1 av 1 databaser använda. En plats räcker för en vanlig ESX- eller QBCore-installation, eftersom ett framework och alla dess resources delar samma databas. Kontakta supporten om din uppsättning verkligen behöver en till.

Vad som ska stå i varje fält

txAdmins uppsättningssteg, HeidiSQL, DBeaver och de flesta framework-installerare frågar efter samma fem värden, vart och ett i sitt eget fält. Fliken Databaser visar dem som fem separata kopieringsknappar i exakt den ordningen, så kopiera vart och ett till fältet med motsvarande namn.

Tre av dem skrivs ur minnet i stället för att kopieras, och alla tre misslyckas:

• localhost är aldrig värden. Din databas körs på vår databasserver och inte inuti spelserverns container, så localhost pekar ditt framework mot en maskin utan MySQL. Använd adressen från knappen Host.
• root är aldrig användarnamnet. Du får en egen användare som heter u följt av ditt servernummer. En delad databasserver har ingen root-inloggning att dela ut, så root nekas oavsett vilket lösenord du sätter till.
• Databasnamnet är det vi har skapat, inte ett du väljer själv. Det har ett prefix, s1708_esx, och en installerare som föreslår ett eget namn föreslår en databas som inte finns. Kopiera knappen Databasnamn.

Saknar ett verktyg separat Port-fält och bara har ett adressfält, är det just där porten hör hemma: 203.0.113.10:3306, adress och port tillsammans.

Sätt samman din connection string

Du behöver inte sätta ihop den för hand. På en FiveM-server visar fliken Databaser den färdiga raden för din första databas under listan, med en kopieringsknapp och en ögonikon som avslöjar lösenordet i den. Kopiera den och gå direkt vidare till nästa avsnitt.

Vill du hellre skriva den själv läser oxmysql en enda convar, mysql_connection_string, och tar emot två format:

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"

Varje värde kommer från sin egen knapp på fliken Databaser: user= från Användarnamn, password= från Lösenord, host= från Host, port= från Port och database= från Databasnamn. Ingenting behöver delas upp eller redigeras på vägen in.

Använd det andra formatet. Lösenorden vi genererar blandar bokstäver och siffror med tecken ur uppsättningen ! @ = . + ^, och oxmysql listar ; , / ? : @ & = + $ # som reserverade tecken i en connection string. Ett lösenord med @, = eller + bryter mysql://-formatet tyst: parsern läser en del av lösenordet som värdnamn och anslutningen misslyckas med uppgifter som faktiskt är helt korrekta. Formen user=...;password=... har inte den fällan.

Lägg in den i server.cfg

1. Öppna fliken Filer och klicka på server.cfg för att redigera den i webbläsaren.
2. Lägg connection stringen ovanför alla resource-rader och starta oxmysql före ditt 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. Spara filen och starta sedan om servern högst upp i panelen. Convars läses bara vid boot, så en ändring gör ingenting förrän servern startat om.

Två saker ska du låta vara. Vår start skriver om raderna endpoint_add_tcp och endpoint_add_udp till din tilldelade port vid varje boot, så det är ingen idé att ändra dem. Och behandla server.cfg som en hemlig fil: den innehåller nu ditt databaslösenord bredvid licensnyckeln, så klistra aldrig in den i en Discord-supportkanal utan att först dölja båda.

Om du slog på txAdmin med chippen Aktivera txAdmin på Översikt kör FXServer inte längre /home/container/server.cfg direkt. txAdmin styr uppstarten och kör servern från sin egen datamapp, /home/container/txData, så redigera den server.cfg som ligger i deployment-mappen där, eller använd CFG-editorn som finns inbyggd i txAdmin. Du når webbpanelen med Öppna txAdmin på Översikt.

Installera oxmysql

Titta i resources först. ESX- och QBCore-recipes innehåller nästan alltid oxmysql redan, och en andra kopia ger en namnkonflikt mellan resources, inte en snabbare server.

Om den saknas hämtar du senaste releasen från oxmysql-repot, packar upp den och laddar upp mappen oxmysql till din resources-mapp via Filer-fliken. Lägg sedan ensure oxmysql ovanför dina framework-resources som ovan. Om din uppsättning fortfarande har mysql-async eller ghmattimysql, ta bort dem: oxmysql tillhandahåller deras exports, och kör du båda får du dubbla query handlers.

oxmysql-dokumentationen täcker resten, bland annat set mysql_debug true som skriver ut varje query i konsolen och set mysql_slow_query_warning 150 som flaggar de långsamma.

Om ESX och QBCore

Båda frameworken frågar via oxmysql, så en connection string räcker för både frameworket och alla resources ovanpå. Vad inget av dem gör åt dig är att skapa tabellerna. Dem importerar du själv:

1. Installera HeidiSQL eller DBeaver på datorn.
2. Skapa en ny MySQL- eller MariaDB-anslutning med adressen och porten från Värd samt Användarnamn och Lösenord från fliken Databaser. Användaren vi skapar får ansluta från valfri adress, så en klient på din hemuppkoppling fungerar utan extra steg.
3. Välj din databas, öppna frameworkets .sql-fil och kör den.

För ESX är det SQL-filen till es_extended plus det varje addon själv levererar. Se ESX-dokumentationen. För QBCore importerar du först dumpen till qb-core och därefter filerna för varje resource, som beskrivs i QBCore-dokumentationen. Importera schemat innan du bootar med frameworket påslaget, annars fylls konsolen med fel om saknade tabeller vid start.

En sak värd att veta om backuper: panelens backuper arkiverar dina serverfiler, inte MySQL-databasen. Exportera en .sql-dump med din klient före en stor framework-uppdatering eller en wipe.

Vanliga problem

Failed to connect eller nekad åtkomst vid boot. Nio av tio gånger står det fortfarande localhost i strängen. Det körs ingen MySQL-server inuti din spelcontainer, så värden måste vara adressen från fliken Databaser.

Access denied for user root. Det finns ingen root-inloggning på databasservern. Kopiera knappen Användarnamn, som ger dig u följt av ditt servernummer.

Porten hamnade där två gånger. Ett verktyg med eget Port-fält vill bara ha adressen i host-fältet. Klistrar du in 203.0.113.10:3306 där sitter porten på båda ställena och ingenting går att slå upp.

Unknown database. Namnet i konfigurationen är inte det vi har skapat. Både txAdmin och framework-installerare föreslår ett eget databasnamn, och den databasen finns inte. Kopiera knappen Databasnamn i stället.

Uppgifterna är rätt men inloggningen misslyckas ändå. Lösenordet innehåller @, = eller + och du använder mysql://-formatet. Byt till formen user=...;password=...;host=.... Ett klick på Nytt lösenord kan också ge dig ett renare lösenord, men det andra formatet är den säkra lösningen.

Resources startar innan convaren är satt. oxmysql ansluter när den startar, så raden set mysql_connection_string måste stå ovanför ensure oxmysql. Använd set, inte sets eller setr: de skickar värdet till alla spelare som ansluter.

Ingenting hände efter ändringen i konfigurationen. Starta om servern. En igångvarande server läser aldrig server.cfg igen.

Fel om okända tabeller eller kolumner. Anslutningen fungerar men schemat importerades aldrig, eller hamnade i fel databas. Kontrollera i HeidiSQL att tabellerna ligger i din databas med prefix och inte i en annan som du skapat själv.

Du redigerade server.cfg men txAdmin är på. txAdmin kör sin egen kopia under /home/container/txData. Redigera den, annars läses filen du ändrade helt enkelt aldrig.

Fliken Databaser säger att databaser inte är tillgängliga. Din server har ingen databasplats. Kontakta supporten så tittar vi på tjänsten.

Nästa steg

Ditt framework har nu någonstans att spara sina data. Är du fortfarande mitt i installationen hittar du guiden till licensnyckeln här: så skaffar du en FiveM-licensnyckel. Alla detaljer om planer, hårdvara och priser finns på sidan FiveM server hosting.