Placeholders

PlaceholderAPI required

The integration module provides the %cobaltstaff_<id>% expansion. It registers automatically if PlaceholderAPI is installed; no /papi ecloud download is needed.

Testing a placeholder

/cobaltstaff placeholders                 lists all placeholders
/cobaltstaff placeholders <id> [player]   shows the value, for you or for a player

Player placeholders

They apply to the requesting player, or to another player by appending _<name>: %cobaltstaff_warn_score_Steve%.

Group	Ids
States	vanished, vanish_type, staffmode, staffmode_name, frozen, spectating, muted, banned, banned_ip, protected, investigated, traced, staffchat_channel
Active mute	mute_reason, mute_remaining, mute_end, mute_staff, mute_id
Active ban	ban_reason, ban_remaining, ban_end, ban_staff, ban_id
Record	warn_score, warns, warns_active, bans, mutes, kicks, infractions, notes
Reports	reports_on (active on the player), reports_total_on, reports_by (active, created by the player), reports_assigned
Misc	online_visible_for (online players this player can see)

Server counters

online_visible, staff_online, staff_in_mode, staff_vanished, frozen_count, reports_open, reports_in_progress, reports_active, tickets_open, tickets_in_progress, bans_active, mutes_active, bans_total, mutes_total, warns_total, kicks_total, infractions_total, investigations_open, chat_locked, chat_slow (in seconds).

Tip

online_visible counts online players without those who are vanished: ideal for a tab list or scoreboard that must not reveal the staff’s presence.

Recent sanctions

%cobaltstaff_<type>_latest_<n>_<field>[_<filters>]%

• <type>: sanction (all types), ban, mute, warn, kick.
• <n>: rank, 1 = most recent (50 max by default).
• <field>: id, type, reason, staff, target, duration, remaining, date, end, status, severity, points, removed_by, removed_reason.
• <filters> (separated by &): type=, severity=, staff=, target=, reason=, period=7d, active=true, expired=true, ip=true. A bare name (or me) reads that player’s whole record.

Example	Result
%cobaltstaff_warn_latest_1_reason_me%	Reason of your last warn
%cobaltstaff_ban_latest_1_target_period=1d%	Last player banned within 24 h
%cobaltstaff_sanction_latest_3_staff%	Staff member of the 3rd most recent sanction

Recent reports

%cobaltstaff_report_latest_<n>_<field>[_<filters>]%

Fields: id, kind, type, reason, reporter, target, status, assignee, date, age, server, closing_reason. Filters: those of /reports chercher (status=, type=, kind=, reporter=, assignee=, culprit=) and period=.

Settings

config/integration.yml

placeholders:
  enabled: true
  value-true: "true"         # text of a true state
  value-false: "false"       # text of a false state
  loading: "..."             # shown while loading a value from the database
  cache-seconds: 30          # validity of values read from the database
  max-cached-players: 500
  max-latest: 50             # maximum N of “latest” placeholders

Values coming from the database (record, totals, notes, closed reports) are loaded in the background and cached; they are also refreshed on every new sanction or report. States (vanish, mute, freeze…) are read from memory, instantly.

Reference

Filter

62 results

• %cobaltstaff_vanished[_<joueur>]%

  True if the player (the viewer, or <joueur>) is vanished.

• %cobaltstaff_vanish_type[_<joueur>]%

  The player's vanish type: TOTAL, LIST or PLAYER, empty if not vanished.

• %cobaltstaff_staffmode[_<joueur>]%

  True if the player (the viewer, or <joueur>) is in staff mode.

• %cobaltstaff_staffmode_name[_<joueur>]%

  Name of the player's active staff mode, empty if not in staff mode.

• %cobaltstaff_frozen[_<joueur>]%

  True if the player (the viewer, or <joueur>) is frozen.

• %cobaltstaff_spectating[_<joueur>]%

  True if the player (the viewer, or <joueur>) is spectating through staff mode.

• %cobaltstaff_online_visible%

  Number of online players who are not vanished.

• %cobaltstaff_online_visible_for[_<joueur>]%

  Number of online players visible to the player, taking into account their permission to see vanished players.

• %cobaltstaff_staff_online%

  Number of online staff members (cobaltstaff.member permission).

• %cobaltstaff_staff_in_mode%

  Number of staff members currently in staff mode.

• %cobaltstaff_staff_vanished%

  Number of online staff members who are vanished.

• %cobaltstaff_frozen_count%

  Number of players currently frozen.

• %cobaltstaff_staffchat_channel[_<joueur>]%

  Id of the staff chat channel the online player has toggled on (everything they type goes there), empty otherwise.

• %cobaltstaff_chat_locked%

  True if the chat is locked with /chat toggle.

• %cobaltstaff_chat_slow%

  Chat slow mode interval in seconds, 0 when disabled.

• %cobaltstaff_reports_open%

  Number of pending reports, tickets excluded.

