Comment créer un serveur alt:V (Guide de démarrage rapide 2025)

Vous souhaitez héberger votre propre monde multijoueur GTA V avec alt:V? Ce guide vous montre deux chemins d'installation fiables (Windows et Linux), vous donne un aperçu clair serveur.toml, une première ressource JavaScript fonctionnelle, un pare-feu/des ports et un service systemd facultatif pour que vous puissiez passer rapidement de zéro à un serveur public répertorié.

---

Ce dont vous aurez besoin

• Une copie légitime de GTA V (les joueurs en ont besoin, le serveur non).
• Windows 10/11 ou Ubuntu 22.04+ (ou tout Linux x64 récent).
• Compétences de base en terminal/PowerShell.

Les serveurs alt:V sont autonomes ; vous n'installez pas GTA sur le serveur.

---

Disposition des dossiers (nous allons créer ceci)

altv-server/ ├─ altv-server.exe (Windows) ou altv-server (Linux) ├─ libnode.dll / libnode.so ├─ server.toml ├─ package.json ← définit ESM (type : module) pour les ressources JS └─ resources/ └─ example/ ├─ resource.toml ├─ server.mjs └─ client/ └─ client.mjs

---

Option A — Démarrage rapide (Windows et Linux) avec altv-package

Cela extrait les derniers binaires officiels pour vous.

1. Créer un répertoire de travail

mkdir altv-server && cd altv-server

