![CraftersStaff Banner](https://i.imgur.com/gWjEyC8.png) ## 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 [craftersdevelopment.pages.dev](https://craftersdevelopment.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: | Command | Aliases | Description | |---|---|---| | `/staff` | `/s`, `/mod` | Toggle Staff Mode on/off | | `/freeze ` | — | Freeze or unfreeze a player | | `/vanish` | `/v` | Toggle vanish (invisibility) | | `/clearchat` | `/clear`, `/cc` | Clear the global chat | | `/inspect ` | — | Open the inspection panel for a player | | `/invsee ` | — | View a player's inventory in real time | | `/note ...` | — | Manage player notes (list, add, remove, accept) | | `/craftersstaff` | `/cs` | Main management command (e.g. `/cs reload`) | | `/report ` | — | Let normal players report others to staff | | `/staffchat` | `/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 /staffchat and 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 (includes `note.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. ![Staff Mode](https://i.imgur.com/JBqEUVm.png) 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 ` – 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 ![Notes System](https://i.imgur.com/dKeAayk.png) 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 `PENDING` and `IN_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 ![Reports Manager](https://i.imgur.com/X9Qub9l.png) `/report ` 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](https://i.imgur.com/gL9LMLA.png) ![Staff Online Menu](https://i.imgur.com/lN1sjmo.png) - **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 ![Staff Detail](https://i.imgur.com/5n35YgO.png) 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 ` 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.yml` using `%player%` placeholders. --- ## Inventory Inspection – `/invsee` Permission: `craftersstaff.invsee` `/invsee ` 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 1. **Drop the JAR** – Place it in your `plugins/` folder and restart the server. 2. **Configure the basics** – Set language, database, vanish behavior and Discord webhooks in `config.yml`. 3. **Assign permissions** – Use LuckPerms or any permissions plugin to grant staff their permissions. 4. **Customize menus (optional)** – Edit YAML files in `plugins/CraftersStaff/menus/` to match your server's style. 5. **Train your staff** – Share the docs and let them practice in a test environment. --- ## Official Documentation & Support **Official Docs:** [craftersdevelopment.pages.dev](https://craftersdevelopment.pages.dev/) 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**! --- ## License & Intellectual Property © 2026 Crafters Development. All rights reserved. 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. > **Clarification:** The redistribution prohibition applies strictly to publishing the software on external download websites or unauthorized third-party distribution platforms. This restriction **does not** affect the sharing of information, screenshots, or official links on social media and messaging services (such as Discord, WhatsApp, Telegram, Twitter/X, etc.).

CraftersStaff

2.7

2.6

2.5

2.0