CraftersStaff

Bug Fixes

Prefix Configuration Fix:* Resolved an issue where modifying the settings.prefix in config.yml would not apply in-game even after using /cs reload. The plugin now correctly reads the prefix from the active configuration manager rather than the internal Bukkit cache. Prefix Color Formatting:* Fixed a visual glitch where color codes (like &8 or &6) within the prefix were sometimes displayed as raw text instead of being parsed by the color engine.

Notes

This is a drop-in replacement patch. No configuration resets are necessary if you are updating from v2.5. If you are updating from versions prior to v2.5, please read the v2.5 release notes regarding PlaceholderAPI migration.

CraftersStaff v2.5 — The Core Rewrite Update

Overview

CraftersStaff v2.5 is the most significant release in the plugin's history. This is not just a feature update—it is a complete architectural rewrite from the ground up, designed for enterprise-grade performance, stability, and aesthetics. Every internal system (database management, networking, memory handling, security, and internationalization) has been meticulously redesigned to meet premium modern standards.

Added & Improved

- Modern Architecture: Completely transitioned to a modern Dependency Injection system. This drastically reduces memory leaks and initialization bugs during long server uptimes. - High-Performance Database Layer: All database operations have been migrated to an asynchronous connection pool. Reads and writes (player data, notes, reports) now execute with zero impact on server TPS, regardless of player count. - Universal Proxy Compatibility: The proxy messaging layer now dynamically detects your environment, flawlessly supporting both legacy networks (BungeeCord) and modern, strict validation networks (Velocity). - Aesthetic Revolution: Introduced a hybrid color parsing engine that fully supports modern Hex formats (<#hex>, <gradient>) alongside legacy ampersand codes and PlaceholderAPI variables. All menus have been fully redesigned with a minimalist, premium look. - Standardized Placeholders: Migrated all internal message variables to the professional PlaceholderAPI standard (e.g., %craftersstaff_target%), replacing outdated bracket variables across all configurations. - Zero-Lag Mining Alerts: The X-Ray detection system was rewritten from scratch to cache configurations and filter events optimally. It now adds zero measurable overhead, even in high-volume mining scenarios. - Discord Integrations: Added full support for Discord webhook alerts for Reports and TPS monitoring. - Configurable Freeze Alerts: Server administrators now have full control over the interval and maximum count of periodic freeze reminders. - Public Developer API: Added a robust public API allowing third-party developers to hook into state changes (Staff Mode, Vanish, Freeze) cleanly.

Fixed & Secured

- Unforgeable Staff Items: Staff item validation was upgraded to use persistent data tags (NBT) instead of simple name matching. Players can no longer forge staff items using an anvil to bypass restrictions. - Multiverse Safe-Transit: Implemented a delayed world-transition safety check. Staff mode inventories, flight, and vanish states are now perfectly preserved when teleporting across worlds, preventing conflicts with inventory management plugins. - GUI Security Exploits: Resolved a critical bug where players could bypass event cancellations and steal items from the Staff Menus. - API Compatibility: Fixed a major API version mismatch that caused crashes on newer server versions, ensuring flawless execution on Paper 1.19 through 1.21+. - Bulletproof Memory Cleanup: The memory management routine now aggressively purges all player state maps exactly at disconnect, guaranteeing zero memory accumulation over time. - Menu Pagination & Visuals: Fixed broken pagination logic in the Notes and Reports managers. Additionally, resolved an issue where advanced color tags (<gray>) failed to render properly on status labels. - Player Head Rendering: Fixed an issue where player heads in the GUI would not be clickable or load correctly if the player was offline. - Hardcoded Strings Eliminated: A full codebase audit was performed to eliminate all hardcoded player-facing messages. Every single message is now 100% configurable via your language files.

Removed

- Legacy Web System: The embedded HTTP web server and remote execution endpoints have been permanently removed. This significantly reduces plugin weight, startup time, and potential attack surfaces, making CraftersStaff a fully native, self-contained Minecraft plugin. - Monolithic Command Structures: Outdated, heavily-coupled command architectures were removed in favor of modular, isolated command executors loaded dynamically.

CraftersStaff v2.0 — The Network & Developer Update

This is a massive update for CraftersStaff that brings full compatibility with proxy networks, a brand new public API for developers, and a rewritten web integration system!

Changes & New Features

Proxy Network Compatibility (BungeeCord & Velocity)

- CraftersStaff now fully supports BungeeCord and Velocity networks out of the box. - Interceptors have been added to properly handle network-wide placeholders. - The %cstaff_proxy_count% placeholder now accurately displays the total number of staff members online across the entire network.

Web Panel Removal

- The Web Panel integration (`/stafflog`) has been completely removed from the plugin. - Why? This decision was made because the backend services (such as Cloudflare KV databases) have strict rate limits on their free tiers and require a budget to maintain effectively at scale. - Since we do not currently have the budget to maintain this feature without our users running into these limits, we decided to remove it completely to ensure the plugin remains lightweight, error-free, and stable. ---

Developer API

We are excited to introduce the CraftersStaff Public API! Developers can now easily hook into CraftersStaff to check player states and listen to events.

How to use the API

To use the API, simply add the CraftersStaff-v2.0.jar to your plugin's build path (or via your dependency manager) and add CraftersStaff to your plugin.yml depend or softdepend list.

Available Methods

You can access the API statically via the CraftersStaffAPI class:

// Check states
boolean isStaff = CraftersStaffAPI.isStaffMode(player);
boolean isVanished = CraftersStaffAPI.isVanished(player);
boolean isFrozen = CraftersStaffAPI.isFrozen(player);

// Modify states programmatically
CraftersStaffAPI.setStaffMode(player, true); // Enable staff mode
CraftersStaffAPI.setVanished(player, false); // Disable vanish
CraftersStaffAPI.setFrozen(target, admin, true); // Freeze a player

Available Events

All events are standard Bukkit events and can be listened to using @EventHandler. `StaffModeChangeEvent`* — Fired when a staff member toggles their staff mode. * getPlayer(): The player changing state. * isEntering(): True if they are turning staff mode ON. * isLeaving(): True if they are turning staff mode OFF. `StaffVanishEvent`* — Fired when a staff member toggles vanish. * getPlayer(): The player changing state. * isVanishing(): True if they are going invisible. * isUnvanishing(): True if they are becoming visible. `PlayerFreezeEvent`* — Fired when a player is frozen by a staff member. * getPlayer(): The player who was frozen. * getFreezer(): The staff member who issued the freeze. `PlayerUnfreezeEvent`* — Fired when a player is unfrozen. * getPlayer(): The player who was unfrozen. * getUnfreezer(): The staff member who removed the freeze.

Example Event Listener

import com.craftersstaff.api.events.StaffModeChangeEvent;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public class MyStaffListener implements Listener {

    @EventHandler
    public void onStaffModeToggle(StaffModeChangeEvent event) {
        if (event.isEntering()) {
            event.getPlayer().sendMessage("§aOur custom plugin detects you are now in Staff Mode!");
        } else {
            event.getPlayer().sendMessage("§cYou have left Staff Mode.");
        }
    }
}

--- Thank you for supporting Crafters Development! Join our Discord if you need any help.

CraftersStaff v1.9 - Web Interface Stabilization & Console Removal

We are excited to announce the release of CraftersStaff v1.9! This update focuses on stabilizing the web dashboard experience and significantly improving server performance by removing legacy console systems.

Overview

Version 1.9 is a major maintenance release that streamlines the web interface. By eliminating the web console system, we've removed unnecessary log spam and reduced server resource consumption, providing a cleaner and more focused monitoring tool for your staff and server status.

General Changes

Complete Web Console Removal:* The web console system has been entirely removed to eliminate log spam and enhance server stability. Optimized Data Polling: Reduced data polling frequency from 0.5 seconds to 10 seconds* for better overall performance. Focused Web Interface: The dashboard now focuses exclusively on the Staff List and Server Monitoring*. Enhanced Refresh Logic:* Improved the manual refresh button functionality for a more reliable data reload. Improved Skin Loading:* Optimized player skin avatars for staff members using the correct UUID formatting. Dynamic Staff Visibility:* The staff list now properly shows or hides based on real-time online staff availability. Streamlined Cloudflare Workers:* Removed all console-related endpoints from Cloudflare Worker scripts.

Web Interface Updates

Simplified Layout:* Removed console command input and terminal output sections for a cleaner look. Auto-Refresh Staff List: The staff list now automatically refreshes every 5 seconds*. Visual Feedback:* Improved visual indicators for online and offline staff members. Real-time Status:* Server status display now shows accurate player and staff counts in real-time.

Performance Improvements

Reduced Log Spam:* Eliminated excessive console logging caused by the old web console polling system. Background Task Optimization:* Reduced unnecessary background tasks when the web interface is active. API Efficiency:* Optimized API endpoints to serve only essential staff and server data. Lower Resource Usage:* Decreased CPU and memory usage by removing console command processing.

Technical Changes

Version Bump:* Updated versioning to 1.9 across all config files and build systems. Legacy Cleanup:* Removed the LocalWebServer HTTP endpoint system. Manager Updates:* Disabled WebConsoleManager and associated command execution logic. Frontend Cleanup:* Removed all console-related functions from the frontend JavaScript. Cloudflare Integration:* Removed console command, result, pending, and status endpoints from the Worker.

Bug Fixes

Fixed* player skin avatars not loading correctly due to improper UUID formatting. Fixed* staff list displaying offline players incorrectly in certain scenarios. Fixed* table visibility toggling issues when staff members connect or disconnect. Fixed* manual refresh button to force a complete data reload, including player count verification.

CraftersStaff v1.8 — Persistent Vanish & UX Improvements

---

New Features

- Added /unfreeze command to unfreeze players directly. - Persistent Vanish System — Vanish state now persists when disabling Staff Mode. - New vanish.persist-on-staff-disable option (default: true). - New vanish.auto-enable-on-staff-disable option (default: false). - Proxy Bridge Plugin — New CraftersStaff-Proxy for Velocity, BungeeCord and Waterfall. - New proxy-config.yml with storage modes (LOCAL/MYSQL), sync settings and debug mode. - Staff state (staff mode, vanish, freeze) now persists on server switch. - Network-wide freeze notifications with server name: [Freeze] [ServerName] Player has been frozen by Staff. - Separate local and network freeze notification messages (staff-notify-freeze-network, staff-notify-unfreeze-network). - Ban-on-quit system — Frozen players who disconnect are automatically banned via a configurable console command. - Self-action prevention — /freeze, /unfreeze, /report and /note can no longer be used on yourself. - Freeze state validation — Freezing an already frozen player shows an already frozen message. Unfreezing an unfrozen player shows a not frozen message. - New freeze.still-frozen message shown to players attempting to rejoin while still frozen. ---

Changes

- Improved Player List Menu — Click on any player head to instantly open the quick actions menu. Removed complex Shift+Click combinations for better UX. - Simplified freeze chat — /freeze <player> [message] now sends messages directly to the frozen player. - Discord link is now embedded directly in the freeze message via lang/messages.yml instead of a separate config variable. - Removed discord-message configuration variables from the freeze system for a cleaner setup. - Freeze notifications now properly distinguish between staff and frozen player messages: - Staff see: [Freeze] > Player has been frozen by Staff - Frozen player sees: [Freeze] > You have been frozen by Staff - Improved freeze chat format: [Freeze] Staff > message. - Enhanced freeze command help: /freeze <player> [message]. - Better permission handling in the player actions menu. - Code optimization in ConfigManager with default fallback values. - Version updated to 1.8 across all components. ---

Fixed

- Fixed all freeze messages no longer including the plugin prefix for cleaner notifications. - Fixed freeze.discord-message reference causing Message not found error. - Fixed freeze chat format now using single > instead of double >>. - Fixed UnsupportedOperationException on player join — now uses proper StaffManager methods. - Fixed variable {staff} in unfreeze message not displaying correctly. - Fixed duplicate messages in frozen player chat — messages no longer echo back to sender. - Fixed /craftersstaff help command showing Message not found errors. - Fixed help messages updated with all available commands including /report and /stafflog. - Fixed Velocity proxy NullPointerException — updated velocity-plugin.json with correct version and main class. - Fixed Message not found: freeze.still-frozen error. - Fixed freeze ban-on-quit command now executes from console on next tick for reliability. - Fixed freeze state not being properly cleaned up on player quit. - Fixed Velocity proxy InvalidPluginException — removed velocity-plugin.json from backend JAR. - Fixed Velocity proxy IllegalArgumentException: plugin main instance automatically registered.

FRESH START — Version 1.2

---

✦ Added

Quick Actions Menu* — New interactive GUI accessible via Shift + Right-Click on any player. Chest Interface* — Menu displays 5 powerful staff actions in a clean 3-row chest interface decorated with black glass panes. Freeze Action* — Instantly freeze or unfreeze a target player directly from the quick menu. Teleport Action* — Teleport to the target player's location with a single click. Inventory Action* — Open and inspect the target player's inventory in real-time. Kill Action* — Eliminate a target player instantly for emergency moderation situations. Ban Action* — Permanently ban players with automatic ban plugin detection. Smart Ban System — Automatically detects and integrates with LiteBans, LibertyBans, or AdvancedBan*. Console Warning* — Notifies server administrators if no supported ban plugin is found. New Permission* — craftersstaff.players.actions is now required to access the Quick Actions Menu. Discord Integration (Freeze)* — Frozen players now receive a formatted message including a Discord link and a live countdown timer. Configurable Discord Link* — Set your server's Discord invite via the freeze.discord-link setting. Configurable Join Timer — Define the Discord join time limit through `freeze.discord-join-time` (default: 300 seconds)*. Staff Teleport Notification* — Staff members now receive a notification message when using freeze teleport. Multi-line Freeze Message* — Improved freeze message with clear instructions, visual structure, and countdown display. ---

✦ Changed

Enhanced Freeze System* — Rebuilt freeze messaging pipeline with improved formatting and Discord integration support. Freeze Prefix Updated* — Staff freeze notifications now use the cleaner Freeze >> prefix format. Moderation Workflow* — Player interaction flow has been streamlined for faster and more efficient staff actions. Menu Language Standardized* — All menu item names and descriptions are now in English for consistency across all interfaces. Version Bump* — Updated to 1.2 across pom.xml, plugin.yml, and config.yml. ---

✦ Removed

Multi-language Support* — Removed in favor of a single unified English system via messages.yml. Language Selection* — The language selector has been removed from config.yml for a cleaner and simpler configuration experience. ---

CraftersStaff is built for serious moderation. FRESH START marks a new standard.

CraftersStaff v12.0.0 — Network Overhaul & Proxy Synchronization

---

Added

- Staff mode state is now synchronized through the proxy, so active staff retain their mode when switching between servers. - Global staff messages can now be redistributed across the network through the proxy channel. - Network-aware broadcasts added for staff chat, freeze notifications, mining alerts and TPS alerts. - Improved placeholder support for proxy-wide staff counts and per-server staff counts. - Backend state updates now persist the source server name for both local database and shared MySQL storage.

Changed

- Velocity and BungeeCord network compatibility overhauled for the backend plugin. - Version updated to 12.0.0 across all plugin resources and build metadata.

Removed

- Removed the sanctions webhook bridge for external punishment plugins. - Removed sanctions-webhooks.yml and dropped unused punishment-plugin soft dependencies.

CraftersStaff v11.5.0 — The Cloud Web Editor Update

---

Cloudflare Integration

- Replaced embedded web server with Cloudflare Worker API for data persistence. - Configuration persistence through Cloudflare's global infrastructure. - Enhanced StaffLog web communication with HTTP-based synchronization. - Removed legacy web server components and dependencies.

The plugin now connects to an external service designed to store, retrieve and synchronize data in a more reliable way, replacing the old embedded approach entirely.

---

Web Interface

- New Cloudflare Pages frontend with modern UI and responsive design. - Built with Tailwind CSS and glassmorphism design style. - Three-page system: Dashboard, Editor and Staff Management. - Enhanced dashboard with console logs, player lists and server metrics. - Server status indicators with color-coded TPS and connection states. - Player avatars via mc-heads.net with crafatar.com fallback. ---

StaffLog

- Improved StaffLog command with apply-by-ID functionality. - Real-time data synchronization between plugin and web interface. - Automatic ID generation and clickable link system for web access. - Real-time session time tracking and comprehensive staff statistics. ---

Security

- CORS-enabled API endpoints for secure cross-origin requests. - Staff-only filtering and permission-based access control. - Staff detection now uses permission-based filtering. ---

Error Handling

- Enhanced command validation with specific error messages for all failure cases. - Comprehensive error handling for API connectivity issues. - Server offline detection and unified error states across all web pages. - Improved user feedback with detailed troubleshooting instructions. ---

Localization

- Multi-language support for all new messages and error states. - Complete localization system now supporting 10 languages.

CraftersStaff v11.0.0 — AdvancedBan, LiteBans & Diagnostics

---

AdvancedBan Integration Upgraded

- Added comprehensive debug logging to the hook: event type, punished player, issuer, reason and duration. - Console messages now announce when the hook is registered and list detected event classes.

Sanctions Command Listener Improved

- Every console or in-game sanction command now produces a detailed log entry with target, reason and duration. - Console-executed commands are now treated identically to player-executed ones. - Granular debug output for ban/tempban, mute, kick, warn, unban, unmute and unwarn.

Error Handling & Diagnostics Hardened

- Individual reflection failures are now logged, showing which getter (getActor() vs getStaff()) succeeded. - Unhandled exceptions inside event handlers are no longer silently swallowed — logged with full context.

Webhook Behaviour Refined

- Console-executed sanction commands now correctly trigger Discord embeds. - Per-type toggles and proper URL handling (webhook-url with link fallback). - JSON escaping and HTTP error body logging for easier debugging.

LiteBans Integration Prepared

- Added the same detailed logging and event handling used for AdvancedBan. - If LiteBans is present, the hook will activate and report punishments with full diagnostics. --- These changes provide robust monitoring of moderation actions and give server operators full visibility when using AdvancedBan, LiteBans or similar sanction systems alongside CraftersStaff.

CraftersStaff v10.9.7 — English Alerts Fix

Release Date: March 10, 2026 ---

What's New

English Alerts Fix - Fixed mining alert messages now display in English instead of Spanish. - Updated MiningListener.java to use is mining instead of está minando. - Discord webhooks now show Mining Alert instead of Alerta de Minería. Technical Changes - File Modified: MiningListener.java - Lines: 86-87 (fallback message strings) - Before: &e[%server%] &c[X-Ray] %player% está minando %block%. - After: &e[%server%] &c[X-Ray] %player% is mining %block%.

CraftersStaff v10.7.9 — Sanctions Webhooks & LibertyBans Integration

---

Summary

- More flexible and granular sanctions webhook integration. - New sanction types: UNMUTE and UNWARN with their own templates. - Per-type toggles (enabled: true/false) to easily enable/disable each webhook. - Clear separation between the Discord endpoint (webhook-url) and the embed clickable link (link). - Reinforced webhook client: correct JSON escaping and HTTP error body logging. - Command observer for sanctions (ban/mute/warn/kick/unban/unmute/unwarn). - Reflective LibertyBans hook (PunishEvent) prepared; ID capture temporarily disabled. - Unified console prefix (no duplicates), independent of general.prefix. - Safe "update available" message with fallback. - Safe cstaff_ aliases to avoid command name conflicts. ---

Technical Changes

🔨 Sanctions Manager - New types: UNMUTE and UNWARN. - Per-type enabled: true/false check before sending each webhook. - Support for webhook-url (endpoint) and link (embed URL), with url as backwards compatibility fallback. 👁️ Sanctions Command Observer - Maps commands to sanction types and fires the webhook: - ban/tempban/ipban → BAN (or BANIP if contains ip) - mute/tempmute/ipmute → MUTE - unban/pardon → UNBAN - unmute → UNMUTE - warn → WARN - unwarn → UNWARN ⚖️ LibertyBans Integration (Reflective) - Hook to PunishEvent via Omnibus to capture sanction data without compile-time dependency. - ID capture temporarily disabled (sends null) for multi-version stability. - LibertyBans added to softdepend in plugin.yml. 🌐 Discord Webhook Client - Correct escaping of JSON characters (quotes, slashes, newlines, control unicode). - Error body reading on HTTP 4xx/5xx responses for clear diagnostics. 🖥️ Unified Console Prefix - All logs go through ConsoleUtil with the internal prefix [CraftersStaff], without using or duplicating general.prefix. 🔄 Safe Update Fallback - If general.update-available is missing from language files, a default message is used. 🔗 Conflict-free Command Aliases - A cstaff_<name> alias is automatically added for every command loaded from commands.yml. ---

Configuration Changes

New file: sanctions-webhooks.yml - Global: - sanctions-webhook.enabled – enables/disables all sanction webhooks. - sanctions-webhook.use-embed – use embed or simple message. - Per type (ban, mute, unmute, kick, warn, unwarn, unban, banip): - enabled: true/false (new) - webhook-url – Discord endpoint (new; `url` still works as fallback) - link – clickable embed title URL (new) - title, description, content, color - New sections for unmute and unwarn with their own titles, descriptions and colors. - ID removed from templates temporarily (capture disabled for stability). ---

Webhook Send Flow

1. A staff member executes a sanction command (or LibertyBans fires the event). 2. SanctionsCommandListener (or LibertyBansHook) interprets type, target, staff, duration and reason. 3. SanctionsWebhookManager checks if the type is enabled, resolves webhook-url and link, builds the embed and sends it. 4. On HTTP error, the log shows the code and Discord's response body. ---

Quick Testing Guide

1. Set webhook-url for the desired types in sanctions-webhooks.yml. Optionally set link and enabled. 2. Restart the server. 3. Run e.g. /mute <player> 10m test and check your Discord channel. 4. Test /unmute <player> and /unwarn <player> to see the new embeds. 5. Set a type to enabled: false and repeat — that webhook should not fire. ---

Final Notes

The webhook system is now modular per type and more resilient against API errors. LibertyBans ID capture will be re-enabled once the stable API for version 1.1.2 is confirmed in your environment. In the meantime, ID will not appear in embeds to avoid empty placeholders.

CraftersStaff v10.2.9 – Unified Language & Official PlaceholderAPI Support

This version 10.2.9 is focused on polishing the plugin's foundation for international networks and better preparing integration with other server systems. --- - Unified Default Language – English - Fixed the language selector to always respect the value configured in general.language inside config.yml. - The internal default language is now English (en), with normalization of invalid codes and better fallbacks when unsupported values are used. - Improved Branding & Console Messages - Fixed startup branding colors in console; legacy color codes & now display correctly. - All console messages respect the configurable prefix defined in general.prefix, maintaining a consistent visual identity in server logs. - Official PlaceholderAPI Support (`cstaff` expansion) - New official PlaceholderAPI support via the cstaff expansion, designed specifically for HUDs, scoreboards, TAB and staff network menus. - Includes placeholders to display the player's Staff Mode and Vanish status, as well as staff counters both at individual server level and across the entire network (proxy). - The system is ready to work in hybrid Spigot/Paper + Velocity environments, leveraging the craftersstaff:main messaging channel to request and receive staff counts from the proxy when needed. --- In summary, CraftersStaff v10.2.9 strengthens the plugin's internationalization, improves the administration experience in console and opens the door to more advanced integrations with PlaceholderAPI in professional network configurations.

Version 10.0.0

- Advanced Notes 2.0: - New /note deny and /note info commands with full pagination and rich formatting. - Automatic persistence and conflict-safe handling of numeric note IDs with daily YAML backups. - Staff Inspect Quick Actions: - Quick-Action GUI inside /inspect fully driven from config.yml. - Per-button actions execute custom commands replacing %player% with the inspected target. - Staff Pass (Activity Logger): - Transparent logging for Freeze, Note and Vanish actions with timestamps and staff names. - New /staff log command to review recent staff activity directly in chat with pages. - Proxy Independence & Decoupled Config: - Automatic proxy-config.yml generation only when running in proxy environments. - Backends rely solely on their local configuration files without reading proxy settings. - Premium Console Loader: - Startup branding banner with ASCII art, gradient-like coloring and environment detection. - MySQL status line showing CONECTADO, ERROR DE CONEXIÓN or BASE DE DATOS NO CONFIGURADA. - Credits line dedicated to xUnknowns for easy recognition on startup. - Cleaner Console Logging: Refined update checker and config merge messages to avoid noisy duplicate logs. - Compatibility: Compatible with Spigot/Paper 1.16–1.21.5.

Version 9.8.4 - The Infrastructure Revolution

This is the most significant update in CraftersStaff history, transforming the plugin into a high-performance, hybrid network solution.

Smart Configuration & Persistence

Non-Destructive Config Merge*: Automatic merging for config.yml, commands.yml, menus, and all language files. Comment Preservation: New options are appended to the end of your files. Your custom values, ordering, and YAML comments remain untouched*. Smart Language Updates*: All 7 supported languages receive new keys without overwriting your manual translations. Internal Cleanup*: Refactored ConfigManager for a cleaner codebase and zero internal warnings.

Hybrid Spigot/Velocity Core

Single JAR Solution*: One CraftersStaff.jar for both Spigot/Paper backends and Velocity proxies. Auto-Detection*: Lightweight environment detection using safe class-loading (prevents ClassNotFoundException). Unified Messaging*: Introduced the craftersstaff:main channel for seamless communication between servers and the proxy. Shared MySQL Backend*: Real-time synchronization of staff lists, notes, and punishments across your entire network.

Dynamic Commands System

YAML-Driven Commands*: All definitions moved from plugin.yml to commands.yml. Runtime Registration*: Commands are injected via Bukkit's CommandMap using your custom names and aliases. Flexible Renaming: Disable or rename any command without recompiling. (Note: Name changes require a full server restart for stability).*

Network-Aware Moderation

Global Staff Chat*: When using Velocity, staff chat is broadcasted across all connected servers in the network. Contextual Alerts*: Added a server-name option. X-Ray and TPS alerts now identify the specific server (e.g., [Survival-1]) when running behind a proxy. Proxy Forwarding*: The Velocity layer ensures that alerts reach every online staff member, regardless of which server they are currently moderating. Created with ❤️ by xUnknowns [Official Documentation](https://craftersstaff.netlify.app) | [Support & Donations](https://www.paypal.com)

Version 9.4.0 - The Customization Update

Fully Configurable GUIs (YAML Menus)

Dynamic Menus*: All core interfaces (staff_list, staff_detail, reports, notes) are now driven by YAML configuration. Full Customization*: Menu size, items, materials, names, and lores can be modified without restarting or recompiling. Flexible Layouts*: Staff list GUI now supports configurable inventory sizes directly from the menu files.

Staff Mode Quality of Life

Navigation*: Added a dedicated back button in the Staff Detail menu, fully defined in YAML. Safety First*: Per-slot actions in Staff Detail are now explicit and safer, preventing self-action errors on decorative items. Inventory Protection*: Strengthened protection inside Staff menus to prevent moving or taking GUI items.

Staff Tools & Anti-Spam

Hardened Protection*: Staff mode tools can no longer be moved between slots or swapped while active. Drop Prevention*: Dropping a staff tool is blocked and no longer triggers the tool’s action. Clean Chat*: Removed "cannot move/drop item" spam, keeping only essential feedback for the staff.

Reports & Navigation Fixes

Consistent GUI*: Fixed fast page-switching issues in the reports menu caused by decorative items. Reliable Arrows*: Navigation arrows now behave consistently and change pages only when intended.

TPS Alerts & Stability

Translation Sync*: Corrected TPS alert message keys to use alerts.tps.alert across all supported languages. Anti-Spam Logic*: TPS alerts now strictly respect check-interval and alert-staff settings. Modern Support*: Improved overall robustness of the TPS monitoring task on the latest Paper/Spigot versions.

Version 9.0.0

Massive Translation Synchronization (Full Multilingual Support)*: Synced 7 Languages*: English (EN), Spanish (ES), German (DE), French (FR), Polish (PL), Portuguese (PT), and Russian (RU) are now 100% in sync. YAML Syntax Overhaul*: Fixed critical indentation and formatting errors in message_es.yml, message_de.yml, and others. Localization Consistency*: Ensured every single key from the English reference exists in all other files. Variable Preservation*: Verified that all variable placeholders (e.g., {player}, {prefix}) are correctly formatted and preserved across translations. Leftover Cleanup*: Removed Spanish/English leftover text from German and French translation files. Advanced Persistence & Core Stability*: Vanish State Persistence*: A highly requested feature! If a staff member leaves the server while vanished, they will remain vanished upon rejoining. Intelligent Join Handling*: The plugin now detects active staff/vanish states during login and applies all necessary effects (hide player, fly mode, gamemode) before the player fully spawns. Zero-Duplicate Messaging*: Optimized internal state triggers. You will no longer see double "Staff mode enabled" or "You are now invisible" messages when joining with those modes active. Improved Memory Management*: Refactored cleanup logic to prevent clearing active states while a player is briefly disconnected, ensuring data integrity. Critical Bug Fixes*: Command Registration Fix*: Resolved a NullPointerException that could occur on startup if certain commands (/report, /staffchat) were not properly initialized in plugin.yml. Item Definition Fixes*: Restored missing player-head items in the Portuguese menu and fixed broken item names in the Spanish configuration. Alert System Correction*: Fixed diamond and netherite mining alerts in Spanish which were showing generic or incorrect messages. TPS Alert Logic*: Completed and corrected the TPS/Lag alert sections in all language files. Refined Developer API & Internal Logic*: Silent State Methods*: Added setVanished(Player, boolean, boolean silent) to allow internal state changes without spamming player chat. Database Synchronization*: Improved the handshake between SQLite/MySQL and the in-memory state during the join event.

Version 8.5.9

Advanced Note Management*: * Added note statuses (PENDING, IN_PROGRESS). New Interaction: Left-click to delete, Right-click to toggle status, Shift+Right-click* to request attendance. Security*: Only note creators can delete their notes (unless craftersstaff.note.admin is used). Collaboration*: Send requests to note owners; use /note accept to approve. Discord Webhooks*: Added Enable: true/false toggles for all event types. Fixes*: * Fixed staff list default language. * Fixed /note tab completion. * Fixed Shift + Right Click logic for note requests.

Version 8.5.8

* Added support for 1.21.x. * Fixed some minor bugs.

v8.9.0: The Communication & Organization Update

This update brings essential tools for better moderation workflow and staff organization.

New Features

❄️ Isolated Frozen Chat: Communication with frozen players is now private and isolated*. When you freeze a player, a 1:1 chat channel* is created between you and them. * Other frozen players/staff cannot see these messages. * Chat session auto-closes if the player quits or is unfrozen. 📝 Note System: Keep track of player behavior with the new /note* command! Add Notes*: /note add <player> <text> (Persistent storage). Manage Notes*: /note list opens a paginated GUI. Secure*: Only the creator or admins can remove notes. 🔔 Auto-Update Checker*: Never miss an update! * Admins are notified on join if a new version is available on Spigot. * Includes a direct download link. * Toggleable in config.yml. 🎨 Menu Overhaul*: * Cleaner UI for Staff/Player lists with Gray Stained Glass borders. Staff Detail Menu*: Statuses now use clean symbols (/✘) instead of text. Added support for Custom Base64 Heads* in menus (material: basehead). 🇧🇷 Portuguese Translation*: fully updated message_pt.yml including all new features. 🌐 Localization Improvements*: Added multilingual comments to configuration files for easier editing.

CraftersStaff v8.5.0 - Code Optimization & Translation Update

This update focuses on code quality, full translation support, and critical bug fixes to improve overall stability and user experience.

New Features

Advanced Color System

- MiniMessage format support (<red>, <gradient>) - Hex colors (&#RRGGBB) - Legacy colors (&a, &c) - All messages support advanced formatting

Mining Alert System

- Configurable watched blocks list - Threshold-based detection - Discord webhook integration - Staff notifications with craftersstaff.alerts.view permission

TPS Monitoring

- Real-time server TPS tracking - Automatic alerts when TPS drops below threshold - Discord webhook notifications - Compatible with both Spigot and Paper

Unified Alert System

- Centralized webhook configuration - Active staff receive in-game alerts - Fully customizable Discord embeds - Complete messages section in config.yml

Bug Fixes

Flight System

- Fixed Staff Mode incorrectly leaving flight enabled - Flight now properly disables when exiting Staff Mode - Creative and Spectator modes correctly retain flight ability

Menu Translation Errors

- Fixed red error messages in player list menu - Fixed missing translations in staff info menu - ConfigManager now properly reloads language files - Eliminated need for double server restart

Duplicate Messages

- Removed duplicate chat messages - Cleaned up all hardcoded text strings - All messages now use translation files

Item Duplication

- Fixed staff items duplicating in inventory - Proper item management when toggling Staff Mode

TPS Calculation

- Reflection-based TPS retrieval for Spigot compatibility - Fixed Bukkit.getTPS() incompatibility - Universal support for Spigot and Paper

Improvements

Complete Code Revision

- Full codebase scan and cleanup - Removed duplicate code blocks - Performance optimizations throughout

Translation System Overhaul

- All hardcoded messages replaced with translation keys - InvSeeCommand, StaffMenuListener, ChatListener fully translated - PlayerListener and StaffMenuBuilder support translations - Complete Spanish and English support

Configuration Translation

- Complete config.yml rewritten in English - All comments and explanations translated - Clearer structure and documentation

Menu Interface

- Staff list uses Green (Active) and ✘ Red (Disabled) - Automatic prefix stripping from ranks - Clean and professional appearance

Documentation

- updates.yml updated with v8.5.0 changelog - Complete history of changes documented

Configuration Updates

New Alert Configuration

alerts:
  mining:
    watched-blocks: [DIAMOND_ORE, DEEPSLATE_DIAMOND_ORE, ANCIENT_DEBRIS]
    threshold: 5
    interval: 300
  tps:
    enabled: true
    threshold: 18.0
    check-interval: 60

discord:
  webhook-url: "your-webhook-here"
  messages:
    mining-title: "Mining Alert"
    tps-title: "TPS Warning"

Technical Details

- ColorUtils implementation for advanced formatting - Reflection-based TPS monitoring - Smart language file reloading - Optimized performance across all systems Version: 8.5.0 Compatibility: Minecraft 1.21+ (Paper/Spigot) Status: Stable Release Languages: English, Spanish, Portuguese