Plugin de Minecraft PlaceholderAPI

🔌 Acerca de PlaceholderAPI

PlaceholderAPI es un plugin de Minecraft que expone un sistema centralizado de placeholders y un ecosistema de expansiones (la eCloud). Permite que otros plugins lean y reemplacen miles de placeholders dinámicos (datos del jugador, valores de economía, valores específicos de plugins, etc.) sin requerir integración directa ni dependencias fuertes.

🎯 Propósito

El plugin soluciona la fricción de integración entre plugins al ofrecer una única API de placeholders extensible. Los autores de plugins publican expansiones que proporcionan placeholders con nombre; los administradores del servidor instalan esas expansiones para que los plugins orientados al servidor (scoreboards, chat, hologramas, GUIs) puedan mostrar datos en vivo usando una sintaxis consistente.

⚙️ Características

• API central de análisis de placeholders para que otros plugins se integren.
• Sistema de expansiones: expansiones empaquetadas por separado o incluidas dentro de plugins.
• eCloud (nube de expansiones) para encontrar y descargar expansiones verificadas dentro del juego.
• Comandos de gestión en tiempo de ejecución para listar, registrar, desregistrar y recargar expansiones.
• Comandos de depuración/análisis para evaluar placeholders para un jugador o emitir resultados, útiles para solucionar problemas.
• Utilidades como el comando dump para compartir las expansiones instaladas y el estado del plugin al pedir soporte.

🧩 Para quién es

• Administradores de servidor que necesitan texto dinámico unificado en varios plugins (scoreboards, tablists, hologramas, GUIs).
• Desarrolladores de plugins que quieren exponer o consumir placeholders sin forzar dependencias fuertes.
• Servidores de Survival, minijuegos y redes que combinan muchos plugins y necesitan una sintaxis de placeholders consistente.

🏗️ Casos de uso de ejemplo

• Un servidor instala una expansión de Vault para que placeholders de economía como el saldo del jugador se puedan usar en plugins de scoreboard y chat.
• Un administrador descarga una expansión específica de un plugin desde la eCloud para que un plugin de hologramas pueda mostrar datos de objetivos en vivo.
• Un desarrollador expone datos del plugin mediante una PlaceholderExpansion para que otros servidores puedan mostrar esos datos sin depender directamente del plugin.

⌨️ Comandos

(Nota: los comandos anteriores están documentados en la referencia oficial de comandos de PlaceholderAPI. Los nodos de permiso para comandos individuales no aparecen en la documentación de comandos referenciada.)

⚙️ Instalación

📥 Configuración

• Descarga el jar oficial de PlaceholderAPI y colócalo en el directorio plugins/ de tu servidor.
• Inicia o reinicia el servidor y confirma en la consola que PlaceholderAPI se carga correctamente.
• Instala expansiones colocando los jars de expansiones en plugins/PlaceholderAPI/expansions/ o usando los comandos de eCloud dentro del juego (para expansiones verificadas).

📦 Dependencias

• El propio PlaceholderAPI no requiere una dependencia general de plugin para funcionar. Algunos placeholders proporcionados por expansiones dependen de otros plugins (por ejemplo, una expansión que muestre valores de economía necesitará el plugin de economía correspondiente). Esos requisitos dependen de la expansión concreta.

🧠 Notas técnicas

• PlaceholderAPI está disponible para servidores basados en Spigot y también se usa mucho en Paper. Expone una API para que los desarrolladores registren PlaceholderExpansions.
• Las expansiones pueden distribuirse como archivos jar independientes o incluirse dentro de otros plugins; las expansiones independientes suelen instalarse en plugins/PlaceholderAPI/expansions/.
• La función eCloud permite descubrir y descargar expansiones verificadas dentro del juego; los servidores deben permitir HTTPS de salida para que funcionen las descargas de eCloud.
• El plugin incluye comandos de depuración y análisis para ayudar a los administradores a verificar que los placeholders se resuelven correctamente.

🤝 Cuándo es útil este plugin

Si tu servidor usa varios plugins que necesitan mostrar datos dinámicos entre plugins (chat, tab, hologramas, scoreboards o GUIs), PlaceholderAPI es útil porque centraliza la resolución de placeholders y te permite añadir soporte para plugins adicionales mediante expansiones modulares sin modificar cada plugin consumidor.