Plugin Minecraft InteractionVisualizer

🔌 À propos de InteractionVisualizer

InteractionVisualizer est un plugin Minecraft qui affiche côté client des représentations visuelles et des animations pour les blocs fonctionnels et les entités concernées (par exemple : crafting tables, furnaces, enchantment tables). Les visuels sont envoyés aux joueurs via des packets et ne créent ni blocs ni entités côté serveur — ce sont uniquement des affichages côté client qui n’affectent pas l’état du monde.

🎯 Objectif

Le plugin rend visibles aux joueurs à proximité les interactions avec des blocs fonctionnels couramment utilisés en affichant des objets, la progression, des hologrammes et des animations lorsque les joueurs utilisent des GUIs. Il est destiné aux propriétaires de serveurs qui veulent un retour visuel plus riche et plus informatif lorsque les joueurs interagissent avec des interfaces dans le monde.

⚙️ Fonctionnalités

• Visualise de nombreux blocs fonctionnels et leurs objets/entités correspondants avec des animations (crafting table, furnace, enchantment table et autres).
• Affichages côté client uniquement : les visuels ne créent pas d’entités serveur persistantes ou interactives.
• Basculement de l’affichage par bloc et basculement global des modules.
• L’état de basculement du joueur est enregistré dans une base de données (SQLite par défaut ; MySQL pris en charge).
• Des placeholders PlaceholderAPI sont disponibles pour l’état de basculement du joueur.
• Fournit une API de développement / wiki pour les add-ons.
• Tient compte des intégrations avec des plugins courants pour désactiver ou ajuster les animations (plugins de vanish, OpenInv, etc.).

🧩 À qui cela s’adresse

• Serveurs Survival et SMP qui veulent un retour visuel plus immersif pour les interactions avec les blocs.
• Serveurs décoratifs/roleplay qui préfèrent une finition visuelle côté client sans modifier les données du monde.
• Administrateurs de serveurs qui veulent un contrôle optionnel par joueur sur les effets visuels.

🏗️ Exemples d’utilisation

• Afficher des objets apparaissant sur une crafting table lorsqu’un joueur remplit les emplacements de la recette afin que les joueurs à proximité puissent voir la progression.
• Afficher un hologramme de progression du furnace et des visuels d’objets générés pendant qu’un joueur interagit avec l’interface du furnace.
• Permettre aux joueurs de basculer les modules d’affichage qu’ils voient (itemstands, dropped items, holograms).

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Configuration

• Télécharge le JAR officiel du plugin ainsi que tous les JAR de dépendances requis.
• Place les fichiers JAR dans le dossier plugins/ de ton serveur.
• Démarre le serveur et vérifie la console pour confirmer que le plugin a bien été chargé.
• Modifie la configuration si nécessaire et redémarre le serveur pour appliquer les changements.

📦 Dépendances

• ProtocolLib (requis pour les anciennes versions du serveur / la gestion des packets lorsque spécifié).
• LightAPI Fork (requis pour les anciennes versions lorsque utilisé).

Intégrations souples/optionnelles signalées par le projet (utilisées pour ajuster le comportement) : EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 Configuration

• Le plugin enregistre les bascules par joueur dans SQLite par défaut et prend en charge MySQL pour un stockage persistant entre serveurs.
• Chaque affichage de bloc et chaque module peut être désactivé via la configuration du plugin.

🧠 Notes techniques

• Construit sur l’API de Spigot ; indique également une compatibilité avec Paper et plusieurs versions modernes du serveur.
• Les affichages sont uniquement côté client et ne créent pas d’entités serveur tuables ou persistantes.
• Le plugin propose une API de développement pour les add-ons tiers et les traductions sont maintenues par la communauté.
• Le projet indique une limitation : il peut ne pas fonctionner sur Minecraft 1.10.2 ou en dessous.

🤝 Quand ce plugin est utile

Si vous voulez un retour visuel décoratif et non intrusif pour les interactions des joueurs sans modifier l’état côté serveur, InteractionVisualizer fournit des animations basées sur des packets et des contrôles par joueur pour renforcer l’immersion tout en gardant le monde inchangé.