Deze handleiding behandelt resource-ontwikkeling, database-instellingen, admin-tools, spelersbeheer, voertuig- en wapenbeheer, en probleemoplossing voor je alt:V server op Legion Hosting. Voor de initiële serverinstallatie, server.toml-configuratie en verbindingsinstructies, zie alt:V Server Setup Guide.

---

Admin-instellingen

alt:V heeft geen ingebouwd admin-systeem. Admin-functionaliteit wordt geïmplementeerd via resources (scripts) die je maakt of installeert. De meeste gamemodes implementeren hun eigen admin-systeem met rechtenniveaus, rollen en admin-commando's.

Veelgebruikte admin-benaderingen

• Database-gebaseerde rollen: De meeste roleplay- en gamemode-frameworks slaan admin-rollen op in een database. Admins krijgen rollen toegewezen (bijv. moderator, admin, superadmin) die verschillende rechtenniveaus verlenen.
• Configuratiegebaseerde admins: Eenvoudigere setups kunnen een configuratiebestand gebruiken met admin Steam ID's of alt:V ID's met hun rechtenniveaus.
• Console-commando's: De GPanel-serverconsole heeft altijd volledige toegang. Je kunt server-side scripts schrijven die console-invoer accepteren voor admin-bewerkingen.

Een admin-resource instellen