2. Initialiser le nœud (pour l'outillage uniquement)

npm init -y npm i --save-dev altv-pkg

3. Télécharger les binaires du serveur

version altv-pkg de npx

Rediffusion version altv-pkg de npx à tout moment où vous souhaitez mettre à jour.

---

Option B — Installation manuelle

1. Téléchargez le Serveur compilez à partir de la page de téléchargement officielle d'alt:V (choisissez Windows ou Linux).
2. Extraire dans altv-serveur/.

---

Créer paquet.json (niveau supérieur)

Cela permet ESM syntaxe (importer ...) pour vos ressources JS.

{ "nom": "altv-server", "privé": true, "type": "module" }

---

Minimal serveur.toml

Créer serveur.toml dans la racine du serveur :

# Nom affiché dans le client alt:V name = "Mon serveur alt:V" # Liaison à toutes les interfaces host = "0.0.0.0" # Port de jeu par défaut (TCP et UDP) port = 7788 # Emplacements de joueur players = 128 # Afficher sur la liste principale ? (définir sur true pour public) announce = true # Obtenir un jeton depuis le tableau de bord alt:V et le coller ici lors de la publication # token = "YOUR_MASTERLIST_TOKEN" # Charger le module JS et notre exemple de ressources modules = ["js-module"] resources = ["example"] # Utile au développement debug = true logStreams = ["console", "file"]

Conseil: Ports lors de l'utilisation externe Les voix sont généralement 7798 (serveur) et 7799 (client) ; ouvrez-les uniquement si vous exécutez le serveur vocal séparément. La voix de base en cours d'exécution n'a besoin que de votre port de jeu.

---

Votre première ressource (JavaScript)

Créer ressources/exemple/ressource.toml:

# Langue côté serveur pour ce type de ressource = "js" # Langue côté client pour cette ressource client-type = "js" # Fichiers d'entrée main = "server.mjs" client-main = "client/client.mjs" # Fichiers que le client peut télécharger client-files = [ "client/*", ]

ressources/exemple/serveur.mjs

importer * comme alt depuis 'alt-server'; alt.on('playerConnect', (player) => { alt.log(`+ ${player.name} connecté`); player.emit('welcome:notify', `Bienvenue sur ${alt.getServerConfig().name}!`); }); alt.on('playerDisconnect', (player, reason) => { alt.log(`- ${player?.name ?? 'unknown'} left (${reason})`); });

ressources/exemple/client/client.mjs

import * as alt from 'alt-client'; alt.onServer('welcome:notify', (msg) => { alt.log(`Server says: ${msg}`); // Texte d'aide simple à l'écran alt.everyTick(() => { alt.drawText2d(msg, 0.5, 0.9, 0.5, 255, 255, 255, 255, 0, true, true, 0); }); // Supprimer après ~8 secondes alt.setTimeout(() => alt.clearEveryTick(), 8000); });

C'est une ressource complète. Lorsqu'un joueur se connecte, il reçoit un message de bienvenue.

---

Démarrer le serveur

Windows (PowerShell)

cd C:\chemin\vers\altv-server ./altv-server.exe

Linux

cd /opt/altv-server # ou votre chemin chmod +x altv-server ./altv-server

Si le démarrage est propre, vous verrez les journaux et le serveur sera accessible à votre.ip:7788. Rejoignez via le client alt:V (Direct Connect) ou depuis la Masterlist (si annoncer = vrai et un valide jeton est défini).

---

Ouvrir le pare-feu

Windows (PowerShell, exécuter en tant qu'administrateur)

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Entrant -Protocole TCP -LocalPort 7788 -Action Autoriser New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Entrant -Protocole UDP -LocalPort 7788 -Action Autoriser

Linux (UFW)

sudo ufw autorise 7788/tcp sudo ufw autorise 7788/udp

Si vous utilisez un externe serveur vocal, permet également 7798/udp et 7799/udp.

---

(Facultatif) Exécutez alt:V en tant que service sous Linux

Créer /etc/systemd/system/altv.service:

[Unité] Description=alt:V Serveur Après=network.target [Service] Utilisateur=altv Répertoire de travail=/opt/altv-server ExecStart=/opt/altv-server/altv-server --port 7788 Redémarrage=en cas d'échec [Installation] WantedBy=multi-user.target

Activer et démarrer :

sudo systemctl daemon-reload sudo systemctl enable --now altv journalctl -u altv -f

---

Qualité de vie pour le développement

• Mode débogage : garder débogage = vrai pendant la construction ; désactiver pour la production.
• Inspecteur de nœuds (serveur JS) : ajouter ceci à ressources/exemple/ressource.toml si vous avez besoin d'un débogage côté serveur : [js-module] inspecteur = vrai Ensuite, attachez Chrome DevTools → Cible de nœud.
• Manuscrit: ajouter un tsconfig.json, compiler pour dist/, et point principal/client-principal aux fichiers compilés. Types d'installation : npm i -D @altv/types-serveur @altv/types-client.

---

Mise à jour et sauvegardes

• Mettre à jour les binaires : rediffusion version altv-pkg de npx (Option A) ou retéléchargez le ZIP (Option B).
• Sauvegardes : fermeture éclair ressources/, serveur.tomlet toutes les configurations de base de données/externes. Automatisez avec une tâche planifiée ou cron.

---

Liste de contrôle de durcissement de la production

• Établir une relation forte jeton et annoncer = vrai pour la liste principale.
• Garder débogage = faux en production.
• Utiliser logStreams = ["fichier"] en produisant et en faisant pivoter les journaux en externe si nécessaire.
• Exposez uniquement les ports nécessaires (7788 ; 7798/7799 si voix externe).
• Considérer useCdn = vrai pour les téléchargements volumineux ; générer des packages avec --justpack et servir via HTTPS.
• Surveiller avec un chien de garde (systemd Redémarrage = en cas d'échec) et configurer des alertes.

---

Dépannage (solutions rapides)

• Impossible de voir le serveur dans la liste : assurer annoncer = vrai, valide jeton, ouvrez 7788 TCP/UDP sur l'hôte et routeur/NAT ; attendez quelques minutes pour la propagation.
• Clients bloqués lors du téléchargement : si vous avez ajouté de gros actifs, pensez useCdn = vrai et l'emballage (--justpack).
• Ports déjà utilisés : choisir un autre port dans serveur.toml ou arrêter le service conflictuel.
• Rien ne se passe lors de la connexion : confirmer la correspondance des noms de ressources ressources = ["exemple"] et votre dossier réside sous ressources/exemple.

---

FAQ – Serveurs alt:V

Ai-je besoin que GTA V soit installé sur la machine serveur ?
Non. Seuls les joueurs ont besoin d'une version officielle de GTA V. Le serveur fonctionne sans le jeu installé.

Quels systèmes d'exploitation sont pris en charge pour l'hébergement d'alt:V ?
Windows 10/11 et les distributions Linux modernes (Ubuntu 22.04+ ou tout Linux x64 récent) sont pris en charge.

Quels ports doivent être ouverts pour que alt:V fonctionne ?
Par défaut, port TCP/UDP 7788 doit être ouvert. Si vous utilisez un serveur vocal externe, ouvrez-le également. 7798/UDP et 7799/UDP.

Pourquoi mon serveur n'apparaît-il pas dans la liste principale ?
Assurez-vous de définir annoncer = vrai, a ajouté un valide jeton de liste principaleet autorisez 7788 TCP/UDP via votre pare-feu et votre routeur. La propagation de la liste peut prendre quelques minutes.

Comment mettre à jour les binaires du serveur ?
Si vous avez installé via altv-package, exécutez simplement :

version altv-pkg de npx

Si vous avez installé manuellement, téléchargez la dernière version à partir du page de téléchargement officielle d'alt:V.

Puis-je exécuter le serveur en tant que service d’arrière-plan ?
Oui. Sous Linux, vous pouvez configurer un systèmed service (altv.service) pour démarrer automatiquement et redémarrer en cas d'échec.

Comment rendre mon serveur plus sécurisé pour la production ?

• Désactiver déboguer mode.
• Ensemble logStreams = ["fichier"].
• Utilisez un jeton de liste principale fort.
• Exposez uniquement les ports requis.
• Automatisez les sauvegardes des ressources et des configurations.

Où puis-je trouver plus de ressources pour mon serveur ?
Le hub officiel alt:V et les dépôts communautaires GitHub contiennent de nombreuses ressources d'exemple. Vous pouvez également consulter les guides sur FiveMX pour l'optimisation et la croissance du serveur.

---

Où aller ensuite

• Ajoutez davantage de ressources à partir du Hub communautaire et des référentiels d’exemples.
• Mettre en place un serveur vocal à l'extérieur pour les grandes populations.
• Automatisez le CI/CD pour envoyer les mises à jour à votre box.

Lectures recommandées (sur FiveMX)

• Comparer les frameworks : FiveM vs RAGE:MP vs alt:V — Lequel choisir ?
• Développez votre communauté : Comment annoncer votre serveur (fonctionne pour n'importe quel GTA V MP)
• Construisez votre base d'attache : Comment créer un site Web pour votre serveur de jeu
• Conseils de réglage : Performance et optimisation

---

Copier-coller des extraits (référence rapide)

Démarrage de Windows :

./altv-server.exe

Démarrage de Linux :

./altv-serveur

Ports ouverts (Windows) :

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Entrant -Protocole TCP -LocalPort 7788 -Action Autoriser New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Entrant -Protocole UDP -LocalPort 7788 -Action Autoriser

Ports ouverts (Linux) :

sudo ufw autorise 7788/tcp && sudo ufw autorise 7788/udp

C'est prêt. Lancez-le, connectez-vous depuis le client alt:V et commencez à créer des ressources !