Official Documentation — 2026

Crafters Development

Professional moderation and administration plugins for Minecraft servers, developed by xUnknowns. Built for production environments — reliable, configurable, and network-ready.

CraftersStaff v12.0.0 Stable Spigot / Paper 1.16–1.21.5 Java 17+
● ACTIVE — v12.0.0

CraftersStaff

An advanced, all-in-one staff management and moderation suite for Spigot and Paper servers. CraftersStaff centralizes the full moderation workflow — staff mode, vanish, freeze, notes, reports, inspection tools, staff chat, web panel and more — into a single cohesive system with deep network support for Velocity and BungeeCord.

Key Features

Everything your staff team needs, built into one plugin.

🛡️
Staff Mode
Dedicated mode with inventory save/restore, staff tools, optional flight and vanish integration. State persists across reconnects.
👁️
Vanish System
Full invisibility including tab list removal. Staff can still moderate while completely hidden from regular players.
❄️
Freeze & FreezerChat
Lock suspicious players in place with a private chat channel between staff and the frozen target for calm investigations.
📋
Notes System
Attach structured notes to players with statuses (PENDING, IN_PROGRESS), attention requests and admin override support.
📊
Reports Manager
Players submit reports via command. Staff review them through a powerful GUI with filter, inspect, freeze and teleport actions.
🌐
Web Panel
Modern Cloudflare Pages frontend with dashboard, staff editor and management. Real-time sync via HTTP and unique session links.
🔗
Network Support
Full Velocity and BungeeCord support. Staff mode syncs across servers, broadcasts propagate network-wide via proxy channels.
📈
PlaceholderAPI
Official cstaff expansion with Staff Mode status, Vanish state, per-server and network-wide staff counters.
🌍
Multilingual
Ships with 10 languages including EN, ES, PT, DE, FR, RU, NL and IT. Non-destructive config merge keeps translations safe on updates.

Installation

CraftersStaff ships as a single JAR that works on both standalone Spigot/Paper servers and proxy networks.

Prerequisites

Spigot or Paper 1.16.5 — 1.21.5
Java 17 or higher
MySQL (required for network mode) or H2 (local, no setup needed)
Velocity or BungeeCord (optional — only for network setups)

Installation Steps

1
Download the latest JAR
Get the latest release from SpigotMC, Modrinth, Bukkit or BuiltByBit. All platforms host the same file.
2
Place the JAR in your plugins folder
Copy CraftersStaff.jar into your server's plugins/ directory.
3
Start or restart the server
The plugin will generate all configuration files inside plugins/CraftersStaff/.
4
Configure config.yml
Set your language, database type, vanish options, TPS alerts and Discord webhook URLs.
5
Assign permissions
Use LuckPerms or your preferred permissions plugin to grant staff the appropriate nodes.
6
Customize and go live
Edit menu YAML files, language files and run /cs reload to apply changes without restarting.

Commands

Command names and aliases can be customized in commands.yml. A server restart is required for name changes.

CommandDescriptionPermission
/staffToggle Staff Mode on/off. Aliases: /s, /modcraftersstaff.use
/vanishToggle invisibility. Alias: /vcraftersstaff.vanish
/freeze <player>Freeze or unfreeze a playercraftersstaff.freeze
/freezerchatOpen private chat with the frozen playercraftersstaff.freeze
/inspect <player>Open the full inspection panel for a playercraftersstaff.inspect
/invsee <player>View a player's inventory in real timecraftersstaff.invsee
/staffchatToggle private staff chat channel. Alias: /sccraftersstaff.chat
/clearchatClear the global chat. Aliases: /clear, /cccraftersstaff.clearchat
/report <player> <reason>Submit a player report to staff
/craftersstaffMain management command (reload, info). Alias: /cscraftersstaff.admin
CommandDescriptionPermission
/note list <player>List all notes for a playercraftersstaff.note.list
/note add <player> <text>Add a note to a playercraftersstaff.note.add
/note remove <player> <id>Remove a note by IDcraftersstaff.note.admin
/note deny <id>Deny a pending note requestcraftersstaff.note
/note info <id>View detailed info about a notecraftersstaff.note
/note accept <id>Accept a pending notecraftersstaff.note
CommandDescriptionPermission
/staff logView recent staff activity with paginationcraftersstaff.staffpass.log
/stafflogGenerate a web panel link for the current sessioncraftersstaff.staffpass.log

