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