PlaceholderAPI en tu servidor de Minecraft: qué es, cómo se instala y por qué sale %player_name%

Qué es un placeholder y qué es una expansión

Un placeholder es un hueco entre porcentajes que se rellena al enseñarlo: %player_name% se convierte en el nombre de quien lo ve, %server_online% en los jugadores conectados y %vault_eco_balance% en el dinero del jugador. Lo escribes en la configuración de otro plugin (el de TAB, el del marcador, el de hologramas) y PlaceholderAPI pone el valor.

Los placeholders vienen en expansiones. Unas van dentro del propio plugin que da los datos y funcionan sin hacer nada. Otras son un .jar aparte que se descarga desde la nube de expansiones de PlaceholderAPI (el eCloud): entre ellas están las más usadas, Player (%player_…%), Server (%server_…%), Vault (dinero y rangos), Essentials y LuckPerms. Instalar PlaceholderAPI solo no trae ninguna de esas.

Dos condiciones para que se vea algo: el plugin donde escribes el placeholder tiene que admitir PlaceholderAPI (lo dice su página; TAB, DecentHolograms, DeluxeMenus, AnimatedScoreboard o DiscordSRV lo admiten), y la expansión de ese placeholder tiene que estar cargada.

Instalarlo

1. Comprueba que tu servidor es de plugins

   PlaceholderAPI es un plugin para Paper, Spigot o Purpur; no funciona en Fabric, Forge ni NeoForge. En NapNodes los servidores de Minecraft se entregan con Paper.

2. Instálalo desde el panel

   En el panel, «Mods y plugins»: busca PlaceholderAPI e instálalo. Busca en Modrinth solo lo que vale para tu versión. Si prefieres hacerlo a mano, sube el .jar a la carpeta plugins desde «Archivos».

3. Reinicia

   Los plugins se cargan al arrancar. Después aparece la carpeta plugins/PlaceholderAPI, con config.yml y la carpeta expansions, que es donde se guardan las expansiones.

4. Descarga las expansiones que vas a usar

   En la «Consola» del panel (sin la barra delante): papi ecloud download Player y papi ecloud download Server, que son las más usadas. Si usas economía, papi ecloud download Vault (y el plugin Vault instalado); para los rangos de LuckPerms, papi ecloud download LuckPerms.

5. Recarga

   papi reload carga las expansiones recién descargadas sin reiniciar. Con papi list ves cuáles están activas.

Probar un placeholder antes de usarlo

Antes de tocar la configuración de otro plugin, comprueba que el placeholder da un valor. Dentro del juego, siendo op: /papi parse me %player_name%. Te tiene que contestar con tu nombre. Desde la consola, que no es un jugador, pon el nombre de alguien conectado en lugar de me: papi parse Nombre %player_ping%.

Si parse devuelve el valor y el otro plugin sigue enseñando los porcentajes, el problema no es PlaceholderAPI: ese plugin no lo admite, o esa opción concreta de su configuración no lee placeholders. Si parse devuelve el texto tal cual, falta la expansión o está mal escrito (siguiente apartado).

Para saber qué placeholders trae una expansión del eCloud: papi ecloud placeholders Player. La lista completa y al día, con las que van dentro de cada plugin, está en la wiki de PlaceholderAPI (wiki.placeholderapi.com).

Los placeholders que más se usan

Del jugador (expansión Player): %player_name%, %player_displayname%, %player_ping%, %player_health%, %player_level% y %player_world%.

Del servidor (expansión Server): %server_online% y %server_max_players% (el «12/20» de la tabla), %server_tps_1% (los TPS del último minuto; %server_tps_1_colored% los pinta de color según lo buenos que sean), %server_ram_used% y %server_uptime%.

Dinero y rango (expansión Vault, con Vault y un plugin de economía como EssentialsX): %vault_eco_balance_formatted% para el saldo, %vault_prefix% y %vault_group% para el prefijo y el grupo. Con LuckPerms (expansión LuckPerms): %luckperms_prefix% y %luckperms_primary_group_name%.

Estadísticas (expansión Statistic): %statistic_mine_block:diamond_ore% cuenta los minerales de diamante picados, útil para marcadores y rankings.

Sale %player_name% en vez del nombre: las causas

1. Falta la expansión

   Es lo más habitual. Instalar PlaceholderAPI no basta: papi ecloud download Player (o la que toque) y papi reload. papi list te dice cuáles están cargadas.

2. No recargaste

   Una expansión descargada no hace nada hasta papi reload o un reinicio.

3. Está mal escrito

   Una letra de más o un guion bajo que falta y ya no se reconoce. Compáralo con papi ecloud placeholders <expansión> o con la wiki, y pruébalo con /papi parse me.

4. Falta el plugin del que saca los datos

   Las de Vault, Essentials o LuckPerms necesitan ese plugin instalado y encendido (en verde al escribir /plugins). Sin él, la expansión no carga y en la consola sale «Failed to load Expansion class … (Is a dependency missing?)».

5. El plugin donde lo escribes no lo admite

   Si /papi parse da el valor pero en el juego no, el fallo está en el otro plugin. EssentialsX Chat, por ejemplo, no lee placeholders de PlaceholderAPI en el formato del chat sin un plugin aparte que se los meta; mira la documentación de cada uno.

Si «papi ecloud download» no descarga nada

El comando necesita que el servidor pueda conectarse por HTTPS al eCloud. Desde los servidores de NapNodes se puede: la salida por HTTPS está abierta (lo que se corta es el correo saliente y las ráfagas de conexiones).

Lo que sí puede pasar es que la expansión no esté verificada: el comando de descarga solo baja las verificadas, para que nadie cuele un .jar con malware. En ese caso, búscala en ecloud.placeholderapi.com, descarga el .jar, súbelo desde «Archivos» a plugins/PlaceholderAPI/expansions y escribe papi reload en la «Consola».

Baja expansiones solo del eCloud o de la página oficial del plugin. Una expansión es código que corre en tu servidor con los mismos permisos que un plugin: antes de probar algo raro, una copia en «Copias de seguridad».

Preguntas frecuentes