> ## Documentation Index
> Fetch the complete documentation index at: https://www.kitemc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlaceholderAPI Variables

<span id="placeholderapi-variables" />

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

<h2 id="requirements">
  Requirements
</h2>

* PlaceholderAPI 2.11.0+

ArcPass automatically registers its expansion on startup.

<h2 id="variable-list">
  Variable List
</h2>

<h3 id="player-data">
  Player Data
</h3>

| 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█████` |

<h3 id="tier-information">
  Tier Information
</h3>

| 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` |

<h3 id="quest-information">
  Quest Information
</h3>

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

<h3 id="reward-information">
  Reward Information
</h3>

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

<h3 id="season-information">
  Season Information
</h3>

| 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` |

<h3 id="leaderboard">
  Leaderboard
</h3>

| 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` |

<h2 id="usage-examples">
  Usage Examples
</h2>

<h3 id="scoreboard-featherboard">
  Scoreboard (FeatherBoard)
</h3>

```yaml theme={null}
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%"
```

<h3 id="chat-format-essentialsx-chat">
  Chat Format (EssentialsX Chat)
</h3>

```yaml theme={null}
format: "[Lv.%arcpass_level%] {DISPLAYNAME}: {MESSAGE}"
```

<h3 id="tab-list-tab">
  Tab List (TAB)
</h3>

```yaml theme={null}
tablist:
  header:
    - "&6=== Battle Pass ==="
    - "&7Level: &e%arcpass_level% &7| XP: &e%arcpass_exp%"
```

<h3 id="hologram-holographicdisplays">
  Hologram (HolographicDisplays)
</h3>

```
&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%
```

<h2 id="progress-bar-customization">
  Progress Bar Customization
</h2>

Default progress bar uses 10 characters:

```
Completed: §a█
Remaining: §7█
```

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

<h2 id="conditional-variables">
  Conditional Variables
</h2>

Use with condition plugins:

```yaml theme={null}
condition: "%arcpass_has_premium% == true"
```

<h2 id="caching">
  Caching
</h2>

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.

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="variable-shows-raw-text">
  Variable Shows Raw Text
</h3>

1. Confirm PlaceholderAPI is installed
2. Check console for registration success
3. Test with `/papi parse me %arcpass_level%`

<h3 id="variable-shows-empty">
  Variable Shows Empty
</h3>

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

<h3 id="rank-shows">
  Rank Shows ?
</h3>

Leaderboard data is loading. Wait a moment and refresh.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.