Ce guide couvre les problèmes courants que vous pouvez rencontrer lors de l'exécution d'un serveur dédié Rust sur Legion Hosting et comment les résoudre. Pour la configuration générale du serveur, consultez le Guide de configuration du serveur Rust.

Le serveur n'apparaît pas dans le navigateur de serveurs

Si votre serveur est en cours d'exécution mais que les joueurs ne le trouvent pas dans le navigateur en jeu :

• Le navigateur de serveurs peut mettre 10 à 20 minutes pour indexer un serveur nouvellement démarré. Utilisez la connexion directe via la console F1 (client.connect IP:PORT) pour vérifier que le serveur est accessible en attendant.
• Assurez-vous que la variable de démarrage QUERY_PORT (dans l'onglet Startup de GPanel) correspond au port de requête attribué dans l'onglet Network de GPanel. Un port de requête incorrect est la raison la plus courante pour laquelle un serveur n'apparaît pas dans le navigateur.
• Confirmez que le serveur est complètement démarré — recherchez la ligne Server startup complete dans la console avant de tester les connexions.
• Vérifiez que votre server.hostname est défini dans server.cfg. Les serveurs sans nom d'hôte peuvent ne pas s'afficher correctement dans le navigateur.

Impossible de se connecter au serveur

Si vous recevez une erreur de connexion ou un délai d'attente en essayant de rejoindre :

• Vérifiez que le serveur est en cours d'exécution et complètement démarré dans l'onglet Console de GPanel.
• Vérifiez bien que vous utilisez la bonne adresse IP et le bon port de jeu depuis l'onglet Network de GPanel.
• Si le serveur a récemment été mis à jour (surtout lors du wipe forcé du premier jeudi), assurez-vous d'avoir redémarré le serveur après la mise à jour. Les joueurs avec la nouvelle version du client ne peuvent pas se connecter à un serveur exécutant une version plus ancienne.
• Vérifiez que server.maxplayers n'a pas été dépassé. Si le serveur est plein, les nouvelles connexions seront refusées.
• Assurez-vous que vous n'avez pas été banni. Vérifiez auprès de l'administrateur du serveur ou consultez bans.cfg sur le serveur.

Impossible de se connecter à RCON avec un outil externe

Si RustAdmin, RCON.IO ou un autre client RCON ne peut pas se connecter :

• Vérifiez que rcon.web 1 est défini dans server.cfg. La plupart des outils externes nécessitent l'interface RCON WebSocket.
• Confirmez que vous utilisez le port RCON et non le port de jeu. Vérifiez l'onglet Network de GPanel pour votre port RCON attribué.
• Vérifiez que le mot de passe RCON correspond exactement à ce qui est défini dans server.cfg. Les mots de passe sont sensibles à la casse.
• Le serveur doit être complètement démarré avant que les connexions RCON soient acceptées. Attendez Server startup complete dans la console.

Pour les instructions complètes de configuration RCON, consultez Rust RCON Access and Admin Commands.

Les plugins Oxide ne se chargent pas

• Confirmez qu'Oxide est installé et actif. Dans l'onglet Startup de GPanel, la variable FRAMEWORK doit être définie sur oxide. Le journal de la console devrait afficher Loaded plugin Oxide.Core au démarrage.
• Les fichiers de plugins doivent être placés directement dans oxide/plugins/ avec l'extension exacte .cs. Les fichiers dans des sous-répertoires ou avec des extensions incorrectes sont ignorés.
• Vérifiez la console et oxide/logs/ pour les erreurs de compilation. Un plugin avec une erreur de syntaxe ne se chargera pas et le message d'erreur décrira le problème.
• Certains plugins dépendent d'autres plugins (par exemple Economics). Installez d'abord toutes les dépendances requises.
• Assurez-vous que la version du plugin est compatible avec votre version actuelle d'Oxide. Les plugins obsolètes peuvent échouer à la compilation avec une version plus récente d'Oxide.

Pour les instructions complètes d'installation de plugins, consultez Rust Oxide/uMod Plugin Installation.

Le serveur utilise trop de RAM ou de CPU

Si votre serveur est lent, lagge ou dépasse les limites de ressources :

• Réduisez la taille de la carte. Diminuez server.worldsize dans server.cfg. Les cartes plus grandes nécessitent considérablement plus de RAM et de CPU pour fonctionner et être maintenues. Une taille de carte de 3000 est un bon équilibre pour la plupart des serveurs.
• Auditez les plugins installés. Certains plugins mal écrits ou obsolètes peuvent causer une utilisation élevée du CPU ou des fuites de mémoire. Utilisez oxide.plugins pour lister les plugins actifs et essayez de les désactiver un par un pour identifier le coupable.
• Réduisez le nombre de joueurs. Diminuez server.maxplayers si le serveur est sous-dimensionné pour votre nombre actuel de joueurs. Chaque joueur connecté ajoute une charge de ressources supplémentaire.
• Vérifiez l'accumulation d'entités. Sur les serveurs de longue durée, les bases abandonnées et les objets en décomposition peuvent s'accumuler. Un wipe de carte remet le nombre d'entités à zéro.

Les modifications du monde ne sont pas sauvegardées / Retour en arrière après redémarrage

Si la progression des joueurs est perdue après les redémarrages du serveur :

• Vérifiez que server.saveinterval est défini sur une valeur raisonnable dans server.cfg (la valeur par défaut est 60 secondes). Le définir à 0 ou à un nombre très élevé désactive effectivement les sauvegardes automatiques.
• Exécutez server.save manuellement via la console GPanel ou RCON avant d'arrêter le serveur pour forcer une sauvegarde immédiate.
• Assurez-vous que le serveur est arrêté proprement depuis GPanel plutôt que d'être tué de force. Un arrêt brutal peut entraîner la perte des modifications du dernier intervalle de sauvegarde.
• Vérifiez l'espace disque disponible. Si le serveur manque d'espace disque, il ne peut pas écrire les fichiers de sauvegarde.

Le serveur plante au démarrage

Si le serveur démarre mais plante immédiatement ou entre dans une boucle de redémarrage :

• Vérifiez la sortie de la console pour les messages d'erreur. Les causes courantes incluent des fichiers de sauvegarde corrompus, des plugins incompatibles ou des fichiers de framework manquants.
• Si le crash a commencé après l'ajout d'un plugin, supprimez le fichier .cs ajouté le plus récemment de oxide/plugins/ et redémarrez.
• Si le crash a commencé après une mise à jour du jeu, assurez-vous que la variable FRAMEWORK est correctement définie. Les fichiers du framework peuvent nécessiter un re-téléchargement après une mise à jour de Rust — redémarrez simplement le serveur et le framework mis à jour devrait être récupéré automatiquement.
• Essayez de supprimer les fichiers de sauvegarde (proceduralmap.*.sav et proceduralmap.*.map) et d'effectuer un wipe de carte complet. Les fichiers de sauvegarde corrompus peuvent empêcher le démarrage du serveur.

La génération de la carte prend très longtemps

Après un wipe, le serveur doit générer une nouvelle carte procédurale. C'est normal et attendu :

• Une taille de carte de 3000 prend généralement 2 à 5 minutes à générer.
• Les cartes plus grandes (4000-6000) peuvent prendre plus de 10 minutes.
• Ne redémarrez pas le serveur pendant la génération de la carte. Laissez-la se terminer complètement. La console affichera Server startup complete lorsque tout sera prêt.

Besoin d'aide ?

Si votre problème n'est pas couvert ici, notre équipe de support est disponible pour vous aider. Soumettez un ticket de support en incluant :

• L'identifiant de votre serveur (affiché dans GPanel)
• Une description du problème et quand il a commencé
• Toute sortie console ou message d'erreur pertinent
• Les étapes que vous avez déjà essayées