PlaceholderAPI Variables

ArcPass provides extensive PlaceholderAPI variables for use in scoreboards, chat, holograms, and more.

Requirements

PlaceholderAPI 2.11.0+

ArcPass automatically registers its expansion on startup.

Variable List

Player Data

Variable	Description	Example
`%arcpass_level%`	Current level	`25`
`%arcpass_exp%`	Total XP	`5000`
`%arcpass_experience%`	Total XP (alias)	`5000`
`%arcpass_total_exp%`	Total XP (alias)	`5000`
`%arcpass_current_exp%`	Current level XP	`75`
`%arcpass_required_exp%`	XP to next level	`150`
`%arcpass_exp_to_level%`	XP to level (alias)	`150`
`%arcpass_progress%`	Progress percentage	`50.0`
`%arcpass_progress_bar%`	Progress bar (10 chars)	`§a█████§7█████`

Tier Information

Variable	Description	Example
`%arcpass_tiers%`	Owned tiers	`free, premium`
`%arcpass_unlocked_tiers%`	Owned tiers (alias)	`free, premium`
`%arcpass_tier_count%`	Number of tiers owned	`2`
`%arcpass_has_premium%`	Has premium tier	`true`
`%arcpass_has_tier_<tier>%`	Has specific tier	`true` / `false`

Quest Information

Variable	Description	Example
`%arcpass_quests_completed%`	Completed quests	`42`
`%arcpass_quest_<quest_id>%`	Quest progress	`5/10`

Reward Information

Variable	Description	Example
`%arcpass_rewards_claimed%`	Claimed rewards	`38`

Season Information

Variable	Description	Example
`%arcpass_season%`	Season name	`Season 1`
`%arcpass_season_name%`	Season name (alias)	`Season 1`
`%arcpass_season_number%`	Season number	`1`
`%arcpass_season_status%`	Season status	`ACTIVE`
`%arcpass_season_time_remaining%`	Time remaining	`7d 12h`

Leaderboard

Variable	Description	Example
`%arcpass_rank%`	Level rank	`5`
`%arcpass_rank_level%`	Level rank (alias)	`5`
`%arcpass_rank_exp%`	XP rank	`3`
`%arcpass_rank_experience%`	XP rank (alias)	`3`
`%arcpass_rank_season%`	Season rank	`10`

Usage Examples

Scoreboard (FeatherBoard)

lines:
  - "&6Pass Level: &e%arcpass_level%"
  - "&7XP: &f%arcpass_current_exp%&7/&f%arcpass_required_exp%"
  - "&7Progress: %arcpass_progress_bar%"
  - ""
  - "&6Season: &e%arcpass_season_name%"
  - "&7Remaining: &f%arcpass_season_time_remaining%"

Chat Format (EssentialsX Chat)

format: "[Lv.%arcpass_level%] {DISPLAYNAME}: {MESSAGE}"

Tab List (TAB)

tablist:
  header:
    - "&6=== Battle Pass ==="
    - "&7Level: &e%arcpass_level% &7| XP: &e%arcpass_exp%"

Hologram (HolographicDisplays)

&6Pass Leaderboard
&7#1 &e{top_player_1} &7- Lv.{top_level_1}
&7#2 &e{top_player_2} &7- Lv.{top_level_2}
&7#3 &e{top_player_3} &7- Lv.{top_level_3}
&7...
&7Your Rank: &e%arcpass_rank%

Progress Bar Customization

Default progress bar uses 10 characters:

Completed: §a█
Remaining: §7█

Use %arcpass_progress% with other plugins for custom progress bars.

Conditional Variables

Use with condition plugins:

condition: "%arcpass_has_premium% == true"

Caching

For performance, some variables are cached:

Variable Type	Cache Duration
Player data	Real-time
Leaderboard ranks	2 minutes
Season info	1 minute

Leaderboard ranks show ... while loading.

Troubleshooting

Variable Shows Raw Text

Confirm PlaceholderAPI is installed
Check console for registration success
Test with /papi parse me %arcpass_level%

Variable Shows Empty

Confirm player is online
For season variables, confirm active season exists
Check variable name spelling (case-sensitive)

Rank Shows ?

Leaderboard data is loading. Wait a moment and refresh.

Getting started

Setup guide

Configuration

Usage

Developer API

Help

PlaceholderAPI Variables

Requirements

Variable List

Player Data

Tier Information

Quest Information

Reward Information

Season Information

Leaderboard

Usage Examples

Scoreboard (FeatherBoard)

Chat Format (EssentialsX Chat)

Tab List (TAB)

Hologram (HolographicDisplays)

Progress Bar Customization

Conditional Variables

Caching

Troubleshooting

Variable Shows Raw Text

Variable Shows Empty

Rank Shows ?

​Requirements

​Variable List

​Player Data

​Tier Information

​Quest Information

​Reward Information

​Season Information

​Leaderboard

​Usage Examples

​Scoreboard (FeatherBoard)

​Chat Format (EssentialsX Chat)

​Tab List (TAB)

​Hologram (HolographicDisplays)

​Progress Bar Customization

​Conditional Variables

​Caching

​Troubleshooting

​Variable Shows Raw Text

​Variable Shows Empty

​Rank Shows ?

Requirements

Variable List

Player Data

Tier Information

Quest Information

Reward Information

Season Information

Leaderboard

Usage Examples

Scoreboard (FeatherBoard)

Chat Format (EssentialsX Chat)

Tab List (TAB)

Hologram (HolographicDisplays)

Progress Bar Customization

Conditional Variables

Caching

Troubleshooting

Variable Shows Raw Text

Variable Shows Empty

Rank Shows ?