Plugin de Minecraft InteractionVisualizer

🔌 Acerca de InteractionVisualizer

InteractionVisualizer es un plugin de Minecraft que renderiza representaciones visuales y animaciones del lado del cliente para bloques funcionales y entidades relevantes (por ejemplo: crafting tables, furnaces, enchantment tables). Los efectos visuales se envían a los jugadores mediante packets y no crean bloques ni entidades del lado del servidor — son pantallas puramente del lado del cliente que no afectan al estado del mundo.

🎯 Propósito

El plugin hace visibles para los jugadores cercanos las interacciones con bloques funcionales de uso común mostrando objetos, progreso, hologramas y animaciones mientras los jugadores usan GUIs. Está pensado para administradores de servidores que quieren una retroalimentación visual más rica e informativa cuando los jugadores interactúan con interfaces del mundo.

⚙️ Características

• Visualiza muchos bloques funcionales y sus objetos/entidades correspondientes con animaciones (crafting table, furnace, enchantment table y otros).
• Pantallas solo del lado del cliente: los efectos visuales no crean entidades persistentes ni interactuables en el servidor.
• Activadores de visualización por bloque y activadores globales de módulos.
• El estado de activación del jugador se guarda en una base de datos (SQLite por defecto; MySQL compatible).
• Hay placeholders de PlaceholderAPI disponibles para el estado de activación del jugador.
• Proporciona una API para desarrolladores / wiki para complementos.
• Tiene en cuenta la integración con plugins comunes para desactivar o ajustar animaciones (plugins de vanish, OpenInv, etc.).

🧩 Para quién es

• Servidores Survival y SMP que quieren una retroalimentación visual más inmersiva para las interacciones con bloques.
• Servidores decorativos/roleplay que prefieren un acabado visual del lado del cliente sin modificar los datos del mundo.
• Administradores de servidores que quieren control opcional por jugador sobre los efectos visuales.

🏗️ Casos de uso de ejemplo

• Mostrar objetos apareciendo sobre una crafting table mientras un jugador llena los espacios de la receta para que los jugadores cercanos puedan ver el progreso.
• Mostrar un holograma de progreso del furnace y visuales de objetos generados mientras un jugador interactúa con la interfaz del furnace.
• Permitir que los jugadores cambien qué módulos de visualización ven (itemstands, dropped items, holograms).

⌨️ Comandos

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin y cualquier JAR de dependencia necesario.
• Coloca los archivos JAR en la carpeta plugins/ de tu servidor.
• Inicia el servidor y revisa la consola para confirmar que el plugin se cargó.
• Edita la configuración según sea necesario y reinicia el servidor para que los cambios se apliquen.

📦 Dependencias

• ProtocolLib (necesario para versiones antiguas del servidor / manejo de packets donde se especifique).
• LightAPI Fork (necesario para versiones antiguas donde se use).

Integraciones suaves/opcionales indicadas por el proyecto (usadas para ajustar el comportamiento): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 Configuración

• El plugin guarda los activadores por jugador en SQLite por defecto y admite MySQL para almacenamiento persistente entre servidores.
• Cada visualización de bloque y cada módulo puede desactivarse mediante la configuración del plugin.

🧠 Notas técnicas

• Construido sobre la API de Spigot; también informa compatibilidad con Paper y varias compilaciones modernas del servidor.
• Las visualizaciones son solo del lado del cliente y no crean entidades del servidor que puedan ser asesinadas o persistentes.
• El plugin ofrece una API para desarrolladores para complementos de terceros y las traducciones son mantenidas por la comunidad.
• El proyecto indica una limitación: puede no funcionar en Minecraft 1.10.2 o inferior.

🤝 Cuándo es útil este plugin

Si quieres una retroalimentación visual decorativa y no intrusiva para las interacciones de los jugadores sin cambiar el estado del lado del servidor, InteractionVisualizer ofrece animaciones basadas en packets y controles por jugador para mejorar la inmersión mientras mantiene el mundo sin cambios.