WebNationsGlory_ServeurBuild_Red/CONFIGURATION.md

🎮 Guide Complet - Interface Web NationsGlory Admin

Étape 1: Préparation du Serveur Minecraft

1.1 Éditer server.properties

Localisez le fichier server.properties du serveur MC et assurez-vous que RCON est activé:

# Ligne 1: Activer RCON
enable-rcon=true

# Ligne 2: Port RCON (25575 par défaut)
rcon.port=25575

# Ligne 3: Mot de passe RCON (important!)
rcon.password=YourStrongPassword123

# Autres paramètres importants
motd=NationsGlory Server
gamemode=survival
difficulty=3
pvp=true
max-players=20

1.2 Redémarrer le Serveur MC

Redémarrez le serveur pour appliquer les changements RCON:

# Si le serveur tourne avec un script
./stop.sh
./start.sh

# Attendez qu'il redémarre complètement

Vérifiez que RCON est actif dans les logs du serveur (vous devriez voir quelque chose comme):

[Server thread/INFO]: RCON running on 0.0.0.0:25575

Étape 2: Installation de l'Interface Web

2.1 Vérifier les Prérequis

# Vérifier Node.js
node --version  # Doit être v14 ou plus

# Vérifier npm
npm --version   # Doit être v6 ou plus

Si Node.js n'est pas installé:

• Linux: sudo apt-get install nodejs npm
• macOS: brew install node
• Windows: Télécharger depuis https://nodejs.org

2.2 Installation Automatique

cd /home/innotex/Documents/Projet/Serveur\ NationsGlory/WebNationsGlory_ServeurBuild_Red

chmod +x install.sh
./install.sh

Cela va:

• ✓ Vérifier Node.js
• ✓ Créer le fichier .env
• ✓ Installer les dépendances npm

Étape 3: Configuration

3.1 Éditer le fichier .env

Ouvrez backend/.env avec votre éditeur préféré:

# Mode d'exécution
NODE_ENV=development

# Port de l'application (8080, 3000, etc.)
PORT=3000

# Clé de session (générer une clé aléatoire forte)
SESSION_SECRET=abc123def456ghi789jkl012mno345pqr

# Chemin EXACT vers le dossier du serveur MC
SERVER_DIR=/home/innotex/Documents/Projet/Serveur NationsGlory/NationsGlory_ServeurBuild_Red

# Paramètres RCON
RCON_HOST=localhost
RCON_PORT=25575

⚠️ Important:

• Vérifiez que SERVER_DIR est le chemin exact
• Le RCON_HOST peut être localhost, 127.0.0.1, ou l'IP du serveur
• SESSION_SECRET doit être unique (utilisez une clé forte)

Étape 4: Lancement

4.1 Démarrer l'Application

cd /home/innotex/Documents/Projet/Serveur\ NationsGlory/WebNationsGlory_ServeurBuild_Red

chmod +x start.sh
./start.sh

Vous devriez voir:

🚀 Backend Admin NationsGlory démarré sur http://localhost:3000
📁 Répertoire du serveur: /home/innotex/Documents/Projet/Serveur NationsGlory/NationsGlory_ServeurBuild_Red

4.2 Accéder à l'Interface

Ouvrez votre navigateur et allez à:

http://localhost:3000

Étape 5: Premier Démarrage

5.1 Créer le Compte Admin

La première fois que vous accédez à l'interface:

1. Tab "Enregistrement" s'affiche

2. Remplissez:

   • Nom d'utilisateur: Le nom que vous voulez pour vous connecter (ex: admin)
   • Mot de passe: Un mot de passe fort
   • Pseudo Minecraft: DOIT être un OP du serveur (ex: VotreNomMC)

3. Cliquez sur "Créer le compte"

⚠️ Attention: Le pseudo Minecraft doit être dans le fichier ops.txt ou ops.json du serveur!

5.2 Se Connecter

Après l'enregistrement:

1. Remplissez le formulaire de connexion
2. Entrez le nom d'utilisateur et mot de passe
3. Cliquez "Se connecter"

5.3 Premier Test

Une fois connecté:

