GroupeZ Docs

Introduction

Introduction à zVeinMiner - Un plugin de minage de filons configurable pour les serveurs Paper, basé sur des presets stockés sur les items

Bienvenue dans la documentation officielle de zVeinMiner !

zVeinMiner est un plugin de minage de filons (vein mining) pour les serveurs Paper. Lorsqu'un joueur casse un bloc avec un item de minage de filons, tous les blocs connectés du même type sont également cassés, jusqu'à une taille configurable. Ce qu'un item peut miner n'est pas global : chaque item possède son propre preset, sa propre taille de filon et ses propres tags, ce qui vous permet de distribuer une petite pioche à charbon, une grande pioche à minerais ou une hache de bûcheron avec le même plugin.

Plugin Paper

zVeinMiner est un plugin Paper (paper-plugin.yml). Il nécessite Paper 26.3 ou supérieur (ou un fork comme Purpur) et Java 25. Spigot et Folia ne sont pas supportés. Consultez le Guide d'Installation.

Fonctionnalités Clés

Minage de Filons par Preset

  • Presets - Définissez autant de presets que vous le souhaitez dans config.yml, chacun avec un nom, une taille de filon et une liste de tags
  • Données stockées sur l'item - Le nom du preset, la taille du filon et les tags sont écrits dans le PersistentDataContainer de l'item, chaque item conserve donc ses propres paramètres
  • Tags - Un tag est soit un matériau de bloc unique (DIAMOND_ORE), soit le nom d'un tag de matériaux Bukkit (COAL_ORES, LOGS...)
  • Correspondance par tag - Avec match-by-tag, les variantes en pierre et en deepslate d'un minerai sont minées ensemble
  • Commandes d'item - Appliquez, définissez, redimensionnez, ajoutez ou retirez des tags sur l'item tenu en main, ou donnez un item avec un preset

Consultez Presets & Tags pour plus de détails.

Aperçu en Sneak

En étant accroupi avec un item de minage de filons et en regardant un bloc correspondant, le joueur voit un contour lumineux des blocs qui seront minés. L'aperçu n'est visible que par son propriétaire, utilise des entités non persistantes et peut être désactivé avec l'option preview.

Gestion des Outils

  • Vérification de la durabilité - Avec check-durability (activé par défaut), la durabilité de l'outil est vérifiée bloc par bloc et le minage de filons s'arrête avant que l'outil ne se casse
  • Dégâts de l'outil - apply-damage peut être désactivé pour que les blocs supplémentaires n'endommagent pas l'outil
  • Solidité - L'enchantement Solidité (Unbreaking) est appliqué comme lors du minage vanilla
  • Bon outil uniquement - Le minage de filons ne se déclenche que si l'item tenu est le bon outil pour le bloc cassé, et les blocs qui nécessitent un autre outil ne font pas partie du filon
  • Enchantements - Les blocs sont cassés comme lors d'un cassage normal par un joueur, Toucher de soie (Silk Touch) et Fortune s'appliquent donc à chaque bloc
  • Mode créatif - Aucun dégât de durabilité en mode créatif

Compatibilité avec les Plugins

Chaque bloc supplémentaire est cassé via un véritable cassage par le joueur, ce qui déclenche un BlockBreakEvent pour chaque bloc. Les plugins de protection (Towny, Lands, WorldGuard...), de journalisation (CoreProtect) et de récompenses (Jobs, mcMMO) voient chaque bloc miné, et pas seulement le premier.

Fonctionnalités Joueur

  • Activation - Les joueurs peuvent activer ou désactiver le minage de filons pour eux-mêmes avec /zveinminer toggle
  • Statistiques - Le nombre total de blocs et de filons minés est suivi par joueur et affiché avec /zveinminer stats
  • Données persistantes - Les préférences et les statistiques sont sauvegardées dans plugins/zVeinMiner/playerdata/<uuid>.yml

Contrôle du Serveur

  • Cooldown - Cooldown optionnel en ticks entre deux minages de filons (contournable avec une permission)
  • Sneak obligatoire - Exigez optionnellement d'être accroupi pour déclencher le minage de filons
  • Limite de taille globale - max-size-limit plafonne la taille de filon de tous les items
  • Contrôle par monde - Liste noire ou liste blanche de mondes
  • Drops - Téléportez optionnellement les drops vers le joueur ou ramassez-les automatiquement
  • Économie - Facturez optionnellement un coût par bloc et/ou par filon (nécessite Vault)
  • Messages configurables - Chaque message peut être modifié dans messages.yml, les messages manquants sont ajoutés automatiquement lors des mises à jour

Protections & Intégrations

Toutes les intégrations sont des dépendances optionnelles (soft dependencies) :

  • WorldGuard - Seuls les blocs que le joueur a le droit de casser sont minés
  • GriefPrevention - Les claims sont respectés
  • NoCheatPlus - Les joueurs sont exemptés des vérifications de cassage de blocs pendant le minage d'un filon
  • Vault - Coûts économiques
  • PlaceholderAPI - Les placeholders sont remplacés dans chaque message envoyé à un joueur (zVeinMiner n'enregistre pas de placeholders propres)

Consultez Intégrations.

API Développeur

zVeinMiner expose un VeinManager et un PlayerManager via le ServicesManager de Bukkit, des événements personnalisés (VeinMineStartEvent, VeinMineBlockEvent, VeinMineCompleteEvent) et des méthodes pour appliquer des presets et des tags aux items. Consultez API.

Fonctionnement

  1. Un joueur casse un bloc avec un item qui possède des données de minage de filons.
  2. zVeinMiner vérifie le mode de jeu (ni aventure ni spectateur), la permission zveinminer.use, l'activation, le monde, l'exigence de sneak, que la taille du filon est supérieure à 1, que le bloc correspond à l'un des tags de l'item et que l'item est le bon outil pour ce bloc, puis le cooldown.
  3. Les blocs connectés correspondants sont trouvés avec un parcours en largeur (BFS), limité par la taille de filon de l'item et par max-size-limit.
  4. Les blocs que le joueur ne peut pas casser (protections, protection du spawn) sont retirés, le coût économique est vérifié et VeinMineStartEvent est déclenché.
  5. Chaque bloc restant est cassé un par un, avec son propre BlockBreakEvent, ses dégâts d'outil et ses drops, jusqu'à ce que le filon soit terminé ou que l'outil soit sur le point de se casser.
  6. Le coût économique est facturé pour les blocs réellement cassés, les statistiques du joueur sont mises à jour et VeinMineCompleteEvent est déclenché.

Prérequis

PrérequisVersion
Java25 ou supérieur
ServeurPaper 26.3 ou supérieur

Plateformes Supportées

PlateformeSupport
PaperRecommandé
Purpur et autres forks de PaperSupporté
SpigotNon supporté
FoliaNon supporté

Liens Rapides

Support

Téléchargement

Installation

Comment installer zVeinMiner sur votre serveur Paper

Sur cette page

Fonctionnalités ClésMinage de Filons par PresetAperçu en SneakGestion des OutilsCompatibilité avec les PluginsFonctionnalités JoueurContrôle du ServeurProtections & IntégrationsAPI DéveloppeurFonctionnementPrérequisPlateformes SupportéesLiens RapidesSupportTéléchargement
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.