WebNationsGlory_ServeurBuild_Red/README.md

Interface Web d'Administration - NationsGlory

Application web complète pour gérer votre serveur Minecraft 1.6.4 sans taper une seule commande!

🚀 Fonctionnalités

🔐 Sécurité

• Authentification sécurisée par mot de passe
• Seuls les OPs du serveur MC peuvent se connecter
• Sessions sécurisées avec expiration

⌨️ Console RCON

• Exécutez des commandes directement depuis l'interface
• Historique complet des commandes
• Réponses en temps réel

📊 Dashboard

• État du serveur en temps réel
• Nombre de joueurs connectés
• Informations rapides du serveur

📜 Logs

• Visualisation des logs en temps réel
• Recherche dans les logs
• Plusieurs fichiers logs supportés

👥 Gestion des Joueurs

• Liste de tous les joueurs ayant joué
• UUID et dernière connexion
• Informations détaillées

✅ Whitelist

• Ajouter/supprimer des joueurs
• Gestion complète de la whitelist
• Support des formats JSON et TXT

💾 Backups

• Création de backups automatiques
• Gestion des anciens backups
• Suppression facile

⚙️ Paramètres

• Modification des settings du serveur
• Changement du mot de passe RCON
• Gestion complète de server.properties

🔄 Commandes Utiles

• Redémarrage du serveur
• Sauvegarde du monde
• Notifications aux joueurs

📋 Prérequis

• Node.js 14+ et npm
• Serveur Minecraft avec RCON activé
• RCON correctement configuré dans server.properties

🔧 Installation

1. Préparer le serveur Minecraft

Éditer server.properties du serveur MC:

enable-rcon=true
rcon.port=25575
rcon.password=votreMotDePasseRcon

Redémarrer le serveur MC.

2. Installer l'interface web

cd WebNationsGlory_ServeurBuild_Red
chmod +x install.sh
./install.sh

3. Configurer

Éditer backend/.env:

NODE_ENV=development
PORT=3000
SESSION_SECRET=changez-cette-cle-en-production
SERVER_DIR=/path/to/NationsGlory_ServeurBuild_Red
RCON_HOST=localhost
RCON_PORT=25575

4. Lancer l'application

chmod +x start.sh
./start.sh

L'interface est maintenant accessible sur: http://localhost:3000

🎯 Premier Démarrage

1. Ouvrez http://localhost:3000
2. Créez le compte admin (doit être un OP du serveur)
3. Connectez-vous
4. Explorez l'interface!

📁 Structure du Projet

WebNationsGlory_ServeurBuild_Red/
├── backend/
│   ├── package.json
│   ├── .env (à créer)
│   └── src/
│       ├── server.js (point d'entrée)
│       ├── routes/
│       │   ├── auth.js (authentification)
│       │   ├── rcon.js (console & contrôle)
│       │   ├── logs.js (visualisation logs)
│       │   ├── players.js (gestion joueurs)
│       │   ├── whitelist.js (gestion whitelist)
│       │   ├── backup.js (gestion backups)
│       │   └── server.js (paramètres)
│       └── utils/
│           └── rcon.js (client RCON)
├── frontend/
│   └── public/
│       ├── index.html
│       ├── js/app.js
│       └── css/style.css
└── start.sh

🔌 API Endpoints

Authentification

• POST /api/auth/register - Créer un compte admin
• POST /api/auth/login - Se connecter
• GET /api/auth/check - Vérifier la connexion
• POST /api/auth/logout - Se déconnecter

Console RCON

• POST /api/rcon/command - Exécuter une commande
• GET /api/rcon/history - Historique des commandes
• POST /api/rcon/restart - Redémarrer le serveur
• POST /api/rcon/save - Sauvegarder

Serveur

• GET /api/server - Récupérer les paramètres
• POST /api/server/update - Mettre à jour un paramètre

Logs

• GET /api/logs - Récupérer les logs
• GET /api/logs/files - Lister les fichiers logs
• GET /api/logs/file/:filename - Lire un fichier spécifique
• GET /api/logs/search?query=... - Chercher dans les logs

Joueurs

• GET /api/players - Lister les joueurs

Whitelist

• GET /api/whitelist - Récupérer la whitelist
• POST /api/whitelist/add - Ajouter un joueur
• POST /api/whitelist/remove - Retirer un joueur

Backups

• GET /api/backup - Lister les backups
• POST /api/backup/create - Créer un backup
• POST /api/backup/delete/:filename - Supprimer un backup

🆘 Dépannage

La connexion RCON échoue

• Vérifiez que RCON est activé dans server.properties
• Vérifiez le port et le mot de passe
• Assurez-vous que le serveur MC est en ligne

Les logs ne s'affichent pas

• Vérifiez le chemin de SERVER_DIR dans .env
• Assurez-vous que les fichiers logs existent

Les joueurs ne s'affichent pas

• Attendez qu'au moins un joueur se soit connecté
• Vérifiez que usercache.json existe

⚠️ Sécurité

En production:

• Changez SESSION_SECRET avec une clé forte
• Utilisez HTTPS
• Placez derrière un proxy (nginx, Apache)
• Limitez l'accès par IP si possible

📝 Logs Applicatifs

Les logs de l'application se trouvent dans:

• Backend console: directement dans le terminal
• RCON historique: SERVER_DIR/.web-admin/rcon-history.json

🎮 Commandes Minecraft Utiles

Depuis la console RCON:

• /say Message - Envoyer un message à tous
• /tp @p @s - Tp un joueur
• /give @p diamond 64 - Donner des items
• /weather clear - Changer la météo
• /time set day - Régler l'heure
• /difficulty 2 - Changer la difficulté

📞 Support

Pour les problèmes:

1. Vérifiez la configuration du .env
2. Vérifiez les logs du backend
3. Testez RCON avec un client externe
4. Vérifiez les permissions sur les fichiers du serveur

🔄 Mises à Jour

L'interface se met à jour automatiquement. Pour mettre à jour les dépendances:

cd backend
npm update

📄 License

MIT - Libre d'utilisation