Skip to content
Popow Docs

Overview

Paper 1.21.x Java 21 Version 1.0.0 PlaceholderAPI

CobaltStaff brings together everything a moderation team needs every day: sanctions with a record and automatic thresholds, reports and tickets, a staff mode with vanish and freeze, investigation tools, staff chat, chat filter and alerts. It was built for the Cobaltia server and is fully configurable: every command, text and menu can be renamed, translated or disabled.

Features

Section titled “Features”

Sanctions

Bans (permanent, temporary, IP and ranges), soft or hard mutes, kicks, severity-based warns with a score and automatic thresholds, player record, appeals, unified sanction menu, LiteBans import.

Reports and tickets

Report a player or an issue, configurable types and reasons, attached chat evidence, full lifecycle, discussion channels, help requests to the staff.

Staff mode

Ranked modes with inheritance, own inventory set aside and given back on exit, tool hotbar, three vanish types, spectate, freeze with a dedicated channel, staff list and staff hub.

Investigations

Inventories and ender chests (even offline), player profile, notes, CPS test, trace, investigations with evidence, IP history, alt detection, staff locations, protected areas.

Chat and alerts

Multi-channel staff chat, chat lock and slow mode, bypass-resistant blacklist, phrase and command detection, X-ray alerts, mentions, anticheat relay.

Integrations

Rich PlaceholderAPI expansion, LuckPerms contexts, Bukkit events and Java services for your own plugins.

Highlights

Section titled “Highlights”
  • Everything is configurable: command names and aliases, permissions, texts (FR and EN included), menus, sounds, thresholds, reasons and hooks.
  • Built for performance: the whole database runs on a dedicated thread, never on the server thread; hot state (active mutes and bans, staff mode, vanish, freeze) is kept in memory; no heavy polling.
  • Staff hierarchy: a staff member can only target a player of a lower rank (ban, mute, kick, warn, freeze, examine), offline players included thanks to LuckPerms.
  • Per-permission limits and cooldowns: maximum tempban or tempmute duration by rank, report cooldown.
  • Offline players: sanctions, reports, inventory examination and notes work on disconnected players.
  • Audit log: every staff action is recorded and can be viewed in game.
  • Modular: six modules (sanctions, reports, staffmode, investigation, chat, integration) that can be enabled independently.

In-game preview

Section titled “In-game preview”

Messages follow a single style: an icon, a title in small caps with a gradient, then the details in grey.

ʙᴀɴɴᴇᴅ  Steve is banned for 7 d: Cheating.
ꜱᴄᴏʀᴇ  4/5 points, next threshold: 1 day ban
ʀᴇʟᴏᴀᴅ ᴄᴏᴍᴘʟᴇᴛᴇ  The whole plugin reloaded in 42 ms.

Ban screens are fully editable text templates (the bundled templates are in French; translated here):

ᴛᴇᴍᴘᴏʀᴀʀɪʟʏ ʙᴀɴɴᴇᴅ


Reason: Cheating
Duration: 7 d (6 d 23 h left)
Ends: 16/10/2026 18:00
By: Moderator


Sanction #128

Requirements

Section titled “Requirements”
Item Version Status
Paper server (or fork) 1.21.x Required
Java 21 Required
LuckPerms 5.4+ Recommended (offline hierarchy, contexts)
PlaceholderAPI 2.11+ Optional (placeholders, player profile)
packetevents — Optional (“PLAYER” vanish that keeps the tab line)
Nexo — Optional (message icons, custom items and ores)
GrimAC — Optional (anticheat alert relay)
LiteBans — Optional (history import)

Next steps

Section titled “Next steps”
InstallationInstall the plugin and make the first adjustments.
CommandsEvery command, its aliases and permission.
PermissionsThe permission tree and a per-rank example.
ConfigurationEvery configuration file explained.