Placeholders
Use plugin's placeholders in other plugins or within the plugin's config files.
PlaceholderAPI is a plugin for Spigot and Paper servers that allows server owners to display data from
various plugins with a standardized format. The format, which is called an external placeholder,
is an identifier surrounded by percent signs % and will be replaced with the provided data from the plugin.
XenoScavenger contains it's own external placeholders that can be used in other plugins. See the table below for a list of available placeholders. Before adding a placeholder to another plugin, ensure the plugin supports PlaceholderAPI.
Available placeholders
External placeholders
These placeholders can be used in any plugin that supports PlaceholderAPI.
Basic Player Placeholders
| Placeholder | Description | Example output |
|---|---|---|
%xsc_player_name% | Player's name (player.getName()). | Klema_LP |
%xsc_player_total_finds% | Total collectibles found by the player. | 42 |
%xsc_player_rank% | Player's personal rank in the global leaderboard. | 10 |
Category Placeholders
| Placeholder | Description | Example output |
|---|---|---|
%xsc_category_name_<id>% | Display name of the <id> category. | &a&lChristmas Event 2025 |
%xsc_category_total_<id>% | Number of collectibles in <id> category. | 10 |
%xsc_category_start_<id>% | Time until start/countdown (if configured). | 7d 5h 30m |
%xsc_category_end_<id>% | Time until end/countdown (if configured). | 7d 5h 30m |
Player Progress in Category
| Placeholder | Description | Example output |
|---|---|---|
%xsc_player_collected_<id>% | Number collected by player in <id> category. | 5 |
%xsc_player_percent_<id>% | Percent completed in <id> category. | 69% |
%xsc_player_completed_<id>% | Has the player completed <id> category (Yes/No). | Yes |
Item-Specific Placeholders
| Placeholder | Description | Example output |
|---|---|---|
%xsc_item_status_<id>_<item>% | Status of <item> in <id> category (Found/Hidden) for the player. | Hidden |
Leaderboard placeholders
These placeholders are used as a global leaderboard. Position in category leaderboard is not supported yet.
| Placeholder | Description | Example output |
|---|---|---|
%xsc_top_name_<position>% | Name of player on the Xth position. | Klema_LP |
%xsc_top_finds_<position>% | Finds by player on the Xth position. | 1 |
Commands & Permissions
List all commands and permissions available for players and admins.
Categories
Create different categories as events and plan your next event easily.
Last updated on