Ce guide couvre tout ce dont vous avez besoin pour faire fonctionner votre serveur alt:V sur Legion Hosting, du premier démarrage et de la configuration du server.toml aux ressources de gamemode, à la configuration CDN, au chat vocal, et à la façon dont les joueurs se connectent via le lanceur alt:V. Pour le développement de ressources, la configuration de base de données et la gestion d'administration, consultez alt:V Admin and Resource Setup.

Qu'est-ce qu'alt:V ?

alt:V est une modification multijoueur gratuite et open-source pour Grand Theft Auto V. Elle permet aux joueurs de se connecter à des serveurs personnalisés exécutant des modes de jeu uniques tels que le roleplay (RP), le deathmatch, les courses, le freeroam, et bien plus encore. Le serveur exécute des ressources personnalisées écrites en JavaScript, TypeScript ou C#, offrant aux propriétaires de serveurs un contrôle total sur la logique de jeu. Les joueurs se connectent via le lanceur alt:V, qui modifie GTA V pour la connectivité multijoueur.

Premier démarrage

Lorsque vous recevez votre serveur alt:V pour la première fois, suivez ces étapes pour le mettre en ligne :

1. Connectez-vous à GPanel et sélectionnez votre serveur alt:V.
2. Accédez à l'onglet Startup et configurez le nom de votre serveur, le nombre maximum de joueurs et les autres variables de démarrage.
3. Allez dans l'onglet Console et cliquez sur Start.
4. Le serveur téléchargera les fichiers du serveur alt:V lors du premier démarrage. Cela peut prendre quelques minutes.
5. Une fois que la console affiche que le serveur est en écoute et prêt pour les connexions, votre serveur est en ligne.
6. Par défaut, le serveur démarre sans ressources de gamemode. Vous devrez ajouter des ressources pour créer du gameplay. Consultez alt:V Admin and Resource Setup pour plus de détails.

Variables de démarrage GPanel

alt:V expose plusieurs options de configuration en tant que variables de démarrage dans GPanel. Accédez à l'onglet Startup pour les modifier. Les changements nécessitent un redémarrage du serveur.

Configuration du serveur (server.toml)

Le fichier de configuration principal des serveurs alt:V est server.toml, situé dans le répertoire racine du serveur. Vous pouvez modifier ce fichier via l'onglet Files dans GPanel ou via SFTP.

Exemple de 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"]

Paramètres clés : name (nom affiché dans le navigateur), host (garder 0.0.0.0), port (doit correspondre à GPanel), players (nombre maximum), password (vide pour public), announce (true pour apparaître dans le navigateur), token (jeton d'annonce du site alt:V, requis pour l'affichage dans le navigateur), gamemode (étiquette du navigateur comme "Roleplay"), modules (modules de script : js-module ou csharp-module), resources (tableau de dossiers de ressources à charger), et tags (balises de filtre du navigateur).

Jeton d'annonce

Pour que votre serveur apparaisse dans le navigateur de serveurs alt:V, vous avez besoin d'un jeton d'annonce du serveur maître alt:V :

1. Visitez le site web alt:V et connectez-vous ou créez un compte.
2. Accédez à la section de gestion des serveurs et générez un nouveau jeton de serveur.
3. Copiez le jeton et collez-le dans le champ token de votre server.toml.
4. Assurez-vous que announce = true dans votre configuration.
5. Redémarrez le serveur. Il devrait maintenant apparaître dans le navigateur public.

Ressources de gamemode

Les serveurs alt:V sont alimentés par des ressources — des scripts qui définissent toute la logique de jeu. Sans ressources, un serveur n'a aucune fonctionnalité personnalisée. Les ressources sont placées dans le répertoire resources/.

Structure des ressources

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)

Chargement des ressources

Ajoutez les noms des ressources au tableau resources dans server.toml pour les charger au démarrage :

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

