Je kunt resources gebruiken om je FiveM-gameserver uit te breiden met extra functies. Dat is vooral interessant als je grotere projecten plant, zoals een roleplayserver of iets vergelijkbaars. Zulke projecten zijn bijna niet mogelijk zonder extra resources.
FiveM en de community bieden een enorme keuze aan resources. Je vindt een overzicht van de populairste resources op het Cfx.re-forum: https://forum.cfx.re/c/development/releases/7
De snelste manier om een resource te installeren is met de FiveM Resource Installer in het dashboard. Upload het ZIP-archief en de installer plaatst de resource in de juiste map, voegt deze toe aan de server.cfg en importeert meegeleverde SQL-bestanden desgewenst in je database. Hieronder vind je de klassieke methode via SFTP.
De Resource Installer is beschikbaar voor FiveM-servers. Gebruik voor FiveM Enhanced en RedM de methode via SFTP.
Open het dashboard van je FiveM-server, ga naar het tabblad Tools en selecteer FiveM Resource Installer. Je hoeft je server hiervoor niet te stoppen.
Je moet hiervoor eerst een serversjabloon (Recipe) in txAdmin hebben ingesteld. Pas dan zijn er een server.cfg en een map resources waar de installer bestanden naartoe kan schrijven.
Upload de resource als ZIP-archief. Een download van GitHub via Code → Download ZIP of een ZIP-bestand van een release werkt direct.
- ZIP-bestanden tot 100 MB zijn toegestaan (uitgepakt maximaal 400 MB en 5.000 bestanden).
- Pak RAR- en 7z-archieven eerst opnieuw in als ZIP.
- De installer verwijdert overbodige tussenliggende mappen (bijvoorbeeld
mijn-resource-main) zelf en verwijdert versienummers en-mainuit de naam. - Bevat een archief meerdere resources, dan worden deze afzonderlijk weergegeven en op basis van hun afhankelijkheden gesorteerd.
- Uitvoerbare bestanden zoals
.exe,.batof.shworden nooit naar je server geschreven.
Voordat er iets wordt geïnstalleerd, laat de installer zien wat er in het archief zit:
- Naam en doelmap: De naam mag letters, cijfers en
_,.en-bevatten (maximaal 64 tekens). Selecteer onder Map in resources/ de categor map, bijvoorbeeld[standalone]. Als het archief er geen bevat, is[local]standaard geselecteerd. Met Direct in resources/ (zonder map) wordt de resource zonder categor map geplaatst. - Afhankelijkheden: Voor elke afhankelijkheid (bijvoorbeeld ESX, QBCore, Qbox, ox_lib, oxmysql) zie je of deze in het archief zit, op de server aanwezig is of op de server ontbreekt. Afhankelijkheden die alleen in de code voorkomen en niet in de
fxmanifest.luastaan, worden als vermoedelijk gemarkeerd. - Beveiligingsscan: De installer controleert alle
.lua- en.js-bestanden op bekende patronen van schadelijke code. Als er iets wordt gevonden, krijg je een waarschuwing. Je kunt de installatie toch uitvoeren, maar de beveiligingsscan schakelt de resource uit bij de volgende serverstart. Denk je dat het om een vals alarm gaat? Neem dan contact op met onze support. - SQL-bestanden: Meegeleverde
.sql-bestanden worden weergegeven, met informatie over de tabellen die ze aanmaken, wijzigen of vullen.
Als de resource al op je server staat, breekt de installer standaard af. Wil je de resource vervangen (bijvoorbeeld voor een update), vink dan Bestaande resource overschrijven aan. De volledige map wordt dan vervangen, inclusief je instellingen zoals config.lua. De oude map wordt eerst als archief opgeslagen onder backups/resource-installer/.
Laat Toevoegen aan server.cfg zodat de resource automatisch start aangevinkt. De installer voegt dan ensure <Name> toe aan de server.cfg van je actieve servermap, na de afhankelijkheden van de resource. De oude server.cfg wordt eerst opgeslagen als server.cfg.bak-….
Klik op Op de server installeren. Je ziet de voortgang (back-up maken, uitpakken, plaatsen, server.cfg aanvullen, resultaat controleren). De installatie gaat door, ook als je de pagina sluit.
In het resultaat zie je hoe de resource wordt gestart:
- ensure-regel toegevoegd aan server.cfg: alles is klaar.
- stond al in server.cfg: de regel was al aanwezig.
- start via de categoriemap:
ensure [Categorie]staat al in jeserver.cfg; hiermee wordt de resource ook gestart. - ensure-regel ontbreekt nog: voeg zelf
ensure <Name>toe aan deserver.cfg(zie Activeren).
Start de server opnieuw via Server opnieuw starten, zodat FiveM de nieuwe resource laadt. Je kunt ook refresh en daarna ensure <Name> invoeren in de liveconsole.
Heeft de resource een database nodig, dan kun je het SQL-bestand rechtstreeks vanuit de installer importeren. Dit gebeurt niet automatisch: je moet bij het betreffende bestand op In database importeren klikken.
- Selecteer de database van je server. De hoofddatabase is standaard geselecteerd. Heeft je server nog geen database, maak er dan een aan via Database aanmaken op het tabblad Databases.
- Als er al tabellen uit het bestand bestaan, wordt dit in het dialoogvenster weergegeven. Laat dan Bestaande tabellen overslaan (aanbevolen) geselecteerd. Zo blijven bestaande tabellen en hun gegevens ongewijzigd.
- Met een actieve ZapX Pass wordt er vóór de import automatisch een back-up van de database gemaakt. Zonder Pass bevestig je Ik importeer zonder Backup.
- Klik op Nu importeren.
Per bestand zijn maximaal 2 MB en 5.000 SQL-instructies toegestaan. Importeer grotere bestanden via phpMyAdmin, zoals beschreven in FiveM: een SQL-bestand importeren.
De import wordt altijd uitgevoerd in de geselecteerde database. Regels zoals CREATE DATABASE … of USE … zijn daarom niet toegestaan. Als zo'n regel in het bestand staat, wordt deze niet geïmporteerd. Verwijder de regels, maak opnieuw een ZIP-bestand en upload het opnieuw.
| Melding of probleem | Oplossing |
|---|---|
| RAR- en 7z-archieven worden niet ondersteund | Pak het archief uit en pak de map opnieuw in als ZIP. |
| Dit archief kan niet worden geïnstalleerd | Controleer de naam en doelmap. Staat er al een resource met dezelfde naam in een andere map, geef de nieuwe dan een andere naam of verwijder de oude. Bevat het archief geen fxmanifest.lua (of __resource.lua), dan is het geen resource maar bijvoorbeeld alleen een map- of voertuigbestand. |
| Afhankelijkheid ontbreekt op de server | Installeer eerst de ontbrekende resource (bijvoorbeeld ox_lib), ook met de installer. Zonder deze resource start de andere resource meestal niet. |
| Melding over een ontbrekende Recipe of een ontbrekend serversjabloon | Stel eerst een serversjabloon in txAdmin in en open daarna de installer opnieuw. |
| Op deze server is al een installatie bezig | Wacht tot de installatie is voltooid. De voortgang blijft op de pagina zichtbaar. |
| Installatie is onderbroken of mislukt | Controleer de server en start de installatie opnieuw. Als een bestaande resource is overschreven, herstelt de installer de oude map bij een fout. |
| SQL: USE is niet toegestaan of Databases aanmaken, wijzigen of verwijderen is niet toegestaan | Verwijder de regels USE en CREATE DATABASE uit het SQL-bestand en upload de ZIP opnieuw. |
| SQL: Mislukt op regel … | De instructies tot aan deze regel zijn al uitgevoerd. Corrigeer het bestand en start de import opnieuw, met Bestaande tabellen overslaan geselecteerd. |
| Resource start niet na het opnieuw opstarten | Controleer de foutmelding in de liveconsole, of alle afhankelijkheden actief zijn en of de ensure-regel na de afhankelijkheden staat. Hulp bij veelvoorkomende fouten: FiveM: veelvoorkomende problemen. |
Wil je een archief eerst controleren zonder het te installeren? Met onze gratis tool FiveM Resource Installer analyseer je het rechtstreeks in je browser, zonder iets te uploaden.
Voorkeursbron bij Google
