LPC Pro · Reference
Placeholders
Documents LPC Pro 4.0.0 · mirrored from the product wiki, updated 2026-02-07 · GitBook version
LPC Pro provides two types of placeholders: built-in placeholders for use in chat format files, and PlaceholderAPI placeholders for use in other plugins.
Built-in Placeholders
These placeholders work in chat format files (formats/*.yml) without any additional plugins:
Player Placeholders
| Placeholder | Description |
|---|---|
{name} |
Player name (with nickname if set) |
{player} |
Same as {name} |
{nickname} |
Player's nickname (or real name if not set) |
{displayname} |
Player's display name |
{prefix} |
Rank prefix (from Vault/LuckPerms) |
{suffix} |
Rank suffix |
{tag} |
Active chat tag (includes leading space when set) |
{world} |
Player's current world |
Message Placeholders
| Placeholder | Description |
|---|---|
{message} |
The chat message content |
Private Message Placeholders
| Placeholder | File | Description |
|---|---|---|
{receiver_name} |
msg-sender.yml |
Recipient's name |
{sender_name} |
msg-receiver.yml |
Sender's name |
Server Message Placeholders
| Placeholder | File | Description |
|---|---|---|
{player} |
servermessages.yml |
Player who joined/quit/died |
{killer} |
Death messages | PvP killer name |
{mob} |
Death messages | Mob name |
{reason} |
Clear chat | Reason provided |
Tab List Placeholders
| Placeholder | Description |
|---|---|
{player} |
Player name |
{displayname} |
Player display name |
{online} |
Online player count |
{max} |
Max player slots |
{tps} |
Server TPS |
{ping} |
Player ping (ms) |
{world} |
Current world name |
{time} |
Server time (HH:mm) |
{rank} |
Primary group |
PlaceholderAPI Placeholders
These placeholders require PlaceholderAPI and work both within LPC Pro formats and in other plugins (scoreboards, TAB, holograms, etc.).
LPC Pro Expansion
| Placeholder | Description |
|---|---|
%lpcpro_messages% |
Messages sent (formatted: 1.2K, 3.5M) |
%lpcpro_messages_raw% |
Messages sent (raw number) |
%lpcpro_mentions% |
Unique players mentioned (formatted: 1.2K, 3.5M) |
%lpcpro_replies% |
Replies sent (formatted: 1.2K, 3.5M) |
%lpcpro_polls% |
Polls voted in (formatted: 1.2K, 3.5M) |
%lpcpro_reputation% |
Reputation score |
%lpcpro_reputation_rank% |
Reputation leaderboard rank |
%lpcpro_achievements% |
Achievement progress (e.g., "5/15") |
%lpcpro_achievements_unlocked% |
Unlocked achievements count |
%lpcpro_achievements_total% |
Total achievements count |
%lpcpro_achievements_percent% |
Unlock percentage (e.g., "33%") |
%lpcpro_balance% |
Shop currency balance |
%lpcpro_balance_formatted% |
Shop balance (formatted: 1.2K, 3.5M) |
%lpcpro_chatting_days% |
Days since first message |
Using in Chat Formats
PlaceholderAPI placeholders can be used directly in text and hover fields:
player:
text: "{prefix} {name}"
hover:
- "&8Joined %player_first_join_date%"
- "&7Hours played: &f%statistic_hours_played%h"
- "&7Messages: &f%lpcpro_messages%"
- "&bReputation: &f%lpcpro_reputation% &8(#%lpcpro_reputation_rank%)"
- "&7Achievements: &f%lpcpro_achievements% &8(%lpcpro_achievements_percent%)"
Popular Third-Party Placeholders
| Placeholder | Plugin | Description |
|---|---|---|
%player_name% |
Player | Player name |
%player_first_join_date% |
Player | First join date |
%statistic_hours_played% |
Statistic | Hours played |
%server_online% |
Server | Online count |
%vault_prefix% |
Vault | Rank prefix |
%vault_eco_balance% |
Vault | Economy balance |
%luckperms_prefix% |
LuckPerms | LuckPerms prefix |
%luckperms_primary_group_name% |
LuckPerms | Primary group |
For the full list of available PlaceholderAPI placeholders, see the PlaceholderAPI wiki.