Chaque ressource doit avoir un fichier resource.toml dans son répertoire qui définit son type, ses dépendances et ses points d'entrée de script. Pour plus de détails sur la création et la gestion des ressources, consultez alt:V Admin and Resource Setup.

Configuration CDN

alt:V utilise un mécanisme CDN pour servir les fichiers côté client (modèles, textures, scripts) aux joueurs qui se connectent. Le CDN intégré sert les fichiers directement depuis le serveur sans configuration supplémentaire nécessaire — c'est le paramètre par défaut et il fonctionne bien pour la plupart des serveurs. Pour les serveurs à grande échelle avec de nombreux assets personnalisés, vous pouvez optionnellement configurer un CDN externe en téléchargeant les fichiers client sur un serveur web et en définissant l'URL CDN dans la configuration de vos ressources, réduisant ainsi l'utilisation de bande passante du serveur de jeu.

Chat vocal

alt:V inclut un système de chat vocal intégré qui permet la communication vocale positionnelle (3D) entre les joueurs. Le chat vocal est activé et configuré dans server.toml.

Configuration vocale

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

Le bitrate contrôle la qualité vocale (64000 est standard). Les champs external* configurent un serveur vocal externe — laissez-les vides/à zéro pour utiliser le serveur vocal intégré, ce qui est recommandé pour la plupart des configurations. L'option de serveur vocal externe n'est nécessaire que pour les configurations avancées où le traitement vocal est déchargé sur une machine séparée.

Comment les joueurs se connectent

Les joueurs se connectent aux serveurs alt:V via le lanceur alt:V, et non directement via GTA V.

Via le navigateur de serveurs

1. Téléchargez et installez le lanceur alt:V depuis altvmp.com.
2. Lancez le lanceur alt:V. Il détectera et vérifiera l'installation de GTA V.
3. Depuis le lanceur, parcourez le Server Browser.
4. Recherchez votre serveur par nom ou utilisez les filtres (gamemode, tags, nombre de joueurs).
5. Cliquez sur votre serveur et sélectionnez Connect.
6. Si le serveur a un mot de passe, le joueur sera invité à le saisir.
7. GTA V se lancera avec le mod multijoueur alt:V et se connectera à votre serveur.

Via connexion directe

1. Dans le lanceur alt:V, sélectionnez Direct Connect.
2. Entrez l'adresse IP et le port de votre serveur au format IP:PORT (ex. : 192.168.1.1:7788).
3. Cliquez sur Connect.

Pour trouver l'adresse IP et le port de votre serveur, consultez How to Find Your Server IP and Port.

Nombre maximum de joueurs et performances

Les serveurs alt:V peuvent supporter un nombre élevé de joueurs, mais les performances dépendent fortement de vos ressources et de votre plan serveur :

• 32–128 joueurs : Une plage courante pour la plupart des serveurs. Les gamemodes simples fonctionnent sans problème avec des nombres plus élevés.
• 128–512+ joueurs : Possible pour les serveurs optimisés avec des ressources efficaces. Nécessite plus de CPU et de RAM.
• Efficacité des ressources : Les scripts mal optimisés sont la principale cause des problèmes de performance. Les scripts côté serveur qui exécutent des opérations lourdes à chaque tick ou maintiennent de grandes structures de données en mémoire peuvent créer un goulot d'étranglement sur le serveur.
• Requêtes de base de données : Les gamemodes utilisant des bases de données (MySQL, MongoDB) doivent utiliser des requêtes asynchrones pour éviter de bloquer le thread principal.

Articles connexes

• alt:V Admin and Resource Setup — Développement de ressources, configuration de base de données, outils d'administration et dépannage
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Server Startup Guide — Guide général pour démarrer n'importe quel serveur de jeu sur Legion Hosting

Besoin d'aide supplémentaire ?

Si vous rencontrez des problèmes non couverts par ce guide, notre équipe de support est disponible pour vous aider. Ouvrez un ticket à legionhosting.net/submitticket.php avec les détails de votre serveur et une description du problème.