Diese Anleitung behandelt alles, was Sie benötigen, um Ihren alt:V Server auf Legion Hosting zum Laufen zu bringen, von der ersten Inbetriebnahme und server.toml-Konfiguration bis hin zu Spielmodus-Ressourcen, CDN-Einrichtung, Voice-Chat und wie Spieler sich über den alt:V Launcher verbinden. Für Ressourcenentwicklung, Datenbankeinrichtung und Admin-Verwaltung siehe alt:V Admin- und Ressourcen-Einrichtung.

Was ist alt:V?

alt:V ist eine kostenlose, quelloffene Multiplayer-Modifikation für Grand Theft Auto V. Sie ermöglicht es Spielern, sich mit benutzerdefinierten Servern zu verbinden, die einzigartige Spielmodi wie Roleplay (RP), Deathmatch, Rennen, Freeroam und mehr anbieten. Der Server führt benutzerdefinierte Ressourcen aus, die in JavaScript, TypeScript oder C# geschrieben sind, und gibt Serverbetreibern die volle Kontrolle über die Spiellogik. Spieler verbinden sich über den alt:V Launcher, der GTA V für die Multiplayer-Konnektivität modifiziert.

Erster Start

Wenn Sie Ihren alt:V-Server zum ersten Mal erhalten, befolgen Sie diese Schritte, um ihn online zu bringen:

1. Melden Sie sich bei GPanel an und wählen Sie Ihren alt:V-Server aus.
2. Navigieren Sie zum Startup-Tab und konfigurieren Sie Ihren Servernamen, maximale Spieleranzahl und andere Startvariablen.
3. Gehen Sie zum Console-Tab und klicken Sie auf Start.
4. Der Server lädt beim ersten Start die alt:V-Serverdateien herunter. Dies kann einige Minuten dauern.
5. Sobald die Konsole anzeigt, dass der Server lauscht und für Verbindungen bereit ist, ist Ihr Server online.
6. Standardmäßig startet der Server ohne Spielmodus-Ressourcen. Sie müssen Ressourcen hinzufügen, um Gameplay zu erstellen. Siehe alt:V Admin- und Ressourcen-Einrichtung für Details.

GPanel-Startvariablen

alt:V bietet mehrere Konfigurationsoptionen als Startvariablen in GPanel an. Navigieren Sie zum Startup-Tab, um diese zu ändern. Änderungen erfordern einen Serverneustart.

Serverkonfiguration (server.toml)

Die primäre Konfigurationsdatei für alt:V-Server ist server.toml, die sich im Server-Stammverzeichnis befindet. Sie können diese Datei über den Files-Tab in GPanel oder via SFTP bearbeiten.

Beispiel 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"]

Wichtige Einstellungen: name (Anzeigename im Browser), host (auf 0.0.0.0 belassen), port (muss mit GPanel übereinstimmen), players (maximale Anzahl), password (leer für öffentlich), announce (true um im Browser zu erscheinen), token (Announce-Token von der alt:V-Website, erforderlich für Browser-Listung), gamemode (Browser-Label wie "Roleplay"), modules (Skriptmodule: js-module oder csharp-module), resources (Array der zu ladenden Ressourcenordner) und tags (Browser-Filtertags).

Announce-Token

Damit Ihr Server im alt:V-Serverbrowser erscheint, benötigen Sie einen Announce-Token vom alt:V-Masterserver:

1. Besuchen Sie die alt:V-Website und melden Sie sich an oder erstellen Sie ein Konto.
2. Navigieren Sie zum Serververwaltungsbereich und generieren Sie einen neuen Server-Token.
3. Kopieren Sie den Token und fügen Sie ihn in das token-Feld in Ihrer server.toml ein.
4. Stellen Sie sicher, dass announce = true in Ihrer Konfiguration steht.
5. Starten Sie den Server neu. Er sollte nun im öffentlichen Browser erscheinen.

Spielmodus-Ressourcen

alt:V-Server werden von Ressourcen angetrieben — Skripten, die die gesamte Spiellogik definieren. Ohne Ressourcen hat ein Server keine benutzerdefinierten Funktionen. Ressourcen werden im resources/-Verzeichnis abgelegt.

Ressourcenstruktur

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)

Ressourcen laden

Fügen Sie Ressourcennamen zum resources-Array in server.toml hinzu, um sie beim Start zu laden:

resources = ["chat", "freeroam", "spawn"]

