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+.