Placeholders
Hephaestus provides a set of PlaceholderAPI-compatible placeholders that allow you to display rank and tag information in supported plugins such as scoreboards, chat formats, tab lists, and holograms.
These placeholders always reflect the player’s currently active state, including contexts, disguises, and overrides.
Available Placeholders
Active Rank
| Placeholder | Description |
|---|---|
%hephaestus_active_rank_name% |
Returns the display name of the player’s active rank |
%hephaestus_active_prefix% |
Returns the prefix of the player’s active rank |
%hephaestus_active_suffix% |
Returns the suffix of the player’s active rank |
%hephaestus_rank_weight% |
Returns the weight of the player’s active rank |
Tags
| Placeholder | Description |
|---|---|
%hephaestus_active_tag% |
Returns the player’s active tag, if one is set |
If the player does not have an active tag, this placeholder will return an empty value.
Notes
- All placeholders are context-aware and automatically update when a player’s rank, tag, or context changes.
- These placeholders are safe to use in:
- Chat formatting plugins
- Scoreboards
- Tab lists
- Holograms
- Placeholders return formatted values, including color codes and styling.
Dependencies
- PlaceholderAPI is required for placeholder support.
- Hephaestus must be loaded and active on the server where placeholders are used.
Troubleshooting
If a placeholder is not resolving: 1. Ensure PlaceholderAPI is installed and up to date. 2. Confirm Hephaestus is running and enabled. 3. Reload PlaceholderAPI placeholders if required. 4. Verify the player has an active rank or tag.