diff --git a/README.md b/README.md index f7bb517..dd2f068 100644 --- a/README.md +++ b/README.md @@ -1,314 +1,358 @@ -# 🎼 Serveur NationsGlory MCPC+ 1.6.4 +# 🎼 Serveur NationsGlory 1.6.4 - Docker -Serveur Minecraft 1.6.4 avec support mods (Forge) et plugins (Bukkit) via MCPC+. +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. -## ïżœ Navigation rapide +--- -- **🐳 [DĂ©ploiement Docker](DOCKER.md)** - Utilisation avec Docker Compose -- **🚀 [DĂ©ploiement Production](DEPLOYMENT.md)** - Migration vers /srv/minecraft -- **⚡ [DĂ©marrage rapide](QUICKSTART.md)** - Commandes essentielles -- **🔧 [Notes techniques](TECHNICAL_NOTES.md)** - Configuration dĂ©taillĂ©e -- **📩 [Installation](INSTALLATION.md)** - Guide d'installation +## 🚀 Installation rapide (3 commandes) -## 🐳 DĂ©ploiement Docker (recommandĂ©) - -### Option 1 : Migration locale vers /srv/minecraft ```bash -sudo ./migrate-to-srv.sh -cd /srv/minecraft/moddĂ© -make start +# 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 +docker-compose up -d ``` -### Option 2 : DĂ©veloppement local -```bash -cd server-final -cp ../docker-compose.yml . -cp ../.env.example .env -make start -``` +**C'est tout!** Le serveur est accessible sur `localhost:25565` -Voir [DOCKER.md](DOCKER.md) pour la documentation complĂšte Docker. +--- ## 📋 PrĂ©requis -### Sans Docker (mĂ©thode originale) -- **Port 25565** disponible -- Au moins **2 GB de RAM** libre +- **Docker** et **Docker Compose** installĂ©s +- **Port 25565** disponible +- **4 GB RAM** minimum +- **Git** pour cloner le dĂ©pĂŽt -### Avec Docker (recommandĂ©) -- **Docker** installĂ© sur votre systĂšme -- **Docker Compose** installĂ© -- Au moins **2 GB de RAM** libre +--- -## 🚀 DĂ©marrage rapide +## 🎼 Commandes de gestion -### MĂ©thode Docker (recommandĂ©e) +### DĂ©marrer ```bash -# Avec Make -make start -make logs - -# Ou avec Docker Compose docker-compose up -d -docker-compose logs -f ``` -### MĂ©thode originale (Docker manuel) +### Voir les logs (sans spam) ```bash -cd server-final -./start-docker.sh +docker logs -f mc-nationsglory 2>&1 | sed -u '/^>/d' ``` -Le serveur dĂ©marre dans un conteneur Docker avec Java 7, requis pour MCPC+ 1.6.4. +### ArrĂȘter +```bash +docker-compose down +``` -## 📁 Structure du serveur +### RedĂ©marrer +```bash +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 +``` + +--- + +## 📁 Structure du projet ``` -server-final/ -├── mcpc.jar # Serveur MCPC+ 1.6.4-R2.1-forge965-B251 -├── start-docker.sh # Script de dĂ©marrage Docker -├── server.properties # Configuration serveur -├── mods/ # Mods Forge +nationsglory-server/ +├── docker-compose.yml # Configuration Docker +├── .gitignore # Fichiers ignorĂ©s +├── .env.example # Template configuration +│ +├── mcpc.jar # Serveur MCPC+ (INCLUS - 29 MB) +│ +├── mods/ # 21 mods Forge (20 MB) +│ ├── aquatweaksng.jar │ ├── chisel-1.0.jar -│ ├── ngbibliocraft-1.5.5.jar +│ ├── customnpc-1.0.jar +│ ├── flansmods-4.1.1.jar │ ├── westerosblocksng.jar -│ └── ... (21 mods chargĂ©s) -├── plugins/ # Plugins Bukkit -│ ├── WorldEdit.jar # Édition de terrain -│ └── Essentials.jar # Commandes essentielles -├── config/ # Configurations mods -├── libraries/ # DĂ©pendances Maven -└── world/ # Monde Minecraft (FLAT) +│ └── ... (et 16 autres) +│ +├── plugins/ # 6 plugins Bukkit (3.3 MB) +│ ├── Essentials.jar # Commandes essentielles +│ ├── EssentialsChat.jar +│ ├── EssentialsSpawn.jar +│ ├── worldedit-5.6.jar # Édition terrain +│ └── ... +│ +├── config/ # Configurations (488 KB) +│ ├── forge.cfg +│ ├── worldedit/ +│ └── ... (40+ fichiers) +│ +├── world/ # Monde Minecraft (NON versionnĂ©) +└── logs/ # Logs serveur (NON versionnĂ©) ``` +**Taille totale du dĂ©pĂŽt Git: ~53 MB** + +--- + ## ⚙ Configuration -### Serveur (server.properties) +### ParamĂštres serveur (automatiques) -- **Port** : `25565` -- **Mode** : CrĂ©atif (`gamemode=1`) -- **Type de monde** : FLAT (`level-type=FLAT`) -- **Authentification** : DĂ©sactivĂ©e (`online-mode=false`) - comptes crack acceptĂ©s -- **PvP** : DĂ©sactivĂ© (`pvp=false`) -- **Monstres** : DĂ©sactivĂ©s (`spawn-monsters=false`) -- **Vol** : AutorisĂ© (`allow-flight=true`) +- **Version**: Minecraft 1.6.4 +- **Port**: 25565 +- **Mode**: CrĂ©atif (gamemode=1) +- **Type monde**: FLAT +- **RAM**: 2 GB (configurable) +- **Authentification**: DĂ©sactivĂ©e (comptes crack acceptĂ©s) +- **PvP**: DĂ©sactivĂ© +- **Vol**: AutorisĂ© -### Ressources Docker +### Modifier la mĂ©moire -- **RAM Max** : 2 GB (`-Xmx2G`) -- **RAM Init** : 1 GB (`-Xms1G`) -- **GC** : G1GC (optimisĂ©) -- **File descriptors** : 65535 (ulimit configurĂ©) +Éditer `docker-compose.yml`: +```yaml +environment: + MEMORY: "3G" # RAM max + INIT_MEMORY: "1500M" # RAM initiale +``` + +### Changer le port + +Éditer `docker-compose.yml`: +```yaml +ports: + - "25566:25565" # Utilise le port 25566 +``` + +--- ## 🎯 Plugins installĂ©s -### WorldEdit -Édition de terrain avancĂ©e pour constructions massives. - -**Commandes principales** : -- `//wand` - Obtenir l'outil de sĂ©lection -- `//set ` - Remplir la sĂ©lection -- `//replace ` - Remplacer des blocs -- `//copy` - Copier la sĂ©lection -- `//paste` - Coller -- `//undo` - Annuler -- `//redo` - Refaire - -### Essentials -Commandes de gestion serveur essentielles. - -**Commandes principales** : -- `/tp ` - TĂ©lĂ©portation -- `/give [qtĂ©]` - Donner items -- `/gamemode ` - Changer mode de jeu -- `/fly` - Activer/dĂ©sactiver vol -- `/heal` - Soigner -- `/feed` - Nourrir -- `/time ` - ContrĂŽle du temps -- `/weather ` - MĂ©tĂ©o - -## 🔐 Gestion des permissions - -### OpĂ©rateurs (OP) - -Donner tous les droits Ă  un joueur : +### WorldEdit 5.6 (Édition terrain) ``` -op +//wand # Outil de sĂ©lection +//set # Remplir +//replace # Remplacer +//copy # Copier +//paste # Coller +//undo # Annuler ``` -Retirer les droits : +### Essentials 2.13.1 (Gestion serveur) ``` -deop +/tp # TĂ©lĂ©porter +/give [qtĂ©] # Donner items +/gamemode # Changer mode +/fly # Vol +/heal # Soigner +/time set # Temps +/weather # MĂ©tĂ©o ``` -### Fichiers de permissions +--- -- `ops.txt` - Liste des opĂ©rateurs -- `white-list.txt` - Liste blanche (si activĂ©e) -- `banned-players.txt` - Joueurs bannis -- `banned-ips.txt` - IPs bannies +## 🔐 Gestion des joueurs -## đŸ› ïž Commandes serveur - -### Console serveur - -Une fois dĂ©marrĂ©, vous pouvez taper des commandes : - -``` -help # Liste des commandes -op # Donner OP -stop # ArrĂȘter le serveur -save-all # Sauvegarder le monde -list # Liste des joueurs -ban # Bannir un joueur -pardon # DĂ©bannir -``` - -### RedĂ©marrage - -1. Dans la console : `stop` -2. Attendre l'arrĂȘt complet -3. Relancer : `./start-docker.sh` - -## 🔧 Maintenance - -### Sauvegardes - -**Sauvegarder le monde** : +### Donner les droits admin (OP) ```bash -cd server-final -tar -czf backup-$(date +%Y%m%d-%H%M).tar.gz world/ DIM1/ DIM-1/ +# Via RCON +docker exec mc-nationsglory rcon-cli --password "op " + +# Ou via console interactive +docker exec -it mc-nationsglory rcon-cli --password +> op ``` -**Restaurer** : +### Retirer les droits ```bash -rm -rf world/ DIM1/ DIM-1/ -tar -xzf backup-YYYYMMDD-HHMM.tar.gz +docker exec mc-nationsglory rcon-cli --password "deop " +``` + +### Bannir/dĂ©bannir +```bash +# Bannir +docker exec mc-nationsglory rcon-cli --password "ban " + +# DĂ©bannir +docker exec mc-nationsglory rcon-cli --password "pardon " +``` + +--- + +## đŸ› ïž Maintenance + +### Sauvegarder le monde +```bash +docker exec mc-nationsglory rcon-cli --password "save-all" +tar -czf backup-$(date +%Y%m%d).tar.gz world/ +``` + +### Restaurer une sauvegarde +```bash +docker-compose down +rm -rf world/ +tar -xzf backup-YYYYMMDD.tar.gz +docker-compose up -d ``` ### RĂ©initialiser le monde - -⚠ **Attention** : Supprime toutes les constructions ! - ```bash -cd server-final -rm -rf world/ DIM1/ DIM-1/ -# Au prochain dĂ©marrage, un nouveau monde FLAT sera gĂ©nĂ©rĂ© +docker-compose down +rm -rf world/ +docker-compose up -d # Un nouveau monde FLAT sera créé ``` ### Nettoyer les logs - ```bash -cd server-final -rm -f *.log *.log.* *.lck -rm -rf crash-reports/* +docker exec mc-nationsglory sh -c "rm -f /data/*.log /data/*.lck" +docker-compose restart ``` -## 📩 Mods installĂ©s +--- -**21 mods actifs** : -- Chisel - Blocs dĂ©coratifs -- WesterosBlocks - Blocs Game of Thrones -- BiblioCraft - Meubles et dĂ©corations -- Autoutils - Outils automatiques -- CustomNPCs - PNJs personnalisĂ©s -- Flan's Mod - VĂ©hicules et armes -- Netherrocks - Minerais du Nether -- TLSpecialArmor - Armures spĂ©ciales -- UniversalElectricity - ÉlectricitĂ© -- WeaponMod - Armes -- AquaTweaks - Modifications aquatiques -- Et plus... +## 📩 Mods inclus (21 mods) + +- **Chisel** - Blocs dĂ©coratifs variĂ©s +- **WesterosBlocks** - Blocs Game of Thrones +- **BiblioCraft** - Meubles et dĂ©corations +- **CustomNPCs** - PNJs personnalisables +- **Flan's Mod** - VĂ©hicules et armes +- **UniversalElectricity** - SystĂšme Ă©lectrique +- **Netherrocks** - Nouveaux minerais +- **WeaponMod** - Armes modernes +- **TLSpecialArmor** - Armures spĂ©ciales +- **AquaTweaks** - Modifications aquatiques +- **Chisel** - Blocs architecturaux +- **Parachute Mod** - Parachutes +- **Dragons Radio Mod** - Radio +- **Get All The Seeds** - Graines +- **MapWriter** - Minimap +- **Melons Spawn** - PastĂšques +- **NationsGUI** - Interface NationsGlory +- **NGContent** - Contenu NationsGlory +- **NGElectricity** - ÉlectricitĂ© NationsGlory +- **Pam's Harvestcraft** - Agriculture +- **Et plus...** + +--- + +## 🔄 Mise Ă  jour et dĂ©ploiement + +### Sur un nouveau serveur +```bash +git clone +cd nationsglory-server +docker-compose up -d +``` + +### Mettre Ă  jour le serveur +```bash +git pull +docker-compose restart +``` + +### Ajouter un mod +```bash +# 1. Copier le mod +cp nouveau-mod.jar mods/ + +# 2. Commiter +git add mods/nouveau-mod.jar +git commit -m "Add: nouveau-mod" +git push + +# 3. Sur le serveur +git pull +docker-compose restart +``` + +--- ## 🐛 DĂ©pannage ### Le serveur ne dĂ©marre pas - -1. VĂ©rifier que Docker est lancĂ© : `docker ps` -2. VĂ©rifier le port 25565 : `netstat -tuln | grep 25565` -3. VĂ©rifier les logs : `cat server-final/server.log` - -### Erreur "Permission denied" - -Corriger les permissions : ```bash -sudo chown -R $USER:$USER server-final/ +# VĂ©rifier les logs +docker logs mc-nationsglory + +# VĂ©rifier le conteneur +docker ps -a + +# RecrĂ©er le conteneur +docker-compose down +docker-compose up -d ``` -### Connexion refusĂ©e +### Impossible de se connecter +```bash +# VĂ©rifier le port +docker ps | grep 25565 -1. VĂ©rifier que `online-mode=false` dans `server.properties` -2. Le serveur accepte les comptes crack +# VĂ©rifier que le serveur Ă©coute +nc -zv localhost 25565 +``` ### Lag/performances +```bash +# Augmenter la RAM dans docker-compose.yml +MEMORY: "4G" +INIT_MEMORY: "2G" -1. Augmenter la RAM dans `start-docker.sh` (changer `-Xmx2G` en `-Xmx4G`) -2. RĂ©duire `view-distance` dans `server.properties` -3. Limiter les entitĂ©s : `/killall [type]` - -## 🌍 Type de monde - -Le serveur gĂ©nĂšre un **monde plat** (`level-type=FLAT`) idĂ©al pour : -- Constructions massives -- Villes et nations -- PvP arĂšnes -- Projets crĂ©atifs - -Pour changer le type de monde : -1. `stop` dans la console -2. Modifier `level-type` dans `server.properties` (`DEFAULT`, `FLAT`, `LARGEBIOMES`) -3. Supprimer `world/` pour rĂ©gĂ©nĂ©rer -4. RedĂ©marrer - -## 📞 Support - -### Logs importants - -- `server.log` - Log principal -- `ForgeModLoader-server-0.log` - Logs Forge/mods -- `crash-reports/` - Rapports de crash - -### VĂ©rifier les mods chargĂ©s - -Au dĂ©marrage, chercher dans les logs : -``` -[INFO] Forge Mod Loader has successfully loaded 21 mods +# RedĂ©marrer +docker-compose down +docker-compose up -d ``` -### Commandes de debug +### RCON ne fonctionne pas +```bash +# RĂ©cupĂ©rer le bon mot de passe +docker exec mc-nationsglory cat /data/server.properties | grep rcon.password +# Tester +docker exec mc-nationsglory rcon-cli --password "list" ``` -/forge tps # Performance serveur -/gc # Garbage collector -/mem # Utilisation mĂ©moire -``` - -## 📝 Notes importantes - -- ✅ Le serveur fonctionne avec **Java 7** via Docker -- ✅ Compatible avec les **comptes crack** (online-mode=false) -- ✅ **21 mods** chargĂ©s automatiquement -- ✅ **Plugins Bukkit** compatibles 1.6.4 -- ⚠ Les warnings "anonymous item" sont normaux (compatibilitĂ© 1.7) -- ⚠ Certains items peuvent manquer si le monde a Ă©tĂ© gĂ©nĂ©rĂ© avec d'autres mods - -## 🔄 Mises Ă  jour - -### Ajouter un mod - -1. Placer le `.jar` dans `server-final/mods/` -2. RedĂ©marrer le serveur -3. VĂ©rifier les logs pour les erreurs - -### Ajouter un plugin - -1. Placer le `.jar` dans `server-final/plugins/` -2. RedĂ©marrer le serveur -3. Le plugin se charge automatiquement --- -**Version** : MCPC+ 1.6.4-R2.1-forge965-B251 -**Forge** : 9.11.1.965 -**Minecraft** : 1.6.4 -**Java** : 7 (via Docker) +## 📊 Informations techniques + +- **Version Minecraft**: 1.6.4 +- **Serveur**: MCPC+ 1.6.4-R2.1-forge965-B251 +- **Forge**: 9.11.1.965 +- **Java**: 7 (via conteneur Docker) +- **Image Docker**: itzg/minecraft-server:java7 +- **Mods**: 21 (Forge) +- **Plugins**: 6 (Bukkit) +- **Taille dĂ©pĂŽt**: ~53 MB + +--- + +## 📖 Documentation complĂ©mentaire + +- [DEPLOY_README.md](DEPLOY_README.md) - Guide de dĂ©ploiement dĂ©taillĂ© +- [DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md) - Checklist de dĂ©ploiement +- `.env.example` - Variables d'environnement disponibles + +--- + +## ⚠ Notes importantes + +- ✅ **Comptes crack acceptĂ©s** (online-mode=false) +- ✅ **Docker obligatoire** (Java 7 requis) +- ✅ **Tout inclus** (mcpc.jar, mods, plugins) +- ⚠ Les warnings "anonymous item" sont normaux (compatibilitĂ© 1.7) +- ⚠ Le monde est en **FLAT** par dĂ©faut (idĂ©al pour constructions) +- ⚠ `world/` n'est PAS versionnĂ© (donnĂ©es spĂ©cifiques au serveur) + +--- + +**Serveur prĂȘt Ă  dĂ©ployer en 3 commandes** 🚀