PlaceholderAPI — plugin para sustituir datos dinámicos en Minecraft
PlaceholderAPI (PAPI) permite que los plugins de Minecraft muestren datos dinámicos — nombre, saldo, rango — mediante sencillos marcadores…
PlaceholderAPI (PAPI) permite que los plugins de Minecraft muestren datos dinámicos — nombre, saldo, rango — mediante sencillos marcadores %placeholder%.
PlaceholderAPI — plugin para sustituir datos dinámicos en Minecraft
Versión de Minecraft con la que se probó y escribió el artículo: 26.1.2
Rango de versiones compatibles: 1.8.x – 26.1.x
PlaceholderAPI (abreviado PAPI) es un plugin de servidor para Minecraft que sustituye en el texto valores dinámicos en lugar de marcadores especiales. Por sí mismo no muestra nada: es un motor que encuentra en una cadena un marcador como %player_name% y lo reemplaza por el valor actual — el nombre del jugador, el saldo, el rango, los jugadores en línea del servidor. Los datos en sí los proporcionan módulos aparte — las expansiones —, mientras que PAPI solo ejecuta la sustitución. Gracias a esto, los plugins de chat, scoreboard, tab-list y menús leen los valores en un mismo formato, sin sintaxis propia.
Formato de los placeholders
Un placeholder se escribe entre dos signos de porcentaje: %<розширення>_<параметр>%. La primera parte antes del guion bajo es el nombre de la expansión, y a continuación va el parámetro concreto. Por ejemplo, %player_name% devuelve el nombre del jugador, y %server_online% el número de jugadores en línea.
La sustitución solo funciona donde la invoca el propio plugin receptor. Si un plugin no admite PAPI, los marcadores en sus mensajes quedarán como texto normal. Se puede comprobar un placeholder concreto con el comando de análisis:
/papi parse me %player_name%
Si en la respuesta se devuelve el propio texto del marcador y no un valor, falta la expansión necesaria o el plugin de origen está desactivado.
Expansiones y eCloud
PlaceholderAPI no incluye de fábrica ni un solo placeholder — todos provienen de expansiones. Algunas vienen integradas en el plugin de origen y se registran solas al iniciar el servidor; otras son archivos jar independientes en la nube de expansiones (eCloud) y se instalan en el directorio /plugins/PlaceholderAPI/expansions/.
La expansión que necesites se puede descargar directamente desde el juego:
/papi ecloud download <розширення>
/papi reload
A través del comando solo se descargan expansiones verificadas — es una protección frente a código malicioso. Las no verificadas se instalan manualmente: se descarga el jar desde el sitio web y se coloca en la carpeta de expansiones.
Acceso a eCloud: si el hosting o un cortafuegos bloquea la conexión externa, la descarga mediante el comando no funcionará — la expansión habrá que añadirla manualmente.
Comandos
Todos los comandos empiezan con /papi. Por defecto solo están disponibles para operadores; los permisos individuales se otorgan mediante los nodos placeholderapi.*.
Comando | Función |
| Analizar los placeholders en el texto para un jugador |
| Analizar placeholders relacionales para dos jugadores |
| Mostrar las expansiones activas |
| Información sobre una expansión concreta |
| Descargar una expansión desde la nube |
| Lista de placeholders de la expansión |
| Recargar el plugin y la configuración |
| Versión del plugin instalado |
Configuración
En config.yml solo unos pocos parámetros son útiles para editar:
Parámetro | Qué hace |
| Conexión con eCloud. |
| Texto de los valores booleanos de los placeholders; se puede sustituir por sí / no |
| Formato de fecha y hora para los placeholders correspondientes |
| Comprueba las actualizaciones del plugin al iniciar y notifica a los operadores |
El resto de valores del archivo son internos (protección de expansiones, modo de sustitución en los componentes de Adventure, depuración) y por defecto no se tocan.
Conclusión
PlaceholderAPI ofrece un formato único de sustitución de datos que entienden cientos de plugins: en lugar de una integración aparte para cada plugin, basta con una línea con un placeholder. Es necesario para administradores de servidores de Minecraft con chat, tab-list, scoreboard o menús basados en datos dinámicos; para un juego en solitario no tiene utilidad.
Instalación
Una instalación típica lleva unos 5 minutos. El proceso es el mismo; solo cambian el loader y el build correspondiente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
