Comment passer mon serveur FiveM en whitelist ?

Activer la whitelist FiveM est une étape cruciale pour sécuriser votre serveur et contrôler l’accès de vos joueurs. En 2025, cette fonctionnalité reste l’un des outils les plus efficaces pour gérer votre communauté, prévenir les intrusions malveillantes et garantir une expérience de jeu optimale. Ce guide complet vous accompagne pas à pas dans la configuration de la whitelist sur votre serveur FiveM, que vous utilisiez une solution d’hébergement professionnelle comme Nexus Games ou une configuration manuelle.

Qu’est-ce que la whitelist FiveM et pourquoi l’activer ?

La whitelist FiveM est un système de filtrage qui autorise uniquement les joueurs sélectionnés à rejoindre votre serveur. Contrairement aux serveurs publics où n’importe qui peut se connecter, la whitelist crée une barrière d’entrée basée sur des identifiants uniques (Steam, Discord, License, etc.).

Les avantages d’une whitelist sur votre serveur FiveM

L’activation de la whitelist FiveM offre plusieurs bénéfices majeurs pour les administrateurs de serveurs :

• Sécurité renforcée : éliminez les trolls, hackers et joueurs indésirables avant même qu’ils ne se connectent
• Contrôle communautaire : créez une base de joueurs engagés et respectueux de vos règles
• Optimisation des performances : réduisez la charge serveur en limitant les connexions simultanées
• Ambiance roleplay préservée : maintenez la cohérence narrative de votre serveur RP
• Gestion des ressources : avec un processeur AMD Ryzen 9 7950X3D et 32 à 128 Go de RAM DDR5 ECC, comme proposé chez Nexus Games, vous optimisez chaque slot disponible

Types d’identifiants utilisables pour la whitelist

FiveM prend en charge plusieurs méthodes d’identification pour votre whitelist :

Pour une sécurité maximale, nous recommandons d’utiliser le Discord ID couplé au Steam ID. Cette double vérification garantit une protection optimale contre les contournements.

Comment activer la whitelist FiveM : méthodes pas à pas

Méthode 1 : Whitelist manuelle via server.cfg

La méthode la plus directe pour activer la whitelist FiveM consiste à modifier directement votre fichier de configuration. Cette approche convient particulièrement aux petits serveurs avec une communauté restreinte.

Étape 1 : Accéder à votre fichier server.cfg

Sur un hébergement Nexus Games avec Panel Nexus, accédez à votre gestionnaire de fichiers depuis l’interface d’administration. Le fichier server.cfg se trouve à la racine de votre serveur FiveM. Si vous utilisez un VPS Linux ou Windows, connectez-vous via FTP ou SSH.

Étape 2 : Ajouter les commandes de whitelist

Insérez les lignes suivantes dans votre server.cfg :

# Activation de la whitelist
set sv_whitelist "true"

# Liste des joueurs autorisés
add_principal identifier.steam:110000xxxxxxxx group.whitelist
add_principal identifier.discord:123456789012345678 group.whitelist
add_ace group.whitelist command.connect allow

Étape 3 : Configuration des permissions

Créez un groupe whitelist avec les permissions appropriées :

add_ace group.whitelist command.quit deny
add_ace group.whitelist command.connect allow
setr sv_whitelistReason "Vous n'êtes pas whitelisté sur ce serveur. Rejoignez notre Discord : discord.gg/votreserveur"

Méthode 2 : Whitelist avancée avec script dédié

Pour les serveurs moyens à grands, l’utilisation d’un script de whitelist FiveM automatisé est recommandée. Cette solution offre une gestion dynamique et une interface d’administration intuitive.

Installation d’un script de whitelist

• Téléchargez un script éprouvé comme esx_whitelist, jg-whitelist ou codem-whitelist
• Placez le dossier dans votre répertoire resources/
• Ajoutez ensure nom_du_script dans votre server.cfg
• Configurez le fichier config.lua selon vos besoins

Exemple de configuration typique :

Config = {}
Config.WhitelistType = "discord" -- steam, discord, license
Config.DiscordBotToken = "VOTRE_TOKEN_BOT"
Config.DiscordGuildID = "VOTRE_ID_SERVEUR"
Config.WhitelistedRole = "Whitelisté"
Config.KickMessage = "Accès refusé. Demandez la whitelist sur notre Discord."

Méthode 3 : Whitelist automatique via Discord Bot

La méthode la plus moderne et scalable pour activer la whitelist FiveM en 2025 repose sur l’intégration Discord. Elle permet une gestion automatisée des demandes et une synchronisation en temps réel.

Configuration du Bot Discord

1. Créez un bot Discord via le portail développeur Discord
2. Récupérez votre token et l’ID de votre serveur Discord
3. Installez un script comme codem-whitelist ou trew_whitelist
4. Configurez les permissions de rôles dans config.lua

Cette méthode s’avère particulièrement efficace sur des infrastructures performantes. Avec un stockage NVMe SSD et une bande passante de 1 Gbps comme chez Nexus Games, la synchronisation reste instantanée même avec des centaines de joueurs.

Gestion de la base de données whitelist

