Database koppelen aan FiveM

Database koppelen aan FiveM

Nu je een database hebt aangemaakt en je connection string klaar hebt, is het tijd om je FiveM server daadwerkelijk te koppelen aan de database. Dit doe je door een MySQL resource te installeren en je connection string in te stellen in de serverconfiguratie.

Welke MySQL resource heb je nodig?

FiveM heeft een extra resource nodig die als tussenstuk dient tussen je server en de MySQL database. Er zijn een paar populaire opties:

• oxmysql - De meest populaire en aanbevolen keuze. Wordt actief onderhouden, is snel en wordt door de meeste moderne frameworks (QBCore, ESX Legacy) standaard gebruikt.
• mysql-async - De oudere standaard. Werkt nog prima, maar wordt minder actief onderhouden. Sommige oudere resources vereisen deze specifiek.
• ghmattimysql - Een alternatief dat door sommige frameworks gebruikt wordt. Minder populair dan oxmysql.

Onze aanbeveling: Gebruik oxmysql tenzij je framework of resources specifiek iets anders vereisen.

oxmysql installeren

1. Ga naar de oxmysql releases pagina op GitHub: github.com/overextended/oxmysql/releases
2. Download de nieuwste oxmysql.zip (niet de source code)
3. Ga in het HytaleNode paneel naar de File Manager van je FiveM server
4. Navigeer naar de map resources (of resources/[standalone] als je die mappenstructuur gebruikt)
5. Upload het ZIP-bestand en pak het uit via de File Manager
6. Zorg dat de map oxmysql heet (niet oxmysql-2.x.x of iets dergelijks)

Afbeelding: hier moet afbeelding komen met screenshot van de oxmysql map in de File Manager van het paneel

mysql-async installeren (alternatief)

Als je liever mysql-async gebruikt of als je framework dit vereist:

1. Ga naar github.com/brouznouf/fivem-mysql-async/releases
2. Download de nieuwste release
3. Upload en pak het uit in je resources map
4. Hernoem de map naar mysql-async

Connection string instellen in server.cfg

Nu moet je je FiveM server vertellen hoe hij verbinding moet maken met de database. Dit doe je in het bestand server.cfg.

1. Open de File Manager in het paneel
2. Open het bestand server.cfg
3. Voeg de volgende regels toe bovenaan het bestand (voor alle andere ensure regels):

Voor oxmysql:

set mysql_connection_string "mysql://gebruikersnaam:wachtwoord@host:poort/database_naam"
ensure oxmysql

Voor mysql-async:

set mysql_connection_string "mysql://gebruikersnaam:wachtwoord@host:poort/database_naam"
ensure mysql-async

Vervang de connection string met de string die je in de vorige handleiding hebt samengesteld. Een compleet voorbeeld:

set mysql_connection_string "mysql://u1_abc123xyz:[email protected]:3306/s1_fivem_server"
ensure oxmysql

Belangrijk: De ensure oxmysql (of ensure mysql-async) regel moet voor alle andere resources staan die de database gebruiken, zoals je framework (ESX, QBCore, etc.). Anders proberen die resources de database te gebruiken terwijl de verbinding nog niet actief is.

Afbeelding: hier moet afbeelding komen met screenshot van server.cfg met de connection string en ensure regel

Testen of de verbinding werkt

(Her)start je FiveM server via het paneel. Ga naar de Console tab om de server output te volgen. Als alles goed is gegaan, zie je een melding zoals:

Bij oxmysql:

[oxmysql] Database server connection established!

Bij mysql-async:

[mysql-async] Database connected successfully.

Afbeelding: hier moet afbeelding komen met screenshot van de console output met een succesvolle database verbinding

Veelvoorkomende fouten bij het verbinden

Zie je een foutmelding in plaats van een succesmelding? Controleer het volgende:

• "Connection refused" - Controleer of de host en poort correct zijn. Kopieer ze opnieuw uit het paneel.
• "Access denied" - Je gebruikersnaam of wachtwoord klopt niet. Let op hoofdletters en speciale tekens.
• "Unknown database" - De database naam is verkeerd. Check de exacte naam in het paneel (inclusief het prefix zoals s1_).
• Resource oxmysql not found - De map staat niet op de juiste plek of heeft een verkeerde naam. Controleer de mappenstructuur in de File Manager.

Tip: Kopieer de gegevens rechtstreeks uit het paneel in plaats van ze over te typen. Zo voorkom je typefouten.