1. Allez à l'onglet Console RCON
2. Entrez une commande simple: /time query daytime
3. Cliquez "Envoyer"
4. Vous devriez voir la réponse

Si ça marche, RCON est correctement configuré! ✓

🆘 Dépannage

Problème: "Erreur RCON: Timeout"

Cause: Le serveur MC ne répond pas

Solutions:

1. Vérifiez que le serveur MC est en ligne
2. Vérifiez que RCON est activé dans server.properties
3. Vérifiez le port RCON (25575 par défaut)
4. Testez RCON avec un autre client:

   telnet localhost 25575
   

Problème: "Mot de passe RCON incorrect"

Cause: Le mot de passe ne correspond pas

Solution:

1. Vérifiez le mot de passe dans server.properties
2. Modifiez via l'interface: Dashboard → Changer RCON
3. Redémarrez le serveur MC après changement

Problème: "Le joueur n'est pas OP sur le serveur"

Cause: Votre pseudo MC n'est pas OP

Solution:

1. Sur le serveur MC, dans la console:

   op VotreNomMC
   

2. Attendez que le serveur se redémarre ou recharge les OPs
3. Réessayez l'enregistrement

Problème: "Impossible de se connecter à localhost:3000"

Cause: L'application n'est pas lancée ou sur le mauvais port

Solution:

1. Vérifiez que npm start est lancé dans backend/
2. Vérifiez le PORT dans .env
3. Assurez-vous qu'aucune autre application n'utilise ce port:

   lsof -i :3000  # Linux/Mac
   netstat -ano | findstr :3000  # Windows
   

Problème: "Node.js n'est pas trouvé"

Solution: Installer Node.js

• Ubuntu/Debian: sudo apt-get install nodejs npm
• CentOS/RHEL: sudo yum install nodejs npm
• macOS: brew install node
• Windows: https://nodejs.org

📊 Fonctionnalités Détaillées

Console RCON

Exécutez n'importe quelle commande Minecraft:

/say Bienvenue!
/gamemode 1 @p
/give @p diamond 64
/weather clear

Gestion des Logs

• Affichage temps réel
• Recherche par mot-clé
• Support multi-fichiers

Whitelist

• Ajouter des joueurs
• Supprimer des joueurs
• Format JSON automatique

Backups

• Création manuelle
• Compression tar.gz
• Gestion de l'espace

Paramètres

• Lire tous les paramètres server.properties
• Modifier certains paramètres
• Changement de RCON

🔒 Sécurité - Important!

En Production:

1. Changez SESSION_SECRET:

   node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
   

2. Utilisez HTTPS:

   • Achetez un certificat SSL
   • Configurez un proxy (nginx/Apache)
   • Voir DEPLOYMENT.md

3. Limitez l'accès:

   • Firewall: autoriser seulement vos IPs
   • VPN: si accès distant
   • Proxy avec authentification

4. Changez RCON:

   • Utilisez un mot de passe fort
   • Changez-le régulièrement

5. Backups:

   • Sauvegardez vos backups ailleurs
   • Testez les restaurations

📞 Support et Aide

Vérification Rapide

# Vérifier que Node.js fonctionne
node --version

# Tester npm
npm --version

# Vérifier RCON du serveur MC
echo "status" | nc localhost 25575

# Vérifier les logs
cat /path/to/mc-server/latest.log | tail -50

Logs de l'Application

Les logs du backend s'affichent en direct quand vous lancez npm start.

Logs des commandes RCON:

SERVER_DIR/.web-admin/rcon-history.json

🚀 Prochaines Étapes

• Tester toutes les fonctionnalités
• Ajouter des joueurs à la whitelist
• Créer des backups réguliers
• Configurer HTTPS pour la production
• Automatiser avec des scripts

📝 Notes Importantes

1. Redémarrage du serveur: Les joueurs seront déconnectés
2. Sauvegarde: Faites des backups réguliers
3. RCON: Gardez le mot de passe sécurisé
4. Logs: Vérifiez régulièrement pour les erreurs
5. Mises à jour: Vérifiez les mises à jour Node.js

Bon courage avec votre serveur! 🎮