1. Kies of ontwikkel een admin-resource die bij je gamemode past.
2. Upload de resource naar de map resources/ via het tabblad Files of SFTP.
3. Voeg de resourcenaam toe aan de resources-array in server.toml.
4. Configureer de admin-resource (stel je admin Steam/alt:V ID's, rechtenniveaus, enz. in).
5. Herstart de server.

---

Resource-systeem

Resources zijn de kernbouwstenen van alt:V servers. Elke resource is een op zichzelf staande module die server-side code, client-side code, of beide kan bevatten. Resources worden geschreven in JavaScript, TypeScript of C#.

Resource-structuur

resources/
  my-resource/
    resource.toml         <-- Resource configuration (required)
    server/
      index.js            <-- Server-side entry point
      utils.js            <-- Additional server-side files
    client/
      index.js            <-- Client-side entry point (runs in player's GTA V)
    shared/
      config.js           <-- Shared code accessible by both server and client

resource.toml-configuratie

type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]

Velden: type (js of csharp), main (server-side ingangspunt), client-main (client-side ingangspunt, draait in de GTA V van de speler), client-files (bestanden om naar de client te sturen, ondersteunt globs), deps (andere resources die eerst geladen moeten worden).

---

Resources installeren

Om een kant-en-klare resource op je server te installeren:

1. Download de resource-bestanden (meestal een map met resource.toml en scriptbestanden).
2. Stop je server in GPanel.
3. Upload de resource-map naar resources/ via het tabblad Files of SFTP.
4. Voeg de naam van de resource-map toe aan de resources-array in server.toml:

resources = ["existing-resource", "new-resource"]

5. Als de resource afhankelijkheden heeft, zorg ervoor dat deze ook zijn geïnstalleerd en vermeld.
6. Configureer de resource volgens de bijbehorende documentatie (configuratiebestanden, database-instellingen, enz.).
7. Start de server. Controleer de console op berichten over het laden van resources en eventuele fouten.

Een resource verwijderen

1. Stop je server.
2. Verwijder de resourcenaam uit de resources-array in server.toml.
3. Verwijder optioneel de resource-map uit resources/.
4. Start de server.

---

Database-instellingen

De meeste alt:V gamemodes vereisen een database om spelergegevens, voertuigen, inventarissen en andere persistente informatie op te slaan. De twee meest gebruikte databasesystemen voor alt:V zijn MongoDB en MySQL/MariaDB.

MongoDB

MongoDB is een NoSQL-documentdatabase die veel wordt gebruikt met JavaScript/TypeScript-resources. Gebruik een beheerde service zoals MongoDB Atlas (gratis tier beschikbaar) of een zelf gehoste instantie. Verkrijg je verbindingsstring (bijv. mongodb+srv://user:[email protected]/mydb) en configureer deze in het configuratiebestand van je resource. Node.js-resources gebruiken het mongodb npm-pakket.

MySQL / MariaDB

MySQL wordt veel gebruikt met C#-resources en sommige JavaScript-frameworks. Verkrijg een database van een beheerde service of zelf gehoste instantie, configureer je resources met de verbindingsgegevens (host, port, gebruikersnaam, wachtwoord, databasenaam) en voer eventuele vereiste SQL-migratiescripts uit.

---

Spelersbeheer

Spelersbeheer in alt:V wordt afgehandeld via je resources. Veelvoorkomende bewerkingen zijn:

Spelers identificeren

alt:V biedt verschillende identificatoren voor elke verbonden speler:

Kicken en bannen

Implementeer kick- en banfunctionaliteit in je resources:

import alt from "alt-server";

// Kick a player
player.kick("Reason for kick");

// Ban check on connect (store bans in database)
alt.on("playerConnect", (player) => {
    if (isPlayerBanned(player.socialID)) {
        player.kick("You are banned from this server.");
    }
});

---

Voertuig- en wapenbeheer

Voertuigen en wapens worden beheerd via server-side scripts. alt:V geeft je volledige controle over het spawnen, aanpassen en verwijderen van voertuigen en wapens.

Voertuigen spawnen

import alt from "alt-server";

// Spawn a vehicle at a position
const vehicle = new alt.Vehicle(
    "sultan",            // Vehicle model name
    0, 0, 72,           // Position (x, y, z)
    0, 0, 0             // Rotation (rx, ry, rz)
);
vehicle.numberPlateText = "LEGION";

Wapens geven

// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);

// Remove all weapons
player.removeAllWeapons();

Voertuigpersistentie

Standaard bestaan voertuigen alleen in het servergeheugen en gaan verloren bij een herstart. Om voertuigen te behouden over herstarts heen, sla hun gegevens op (model, positie, aanpassingen, eigenaar) in een database en maak ze opnieuw aan bij het starten van de server.

---

Probleemoplossing

Resources laden niet

• Controleer of de resourcenaam in server.toml exact overeenkomt met de mapnaam in resources/.
• Controleer of de resource een geldig resource.toml-bestand heeft met correcte type- en main-velden.
• Controleer de console op foutmeldingen tijdens het laden van resources. Syntaxfouten in scripts voorkomen dat de resource start.
• Zorg ervoor dat alle afhankelijkheden die in deps staan vermeld, geïnstalleerd en geladen zijn.
• Controleer of de juiste module is geladen in server.toml (js-module voor JavaScript, csharp-module voor C#).

Spelers kunnen niet verbinden

• Controleer of de server draait en als online wordt weergegeven in GPanel.
• Controleer of spelers de alt:V launcher gebruiken, niet de gewone GTA V launcher.
• Zorg ervoor dat de alt:V serverbranch overeenkomt met wat spelers hebben (release, rc of dev). Niet-overeenkomende branches voorkomen verbindingen.
• Als de server met een wachtwoord is beveiligd, controleer of spelers het juiste wachtwoord invoeren.
• Laat spelers directe verbinding proberen met het IP en de port. Zie How to Find Your Server IP and Port.

Server crasht

• Controleer de console op foutmeldingen vóór de crash.
• Defecte resources zijn de meest voorkomende oorzaak van crashes. Schakel recentelijk toegevoegde resources uit om het probleem te isoleren.
• Zorg ervoor dat je serverbestanden up-to-date zijn. Activeer een herinstallatie vanuit het Startup-tabblad indien nodig.
• Geheugenlekken in resources kunnen ervoor zorgen dat de server na verloop van tijd geen RAM meer heeft. Monitor de GPanel-resourcegrafieken op gestaag toenemend geheugengebruik.

Database- en spraakproblemen

• Controleer de database-inloggegevens en verbindingsstrings. Voor MongoDB Atlas, voeg het IP van je server toe aan de whitelist in de netwerktoeganginstellingen.
• Controleer de console op foutmeldingen over de databaseverbinding.
• Spraakchat vereist de sectie [voice] in server.toml plus resources die spraakkanaallogica implementeren. De configuratie alleen stelt alleen de infrastructuur in.

Prestatieproblemen

• Profileer je resources op dure bewerkingen (zware loops, synchrone database-aanroepen, overmatig aanmaken van entiteiten).
• Gebruik alt.setInterval en alt.setTimeout spaarzaam. Zware bewerkingen per tick zijn de meest voorkomende oorzaak van prestatieproblemen.
• Monitor de GPanel-resourcegrafieken op CPU- en RAM-gebruik.
• Overweeg je serverplan te upgraden voor hoge speleraantallen. Open een supportticket om de opties te bespreken.

---

Gerelateerde artikelen

• alt:V Server Setup Guide — Initiële installatie, server.toml-configuratie, spraakchat en verbindingsinstructies
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Server Startup Guide — Algemene handleiding voor het starten van elke gameserver op Legion Hosting

---

Meer hulp nodig?

Als je problemen ondervindt die niet in deze handleiding worden behandeld, staat ons supportteam klaar om je te helpen. Open een ticket op legionhosting.net/submitticket.php met je servergegevens, een beschrijving van het probleem en eventuele relevante foutmeldingen uit de GPanel-console.