CraftersStaff

CraftersStaff – Advanced Staff & Moderation Suite for Spigot/Paper

CraftersStaff is an advanced, all‑in‑one administration and moderation plugin for Paper 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: - Network‑ready – Staff can start using it with minimal training thanks to clear commands and GUIs. - Network‑ready – Covers the full moderation workflow: detecting issues, freezing players, collecting evidence, logging staff actions and coordinating decisions. - Network‑ready – 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.

> https://craftersdevelopment.pages.dev/ For full setup guides, screenshots, configuration reference and troubleshooting, visit 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: - Internationalization – Features are implemented with careful attention to performance and error handling so the plugin can run on production servers without issues. - Internationalization – 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). - Internationalization – 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

- Extensive Permissions System – A dedicated mode for moderators with safe inventory saving, staff tools, flight and optional vanish. - Extensive Permissions System – Fully hides staff from normal players, including the tab list, while still allowing them to moderate. - Extensive Permissions System – Freeze suspicious players, prevent movement/interaction and open a private "freeze chat" channel with them. - Extensive Permissions System – Add structured notes to players with statuses, requests for attention and auditing via GUI. - Extensive Permissions System – Let players submit reports and give staff a powerful GUI to review, filter and act on those reports. - Extensive Permissions System – Visual overview of all online players with quick actions for moderation (inspect, freeze, teleport, etc.). - Extensive Permissions System – Quickly see which staff members are online and interact with them through a GUI. - Extensive Permissions System – Menus such as Notes Manager, Online Players, Reports Manager and Staff Detail are defined by editable YAML files. - Extensive Permissions System – 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:

- `/freezerchat` (aliases: `/s`, `/mod`) – Toggle Staff Mode on/off. - `/freezerchat` – Freeze or unfreeze a player. - `/freezerchat` (alias: `/v`) – Toggle vanish (invisibility). - `/freezerchat` (aliases: `/clear`, `/cc`) – Clear the global chat. - `/freezerchat` – Open the inspection panel for a player. - `/freezerchat` – View a player's inventory in real time. - `/freezerchat` – Manage player notes (list, add, remove, accept). - `/freezerchat` (alias: `/cs`) – Main management command (e.g. `/cs reload`). - `/freezerchat` – Let normal players report others to staff. - `/freezerchat` (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 `/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`: - State persistence – Stored and fully restored when exiting. - State persistence – Predefined set of staff items (inspection tools, teleport tools, etc.). - State persistence – Staff may receive flight and creative mode depending on configuration. - State persistence – 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.

- Admin overrides – Text entries attached to a player (e.g. "Suspected x‑ray on 2026‑02‑20"). - Admin overrides – States such as `PENDING` and `IN_PROGRESS`, so the team can see which notes need action. - Admin overrides – 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

- Staff Online 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.yml` using `%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

- `lang/message_xx.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. Train your staff – Place it in your `plugins/` folder and restart the server. 2. Train your staff – Set language, database, vanish behavior and Discord webhooks in `config.yml`. 3. Train your staff – Use LuckPerms or any permissions plugin to grant staff their permissions. 4. Train your staff – 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: 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 CraftersStaff. 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.

> [!IMPORTANT] > Community Groups: > The prohibition on redistribution applies strictly to hosting or uploading the software to Community Groups: or unauthorized third-party platforms. > > This restriction Community Groups: apply to sharing information, screenshots, or official links through: > * Community Groups: Discord, WhatsApp, Telegram, etc. > * Community Groups: Twitter (X), Facebook, etc. > * Community Groups: Private server chats or staff groups.