ВЕРСИИ (20)

## CraftersStaff v2.7 — Changelog ### New Features & Changes **1. Crafters Synergy API (Inter-Plugin Security)** - Implemented and finalized the "Crafters Synergy" API, allowing other plugins in the suite (such as CraftersLogin) to safely interact with the StaffMode and Vanish systems. - CraftersStaff now registers its API through Bukkit's service manager, allowing CraftersLogin to consume it without requiring a hard dependency. - Added a secret-key-based security system in the configuration. External API requests are automatically blocked if the secret key sent by the requesting plugin doesn't match the one configured in CraftersStaff, preventing abuse from malicious plugins. **2. State Stability Improvements (Vanish/StaffMode)** - The API allows temporarily suspending and silently re-enabling moderation modes. - This fixes visibility and bypass issues during CraftersLogin's authentication flow, ensuring staff members are never invisible or able to move while on the authentication screen. - Mode restoration is fully transparent and does not notify the rest of the server. **3. Code Cleanup & Optimization** - Removed irrelevant blank messages and standardized the use of internal components. - Bumped the base version to 2.7.

## 🛠️ 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: ```java // 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 ```java 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 ```yaml 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