Scoreboard¶
MRTImposterUs draws its own sidebar scoreboard. You don't need TAB or PlaceholderAPI for it. The board changes with the situation:
| Board | Shown when |
|---|---|
hub |
in the hub / lobby world, not in a match |
waiting |
in an arena's waiting lobby |
countdown |
the match is about to start |
match |
playing (role reveal, free play) |
meeting |
a meeting is running (discussion or voting) |
ghost |
dead or ejected, finishing the tasks as a ghost |
ending |
end-of-match screen |
Admins watching a match with /iu admin spectate get no plugin sidebar. Outside a match the sidebar doesn't replace another plugin's scoreboard.
Every board is personal: what one player sees is never sent to anyone else. That is why the board can show your own role (<role>) and your kill cooldown without spoiling the game.
Settings: config.yml¶
scoreboard:
enabled: true # false = no plugin scoreboard (e.g. you keep TAB's)
update-ticks: 10 # refresh rate (20 = 1 second), minimum 5
hub-worlds: [] # worlds with the "hub" board; empty = the lobby world
date-format: 'dd/MM/yyyy'
server-address: 'play.yourserver.com' # the <server> placeholder
boards: # turn single boards on/off
hub: true
waiting: true
countdown: true
match: true
meeting: true
ghost: true
ending: true
Only one sidebar at a time
If you use the TAB plugin, turn off its scoreboard feature or set scoreboard.enabled: false here (and build your board in TAB with the %imposterus_*% placeholders and %imposterus_board%). TAB's tab list, name tags and other features keep working.
Your personal board keeps the name colours, the hidden name tags and the glow colours: the teams of the main scoreboard (this plugin's and other plugins') are copied into it whenever they change.
Texts: languages/messages_<lang>.yml¶
Titles and lines live in the scoreboard.boards section of the messages file, so they follow the plugin language:
scoreboard:
boards:
match:
title: '<gradient:#ff4d4d:#c51111><bold>ImposterUs</bold></gradient>'
lines:
- '<gray>Map <dark_gray>» <white><arena>'
- '<gray>Role <dark_gray>» <role>'
- ''
- '<gray>Tasks <dark_gray>» <green><tasks_percent>%'
- '<kill_status>'
- '<sabotage_status>'
- Formatting is MiniMessage, like the rest of the plugin.
- At most 15 lines.
''is an empty spacer line.- A line made only of placeholders that ends up empty is hidden. Lines with any literal text stay. For example,
<kill_status>disappears for crewmates, and<sabotage_status>disappears when no sabotage is running. - With
messages.smallcaps: truethe literal text becomes small caps (placeholder values never do). - With PlaceholderAPI installed, any
%placeholder%works too (its value is inserted as plain text). - Apply changes with
/iu reload.
The texts of a few placeholders are in the same section: none, role-hidden, comms-hidden, kill-ready, kill-cooldown, sabotage-active, sabotage-timer, meeting-discussion, meeting-voting, winner-crew, winner-impostor, winner-none, result-win, result-lose.
Placeholders¶
Always available:
| Placeholder | Value |
|---|---|
<player> |
player name |
<online> |
online players |
<date> |
today's date (date-format) |
<server> |
your server address (scoreboard.server-address) |
<level> <xp> <coins> |
progression |
<xp_progress> <xp_target> <xp_percent> |
XP in the current level, XP needed, percent |
<wins> <wins_crew> <wins_impostor> |
lifetime wins (total, as crewmate, as impostor) |
<kills_total> <deaths> <games> |
lifetime stats |
<kd> <winrate> <tasks_completed> |
lifetime stats |
In an arena or match (outside one they show - or 0):
| Placeholder | Value |
|---|---|
<arena> |
arena name |
<state> |
match state (Waiting, Countdown, In progress, Meeting...) |
<players> <max_players> <min_players> <needed> |
queue |
<countdown> |
seconds to the start |
<impostors> |
impostors of the match (before the reveal: how many there will be) |
<alive> <ghosts> |
living players / dead players |
<color> |
your suit colour, in its colour |
<role> |
your role, translated; ? (role-hidden) before the reveal |
<kills> |
your kills in this match |
<kill_status> |
impostors only: "Kill » ready" or "Kill » 12s"; empty for the crew |
<kill_cooldown> |
seconds to your next kill |
<emergencies> |
emergency meetings you have left |
<tasks_percent> <tasks_done> <tasks_total> |
crew task progress |
<tasks_bar> |
10-segment task bar |
<my_tasks> |
your tasks, e.g. 3/6 |
<sabotage> |
running sabotage (name) or - |
<sabotage_timer> |
seconds left of a critical sabotage (0 without a countdown) |
<sabotage_status> |
"⚠ Reactor 25s" while a sabotage runs; empty otherwise |
<meeting_phase> |
Discussion / Voting |
<meeting_time> |
seconds left of the current meeting phase |
<voted> <voters> |
living players who already voted / living players |
<winner> |
end screen: Crewmates / Impostors / Nobody |
<result> |
end screen: Victory / Defeat for you |
<xp_earned> <coins_earned> |
end screen: the reward of this match |
While communications are sabotaged the task placeholders (<tasks_percent>, <tasks_done>, <tasks_total>, <tasks_bar>, <my_tasks>) show ? (comms-hidden), exactly like the task bar.
Don't reveal kills
The default match board does not show <alive> or <ghosts>: knowing how many players are still alive would tell everyone a kill just happened. The meeting board shows them, since a meeting reveals the dead anyway.