Framework installeren (ESX/QBCore)

Framework installeren (ESX of QBCore)

Een framework is de ruggengraat van je FiveM roleplay server. Zonder framework kun je geen banen, geld-systeem, inventaris of andere RP-functionaliteiten gebruiken. In deze handleiding leggen we uit wat een framework is, wat de verschillen zijn tussen ESX en QBCore, en hoe je er een installeert op je HytaleNode server.

Wat is een framework en waarom heb je het nodig?

Een framework is een grote, allesomvattende resource die de basisfunctionaliteit van je RP server regelt. Denk aan:

• Speler-accounts – Opslaan van karakter-data, geld, banen en inventaris in de database
• Geldsysteem – Cash, bankrekening en zwart geld bijhouden
• Banen-systeem – Spelers kunnen banen hebben met salarissen en rangen
• Item-systeem – Items gebruiken, geven en verhandelen
• API voor andere resources – Andere resources (zoals politie, ambulance, winkels) gebruiken het framework om toegang te krijgen tot spelersgegevens

Zonder framework werken al die baan-resources, winkels en andere RP-scripts simpelweg niet. Het framework is het fundament waarop alles gebouwd wordt.

ESX vs QBCore: welke moet je kiezen?

De twee populairste frameworks zijn ESX en QBCore. Hier is een vergelijking om je te helpen kiezen:

Eigenschap	ESX (es_extended)	QBCore (qb-core)
Leeftijd	Ouder, zeer bewezen	Nieuwer, modern opgezet
Community	Enorm, duizenden resources	Groeiend, honderden resources
Moeilijkheidsgraad	Makkelijk om mee te beginnen	Iets steiler leercurve
Anti-cheat	Basis, extra nodig	Beter ingebouwd
Performance	Goed (met goede resources)	Goed (met goede resources)
Documentatie	Veel community docs	Officiele docs beschikbaar
Aangeraden voor	Beginners, kleinere servers	Gevorderde gebruikers, grotere servers

Onze aanbeveling: Als je voor het eerst een FiveM RP server opzet, begin dan met ESX. Er zijn meer gratis resources beschikbaar en de community is groter, waardoor je makkelijker hulp kunt vinden. Als je meer ervaring hebt of een grotere server wilt opzetten, is QBCore een uitstekende keuze.

ESX installeren: stap voor stap

Volg deze stappen om ESX te installeren op je HytaleNode FiveM server:

Stap 1: Database voorbereiden

1. Ga naar je server op mijn.hytalenode.nl en open de "Databases" tab.
2. Maak een nieuwe database aan als je die nog niet hebt. Noteer de database-naam, gebruikersnaam, wachtwoord en host.
3. Open phpMyAdmin via de link in het panel.
4. Download het SQL-bestand van ESX (te vinden in de GitHub repository van es_extended onder de map sql/ of als es_extended.sql).
5. Ga in phpMyAdmin naar je database en klik op "Importeren". Upload het SQL-bestand en klik op "Starten". Dit maakt alle benodigde tabellen aan.

Afbeelding: hier moet afbeelding komen met screenshot van phpMyAdmin met de importeer functie

Stap 2: Benodigde resources downloaden en uploaden

Download de volgende resources van GitHub en upload ze naar je server in de resources/ map (zie de handleiding "Resources installeren" voor gedetailleerde upload-instructies):

1. oxmysql – github.com/overextended/oxmysql (gebruik de release-versie, niet de broncode)
2. es_extended – github.com/esx-framework/esx_core
3. esx_identity – Voor karakter-aanmaak
4. esx_skin of fivem-appearance – Voor het uiterlijk van karakters

Zorg dat je de mappen correct hernoemt. Verwijder eventuele -main of -master achtervoegsels van de mapnamen.

Stap 3: server.cfg configureren

Open je server.cfg via de "Bestanden" tab in het panel en voeg het volgende toe. Zorg dat de database-verbinding bovenaan staat:

# Database verbinding
set mysql_connection_string "mysql://GEBRUIKERSNAAM:WACHTWOORD@HOST/DATABASENAAM?charset=utf8mb4"

# Resources laden (volgorde is belangrijk!)
ensure oxmysql
ensure es_extended
ensure esx_identity
ensure esx_skin

Vervang GEBRUIKERSNAAM, WACHTWOORD, HOST en DATABASENAAM door je eigen database-gegevens uit stap 1.

Stap 4: Server herstarten en testen

1. Sla het server.cfg bestand op.
2. Herstart je server via het panel.
3. Bekijk de console op foutmeldingen. Als alles goed gaat, zie je dat alle resources succesvol zijn geladen.
4. Verbind met je server via FiveM en test of je een karakter kunt aanmaken.

QBCore installeren: stap voor stap

De installatie van QBCore volgt grotendeels dezelfde stappen als ESX, maar met andere resources:

1. Database: Importeer de SQL-bestanden van QBCore in je database via phpMyAdmin.
2. Resources downloaden: Download qb-core, qb-multicharacter, qb-clothing en oxmysql van de QBCore GitHub organisatie.
3. Upload: Upload alle resource-mappen naar resources/ op je server.
4. server.cfg: Voeg de database-verbinding en ensure regels toe:

# Database verbinding
set mysql_connection_string "mysql://GEBRUIKERSNAAM:WACHTWOORD@HOST/DATABASENAAM?charset=utf8mb4"

# Resources laden
ensure oxmysql
ensure qb-core
ensure qb-multicharacter
ensure qb-clothing

5. Herstart je server en test de verbinding.

Na de installatie: basis resources toevoegen

Zodra je framework draait, kun je stap voor stap meer resources toevoegen. Begin met de essentials:

1. ox_lib – Hulpbibliotheek (werkt met beide frameworks)
2. ox_inventory – Inventaris-systeem (werkt met beide frameworks)
3. Een baan-resource – Bijvoorbeeld politie, om te testen of alles werkt

Voeg telkens een resource toe, herstart de server en test of alles werkt voordat je de volgende toevoegt.

Officiele documentatie

Voor meer gedetailleerde informatie over de frameworks kun je de officiele documentatie raadplegen:

• ESX documentatie: documentation.esx-framework.org
• QBCore documentatie: docs.qbcore.org
• Overextended (ox_lib, oxmysql, ox_inventory): overextended.dev
• Cfx.re Native Reference: docs.fivem.net/natives – Voor ontwikkelaars die zelf resources willen maken

Tip: Neem de tijd om de documentatie van je gekozen framework door te lezen. Dit bespaart je veel problemen later en helpt je om je server beter te begrijpen en aan te passen aan je eigen wensen.