How to Use PlaceholderAPI on a Minecraft Server

What PlaceholderAPI Does

Customizing a Minecraft server gets much easier when plugins can share live information with each other. PlaceholderAPI, often shortened to PAPI, makes that possible by letting compatible plugins display dynamic values such as nicknames, ranks, balances, playtime, world names, TPS, ping, and more.

Instead of typing static text everywhere, placeholders pull current server data into plugin formats and configuration files. For example, `%essentials_nickname%` can show a player's EssentialsX nickname, while `%luckperms_prefix%` can show their rank prefix. It is a small plugin with a very large job, which is usually how Minecraft server administration likes to keep things interesting.

Installing PlaceholderAPI

• Download the PlaceholderAPI JAR from its Spigot resource page.

• Open your HolyHosting server panel, then go to the file manager or use an FTP client.
• Sign in with your panel credentials and open the `plugins` folder.
• Upload the PlaceholderAPI JAR file into that folder.
• Wait for the upload to finish completely before leaving the page.

• Return to the main server controls and restart the server.

After the restart, PlaceholderAPI should load with the rest of your plugins. If the plugin does not appear in `/plugins`, confirm that the server is running a compatible Spigot, Paper, or Bukkit-based version and that the JAR was placed directly inside the `plugins` folder.

Downloading Placeholder Expansions

PlaceholderAPI uses expansions to add placeholder sets for supported plugins. These are commonly downloaded through PAPI's eCloud system. Some plugins support PlaceholderAPI without making it obvious on their resource page, but the official expansion list is the cleanest place to check first.

• Open the PlaceholderAPI expansion list and search for the plugin or feature you want.
• Select the expansion name to view its available placeholders.

• Join your server and run the eCloud download command for the expansion:

`/papi ecloud download Essentials`

• Reload PlaceholderAPI so the new expansion becomes active:

`/papi reload`

• Add the new placeholder values to compatible plugin configs or formatting options.

Most expansion placeholders only work when the related plugin is installed. For example, Essentials placeholders usually require EssentialsX, and LuckPerms placeholders require LuckPerms. PlaceholderAPI also has some default expansions, but those still need to be downloaded before use.

Using Placeholders in Plugins

Placeholders are added inside plugin configuration files or in-game format settings. Many placeholders begin and end with `%`, such as `%essentials_nickname%`, though some plugins may use other wrappers like `{}` or `()` depending on their own formatting system.

When editing a config file, place the placeholder exactly as listed by the expansion. Then save the file and reload or restart the plugin as needed. If the placeholder shows as plain text in-game, the plugin may not support PlaceholderAPI in that field, the expansion may be missing, or the required dependency plugin may not be installed.

Chat Formatting

Server chat is one of the most common uses for PlaceholderAPI. With a chat formatting plugin such as LPC, placeholders can show nicknames, rank prefixes, suffixes, balances, or other player information beside each message.

Example:

`%essentials_nickname%`

This can help make chat easier to read and more polished without manually updating every player's display name.

Tab List Details

The player tab list can also use placeholders when paired with a compatible tab plugin such as TAB. This is useful for showing playtime, ping, current world, server TPS, online player count, or similar live details.

Example:

`%playtime_time%`

A good tab list gives players useful information at a glance. A bad one becomes a spreadsheet with ambitions, so keep it readable.

Scoreboard Values

Scoreboard plugins can use PlaceholderAPI to show server and player data on the right side of the screen. For example, RealScoreboard can display a player's LuckPerms rank, username, balance, uptime, or total player count.

Example:

`%luckperms_prefix%`

Scoreboards are best when they show a few important values instead of every possible statistic. If the screen starts looking like a debug menu, trim it back.

Useful PlaceholderAPI Commands

• `/papi ecloud list all` shows available eCloud expansions.
• `/papi ecloud download [extension]` downloads a selected expansion.
• `/papi reload` reloads PlaceholderAPI after changes.
• `/papi parse me [placeholder]` tests a placeholder against your own player data.

Final Notes

PlaceholderAPI is a bridge between plugins. Install it, add the expansions you need, reload PAPI, then place the listed values into compatible chat, tab list, scoreboard, or other plugin settings.

If a placeholder does not work, check three things first: the expansion is installed, the dependency plugin is installed, and the plugin field you edited actually supports PlaceholderAPI. Once those line up, placeholders are one of the easiest ways to make a Minecraft server feel more custom and organized.