Permissions

craftersstaff.use
Toggle Staff Mode
craftersstaff.vanish
Use /vanish command
craftersstaff.freeze
Freeze and unfreeze players
craftersstaff.inspect
Open the inspection panel
craftersstaff.invsee
View player inventories
craftersstaff.chat
Access private staff chat
craftersstaff.clearchat
Clear the global chat
craftersstaff.list
View the staff list
craftersstaff.players
View the online player list
craftersstaff.note
Base note permissions (includes list, add, remove)
craftersstaff.note.add
Add notes to players
craftersstaff.note.list
List player notes
craftersstaff.note.admin
Remove any note regardless of creator
craftersstaff.admin.actions
Admin-level GUI actions
craftersstaff.staffpass.log
View staff activity logs and web panel
craftersstaff.admin
Full access to all plugin functions

Configuration

All configuration files are located in plugins/CraftersStaff/. The plugin uses a non-destructive merge system — updates never overwrite your custom values.

config.yml
Main settings: language, database, Staff Mode behavior, TPS alerts, Discord webhooks, proxy flags.
lang/message_xx.yml
Localization files for all messages. Supports EN, ES, PT, DE, FR, RU, NL, IT and more.
menus/*.yml
GUI definitions for every menu. Control sizes, items, icons, names, lores and click actions.
commands.yml
Rename or add aliases to any command. A server restart is required for name changes to apply.
proxy-config.yml
Generated automatically in proxy environments. Controls messaging channels and network behavior.
When updating the plugin, always reload with /cs reload after the server starts. New config keys are merged automatically.

Network Setup

CraftersStaff supports Velocity, BungeeCord and Waterfall as proxy platforms. Install the plugin on each backend server — no separate proxy JAR is needed.

Staff Mode state is automatically synchronized through the proxy. Active staff retain their mode when switching between servers.
State Synchronization
Staff Mode, vanish state and source server name are persisted across the entire network via shared MySQL storage.
Network Broadcasts
Staff chat, freeze notifications, mining alerts and TPS alerts are broadcast network-wide through the proxy channel.
PlaceholderAPI Network
Access proxy-wide staff counts and per-server staff counts via the cstaff expansion.


● ACTIVE — Advanced Punishment Suite

CraftersBan

A complete punishment management plugin for Minecraft servers that want a fast, organized, and modern moderation workflow. It brings the most important staff tools into one place: bans, tempbans, mutes, tempmutes, warnings, tempwarnings, kicks, IP punishments, punishment history, active punishment lists, account investigation tools, lockdown controls, chat moderation, and Discord webhook support. Designed for real production use with MySQL or H2 storage.

Key Features

Everything your moderation team needs for effective punishment management.

🔨
Full Punishment System
Ban, tempban, mute, tempmute, warn, tempwarn, kick, IP ban and IP mute with full duration support.
📋
Staff-Friendly Commands
Check active punishments, view player history, browse ban, mute and warning lists with ease.
⚠️
Warning Management
Unwarn and warning lookup commands with full tracking of player infractions.
🤫
Silent Punishments
Staff-only moderation actions hidden from public chat for discreet enforcement.
📄
Punishment Templates
Quick reasons for faster staff responses and consistent punishment messaging.
👤
Alt/Account Lookup
Investigate linked accounts through stored player IP history.
🌍
GeoIP Lookup Support
Know where players are connecting from for better security analysis.
🔒
Lockdown Mode
Restrict server access during incidents with configurable lockdown controls.
💬
Chat Moderation
Clear chat and mute chat tools for managing server communication.
💬
Discord Webhooks
Punishment logs and alerts sent directly to your Discord server.
⚙️
Auto Config Merge
Updates never overwrite your existing customization — safe upgrades guaranteed.
🌐
Network Ready
Support for both local and network-style server setups with reliable storage.

Installation & Compatibility

v1.0.0 Stable Bukkit / Spigot / Paper 1.13+ Java 11+

Prerequisites

Bukkit / Spigot / Paper 1.13 or higher
Java 11 or higher
MySQL or H2 (included) for storage
Compiled against Spigot API 1.21.5

Soft Dependencies (Optional)

LuckPerms — Permission management
Vault — Economy integration
PlaceholderAPI — Placeholder support
Note: Velocity is not currently supported. For proxy networks, use BungeeCord/Waterfall.

Commands & Usage

Complete command reference with syntax, examples, and usage tips.

Silent Mode: Add -s at the beginning of any command to execute silently (staff-only visible). Example: /ban -s Jhonn 1d Hacks
CommandSyntaxExample
/ban/ban [user] [time] [reason]/ban Jhonn 1d Uso de hacks
/ban [user] [reason] (permanent)/ban Jhonn Uso de hacks
/tempban/tempban [user] [time] [reason]/tempban Jhonn 2h Spam
/ipban/ipban [user/IP] [time] [reason]/ipban Jhonn 7d Ban evasion
/ipban [user/IP] [reason] (perm)/ipban 192.168.1.1 Ban evasion
/mute/mute [user] [time] [reason]/mute Jhonn 30m Insultos
/mute [user] [reason] (permanent)/mute Jhonn Insultos
/ipmute/ipmute [user/IP] [time] [reason]/ipmute Jhonn 1h Flood
/warn/warn [user] [reason]/warn Jhonn Comportamiento inapropiado
/kick/kick [user] [reason]/kick Jhonn Desconecta y reconecta
CommandSyntaxExample
/unban/unban [user/IP]/unban Jhonn or /unban 192.168.1.1
/unmute/unmute [user/IP]/unmute Jhonn
/unwarn/unwarn [user] (last warning)/unwarn Jhonn
/unwarn [user] [id]/unwarn Jhonn 3
CommandSyntaxExample
/checkban/checkban [user/IP]/checkban Jhonn or /checkban 192.168.1.1
/checkmute/checkmute [user/IP]/checkmute Jhonn
/checkwarn/checkwarn [user]/checkwarn Jhonn
/history/history [user] [page]/history Jhonn or /history Jhonn 2
/banlist/banlist [page]/banlist or /banlist 3
/mutelist/mutelist [page]/mutelist or /mutelist 2
/warnlist/warnlist [page]/warnlist or /warnlist 1
/alts/alts [user]/alts Jhonn — Find linked accounts by IP
CommandSyntaxExample
/lockdown/lockdown (toggle)/lockdown
/lockdown on|off/lockdown on or /lockdown off
/clearchat/clearchat/clearchat — Clear global chat
/mutechat/mutechat (toggle)/mutechat — Mute/unmute chat for non-staff
/lastuuid/lastuuid/lastuuid — Get last known player UUID
/geoip/geoip [user/IP]/geoip Jhonn or /geoip 192.168.1.1
/craftersban/craftersban reload|debug/craftersban reload — Reload configuration
FormatMeaningExample
sSeconds30s = 30 seconds
mMinutes15m = 15 minutes
hHours2h = 2 hours
dDays7d = 7 days
wWeeks2w = 2 weeks
moMonths1mo = 1 month
yYears1y = 1 year
Combined examples: /ban Jhonn 1d12h Hacks = 1 day and 12 hours | /mute Jhonn 1w2d Spam = 1 week and 2 days

Download

Get CraftersBan from official plugin platforms. Every download supports continued development.