From d5e57eec7bc2c7c7809117de82042898a44d4f95 Mon Sep 17 00:00:00 2001 From: "y.campiontrebouta@innotexnas.ovh" Date: Wed, 4 Feb 2026 00:05:23 +0100 Subject: [PATCH] =?UTF-8?q?feat:=20Configuration=20FLAT=20+=20Documentatio?= =?UTF-8?q?n=20RCON=20compl=C3=A8te?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Configure monde en FLAT par défaut - Active mode créatif (gamemode=1) - Accepte comptes crack (online-mode=false) - Ajoute CONFIGURATION.md avec guide RCON détaillé - Améliore README.md avec navigation - Crée INDEX.md pour navigation docs - Nettoie docker-compose.yml --- CHANGELOG.md | 49 +++++++ CONFIGURATION.md | 312 +++++++++++++++++++++++++++++++++++++++++++++ INDEX.md | 290 ++++++++++++++++------------------------- QUICKSTART.md | 145 ++++++++++----------- README.md | 77 ++++++++--- docker-compose.yml | 2 - 6 files changed, 608 insertions(+), 267 deletions(-) create mode 100644 CHANGELOG.md create mode 100644 CONFIGURATION.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..add86e4 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,49 @@ +# 📝 Changelog - NationsGlory 1.6.4 + +## [1.1.0] - 2026-02-03 + +### ✨ Ajouts +- **CONFIGURATION.md** : Documentation complète de configuration + - Guide RCON avec mot de passe en ligne de commande + - Configuration du monde FLAT + - Optimisation performances + - Sauvegardes automatiques + - Monitoring et logs +- **QUICKSTART.md** : Guide de démarrage rapide (3 minutes) +- **INDEX.md** : Navigation complète de la documentation + +### 🔧 Modifications +- **README.md** : Amélioré avec badges et liens vers documentation +- **docker-compose.yml** : Retrait de `version: '3'` (obsolète) +- **server.properties** : + - `online-mode=false` (accepte comptes crack) + - `level-type=FLAT` (monde plat) + - `gamemode=1` (mode créatif) + +### 🔐 Sécurité +- Documentation complète pour définir mot de passe RCON +- Guide d'authentification RCON avec IP serveur +- Exemples de commandes sécurisées + +### 📖 Documentation +- Navigation améliorée avec INDEX.md +- Guide RCON détaillé dans CONFIGURATION.md +- Troubleshooting étendu +- Scripts de sauvegarde automatique + +### 🐛 Corrections +- Monde généré en mode FLAT (avant: DEFAULT) +- Mode créatif par défaut (avant: survie) +- Comptes crack acceptés (avant: online-mode=true) +- Configuration RCON fonctionnelle avec network_mode: host + +--- + +## [1.0.0] - 2026-02-02 + +### 🎉 Version initiale +- MCPC+ 1.6.4-R2.1-forge965-B251 +- 21 mods Forge +- 6 plugins Bukkit (WorldEdit 5.6, Essentials 2.13.1) +- Configuration Docker complète +- Documentation de base diff --git a/CONFIGURATION.md b/CONFIGURATION.md new file mode 100644 index 0000000..eb08696 --- /dev/null +++ b/CONFIGURATION.md @@ -0,0 +1,312 @@ +# 🔧 Configuration avancée - NationsGlory 1.6.4 + +## 📝 Fichiers de configuration + +### docker-compose.yml +Configuration Docker principale. Variables importantes: + +```yaml +environment: + SERVER_PORT: "25565" # Port du serveur Minecraft + RCON_PORT: "25575" # Port RCON (administration) + RCON_PASSWORD: "minecraft" # ⚠️ À CHANGER pour la sécurité + ONLINE_MODE: "FALSE" # Accepte les comptes crack + GAMEMODE: "1" # 0=Survie, 1=Créatif, 2=Aventure + LEVEL_TYPE: "FLAT" # Type de monde (FLAT, DEFAULT, LARGEBIOMES) + MEMORY: "2G" # RAM maximale + INIT_MEMORY: "1G" # RAM initiale +``` + +### server.properties +Généré automatiquement. Modifications manuelles nécessaires pour: +- `online-mode=false` (authentification crack) +- `level-type=FLAT` (monde plat) +- `gamemode=1` (mode créatif) +- `rcon.password=VotreMotDePasse` (mot de passe RCON) + +⚠️ **Redémarrez après modification**: `docker-compose restart` + +--- + +## 🔐 Configuration RCON sécurisée + +### 1. Définir le mot de passe RCON + +**Méthode 1: Avant le premier démarrage** +```bash +# Éditer server.properties +echo "rcon.password=VotreMotDePasseSecurise" >> server.properties +echo "enable-rcon=true" >> server.properties +``` + +**Méthode 2: Serveur en cours** +```bash +# Arrêter le serveur +docker-compose down + +# Modifier la configuration +sed -i 's/^rcon.password=.*/rcon.password=NouveauMotDePasse/' server.properties + +# Redémarrer +docker-compose up -d +``` + +### 2. Tester RCON + +```bash +# Remplacer 192.168.1.252 par votre IP serveur +docker exec mc-nationsglory rcon-cli \ + --host 192.168.1.252 \ + --port 25575 \ + --password VotreMotDePasse \ + "list" +``` + +### 3. Mode interactif + +```bash +docker exec -it mc-nationsglory rcon-cli \ + --host 192.168.1.252 \ + --port 25575 \ + --password VotreMotDePasse + +# Dans la console RCON: +> list +> op JoueurAdmin +> save-all +> stop +``` + +--- + +## 🌍 Configuration du monde + +### Réinitialiser le monde en FLAT + +```bash +# 1. Arrêter le serveur +docker-compose down + +# 2. Supprimer l'ancien monde +sudo rm -rf world world_* + +# 3. Modifier server.properties +sed -i 's/level-type=.*/level-type=FLAT/' server.properties + +# 4. Redémarrer (génère un nouveau monde FLAT) +docker-compose up -d +``` + +### Types de mondes disponibles + +- **FLAT** : Monde plat (idéal construction) +- **DEFAULT** : Monde normal avec biomes +- **LARGEBIOMES** : Biomes plus grands +- **AMPLIFIED** : Relief extrême (nécessite plus de RAM) + +--- + +## 🎮 Gestion des joueurs + +### Donner les droits OP + +**Via RCON:** +```bash +docker exec mc-nationsglory rcon-cli \ + --host 192.168.1.252 \ + --port 25575 \ + --password VotreMotDePasse \ + "op NomJoueur" +``` + +**Manuellement:** +```bash +# Ajouter au fichier ops.txt +echo "NomJoueur" >> ops.txt +docker-compose restart +``` + +### Bannir/Débannir + +```bash +# Bannir +docker exec mc-nationsglory rcon-cli --host IP --port 25575 --password MDP "ban JoueurMechant" + +# Débannir +docker exec mc-nationsglory rcon-cli --host IP --port 25575 --password MDP "pardon JoueurMechant" +``` + +--- + +## 💾 Sauvegardes automatiques + +### Script de sauvegarde + +```bash +#!/bin/bash +# save-world.sh + +BACKUP_DIR="$HOME/backups/nationsglory" +DATE=$(date +%Y%m%d_%H%M%S) + +# Créer le dossier de sauvegarde +mkdir -p "$BACKUP_DIR" + +# Forcer la sauvegarde +docker exec mc-nationsglory rcon-cli \ + --host 192.168.1.252 \ + --port 25575 \ + --password VotreMotDePasse \ + "save-all" + +# Attendre la fin +sleep 5 + +# Archiver +cd /chemin/vers/serveur +tar -czf "$BACKUP_DIR/world_$DATE.tar.gz" world/ + +echo "✅ Sauvegarde créée: $BACKUP_DIR/world_$DATE.tar.gz" +``` + +### Automatiser avec cron + +```bash +# Éditer crontab +crontab -e + +# Sauvegarder toutes les 6 heures +0 */6 * * * /chemin/vers/save-world.sh >> /var/log/minecraft-backup.log 2>&1 +``` + +--- + +## 🚀 Optimisation performances + +### Augmenter la RAM + +```yaml +# docker-compose.yml +environment: + MEMORY: "4G" # RAM max + INIT_MEMORY: "2G" # RAM initiale + +deploy: + resources: + limits: + memory: 5G # Limite Docker +``` + +### Options JVM optimisées + +```yaml +command: + - sh + - -c + - | + cd /data + exec java \ + -Xms2G -Xmx4G \ + -XX:+UseG1GC \ + -XX:+ParallelRefProcEnabled \ + -XX:MaxGCPauseMillis=200 \ + -XX:+UnlockExperimentalVMOptions \ + -XX:+DisableExplicitGC \ + -XX:G1NewSizePercent=30 \ + -XX:G1MaxNewSizePercent=40 \ + -XX:G1HeapRegionSize=8M \ + -jar mcpc.jar nogui +``` + +--- + +## 🔍 Monitoring + +### Voir les logs en temps réel + +```bash +# Tous les logs +docker logs -f mc-nationsglory + +# Sans spam Forge (filtrer les >) +docker logs -f mc-nationsglory 2>&1 | sed -u '/^>/d' + +# Rechercher des erreurs +docker logs mc-nationsglory 2>&1 | grep -i "error\|exception" +``` + +### Surveiller les ressources + +```bash +# Utilisation CPU/RAM +docker stats mc-nationsglory + +# Processus Java +docker exec mc-nationsglory ps aux | grep java +``` + +--- + +## 🐛 Dépannage courant + +### Problème: "Failed to verify username" +**Cause**: `online-mode=true` +**Solution**: +```bash +docker exec mc-nationsglory sed -i 's/online-mode=true/online-mode=false/' /data/server.properties +docker-compose restart +``` + +### Problème: RCON "authentication failed" +**Cause**: Mot de passe incorrect ou vide +**Solution**: +```bash +# Vérifier le mot de passe +docker exec mc-nationsglory grep "rcon.password" /data/server.properties + +# Le définir +docker exec mc-nationsglory sed -i 's/^rcon.password=.*/rcon.password=NouveauMDP/' /data/server.properties +docker-compose restart +``` + +### Problème: Le monde n'est pas FLAT +**Solution**: +```bash +docker-compose down +sudo rm -rf world world_* +sed -i 's/level-type=.*/level-type=FLAT/' server.properties +docker-compose up -d +``` + +### Problème: Serveur lag +**Solutions**: +1. Augmenter RAM (voir Optimisation) +2. Réduire view-distance dans server.properties: `view-distance=8` +3. Nettoyer les logs: `docker exec mc-nationsglory rm -f /data/*.log` + +--- + +## 📊 Variables d'environnement complètes + +| Variable | Valeur par défaut | Description | +|----------|------------------|-------------| +| `SERVER_PORT` | 25565 | Port Minecraft | +| `RCON_PORT` | 25575 | Port RCON | +| `RCON_PASSWORD` | minecraft | Mot de passe RCON | +| `ENABLE_RCON` | true | Activer RCON | +| `ONLINE_MODE` | FALSE | Authentification Mojang | +| `GAMEMODE` | 1 | Mode de jeu (0/1/2) | +| `DIFFICULTY` | 1 | Difficulté (0-3) | +| `LEVEL_TYPE` | FLAT | Type de monde | +| `MEMORY` | 2G | RAM maximale | +| `INIT_MEMORY` | 1G | RAM initiale | +| `JVM_OPTS` | (voir docker-compose.yml) | Options Java | + +--- + +## 🔗 Ressources + +- [Documentation MCPC+](https://www.spigotmc.org/wiki/mcpc-plus/) +- [Commandes WorldEdit](https://worldedit.enginehub.org/en/latest/commands/) +- [Commandes Essentials](https://essinfo.xeya.me/commands.html) +- [Options JVM Minecraft](https://aikar.co/2018/07/02/tuning-the-jvm-g1gc-garbage-collector-flags-for-minecraft/) diff --git a/INDEX.md b/INDEX.md index 041a199..25c8d4d 100644 --- a/INDEX.md +++ b/INDEX.md @@ -1,205 +1,137 @@ -# 📖 Index de Documentation - Serveur NationsGlory +# 📚 Documentation NationsGlory 1.6.4 -Bienvenue dans la documentation complète du serveur NationsGlory MCPC+ 1.6.4 ! +## 🎯 Par où commencer? -## 🎯 Guide de navigation +### Nouveau sur le projet? +1. **[README.md](README.md)** - Vue d'ensemble et installation rapide +2. **[QUICKSTART.md](QUICKSTART.md)** - Démarrage en 3 minutes +3. **[CONFIGURATION.md](CONFIGURATION.md)** - Configuration RCON et optimisation -### Pour commencer rapidement +### Déploiement en production? +1. **[DEPLOY_README.md](DEPLOY_README.md)** - Guide de déploiement complet +2. **[DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md)** - Checklist pré/post déploiement -1. **🚀 Nouveau sur ce serveur ?** - - Commencez par [QUICKSTART.md](QUICKSTART.md) - Démarrage en 2 minutes - - Puis lisez [README.md](README.md) - Vue d'ensemble complète +--- -2. **🐳 Vous voulez utiliser Docker ?** - - Lisez [DOCKER.md](DOCKER.md) - Guide Docker complet - - Utilisez le `Makefile` pour des commandes simplifiées +## 📖 Documentation complète -3. **🌐 Migration vers serveur de production ?** - - Suivez [DEPLOYMENT.md](DEPLOYMENT.md) - Déploiement sur /srv/minecraft - - Utilisez `./migrate-to-srv.sh` pour automatiser +### 🚀 Démarrage +- **[README.md](README.md)** - Introduction et installation +- **[QUICKSTART.md](QUICKSTART.md)** - Démarrage rapide +- **[DOCKER.md](DOCKER.md)** - Utilisation Docker -## 📚 Documentation par thème +### ⚙️ Configuration +- **[CONFIGURATION.md](CONFIGURATION.md)** - Configuration avancée + - Configuration RCON avec mot de passe + - Gestion du monde (FLAT, reset) + - Optimisation performances + - Sauvegardes automatiques + - Monitoring et logs -### 🎮 Utilisation du serveur +### 🔧 Déploiement +- **[DEPLOY_README.md](DEPLOY_README.md)** - Guide de déploiement +- **[DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md)** - Checklist +- **[INSTALLATION.md](INSTALLATION.md)** - Installation détaillée +- **[TRANSFER-REMOTE.md](TRANSFER-REMOTE.md)** - Transfert vers serveur distant -| Document | Description | Niveau | -|----------|-------------|--------| -| [QUICKSTART.md](QUICKSTART.md) | Commandes essentielles et démarrage rapide | ⭐ Débutant | -| [README.md](README.md) | Guide complet du serveur, configuration, mods, plugins | ⭐⭐ Intermédiaire | -| [INSTALLATION.md](INSTALLATION.md) | Détails de l'installation, statistiques, fonctionnalités | ⭐⭐ Intermédiaire | +### 🛠️ Technique +- **[TECHNICAL_NOTES.md](TECHNICAL_NOTES.md)** - Notes techniques +- **[.gitignore](.gitignore)** - Fichiers ignorés par Git +- **[docker-compose.yml](docker-compose.yml)** - Configuration Docker -### 🐳 Docker et conteneurisation - -| Document | Description | Niveau | -|----------|-------------|--------| -| [DOCKER.md](DOCKER.md) | Utilisation avec Docker Compose, commandes Make | ⭐⭐ Intermédiaire | -| [DEPLOYMENT.md](DEPLOYMENT.md) | Déploiement production, /srv/minecraft, Traefik | ⭐⭐⭐ Avancé | -| `docker-compose.yml` | Configuration Docker Compose | ⭐⭐⭐ Avancé | -| `.env.example` | Variables d'environnement | ⭐ Débutant | -| `Makefile` | Commandes simplifiées (make help) | ⭐ Débutant | - -### 🔧 Configuration et techniques - -| Document | Description | Niveau | -|----------|-------------|--------| -| [TECHNICAL_NOTES.md](TECHNICAL_NOTES.md) | Notes techniques détaillées, JVM, Docker | ⭐⭐⭐ Avancé | -| `server-final/server.properties` | Configuration serveur Minecraft | ⭐⭐ Intermédiaire | - -### 🛠️ Scripts et automatisation - -| Fichier | Description | Usage | -|---------|-------------|-------| -| `migrate-to-srv.sh` | Migration vers /srv/minecraft | `sudo ./migrate-to-srv.sh` | -| `install-prod.sh` | Installation automatique sur serveur | `sudo ./install-prod.sh` | -| `server-final/start-docker.sh` | Démarrage serveur (méthode originale) | `./start-docker.sh` | -| `Makefile` | Commandes simplifiées | `make start`, `make help` | - -## 🗺️ Parcours recommandés - -### Parcours 1 : Débutant - Test rapide en local - -1. ✅ Lire [QUICKSTART.md](QUICKSTART.md) -2. ✅ Exécuter `cd server-final && ./start-docker.sh` -3. ✅ Se connecter au serveur (localhost:25565) -4. ✅ Tester les commandes dans [QUICKSTART.md](QUICKSTART.md) - -**Temps estimé** : 10 minutes - -### Parcours 2 : Intermédiaire - Déploiement Docker local - -1. ✅ Lire [DOCKER.md](DOCKER.md) -2. ✅ Copier `.env.example` vers `.env` -3. ✅ Exécuter `make start` ou `docker-compose up -d` -4. ✅ Utiliser les commandes Make (`make logs`, `make backup`, etc.) -5. ✅ Lire [README.md](README.md) pour comprendre les mods et plugins - -**Temps estimé** : 30 minutes - -### Parcours 3 : Avancé - Déploiement production - -1. ✅ Lire [DEPLOYMENT.md](DEPLOYMENT.md) en entier -2. ✅ Préparer le serveur (Docker, firewall, /srv/minecraft) -3. ✅ Exécuter `sudo ./migrate-to-srv.sh` ou migration manuelle -4. ✅ Configurer les backups automatiques -5. ✅ Configurer Traefik (si nécessaire) -6. ✅ Lire [TECHNICAL_NOTES.md](TECHNICAL_NOTES.md) pour optimisation - -**Temps estimé** : 1-2 heures - -### Parcours 4 : Expert - Migration vers serveur distant - -1. ✅ Lire [DEPLOYMENT.md](DEPLOYMENT.md) section "Transfert vers machine distante" -2. ✅ Créer archive : `tar -czf nationsglory-docker.tar.gz ...` -3. ✅ Transférer via SCP -4. ✅ Sur le serveur : `sudo ./install-prod.sh` -5. ✅ Extraire et configurer -6. ✅ Démarrer et tester -7. ✅ Configurer monitoring et backups - -**Temps estimé** : 2-3 heures +--- ## 🔍 Recherche rapide ### Je veux... -| Objectif | Document(s) | Commande | -|----------|-------------|----------| -| **Démarrer le serveur rapidement** | [QUICKSTART.md](QUICKSTART.md) | `make start` ou `./start-docker.sh` | -| **Voir les logs** | [DOCKER.md](DOCKER.md) | `make logs` ou `docker-compose logs -f` | -| **Faire un backup** | [DEPLOYMENT.md](DEPLOYMENT.md) | `make backup` | -| **Donner OP à un joueur** | [QUICKSTART.md](QUICKSTART.md) | `make console` puis `op ` | -| **Changer la RAM** | [DOCKER.md](DOCKER.md) | Éditer `.env` puis `make restart` | -| **Migrer vers /srv/minecraft** | [DEPLOYMENT.md](DEPLOYMENT.md) | `sudo ./migrate-to-srv.sh` | -| **Ajouter un mod** | [README.md](README.md) | Copier dans `mods/` puis `make restart` | -| **Réinitialiser le monde** | [DEPLOYMENT.md](DEPLOYMENT.md) | `make reset-world` | -| **Optimiser les performances** | [TECHNICAL_NOTES.md](TECHNICAL_NOTES.md) | Augmenter RAM, réduire view-distance | -| **Configurer backups auto** | [DEPLOYMENT.md](DEPLOYMENT.md) | Voir section "Sauvegardes" | +**Installer le serveur** +→ [QUICKSTART.md](QUICKSTART.md) -## 📊 Statistiques du projet +**Configurer le mot de passe RCON** +→ [CONFIGURATION.md](CONFIGURATION.md#-configuration-rcon-sécurisée) -### Configuration serveur +**Mettre le monde en FLAT** +→ [CONFIGURATION.md](CONFIGURATION.md#-configuration-du-monde) -- **Version Minecraft** : 1.6.4 -- **Serveur** : MCPC+ 1.6.4-R2.1-forge965-B251 -- **Forge** : 9.11.1.965 -- **Java** : 7 (via Docker) -- **Image Docker** : itzg/minecraft-server:java8 +**Optimiser les performances** +→ [CONFIGURATION.md](CONFIGURATION.md#-optimisation-performances) -### Contenu +**Résoudre un problème** +→ [CONFIGURATION.md](CONFIGURATION.md#-dépannage-courant) -- **Mods** : 21 actifs (Chisel, WesterosBlocks, BiblioCraft, etc.) -- **Plugins** : 2 (WorldEdit, Essentials) -- **Taille totale** : ~120 MB -- **Type de monde** : FLAT (super-plat) +**Déployer en production** +→ [DEPLOY_README.md](DEPLOY_README.md) -### Documentation +**Faire des sauvegardes** +→ [CONFIGURATION.md](CONFIGURATION.md#-sauvegardes-automatiques) -- **Fichiers MD** : 6 guides complets -- **Scripts** : 3 scripts d'automatisation -- **Configuration** : Docker Compose + Makefile -- **Langues** : Français 🇫🇷 - -## 🆘 Aide et support - -### Problèmes courants - -| Problème | Solution | Document | -|----------|----------|----------| -| Le serveur ne démarre pas | `make logs` pour voir les erreurs | [DEPLOYMENT.md](DEPLOYMENT.md) section Dépannage | -| Permission denied | `make fix-permissions` ou `sudo chown -R 1000:1000 .` | [DOCKER.md](DOCKER.md) | -| Port déjà utilisé | Changer `MINECRAFT_PORT` dans `.env` | [DOCKER.md](DOCKER.md) | -| Connexion refusée | Vérifier `online-mode=false` | [README.md](README.md) | -| Lag/performances | Augmenter RAM, réduire view-distance | [TECHNICAL_NOTES.md](TECHNICAL_NOTES.md) | - -### Commandes de diagnostic - -```bash -make check # Vérifier configuration -make status # État du serveur -make stats # Statistiques détaillées -docker ps # Conteneurs actifs -docker logs mc-nationsglory # Logs Docker -``` - -## 🎓 Ressources additionnelles - -### Liens utiles - -- **Docker** : https://docs.docker.com/ -- **Docker Compose** : https://docs.docker.com/compose/ -- **itzg/minecraft-server** : https://github.com/itzg/docker-minecraft-server -- **MCPC+** : https://www.spigotmc.org/wiki/mcpc-plus/ -- **Minecraft Forge** : https://files.minecraftforge.net/ - -### Communauté - -- Serveur Discord NationsGlory (si disponible) -- Forum NationsGlory -- GitHub Issues pour bugs/suggestions - -## 📅 Versions et changelog - -| Date | Version | Changements | -|------|---------|-------------| -| 2026-02-03 | 1.0.0 | Installation initiale, configuration Docker, documentation complète | - -## 📝 Contribution - -Pour contribuer à cette documentation : - -1. Identifier les améliorations possibles -2. Proposer des modifications -3. Tester les changements -4. Mettre à jour l'index si nécessaire - -## 📜 Licence - -Configuration serveur NationsGlory - Usage privé/éducatif +**Donner les droits admin** +→ [CONFIGURATION.md](CONFIGURATION.md#-gestion-des-joueurs) --- -**Dernière mise à jour** : 3 février 2026 -**Mainteneur** : Configuration automatique -**Contact** : Voir documentation principale +## 📦 Structure du projet -💡 **Astuce** : Utilisez `make help` pour voir toutes les commandes disponibles ! +``` +nationsglory-server/ +├── README.md # 📄 Vue d'ensemble +├── QUICKSTART.md # ⚡ Démarrage rapide +├── CONFIGURATION.md # 🔧 Configuration avancée +├── INDEX.md # 📚 Navigation documentation (ce fichier) +│ +├── docker-compose.yml # 🐳 Config Docker +├── .gitignore # 🚫 Fichiers ignorés +├── server.properties # ⚙️ Config serveur (généré) +│ +├── mcpc.jar # 🎮 Serveur MCPC+ (29 MB) +├── server.jar -> mcpc.jar # 🔗 Lien symbolique +│ +├── mods/ # 📦 21 mods Forge +├── plugins/ # 🔌 6 plugins Bukkit +├── config/ # ⚙️ Configurations mods +│ +├── world/ # 🌍 Monde Minecraft (ignoré Git) +└── logs/ # 📋 Logs serveur (ignoré Git) +``` + +--- + +## 🆘 Support + +### Problèmes courants + +| Problème | Documentation | +|----------|---------------| +| Serveur ne démarre pas | [CONFIGURATION.md - Dépannage](CONFIGURATION.md#-dépannage-courant) | +| RCON ne fonctionne pas | [CONFIGURATION.md - RCON](CONFIGURATION.md#-configuration-rcon-sécurisée) | +| Monde pas FLAT | [CONFIGURATION.md - Monde](CONFIGURATION.md#-configuration-du-monde) | +| "Failed to verify username" | [CONFIGURATION.md - Dépannage](CONFIGURATION.md#-dépannage-courant) | +| Serveur lag | [CONFIGURATION.md - Optimisation](CONFIGURATION.md#-optimisation-performances) | + +### Logs utiles + +```bash +# Logs serveur sans spam +docker logs -f mc-nationsglory 2>&1 | sed -u '/^>/d' + +# Erreurs uniquement +docker logs mc-nationsglory 2>&1 | grep -i "error\|exception" + +# Configuration actuelle +docker exec mc-nationsglory cat /data/server.properties +``` + +--- + +## 🔗 Liens utiles + +- [MCPC+ Documentation](https://www.spigotmc.org/wiki/mcpc-plus/) +- [WorldEdit Commands](https://worldedit.enginehub.org/en/latest/commands/) +- [Essentials Commands](https://essinfo.xeya.me/commands.html) +- [Docker Documentation](https://docs.docker.com/) + +--- + +**Version**: 1.0.0 +**Dernière mise à jour**: 3 février 2026 diff --git a/QUICKSTART.md b/QUICKSTART.md index b125571..b77994b 100644 --- a/QUICKSTART.md +++ b/QUICKSTART.md @@ -1,80 +1,83 @@ -# 🚀 Guide de démarrage rapide - NationsGlory +# ⚡ Démarrage Rapide - NationsGlory 1.6.4 -## Démarrer le serveur +## 🎯 Installation en 3 minutes + +### 1️⃣ Cloner le projet +```bash +git clone nationsglory-server +cd nationsglory-server +``` + +### 2️⃣ Configurer RCON (recommandé) +```bash +# Définir un mot de passe RCON sécurisé +sed -i 's/^rcon.password=.*/rcon.password=MonMotDePasseSecurise/' server.properties +``` + +### 3️⃣ Démarrer le serveur +```bash +docker-compose up -d +``` + +### 4️⃣ Vérifier le démarrage +```bash +# Voir les logs (sans spam Forge) +docker logs -f mc-nationsglory 2>&1 | sed -u '/^>/d' + +# Attendre "Done" (environ 1-2 minutes) +``` + +### 5️⃣ Se connecter +- **Adresse**: `IP_SERVEUR:25565` +- **Version**: Minecraft 1.6.4 + Forge 9.11.1.965 +- **Mods**: Copier depuis `/mods/` du serveur + +--- + +## ✅ Checklist post-installation + +- [ ] Serveur démarre sans erreur +- [ ] Monde en mode FLAT +- [ ] Mode créatif activé +- [ ] Comptes crack acceptés +- [ ] RCON configuré +- [ ] OP attribué aux admins + +--- + +## 🎮 Commandes essentielles ```bash -cd "/home/innotex/Documents/Projet/Serveur NationsGlory/server-final" -./start-docker.sh +# Démarrer +docker-compose up -d + +# Arrêter +docker-compose down + +# Redémarrer +docker-compose restart + +# Logs sans spam +docker logs -f mc-nationsglory 2>&1 | sed -u '/^>/d' + +# Donner OP (remplacer IP_SERVEUR) +docker exec mc-nationsglory rcon-cli \ + --host IP_SERVEUR \ + --port 25575 \ + --password VotreMotDePasse \ + "op NomJoueur" ``` -## Première connexion +--- -1. Lancez Minecraft 1.6.4 -2. Multijoueur → Ajouter un serveur -3. Adresse : `localhost:25565` (ou IP du serveur) -4. Le serveur accepte les **comptes crack** +## 🚨 Problèmes courants -## Devenir administrateur +| Erreur | Solution | +|--------|----------| +| "Failed to verify username" | `docker exec mc-nationsglory sed -i 's/online-mode=true/online-mode=false/' /data/server.properties && docker-compose restart` | +| Monde pas FLAT | `docker-compose down && sudo rm -rf world && docker-compose up -d` | +| RCON "authentication failed" | Vérifier mot de passe: `grep rcon.password server.properties` | -Dans la console du serveur : -``` -op -``` +--- -## Commandes essentielles - -### WorldEdit (édition terrain) -``` -//wand # Outil de sélection (hache en bois) -//set stone # Remplir de pierre -//set 0 # Supprimer (air) -//copy # Copier -//paste # Coller -//undo # Annuler -``` - -### Essentials (gestion) -``` -/gamemode 1 # Mode créatif -/gamemode 0 # Mode survie -/tp # Téléportation -/fly # Activer vol -/time set day # Jour -/weather clear # Beau temps -/give [qté] # Donner items -``` - -### Console serveur -``` -stop # Arrêter proprement -save-all # Sauvegarder -list # Liste joueurs -op # Donner OP -ban # Bannir -``` - -## Configuration actuelle - -- ✅ **Mode** : Créatif -- ✅ **Monde** : Plat (FLAT) -- ✅ **PvP** : Désactivé -- ✅ **Monstres** : Désactivés -- ✅ **Vol** : Autorisé -- ✅ **Comptes crack** : Acceptés -- ✅ **21 mods** chargés -- ✅ **Plugins** : WorldEdit, Essentials - -## Problèmes courants - -**Le serveur ne démarre pas ?** -→ Vérifier que Docker est lancé : `docker ps` - -**Permission denied ?** -→ `sudo chown -R $USER:$USER server-final/` - -**Connexion refusée ?** -→ Vérifier que le port 25565 est ouvert - -## Documentation complète - -Voir [README.md](README.md) pour la documentation complète. +**📚 Documentation complète**: [CONFIGURATION.md](CONFIGURATION.md) diff --git a/README.md b/README.md index dd2f068..4469597 100644 --- a/README.md +++ b/README.md @@ -3,23 +3,41 @@ Serveur Minecraft 1.6.4 moddé avec MCPC+ (Forge + Bukkit) déployable via Docker. **Tout inclus**: mcpc.jar, 21 mods Forge, 6 plugins Bukkit, configurations. +[![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://www.docker.com/) +[![Minecraft](https://img.shields.io/badge/Minecraft-1.6.4-green.svg)](https://minecraft.net/) +[![Forge](https://img.shields.io/badge/Forge-9.11.1.965-orange.svg)](https://files.minecraftforge.net/) + +## 📖 Documentation + +- **[⚡ Démarrage Rapide](QUICKSTART.md)** - Installation en 3 minutes +- **[🔧 Configuration Avancée](CONFIGURATION.md)** - RCON, optimisation, sauvegardes +- **[🚀 Déploiement Production](DEPLOY_README.md)** - Guide de déploiement complet + --- -## 🚀 Installation rapide (3 commandes) +## 🚀 Installation rapide (2 commandes) ```bash -# 1. Cloner le dépôt (tout est inclus: mcpc.jar, mods, plugins) -git clone nationsglory-server -cd nationsglory-server - -# 2. (Optionnel) Configurer -cp .env.example .env - -# 3. Démarrer le serveur +git clone nationsglory-server && cd nationsglory-server docker-compose up -d ``` -**C'est tout!** Le serveur est accessible sur `localhost:25565` +**Serveur prêt en 2 minutes!** 🎉 + +### ⚙️ Configuration post-installation + +```bash +# 1. Définir mot de passe RCON (remplacer VotreIP par l'IP du serveur) +sed -i 's/^rcon.password=.*/rcon.password=MotDePasseSecurise/' server.properties +docker-compose restart + +# 2. Donner droits admin (remplacer VotreIP) +docker exec mc-nationsglory rcon-cli \ + --host VotreIP \ + --port 25575 \ + --password MotDePasseSecurise \ + "op NomAdmin" +``` --- @@ -55,14 +73,43 @@ docker-compose restart ``` ### Console interactive (RCON) -```bash -# Récupérer le mot de passe RCON -docker exec mc-nationsglory cat /data/server.properties | grep rcon.password -# Ouvrir la console -docker exec -it mc-nationsglory rcon-cli --password +⚠️ **Note importante**: RCON nécessite une configuration manuelle avec `network_mode: host`. + +#### Configuration du mot de passe RCON + +Le mot de passe RCON doit être défini **avant le premier démarrage**: + +```bash +# 1. Arrêter le serveur +docker-compose down + +# 2. Modifier server.properties +sed -i 's/^rcon.password=.*/rcon.password=VotreMotDePasse/' server.properties + +# 3. Vérifier les paramètres RCON +grep -E "enable-rcon|rcon" server.properties + +# 4. Redémarrer +docker-compose up -d ``` +#### Utiliser RCON + +```bash +# Avec l'IP du serveur (network_mode: host) +docker exec mc-nationsglory rcon-cli --host 192.168.1.252 --port 25575 --password VotreMotDePasse "list" + +# Mode interactif +docker exec -it mc-nationsglory rcon-cli --host 192.168.1.252 --port 25575 --password VotreMotDePasse + +# Exemples de commandes +docker exec mc-nationsglory rcon-cli --host 192.168.1.252 --port 25575 --password VotreMotDePasse "op JoueurAdmin" +docker exec mc-nationsglory rcon-cli --host 192.168.1.252 --port 25575 --password VotreMotDePasse "save-all" +``` + +**Alternative simple (sans RCON)**: Utilisez `docker logs` pour surveiller le serveur. + --- ## 📁 Structure du projet diff --git a/docker-compose.yml b/docker-compose.yml index 6ae61d1..e5f9b22 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,5 +1,3 @@ -version: '3' - services: nationsglory-modded: image: itzg/minecraft-server:java7