Intégrations

zVeinMiner fonctionne seul. Chaque intégration est une dépendance optionnelle (soft dependency) : si l'autre plugin est absent, zVeinMiner démarre quand même et la fonctionnalité qui l'utilise est simplement ignorée.

Lorsqu'un hook se connecte, la console affiche une ligne comme Hooked into WorldGuard, Hooked into Vault economy: <name> ou Hooked into NoCheatPlus.

Plugins de protectionCopier le lien vers ce titre

Fonctionnement de la protectionCopier le lien vers ce titre

Chaque bloc supplémentaire d'un filon est cassé avec Player#breakBlock de Paper. Cela déclenche un BlockBreakEvent normal pour chaque bloc, donc n'importe quel plugin de protection, de logs ou de récompenses voit chaque bloc comme si le joueur l'avait cassé à la main. Cela inclut les plugins pour lesquels zVeinMiner n'a pas de hook.

Les hooks WorldGuard et GriefPrevention ajoutent une vérification avant le début du minage :

1. zVeinMiner détecte le filon.
2. Il retire tous les blocs que le joueur n'a pas le droit de casser, selon les hooks de protection et la protection du spawn vanilla.
3. Seuls les blocs restants sont minés. Ce sont aussi les seuls qui comptent dans le coût économique.

Le même filtre est utilisé pour la prévisualisation du filon, le contour affiché lorsque le joueur est accroupi (quand vein-mining.preview vaut true). La prévisualisation n'affiche que les blocs que le joueur peut réellement casser.

La protection du spawn est toujours vérifiée, même sans aucun plugin de protection. Elle suit la règle vanilla : elle s'applique uniquement dans le monde principal, uniquement lorsque spawn-protection est supérieur à 0, uniquement lorsqu'au moins un opérateur existe, et jamais aux opérateurs.

WorldGuardCopier le lien vers ce titre

Nécessite WorldGuard et WorldEdit, dont WorldGuard dépend.

Pour chaque bloc, zVeinMiner exécute le test de construction de WorldGuard avec le flag block-break. C'est le même test que WorldGuard utilise lorsqu'un joueur casse un bloc :

• les membres et propriétaires de la région peuvent miner, et les valeurs par défaut de la région s'appliquent ;
• un flag block-break défini sur allow ou deny remplace la valeur par défaut ;
• une région sans flag block-break suit les règles de construction normales. Elle n'est pas refusée automatiquement ;
• les joueurs disposant du bypass WorldGuard dans ce monde (par exemple worldguard.region.bypass.<world>) ne sont pas soumis à la vérification.

Aucun flag ni aucune option n'a besoin d'être configuré dans zVeinMiner.

GriefPreventionCopier le lien vers ce titre

Pour chaque bloc, zVeinMiner cherche le claim GriefPrevention à cet emplacement :

• aucun claim : le bloc peut être miné ;
• un claim : le bloc ne peut être miné que si GriefPrevention autorise ce joueur à casser ce type de bloc à cet endroit, la même vérification que pour un cassage normal.

Détection et rechargementCopier le lien vers ce titre

zVeinMiner recherche les hooks de protection au démarrage, puis à chaque /zveinminer reload. Un hook n'est utilisé que si son plugin est activé.

Même lorsqu'un hook est ignoré, le BlockBreakEvent déclenché pour chaque bloc permet toujours à ce plugin d'annuler les blocs.

Vault (économie)Copier le lien vers ce titre

Vault vous permet de faire payer les joueurs pour le minage de filons. Activez-le dans config.yml :

# Economy settings (requires Vault)
economy:
  enabled: false
  # Cost per block mined (0 = disabled)
  cost-per-block: 0.0
  # Cost per vein mine action (0 = disabled)
  cost-per-vein: 0.0

Vous avez besoin de Vault et d'un plugin d'économie qui enregistre un fournisseur Vault. zVeinMiner recherche le fournisseur la première fois qu'il en a besoin, et non au démarrage, donc un plugin d'économie qui s'enregistre tardivement est quand même trouvé.

Calcul du coût :

cost = cost-per-vein + cost-per-block x number of extra blocks broken

Le bloc cassé à la main par le joueur n'est pas compté. Seuls les blocs supplémentaires minés par zVeinMiner le sont.

1. Avant le minage, zVeinMiner calcule le coût maximal possible, à partir de tous les blocs qui ont passé les vérifications de protection. Si le joueur ne peut pas payer ce montant, aucun bloc supplémentaire n'est miné (le bloc cassé à la main se casse quand même normalement) et le joueur reçoit le message economy-not-enough.
2. Après le minage, le joueur ne paie que les blocs réellement cassés. Par exemple, si l'outil n'a plus de durabilité à mi-chemin, les blocs qui n'ont pas été cassés ne sont pas facturés.
3. Lorsque le montant est supérieur à 0, le joueur reçoit le message economy-charged.

NoCheatPlusCopier le lien vers ce titre

Tous les blocs d'un filon sont cassés dans le même tick. Sans ce hook, les vérifications de cassage de blocs de NoCheatPlus (fast break et similaires) les annuleraient.

Lorsque NoCheatPlus est activé, zVeinMiner exempte le joueur des vérifications BLOCKBREAK uniquement pendant le minage d'un filon, puis retire l'exemption. Si un autre plugin avait déjà exempté le joueur, zVeinMiner ne touche pas à cette exemption. Le cassage normal du bloc n'est jamais exempté, seuls les blocs supplémentaires du filon le sont.

Le hook ne nécessite aucune configuration. Il est chargé par réflexion au démarrage de zVeinMiner. Si NoCheatPlus n'est pas installé, rien n'est affiché et rien n'est exempté. Si NoCheatPlus est installé mais que son API a changé, rien n'est exempté et la console affiche Failed to hook into NoCheatPlus: <error>. Contrairement aux hooks de protection, le hook NoCheatPlus n'est pas recherché à nouveau lors d'un /zveinminer reload.

PlaceholderAPICopier le lien vers ce titre

zVeinMiner n'enregistre pas sa propre expansion PlaceholderAPI, il n'a donc aucun placeholder %zveinminer_...%.

Lorsque PlaceholderAPI est installé, chaque message que zVeinMiner envoie à un joueur, dans le chat ou dans l'action bar, passe d'abord par PlaceholderAPI. Vous pouvez utiliser n'importe quel placeholder d'autres expansions dans messages.yml :

economy-charged: "&aYou have been charged &f%amount%&a. Balance: &f%vault_eco_balance_formatted%"

Les messages envoyés à la console ne sont pas analysés. Sans PlaceholderAPI, les messages sont envoyés tels quels, et les placeholders restent en texte brut.

Voir aussiCopier le lien vers ce titre

• Configuration : toutes les options de config.yml, y compris economy
• Commandes et permissions : /zveinminer reload et les permissions zveinminer.*
• Installation : prérequis et mise en place du plugin