Cómo usar PlaceholderAPI en un server de Minecraft

Qué hace PlaceholderAPI

Personalizar un server de Minecraft se vuelve mucho más fácil cuando los plugins pueden compartir información en vivo entre sí. PlaceholderAPI, a menudo abreviado como PAPI, hace esto posible al permitir que plugins compatibles muestren valores dinámicos como apodos, rangos, balances, tiempo de juego, nombres de mundos, TPS, ping y más.

En lugar de escribir texto estático en todas partes, los placeholders toman datos actuales del server y los insertan en formatos de plugins y archivos de config. Por ejemplo, `%essentials_nickname%` puede mostrar el apodo de EssentialsX de un jugador, mientras que `%luckperms_prefix%` puede mostrar el prefijo de su rango. Es un plugin pequeño con un trabajo muy grande, que normalmente es como a la administración de servers de Minecraft le gusta mantener las cosas interesantes.

Instalar PlaceholderAPI

• Descarga el archivo JAR de PlaceholderAPI desde su página de recurso en Spigot.

• Abre tu panel de server de HolyHosting, luego ve al administrador de archivos o al área de acceso de archivos por FTP.
• Inicia sesión con tus credenciales del panel y abre la carpeta `plugins`.
• Sube el archivo JAR de PlaceholderAPI a esa carpeta.
• Espera a que la carga termine por completo antes de salir de la página.

• Regresa a los controles principales del server y reinicia el server.

Después del reinicio, PlaceholderAPI debería cargar junto con el resto de tus plugins. Si el plugin no aparece en `/plugins`, confirma que el server esté ejecutando una versión compatible basada en Spigot, Paper o Bukkit, y que el JAR se haya colocado directamente dentro de la carpeta `plugins`.

Descargar expansiones de placeholders

PlaceholderAPI usa expansiones para agregar conjuntos de placeholders para plugins compatibles. Estas normalmente se descargan mediante el sistema eCloud de PAPI. Algunos plugins son compatibles con PlaceholderAPI sin hacerlo evidente en su página de recurso, pero la lista oficial de expansiones es el lugar más limpio para revisar primero.

• Abre la lista de expansiones de PlaceholderAPI y busca el plugin o función que quieres.
• Selecciona el nombre de la expansión para ver sus placeholders disponibles.

• Entra a tu server y ejecuta el comando de descarga de eCloud para la expansión:

`/papi ecloud download Essentials`

• Recarga PlaceholderAPI para que la nueva expansión se active:

`/papi reload`

• Agrega los nuevos valores de placeholder a configs de plugins compatibles u opciones de formato.

La mayoría de los placeholders de expansiones solo funcionan cuando el plugin relacionado está instalado. Por ejemplo, los placeholders de Essentials normalmente requieren EssentialsX, y los placeholders de LuckPerms requieren LuckPerms. PlaceholderAPI también tiene algunas expansiones predeterminadas, pero aun así deben descargarse antes de usarse.

Usar placeholders en plugins

Los placeholders se agregan dentro de archivos de configuración de plugins o en settings de formato dentro del juego. Muchos placeholders empiezan y terminan con `%`, como `%essentials_nickname%`, aunque algunos plugins pueden usar otros contenedores como `{}` o `()` dependiendo de su propio sistema de formato.

Cuando edites un archivo de config, coloca el placeholder exactamente como aparece en la expansión. Luego guarda el archivo y recarga o reinicia el plugin según sea necesario. Si el placeholder aparece como texto plano dentro del juego, puede que el plugin no sea compatible con PlaceholderAPI en ese campo, que falte la expansión o que el plugin de dependencia requerido no esté instalado.

Formato de chat

El chat del server es uno de los usos más comunes de PlaceholderAPI. Con un plugin de formato de chat como LPC, los placeholders pueden mostrar apodos, prefijos de rango, sufijos, balances u otra información del jugador junto a cada mensaje.

Ejemplo:

`%essentials_nickname%`

Esto puede ayudar a que el chat sea más fácil de leer y se vea más pulido sin actualizar manualmente el nombre visible de cada jugador.

Detalles de la lista de tab

La lista de tab de jugadores también puede usar placeholders cuando se combina con un plugin de tab compatible como TAB. Esto es útil para mostrar tiempo de juego, ping, mundo actual, TPS del server, cantidad de jugadores en línea o detalles similares en vivo.

Ejemplo:

`%playtime_time%`

Una buena lista de tab les da a los jugadores información útil de un vistazo. Una mala se convierte en una hoja de cálculo con ambiciones, así que mantenla legible.

Valores de scoreboard

Los plugins de scoreboard pueden usar PlaceholderAPI para mostrar datos del server y del jugador en el lado derecho de la pantalla. Por ejemplo, RealScoreboard puede mostrar el rango de LuckPerms de un jugador, nombre de usuario, balance, uptime o cantidad total de jugadores.

Ejemplo:

`%luckperms_prefix%`

Los scoreboards funcionan mejor cuando muestran algunos valores importantes en lugar de cada estadística posible. Si la pantalla empieza a parecer un menú de debug, recórtalo.

Comandos útiles de PlaceholderAPI

• `/papi ecloud list all` muestra las expansiones disponibles de eCloud.
• `/papi ecloud download [extension]` descarga una expansión seleccionada.
• `/papi reload` recarga PlaceholderAPI después de los cambios.
• `/papi parse me [placeholder]` prueba un placeholder contra los datos de tu propio jugador.

Notas finales

PlaceholderAPI es un puente entre plugins. Instálalo, agrega las expansiones que necesitas, recarga PAPI y luego coloca los valores listados en settings compatibles de chat, lista de tab, scoreboard u otros plugins.

Si un placeholder no funciona, revisa tres cosas primero: que la expansión esté instalada, que el plugin de dependencia esté instalado y que el campo del plugin que editaste realmente sea compatible con PlaceholderAPI. Cuando esas piezas coinciden, los placeholders son una de las formas más fáciles de hacer que un server de Minecraft se sienta más personalizado y organizado.