NationsGlory Web Admin

Panel d'administration web pour serveur Minecraft 1.6.4 NationsGlory.

🚀 Quick Start

# Démarrage avec Docker Compose
docker-compose up -d

# Le panel sera accessible sur http://localhost:4001

✨ Fonctionnalités

🎮 Gestion du Serveur

• Console RCON : Interface style terminal Linux pour exécuter des commandes
• Historique des commandes : Sauvegarde persistante avec recherche et suppression
• Contrôle du serveur : Arrêt et redémarrage avec cooldown configurable
• Paramètres en temps réel : Modification des propriétés serveur sans redémarrage

👥 Gestion des Joueurs

• Liste des joueurs connectés : Affichage temps réel avec support des codes couleur Minecraft (§)
• Compteur de joueurs : Affichage X/Y dans le dashboard
• Whitelist : Ajout/suppression de joueurs autorisés
• Logs : Consultation des logs serveur

🔐 Sécurité

• Authentification OP : Seuls les opérateurs du serveur peuvent se connecter
• Sessions persistantes : Gestion sécurisée des sessions
• Masquage des mots de passe : Les mots de passe RCON ne s'affichent pas en clair

🏗️ Architecture

``` WebNationsGlory/ ├── backend/ │ ├── src/ │ │ ├── routes/ # API endpoints │ │ ├── utils/ # RCON client │ │ └── server.js # Express app │ └── data/ │ └── users.json # Utilisateurs ├── frontend/ │ └── public/ │ ├── css/ # Styles │ ├── js/ # SPA vanilla JS │ └── index.html └── docker-compose.yml # Orchestration ```

🔧 Configuration

Prérequis

• Docker & Docker Compose
• Serveur Minecraft 1.6.4 avec RCON activé
• Port 25575 (RCON) et 4001 (Web) disponibles

Variables d'environnement

```env SERVER_DIR=/mc-server # Chemin vers le serveur Minecraft RCON_HOST=localhost # Hôte RCON RCON_PORT=25575 # Port RCON RCON_PASSWORD=votre_mot_de_passe # Mot de passe RCON SESSION_SECRET=secret_securise # Secret pour les sessions ```

Serveur Minecraft (server.properties)

```properties enable-rcon=true rcon.port=25575 rcon.password=votre_mot_de_passe ```

📚 Documentation

• QUICKSTART.md - Guide de démarrage rapide
• CONFIGURATION.md - Configuration détaillée
• DEPLOYMENT.md - Guide de déploiement
• MAINTENANCE.md - Maintenance et dépannage
• CHANGELOG.md - Historique des versions

🔐 Première Connexion

1. Démarrer le serveur Minecraft
2. Démarrer le panel web : `docker-compose up -d`
3. Accéder à http://localhost:4001
4. Se connecter avec un compte OP du serveur Minecraft
5. Le système vérifie automatiquement les permissions OP dans `ops.txt`

🛠️ Développement

Structure Backend

• Express.js : Serveur web Node.js 18
• RCON Client : Implémentation complète du protocole Minecraft RCON (Int32LE)
• Sessions : express-session avec MemoryStore
• Authentification : bcryptjs pour le hachage

Structure Frontend

• Vanilla JavaScript : SPA sans framework
• Style Terminal : Console RCON avec apparence Linux shell
• API REST : Communication avec le backend

⚠️ Notes Importantes

• Le serveur Minecraft doit être démarré avant le panel web
• Seuls les joueurs dans `ops.txt` peuvent se connecter
• L'historique RCON est sauvegardé dans un volume Docker nommé `web-admin`
• Le serveur utilise `network_mode: host` pour accéder au RCON local
• Compatible uniquement avec Minecraft 1.6.4 (codes couleur §)

📦 Volumes Docker

• `mc-server` : Données du serveur Minecraft (lecture/écriture)
• `web-admin` : Données persistantes du panel (.web-admin/)

🐛 Dépannage

Le panel ne se connecte pas au RCON

1. Vérifier que `enable-rcon=true` dans `server.properties`
2. Vérifier le mot de passe RCON
3. Vérifier que le serveur Minecraft est démarré

Les joueurs ne s'affichent pas

1. Vérifier que le dossier `/world/players/` existe
2. Vérifier que `usercache.json` est présent

Impossible de modifier les paramètres

1. Vérifier que le volume `mc-server` n'est pas en lecture seule
2. Vérifier les permissions sur `server.properties`

📄 Licence

Projet privé - NationsGlory Server