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