Resources beheren

Resources beheren

Je hebt resources geinstalleerd op je FiveM server – maar hoe beheer je ze? In deze handleiding leer je hoe je resources kunt starten, stoppen, herladen en verwijderen. Ook leggen we uit hoe je fouten kunt herkennen en oplossen.

Resources starten en stoppen

Je hoeft niet altijd je hele server te herstarten als je een resource wilt starten of stoppen. Via de server console in het panel kun je resources individueel bedienen met commando's.

Via de server console

Ga naar het "Console" tabblad in je panel op mijn.hytalenode.nl. Onderaan zie je een invoerveld waar je commando's kunt typen. Gebruik de volgende commando's:

• ensure resourcenaam – Start een resource. Als de resource al draait, wordt deze eerst gestopt en opnieuw gestart (herstart). Dit is het handigst commando om te onthouden.
• stop resourcenaam – Stopt een draaiende resource. De resource wordt volledig uitgeschakeld totdat je hem weer start.
• start resourcenaam – Start een gestopte resource. Gebruik dit alleen als de resource nog niet draait, anders krijg je een foutmelding.
• restart resourcenaam – Herstart een resource. Dit is hetzelfde als stop gevolgd door start.
• refresh – Scant de resources-map opnieuw. Gebruik dit als je een nieuwe resource hebt geupload maar je server niet wilt herstarten. Na refresh kun je de nieuwe resource starten met ensure.

Voorbeeld: Je hebt een update van esx_policejob geupload en wilt deze herladen zonder de hele server te herstarten. Typ dan in de console:

ensure esx_policejob

Afbeelding: hier moet afbeelding komen met screenshot van de server console in het HytaleNode panel met een ensure commando

Via txAdmin

Als je server txAdmin gebruikt (dit is standaard ingeschakeld op HytaleNode FiveM servers), heb je een extra optie om resources te beheren:

1. Open txAdmin via de link in je panel of door naar het txAdmin-adres te navigeren.
2. Ga naar de "Resources" pagina in het txAdmin menu.
3. Hier zie je een overzicht van alle resources op je server.
4. Je kunt resources starten, stoppen en herstarten met de knoppen naast elke resource.

txAdmin biedt een visueel overzicht en is handig als je snel wilt zien welke resources er draaien en welke niet.

Volgorde van laden (load order)

De volgorde waarin resources worden geladen is heel belangrijk. Resources worden geladen in de volgorde waarin ze in je server.cfg staan. Als een resource afhankelijk is van een andere resource (een dependency), moet die dependency eerder in de lijst staan.

Een goede volgorde voor je server.cfg is:

1. Database resource – oxmysql of mysql-async (bijna alles heeft dit nodig)
2. Hulpbibliotheken – ox_lib en andere libraries
3. Framework – es_extended of qb-core
4. Framework-onderdelen – Inventory, identity, multicharacter
5. Baan-resources – Politie, ambulance, monteur, etc.
6. Overige resources – HUD, chat, extra functionaliteiten

Tip: Als een resource raar doet of niet werkt, controleer dan eerst of alle dependencies erboven staan in de server.cfg.

Fouten herkennen in de console

Als een resource niet goed werkt, geeft de console meestal een foutmelding. Hier zijn de meest voorkomende fouten en wat ze betekenen:

• "Could not find resource [naam]" – De resource-map bestaat niet of de mapnaam komt niet overeen met de naam in server.cfg. Controleer de spelling en of de map op de juiste plek staat.
• "Failed to load script" – Er zit een fout in de scriptcode. Dit kan komen door een ontbrekende dependency of een bug in de resource zelf. Check of alle dependencies geinstalleerd zijn.
• "No such export" – De resource probeert een functie te gebruiken van een andere resource die niet draait of een oudere versie heeft. Zorg dat alle gerelateerde resources up-to-date zijn.
• "SCRIPT ERROR" – Een fout in de Lua/JavaScript code van de resource. Lees de foutmelding goed: er staat meestal een bestandsnaam en regelnummer bij. Dit helpt bij het zoeken naar een oplossing.
• "Access denied" of database-fouten – De resource kan geen verbinding maken met de database. Controleer of je database-gegevens correct zijn ingesteld en of oxmysql of mysql-async goed draait.

Tip: Kopieer de exacte foutmelding en zoek ernaar op Google of het Cfx.re forum. Grote kans dat iemand anders hetzelfde probleem al heeft gehad en een oplossing heeft gedeeld.

Afbeelding: hier moet afbeelding komen met screenshot van een console met een typische resource foutmelding

Resources verwijderen

Wil je een resource volledig van je server verwijderen? Volg dan deze stappen:

1. Stop de resource – Typ stop resourcenaam in de console, of herstart je server na stap 2 en 3.
2. Verwijder de ensure-regel – Open server.cfg en verwijder (of zet een # voor) de regel ensure resourcenaam.
3. Verwijder de bestanden – Ga naar "Bestanden" in het panel, navigeer naar de resource-map in resources/ en verwijder de hele map.
4. Database opruimen (optioneel) – Sommige resources maken tabellen aan in je database. Als je de resource permanent wilt verwijderen, kun je deze tabellen ook verwijderen. Kijk in de documentatie van de resource welke tabellen er zijn aangemaakt.

Let op: Voordat je een resource verwijdert, controleer of andere resources er niet afhankelijk van zijn. Het verwijderen van een dependency kan ervoor zorgen dat andere resources crashen.

Resources updaten

Het is verstandig om je resources regelmatig bij te werken voor bugfixes en nieuwe functies. Om een resource te updaten:

1. Download de nieuwste versie van de resource.
2. Maak een backup van je huidige resource-map (kopieer deze of download via SFTP).
3. Sla je configuratiebestanden apart op (meestal config.lua of config.js). Je wilt je instellingen niet kwijtraken.
4. Vervang de oude bestanden door de nieuwe versie.
5. Zet je configuratie terug of pas de nieuwe configuratie aan met je oude instellingen.
6. Herstart de resource met ensure resourcenaam.

Belangrijk: Lees altijd de changelog of release notes van een update. Soms zijn er database-migraties nodig of zijn configuratie-opties veranderd.