Créer un serveur alt:V

1. Pourquoi un serveur alt:V ?

Un serveur dédié alt:V Multiplayer te donne le contrôle : règles, mods, économie, whitelist, événements. Tu héberges sur un VPS / dédié, tu configures alt:V Dedicated Server, puis tu listes le serveur sur VoteServeur pour les votes et la visibilité FR.

2. Prérequis techniques

• RAM : 4 Go minimum · 8–16 Go recommandé
• CPU : 4 cœurs+ (fréquence élevée = mieux pour la simu / ticks)
• Stockage : SSD / NVMe (saves, streaming, restarts)
• OS : Windows / Linux
• Réseau : IP publique · ports 7788 · protocole UDP 7788
• Joueurs cibles : 32–128
• Config clé : server.toml

3. Installer le logiciel serveur

Télécharge le binaire alt:V Dedicated Server, crée server.toml, ajoute ta clé master.

# server.toml — voir doc alt:V
name = "Mon serveur"
players = 128
password = ""
announce = true

Docs : https://altv.mp

4. Configuration (server.toml)

Le fichier / la config principale est server.toml. Règle au minimum : nom du serveur, slots, mot de passe admin / RCON, monde ou carte, et options PvP / difficulty.

# Exemple — adapte selon la doc alt:V
ServerName=MonServeurVS
MaxPlayers=32
Port=7788
# AdminPassword=change-moi
# RconPort=...

5. Ouvrir les ports & firewall

Sans redirection de ports, personne ne rejoint. Ouvre au minimum :

• Port jeu : 7788 (UDP 7788)
• Ports query / RCON annexes si documentés
• Autorise le process dans le firewall OS (ufw / firewalld / Windows Defender)

sudo ufw allow 7788/udp
sudo ufw reload

Teste d’abord en local (127.0.0.1), puis depuis un autre réseau (4G).

6. Mods, plugins & admin

Selon le jeu : Workshop Steam, dossiers Mods / plugins, Oxide/uMod, BepInEx, etc. Installe un pack à la fois, redémarre, vérifie les logs. Garde une liste des mods (noms + versions).

• Compte admin / RCON avec mot de passe fort
• Backups automatiques des saves (cron / Task Scheduler)
• Monitoring : RAM, CPU, joueurs connectés

7. Référencer sur VoteServeur

Suis ces étapes dans l’ordre — tu n’as pas besoin d’ouvrir un autre onglet une fois la fiche créée.

1. Créer la fiche serveur — connecte-toi, puis ajoute ton serveur (jeu alt:V). Renseigne IP/port, description, Discord et bannière.
2. Ouvrir la page plugin — va sur /plugins/altv depuis ton espace propriétaire (lien « Plugin » sur ta fiche). Tu y vois le type de pack (natif / universel) et les paliers de récompenses.
3. Télécharger le ZIP — clique « Télécharger le plugin ». Le fichier contient ton server_token unique déjà injecté (ne le partage jamais publiquement).
4. Option A — poller universel : ouvre le dossier universal/ du ZIP, puis :

   cd universal
   npm i
   node poller.js

   Édite config.json (host/port/mot de passe RCON) si besoin — le token est déjà injecté.
5. Tester le claim — fais voter un compte test sur ta fiche, puis vérifie que l’API répond (remplace TOKEN et PseudoJoueur par tes valeurs) :

   curl -s "https://voteserveur.fr/api/v1/votes/claim-playername?server_token=TOKEN&playername=PseudoJoueur"

   Réponse attendue : {"claimed":1,...} au premier vote non réclamé du mois. Les joueurs votent avec leur pseudo in-game.
6. Aller plus loin — doc API : /api · catalogue plugins : /plugins · retour à ce guide : /guides/creer-serveur-altv.

GET /api/v1/votes/pending?server_token=TOKEN
GET /api/v1/servers/heartbeat?server_token=TOKEN&players=12&max_players=64&platform=fivem
GET /api/v1/votes/claim?server_token=TOKEN&identity=PseudoOuSteamOuDiscord
GET /api/v1/votes/player?server_token=TOKEN&playername=Pseudo

8. FAQ alt:V