## Introduction Ce guide vous accompagne dans l'installation de mods sur votre serveur Minecraft hébergé chez VeryCloud. Que vous soyez débutant ou expert, vous trouverez ici toutes les informations nécessaires pour personnaliser votre expérience de jeu. ## Prérequis et Informations Importantes ### Avant de Commencer - ✅ Votre serveur Minecraft VeryCloud doit être actif - ✅ Vous devez avoir accès au panel de contrôle VeryCloud - ✅ Une sauvegarde de votre monde est recommandée - ✅ Vérifiez la compatibilité des mods avec votre version de Minecraft ### ⚠️ **Attention** ⚠️ - **Sauvegardez toujours** votre monde avant d'installer des mods - **Vérifiez la compatibilité** entre les mods et la version du serveur - **Les mods côté serveur** nécessitent que les joueurs aient les mêmes mods installés - **Certains mods** peuvent affecter les performances du serveur ## Types de Serveurs Supportés ### Serveurs Vanilla avec Mods - **Forge** : Le plus populaire pour les gros packs de mods - **Fabric** : Plus léger et rapide, idéal pour les mods simples - **Quilt** : Alternative moderne à Fabric ### Serveurs avec Plugins - **Paper/Spigot** : Utilise des plugins (.jar) au lieu de mods - **Purpur** : Basé sur Paper avec optimisations supplémentaires ## Accès à votre Serveur VeryCloud ### Via le Panel de Contrôle 1. **Connexion au Panel** - Rendez-vous sur [panel.verycloud.fr](https://panel.verycloud.fr) - Connectez-vous avec vos identifiants VeryCloud - Sélectionnez votre serveur Minecraft 2. **Gestionnaire de Fichiers** - Cliquez sur **"Gestionnaire de Fichiers"** - Vous verrez la structure de votre serveur ### Via FTP/SFTP (Méthode Alternative) ``` Serveur : votre-serveur.verycloud.fr Port : 22 (SFTP) ou 21 (FTP) Nom d'utilisateur : fourni dans votre panel Mot de passe : fourni dans votre panel ``` **Clients FTP recommandés :** - FileZilla (Gratuit) - WinSCP (Windows) - Cyberduck (Mac/Windows) ## Installation de Forge ### Étape 1 : Arrêter le Serveur 1. Dans votre panel VeryCloud, cliquez sur **"Arrêter le Serveur"** 2. Attendez que le statut passe à "Arrêté" ### Étape 2 : Télécharger Forge 1. Visitez [files.minecraftforge.net](https://files.minecraftforge.net) 2. Sélectionnez votre version Minecraft 3. Téléchargez la version **"Installer"** (pas MDK) ### Étape 3 : Installation sur VeryCloud #### Méthode 1 : Via le Panel (Recommandée) 1. Dans le **Gestionnaire de Fichiers**, supprimez l'ancien fichier serveur (ex: `server.jar`) 2. Uploadez le fichier Forge téléchargé 3. Renommez-le en `server.jar` 4. Redémarrez le serveur #### Méthode 2 : Installation Manuelle 1. Uploadez le fichier d'installation Forge 2. Connectez-vous en SSH (si disponible) : ```bash java -jar forge-installer.jar --installServer ``` 3. Modifiez le script de démarrage pour utiliser le JAR Forge généré ### Étape 4 : Vérification 1. Démarrez votre serveur 2. Vérifiez dans les logs que Forge se charge correctement 3. Un dossier `mods` devrait apparaître automatiquement ## Installation de Fabric ### Étape 1 : Télécharger Fabric 1. Visitez [fabricmc.net](https://fabricmc.net) 2. Téléchargez l'**installateur universel** 3. Ou téléchargez directement le JAR serveur ### Étape 2 : Installation #### Méthode Directe (Recommandée pour VeryCloud) 1. Téléchargez le **server jar** depuis [fabricmc.net/use/server](https://fabricmc.net/use/server) 2. Dans votre panel VeryCloud : - Supprimez l'ancien `server.jar` - Uploadez le JAR Fabric - Renommez-le en `server.jar` ### Étape 3 : Installation de Fabric API La plupart des mods Fabric nécessitent Fabric API : 1. Téléchargez [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api) 2. Placez le fichier dans le dossier `mods` ## Installation des Mods ### Où Trouver des Mods **Sites Officiels et Sûrs :** - [CurseForge](https://www.curseforge.com/minecraft/mc-mods) - [Modrinth](https://modrinth.com) - Sites officiels des créateurs de mods ### Procédure d'Installation #### 1. Créer le Dossier Mods Si le dossier `mods` n'existe pas : 1. Dans le Gestionnaire de Fichiers VeryCloud 2. Créez un nouveau dossier nommé `mods` #### 2. Télécharger et Installer 1. **Téléchargez le mod** depuis un site officiel 2. **Vérifiez la compatibilité** : - Version de Minecraft - Loader (Forge/Fabric) - Dépendances requises 3. **Uploadez le fichier .jar** dans le dossier `mods` 4. **Redémarrez le serveur** ### Exemple d'Installation : JEI (Just Enough Items) ``` 1. Aller sur CurseForge 2. Rechercher "JEI" 3. Sélectionner la version pour Minecraft 1.19.2 + Forge 4. Télécharger le fichier .jar 5. Uploader dans /mods/ 6. Redémarrer le serveur ``` ### Structure des Fichiers ``` votre-serveur/ ├── server.jar (Forge/Fabric) ├── mods/ │ ├── jei-1.19.2-forge.jar │ ├── journeymap-server.jar │ └── waystones-forge.jar ├── config/ │ ├── jei/ │ └── waystones/ └── world/ ``` ## Configuration et Optimisation ### Fichiers de Configuration Les mods créent des fichiers de configuration dans le dossier `config/` : 1. **Accédez au dossier config** via le gestionnaire de fichiers 2. **Modifiez les fichiers** selon vos besoins 3. **Redémarrez le serveur** pour appliquer les changements ### Optimisation des Performances #### Mods d'Optimisation Recommandés **Pour Forge :** - **OptiFine** (amélioration graphique) - **AI Improvements** (IA des mobs) - **FoamFix** (optimisation mémoire) **Pour Fabric :** - **Sodium** (rendu optimisé) - **Lithium** (optimisation générale) - **Phosphor** (optimisation éclairage) #### Configuration Serveur Modifiez `server.properties` pour optimiser : ```properties # Optimisations recommandées pour serveurs VeryCloud max-tick-time=60000 spawn-protection=16 view-distance=8 simulation-distance=8 ``` ### Allocation Mémoire Selon votre plan VeryCloud : - **Plan Starter** : `-Xmx2G -Xms2G` - **Plan Gaming** : `-Xmx4G -Xms4G` - **Plan Pro** : `-Xmx8G -Xms8G` ## Dépannage ### Problèmes Courants #### Le Serveur ne Démarre Pas **Causes possibles :** - Mod incompatible avec la version Minecraft - Conflit entre mods - Manque de mémoire **Solutions :** 1. Vérifiez les logs dans le panel VeryCloud 2. Retirez le dernier mod installé 3. Vérifiez la compatibilité des versions #### Crash lors de la Connexion ``` 1. Vérifiez que les joueurs ont les mêmes mods côté client 2. Consultez les crash reports dans /crash-reports/ 3. Vérifiez les logs pour identifier le mod problématique ``` #### Performance Dégradée 1. **Réduisez le nombre de mods** actifs 2. **Installez des mods d'optimisation** 3. **Ajustez les paramètres** dans server.properties 4. **Contactez le support VeryCloud** pour upgrade ### Commandes de Debug Dans la console du serveur : ``` /forge tps # Affiche les TPS (Forge) /fabric-api # Infos Fabric API /debug start # Démarrer profiling /debug stop # Arrêter profiling ``` ### Logs Importants Fichiers à consulter en cas de problème : - `latest.log` : Log principal du serveur - `crash-reports/` : Rapports de crash - `debug/` : Informations de debug ## Mods Recommandés ### Mods Essentiels pour Serveurs #### Gestion et Administration | Mod | Description | Loader | |-----|-------------|---------| | **WorldEdit** | Édition de terrain | Forge/Fabric | | **LuckPerms** | Gestion des permissions | Plugin | | **Journeymap** | Carte du monde | Forge/Fabric | #### Gameplay et Contenu | Mod | Description | Loader | |-----|-------------|---------| | **JEI/REI** | Interface des objets | Forge/Fabric | | **Waystones** | Téléportation | Forge/Fabric | | **Iron Chests** | Coffres améliorés | Forge | | **Applied Energistics 2** | Stockage avancé | Forge | #### Optimisation | Mod | Description | Loader | |-----|-------------|---------| | **OptiFine** | Optimisation graphique | Forge | | **Sodium** | Rendu optimisé | Fabric | | **Lithium** | Optimisation serveur | Fabric | ### Packs de Mods Populaires #### Pour Débutants - **All the Mods 8** (Forge) - **Better MC** (Forge) #### Techniques - **FTB Industrial Foregoing** (Forge) - **Create Above and Beyond** (Forge) #### Aventure - **RLCraft** (Forge) - **MC Eternal** (Forge) ## Configuration Avancée ### Scripts de Démarrage Personnalisés Créez un fichier `start.sh` personnalisé : ```bash #!/bin/bash java -Xmx4G -Xms4G \ -XX:+UseG1GC \ -XX:+UnlockExperimentalVMOptions \ -XX:MaxGCPauseMillis=100 \ -XX:+DisableExplicitGC \ -XX:TargetSurvivorRatio=90 \ -XX:G1NewSizePercent=50 \ -XX:G1MaxNewSizePercent=80 \ -XX:G1MixedGCLiveThresholdPercent=35 \ -XX:+AlwaysPreTouch \ -XX:+ParallelRefProcEnabled \ -jar server.jar nogui ``` ### Automatisation avec Cron Pour les sauvegardes automatiques : ```bash # Sauvegarde quotidienne à 2h du matin 0 2 * * * /home/minecraft/backup.sh ``` ### Monitoring et Alertes Surveillez votre serveur avec des scripts : ```bash #!/bin/bash # check-server.sh if ! pgrep -f "server.jar" > /dev/null; then echo "Serveur arrêté, redémarrage..." cd /home/minecraft/ ./start.sh fi ``` ## Sécurité et Bonnes Pratiques ### Sécurisation du Serveur 1. **Utilisez une whitelist** : ``` whitelist=true ``` 2. **Configurez les permissions** avec LuckPerms 3. **Limitez les ressources** : ```properties max-players=20 spawn-protection=16 ``` ### Sauvegardes Régulières Le panel VeryCloud propose des sauvegardes automatiques : 1. **Activez les sauvegardes quotidiennes** 2. **Testez la restauration** régulièrement 3. **Gardez plusieurs points de sauvegarde** ### Mise à Jour des Mods 1. **Vérifiez les changelogs** avant mise à jour 2. **Testez sur un serveur de développement** 3. **Sauvegardez avant toute mise à jour** ## Support VeryCloud ### Ressources Disponibles - 💬 **Discord Communauté** : Rejoignez notre serveur Discord - 🎫 **Tickets Support** : Via votre espace client [manager.verycloud.fr](https://manager.verycloud.fr) ### Avant de Contacter le Support Préparez ces informations : 1. **Version de Minecraft** et du loader (Forge/Fabric) 2. **Liste des mods** installés 3. **Messages d'erreur** complets 4. **Fichiers de logs** (latest.log, crash reports) 5. **Étapes pour reproduire** le problème ### Upgrades de Serveur Si vos mods nécessitent plus de ressources : 1. **Consultez les métriques** dans votre panel 2. **Analysez l'utilisation** RAM/CPU 3. **Contactez le support** pour upgrade 4. **Choisissez le plan adapté** à vos mods ## FAQ ### Questions Fréquentes **Q: Puis-je installer des mods sur un serveur Paper/Spigot ?** R: Non, Paper/Spigot utilise des plugins. Vous devez utiliser Forge ou Fabric pour les mods. **Q: Les joueurs doivent-ils avoir les mêmes mods ?** R: Oui, pour les mods côté serveur. Les mods cosmétiques côté client sont optionnels. **Q: Combien de mods puis-je installer ?** R: Cela dépend de votre plan VeryCloud et de la complexité des mods. Commencez petit et ajoutez progressivement. **Q: Comment mettre à jour un mod ?** R: Supprimez l'ancienne version du dossier mods/ et ajoutez la nouvelle. **Q: Que faire si mon serveur crash ?** R: Consultez les crash reports et logs, retirez le dernier mod installé, et contactez le support si nécessaire. ### Glossaire - **Loader** : Forge, Fabric ou Quilt - **Client-side** : Mod installé côté joueur - **Server-side** : Mod installé côté serveur - **Core mod** : Mod modifiant le cœur de Minecraft - **Library** : Dépendance requise par d'autres mods ## Conclusion Félicitations ! Vous avez maintenant toutes les connaissances nécessaires pour installer et gérer des mods sur votre serveur Minecraft VeryCloud. ### Points Clés à Retenir ✅ **Toujours sauvegarder** avant d'installer des mods ✅ **Vérifier la compatibilité** des versions ✅ **Commencer petit** et ajouter progressivement ✅ **Surveiller les performances** du serveur ✅ **Utiliser le support VeryCloud** en cas de besoin ### Prochaines Étapes 1. **Choisissez votre loader** (Forge ou Fabric) 2. **Installez quelques mods essentiels** 3. **Testez la stabilité** de votre serveur 4. **Invitez vos amis** à rejoindre l'aventure !