Placeholders

Two different placeholder systems: PlaceholderAPI placeholders (%alphasystem_*%) that other plugins can use, and internal {curly} placeholders used inside Alpha-system's own message files.

PlaceholderAPI — %alphasystem_*%

Registered automatically when PlaceholderAPI is installed. Identifier: alphasystem.

Placeholder	Returns
`%alphasystem_balance%`	Formatted balance — respects economy.yml's currency symbol and short-format settings (e.g. `$1.5k`)
`%alphasystem_balance_raw%`	Raw numeric balance, no formatting (e.g. `1500.0`)
`%alphasystem_god%`	`yes` / `no`
`%alphasystem_vanished%`	`yes` / `no`

Use these anywhere PlaceholderAPI is accepted — scoreboard plugins, TAB, holograms, other plugins' own message configs.

What Alpha-system consumes from other plugins

The plugin also reads placeholders from PlaceholderAPI in the other direction:

%luckperms_prefix% / %luckperms_suffix% — pulled live into every chat message, so rank prefixes/suffixes always reflect the player's current LuckPerms group with zero caching lag.

No hard dependency on LuckPerms itself — Alpha-system only ever talks to it through PlaceholderAPI, and silently returns an empty string if PlaceholderAPI isn't installed or the placeholder isn't registered.

Message placeholders — general

Used throughout lang/messages.yml. Not every message key uses every placeholder — check the specific line.

Identity

{prefix}
{player}
{target}
{admin}

Chat only

{rank_prefix}
{rank_suffix}
{message}

Values

{amount}
{world}
{time}

Punishment placeholders

Used in punishments.yml — kick screens, staff-info cards, broadcast lines, history entries.

Placeholder	Meaning
`{player}`	The punished account's name
`{punisher}`	Who issued it — a staff name, or "SYSTEM" for auto-escalation
`{reason}`	The reason text (or the preset's configured reason)
`{duration}`	Humanized ("2 hours"), or the literal word "permanent"
`{expires}`	Formatted date, or "never" for a permanent punishment
`{time}`	Formatted date the punishment was issued
`{id}`	The punishment's database id — usable with `/unban <id>` etc.

Death message placeholders

Used in lang/deathmessages.yml:

Placeholder	Meaning
`{player}`	The victim's name
`{killer}`	The attacking player's name, a mob's custom name if it has one, or a formatted entity type ("Wither Skeleton") otherwise

Only the pvp category and specific mob categories actually use {killer} — environmental death categories (fall, lava, void, etc.) only ever use {player}, since there's no attacking entity.

Discord webhook placeholders

Used in config.yml's discord.title and discord.description templates:

discord:
  title: "{type} — {player}"
  description: "**Reason:** {reason}\n**By:** {punisher}\n**Duration:** {duration}"

Placeholder	Meaning
`{type}`	BAN / MUTE / WARN / JAIL
`{player}`, `{punisher}`, `{reason}`, `{duration}`	Same meaning as the punishment placeholders above

The reports webhook is different — it POSTs structured JSON, not a text template, so there's nothing to placeholder-fill there. See Integrations → Reports webhook for its exact field names.

Previous← Permissions NextIntegrations →