Plugin de Minecraft CommandPanels

🔌 Acerca de CommandPanels

CommandPanels es un plugin de Minecraft que proporciona un sistema de GUI/menús para servidores impulsado por YAML. Se centra en paneles basados en inventario, paneles de diálogo (formularios) y paneles compatibles con Floodgate para jugadores de Bedrock. El proyecto incluye un editor en línea y un formato estructurado para crear menús interactivos y basados en datos que ejecutan comandos, muestran placeholders dinámicos y reaccionan a la lógica y los permisos.

🎯 Propósito

El plugin está pensado para administradores de servidores y desarrolladores que necesitan GUI flexibles y programables para tiendas, kits, lobbies, herramientas de moderación o flujos de trabajo personalizados. Está diseñado para permitir que los paneles ejecuten comandos, comprueben condiciones, animen objetos y expongan datos de sesión o persistentes para usarlos en otros sistemas.

⚙️ Funcionalidades

• Paneles de inventario con interacciones con objetos, distribución de slots y cadenas de animación.
• Paneles de diálogo para formularios estructurados y entradas de los jugadores.
• Compatibilidad con paneles Floodgate para mostrar paneles compatibles a jugadores de Bedrock (mediante configuraciones Geyser/Floodgate).
• Lógica y condiciones inline (operadores del estilo AND/OR/NOT) para controlar la visibilidad y el comportamiento.
• Sistema de comandos/acciones: hooks de apertura/cierre, acciones de clic, acciones al hacer clic fuera y ejecución condicional de comandos.
• Compatibilidad con PlaceholderAPI y actualizaciones dinámicas de placeholders dentro de los paneles.
• Datos de sesión y persistentes del panel accesibles entre paneles y comandos.
• Actualizaciones periódicas y un observador de permisos que puede volver a analizar toda la lógica cuando cambian los permisos.
• Editor en línea con vista previa en vivo de YAML y comprobaciones de estructura.

🧩 Para quién es

Administradores y desarrolladores de plugins que ejecutan servidores modernos compatibles con Paper y necesitan menús GUI flexibles: servidores survival/SMP, redes de minijuegos, hubs PvP y servidores que requieren interfaces personalizadas de administración/moderación.

🏗️ Casos de uso de ejemplo

• Crear una GUI de kit o tienda que ejecute comandos del servidor y requiera permisos específicos o saldo de economía.
• Construir un menú de navegación del hub con objetos animados y visibilidad condicional según el rango del jugador.
• Ofrecer un menú compatible con Bedrock usando variantes de panel específicas de Floodgate.

⌨️ Comandos

(Los comandos y sus permisos se toman de la documentación oficial de CommandPanels.)

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el archivo oficial .jar de CommandPanels y colócalo en la carpeta plugins/ de tu servidor.
• Inicia el servidor para generar los datos del plugin.
• Después de la primera ejecución, revisa plugins/CommandPanels para ver config.yml y la carpeta panels/ con los archivos de definición de paneles.

📦 Dependencias

• PlaceholderAPI — opcional, pero recomendado para placeholders dinámicos.
• Floodgate — opcional para compatibilidad con paneles de Bedrock (Floodgate).

🧾 Configuración

• Los paneles se definen como archivos YAML colocados en el directorio panels/. Se admiten subcarpetas para organizarlos.
• El plugin genera paneles de ejemplo si se elimina el directorio panels/ y se reinicia el plugin.

🧠 Notas técnicas

• La documentación oficial y los lanzamientos indican Paper y Folia (forks de Paper) como plataformas de servidor compatibles para las versiones modernas v4.
• La serie de lanzamientos v4 se centra en versiones recientes del servidor Minecraft; las definiciones de paneles admiten placeholders dinámicos y lógica condicional analizada en tiempo de ejecución.
• El plugin expone nodos de permisos y una API basada en comandos para abrir paneles; también puede integrarse como biblioteca en otros plugins cargando YAML de paneles e invocando acciones de apertura.

🤝 Cuándo es útil este plugin

Si necesitas un sistema de GUI estructurado y programable que admita datos dinámicos, lógica condicional, compatibilidad con Bedrock y un editor en línea, CommandPanels ofrece un enfoque confirmado y centrado en YAML que encaja con servidores y redes basados en Paper.