Configuration

The configuration is split by module. Each file is created on first start and never overwritten afterwards; a missing key falls back to its default value. Apply your changes with /cobaltstaff reload [module].

Overview

File	Content
config.yml	General settings: language, database, hierarchy, limits, menus, notifications, alerts, modules
commands.yml, commands/<module>.yml	Command names, aliases, permissions and activation
config/sanctions.yml	Warns, severities, thresholds, bans, IP bans, mutes, kicks, /sanction menu, appeals, record, import
config/reports.yml	Reports, tickets, types and reasons, evidence, notifications, channels, hooks
config/staffmode.yml	Staff mode, vanish, spectate, freeze, random TP, staff list, staff hub
config/investigation.yml	Examine, silent chests, player profile, CPS, trace, notes, investigations, alts, TP, protections, revive (inventory copies)
config/chat.yml	Staff chat, chat module, blacklist, detections, blocked commands, alerts, X-ray, GrimAC, join messages
config/integration.yml	PlaceholderAPI placeholders
staffmode/modes.yml	Staff modes and inheritance
staffmode/modules.yml	Staff mode hotbar items
staffmode/custom-modules.yml	Custom staff mode items
bans/*.txt	Ban screen templates
lang/*.yml	FR and EN texts, see Messages and languages

config.yml

General

server-name: myserver            # kept in the history
language: en                     # fr or en
date-format: "dd/MM/yyyy HH:mm"
timezone: Europe/Paris
database:
  type: sqlite                   # SQLite only for now
  file: data.db
offline-players-mode: true       # sanctions, reports, examine, notes on offline players

Hierarchy and limits

ranks:                           # from lowest to highest
  - guide
  - moderateur
  - supermodo
  - responsable
  - admin
default-limits: {}               # limit when a staff member has no <prefix>.<duration> permission

See Staff hierarchy and Limits and cooldowns.

Commands and menus

commands:
  override-existing: true        # replaces same-name commands from other plugins
  hide-vanished-in-tab: true     # hides vanished players from completion
gui:
  glass-color: light_blue        # glass pane colour; each staff member can pick their own
  hide-without-permission: false # buttons without permission: greyed (false) or hidden (true)
  chat-input-timeout: 2m         # time to answer a chat input

Notifications and alerts

notifications:
  staff-mode-only: true          # staff notifications only received in staff mode
alerts:
  sound: {name: block.note_block.pling, volume: 1.0, pitch: 1.6}
  sounds: {}                     # per-type sound, e.g. xray: {name: block.note_block.bell, ...}
  console: false                 # copy alerts to the console
audit:
  page-size: 10
modules:                         # enable / disable each module
  sanctions: true
  reports: true
  staffmode: true
  investigation: true
  chat: true
  integration: true

Staff chat and personal messages are always received, even outside staff mode.

Module options

Each module’s options are detailed on its page:

• Sanctions — config/sanctions.yml
• Reports and tickets — config/reports.yml
• Staff mode — config/staffmode.yml and staffmode/*.yml
• Investigations and tools — config/investigation.yml
• Chat and alerts — config/chat.yml
• Placeholders — config/integration.yml

Durations

Throughout the configuration, durations are written 30s, 10m, 2h, 7d, 2w, 1M, 1y, or combined (1d12h). An empty value or perm means “never” or “permanent” depending on context.

Items

item and material fields accept a Minecraft material (diamond_sword) or a Nexo item id if Nexo is installed.

Hooks (automatic actions)

Several features run configurable commands: warn thresholds, warn actions, appeals, report lifecycle, investigations, freeze, chat detections, staff mode entry and exit. They all share the same format:

actions:
  - command: "tempban %target% 1d Warn threshold (%score% points) -silent"
    executor: console                 # console, or a role from the context (e.g. issuer)
    executor-run-strategy: ONLINE     # ONLINE (default), DELAY or ALWAYS
    target: target                    # targeted role
    target-run-strategy: ALWAYS       # ALWAYS (default), ONLINE or DELAY
    filters: "severity=GRAVE"         # optional
    rollback-command: "unban %target% Warn cancelled -silent"

Field	Role
command	Command to run, without /, with %…% variables
executor	Who runs the command: console or a role from the context
executor-run-strategy	ONLINE: only if the executor is online; ALWAYS: always; DELAY: on their next login
target, target-run-strategy	Same logic for the targeted player
filters	Conditions: key=value, key=a,b, key!=value, permission=<perm>, separated by ;
rollback-command	Undo command (warn deleted, appeal accepted)

Note

A DELAY action is stored in the database and run one second after the player’s next login, even after a server restart.

Variables by feature:

Feature	Variables
Sanctions (thresholds, actions, appeals)	%target% %target_uuid% %issuer% %reason% %severity% %score% %points% %threshold% %id%
Reports	%id% %type% %reason% %reporter% %culprit% %assigned% %issuer% %status% %kind% %hasculprit%
Investigations	%target% %investigator% %issuer% %id%
Freeze	%target% %issuer%
Phrase detection	%player% %phrases%
Command detection	%player% %command%
Staff mode	%player% %mode%

All keys

Reference of keys and their default values, filterable by file:

Filter

429 results

• server-nameFile config.ymlDefault cobaltia

  Server name (kept in the history, no multi-server support).

• languageFile config.ymlDefault fr

  Text language: fr or en (files lang/<langue>.yml and lang/<module>.<langue>.yml).

• date-formatFile config.ymlDefault dd/MM/yyyy HH:mm

  Format of displayed dates (Java pattern, e.g. dd/MM/yyyy HH:mm).

• timezoneFile config.ymlDefault Europe/Paris

  Time zone used to display dates (e.g. Europe/Paris).

• database.typeFile config.ymlDefault sqlite

  sqlite only for now (mysql planned).

• database.fileFile config.ymlDefault data.db

  Name of the SQLite database file, in the plugin folder.

• offline-players-modeFile config.ymlDefault true

  Offline players: sanctions, reports, examine and notes on disconnected players.

• ranksFile config.ymlDefault ["guide","moderateur","supermodo","responsable","developpeur","admin"]

  Staff hierarchy, from lowest to highest. A staff member's rank = the highest cobaltstaff.rank.<nom> they have. You can only target (ban, mute, kick, warn, freeze, examine) lower ranks.

• default-limitsFile config.ymlDefault {}

  Default cap when a staff member has no <prefixe>.<durée> permission (absent = no cap). Key = permission prefix without "cobaltstaff.".

• commands.override-existingFile config.ymlDefault true

  Replaces commands with the same name from other plugins (LiteBans, CMI...).

• commands.hide-vanished-in-tabFile config.ymlDefault true

  Hides vanished players from tab completion.

• gui.glass-colorFile config.ymlDefault light_blue

  Default glass pane color (white, orange, magenta, light_blue, yellow, lime, pink, gray, light_gray, cyan, purple, blue, brown, green, red, black). Each staff member can pick their own.

• gui.hide-without-permissionFile config.ymlDefault false

  Buttons without permission: false = greyed out, true = hidden.

• gui.chat-input-timeoutFile config.ymlDefault 2m

  Time allowed to answer a chat input prompt.

• notifications.staff-mode-onlyFile config.ymlDefault true

  Staff notifications (reports, sanctions, appeals, /alerts alerts, alt accounts, X-ray, investigations...) received only in staff mode. Outside staff mode: nothing (staff chat and personal messages are still sent).

• alerts.sound.nameFile config.ymlDefault block.note_block.pling

  Sound played when an alert is received (Minecraft sound key, none = no sound).

• alerts.sound.volumeFile config.ymlDefault 1

  Volume of the alert sound.

• alerts.sound.pitchFile config.ymlDefault 1.6

  Pitch of the alert sound.

• alerts.soundsFile config.ymlDefault {}

  Sound per alert type, e.g. xray: {name: block.note_block.bell, volume: 1.0, pitch: 1.0}

• alerts.consoleFile config.ymlDefault false

  Copy alerts to the console.

• audit.page-sizeFile config.ymlDefault 10

  Number of entries per page in the /cobaltstaff audit log.

• modules.sanctionsFile config.ymlDefault true

  Enables the sanctions module (ban, mute, kick, warn) if present in the build.

• modules.reportsFile config.ymlDefault true

  Enables the reports and tickets module if present in the build.

• modules.staffmodeFile config.ymlDefault true

  Enables the staff mode module (vanish, freeze, spectate) if present in the build.

• modules.investigationFile config.ymlDefault true

  Enables the investigation module (investigations, notes, protection, trace) if present in the build.

• modules.chatFile config.ymlDefault true

  Enables the chat module (staff chat, blacklist, detections, alerts) if present in the build.

• modules.integrationFile config.ymlDefault true

  Enables the integration module (PlaceholderAPI placeholders) if present in the build.

• staff-chat.channels.<id>.commandFile config/chat.ymlDefault sc

  Send command of channel <id> (also creates /<command>-mute and /<command>-sound); without a message, toggles chat to this channel.

• staff-chat.channels.<id>.aliasesFile config/chat.ymlDefault ["staffchat"]

  Aliases of the channel <id> command.

• staff-chat.channels.<id>.permissionFile config/chat.ymlDefault cobaltstaff.staffchat.staff

  Permission to read and write in channel <id>.

• staff-chat.channels.<id>.prefixFile config/chat.ymlDefault <gradient:#6FE2E8:#6180C9><b>ꜱᴛᴀꜰꜰ</b></gradient>

  Prefix of channel <id> in MiniMessage, used by the <prefixe> tag of the format.

• staff-chat.channels.<id>.formatFile config/chat.yml

  Message format of channel <id> in MiniMessage (<prefixe>, <joueur>, <message>); empty = language file format.

• staff-chat.channels.<id>.shortcutFile config/chat.ymlDefault @

  Character at the start of a message to write in channel <id> without a command, empty = none.

• staff-chat.channels.<id>.sound.nameFile config/chat.ymlDefault block.note_block.hat

  Sound played when a message is received in channel <id> (Minecraft sound key, none = no sound).

• staff-chat.channels.<id>.sound.volumeFile config/chat.ymlDefault 0.6

  Volume of the channel <id> receive sound.

• staff-chat.channels.<id>.sound.pitchFile config/chat.ymlDefault 1.6

  Pitch of the channel <id> receive sound.

• chat.clear-linesFile config/chat.ymlDefault 100

  Number of blank lines sent by /chat clear.

• chat.clear-keep-staffFile config/chat.ymlDefault true

  Staff (cobaltstaff.chat.clear permission) keep their chat history during a /chat clear.

• blacklist.enabledFile config/chat.ymlDefault true

  Enables the filter for forbidden words, characters and links.

• blacklist.chatFile config/chat.ymlDefault true

  Where to filter.

• blacklist.signsFile config/chat.ymlDefault true

  Applies the filter to signs.

• blacklist.anvilsFile config/chat.ymlDefault true

  Applies the filter to names set in an anvil.

• blacklist.booksFile config/chat.ymlDefault true

  Applies the filter to books.

• blacklist.censor-characterFile config/chat.ymlDefault *

  Replacement character.

• blacklist.block-messageFile config/chat.ymlDefault false

  true = block the whole message instead of censoring it (chat only).

• blacklist.hover-uncensoredFile config/chat.ymlDefault true

  Staff with cobaltstaff.blacklist.see-uncensored see the original message on hover (chat).

• blacklist.alertFile config/chat.ymlDefault true

  blacklist-detection alert sent to subscribers.

• blacklist.mergingFile config/chat.ymlDefault true

  Detect a forbidden word hidden inside another word. False positives go into allowed-words.

• blacklist.wordsFile config/chat.ymlDefault […]

  Forbidden words (case, accents, leet digits, repeated letters and spaced letters handled).

• blacklist.allowed-wordsFile config/chat.yml

  Words never censored (merging false positives).

• blacklist.charactersFile config/chat.ymlDefault ["卐","卍","ꖦ"]

  Forbidden characters, detected anywhere.

• blacklist.domainsFile config/chat.yml

  Links: detected domain endings (with a real dot or a fake dot).

• blacklist.periodsFile config/chat.ymlDefault ["(dot)","[dot]","{dot}","(point)","[point]","()","[]","{}","(.)","[.]"," dot "," point "]

  Fake dots (« site(dot)com », « site () fr »).

• blacklist.allowed-linksFile config/chat.ymlDefault ["cobaltia.fr"]

  Links always allowed.

• phrase-detection.enabledFile config/chat.ymlDefault true

  Enables phrase detection in chat (whole words, ignoring case, accents and punctuation).

• phrase-detection.groups.triche.phrasesFile config/chat.ymlDefault ["x-ray","kill aura","autoclick","auto clicker","hack client"]

  Watched phrases of the triche (cheating) group.

• phrase-detection.groups.triche.alertFile config/chat.ymlDefault true

  Sends the chat-phrase-detection alert when a phrase of the triche group is detected.

• phrase-detection.groups.triche.block-messageFile config/chat.ymlDefault false

  Blocks the message that contains a phrase of the triche group.

• phrase-detection.groups.triche.actionsFile config/chat.ymlDefault []

  Actions (commands) run on detection for the triche group, placeholders %player% and %phrases%.

• phrase-detection.groups.pub.phrasesFile config/chat.ymlDefault ["rejoignez mon serveur","venez sur mon serveur","mon discord"]

  Watched phrases of the pub (advertising) group.

• phrase-detection.groups.pub.alertFile config/chat.ymlDefault true

  Sends the chat-phrase-detection alert when a phrase of the pub group is detected.

• phrase-detection.groups.pub.block-messageFile config/chat.ymlDefault true

  Blocks the message that contains a phrase of the pub group.

• phrase-detection.groups.pub.actionsFile config/chat.ymlDefault []

  Actions (commands) run on detection for the pub group, placeholders %player% and %phrases%.

• command-detection.enabledFile config/chat.ymlDefault true

  Enables detection of sensitive commands (aliases resolved, minecraft: prefix included).

• command-detection.groups.permissions.commandsFile config/chat.ymlDefault ["op","deop","lp user","lp group","lp editor"]

  Watched commands of the permissions group.

• command-detection.groups.permissions.alertFile config/chat.ymlDefault true

  Sends the command-detection alert when a command of the permissions group is used.

• command-detection.groups.permissions.actionsFile config/chat.ymlDefault []

  Actions run when a command of the permissions group is used, placeholders %player% and %command%.

• command-detection.groups.serveur.commandsFile config/chat.ymlDefault ["stop","restart","reload","plugman"]

  Watched commands of the serveur (server) group.

• command-detection.groups.serveur.alertFile config/chat.ymlDefault true

  Sends the command-detection alert when a command of the serveur group is used.

• command-detection.groups.serveur.actionsFile config/chat.ymlDefault []

  Actions run when a command of the serveur group is used, placeholders %player% and %command%.

• blocked-commandsFile config/chat.ymlDefault ["op","deop","stop","restart","reload","lp editor"]

  Forbidden for staff who have the cobaltstaff.block permission.

• blocked-mode-commandsFile config/chat.ymlDefault ["give","i","item","kit","kits","sell","ah","hdv","pay","trade","enchant","repair","xp"]

  Forbidden in staff mode (no items or money gained through staff mode).

• alerts.click-commandFile config/chat.ymlDefault /tp %player%

  Command run when clicking an alert that targets a player (%player%), empty = none.

• alerts.types.<id>.enabledFile config/chat.ymlDefault true

  Enables alert type <id> (namechange, mention, xray, alt-detects, chat-phrase-detection, command-detection, blacklist-detection, grimac).

• alerts.types.<id>.consoleFile config/chat.ymlDefault true

  Also copies alerts of type <id> to the console, in addition to config.yml > alerts.console.

• mention.require-atFile config/chat.ymlDefault false

  With « @ » only (true) or plain name accepted too (false).

• xray.ignore-creativeFile config/chat.ymlDefault true

  Ignores blocks mined in creative mode for the X-ray alert.

• xray.blocksFile config/chat.yml

  Blocks watched by the X-ray alert: BLOCK (every time), BLOCK:N (at the Nth) or BLOCK:N:duration (N within the time span).

• xray.nexo-blocksFile config/chat.ymlDefault ["amethyste_ore:8:5m","ruby_ore:6:5m","opale_ore:4:5m"]

  Custom Nexo ores (Nexo item id), same format. Listens to the Nexo event when Nexo is present.

• grimac.enabledFile config/chat.ymlDefault true

  Relays GrimAC anticheat alerts to staff (grimac alert).

• grimac.min-violationsFile config/chat.ymlDefault 0

  Minimum violations before relaying.

• grimac.cooldownFile config/chat.ymlDefault 10s

  Delay between two relays for the same player and the same check.

• grimac.ignore-checksFile config/chat.ymlDefault []

  Checks never relayed (check name, case-insensitive).

• join-messages.enabledFile config/chat.ymlDefault false

  Enables join messages broadcast according to the player's permission (none for a vanished player).

• join-messages.messages.<id>.permissionFile config/chat.ymlDefault cobaltstaff.join-message.admin

  Permission required for join message <id>, empty = everyone.

• join-messages.messages.<id>.weightFile config/chat.ymlDefault 100

  Priority of message <id>: when several messages apply, the highest weight wins.

• join-messages.messages.<id>.messageFile config/chat.ymlDefault  <gradient:#FF5A5A:#C81E1E><b>ᴀᴅᴍɪɴ</b></gradient> <gray><white><joueur><gray> vient de se connecter.

  Text of join message <id> in MiniMessage, <joueur> or %player% = the player's name.

• placeholders.enabledFile config/integration.ymlDefault true

  Enables the PlaceholderAPI placeholders %cobaltstaff_<id>%.

• placeholders.value-trueFile config/integration.ymlDefault true

  Texts for the true / false states.

• placeholders.value-falseFile config/integration.ymlDefault false

  Text displayed for a false state.

• placeholders.loadingFile config/integration.ymlDefault ...

  Displayed while a value is loading from the database (record, totals, notes, closed reports).

• placeholders.cache-secondsFile config/integration.ymlDefault 30

  How long these values stay valid (they are also refreshed on every sanction / report).

• placeholders.max-cached-playersFile config/integration.ymlDefault 500

  Players kept in cache (records, notes).

• placeholders.max-latestFile config/integration.ymlDefault 50

  Maximum N for the « Nth most recent » placeholders.

• examine.info.foodFile config/investigation.ymlDefault 1

  Position (1 to 9) of the hunger and health button in the /examine info row; 0 hides it.

• examine.info.ipFile config/investigation.ymlDefault 2

  Position (1 to 9) of the IP address button in the /examine info row; 0 hides it.

• examine.info.pingFile config/investigation.ymlDefault 3

  Position (1 to 9) of the ping button in the /examine info row; 0 hides it.

• examine.info.gamemodeFile config/investigation.ymlDefault 4

  Position (1 to 9) of the gamemode and flight button in the /examine info row; 0 hides it.

• examine.info.infractionsFile config/investigation.ymlDefault 5

  Position (1 to 9) of the record (infractions) button in the /examine info row; 0 hides it.

• examine.info.locationFile config/investigation.ymlDefault 6

  Position (1 to 9) of the player location button in the /examine info row; 0 hides it.

• examine.info.notesFile config/investigation.ymlDefault 7

  Position (1 to 9) of the player notes button in the /examine info row; 0 hides it.

• examine.info.freezeFile config/investigation.ymlDefault 8

  Position (1 to 9) of the freeze button in the /examine info row; 0 hides it.

• examine.info.warnFile config/investigation.ymlDefault 9

  Position (1 to 9) of the warn button in the /examine info row; 0 hides it.

• examine.armor-glassFile config/investigation.ymlDefault ORANGE_STAINED_GLASS_PANE

  Glass pane separating armor / offhand from the rest.

• examine.sync-ticksFile config/investigation.ymlDefault 1

  Sync rate of online views (ticks), active only while a view is open.

• examine.commands.infractionsFile config/investigation.ymlDefault infractions !%player%

  Command run as the staff member by the /examine record button (%player% = examined player).

• examine.commands.freezeFile config/investigation.ymlDefault freeze %player%

  Command run as the staff member by the /examine freeze button (%player% = examined player).

• examine.commands.warnFile config/investigation.ymlDefault warn %player% %reason%

  Command run as the staff member by the /examine warn button, after typing the reason in chat (%player%, %reason%).

• silent-chests.enabledFile config/investigation.ymlDefault true

  In staff mode: open containers without animation or sound.

• silent-chests.also-when-vanishedFile config/investigation.ymlDefault false

  Also when the staff member is vanished outside staff mode.

• silent-chests.allow-editFile config/investigation.ymlDefault true

  Edit the contents (in addition to the cobaltstaff.mode.silent-chest-interaction permission).

• silent-chests.blocksFile config/investigation.ymlDefault ["CHEST","TRAPPED_CHEST","BARREL","HOPPER","DISPENSER","DROPPER","SHULKER_BOX","*_SHULKER_BOX"]

  Affected blocks ("*_SHULKER_BOX" = every block ending with _SHULKER_BOX).

• players.miners-yFile config/investigation.ymlDefault 30

  "Miners" list: online players below this layer.

• players.detail.cache-secondsFile config/investigation.ymlDefault 30

  Full profile (holdings read from Cobaltia, CMI, PhoenixCrates, LuckPerms, CobaltiaEffets): kept in memory for this many seconds ("refresh" button to reload immediately).

• players.detail.placeholders.reportsFile config/investigation.ymlDefault %cobaltstaff_reports_total_on%

  PlaceholderAPI placeholder evaluated for the target player, shown as the report counter on their profile (empty = "?").

• players.detail.placeholders.warnsFile config/investigation.ymlDefault %cobaltstaff_warn_score%

  Placeholder for the warn score on the player profile, used as a fallback when the sanctions module is absent (empty = "?").

• players.detail.placeholders.kicksFile config/investigation.ymlDefault %cobaltstaff_kicks%

  Placeholder for the kick count on the player profile, used as a fallback when the sanctions module is absent (empty = "?").

• players.detail.placeholders.banipFile config/investigation.ymlDefault %cobaltstaff_banned_ip%

  Placeholder for the IP ban status on the player profile, used as a fallback when the sanctions module is absent (empty = "?").

• players.commands.freezeFile config/investigation.ymlDefault freeze %player%

  Command run as the staff member by the player profile freeze button (%player% = target player).

• players.commands.spectateFile config/investigation.ymlDefault spec %player%

  Command run as the staff member by the player profile spectate button (%player% = target player).

• players.commands.infractionsFile config/investigation.ymlDefault infractions !%player%

  Command run as the staff member by the player profile record button (%player% = target player).

• players.commands.sanctionFile config/investigation.ymlDefault sanction %player%

  Used only if the sanctions module (sanction menu) is absent.

• cps.durationFile config/investigation.ymlDefault 10s

  Length of a /cps test on a player (e.g. 10s); an invalid value falls back to 10 seconds.

• cps.thresholdFile config/investigation.ymlDefault 16

  Alert above this number of clicks per second.

• trace.outputFile config/investigation.ymlDefault ["CHAT","FILE"]

  CHAT and / or FILE.

• trace.folderFile config/investigation.ymlDefault traces

  Log folder (inside plugins/CobaltStaff).

• trace.eventsFile config/investigation.yml

  COMMAND, CHAT, BLOCK_BREAK, BLOCK_PLACE, INTERACT, DAMAGE_DEALT, DAMAGE_TAKEN, PICKUP, DROP, WORLD_CHANGE, INVENTORY_OPEN

• notes.notify-on-createFile config/investigation.ymlDefault true

  Notify staff (cobaltstaff.player-notes.notifications permission) on every public note.

• investigations.max-concurrentFile config/investigation.ymlDefault 1

  Investigations open at the same time on the same player (0 = unlimited).

• investigations.allow-offlineFile config/investigation.ymlDefault true

  Investigate an offline player.

• investigations.enforce-staff-modeFile config/investigation.ymlDefault true

  Force staff mode on open / resume (if the staff member is not already in it; staffmode module required).

• investigations.staff-modeFile config/investigation.ymlDefault Enquete

  Mode from staffmode/modes.yml to enforce (absent = mode picked by weight for this staff member).

• investigations.pause-on-target-logoutFile config/investigation.ymlDefault true

  Automatic pause.

• investigations.pause-on-staff-mode-exitFile config/investigation.ymlDefault true

  Pauses the investigation when the investigator leaves staff mode.

• investigations.notify-target.chatFile config/investigation.ymlDefault true

  Notifies the target player with a chat message when an investigation starts or resumes.

• investigations.notify-target.action-barFile config/investigation.ymlDefault true

  Shows the target player a reminder in the action bar for as long as the investigation is running.

• investigations.hooks.startFile config/investigation.ymlDefault []

  Actions (hooks) run when an investigation is opened or resumed (%target%, %investigator%, %issuer%, %id%).

• investigations.hooks.pauseFile config/investigation.ymlDefault []

  Actions (hooks) run when an investigation is paused (%target%, %investigator%, %issuer%, %id%).

• investigations.hooks.concludeFile config/investigation.ymlDefault []

  Actions (hooks) run when an investigation is concluded (%target%, %investigator%, %issuer%, %id%).

• alt-detect.enabledFile config/investigation.ymlDefault true

  Enables alt account detection on join (skipped with the cobaltstaff.altdetect.bypass permission).

• alt-detect.same-ip-requiredFile config/investigation.ymlDefault true

  Nothing is flagged without a shared IP.

• alt-detect.name-checkFile config/investigation.ymlDefault true

  Compare usernames (≥ 90 % = 4 pts, ≥ 70 % = 3, ≥ 50 % = 2, ≥ 30 % = 1; same IP = +1).

• alt-detect.alert-levelsFile config/investigation.ymlDefault ["POSITIVE","FAIRLY_POSITIVE","POSSIBLE","SAME_IP"]

  Levels that trigger the "alt-detects" alert: POSITIVE, FAIRLY_POSITIVE, POSSIBLE, NOT_LIKELY, SAME_IP.

• teleport.locations.<id>.worldFile config/investigation.ymlDefault world

  World of the predefined teleport location (<id> = location name, used by /tplieu and the -T<location> argument).

• teleport.locations.<id>.xFile config/investigation.ymlDefault 0.5

  X coordinate of the predefined teleport location <id>.

• teleport.locations.<id>.yFile config/investigation.ymlDefault 100

  Y coordinate of the predefined teleport location <id>.

• teleport.locations.<id>.zFile config/investigation.ymlDefault 0.5

  Z coordinate of the predefined teleport location <id>.

• teleport.locations.<id>.yawFile config/investigation.ymlDefault 0

  Horizontal rotation (yaw) applied on arrival at location <id>.

• teleport.locations.<id>.pitchFile config/investigation.ymlDefault 0

  Vertical rotation (pitch) applied on arrival at location <id>.

• staff-locations.icons[].itemFile config/investigation.ymlDefault COMPASS

  Item of an icon offered for staff locations (material or Nexo id); the first one is the default icon.

• staff-locations.icons[].nameFile config/investigation.ymlDefault <white>Lieu

  Display name of the staff location icon, in MiniMessage format.

• protect.area-max-sizeFile config/investigation.ymlDefault 50

  Max size of /protectarea create (blocks on each side of the center).

• inventory.revive.max-backupsFile config/investigation.ymlDefault 10

  Backups kept per player (deaths + clears).

• inventory.revive.save-on-deathFile config/investigation.ymlDefault true

  Backs up the player's inventory on death (unless keepInventory applies) so it can be restored.

• claim-requires-staff-modeFile config/reports.ymlDefault false

  Staff mode is required to claim a report.

• closing-reason-enabledFile config/reports.ymlDefault true

  Ask for a closing reason (resolved / rejected).

• show-reporterFile config/reports.ymlDefault true

  Show the reporter in staff lists.

• purge-deletedFile config/reports.ymlDefault false

  Deletion: false = the report becomes DELETED (hidden everywhere, history kept); true = erased from the database.

• require-reasonFile config/reports.ymlDefault true

  Reason required when no predefined reason exists (otherwise asked in chat).

• reason-max-lengthFile config/reports.ymlDefault 120

  Maximum length of a report reason, in characters (minimum 8).

• max-open-per-playerFile config/reports.ymlDefault 3

  Maximum active reports (pending + claimed) per player (0 = unlimited).

• deny-duplicatesFile config/reports.ymlDefault true

  Refuse a 2nd active report from the same reporter on the same player.

• evidence.chat.enabledFile config/reports.ymlDefault true

  Attach the reported player's latest messages.

• evidence.chat.messagesFile config/reports.ymlDefault 10

  Number of the reported player's latest messages attached to the report.

• evidence.chat.max-ageFile config/reports.ymlDefault 15m

  Older messages are not attached.

• evidence.culprit-positionFile config/reports.ymlDefault true

  Record the reported player's location (if online).

• reporter-notifications.statusesFile config/reports.ymlDefault ["IN_PROGRESS","RESOLVED","REJECTED"]

  Statuses notified to the reporter (OPEN = report reopened).

• reporter-notifications.on-joinFile config/reports.ymlDefault true

  On join: reminder of their active reports and missed changes.

• staff-notifications.permissionFile config/reports.ymlDefault cobaltstaff.reports.manage.view

  Permission to receive new reports (tickets: tickets.manage).

• staff-notifications.update-permissionFile config/reports.ymlDefault cobaltstaff.reports.update.notifications

  Permission for status changes.

• staff-notifications.sound.nameFile config/reports.ymlDefault block.note_block.bell

  Sound played to staff when a new report arrives (Minecraft sound id).

• staff-notifications.sound.volumeFile config/reports.ymlDefault 1

  Volume of the new report notification sound.

• staff-notifications.sound.pitchFile config/reports.ymlDefault 1.2

  Pitch of the new report notification sound.

• staff-notifications.on-joinFile config/reports.ymlDefault true

  Message when a staff member joins if reports are still pending.

• staff-notifications.on-join-delayFile config/reports.ymlDefault 3s

  Delay after a staff member joins before the pending reports message (e.g. 3s).

• staff-notifications.action-bar.enabledFile config/reports.ymlDefault true

  Action bar reminder for staff in staff mode as long as reports are pending.

• staff-notifications.action-bar.intervalFile config/reports.ymlDefault 30s

  Interval between two action bar reminders of pending reports (minimum 5 seconds).

• channels.enabledFile config/reports.ymlDefault false

  Enables the dedicated discussion channel for each report (/rc).

• channels.open-onFile config/reports.ymlDefault ["IN_PROGRESS"]

  Automatically opened at these statuses, automatically closed at those.

• channels.close-onFile config/reports.ymlDefault ["RESOLVED","REJECTED","DELETED"]

  Report statuses that automatically close its discussion channel.

• tickets.enabledFile config/reports.ymlDefault true

  Enables tickets (/ticket), requests sent to staff without a reported player.

• tickets.max-open-per-playerFile config/reports.ymlDefault 2

  Maximum number of tickets a player can have open at the same time.

• tickets.message-max-lengthFile config/reports.ymlDefault 200

  Maximum length of a ticket message, in characters (minimum 8).

• menus.db-limitFile config/reports.ymlDefault 270

  Maximum number of reports loaded for the "closed" lists, search and /reports <player>.

• hooks.create-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a report is created (%id%, %type%, %reason%, %reporter%, %culprit%, %status%...).

• hooks.accept-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a staff member claims a report.

• hooks.reopen-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a report is reopened.

• hooks.resolve-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a report is resolved.

• hooks.reject-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a report is rejected.

• hooks.delete-commandsFile config/reports.ymlDefault []

  Actions (hooks) run when a report is deleted.

• actions.spectateFile config/reports.ymlDefault spec %player%

  Command of the spectate button in report management (%player% = reported player, empty = button hidden).

• actions.examineFile config/reports.ymlDefault examine %player%

  Command of the examine button in report management (%player% = reported player, empty = button hidden).

• actions.freezeFile config/reports.ymlDefault freeze %player%

  Command of the freeze button in report management (%player% = reported player, empty = button hidden).

• actions.infractionsFile config/reports.ymlDefault infractions !%player%

  Command of the record button in report management (%player% = reported player, empty = button hidden).

• actions.notesFile config/reports.ymlDefault notes %player%

  Command of the notes button in report management (%player% = reported player, empty = button hidden).

• actions.investigateFile config/reports.ymlDefault investigate !%player%

  Command of the investigation button in report management (%player% = reported player, empty = button hidden).

• fixed-reasonFile config/reports.ymlDefault false

  No type or reason: free reason. Types only: type menu. Reasons only (root reasons section): reason from the command, otherwise menu (fixed-reason: true = always the menu). Types + reasons: type menu then reason. culprit: true = only for a report on a player, false = only without a player, absent = both. custom: true = the reason asks the player for text. item: material or Nexo id.

• reasonsFile config/reports.ymlDefault {}

  Root report reasons, used when no type is defined (same format as a type's reasons).

• types.<id>.nameFile config/reports.ymlDefault <gradient:#FF5A5A:#C81E1E><b>ᴛʀɪᴄʜᴇ</b></gradient>

  Display name of the report type in the menu (<id> = type id, e.g. triche), in MiniMessage format.

• types.<id>.descriptionFile config/reports.ymlDefault ["<gray>Cheat, client modifié, X-ray,","<gray>macro ou autoclick."]

  Description lines of the report type shown in the menu (MiniMessage).

• types.<id>.itemFile config/reports.ymlDefault iron_sword

  Icon of the report type in the menu (material or Nexo id).

• types.<id>.culpritFile config/reports.ymlDefault true

  true = type offered only for a report on a player, false = only without a player, absent = both.

• types.<id>.reasons.<id>.nameFile config/reports.ymlDefault <white>Cheat de combat

  Display name of a reason of the report type (second <id> = reason id), in MiniMessage format.

• types.<id>.reasons.<id>.descriptionFile config/reports.ymlDefault ["<gray>Killaura, reach, aimbot..."]

  Description lines of the reason shown in the menu (MiniMessage).

• types.<id>.reasons.<id>.itemFile config/reports.ymlDefault diamond_sword

  Icon of the reason in the menu (material or Nexo id).

• types.<id>.reasons.<id>.customFile config/reports.ymlDefault true

  true = choosing this reason asks the player to describe what happened in chat.

• types.<id>.reasons.<id>.culpritFile config/reports.ymlDefault true

  true = reason offered only for a report on a player, false = only without a player, absent = both.

• announceFile config/sanctions.ymlDefault true

  Public announcement of sanctions (ban, mute, kick, warn) to all players, except with -silent.

• banned-login-alert.enabledFile config/sanctions.ymlDefault true

  Alerts staff (cobaltstaff.bans.notifications permission) when a banned player tries to join.

• banned-login-alert.cooldownFile config/sanctions.ymlDefault 1m

  At most one alert per player within this delay.

• warnings.threshold-modeFile config/sanctions.ymlDefault ALL

  ALL: each warn re-triggers every reached threshold (Staff++); HIGHEST: only the highest; CROSSED: only those crossed by this warn.

• warnings.always-notifyFile config/sanctions.ymlDefault false

  Join notification: false = only unread warns; true = on every join while active warns remain.

• warnings.show-issuerFile config/sanctions.ymlDefault true

  Show the player which staff member warned them.

• warnings.show-next-thresholdFile config/sanctions.ymlDefault true

  The warn message shows the score and the next threshold ("4/5 points, next: ban 1 day").

• warnings.sound.nameFile config/sanctions.ymlDefault entity.villager.no

  Sound played to the player who receives a warn ("none" = no sound).

• warnings.sound.volumeFile config/sanctions.ymlDefault 1

  Volume of the sound played to the warned player.

• warnings.sound.pitchFile config/sanctions.ymlDefault 0.8

  Pitch of the sound played to the warned player.

• warnings.severities.<id>.scoreFile config/sanctions.ymlDefault 1

  Points added to the warn score by a warn of this severity (<id> = LEGER, MOYEN, GRAVE, CRITIQUE by default).

• warnings.severities.<id>.expires-afterFile config/sanctions.ymlDefault 2w

  Time before a warn of this severity expires (e.g. 2w, 1M); empty = never expires.

• warnings.severities.<id>.reasonFile config/sanctions.yml

  Default reason for this severity, allowing a warn without typing a reason.

• warnings.severities.<id>.reason-overwrite-enabledFile config/sanctions.ymlDefault true

  Allows staff to replace this severity's default reason.

• warnings.severities.<id>.itemFile config/sanctions.ymlDefault lime_dye

  Icon of the severity in the selection menu (material or Nexo id).

• warnings.thresholds[].scoreFile config/sanctions.ymlDefault 3

  Warn score from which the threshold triggers its actions.

• warnings.thresholds[].labelFile config/sanctions.ymlDefault mute 1 h

  Threshold text shown to the player as the next sanction (e.g. mute 1 h).

• warnings.thresholds[].actions[].commandFile config/sanctions.ymlDefault tempmute %target% 1h Palier de warns (%score% points) -silent

  Command run when the threshold is reached (%target%, %score%, %points%, %threshold%...).

• warnings.thresholds[].actions[].rollback-commandFile config/sanctions.ymlDefault unmute %target% Warn annulé -silent

  Rollback command run if the warn is removed or its appeal is accepted.

• warnings.actionsFile config/sanctions.ymlDefault []

  Actions run on every warn (filterable by severity), linked to the warn when it is created.

• warnings.appeals.enabledFile config/sanctions.ymlDefault true

  Lets players appeal their warns.

• warnings.appeals.fixed-reasonFile config/sanctions.ymlDefault false

  Appeal reason must be chosen from the list (otherwise free text).

• warnings.appeals.reasonsFile config/sanctions.ymlDefault []

  List of offered warn appeal reasons (enforced when fixed-reason is true).

• warnings.appeals.resolve-reason-enabledFile config/sanctions.ymlDefault true

  Reason required to approve / reject.

• warnings.appeals.on-approved-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a warn appeal is approved.

• warnings.appeals.on-rejected-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a warn appeal is rejected.

• bans.default-template-permFile config/sanctions.ymlDefault permanent

  Default screen templates (bans/<name>.txt files).

• bans.default-template-tempFile config/sanctions.ymlDefault temporaire

  Default screen template for temporary bans (bans/<name>.txt file).

• bans.fixed-reasonsFile config/sanctions.ymlDefault {}

  Fixed reasons: as soon as one exists, no more free reason (/ban <player> <name>). Without a reason: selection menu. ban-type: PERM_BAN or TEMP_BAN (duration required).

• bans.appeals.enabledFile config/sanctions.ymlDefault true

  Lets players appeal their bans.

• bans.appeals.fixed-reasonFile config/sanctions.ymlDefault false

  Ban appeal reason must be chosen from the reasons list (otherwise free text).

• bans.appeals.reasonsFile config/sanctions.ymlDefault []

  List of offered ban appeal reasons.

• bans.appeals.resolve-reason-enabledFile config/sanctions.ymlDefault true

  Reason required to approve or reject a ban appeal.

• bans.appeals.unban-on-approveFile config/sanctions.ymlDefault true

  Automatically unbans the player when their appeal is approved.

• bans.appeals.on-approved-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a ban appeal is approved.

• bans.appeals.on-rejected-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a ban appeal is rejected.

• ipbans.confirmationFile config/sanctions.ymlDefault GUI

  Confirmation with the list of affected players (last known IP): CHAT, GUI or DISABLED.

• ipbans.default-template-permFile config/sanctions.ymlDefault ip-permanent

  Default screen template for permanent IP bans (bans/<name>.txt file).

• ipbans.default-template-tempFile config/sanctions.ymlDefault ip-temporaire

  Default screen template for temporary IP bans (bans/<name>.txt file).

• mutes.default-soft-mutesFile config/sanctions.ymlDefault false

  Soft mute by default (the player does not know they are muted; their messages are not sent but they see them).

• mutes.blocked-commandsFile config/sanctions.yml

  Commands blocked during a mute (multiple words allowed, e.g. "cmi msg").

• mutes.fixed-reasonsFile config/sanctions.ymlDefault {}

  Fixed reasons (same format as bans, mute-type PERM_MUTE / TEMP_MUTE).

• mutes.appeals.enabledFile config/sanctions.ymlDefault true

  Lets players appeal their mutes.

• mutes.appeals.fixed-reasonFile config/sanctions.ymlDefault false

  Mute appeal reason must be chosen from the reasons list (otherwise free text).

• mutes.appeals.reasonsFile config/sanctions.ymlDefault []

  List of offered mute appeal reasons.

• mutes.appeals.resolve-reason-enabledFile config/sanctions.ymlDefault true

  Reason required to approve or reject a mute appeal.

• mutes.appeals.unmute-on-approveFile config/sanctions.ymlDefault true

  Automatically unmutes the player when their appeal is approved.

• mutes.appeals.on-approved-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a mute appeal is approved.

• mutes.appeals.on-rejected-commandsFile config/sanctions.ymlDefault []

  Actions (hooks) run when a mute appeal is rejected.

• kicks.fixed-reasonFile config/sanctions.ymlDefault false

  true: free reason forbidden, choice from reasons only.

• kicks.reasonsFile config/sanctions.ymlDefault {}

  Predefined reasons: without a typed reason, selection menu (a single reason = applied directly).

• sanction-menu.reason-editableFile config/sanctions.ymlDefault true

  Allows editing a motive's default reason in the /sanction menu.

• sanction-menu.motifs.<id>.nameFile config/sanctions.ymlDefault <gradient:#FFD84A:#F29A00><b>Insultes</b></gradient>

  Display name of the motive in the /sanction menu (<id> = motive id, e.g. insultes), in MiniMessage format.

• sanction-menu.motifs.<id>.reasonFile config/sanctions.ymlDefault Insultes

  Default reason applied to this motive's sanctions.

• sanction-menu.motifs.<id>.itemFile config/sanctions.ymlDefault red_dye

  Icon of the motive in the /sanction menu (material or Nexo id).

• sanction-menu.motifs.<id>.loreFile config/sanctions.ymlDefault []

  Description lines of the motive shown in the menu (MiniMessage).

• sanction-menu.motifs.<id>.steps[].typeFile config/sanctions.ymlDefault WARN

  Sanction type of the step: WARN, MUTE, BAN or KICK.

• sanction-menu.motifs.<id>.steps[].severityFile config/sanctions.ymlDefault MOYEN

  Warn severity for a WARN step (LEGER, MOYEN, GRAVE, CRITIQUE by default).

• sanction-menu.motifs.<id>.steps[].durationFile config/sanctions.ymlDefault 1d

  Duration of a MUTE or BAN step (e.g. 1d); empty = permanent.

• import.litebans.warn-severityFile config/sanctions.ymlDefault LEGER

  Severity given to imported warns (LiteBans has no severity).

• infractions.types.<id>.showFile config/sanctions.ymlDefault true

  Shows this sanction type in the /infractions record (<id> = BAN, MUTE, WARN or KICK).

• infractions.types.<id>.itemFile config/sanctions.ymlDefault barrier

  Icon of this sanction type in the /infractions record (material or Nexo id).

• infractions.top-sizeFile config/sanctions.ymlDefault 28

  Size of the /infractions top leaderboard.

• staff-mode.announce-to-staffFile config/staffmode.ymlDefault false

  Action bar message on entering / leaving staff mode, announced to other staff (perm cobaltstaff.member).

• staff-mode.restore-on-shutdownFile config/staffmode.ymlDefault true

  Exits staff mode when the server stops or the plugin is reloaded: the saved state is restored.

• vanish.default-typeFile config/staffmode.ymlDefault TOTAL

  Default type for /vanish without a type: TOTAL (invisible + hidden from tab), LIST (hidden from tab only), PLAYER (invisible in game, stays in tab).

• vanish.keep-on-relogFile config/staffmode.ymlDefault true

  Keep vanish on reconnect (otherwise it is removed on disconnect).

• vanish.fake-messagesFile config/staffmode.ymlDefault true

  Fake quit message when going into vanish, fake join message when leaving it.

• vanish.hide-join-quitFile config/staffmode.ymlDefault true

  No join / quit message for a vanished player (staff with vanish.see are notified).

• vanish.chatFile config/staffmode.ymlDefault true

  The vanished player can talk in chat.

• vanish.reminderFile config/staffmode.ymlDefault BOSSBAR

  "You are vanished" reminder: BOSSBAR (no repeating task), ACTIONBAR (refreshed every 2 s) or NONE.

• vanish.silent-chestsFile config/staffmode.ymlDefault true

  Outside staff mode, a vanished player opens containers without animation or sound (staff mode has its own options).

• vanish.item-dropFile config/staffmode.ymlDefault false

  Outside staff mode, allows a vanished player to drop items (false = blocked).

• vanish.item-pickupFile config/staffmode.ymlDefault false

  Outside staff mode, allows a vanished player to pick up items (false = blocked).

• vanish.block-manipulationFile config/staffmode.ymlDefault true

  Outside staff mode, allows a vanished player to break and place blocks.

• vanish.cancelled-interaction-typesFile config/staffmode.ymlDefault ["PHYSICAL"]

  Interactions cancelled for a vanished player (PHYSICAL = pressure plates, tripwires, farmland).

• vanish.damageFile config/staffmode.ymlDefault false

  Outside staff mode, allows a vanished player to deal damage.

• vanish.invincibleFile config/staffmode.ymlDefault true

  Outside staff mode, a vanished player takes no damage.

• vanish.night-visionFile config/staffmode.ymlDefault true

  Gives night vision to a vanished player, removed when they leave vanish.

• vanish.mobs-ignoreFile config/staffmode.ymlDefault true

  Mobs do not target a vanished player (TOTAL and PLAYER).

• vanish.show-awayFile config/staffmode.ymlDefault true

  In /personnel, a vanished staff member appears "away" (instead of hidden) to those who cannot see them.

• spectate.return-to-locationFile config/staffmode.ymlDefault true

  Return to the previous location when leaving spectate.

• freeze.allowed-commandsFile config/staffmode.ymlDefault ["msg","r","tell","w"]

  Commands allowed while frozen (without /). /fc is always allowed.

• freeze.chatFile config/staffmode.ymlDefault true

  The frozen player can talk in chat.

• freeze.damage-receivedFile config/staffmode.ymlDefault false

  The frozen player can take damage.

• freeze.damage-dealtFile config/staffmode.ymlDefault false

  The frozen player can deal damage.

• freeze.titleFile config/staffmode.ymlDefault true

  Title + subtitle (texts in lang), reminder every <timer> seconds (0 = no reminder).

• freeze.timerFile config/staffmode.ymlDefault 10

  Interval in seconds between two reminders (title and sound) to the frozen player; 0 disables the reminder.

• freeze.sound.nameFile config/staffmode.ymlDefault block.note_block.bass

  Sound played to the frozen player along with the title (Minecraft sound key); empty or none = no sound.

• freeze.sound.volumeFile config/staffmode.ymlDefault 1

  Volume of the freeze sound (1.0 = normal volume).

• freeze.sound.pitchFile config/staffmode.ymlDefault 0.6

  Pitch of the freeze sound (1.0 = normal, lower = deeper).

• freeze.promptFile config/staffmode.ymlDefault false

  "Prompt" window (paper with the message) that reopens as long as the player is frozen.

• freeze.channelFile config/staffmode.ymlDefault true

  Freeze channel: opened automatically between the frozen player and staff, /fc to talk, closed on unfreeze.

• freeze.keep-on-relogFile config/staffmode.ymlDefault true

  Keep the freeze if the player disconnects (frozen again on reconnect).

• freeze.logout-commandsFile config/staffmode.ymlDefault []

  Actions when a frozen player disconnects (hooks: command, executor, filters...). Placeholders %target% %issuer%.

• freeze.freeze-commandsFile config/staffmode.ymlDefault []

  Actions (hooks) run when a player is frozen, same format as logout-commands.

• freeze.unfreeze-commandsFile config/staffmode.ymlDefault []

  Actions (hooks) run when a player is unfrozen, same format as freeze-commands.

• random-teleport.modeFile config/staffmode.ymlDefault RANDOM

  RANDOM = random player, ROTATION = each player in turn.

• random-teleport.exclude-staff-modeFile config/staffmode.ymlDefault true

  Only pick players who are not in staff mode.

• compass.velocityFile config/staffmode.ymlDefault 2

  Propulsion speed of the compass.

• counter.staff-mode-onlyFile config/staffmode.ymlDefault false

  The counter only shows staff who are in staff mode.

• reports-item.count-placeholderFile config/staffmode.ymlDefault %cobaltstaff_reports_open%

  Number of pending reports shown in the Reports item name (PAPI placeholder, provided by the integration module). Empty = no number.

• personnel.show-modeFile config/staffmode.ymlDefault true

  Also show staff in staff mode / vanish.

• hub.rowsFile config/staffmode.ymlDefault 4

  Number of rows of the /staffhub menu, from 1 to 6.

• hub.buttons.<id>.slotFile config/staffmode.ymlDefault 10

  Position of the button in the /staffhub menu; <id> = button identifier (reports, bans, mutes, audit…).

• hub.buttons.<id>.materialFile config/staffmode.ymlDefault writable_book

  Material of the <id> button icon in the /staffhub menu.

• hub.buttons.<id>.commandFile config/staffmode.ymlDefault manage-reports

  Command run on click (plugin command id or raw name); if it does not exist, the button is marked unavailable.

• hub.buttons.<id>.permissionFile config/staffmode.ymlDefault cobaltstaff.reports.manage.view

  Permission required to use the <id> button of the /staffhub menu.

• hub.buttons.<id>.argsFile config/staffmode.ymlDefault audit

  Arguments added after the button command (e.g. audit for /cobaltstaff audit).

• ban-rapide.typeFile staffmode/custom-modules.ymlDefault COMMAND_DYNAMIC

  Custom module type: COMMAND_DYNAMIC runs the command as you on the targeted player (also COMMAND_STATIC, COMMAND_CONSOLE, ITEM).

• ban-rapide.materialFile staffmode/custom-modules.ymlDefault blaze_rod

  Material of the ban-rapide module item (Material or Nexo item id).

• ban-rapide.enchantedFile staffmode/custom-modules.ymlDefault true

  Adds the enchantment glint to the module item.

• ban-rapide.permissionFile staffmode/custom-modules.ymlDefault cobaltstaff.bans.tempban

  Permission required to use the ban-rapide item.

• ban-rapide.commandFile staffmode/custom-modules.ymlDefault tempban %clicked% 1d %input%

  Command run by the item; %clicked% = targeted player, %clicker% = you, %input% = typed text.

• ban-rapide.require-inputFile staffmode/custom-modules.ymlDefault true

  Asks for chat input before running the command; the text replaces %input%.

• ban-rapide.input-promptFile staffmode/custom-modules.ymlDefault staffmode.custom.ban-rapide.saisie

  Message shown to ask for input (language key or MiniMessage text).

• ban-rapide.confirmationFile staffmode/custom-modules.ymlDefault GUI

  Confirmation before running: GUI (menu), CHAT (answer yes) or NONE.

• ban-rapide.confirmation-messageFile staffmode/custom-modules.ymlDefault staffmode.custom.ban-rapide.confirmation

  Confirmation question shown (language key or MiniMessage text, same placeholders as the command).

• default.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode

  Permission required for the default mode, the base mode the other modes inherit from.

• default.weightFile staffmode/modes.ymlDefault 0

  Mode weight: /staff picks the highest-weight mode you have permission for.

• default.block-manipulationFile staffmode/modes.ymlDefault false

  Allows breaking and placing blocks in staff mode.

• default.inventory-interactionFile staffmode/modes.ymlDefault false

  Allows moving items in your inventory in staff mode (staff items stay locked).

• default.silent-chest-interactionFile staffmode/modes.ymlDefault false

  Allows editing containers opened silently (also requires cobaltstaff.mode.silent-chest-interaction).

• default.item-dropFile staffmode/modes.ymlDefault false

  Allows dropping items in staff mode.

• default.item-pickupFile staffmode/modes.ymlDefault false

  Allows picking up items in staff mode.

• default.vanish-typeFile staffmode/modes.ymlDefault TOTAL

  Vanish type of the mode: TOTAL, LIST, PLAYER or NONE.

• default.vanish-on-enterFile staffmode/modes.ymlDefault true

  Enables vanish (of type vanish-type) when entering staff mode.

• default.staff-see-staff-in-modeFile staffmode/modes.ymlDefault true

  Staff in staff mode can see each other, even while vanished.

• default.invincibleFile staffmode/modes.ymlDefault true

  In staff mode, you take no damage.

• default.damageFile staffmode/modes.ymlDefault false

  Allows dealing damage in staff mode.

• default.hunger-lossFile staffmode/modes.ymlDefault false

  Allows hunger loss in staff mode.

• default.flightFile staffmode/modes.ymlDefault true

  Enables flight in staff mode.

• default.creativeFile staffmode/modes.ymlDefault false

  Switches to creative game mode in staff mode.

• default.night-visionFile staffmode/modes.ymlDefault true

  Gives night vision in staff mode.

• default.original-locationFile staffmode/modes.ymlDefault true

  Returns you to your entry point when leaving staff mode.

• default.enable-on-loginFile staffmode/modes.ymlDefault false

  Automatically enters staff mode on login.

• default.disable-on-logoutFile staffmode/modes.ymlDefault false

  Leaves staff mode on logout (otherwise it is kept and restored on reconnect).

• default.disable-on-world-changeFile staffmode/modes.ymlDefault false

  Leaves staff mode when changing worlds.

• default.allowed-worldsFile staffmode/modes.ymlDefault []

  Worlds where the mode is allowed ([] = all).

• default.enable-commandsFile staffmode/modes.ymlDefault []

  Actions (hooks) run when entering staff mode; placeholders %player% and %mode%.

• default.disable-commandsFile staffmode/modes.ymlDefault []

  Actions (hooks) run when leaving staff mode; placeholders %player% and %mode%.

• default.initial-item-statesFile staffmode/modes.ymlDefault {}

  State of toggle items when entering staff mode (e.g. vanish: on or off).

• default.itemsFile staffmode/modes.ymlDefault {}

  Mode items, as <item id>: <slot> (0-8 = hotbar, 9-35 = inventory); empty for the default mode.

• Guide.extendsFile staffmode/modes.ymlDefault default

  Parent mode whose options and items Guide inherits (here default).

• Guide.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.guide

  Permission required to use the Guide mode.

• Guide.weightFile staffmode/modes.ymlDefault 10

  Weight of the Guide mode (10): /staff picks the highest-weight mode you have permission for.

• Guide.items.compassFile staffmode/modes.ymlDefault 0

  Slot of the compass in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Guide.items.random-teleportFile staffmode/modes.ymlDefault 1

  Slot of the random teleport item in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Guide.items.examineFile staffmode/modes.ymlDefault 4

  Slot of the examine item in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Guide.items.detailsFile staffmode/modes.ymlDefault 5

  Slot of the player details item in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Guide.items.reportsFile staffmode/modes.ymlDefault 7

  Slot of the Reports item in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Guide.items.counterFile staffmode/modes.ymlDefault 8

  Slot of the staff counter in the Guide mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Modo.extendsFile staffmode/modes.ymlDefault Guide

  Parent mode whose options and items Modo inherits (here Guide).

• Modo.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.modo

  Permission required to use the Modo mode.

• Modo.weightFile staffmode/modes.ymlDefault 20

  Weight of the Modo mode (20): /staff picks the highest-weight mode you have permission for.

• Modo.items.vanishFile staffmode/modes.ymlDefault 2

  Slot of the vanish item in the Modo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Modo.items.freezeFile staffmode/modes.ymlDefault 3

  Slot of the freeze item in the Modo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Modo.items.cpsFile staffmode/modes.ymlDefault 6

  Slot of the CPS item in the Modo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Modo.items.followFile staffmode/modes.ymlDefault 9

  Slot of the follow item in the Modo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Modo.items.spectateFile staffmode/modes.ymlDefault 10

  Slot of the spectate item in the Modo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• SuperModo.extendsFile staffmode/modes.ymlDefault Modo

  Parent mode whose options and items SuperModo inherits (here Modo).

• SuperModo.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.supermodo

  Permission required to use the SuperModo mode.

• SuperModo.weightFile staffmode/modes.ymlDefault 30

  Weight of the SuperModo mode (30): /staff picks the highest-weight mode you have permission for.

• SuperModo.silent-chest-interactionFile staffmode/modes.ymlDefault true

  Allows the SuperModo mode to edit containers opened silently (also requires cobaltstaff.mode.silent-chest-interaction).

• SuperModo.items.hubFile staffmode/modes.ymlDefault 8

  Slot of the staff hub item in the SuperModo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• SuperModo.items.counterFile staffmode/modes.ymlDefault 11

  Slot of the staff counter in the SuperModo mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Responsable.extendsFile staffmode/modes.ymlDefault SuperModo

  Parent mode whose options and items Responsable inherits (here SuperModo).

• Responsable.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.responsable

  Permission required to use the Responsable mode.

• Responsable.weightFile staffmode/modes.ymlDefault 40

  Weight of the Responsable mode (40): /staff picks the highest-weight mode you have permission for.

• Responsable.items.ban-rapideFile staffmode/modes.ymlDefault 12

  Slot of the ban-rapide item in the Responsable mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Admin.extendsFile staffmode/modes.ymlDefault Responsable

  Parent mode whose options and items Admin inherits (here Responsable).

• Admin.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.admin

  Permission required to use the Admin mode.

• Admin.weightFile staffmode/modes.ymlDefault 50

  Weight of the Admin mode (50): /staff picks the highest-weight mode you have permission for.

• Admin.creativeFile staffmode/modes.ymlDefault true

  The Admin mode switches to creative game mode.

• Admin.inventory-interactionFile staffmode/modes.ymlDefault true

  The Admin mode can move items in its inventory (staff items stay locked).

• Admin.allowed-worldsFile staffmode/modes.ymlDefault []

  Worlds where the Admin mode is allowed ([] = all).

• Enquete.extendsFile staffmode/modes.ymlDefault default

  Parent mode whose options and items Enquete inherits (here default).

• Enquete.permissionFile staffmode/modes.ymlDefault cobaltstaff.mode.enquete

  Permission required to use the Enquete mode.

• Enquete.weightFile staffmode/modes.ymlDefault -1

  Weight -1: the Enquete mode is never picked automatically (access via /staff -mode=Enquete with cobaltstaff.mode.specific, or through an investigation).

• Enquete.items.compassFile staffmode/modes.ymlDefault 0

  Slot of the compass in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.vanishFile staffmode/modes.ymlDefault 2

  Slot of the vanish item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.freezeFile staffmode/modes.ymlDefault 3

  Slot of the freeze item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.examineFile staffmode/modes.ymlDefault 4

  Slot of the examine item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.detailsFile staffmode/modes.ymlDefault 5

  Slot of the player details item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.cpsFile staffmode/modes.ymlDefault 6

  Slot of the CPS item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.spectateFile staffmode/modes.ymlDefault 7

  Slot of the spectate item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• Enquete.items.followFile staffmode/modes.ymlDefault 8

  Slot of the follow item in the Enquete mode (0-8 = hotbar, 9-35 = inventory), -1 removes an inherited item.

• compass.materialFile staffmode/modules.ymlDefault compass

  Material of the compass (propulsion) in staff mode (Material or Nexo item id).

• compass.permissionFile staffmode/modules.ymlDefault cobaltstaff.mode.compass

  Permission required to use the compass (propulsion).

• random-teleport.materialFile staffmode/modules.ymlDefault clock

  Material of the teleport-to-random-player item in staff mode (Material or Nexo item id).

• random-teleport.permissionFile staffmode/modules.ymlDefault cobaltstaff.mode.random-teleport

  Permission required to use the teleport-to-random-player item.

• vanish.material-onFile staffmode/modules.ymlDefault lime_dye

  Material of the vanish item when vanish is on (Material or Nexo item id).

• vanish.material-offFile staffmode/modules.ymlDefault gray_dye

  Material of the vanish item when vanish is off (Material or Nexo item id).

• vanish.permissionFile staffmode/modules.ymlDefault cobaltstaff.vanish.use

  Permission required to use the vanish item.

• hub.materialFile staffmode/modules.ymlDefault nether_star

  Material of the item that opens the staff hub in staff mode (Material or Nexo item id).

• hub.permissionFile staffmode/modules.ymlDefault cobaltstaff.hub.view

  Permission required to use the item that opens the staff hub.

• counter.materialFile staffmode/modules.ymlDefault player_head

  Material of the staff counter item in staff mode (Material or Nexo item id).

• counter.permissionFile staffmode/modules.ymlDefault cobaltstaff.mode.counter

  Permission required to use the staff counter item.

• freeze.materialFile staffmode/modules.ymlDefault packed_ice

  Material of the freeze item in staff mode (Material or Nexo item id).

• freeze.permissionFile staffmode/modules.ymlDefault cobaltstaff.freeze.freeze

  Permission required to use the freeze item.

• cps.materialFile staffmode/modules.ymlDefault feather

  Material of the CPS item in staff mode (Material or Nexo item id).

• cps.permissionFile staffmode/modules.ymlDefault cobaltstaff.cps

  Permission required to use the CPS item.

• cps.commandFile staffmode/modules.ymlDefault cps

  Command run by the CPS item (plugin command id or raw name).

• cps.argsFile staffmode/modules.ymlDefault %clicked%

  Arguments added to the command of the CPS item; %clicked% = name of the targeted player.

• examine.materialFile staffmode/modules.ymlDefault book

  Material of the examine item in staff mode (Material or Nexo item id).

• examine.permissionFile staffmode/modules.ymlDefault cobaltstaff.examine

  Permission required to use the examine item.

• examine.commandFile staffmode/modules.ymlDefault examine

  Command run by the examine item (plugin command id or raw name).

• examine.argsFile staffmode/modules.ymlDefault %clicked%

  Arguments added to the command of the examine item; %clicked% = name of the targeted player.

• follow.materialFile staffmode/modules.ymlDefault lead

  Material of the follow item in staff mode (Material or Nexo item id).

• follow.permissionFile staffmode/modules.ymlDefault cobaltstaff.mode.follow

  Permission required to use the follow item.

• follow.commandFile staffmode/modules.ymlDefault follow

  Command run by the follow item (plugin command id or raw name).

• follow.argsFile staffmode/modules.ymlDefault %clicked%

  Arguments added to the command of the follow item; %clicked% = name of the targeted player.

• details.materialFile staffmode/modules.ymlDefault name_tag

  Material of the player details item in staff mode (Material or Nexo item id).

• details.permissionFile staffmode/modules.ymlDefault cobaltstaff.players

  Permission required to use the player details item.

• details.commandFile staffmode/modules.ymlDefault players

  Command run by the player details item (plugin command id or raw name).

• details.argsFile staffmode/modules.ymlDefault %clicked%

  Arguments added to the command of the player details item; %clicked% = name of the targeted player.

• spectate.materialFile staffmode/modules.ymlDefault ender_eye

  Material of the spectate item in staff mode (Material or Nexo item id).

• spectate.permissionFile staffmode/modules.ymlDefault cobaltstaff.spec.use

  Permission required to use the spectate item.

• reports.materialFile staffmode/modules.ymlDefault writable_book

  Material of the Reports item in staff mode (Material or Nexo item id).

• reports.permissionFile staffmode/modules.ymlDefault cobaltstaff.reports.manage.view

  Permission required to use the Reports item.

• reports.commandFile staffmode/modules.ymlDefault manage-reports

  Command run by the Reports item (plugin command id or raw name).

• reports.argsFile staffmode/modules.yml

  Arguments added to the command of the Reports item; empty = no argument.