<\/p>\n
# CraftersStaff \u2013 Advanced Staff & Moderation Suite for Spigot\/Paper<\/p>\n
CraftersStaff is an advanced, all\u2011in\u2011one administration and moderation plugin for **Spigot** and **Paper** servers. It centralizes day\u2011to\u2011day 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.<\/p>\n
The plugin is designed to be:
\n– **Intuitive** \u2013 Staff can start using it with minimal training thanks to clear commands and GUIs.
\n– **Powerful** \u2013 Covers the full moderation workflow: detecting issues, freezing players, collecting evidence, logging staff actions and coordinating decisions.
\n– **Flexible** \u2013 Highly configurable via YAML files and language files so every server can adapt texts, menus and flows to its own community.
\n– **Network\u2011ready** \u2013 Built with hybrid Spigot\/Velocity support (for network setups) while still working perfectly on single Spigot\/Paper servers.<\/p>\n
> **Official documentation:** For full setup guides, screenshots, configuration reference and troubleshooting, visit **https:\/\/craftersdevelopment.pages.dev\/**<\/p>\n
—<\/p>\n
# About the Developer<\/p>\n
CraftersStaff is developed and maintained by **xUnknowns**, a developer focused on creating robust, production\u2011ready tools for Minecraft communities.<\/p>\n
Key principles behind the project:
\n– **Stability first** \u2013 Features are implemented with careful attention to performance and error handling so the plugin can run on production servers without issues.
\n– **Clarity for staff** \u2013 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).
\n– **Respect for customization** \u2013 Server owners are encouraged to customize menus, texts and permissions. The plugin includes advanced config\u2011merge logic to add new options without overwriting existing customization.
\n– **Internationalization** \u2013 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.<\/p>\n
—<\/p>\n
# Key Features Overview<\/p>\n
– **Staff Mode** \u2013 A dedicated mode for moderators with safe inventory saving, staff tools, flight and optional vanish.
\n– **Vanish System** \u2013 Fully hides staff from normal players, including the tab list, while still allowing them to moderate.
\n– **Freeze System & FreezerChat** \u2013 Freeze suspicious players, prevent movement\/interaction and open a private “freeze chat” channel with them.
\n– **Notes System (Notes Manager)** \u2013 Add structured notes to players with statuses, requests for attention and auditing via GUI.
\n– **Reports Manager** \u2013 Let players submit reports and give staff a powerful GUI to review, filter and act on those reports.
\n– **Online Players Menu** \u2013 Visual overview of all online players with quick actions for moderation (inspect, freeze, teleport, etc.).
\n– **Staff List \/ Staff Online** \u2013 Quickly see which staff members are online and interact with them through a GUI.
\n– **GUIs Driven by YAML** \u2013 Menus such as Notes Manager, Online Players, Reports Manager and Staff Detail are defined by editable YAML files.
\n– **Staff Pass (Activity Logger)** \u2013 Log key staff actions (freeze, notes, vanish, etc.) and review them later via in\u2011game commands.
\n– **Extensive Permissions System** \u2013 Fine\u2011grained permissions for every feature, from basic staff toggles to advanced admin actions and note management.<\/p>\n
—<\/p>\n
# Commands Overview<\/p>\n
Commands are defined dynamically via `commands.yml` and registered at runtime. By default, the plugin provides the following main commands:<\/p>\n
– **`\/staff`** (aliases: `\/s`, `\/mod`) \u2013 Toggle Staff Mode on\/off. > 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.<\/p>\n —<\/p>\n # Permissions Overview<\/p>\n – `craftersstaff.use` \u2013 Allows toggling Staff Mode. —<\/p>\n # Staff Mode and Vanish<\/p>\n ## `\/staff` \u2013 Entering and Leaving Staff Mode When a staff member runs `\/staff`: <\/p>\n Running `\/staff` again exits Staff Mode: tools are removed, original inventory is restored and optional changes are reverted.<\/p>\n ## `\/vanish` \u2013 Invisible Moderation `\/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.<\/p>\n —<\/p>\n # Freeze System and FreezerChat<\/p>\n ## `\/freeze When you freeze a player: ## `\/freezerchat` \u2013 Private Chat with the Frozen Player<\/p>\n 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 \u2014 ideal for calm, organized investigations without confusing other players.<\/p>\n —<\/p>\n # Notes System \u2013 Player Notes and Collaboration<\/p>\n <\/p>\n The **Notes System** allows staff to attach structured notes to players, track status, and collaborate over time.<\/p>\n – **Notes** \u2013 Text entries attached to a player (e.g. “Suspected x\u2011ray on 2026\u201102\u201120”). **Permissions:** `craftersstaff.note` | `craftersstaff.note.list` | `craftersstaff.note.add` | `craftersstaff.note.admin`<\/p>\n —<\/p>\n # Reports Manager \u2013 Handling Player Reports<\/p>\n <\/p>\n `\/report —<\/p>\n # Online Players & Staff Menus<\/p>\n <\/p>\n <\/p>\n – **Online Players Menu** \u2013 Shows all connected players with quick actions (inspect, freeze, teleport, notes, etc.). Both menus are fully customizable via YAML (`menus\/player_list.yml`, `menus\/staff_list.yml`).<\/p>\n —<\/p>\n # Staff Detail \u2013 Per\u2011Staff Overview<\/p>\n <\/p>\n 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`.<\/p>\n —<\/p>\n # Inspect \u2013 Deep Dive into a Player<\/p>\n **Permission:** `craftersstaff.inspect`<\/p>\n `\/inspect —<\/p>\n # Inventory Inspection \u2013 `\/invsee`<\/p>\n **Permission:** `craftersstaff.invsee`<\/p>\n `\/invsee —<\/p>\n # Chat Management<\/p>\n ## `\/staffchat` \u2013 Private Staff Channel Toggle a private channel where only staff with the right permission can read messages \u2014 ideal for coordinating freezes, planning actions and internal discussion.<\/p>\n ## `\/clearchat` \u2013 Clean the Global Chat Instantly clears the public chat for all players. Useful after spam attacks, advertising or heated arguments.<\/p>\n —<\/p>\n # Configuration, Languages and Menus<\/p>\n – **`config.yml`** \u2013 Staff Mode, vanish, database (SQLite\/MySQL), TPS alerts, Discord webhooks, network flags, and more. The plugin includes a **non\u2011destructive config merge** system: when the plugin updates, new options are appended to your existing files without replacing custom values.<\/p>\n —<\/p>\n # Getting Started \u2013 Quick Setup<\/p>\n 1. **Drop the JAR** \u2013 Place it in your `plugins\/` folder and restart the server. —<\/p>\n # Official Documentation & Support<\/p>\n > **Official Docs:** https:\/\/craftersdevelopment.pages.dev\/<\/p>\n There you will find the full configuration reference, detailed feature pages, troubleshooting tips and changelogs.<\/p>\n If you appreciate the plugin, consider leaving a review or sharing feedback with **xUnknowns**. Enjoy moderating your server with **CraftersStaff**! \ud83c\udfae<\/p>\n ## License & Intellectual Property Redistribution, copying, or modification of this software is prohibited without the express permission of Crafters Development. This code is intellectual property protected by **Chilean Intellectual Property Law 17.336**.<\/p>\n > [!IMPORTANT] Complete staff management solution with vanish, freeze, alerts, Discord integration, and customizable menus for Minecraft servers.<\/p>\n","protected":false},"featured_media":47855,"template":"","meta":{"_minecraft_slug":"craftersstaff","_minecraft_project_id":"UAUjFHnX","_minecraft_author":"xUnknowns","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":188,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"craftersstaff.zip","_minecraft_size_bytes":18177077,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T13:02:05.969286Z","_minecraft_date_created":"2026-02-16T22:42:15.203319Z","_minecraft_date_modified":"2026-05-01T04:20:21.168319Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/craftersstaff","_minecraft_icon_attachment_id":47855,"_minecraft_imported_at":"2026-06-02T11:29:03+00:00","_minecraft_import_hash":"4aa1ec81ecac66d91f4284a2902228c5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,126,127,128,867,129,92,985,992],"mod_loader":[130,895,132,133,134,986,993],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-47854","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **`\/freeze
\n– **`\/vanish`** (alias: `\/v`) \u2013 Toggle vanish (invisibility).
\n– **`\/clearchat`** (aliases: `\/clear`, `\/cc`) \u2013 Clear the global chat.
\n– **`\/inspect
\n– **`\/invsee
\n– **`\/note …`** \u2013 Manage player notes (list, add, remove, accept).
\n– **`\/craftersstaff`** (alias: `\/cs`) \u2013 Main management command (e.g. `\/cs reload`).
\n– **`\/report
\n– **`\/staffchat`** (alias: `\/sc`) \u2013 Toggle private staff chat.
\n– **`\/freezerchat`** \u2013 Open or toggle the private chat with the frozen player.<\/p>\n
\n– `craftersstaff.freeze` \u2013 Allows using `\/freeze`.
\n– `craftersstaff.vanish` \u2013 Allows using `\/vanish`.
\n– `craftersstaff.chat` \u2013 Allows using `\/staffchat` and reading staff chat.
\n– `craftersstaff.list` \u2013 Allows viewing the staff list.
\n– `craftersstaff.players` \u2013 Allows viewing the full player list.
\n– `craftersstaff.help` \u2013 Allows viewing help.
\n– `craftersstaff.clearchat` \u2013 Allows clearing the global chat.
\n– `craftersstaff.invsee` \u2013 Allows opening inventories with `\/invsee`.
\n– `craftersstaff.inspect` \u2013 Allows using `\/inspect`.
\n– `craftersstaff.admin.actions` \u2013 Allows admin\u2011level actions in GUIs.
\n– `craftersstaff.note` \u2013 Base permission for note commands (includes `note.list`, `note.add`, `note.remove`).
\n– `craftersstaff.note.admin` \u2013 Allows removing any note regardless of creator.
\n– `craftersstaff.staffpass.log` \u2013 Allows viewing staff activity logs.<\/p>\n
\n**Permission:** `craftersstaff.use`<\/p>\n
\n– **Current inventory is saved** \u2013 Stored and fully restored when exiting.
\n– **Staff tools are equipped** \u2013 Predefined set of staff items (inspection tools, teleport tools, etc.).
\n– **Optional flight and gamemode switches** \u2013 Staff may receive flight and creative mode depending on configuration.
\n– **Vanish integration** \u2013 Entering Staff Mode can also toggle vanish automatically.
\n– **State persistence** \u2013 Staff Mode and vanish state are remembered across reconnects.<\/p>\n
\n**Permission:** `craftersstaff.vanish`<\/p>\n
\n**Permission:** `craftersstaff.freeze`<\/p>\n
\n– The target cannot move, break blocks, place blocks, or interact with the world.
\n– Certain commands can be blocked or whitelisted while frozen.
\n– Alerts are sent to staff and\/or Discord via webhooks.<\/p>\n
\n– **Statuses** \u2013 States such as `PENDING` and `IN_PROGRESS`, so the team can see which notes need action.
\n– **Requests for attention** \u2013 Staff can request other team members to look into a note.
\n– **Admin overrides** \u2013 With the right permission, admins can remove any note.<\/p>\n
\n– Staff can see a list of open reports.
\n– Each entry shows the reporting player, the reported player, and the reason.
\n– From the GUI, staff can teleport, inspect, freeze or otherwise act on the case.<\/p>\n
\n– **Staff Online Menu** \u2013 Shows currently connected staff members for real\u2011time coordination.<\/p>\n
\n– Basic player info (name, UUID, current world, ping, etc.).
\n– Direct access to Notes, Reports, Freeze, Teleport and more.
\n– Quick\u2011Action buttons configurable in `config.yml` using `%player%` placeholders.<\/p>\n
\n**Permission:** `craftersstaff.chat`<\/p>\n
\n**Permission:** `craftersstaff.clearchat`<\/p>\n
\n– **`lang\/message_xx.yml`** \u2013 Localization for EN, ES, PT, DE, FR, RU, NL, IT and more. New keys are merged automatically without overwriting custom translations.
\n– **`menus\/*.yml`** \u2013 Full control over GUI sizes, items, names, lores and click actions.<\/p>\n
\n2. **Configure the basics** \u2013 Set language, database, vanish behavior and Discord webhooks in `config.yml`.
\n3. **Assign permissions** \u2013 Use LuckPerms or any permissions plugin to grant staff their permissions.
\n4. **Customize menus (optional)** \u2013 Edit YAML files in `plugins\/CraftersStaff\/menus\/` to match your server’s style.
\n5. **Train your staff** \u2013 Share the docs and let them practice in a test environment.<\/p>\n
\n\u00a9 2026 **Crafters Development**. All rights reserved.<\/p>\n
\n> **Redistribution Clarification:**
\n> The prohibition on redistribution applies strictly to hosting or uploading the software to **external download websites** or unauthorized third-party platforms.
\n>
\n> This restriction **DOES NOT** apply to sharing information, screenshots, or official links through:
\n> * **Messaging Apps:** Discord, WhatsApp, Telegram, etc.
\n> * **Social Media:** Twitter (X), Facebook, etc.
\n> * **Community Groups:** Private server chats or staff groups.<\/p>\n","protected":false},"excerpt":{"rendered":"