🧍 Playerlist (TAB)
Player List customizes the TAB menu with configurable header, footer, and player name formatting. Supports live placeholders, rank prefixes/suffixes from both Discord roles and the Auto‑Rank system.
To enable: set
enablePlayerList: true in general.json. Configure in playerlist.json.
Jump to
📋 Header & Footer
The TAB list header and footer each have 3 configurable lines. Use § color codes and placeholders:
Placeholders
| Placeholder | Description |
|---|---|
%online% |
Current online player count |
%max% |
Maximum player slots |
%tps% |
Server TPS |
%ping% |
Player’s ping in ms |
%playtime% |
Player’s playtime in hours |
%time% |
Current server time |
%memory% |
JVM memory usage |
Default header
§b§l✦ VOIDIUM SERVER ✦
§7Online: §a%online%§7/§a%max%
Default footer
§7TPS: §a%tps%
§7Ping: §e%ping%ms
👤 Player names
Name format
Player names in TAB are formatted using playerNameFormat:
%rank_prefix%%player_name%%rank_suffix%
Rank sources
Voidium combines ranks from multiple sources:
- Discord roles — prefix/suffix from
rolePrefixesindiscord.json - Time-based ranks — from the Auto-Rank system (
ranks.json)
When combineMultipleRanks is true, all applicable prefixes/suffixes are combined. When false, only the highest priority is used.
Default prefix/suffix
Players without any rank get defaultPrefix and defaultSuffix (default: §7 gray and empty).
⚙️ Configuration
File: config/voidium/playerlist.json
| Field | Type | Default | Description |
|---|---|---|---|
enableCustomPlayerList |
boolean | true |
Master switch |
headerLine1 |
string | §b§l✦ VOIDIUM SERVER ✦ |
Header line 1 |
headerLine2 |
string | §7Online: §a%online%§7/§a%max% |
Header line 2 |
headerLine3 |
string | "" |
Header line 3 |
footerLine1 |
string | §7TPS: §a%tps% |
Footer line 1 |
footerLine2 |
string | §7Ping: §e%ping%ms |
Footer line 2 |
footerLine3 |
string | "" |
Footer line 3 |
enableCustomNames |
boolean | true |
Enable player name formatting |
playerNameFormat |
string | %rank_prefix%%player_name%%rank_suffix% |
Name format template |
defaultPrefix |
string | §7 |
Fallback prefix |
defaultSuffix |
string | "" |
Fallback suffix |
combineMultipleRanks |
boolean | true |
Combine all ranks or use highest only |
updateIntervalSeconds |
int | 5 |
Update interval (min 3) |
Related
- Auto-Rank — time-based rank system
- Discord — role prefixes
- Configuration