Jede Ressource muss eine resource.toml-Datei in ihrem Verzeichnis haben, die ihren Typ, Abhängigkeiten und Skript-Einstiegspunkte definiert. Für Details zum Erstellen und Verwalten von Ressourcen siehe alt:V Admin- und Ressourcen-Einrichtung.

CDN-Einrichtung

alt:V verwendet einen CDN-Mechanismus, um clientseitige Dateien (Modelle, Texturen, Skripte) an verbindende Spieler auszuliefern. Das integrierte CDN liefert Dateien direkt vom Server ohne zusätzliche Konfiguration — dies ist die Standardeinstellung und funktioniert für die meisten Server gut. Für große Server mit vielen benutzerdefinierten Assets können Sie optional ein externes CDN konfigurieren, indem Sie Client-Dateien auf einen Webserver hochladen und die CDN-URL in Ihrer Ressourcenkonfiguration einstellen, um die Bandbreitennutzung des Gameservers zu reduzieren.

Voice-Chat

alt:V enthält ein integriertes Voice-Chat-System, das positionsbezogene (3D) Sprachkommunikation zwischen Spielern ermöglicht. Voice-Chat wird in server.toml aktiviert und konfiguriert.

Voice-Konfiguration

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

Die bitrate steuert die Sprachqualität (64000 ist Standard). Die external*-Felder konfigurieren einen externen Voice-Server — lassen Sie diese leer/null, um den integrierten Voice-Server zu verwenden, was für die meisten Setups empfohlen wird. Die externe Voice-Server-Option wird nur für fortgeschrittene Konfigurationen benötigt, bei denen die Sprachverarbeitung auf eine separate Maschine ausgelagert wird.

Wie Spieler sich verbinden

Spieler verbinden sich mit alt:V-Servern über den alt:V Launcher, nicht direkt über GTA V.

Über den Serverbrowser

1. Laden Sie den alt:V Launcher von altvmp.com herunter und installieren Sie ihn.
2. Starten Sie den alt:V Launcher. Er erkennt und überprüft die GTA V-Installation.
3. Durchsuchen Sie im Launcher den Server Browser.
4. Suchen Sie nach Ihrem Server per Name oder verwenden Sie Filter (Spielmodus, Tags, Spieleranzahl).
5. Klicken Sie auf Ihren Server und wählen Sie Connect.
6. Wenn der Server ein Passwort hat, wird der Spieler aufgefordert, es einzugeben.
7. GTA V wird mit dem alt:V-Multiplayer-Mod gestartet und verbindet sich mit Ihrem Server.

Über Direktverbindung

1. Wählen Sie im alt:V Launcher Direct Connect.
2. Geben Sie die IP-Adresse und den Port Ihres Servers im Format IP:PORT ein (z.B. 192.168.1.1:7788).
3. Klicken Sie auf Connect.

Um die IP-Adresse und den Port Ihres Servers zu finden, siehe Server-IP und Port finden.

Maximale Spieleranzahl und Leistung

alt:V-Server können hohe Spielerzahlen unterstützen, aber die Leistung hängt stark von Ihren Ressourcen und Ihrem Serverplan ab:

• 32–128 Spieler: Ein gängiger Bereich für die meisten Server. Einfache Spielmodi laufen bei höheren Zahlen reibungslos.
• 128–512+ Spieler: Möglich für optimierte Server mit effizienten Ressourcen. Erfordert mehr CPU und RAM.
• Ressourceneffizienz: Schlecht optimierte Skripte sind die Hauptursache für Leistungsprobleme. Serverseitige Skripte, die jeden Tick aufwendige Operationen ausführen oder große Datenstrukturen im Speicher halten, können den Server ausbremsen.
• Datenbankabfragen: Spielmodi, die Datenbanken (MySQL, MongoDB) verwenden, sollten asynchrone Abfragen nutzen, um das Blockieren des Haupt-Threads zu vermeiden.

Verwandte Artikel

• alt:V Admin- und Ressourcen-Einrichtung — Ressourcenentwicklung, Datenbankeinrichtung, Admin-Tools und Fehlerbehebung
• Server-IP und Port finden
• Dateien via SFTP hochladen
• Server-Startanleitung — Allgemeine Anleitung zum Starten eines beliebigen Gameservers auf Legion Hosting

Weitere Hilfe benötigt?

Wenn Sie Probleme haben, die in dieser Anleitung nicht behandelt werden, steht Ihnen unser Support-Team zur Verfügung. Eröffnen Sie ein Ticket unter legionhosting.net/submitticket.php mit Ihren Serverdetails und einer Beschreibung des Problems.