VeinMiner mine un filon entier dès que tu en casses un seul bloc. Au lieu de frapper quinze fois du minerai de diamant, tu frappes une fois et les blocs connectés suivent d'eux-mêmes. Le plugin tourne entièrement sur le serveur ; les joueurs n'ont besoin ni de mod ni de réglage côté client. Les captures d'écran proviennent d'un serveur de test sous Paper 1.21.1 avec VeinMiner 2.x : un filon de diamant de quinze blocs, une pioche en diamant, un seul coup.

Prérequis

Tu installes VeinMiner dans le panel sous Plugins → Browser. La recherche Modrinth trouve deux variantes du même projet : le plugin 2.x, un 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 détecte la variante installée et l'affiche dans son en-tête. Après le redémarrage, /veinminer settings maxChain sans valeur affiche le réglage actuel, ce qui te permet de vérifier que le plugin fonctionne.

Les commandes d'administration sont à réserver à un groupe de modération. Les opérateurs ont tous les droits ; pour les autres, les nœuds 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 nœuds est expliqué dans LuckPerms : configurer les permissions.

Comment fonctionne le minage

Juste après l'installation, chaque bloc miné avec le bon outil 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 voisins du même type (searchRadius 1), bloc après bloc, jusqu'à la fin du filon ou jusqu'à ce que la limite soit atteinte.

Un filon de diamant de quinze blocs avant le minage, la pioche en diamant en main (Enlarge image)

Dans cet exemple, le filon est dégagé et forme un mur de cinq blocs de minerai de diamant sur trois. Le joueur casse un seul bloc, au centre.

Le minage d'un bloc fait se briser tout le filon en même temps, les diamants jaillissent du mur (Enlarge image)

Les quatorze autres blocs se brisent au même instant, et les diamants ainsi que les orbes d'expérience jaillissent du mur. La durabilité de la pioche baisse d'un point par bloc (durabilityDecrease true) ; un outil sur le point de casser ne survivra donc pas à un grand filon.

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

Ensuite, les diamants se trouvent devant le joueur et 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

Le panel du serveur propose pour VeinMiner 2.x un assistant avec deux préréglages, qui applique les valeurs via la console du serveur en cours d'exécution sans toucher 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 (pour beaucoup de joueurs) : 32 blocs maximum, 2 ticks de délai, 40 ticks de temps de recharge, drops regroupés.

Les deux préréglages désactivent le système de mise à jour automatique intégré à VeinMiner, car les mises à jour passent par la gestion des plugins du panel. La page Assistants de plugins dans le panel explique comment ouvrir l'assistant.

Tu peux aussi définir ces valeurs à la main, avec une barre oblique en jeu et sans 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 retravailler un mur de pierre sans en emporter la moitié, il suffit de rester debout. cooldown et delay s'expriment en ticks ; 20 ticks correspondent à 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 charge des groupes tout prêts, par exemple pour les minerais ou le bois. Voici comment créer ton propre groupe :

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

Ainsi, un filon de diamant ne se brise qu'avec une pioche en diamant. Mets les feuilles ou le bois dans un groupe associé à la hache, et évite d'ajouter la pierre, sinon des murs entiers disparaîtront quand tu creuseras des tunnels.

Erreurs courantes

  • En construisant, tu casses plus de blocs que prévu. Définis mustSneak true ou retire le bloc du groupe. Les préréglages de l'assistant exigent déjà l'accroupissement.
  • Le serveur saccade sur les grands filons. Baisse maxChain et augmente delay ; le préréglage « Performance » répartit le minage sur davantage de ticks.
  • La pioche casse d'un coup. Chaque bloc consomme de la durabilité. Préviens les joueurs ou définis durabilityDecrease false : le filon ne coûtera alors qu'un point.
  • L'assistant affiche « Datapack 1.x ». Les préréglages 2.x ne s'appliquent pas dans ce cas ; configure 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é. Les mises à jour passent par la gestion des plugins ; autoUpdate false met fin au message.
  • Tu veux désactiver VeinMiner un moment. /veinminer toggle désactive puis réactive le plugin sur tout le serveur, sans perdre les réglages.

Pour aller plus loin

Le guide Installer et gérer des plugins montre comment ajouter des plugins au panel et les mettre à jour. Pour savoir si un grand filon provoque vraiment du lag, mesure-le avec spark : analyser le lag avant de modifier les réglages.

Sources

Vidéo (0:12) : VeinMiner

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.