ESX Legacy is het populairste roleplay-framework voor FiveM. Het biedt een compleet systeem met banen, economie, inventaris en voertuigen dat als basis dient voor vrijwel elke serieuze RP-server. De installatie is niet moeilijk, maar er zijn genoeg valkuilen. In dit artikel doorlopen we het hele proces: van een lege FiveM server tot een werkend ESX-framework.
Wat is ESX Legacy?
ESX (EssentialMode Extended) begon jaren geleden als een eenvoudig framework en is uitgegroeid tot de standaard voor FiveM roleplay. ESX Legacy is de geconsolideerde versie die alle oude losse modules (es_extended, esx_menu, esx_skin) samenvoegt in een modern, onderhouden pakket. Het wordt actief ontwikkeld door de community en is volledig open source.
Het framework biedt:
- Een economiesysteem met bank, contant geld en transacties.
- Een banen- en society-systeem met configureerbare beroepen.
- Inventarisbeheer met items, wapens en bruikbare objecten.
- Karakter- en identiteitssysteem met registratie en selectie.
Vereisten
Voordat je begint, zorg je dat het volgende klaarstaat:
- Een FiveM server: met txAdmin geinstalleerd (standaard bij FiveM-serverinstallaties). Je hebt een geldige FiveM-serverlicentie nodig van keymaster.fivem.net.
- MySQL-database: ESX slaat alle data op in MySQL. MariaDB 10.x of MySQL 8.x werkt beide. Maak een lege database aan met een dedicated gebruiker.
- oxmysql: de aanbevolen MySQL-resource voor FiveM. Download de nieuwste release van GitHub.
Stap 1: Database opzetten
Log in op je MySQL-server en maak een database aan:
CREATE DATABASE esx_db;
CREATE USER 'esxuser'@'localhost' IDENTIFIED BY 'sterk_wachtwoord';
GRANT ALL PRIVILEGES ON esx_db.* TO 'esxuser'@'localhost';
FLUSH PRIVILEGES;
Bewaar de databasegegevens; je hebt ze straks nodig voor de configuratie.
Stap 2: oxmysql installeren
Download oxmysql van de GitHub releases-pagina. Pak het archief uit in je resources-map. In je server.cfg voeg je het volgende toe:
set mysql_connection_string "mysql://esxuser:sterk_wachtwoord@localhost/esx_db?charset=utf8mb4"
ensure oxmysql
De connection string verbindt oxmysql met je zojuist aangemaakte database. Zorg dat ensure oxmysql voor alle andere resources staat die de database gebruiken.
Stap 3: ESX Legacy downloaden
Clone of download ESX Legacy van de officiele GitHub-repository (esx-framework). Je krijgt een map met daarin de core resource en de standaard resources (esx_identity, esx_society, esx_vehicleshop, enzovoort). Kopieer alles naar je resources-map.
De mappenstructuur ziet er typisch zo uit:
resources/[esx]/es_extended: het kernframework.resources/[esx]/esx_identity: karakterregistratie.resources/[esx]/esx_skin: karakter-uiterlijk.resources/[esx]/esx_vehicleshop: voertuigwinkel.
Stap 4: server.cfg configureren
Voeg de ESX-resources toe aan je server.cfg in de juiste volgorde. De volgorde is belangrijk omdat resources afhankelijkheden hebben:
ensure oxmysqlensure es_extendedensure esx_identityensure esx_skinensure esx_vehicleshop- Overige ESX-resources
Je kunt ook ensure [esx] gebruiken om alle resources in de esx-map te laden, maar dan heb je minder controle over de volgorde. Bij problemen is het handmatig specificeren betrouwbaarder.
Stap 5: Database-tabellen importeren
ESX Legacy bevat SQL-bestanden die de benodigde tabellen aanmaken. Importeer het hoofdbestand (meestal es_extended.sql) in je database:
mysql -u esxuser -p esx_db < es_extended.sql
Sommige extra resources hebben eigen SQL-bestanden. Controleer elke resource-map op een .sql-bestand en importeer dat ook. De volgorde maakt hier niet uit zolang de hoofdtabellen al bestaan.
Stap 6: Eerste start en verificatie
Start je server via txAdmin en kijk naar de console-output. Let op:
- oxmysql moet succesvol verbinden met de database (een groen bericht in de console).
- es_extended moet laden zonder foutmeldingen.
- De overige resources moeten na es_extended laden.
Verbind met je server via FiveM. Als alles correct is krijg je een karakterregistratiescherm waar je een naam, geboortedatum en geslacht kiest. Na registratie verschijn je in de wereld met het standaard startgeld en kun je de basisfuncties testen.
Veelgemaakte fouten
- Database connection failed: controleer je connection string op typefouten. De meest voorkomende fout is een verkeerd wachtwoord of databasenaam.
- Resource not found: check of de mapnamen exact overeenkomen met de ensure-regels in server.cfg. Hoofdletters en onderstrepingstekens maken verschil.
- es_extended start voor oxmysql: zorg dat oxmysql altijd als eerste wordt geladen in je server.cfg.
Volgende stappen
Met het basisframework draaiend kun je verder bouwen:
- Voeg banen toe via esx_jobs of maak custom banen met het society-systeem.
- Installeer een uitgebreider inventarissysteem zoals ox_inventory.
- Voeg een HUD toe voor geld, gezondheid en informatie.
- Configureer voertuigen, huizen en bedrijven.
Wat is het verschil tussen ESX Legacy en QBCore?
Beide zijn roleplay-frameworks voor FiveM. ESX Legacy is ouder, heeft een grotere community en meer beschikbare resources. QBCore is nieuwer met een modernere codestructuur. De keuze hangt af van voorkeur en welke resources je wilt gebruiken. Veel scripts zijn beschikbaar voor beide frameworks.
Kan ik ESX-resources van anderen installeren?
Ja. Op platforms zoals GitHub, Tebex en het CFX-forum vind je duizenden ESX-compatibele resources, zowel gratis als betaald. Controleer altijd of een resource compatibel is met ESX Legacy (niet de oudere ESX 1.x) en lees reviews voordat je iets installeert. Ongeteste resources van onbekende bronnen kunnen beveiligingsrisico's vormen.
Hoeveel RAM heeft een ESX-server nodig?
Een basis ESX-server met de standaard resources draait op 4 GB RAM. Met uitgebreide scripts, custom voertuigen en veel spelers groeit dat naar 6 tot 8 GB. De database vergt apart geheugen; reken op 1 tot 2 GB extra voor MySQL als die op dezelfde machine draait.
Klaar om je eigen FiveM roleplay server te starten? Bij HostValues FiveM hosting staat txAdmin, MySQL en volledige servertoegang klaar. Je installeert ESX Legacy binnen een uur.
