# 📖 Index de Documentation - Serveur NationsGlory

Bienvenue dans la documentation complète du serveur NationsGlory MCPC+ 1.6.4 !

## 🎯 Guide de navigation

### Pour commencer rapidement

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

3. **🌐 Migration vers serveur de production ?**
   - Suivez [DEPLOYMENT.md](DEPLOYMENT.md) - Déploiement sur /srv/minecraft
   - Utilisez `./migrate-to-srv.sh` pour automatiser

## 📚 Documentation par thème

### 🎮 Utilisation du serveur

| 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 |

### 🐳 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 <pseudo>` |
| **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" |

## 📊 Statistiques du projet

### Configuration serveur

- **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

### Contenu

- **Mods** : 21 actifs (Chisel, WesterosBlocks, BiblioCraft, etc.)
- **Plugins** : 2 (WorldEdit, Essentials)
- **Taille totale** : ~120 MB
- **Type de monde** : FLAT (super-plat)

### Documentation

- **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

---

**Dernière mise à jour** : 3 février 2026  
**Mainteneur** : Configuration automatique  
**Contact** : Voir documentation principale

💡 **Astuce** : Utilisez `make help` pour voir toutes les commandes disponibles !
