StellaPlaceholders
##Introduction
Placeholders let you display dynamic information about teams, players and the plugin's global state anywhere that supports PlaceholderAPI — chat, scoreboards, holograms, tab list, custom messages, etc.
INFO
Requires PlaceholderAPI to be installed. Stella registers the stella expansion automatically when PlaceholderAPI is detected — no extra setup needed.
When a value can't be resolved (unknown team or player), the placeholder returns the literal string
null.
##Supported Placeholders
###Global
| Placeholder | Description | Returned Format |
|---|---|---|
| %stella_total_teams% | Total number of registered teams. | Integer (e.g. 3) |
| %stella_total_players% | Number of distinct players that belong to at least one team. | Integer (e.g. 12) |
| %stella_all_teams% | Comma-separated list of every team id. | String (e.g. red, blue, yellow) |
###About the player viewing the placeholder
| Placeholder | Description | Returned Format |
|---|---|---|
| %stella_team% | Id of the player's main team (highest priority). | String or null |
| %stella_team_display% | Display name of the player's main team. | String or null |
| %stella_team_priority% | Priority of the player's main team. | Integer or null |
| %stella_team_color% | Hex color of the player's main team. | String or null |
| %stella_in_any_team% | Whether the player belongs to any team. | Boolean (true / false) |
| %stella_team_count% | How many teams the player belongs to. | Integer |
| %stella_teams_list% | Comma-separated list of every team the player belongs to, highest priority first. | String or none |
| %stella_in_team_<team>% | Whether the player belongs to a specific team. | Boolean (true / false) |
###About another player (by name)
| Placeholder | Description | Returned Format |
|---|---|---|
| %stella_player_team_<player>% | Id of <player>'s main team. |
String or null |
| %stella_player_team_display_<player>% | Display name of <player>'s main team. |
String or null |
| %stella_player_team_count_<player>% | How many teams <player> belongs to. |
Integer or null |
| %stella_player_in_any_team_<player>% | Whether <player> belongs to any team. |
Boolean or null |
| %stella_player_in_team_<player>:<team>% | Whether <player> belongs to <team>. Note the : separator. |
Boolean or null |
###About a specific team
| Placeholder | Description | Returned Format |
|---|---|---|
| %stella_exists_<team>% | Whether <team> exists. |
Boolean (true / false) |
| %stella_display_<team>% | Display name of <team>. |
String or null |
| %stella_priority_<team>% | Priority of <team>. |
Integer or null |
| %stella_color_<team>% | Hex color of <team>. |
String or null |
| %stella_size_<team>% | Number of members in <team>. |
Integer or null |
##How to use these placeholders
Drop the placeholder anywhere PlaceholderAPI processes input. Stella replaces it with the live value at render time.
- The "player viewing" placeholders need a player context — they only resolve when one exists (chat, player-bound scoreboards, etc.). In console contexts they return
null. - The "about another player" and "about a team" placeholders are context-free and work anywhere.
##Example configuration
chat-format: "%stella_team_display% &7| &f%player_name%: %message%"
sidebar-line: "Your team: %stella_team% (priority %stella_team_priority%)"
admin-list: "Teams: %stella_all_teams% — %stella_total_players% players in total"
ally-check: "Is xDrygo in red? %stella_player_in_team_xDrygo:red%"##Compatibility with PlaceholderAPI
If PlaceholderAPI is installed, the integration is automatic — no extra configuration needed. Just place the placeholders wherever you want them and Stella handles the rest.