Pour les serveurs utilisant MySQL, la whitelist FiveM peut être stockée dans une table dédiée :

CREATE TABLE whitelist (
  identifier VARCHAR(60) PRIMARY KEY,
  discord_id VARCHAR(20),
  steam_id VARCHAR(20),
  date_added TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  added_by VARCHAR(60)
);

Cette structure permet un suivi historique et facilite l’audit des accès.

Optimisation et maintenance de votre whitelist FiveM

Meilleures pratiques de sécurité

Une fois votre whitelist FiveM activée, plusieurs mesures complémentaires renforcent la protection de votre serveur :

• Double authentification : exigez au minimum deux identifiants (Discord + Steam)
• Rotation régulière : révisez votre liste mensuellement pour retirer les comptes inactifs
• Logs détaillés : conservez une trace de toutes les tentatives de connexion
• Système de candidature : créez un formulaire structuré pour évaluer les nouveaux joueurs
• Backup automatique : sauvegardez votre base whitelist quotidiennement

Résolution des problèmes courants

Problème 1 : Les joueurs whitelistés ne peuvent pas se connecter

Vérifiez la syntaxe de vos identifiants dans server.cfg. Un simple espace ou caractère manquant bloque l’accès. Utilisez la commande sv_whitelist dans la console serveur pour vérifier l’état d’activation.

Problème 2 : Le bot Discord ne synchronise pas

Contrôlez les permissions du bot et assurez-vous que les intents privilégiés (Server Members Intent) sont activés dans le portail développeur. Redémarrez le script avec restart nom_script.

Problème 3 : Lenteurs lors de la connexion

Une whitelist mal optimisée peut ralentir les connexions. Sur un serveur hébergé avec Panel Nexus et équipé d’un AMD Ryzen 9 7950X3D, ce problème est rare, mais peut survenir avec des scripts mal codés. Privilégiez les solutions légères et régulièrement mises à jour.

Automatisation et intégration avancée

Pour les communautés importantes, l’automatisation complète de la whitelist FiveM devient indispensable. Voici les solutions 2025 recommandées :

• Webhooks Discord : notifications instantanées des nouvelles demandes
• API REST : gestion externe depuis un site web avec dashboard
• Système de parrainage : validation automatique par les membres existants
• Intégration Tebex : whitelist automatique après achat (VIP, dons)

Ces fonctionnalités avancées nécessitent des ressources serveur stables. Un VPS avec Pterodactyl offre la flexibilité nécessaire pour héberger simultanément votre serveur FiveM et vos outils d’administration.

Performances et scaling

Lorsque votre communauté grandit, la whitelist FiveM doit évoluer sans compromettre les performances. Sur une infrastructure avec RAM DDR5 ECC et stockage NVMe, vous pouvez gérer aisément :

• Jusqu’à 10 000 identifiants en base de données
• Vérifications en moins de 100ms par connexion
• Synchronisation Discord en temps réel
• Logs détaillés sans impact sur le gameplay

La bande passante de 1 Gbps garantit que les requêtes API vers Discord ou votre base de données externe ne créent aucun goulot d’étranglement.

Comparatif des solutions de whitelist FiveM en 2025

Whitelist manuelle vs automatisée

Scripts de whitelist FiveM recommandés

1. Codem-Whitelist

Solution complète avec interface React, gestion multi-identifiants et synchronisation Discord native. Idéale pour les serveurs RP exigeants.

2. JG-Whitelist

Script léger et performant, parfait pour les serveurs moyens. Supporte Discord et Steam avec logs détaillés.

3. ESX Whitelist

Intégration native au framework ESX, recommandée si vous utilisez déjà cet écosystème. Configuration simplifiée via config.lua.

4. QB-Whitelist

Équivalent pour le framework QBCore, avec commandes admin intégrées et système de candidature.

Choisir selon votre type de serveur

• Serveur RP strict : privilégiez une solution avec candidature détaillée et validation manuelle
• Serveur communautaire : optez pour Discord avec rôles automatiques après présentation
• Serveur VIP/donateurs : intégrez Tebex pour whitelist automatique post-achat
• Serveur événementiel : utilisez une whitelist temporaire désactivable rapidement

Quelle que soit votre approche, assurez-vous que votre hébergement supporte la charge. Les serveurs Nexus Games, équipés de processeurs AMD Ryzen 9 7950X3D avec jusqu’à 128 Go de RAM DDR5 ECC, garantissent des vérifications whitelist instantanées même sous forte affluence.

En conclusion, activer la whitelist FiveM en 2025 reste un processus accessible, quel que soit votre niveau technique. Que vous optiez pour une méthode manuelle via server.cfg pour un petit groupe d’amis ou un système automatisé complet avec bot Discord pour une communauté de plusieurs centaines de joueurs, les outils existent et sont matures. L’essentiel réside dans le choix d’une infrastructure stable : avec un hébergement sur NVMe SSD, une bande passante d’1 Gbps et un support technique réactif comme celui proposé par Nexus Games, votre whitelist fonctionnera de manière fiable et sécurisée. N’hésitez pas à tester plusieurs approches et à adapter votre configuration selon l’évolution de votre communauté.

FAQ

Hébergeur FiveM