Integrations
PlaceholderAPI, Paper, Folia, and metrics support.
Overview
SimpleTeams auto-detects supported plugins at startup. All integrations are optional — the plugin works fully without any of them installed.
PlaceholderAPI
When PlaceholderAPI is installed, SimpleTeams automatically registers its expansion. This exposes team data as placeholders that can be used in any PAPI-compatible plugin (scoreboards, TAB, chat formats, etc.).
Use %simpleteams_<placeholder>% in any compatible plugin.
Paper API
On Paper servers, SimpleTeams uses AsyncChatEvent for chat formatting and rendering. All messages are sent through the Adventure API using MiniMessage format.
This provides clean, rich text output without legacy colour codes.
Folia
SimpleTeams detects Folia at runtime and uses region-aware scheduling for async and sync tasks. Folia support is built-in — no extra configuration required.
The plugin falls back to standard Bukkit scheduler on non-Folia servers.
Placeholders
Available placeholders when PlaceholderAPI is installed:
| Placeholder | Description |
|---|---|
| %simpleteams_has_team% | "true" or "false" |
| %simpleteams_team% | Team name |
| %simpleteams_team_plain% | Team prefix stripped of formatting |
| %simpleteams_prefix% | Plain text prefix |
| %simpleteams_prefix_formatted% | MiniMessage-formatted prefix |
| %simpleteams_rank% | Player's rank display name (e.g., "Member") |
| %simpleteams_rank_name% | Player's rank enum name (e.g., "MEMBER") |
| %simpleteams_leader% | Leader's player name |
| %simpleteams_size% | Member count |
| %simpleteams_max_size% | Max member limit |
| %simpleteams_description% | Team description |
| %simpleteams_color% | Team colour code |
| %simpleteams_status% | "Open" or "Closed" |
| %simpleteams_motd% | Team MOTD |
| %simpleteams_created% | Creation date (yyyy-MM-dd) |
Metrics
SimpleTeams includes bStats for anonymous usage statistics. This tracks total team count to help understand plugin adoption.
Metrics can be disabled by setting bstats.enabled: false in config.yml.