VeinMiner peut miner côté serveur, en une seule fois, les blocs connectés d'un filon. Vérifie d'abord la variante installée (plugin ou datapack) ainsi que ses règles de blocs et d'outils. Sur un serveur public, limite la longueur de la chaîne et le déclenchement, afin que les travaux de construction et les grands filons restent maîtrisables. Les captures d'écran proviennent d'un serveur de test avec Paper 1.21.1 et VeinMiner 2.x : un filon de diamant de quinze blocs, une pioche en diamant, un seul minage.

Prérequis

Tu installes VeinMiner dans le panel sous Plugins → Navigateur. La recherche Modrinth trouve deux variantes du même projet : le plugin 2.x sous forme de fichier JAR pour Paper, Purpur et Folia, et l'ancien datapack 1.x. Ce guide décrit le plugin 2.x ; l'assistant du panel reconnaît la variante installée et l'affiche en haut dans l'en-tête. Après le redémarrage, /veinminer settings maxChain sans valeur affiche le réglage actuel ; tu vérifies ainsi que le plugin fonctionne.

Les commandes d'administration appartiennent à un groupe de modération. Les opérateurs peuvent tout faire ; pour tous les autres, les permissions veinminer.settings, veinminer.blocks, veinminer.groups et veinminer.toggle déterminent qui peut modifier les réglages, les listes de blocs, les groupes et l'interrupteur global du serveur. Les joueurs normaux n'ont besoin que de veinminer.use, et seulement si tu actives permissionRestricted. Le fonctionnement des groupes et des permissions est expliqué dans LuckPerms : configurer les permissions.

Fonctionnement du minage

Directement après l'installation, la règle est la suivante : chaque minage avec l'outil adapté déclenche le filon. needCorrectTool est sur true, mustSneak sur false, et maxChain autorise jusqu'à 100 blocs par déclenchement. La recherche parcourt tous les blocs directement adjacents du même type (searchRadius 1), bloc par bloc, jusqu'à ce que le filon se termine ou que la limite soit atteinte.

Un filon de diamant de quinze blocs avant le minage, la pioche en diamant en main
Un filon de diamant de quinze blocs avant le minage, la pioche en diamant en main

Dans l'exemple, le filon est exposé comme un mur de cinq par trois blocs de minerai de diamant. Le joueur casse exactement un bloc au milieu.

Le minage d'un seul bloc fait éclater tout le filon en même temps, les diamants jaillissent du mur
Le minage d'un seul bloc fait éclater tout le filon en même temps, les diamants jaillissent du mur

Les quatorze autres blocs se brisent au même instant, les diamants et les orbes d'expérience jaillissent du mur. Si l'usure des outils est activée, une pioche presque usée peut se casser à cette occasion. Les versions de plugin vérifiées 2.9.0 et 2.12.0 enregistrent l'option sous le nom decreaseDurability ; certaines anciennes documentations parlent de durabilityDecrease. Utilise le nom proposé par l'autocomplétion des commandes de ta version installée. Les enchantements et les overrides de groupe ou de client modifient l'usure réelle ; teste donc d'abord un petit filon avec un outil dont tu connais l'état.

Les diamants sont rassemblés devant le joueur, le mur derrière eux est vide
Les diamants sont rassemblés devant le joueur, le mur derrière eux est vide

Ensuite, les diamants se trouvent devant le joueur, le mur est vide. Avec mergeItemDrops true, les objets tombent en une seule pile à l'emplacement du premier bloc, ce qui économise des entités quand il y a beaucoup de joueurs.

Réglages : assistant ou console

Pour VeinMiner 2.x, le panel du serveur propose un assistant avec deux presets, qui applique les valeurs via la console du serveur en cours d'exécution et ne touche pas aux groupes de blocs et d'outils :

  • Équilibré (recommandé) : 64 blocs maximum par déclenchement, 1 tick de délai entre les blocs, 20 ticks de temps de recharge, accroupissement requis, bon outil requis, drops individuels.
  • Performance (avec beaucoup de joueurs) : 32 blocs maximum, 2 ticks de délai, 40 ticks de temps de recharge, drops regroupés.

