Guide de dépannage pour les problèmes courants de serveur RedM, notamment les erreurs de clé de licence, la visibilité dans le navigateur de serveurs, les échecs de ressources, les connexions client, les problèmes de base de données et l'optimisation des performances. Pour les instructions de configuration initiale, consultez notre Guide de configuration d'un serveur RedM.

Erreurs de clé de licence

Les problèmes de clé de licence sont le problème le plus courant lors du démarrage d'un nouveau serveur RedM. Voici les erreurs typiques et leurs solutions :

"Invalid license key" ou "Could not authenticate"

Le serveur n'apparaît pas dans le navigateur

Si votre serveur fonctionne mais que les joueurs ne le trouvent pas dans le navigateur de serveurs RedM :

Liste de vérification

1. Attendez au moins 5 minutes. Après le démarrage, le serveur a besoin de temps pour s'enregistrer auprès de la liste maître Cfx.re. Les nouveaux serveurs peuvent prendre plusieurs minutes avant d'apparaître.
2. Vérifiez que la clé de licence est valide. Le serveur ne sera pas listé sans une clé de licence fonctionnelle. Vérifiez la console du serveur pour les erreurs liées à la licence.
3. Vérifiez la configuration des points de terminaison. Assurez-vous que endpoint_add_tcp et endpoint_add_udp dans server.cfg utilisent le bon port :

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   Le port doit correspondre à celui attribué dans GPanel.
4. Vérifiez les paramètres "sv_master1" ou de listing. Assurez-vous que vous n'avez pas accidentellement configuré le serveur pour ne pas s'inscrire. Il ne doit pas y avoir de sv_master1 "" dans votre configuration (cela désactive l'enregistrement sur la liste maître).
5. Vérifiez que le serveur est effectivement en cours d'exécution. Consultez la console GPanel. Si le serveur a planté ou s'est arrêté, il n'apparaîtra pas dans le navigateur.
6. Essayez la connexion directe. Même si le serveur n'est pas dans le navigateur, la connexion directe devrait fonctionner. Demandez à un joueur d'appuyer sur F8 dans RedM et de taper :

   connect YOUR_SERVER_IP:PORT

Échecs de chargement des ressources

Les erreurs de ressources sont courantes lors de l'ajout de nouveaux scripts ou frameworks à votre serveur. Voici les problèmes les plus fréquents :

"Could not find resource [resource_name]"

• Le dossier de la ressource n'existe pas dans le répertoire resources/, ou se trouve au mauvais emplacement.
• Le nom du dossier ne correspond pas au nom utilisé dans ensure. Les noms de ressources sont sensibles à la casse.
• Correction : Vérifiez que le dossier de la ressource existe et que le nom dans server.cfg correspond exactement. Utilisez le gestionnaire de fichiers GPanel ou SFTP pour vérifier.

"Failed to load resource [resource_name]: manifest error"

• Le fichier fxmanifest.lua ou __resource.lua de la ressource contient une erreur de syntaxe.
• Le manifeste fait référence à des fichiers qui n'existent pas dans le dossier de la ressource.
• Correction : Ouvrez le fichier manifeste et vérifiez les fautes de frappe, les virgules manquantes ou les références à des fichiers inexistants. Consultez la console du serveur pour le numéro de ligne spécifique de l'erreur.

"Error loading script [filename]: [error details]"

• Un fichier Lua, C# ou JavaScript dans la ressource contient une erreur de syntaxe ou d'exécution.
• Correction : Lisez le message d'erreur complet dans la console. Il inclura le nom du fichier et le numéro de ligne. Les causes courantes incluent :
  • Des dépendances manquantes (une autre ressource qui doit être chargée en premier)
  • Une ressource obsolète non compatible avec la version actuelle du serveur RedM
  • Des valeurs de configuration incorrectes dans le fichier de configuration de la ressource

Problèmes d'ordre de chargement des ressources

Les ressources dans server.cfg sont chargées dans l'ordre où elles apparaissent. Si une ressource dépend d'une autre (par exemple, vorp_inventory dépend de vorp_core), la dépendance doit être listée en premier :

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

Problèmes de connexion client

Lorsque les joueurs ne peuvent pas se connecter à votre serveur :

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Mot de passe du serveur : Si sv_password est défini, le joueur doit entrer le bon mot de passe.
• Ressource de whitelist/liste d'autorisation : Si vous avez une ressource de whitelist activée, le joueur doit être approuvé avant de se connecter.
• Bannissement : Le joueur est peut-être banni. Vérifiez votre liste de bannissements ou votre base de données pour ses identifiants.

Le client plante lors de la connexion

• Une ressource sur le serveur envoie des données incorrectes ou a une erreur de script côté client qui fait planter le client.
• Correction : Désactivez les ressources récemment ajoutées une par une pour identifier celle qui pose problème. Vérifiez la console du serveur pour les erreurs pendant la connexion du client.
• Assurez-vous que le client RedM du joueur est à jour.

Erreurs "Could not download file"

• Le serveur tente d'envoyer un fichier volumineux (par exemple un asset de streaming) qui dépasse les limites de transfert ou la connexion est instable.
• Correction : Réduisez la taille des assets streamés, utilisez un CDN/hébergement externe pour les fichiers volumineux si supporté, ou demandez au joueur de retenter la connexion.

Problèmes de base de données (MySQL / oxmysql)

La plupart des frameworks de roleplay RedM utilisent MySQL pour le stockage persistant des données. Le connecteur de base de données le plus courant est oxmysql.

Erreurs de connexion échouée

Si oxmysql (ou un autre connecteur MySQL) échoue à se connecter, vérifiez les points suivants :

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

Tables manquantes ou erreurs de schéma

Les frameworks de roleplay nécessitent souvent que les tables de base de données soient configurées avant de pouvoir fonctionner :

1. Consultez la documentation du framework ou le dépôt GitHub pour les fichiers d'import SQL (souvent nommés database.sql, schema.sql ou similaire).
2. Importez le fichier SQL dans votre base de données en utilisant phpMyAdmin ou un client MySQL.
3. Certains frameworks créent automatiquement les tables au premier démarrage. Assurez-vous que l'utilisateur de la base de données a les privilèges CREATE TABLE.

Problèmes de performance

Si votre serveur RedM subit du lag, un faible taux de ticks ou de mauvaises performances générales :

Identifier les problèmes de performance

Vérifiez la console du serveur pour les avertissements de performance. Les serveurs RedM visent un taux de ticks d'environ 30-64 ticks par seconde. Vous pouvez surveiller cela avec :

• Tableau de bord txAdmin : Si txAdmin est disponible, il affiche les métriques de performance du serveur en temps réel.
• Console du serveur : Surveillez les avertissements "slow tick" ou "resource hitch".
• Commande resmon : Tapez resmon 1 dans la console du serveur (ou la console F8) pour activer le moniteur de ressources, qui affiche le temps CPU par ressource.

Solutions courantes pour les performances

Pratiques recommandées

• Planifiez des redémarrages automatiques toutes les 6 à 12 heures en utilisant la fonctionnalité de planification de GPanel ou txAdmin pour libérer la mémoire accumulée et les problèmes d'entités.
• Gardez les ressources à jour pour bénéficier des correctifs de performance et des optimisations.
• Évitez les fonctionnalités en double — n'exécutez pas deux ressources qui font la même chose (par exemple, deux systèmes météo).
• Testez les nouvelles ressources sur un serveur de test (ou avec un faible nombre de joueurs) avant de les déployer sur votre serveur principal.
• Surveillez régulièrement les métriques du serveur via GPanel ou txAdmin pour détecter les problèmes rapidement.

Conseils généraux de dépannage

1. Lisez toujours la sortie de la console du serveur. Presque chaque erreur inclut un message dans la console qui vous dit ce qui s'est mal passé et où.
2. Redémarrez le serveur après les changements de configuration. La plupart des modifications de server.cfg nécessitent un redémarrage complet du serveur pour prendre effet.
3. Désactivez les ressources une par une pour isoler les problèmes. Commentez les lignes ensure dans server.cfg avec #.
4. Conservez des sauvegardes des configurations fonctionnelles avant d'effectuer des changements. Téléchargez votre server.cfg et votre base de données avant les mises à jour importantes.
5. Consultez les forums et la documentation Cfx.re sur docs.fivem.net pour la documentation officielle qui s'applique à la fois à FiveM et RedM.
6. Vérifiez la compatibilité des ressources avec votre version de serveur. Les ressources conçues pour des versions plus anciennes peuvent ne pas fonctionner avec les builds actuels de RedM.

Articles connexes

• Guide de configuration d'un serveur RedM — Clés de licence, configuration de server.cfg, gestion des ressources et connexion.
• Comment trouver l'IP et le port de votre serveur
• Comment uploader des fichiers via SFTP
• Premiers pas avec votre nouveau serveur

Besoin d'aide ?

Vous rencontrez toujours des problèmes avec votre serveur RedM ? Ouvrez un ticket de support en incluant les messages d'erreur de votre console serveur. Notre équipe vous aidera à diagnostiquer et résoudre le problème.