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://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:

• /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 /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.

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 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

/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.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

• 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: 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.

[!IMPORTANT]
Redistribution Clarification:
The prohibition on redistribution applies strictly to hosting or uploading the software to external download websites or unauthorized third-party platforms.

This restriction DOES NOT apply to sharing information, screenshots, or official links through:

• Messaging Apps: Discord, WhatsApp, Telegram, etc.
• Social Media: Twitter (X), Facebook, etc.
• Community Groups: Private server chats or staff groups.