Planifie les mises à jour du plugin de façon réfléchie via la gestion des plugins, et sauvegarde auparavant le monde et la configuration. Après un preset, vérifie les réponses de la console : une commande envoyée ne prouve pas qu'un réglage a été pris en compte. Une commande settings autoUpdate d'effet général n'est pas enregistrée dans les versions vérifiées. Ils définissent en outre permissionRestricted false. Si l'utilisation doit rester limitée aux joueurs autorisés, remets l'option sur true après le preset et vérifie avec deux comptes normaux, l'un avec et l'autre sans veinminer.use. Les droits d'opérateur faussent ce test. Dans les sorties vérifiées, les valeurs globales sont des valeurs par défaut : un override client peut les modifier pour les joueurs ayant l'addon client ; un override du groupe de blocs est prioritaire sur celui-ci. Pour le groupe testé, vérifie en particulier mustSneak, maxChain, permissionRestricted et decreaseDurability avant d'évaluer les tests d'accès ou de minage. La façon d'ouvrir l'assistant est décrite dans Assistants de plugins dans le panel.

Tu peux aussi définir ces mêmes valeurs à la main, avec une barre oblique dans le jeu, sans elle dans la console du panel :

/veinminer settings mustSneak true
/veinminer settings maxChain 64
/veinminer settings cooldown 20
/veinminer settings delay 1

mustSneak est le réglage le plus important sur un serveur de construction : s'il est sur true, le filon ne se brise que si le joueur est accroupi pendant le minage. Pour travailler sur un mur de pierre sans que la moitié du mur parte avec, il suffit de rester debout. cooldown et delay sont indiqués en ticks, 20 ticks font une seconde.

Blocs et groupes

Les blocs que VeinMiner traite comme un filon sont définis dans des groupes. Chaque groupe associe une liste de blocs aux outils autorisés à les déclencher. /veinminer blocks affiche les blocs valables pour tous les outils ; /veinminer presets propose des groupes prêts à l'emploi, par exemple Logs pour le bois. Utilise la sélection de ta version installée ; tu peux explicitement définir toi-même un groupe de minerais. Tu crées un groupe personnalisé ainsi :

/veinminer groups create erze diamond_ore
/veinminer groups edit erze add-block deepslate_diamond_ore
/veinminer groups edit erze add-tool diamond_pickaxe

Pour ce groupe, une pioche en diamant est autorisée. Vérifie les listes de blocs existantes et les autres groupes : si le minerai de diamant y est également autorisé, des outils supplémentaires peuvent rester valides. Teste, sans être OP, les outils souhaités et des outils volontairement incorrects. Range les feuilles ou le bois dans un groupe avec la hache, et mieux vaut ne jamais y mettre la pierre, sinon des murs entiers disparaissent lors du creusement de tunnels.

Erreurs courantes

  • En construisant, plus de blocs que prévu disparaissent. Définis mustSneak true ou retire le bloc du groupe. Les presets de l'assistant exigent déjà l'accroupissement.
  • Le serveur saccade avec de grands filons. Réduis maxChain et augmente delay ; le preset « Performance » répartit le minage sur davantage de ticks.
  • La pioche est soudainement cassée. Vérifie le réglage effectif decreaseDurability ainsi que les enchantements et les overrides de groupe/client. Contrôle l'état de l'outil avant un petit test ; une usure fixe par bloc ne vaut pas pour toutes les configurations.
  • L'assistant affiche « Datapack 1.x ». Les presets 2.x ne s'appliquent alors pas ; tu configures le datapack en jeu en tant qu'opérateur avec /function veinminer:_config.
  • VeinMiner signale une mise à jour dans la console. C'est le système de mise à jour intégré. Vérifie la version exacte du plugin et la méthode de mise à jour proposée. Planifie les mises à jour avec une sauvegarde ; une commande de console générale autoUpdate false n'est pas enregistrée dans les versions vérifiées.
  • VeinMiner doit être désactivé brièvement. /veinminer toggle désactive puis réactive le plugin sur tout le serveur, sans perdre les réglages.

