Configurer un serveur alt:V Roleplay : Athena, GTArcos, MariaDB et voicechat

Vous voulez transformer votre serveur alt:V en serveur Roleplay français avec jobs, économie, factions et voicechat ? Ce guide détaille les gamemodes RP populaires, comment installer MariaDB pour persister les données, et comment activer le voicechat alt:V natif.

Pas encore de serveur alt:V ? Voir notre tuto installation alt:V.

Étape 1 — Choisir un gamemode RP

L’écosystème alt:V Roleplay propose plusieurs gamemodes open-source. Comparatif :

Gamemode	Langage	Maturité	Communauté FR	Repo
Athena Framework	TypeScript	Mature, V6+	Active	https://github.com/Stuyk/altv-athena
GTArcos	JavaScript	Moyenne	Faible (anglo)	https://github.com/Krishan-S/GTArcos
alt:V RP (Empire-V-RP)	JavaScript	Moyenne	Anglo principalement	https://github.com/Empire-V-RP
Custom	Au choix	Vous codez tout	—	—

Recommandation FR : Athena Framework est le plus actif et documenté. Bonne base pour un serveur RP français.

Étape 2 — Installer Athena Framework

Athena nécessite Node.js 18+ et MongoDB ou MariaDB.

Pré-requis

Node.js 18+

# Linux
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# Windows: télécharger depuis https://nodejs.org

Git

sudo apt install git -y     # Linux
# Windows : https://git-scm.com/download/win

Cloner Athena

cd ~/altv-server
git clone https://github.com/Stuyk/altv-athena.git athena
cd athena
npm install

Configurer la connexion DB Athena

Éditez src/core/server/config/connect.ts (ou le .env selon la version) :

export const MONGO_URL = 'mongodb://localhost:27017/altv';
export const DEFAULT_DATABASE = 'altv';

Pour MariaDB (configuration alternative selon la version Athena), voir la doc officielle.

Build et lancer

npm run windows         # Windows
npm run linux           # Linux

Le script copie les ressources dans altv-server/resources/ et lance le serveur.

Étape 3 — Installer MariaDB pour persistance

Si vous préférez MariaDB à MongoDB (plus courant en hébergement français) :

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install mariadb-server -y
sudo mysql_secure_installation

Créez la base et l’utilisateur :

sudo mysql -u root -p

CREATE DATABASE altv_rp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'altv'@'localhost' IDENTIFIED BY 'MotDePasseFort2026';
GRANT ALL PRIVILEGES ON altv_rp.* TO 'altv'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Windows

Téléchargez MariaDB Server : https://mariadb.org/download/. Installez avec un mot de passe root, créez la base via HeidiSQL ou phpMyAdmin.

Connecter votre gamemode RP à MariaDB

Selon le gamemode, configurez les credentials dans :

Athena : src/core/server/config/connect.ts ou .env
Custom : module mysql2/promise ou mariadb dans Node.js

import mariadb from 'mariadb';

const pool = mariadb.createPool({
    host: 'localhost',
    user: 'altv',
    password: 'MotDePasseFort2026',
    database: 'altv_rp',
    connectionLimit: 10
});

export default pool;

Étape 4 — Activer le voicechat alt:V natif

alt:V intègre un voicechat 3D natif (à la différence de FiveM qui dépend de mods comme pma-voice). Activation depuis server.toml :

voice = true
voiceExternalPublic = ''     # Si voice externe (laissez vide pour intégré)
voiceExternal = ''           # Idem
voiceSampleRate = 48000      # Qualité audio (48000 = standard)

Le voice est 3D spatialisé : les joueurs proches s’entendent plus fort, ceux loin moins. Idéal pour le RP immersif.

Côté client

Le client alt:V utilise le micro système par défaut. Aucun mod ou Plugin externe nécessaire.

Pousser-pour-parler ou voix ouverte

Configurable côté client dans les paramètres alt:V (touche par défaut N).

Étape 5 — Sécuriser le serveur RP

Whitelist Discord

Pour contrôler qui rejoint, beaucoup de RP français utilisent une whitelist Discord. Solution courante :

Créez un bot Discord (https://discord.com/developers/applications)
Liez le SteamID/HWID du joueur à son compte Discord
Bloquez la connexion si Discord ID absent de la whitelist

Module recommandé : discord-altv-bot (plusieurs forks GitHub).

Anti-cheat

alt:V intègre HWID detection et un anti-cheat de base. Pour aller plus loin :

Vérifications côté serveur (toujours valider l’argent, items, position)
Sanity checks : pas de téléportations brutales, pas de spawns instantanés
Monitoring des warnings dans les logs

Token et CDN

Pour héberger vos ressources sur un CDN externe (téléchargement plus rapide pour les joueurs), définissez token dans server.toml et configurez votre CDN selon https://docs.altv.mp/articles/cdn.html.

Étape 6 — Configuration server.toml RP type

Exemple complet pour un serveur RP français :

name = 'My RP — Serveur Roleplay FR'
host = '0.0.0.0'
port = 7788
players = 128
password = ''
announce = true
gamemode = 'Roleplay'
website = 'https://my-rp.fr'
language = 'fr'
description = 'Serveur Roleplay français — Whitelist Discord obligatoire'
debug = false
streamingDistance = 400

voice = true
voiceSampleRate = 48000

modules = [
  'js-module',
]

resources = [
  'athena',
]

[tags]
gamemode = 'Roleplay'
language = 'French'
whitelist = 'Discord'
voice = '3D'

Étape 7 — Optimisations RP

RAM et performance

Un serveur RP avec gamemode mature (Athena, GTArcos) consomme 8-16 Go de RAM pour 64 slots. Au-delà :

Utilisez streamingDistance plus bas (200-300) pour réduire la charge réseau
Activez OneSync style : seuls les joueurs proches sont synchronisés en détail
Surveillez la consommation via les logs et les outils Node.js (--inspect)

Réseau

Pour un serveur RP 80 ms de latence max côté joueurs :

Datacenter en France ou Europe centrale
Bande passante minimum 100 Mbps symétriques
Anti-DDoS indispensable (les RP français sont fréquemment attaqués)

Customiser le gamemode — jobs, factions, vehicles, économie
Lancer une bêta privée sur Discord pour tester avec 5-10 joueurs
Lancer la communication : site web, Discord, recrutement de modos
Mises à jour régulières d’alt:V et du gamemode

Pour un hébergeur alt:V Ryzen 9 5950X avec MariaDB intégré et support 24/7, HebergTonServ est la référence en France dès 1,90€/mois (Dev) à 19,90€/mois (Infinity).

Sommaire

Tags populaires

Support Technique

Tutoriels connexes

Combien coûte un serveur FiveM en 2026 ? Prix réel et budget

Comment créer un serveur FiveM RP : guide débutant complet

Hébergeur FiveM français : pourquoi choisir un hébergement en France

Sommaire