Kstaff — Complete Moderation Plugin | Paper 26.2

OVERVIEW

Kstaff is a complete moderation plugin for Paper 26.2+ servers. Manage bans, mutes, warnings, kicks, player reports, staff tools and sanction history — all in one lightweight plugin.

No database required. All data is saved in YAML. Optional Discord webhook for instant staff alerts.

FEATURES

Sanctions

• /ban, /tempban, /unban — permanent or temporary bans

• /mute, /tempmute, /unmute — chat mute system

• /kick — kick with custom reason

• /warn, /unwarn — warnings with optional auto-ban after X warns

• /history — full sanction history per player

Staff tools

• /vanish (alias /v) — invisible mode for staff

• /freeze — freeze a player in place

• /invsee — view player inventory (read-only)

• /staffchat (alias /sc) — private staff chat

Reports

• /report — players can report others

• /reports — list open reports in chat

• /reports gui — GUI with player heads (left-click = teleport, right-click = resolve)

• /reports resolve — mark report as handled

• Cooldown system to prevent report spam

Other

• Ban check on join

• Mute blocks chat messages

• Duration format: 7d, 2h, 30m, 1w, permanent

• Discord webhook (ban, mute, warn, kick, reports)

• Permission bypass for senior staff (kstaff.bypass)

• Data saved in plugins/Kstaff/data.yml

COMMANDS

• /kstaff — help, reload, staff list

• /ban, /tempban, /unban

• /mute, /tempmute, /unmute

• /kick, /warn, /unwarn

• /history

• /vanish, /freeze, /invsee, /staffchat

• /report, /reports, /reports gui

PERMISSIONS

• kstaff.ban — ban commands

• kstaff.mute — mute commands

• kstaff.kick — kick

• kstaff.warn — warn / unwarn

• kstaff.vanish — vanish mode

• kstaff.vanish.see — see vanished staff

• kstaff.freeze — freeze players

• kstaff.invsee — view inventories

• kstaff.staffchat — staff chat

• kstaff.report — use /report (default: all players)

• kstaff.reports — manage reports

• kstaff.history — view history

• kstaff.admin — reload + target bypass staff

• kstaff.bypass — immunity from sanctions

REQUIREMENTS

• Paper 26.2+

• Java 21+ (25 recommended)

• No external dependencies

INSTALLATION

1. Drop Kstaff.jar into /plugins/

2. Restart your server

3. Configure plugins/Kstaff/config.yml

4. Optional: set Discord webhook URL

5. Use /kstaff help for all commands

FILE STRUCTURE

plugins/Kstaff/

config.yml — messages, Discord, settings

data.yml — sanctions & reports (auto-generated)

DISCORD WEBHOOK (optional)

discord:

enabled: true

webhook-url: "your-webhook-url"

notify-ban: true

notify-mute: true

notify-report: true

SUPPORT

Get help on Discord:https://discord.gg/j9776xVJzD

Kstaff is developed by Kayz. Independent plugin for Paper 26.2+.