CraftersStaff
Complete staff management solution with vanish, freeze, alerts, Discord integration, and customizable menus for Minecraft servers.
CraftersStaff – Advanced Staff & Moderation Suite for Spigot/Paper
CraftersStaff is an advanced, all‑in‑one administration and moderation plugin for Spigot and Paper servers. It centralizes day‑to‑day staff tasks (staff mode, vanish, freezing, notes, reports, inventory inspection, staff chat, GUI menus, etc.) into a single, cohesive system that is easy for server owners to configure and easy for staff members to learn and use.
The plugin is designed to be:
- Intuitive – Staff can start using it with minimal training thanks to clear commands and GUIs.
- Powerful – Covers the full moderation workflow: detecting issues, freezing players, collecting evidence, logging staff actions and coordinating decisions.
- Flexible – Highly configurable via YAML files and language files so every server can adapt texts, menus and flows to its own community.
- Network‑ready – Built with hybrid Spigot/Velocity support (for network setups) while still working perfectly on single Spigot/Paper servers.
Official documentation: For full setup guides, screenshots, configuration reference and troubleshooting, visit https://craftersstaff.pages.dev/
About the Developer
CraftersStaff is developed and maintained by xUnknowns, a developer focused on creating robust, production‑ready tools for Minecraft communities.
Key principles behind the project:
- Stability first – Features are implemented with careful attention to performance and error handling so the plugin can run on production servers without issues.
- Clarity for staff – Every command, GUI and message is written to be clear for staff members under pressure (e.g. during a cheat investigation or a griefing incident).
- Respect for customization – Server owners are encouraged to customize menus, texts and permissions. The plugin includes advanced config‑merge logic to add new options without overwriting existing customization.
- Internationalization – Out of the box, CraftersStaff ships with multiple languages (including English, Spanish, Portuguese, German, French, Russian, Dutch and Italian), and the system is designed to keep translations in sync.
Key Features Overview
- Staff Mode – A dedicated mode for moderators with safe inventory saving, staff tools, flight and optional vanish.
- Vanish System – Fully hides staff from normal players, including the tab list, while still allowing them to moderate.
- Freeze System & FreezerChat – Freeze suspicious players, prevent movement/interaction and open a private "freeze chat" channel with them.
- Notes System (Notes Manager) – Add structured notes to players with statuses, requests for attention and auditing via GUI.
- Reports Manager – Let players submit reports and give staff a powerful GUI to review, filter and act on those reports.
- Online Players Menu – Visual overview of all online players with quick actions for moderation (inspect, freeze, teleport, etc.).
- Staff List / Staff Online – Quickly see which staff members are online and interact with them through a GUI.
- GUIs Driven by YAML – Menus such as Notes Manager, Online Players, Reports Manager and Staff Detail are defined by editable YAML files.
- Staff Pass (Activity Logger) – Log key staff actions (freeze, notes, vanish, etc.) and review them later via in‑game commands.
- Extensive Permissions System – Fine‑grained permissions for every feature, from basic staff toggles to advanced admin actions and note management.
Commands Overview
Commands are defined dynamically via commands.yml and registered at runtime. By default, the plugin provides the following main commands:
/staff(aliases:/s,/mod) – Toggle Staff Mode on/off./freeze <player>– Freeze or unfreeze a player./vanish(alias:/v) – Toggle vanish (invisibility)./clearchat(aliases:/clear,/cc) – Clear the global chat./inspect <player>– Open the inspection panel for a player./invsee <player>– View a player's inventory in real time./note ...– Manage player notes (list, add, remove, accept)./craftersstaff(alias:/cs) – Main management command (e.g./cs reload)./report <player> <reason>– Let normal players report others to staff./staffchat(alias:/sc) – Toggle private staff chat./freezerchat– Open or toggle the private chat with the frozen player.
The actual command names and aliases can be changed in
plugins/CraftersStaff/commands.yml. A server restart is required for command name changes to apply fully.
Permissions Overview
craftersstaff.use– Allows toggling Staff Mode.craftersstaff.freeze– Allows using/freeze.craftersstaff.vanish– Allows using/vanish.craftersstaff.chat– Allows using/staffchatand reading staff chat.craftersstaff.list– Allows viewing the staff list.craftersstaff.players– Allows viewing the full player list.craftersstaff.help– Allows viewing help.craftersstaff.clearchat– Allows clearing the global chat.craftersstaff.invsee– Allows opening inventories with/invsee.craftersstaff.inspect– Allows using/inspect.craftersstaff.admin.actions– Allows admin‑level actions in GUIs.craftersstaff.note– Base permission for note commands (includesnote.list,note.add,note.remove).craftersstaff.note.admin– Allows removing any note regardless of creator.craftersstaff.staffpass.log– Allows viewing staff activity logs.
Staff Mode and Vanish
/staff – Entering and Leaving Staff Mode
Permission: craftersstaff.use
When a staff member runs /staff:
- Current inventory is saved – Stored and fully restored when exiting.
- Staff tools are equipped – Predefined set of staff items (inspection tools, teleport tools, etc.).
- Optional flight and gamemode switches – Staff may receive flight and creative mode depending on configuration.
- Vanish integration – Entering Staff Mode can also toggle vanish automatically.
- State persistence – Staff Mode and vanish state are remembered across reconnects.
Running /staff again exits Staff Mode: tools are removed, original inventory is restored and optional changes are reverted.
/vanish – Invisible Moderation
Permission: craftersstaff.vanish
/vanish toggles the moderator's visibility to normal players and removes them from the tab list. While vanished, staff can still move, teleport, inspect players and use all moderation tools.
Freeze System and FreezerChat
/freeze <player> – Locking a Player in Place
Permission: craftersstaff.freeze
When you freeze a player:
- The target cannot move, break blocks, place blocks, or interact with the world.
- Certain commands can be blocked or whitelisted while frozen.
- Alerts are sent to staff and/or Discord via webhooks.
/freezerchat – Private Chat with the Frozen Player
During a freeze, /freezerchat opens a private chat channel between the staff member and the frozen player. Messages are only visible to staff and the frozen target — ideal for calm, organized investigations without confusing other players.
Notes System – Player Notes and Collaboration
The Notes System allows staff to attach structured notes to players, track status, and collaborate over time.
- Notes – Text entries attached to a player (e.g. "Suspected x‑ray on 2026‑02‑20").
- Statuses – States such as
PENDINGandIN_PROGRESS, so the team can see which notes need action. - Requests for attention – Staff can request other team members to look into a note.
- Admin overrides – With the right permission, admins can remove any note.
Permissions: craftersstaff.note | craftersstaff.note.list | craftersstaff.note.add | craftersstaff.note.admin
Reports Manager – Handling Player Reports
/report <player> <reason> lets players send structured reports to staff. Reports are stored and reviewed via the Reports Manager GUI:
- Staff can see a list of open reports.
- Each entry shows the reporting player, the reported player, and the reason.
- From the GUI, staff can teleport, inspect, freeze or otherwise act on the case.
Online Players & Staff Menus
- Online Players Menu – Shows all connected players with quick actions (inspect, freeze, teleport, notes, etc.).
- Staff Online Menu – Shows currently connected staff members for real‑time coordination.
Both menus are fully customizable via YAML (menus/player_list.yml, menus/staff_list.yml).
Staff Detail – Per‑Staff Overview
The Staff Detail GUI gives an overview of a single staff member: online status, role, and quick access to actions (teleport, open inventory, see recent actions). Layout is driven by menus/staff_detail.yml.
Inspect – Deep Dive into a Player
Permission: craftersstaff.inspect
/inspect <player> opens a powerful Inspection Panel including:
- Basic player info (name, UUID, current world, ping, etc.).
- Direct access to Notes, Reports, Freeze, Teleport and more.
- Quick‑Action buttons configurable in
config.ymlusing%player%placeholders.
Inventory Inspection – /invsee
Permission: craftersstaff.invsee
/invsee <player> lets staff view (and optionally modify) a player's inventory in real time — inspect suspicious items, illegal stacks, x‑ray loot and more.
Chat Management
/staffchat – Private Staff Channel
Permission: craftersstaff.chat
Toggle a private channel where only staff with the right permission can read messages — ideal for coordinating freezes, planning actions and internal discussion.
/clearchat – Clean the Global Chat
Permission: craftersstaff.clearchat
Instantly clears the public chat for all players. Useful after spam attacks, advertising or heated arguments.
Configuration, Languages and Menus
config.yml– Staff Mode, vanish, database (SQLite/MySQL), TPS alerts, Discord webhooks, network flags, and more.lang/message_xx.yml– Localization for EN, ES, PT, DE, FR, RU, NL, IT and more. New keys are merged automatically without overwriting custom translations.menus/*.yml– Full control over GUI sizes, items, names, lores and click actions.
The plugin includes a non‑destructive config merge system: when the plugin updates, new options are appended to your existing files without replacing custom values.
Getting Started – Quick Setup
- Drop the JAR – Place it in your
plugins/folder and restart the server. - Configure the basics – Set language, database, vanish behavior and Discord webhooks in
config.yml. - Assign permissions – Use LuckPerms or any permissions plugin to grant staff their permissions.
- Customize menus (optional) – Edit YAML files in
plugins/CraftersStaff/menus/to match your server's style. - Train your staff – Share the docs and let them practice in a test environment.
Official Documentation & Support
Official Docs: https://craftersstaff.netlify.app
There you will find the full configuration reference, detailed feature pages, troubleshooting tips and changelogs.
If you appreciate the plugin, consider leaving a review or sharing feedback with xUnknowns. Enjoy moderating your server with CraftersStaff! 🎮
