Installation

Ce guide couvre l'installation de zVeinMiner et les fichiers qu'il crée au premier démarrage.

PrérequisCopier le lien vers ce titre

Avant l'installation, assurez-vous que votre serveur répond à ces exigences :

zVeinMiner n'a aucune dépendance obligatoire. Chaque intégration est une dépendance optionnelle (soft dependency) : le plugin la détecte au démarrage et l'ignore simplement si elle n'est pas installée. Voir Intégrations pour le rôle de chacune.

Plateformes SupportéesCopier le lien vers ce titre

Étapes d'InstallationCopier le lien vers ce titre

1. Télécharger le PluginCopier le lien vers ce titre

Téléchargez zVeinMiner depuis l'une de ces sources :

• Modrinth
• groupez.dev

2. Installer les Dépendances OptionnellesCopier le lien vers ce titre

Installez uniquement les intégrations dont vous avez besoin :

• WorldGuard (nécessite WorldEdit) - Le minage de filons respecte les protections de régions
• GriefPrevention - Le minage de filons respecte les claims
• Vault + un plugin d'économie - Faites payer le minage de filons aux joueurs (section economy de config.yml)
• PlaceholderAPI - Les placeholders des autres plugins sont interprétés dans chaque message envoyé à un joueur
• NoCheatPlus - Les joueurs sont exemptés des vérifications de cassage de blocs pendant le minage d'un filon

3. Installer le PluginCopier le lien vers ce titre

1. Arrêtez votre serveur
2. Placez le .jar de zVeinMiner dans votre dossier plugins/
3. Démarrez votre serveur
4. Le plugin génère ses fichiers par défaut config.yml et messages.yml

4. Vérifier l'InstallationCopier le lien vers ce titre

Exécutez /zveinminer (alias : /veinminer, /zvm, nécessite zveinminer.use) en jeu ou depuis la console. Si le plugin est correctement chargé, il affiche les sous-commandes que vous avez la permission d'utiliser. Vous pouvez aussi exécuter /zveinminer list pour vérifier que les presets de config.yml ont bien été chargés.

Dans la console du serveur, recherchez des lignes comme :

[zVeinMiner] Hooked into WorldGuard
[zVeinMiner] Hooked into GriefPrevention
[zVeinMiner] Hooked into NoCheatPlus

Les lignes Hooked into ... n'apparaissent que pour les intégrations installées. Si un plugin installé ne peut pas être connecté, la console affiche à la place Failed to hook into <plugin>: ... (ou <plugin> is installed but its hook is not available pour WorldGuard et GriefPrevention). L'économie Vault est résolue la première fois qu'elle est nécessaire et affiche Hooked into Vault economy: <provider>.

Structure des FichiersCopier le lien vers ce titre

Après le premier démarrage, zVeinMiner crée la structure suivante :

plugins/zVeinMiner/
├── config.yml                # Configuration principale : options du minage de filons, mondes, drops, outils, économie, presets
├── messages.yml              # Tous les messages du plugin
└── playerdata/
    └── <uuid>.yml            # État d'activation et statistiques par joueur

Les données des joueurs sont stockées en YAML, un fichier par joueur. Un fichier est écrit lorsque le joueur quitte le serveur et lorsque le plugin est désactivé :

vein-miner-enabled: true
statistics:
  total-blocks-mined: 0
  total-veins-mined: 0

Il n'y a aucune base de données à configurer. Voir Configuration pour toutes les options de config.yml et messages.yml, et Presets & Tags pour définir quels blocs peuvent être minés en filon.

Première ConfigurationCopier le lien vers ce titre

Après l'installation, voici les premières étapes recommandées :

1. Presets - Ajustez le preset par défaut pickaxe-1 ou ajoutez les vôtres dans la section presets de config.yml
2. Limites - Définissez vein-mining.max-size-limit et vein-mining.cooldown pour votre serveur
3. Mondes - Configurez worlds.blacklist (l'End est dans la blacklist par défaut)
4. Donner des items - Utilisez /zveinminer apply <preset> sur l'item en main ou /zveinminer give <player> <preset> [material] (matériau par défaut : DIAMOND_PICKAXE) pour créer des outils de minage de filons
5. Rechargement - Appliquez vos modifications avec /zveinminer reload

Voir Commandes & Permissions pour la liste complète des commandes.

DépannageCopier le lien vers ce titre

Le plugin ne démarre pasCopier le lien vers ce titre

• Vérifiez que Java 25+ est installé : java -version
• Vérifiez que le serveur tourne sous Paper 26.3 ou plus récent (ou un fork de Paper). Spigot et Folia ne peuvent pas charger le plugin
• Vérifiez la console du serveur pour les messages d'erreur
• Assurez-vous que le fichier .jar n'est pas corrompu en le re-téléchargeant

Le minage de filons ne se déclenche pasCopier le lien vers ce titre

• L'outil en main doit avoir un preset ou des tags appliqués : vérifiez-le avec /zveinminer info
• Le joueur a besoin de la permission zveinminer.use
• Le joueur ne doit pas être en mode Aventure ou Spectateur
• Le bloc cassé doit correspondre à l'un des tags de l'outil, et l'outil doit être le bon outil pour ce bloc (par exemple une pioche pour les minerais)
• La taille de filon de l'outil (après application de vein-mining.max-size-limit) doit être supérieure à 1
• Le joueur a peut-être désactivé le minage de filons avec /zveinminer toggle
• Si vein-mining.require-sneak vaut true, le joueur doit être accroupi en cassant le bloc
• Le monde actuel est peut-être dans la blacklist (ou absent de la whitelist) de la section worlds
• Un cooldown est peut-être encore actif

Un preset est manquantCopier le lien vers ce titre

• Les presets invalides sont ignorés avec un avertissement dans la console (Preset '...' has an invalid size, has no tags list, ...)
• Un tag inconnu est ignoré avec the tag '...' is not a valid block tag or block material
• Corrigez l'entrée dans config.yml, puis exécutez /zveinminer reload

Les messages ne sont pas mis à jourCopier le lien vers ce titre

• Si messages.yml contient une erreur de syntaxe YAML, la console affiche Unable to read messages.yml, the current messages are kept et le fichier n'est pas écrasé. Corrigez la syntaxe et rechargez

L'économie ne prélève pas les joueursCopier le lien vers ce titre

• economy.enabled doit valoir true et economy.cost-per-block et/ou economy.cost-per-vein doivent être supérieurs à 0
• Si la console affiche no Vault economy provider was found: vein mining will be free, installez un plugin d'économie compatible avec Vault

Prochaines ÉtapesCopier le lien vers ce titre

• Commandes & Permissions
• Configuration
• Presets & Tags
• Intégrations