🧩 PlaceholderAPI Integration
PlaceholderAPI support in ProgressiveUnlock is optional, but it allows you to display player-specific progression data (XP, level, etc.) in chat messages, scoreboards, holograms, signs, and other plugins that support PlaceholderAPI.
🔌 How to Enable PlaceholderAPI Support
- Make sure you have PlaceholderAPI installed on your server.
- ProgressiveUnlock will automatically register its placeholders when PlaceholderAPI is present.
- You do not need to install expansions manually for ProgressiveUnlock – it is integrated directly.
If PlaceholderAPI is not installed, the placeholders will simply not be parsed and shown as-is (e.g.
%progressiveunlock_xp%).
🏷️ Available Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
%progressiveunlock_xp% |
Player’s current XP | 135 |
%progressiveunlock_level% |
Player’s current level | 2 |
%progressiveunlock_requiredxp% |
XP required to reach the next level | 200 |
📌 Example Usages
📋 In Scoreboards
If you're using a scoreboard plugin like FeatherBoard or SimpleScore, you can add:
XP: %progressiveunlock_xp%
Level: %progressiveunlock_level%
Next Level in: %progressiveunlock_requiredxp% XP💬 In Chat Messages
With chat formatting plugins such as ChatControl or EssentialsChat:
[Level %progressiveunlock_level% | XP: %progressiveunlock_xp%/%progressiveunlock_requiredxp%] %player%: %message%🧱 On Signs
Using plugins that allow signs with placeholders (e.g., QuickBoard or PlaceholderSigns):
Line 1: [Progress]
Line 2: Level %progressiveunlock_level%
Line 3: XP: %progressiveunlock_xp%
Line 4: To next: %progressiveunlock_requiredxp%🧠 Summary
- 📦 Optional integration – plugin works without PlaceholderAPI
- 🧩 Dynamic placeholders for displaying XP, level, and required XP
- 🧰 Compatible with most plugins supporting PlaceholderAPI
Need a new placeholder or custom behavior? Feel free to suggest it!