FAQ

Mes joueurs ont-ils besoin d'un mod ou d'un réglage côté client ?

Non. VeinMiner fonctionne entièrement sur le serveur. Quiconque peut se connecter normalement l'utilise immédiatement — y compris les joueurs via Geyser avec un client Bedrock, car seul le minage est évalué côté serveur.

En construisant, plus de blocs que voulu disparaissent — que faire ?

/veinminer settings mustSneak true. Ensuite, le filon ne se déclenche que si le joueur est accroupi pendant le minage ; debout, tu travailles bloc par bloc comme d'habitude. Sur les serveurs de construction, c'est le réglage le plus important, et les presets de l'assistant l'exigent déjà.

Ai-je le plugin 2.x ou le datapack 1.x ?

L'assistant du panel affiche la variante détectée en haut dans l'en-tête. Sans panel, /veinminer settings maxChain te renseigne : si la commande répond avec une valeur, le plugin 2.x est actif. Le datapack 1.x, lui, se configure en tant qu'opérateur avec /function veinminer:_config.

L'outil s'use-t-il plus vite ?

Si l'usure des outils est activée, un grand filon peut détruire un outil presque usé. L'option vérifiée actuelle s'appelle decreaseDurability ; vérifie le nom et la valeur dans ta version installée. Les enchantements et les overrides de groupe ou de client peuvent modifier l'usure. Teste un petit filon au lieu de t'attendre à un nombre de points fixe par bloc ou par déclenchement.

Comment désactiver VeinMiner temporairement ?

/veinminer toggle le désactive puis le réactive sur tout le serveur, sans perdre les réglages, les listes de blocs ou les groupes. C'est le moyen le plus rapide si tu veux travailler sans être dérangé pendant un projet de construction ou un événement.

Guides complémentaires

La façon dont les plugins arrivent dans le panel et sont mis à jour est expliquée dans Installer et gérer les plugins. Pour savoir si un grand filon provoque vraiment du lag, mesure-le avec spark : analyser le lag avant de modifier les réglages.

Sources

Tester un groupe de blocs sur un filon de test sans risque

Dans une zone de test séparée, place un petit filon de minerai autorisé à côté d'un bloc non autorisé. Vérifie d'abord l'outil prévu, puis un outil volontairement incorrect. Teste l'accroupissement, le temps de recharge, la durabilité et la longueur maximale de la chaîne avec un rôle de joueur normal. Un test en OP ne confirme pas la permission par défaut. Si un mur est miné en même temps lors de la construction, contrôle les groupes et la condition de déclenchement avant de modifier globalement les performances. Note l'ancien réglage et ne reviens en arrière que pour ce groupe. Le plugin 2.x et le datapack 1.x restent des voies de configuration distinctes.

VeinMiner: Voir l'exemple

Captures réalisées dans un environnement de démonstration. La version et la configuration présentées peuvent différer de celles de ton serveur.

  1. Un filon de diamants, une pioche.
  2. Un bloc est extrait. Tout le filon suit.
  3. Les drops sont regroupés devant toi.
Un filon de diamants dégagé avant l'extraction. La pioche est prête.
Un filon de diamants dégagé avant l'extraction. La pioche est prête.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14

Une seule extraction déclenche tout le filon : les blocs voisins sont retirés avec lui.
Une seule extraction déclenche tout le filon : les blocs voisins sont retirés avec lui.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14

Les diamants sont regroupés devant le joueur, le filon a disparu.
Les diamants sont regroupés devant le joueur, le filon a disparu.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14