4c48ee5fe4
- Suppression de 10 fichiers obsolètes (scripts, tests, docs temporaires) - Suppression des dossiers vides (frontend/src, backend/src/middlewares) - Réecriture complète de 7 fichiers de documentation - README.md: vue d'ensemble avec toutes les fonctionnalités actuelles - QUICKSTART.md: guide de démarrage rapide en 3 étapes - CONFIGURATION.md: guide de configuration complète (Docker, RCON, sécurité) - DEPLOYMENT.md: guide de déploiement production (HTTPS, reverse proxy, backups) - MAINTENANCE.md: guide de maintenance avec dépannage exhaustif - INDEX.md: index de navigation simplifié - CHANGELOG.md: historique complet v1.0.0 - Optimisation docker-compose.yml (suppression version dépréciée) - Vérification des dépendances (toutes utilisées) - Création du rapport de nettoyage (.cleanup-report.md) - Documentation cohérente avec le code actuel - Projet 100% prêt pour la production
4.4 KiB
4.4 KiB
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
- Démarrer le serveur Minecraft
- Démarrer le panel web : `docker-compose up -d`
- Accéder à http://localhost:4001
- Se connecter avec un compte OP du serveur Minecraft
- 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
- Vérifier que `enable-rcon=true` dans `server.properties`
- Vérifier le mot de passe RCON
- Vérifier que le serveur Minecraft est démarré
Les joueurs ne s'affichent pas
- Vérifier que le dossier `/world/players/` existe
- Vérifier que `usercache.json` est présent
Impossible de modifier les paramètres
- Vérifier que le volume `mc-server` n'est pas en lecture seule
- Vérifier les permissions sur `server.properties`
📄 Licence
Projet privé - NationsGlory Server