Deze handleiding behandelt alles wat je nodig hebt om je alt:V server op Legion Hosting draaiend te krijgen, van de eerste opstart en server.toml-configuratie tot gamemode-resources, CDN-instellingen, spraakchat en hoe spelers verbinding maken via de alt:V launcher. Voor resource-ontwikkeling, database-instellingen en admin-beheer, zie alt:V Admin and Resource Setup.
Wat is alt:V?
alt:V is een gratis, open-source multiplayermodificatie voor Grand Theft Auto V. Het stelt spelers in staat om verbinding te maken met aangepaste servers die unieke gamemodes draaien zoals roleplay (RP), deathmatch, racen, freeroam en meer. De server draait aangepaste resources geschreven in JavaScript, TypeScript of C#, waardoor servereigenaren volledige controle hebben over de gameplay-logica. Spelers verbinden via de alt:V launcher, die GTA V aanpast voor multiplayerconnectiviteit.
Eerste start
Wanneer je je alt:V server voor het eerst ontvangt, volg deze stappen om hem online te krijgen:
- Log in op GPanel en selecteer je alt:V server.
- Ga naar het tabblad Startup en configureer je servernaam, maximaal aantal spelers en andere opstartvariabelen.
- Ga naar het tabblad Console en klik op Start.
- De server zal bij de eerste opstart de alt:V serverbestanden downloaden. Dit kan enkele minuten duren.
- Zodra de console aangeeft dat de server luistert en klaar is voor verbindingen, is je server online.
- Standaard start de server zonder gamemode-resources. Je moet resources toevoegen om gameplay te creëren. Zie alt:V Admin and Resource Setup voor details.
GPanel opstartvariabelen
alt:V biedt verschillende configuratieopties als opstartvariabelen in GPanel. Ga naar het tabblad Startup om deze aan te passen. Wijzigingen vereisen een serverherstart.
| Variabele | Standaard | Beschrijving |
|---|---|---|
PASSWORD |
ChangeMe |
Wachtwoord om de server te betreden. Minimaal 6 tekens. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Serverbeschrijving weergegeven in de alt:V serverbrowser. |
BUILD |
release |
De alt:V serverbranch: release (stabiel), rc (release candidate), of dev (ontwikkeling). |
Serverconfiguratie (server.toml)
Het primaire configuratiebestand voor alt:V servers is server.toml, dat zich bevindt in de hoofdmap van de server. Je kunt dit bestand bewerken via het tabblad Files in GPanel of via SFTP.
Voorbeeld server.toml
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]Belangrijke instellingen: name (weergavenaam in browser), host (houd op 0.0.0.0), port (moet overeenkomen met GPanel), players (maximaal aantal), password (leeg voor publiek), announce (true om in de browser te verschijnen), token (announce token van de alt:V website, vereist voor browservermelding), gamemode (browserlabel zoals "Roleplay"), modules (scriptmodules: js-module of csharp-module), resources (array van resource-mappen om te laden) en tags (browserfiltertags).
Announce Token
Om je server in de alt:V serverbrowser te laten verschijnen, heb je een announce token nodig van de alt:V masterserver:
- Bezoek de alt:V website en log in of maak een account aan.
- Ga naar het serverbeheersgedeelte en genereer een nieuw servertoken.
- Kopieer het token en plak het in het veld
tokenin jeserver.toml. - Zorg ervoor dat
announce = truein je configuratie staat. - Herstart de server. Deze zou nu in de publieke browser moeten verschijnen.
server.toml staan.
Gamemode-resources
alt:V servers worden aangedreven door resources — scripts die alle gameplay-logica definiëren. Zonder resources heeft een server geen aangepaste functionaliteit. Resources worden geplaatst in de map resources/.
Resource-structuur
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)Resources laden
Voeg resourcenamen toe aan de resources-array in server.toml om ze bij het opstarten te laden:
resources = ["chat", "freeroam", "spawn"]Elke resource moet een resource.toml-bestand in zijn map hebben dat het type, de afhankelijkheden en de script-ingangspunten definieert. Voor details over het aanmaken en beheren van resources, zie alt:V Admin and Resource Setup.
CDN-instellingen
alt:V gebruikt een CDN-mechanisme om client-side bestanden (modellen, textures, scripts) aan verbindende spelers te serveren. De ingebouwde CDN serveert bestanden rechtstreeks vanaf de server zonder extra configuratie — dit is de standaardinstelling en werkt goed voor de meeste servers. Voor grootschalige servers met veel aangepaste assets kun je optioneel een externe CDN configureren door clientbestanden te uploaden naar een webserver en de CDN-URL in te stellen in je resource-configuratie, waardoor het bandbreedtegebruik van de gameserver wordt verminderd.
Spraakchat
alt:V bevat een ingebouwd spraakchatsysteem dat positionele (3D) spraakcommunicatie tussen spelers mogelijk maakt. Spraakchat wordt ingeschakeld en geconfigureerd in server.toml.
Spraakconfiguratie
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0De bitrate regelt de spraakkwaliteit (64000 is standaard). De external*-velden configureren een externe spraakserver — laat ze leeg/nul om de ingebouwde spraakserver te gebruiken, wat wordt aanbevolen voor de meeste setups. De optie voor een externe spraakserver is alleen nodig voor geavanceerde configuraties waarbij spraakverwerking wordt uitbesteed aan een aparte machine.
Hoe spelers verbinden
Spelers verbinden met alt:V servers via de alt:V launcher, niet rechtstreeks via GTA V.
Via de serverbrowser
- Download en installeer de alt:V launcher van altvmp.com.
- Start de alt:V launcher. Deze detecteert en verifieert de GTA V-installatie.
- Blader vanuit de launcher door de Server Browser.
- Zoek je server op naam of gebruik filters (gamemode, tags, speleraantal).
- Klik op je server en selecteer Connect.
- Als de server een wachtwoord heeft, wordt de speler gevraagd dit in te voeren.
- GTA V wordt gestart met de alt:V multiplayermod en maakt verbinding met je server.
Via directe verbinding
- Selecteer in de alt:V launcher Direct Connect.
- Voer het IP-adres en de port van je server in het formaat
IP:PORTin (bijv.192.168.1.1:7788). - Klik op Connect.
Om het IP-adres en de port van je server te vinden, zie How to Find Your Server IP and Port.
announce = true in je server.toml staat en dat je een geldig announce token hebt. Het kan een minuut duren voordat de server zich registreert na het opstarten. Controleer de console op verbindingsfouten met de masterserver. Let op dat je port willekeurig wordt toegewezen tenzij je een privé-IP hebt -- controleer GPanel voor de juiste waarde.
Maximaal aantal spelers en prestaties
alt:V servers kunnen hoge speleraantallen ondersteunen, maar de prestaties zijn sterk afhankelijk van je resources en serverplan:
- 32–128 spelers: Een gebruikelijk bereik voor de meeste servers. Eenvoudige gamemodes draaien soepel bij hogere aantallen.
- 128–512+ spelers: Mogelijk voor geoptimaliseerde servers met efficiënte resources. Vereist meer CPU en RAM.
- Resource-efficiëntie: Slecht geoptimaliseerde scripts zijn de voornaamste oorzaak van prestatieproblemen. Server-side scripts die zware bewerkingen uitvoeren bij elke tick of grote datastructuren in het geheugen bijhouden, kunnen de server vertragen.
- Databasequery's: Gamemodes die databases gebruiken (MySQL, MongoDB) moeten asynchrone query's gebruiken om blokkering van de hoofdthread te voorkomen.
Gerelateerde artikelen
- alt:V Admin and Resource Setup — Resource-ontwikkeling, database-instellingen, admin-tools en probleemoplossing
- 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 en een beschrijving van het probleem.