• %cobaltstaff_reports_in_progress%

  Number of reports being handled, tickets excluded.

• %cobaltstaff_reports_active%

  Number of active reports (pending and being handled), tickets excluded.

• %cobaltstaff_tickets_open%

  Number of pending tickets.

• %cobaltstaff_tickets_in_progress%

  Number of tickets being handled.

• %cobaltstaff_reports_on[_<joueur>]%

  Number of active reports against the player (the viewer, or <joueur>).

• %cobaltstaff_reports_total_on[_<joueur>]%

  Total number of non-deleted reports ever made against the player.

• %cobaltstaff_reports_by[_<joueur>]%

  Number of active reports created by the player, tickets included.

• %cobaltstaff_reports_assigned[_<joueur>]%

  Number of reports currently being handled by this staff member.

• %cobaltstaff_report_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent report: <champ> = id, kind, type, reason, reporter, target, status, assignee, date, age, server or closing_reason.

• %cobaltstaff_muted[_<joueur>]%

  True if the player (the viewer, or <joueur>) has an active mute.

• %cobaltstaff_banned[_<joueur>]%

  True if the player has an active ban (on their account or IP).

• %cobaltstaff_banned_ip[_<joueur>]%

  True if the player's active ban is an IP ban.

• %cobaltstaff_mute_reason[_<joueur>]%

  Reason of the player's active mute, empty if not muted.

• %cobaltstaff_mute_remaining[_<joueur>]%

  Remaining time of the player's active mute, empty if not muted.

• %cobaltstaff_mute_end[_<joueur>]%

  End date of the player's active mute, empty if not muted.

• %cobaltstaff_mute_staff[_<joueur>]%

  Staff member (or console) who issued the player's active mute.

• %cobaltstaff_mute_id[_<joueur>]%

  Sanction id of the player's active mute, empty if not muted.

• %cobaltstaff_ban_reason[_<joueur>]%

  Reason of the player's active ban, empty if not banned.

• %cobaltstaff_ban_remaining[_<joueur>]%

  Remaining time of the player's active ban, empty if not banned.

• %cobaltstaff_ban_end[_<joueur>]%

  End date of the player's active ban, empty if not banned.

• %cobaltstaff_ban_staff[_<joueur>]%

  Staff member (or console) who issued the player's active ban.

• %cobaltstaff_ban_id[_<joueur>]%

  Sanction id of the player's active ban, empty if not banned.

• %cobaltstaff_bans_active%

  Number of active bans on the server.

• %cobaltstaff_mutes_active%

  Number of active mutes on the server.

• %cobaltstaff_warn_score[_<joueur>]%

  Sum of points of the player's warns that still count (not expired, not overturned on appeal).

• %cobaltstaff_warns[_<joueur>]%

  Total number of warns in the player's record.

• %cobaltstaff_warns_active[_<joueur>]%

  Number of the player's warns that still count toward their score.

• %cobaltstaff_bans[_<joueur>]%

  Total number of bans in the player's record.

• %cobaltstaff_mutes[_<joueur>]%

  Total number of mutes in the player's record.

• %cobaltstaff_kicks[_<joueur>]%

  Total number of kicks in the player's record.

• %cobaltstaff_infractions[_<joueur>]%

  Total number of sanctions of all types in the player's record.

• %cobaltstaff_bans_total%

  Total number of bans ever issued on the server.

• %cobaltstaff_mutes_total%

  Total number of mutes ever issued on the server.

• %cobaltstaff_kicks_total%

  Total number of kicks ever issued on the server.

• %cobaltstaff_warns_total%

  Total number of warns ever issued on the server.

• %cobaltstaff_infractions_total%

  Total number of sanctions of all types ever issued on the server.

• %cobaltstaff_sanction_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent sanction of any type; <filtres> separated by & (type=, severity=, period=7d…) or a player name to read their record.

• %cobaltstaff_ban_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent ban: <champ> = id, reason, staff, target, duration, remaining, date, end, status…

• %cobaltstaff_mute_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent mute: <champ> = id, reason, staff, target, duration, remaining, date, end, status…

• %cobaltstaff_kick_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent kick: <champ> = id, reason, staff, target, date, status…

• %cobaltstaff_warn_latest_<n>_<champ>[_<filtres>]%

  Field of the Nth most recent warn: <champ> = id, reason, staff, target, severity, points, remaining, end, status…

• %cobaltstaff_protected[_<joueur>]%

  True if the player is protected with /protectplayer.

• %cobaltstaff_investigated[_<joueur>]%

  True if an investigation is open on the player.

• %cobaltstaff_traced[_<joueur>]%

  True if the player is being traced with /trace.

• %cobaltstaff_investigations_open%

  Number of open investigations.

• %cobaltstaff_notes[_<joueur>]%

  Number of public notes recorded on the player.