Resources installeren

Resources installeren

Je hebt een gave resource gevonden en wilt deze op je FiveM server installeren? In deze handleiding leggen we stap voor stap uit hoe je dat doet via het HytaleNode panel op mijn.hytalenode.nl.

Stap 1: Resource downloaden

Download eerst de resource die je wilt installeren. Dit is afhankelijk van waar je de resource vandaan haalt:

• GitHub: Ga naar de repository van de resource. Klik op de groene knop "Code" en kies "Download ZIP". Het ZIP-bestand wordt nu gedownload naar je computer.
• Cfx.re Forums: Volg de downloadlink in het forum-bericht. Dit verwijst meestal naar GitHub of een directe download.
• Tebex/betaalde resources: Na aankoop krijg je een downloadlink. Volg de instructies van de verkoper.

Afbeelding: hier moet afbeelding komen met screenshot van GitHub repository met de groene "Code" knop en "Download ZIP" optie

Stap 2: Bestand uitpakken

Het gedownloade bestand is meestal een .zip bestand. Pak dit uit op je computer:

• Windows: Klik met de rechtermuisknop op het ZIP-bestand en kies "Alles uitpakken".
• Mac: Dubbelklik op het ZIP-bestand om het uit te pakken.

Na het uitpakken heb je een map met de resource-bestanden. De mapnaam bevat vaak "-main" of "-master" (bijvoorbeeld esx_policejob-main). Hernoem de map naar de juiste resource-naam door het achtervoegsel te verwijderen (dus esx_policejob). Dit is belangrijk, want de mapnaam is de naam waarmee FiveM de resource herkent.

Stap 3: Resource uploaden naar je server

Nu moet je de resource-map uploaden naar je FiveM server. Dit kan op twee manieren:

Optie A: Via de Bestanden tab in het panel

1. Log in op mijn.hytalenode.nl en ga naar je FiveM server.
2. Klik op het tabblad "Bestanden" in het linkermenu.
3. Navigeer naar de map resources/. Je ziet hier waarschijnlijk submappen zoals [local], [standalone] of framework-specifieke mappen.
4. Ga naar de submap waar je de resource wilt plaatsen (bijvoorbeeld [local] voor eigen resources).
5. Klik op de "Uploaden" knop en upload de bestanden van je resource. Let op: als het een grote resource is met veel bestanden, is SFTP sneller en betrouwbaarder (zie optie B).

Afbeelding: hier moet afbeelding komen met screenshot van de Bestanden tab in het HytaleNode panel met de resources map open

Optie B: Via SFTP (aanbevolen voor grotere resources)

1. Download en installeer een SFTP-programma zoals WinSCP (Windows) of FileZilla (Windows/Mac).
2. Ga in het panel naar "Instellingen" en zoek je SFTP-gegevens (host, poort, gebruikersnaam). Je wachtwoord is hetzelfde als je panel-wachtwoord.
3. Verbind met je server via SFTP.
4. Navigeer naar de map resources/[local]/ (of een andere submap naar keuze).
5. Sleep de resource-map vanaf je computer naar de SFTP-client om te uploaden.

Tip: Het is slim om je eigen resources in een submap zoals [local] te plaatsen. Zo houd je ze gescheiden van framework-resources en kun je ze makkelijker terugvinden. FiveM laadt automatisch alle submappen binnen resources/.

Stap 4: Resource activeren in server.cfg

De resource staat nu op je server, maar FiveM weet nog niet dat hij geladen moet worden. Dat stel je in via het server.cfg bestand:

1. Ga naar "Bestanden" in het panel.
2. Open het bestand server.cfg (staat in de hoofdmap van je server).
3. Voeg onderaan (of bij de andere ensure regels) de volgende regel toe:

ensure resourcenaam

Vervang resourcenaam door de exacte mapnaam van je resource. Bijvoorbeeld:

ensure esx_policejob

Belangrijk: De naam achter ensure moet exact overeenkomen met de mapnaam van de resource. Let op hoofd- en kleine letters.

Stap 5: Server herstarten

Om de nieuwe resource te laden, moet je je server herstarten:

1. Ga naar het "Console" tabblad in je panel.
2. Klik op de "Herstarten" knop bovenaan de pagina.
3. Wacht tot de server volledig is opgestart.

Je kunt in de console zien of de resource succesvol is geladen. Als alles goed gaat, zie je een melding dat de resource is gestart. Als er een fout is, zie je een rode foutmelding – lees deze goed door, want die vertelt je vaak precies wat er mis is.

Dependencies controleren

Veel resources hebben dependencies – andere resources die eerst geladen moeten zijn. Controleer altijd de README of documentatie van de resource die je installeert. Veel voorkomende dependencies zijn:

• oxmysql of mysql-async – voor database-verbinding
• es_extended of qb-core – het framework zelf
• ox_lib – een veelgebruikte hulpbibliotheek

Als een dependency ontbreekt, krijg je een foutmelding in de console. Installeer dan eerst de ontbrekende resource met dezelfde stappen als hierboven, en zorg dat deze boven de afhankelijke resource in je server.cfg staat (zodat deze eerst wordt geladen).

Tip: Installeer resources een voor een en herstart je server na elke installatie. Zo kun je direct zien of een resource problemen veroorzaakt, in plaats van alles tegelijk te moeten debuggen.