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

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 their current server.

[HR][/HR]

Version 9.4.0

• Fully Configurable GUIs (YAML Menus):
  • All core menus (staff_list, staff_detail, reports, notes) are now driven by YAML.
  • Menu size, items, materials, names and lores can be customized without recompiling.
  • Staff list GUI supports configurable inventory size directly from the menu configuration.
• Staff Detail & Staff Mode Quality of Life:
  • Added a dedicated back button in the Staff Detail menu, with behavior fully defined in YAML.
  • Per-slot actions in Staff Detail are now explicit and safer (no more self-action errors on decorative items or back buttons).
  • Strengthened inventory protection inside Staff menus to avoid moving or taking GUI items.
• Staff Tools Protection & Anti-Spam:
  • Staff mode tools can no longer be moved between slots or swapped with other items while staff mode is active.
  • Dropping a staff tool is blocked and no longer triggers the tool’s action.
  • Removed noisy "cannot move/drop item" chat spam and kept only the relevant staff feedback.
• Reports & Navigation Fixes:
  • Fixed fast page-switching issues in the reports GUI caused by decorative crystals.
  • Navigation arrows now behave consistently and only change pages when intended.
• TPS Alerts & Stability:
  • Corrected TPS alert message keys to use alerts.tps.alert across all languages.
  • TPS alerts now respect tps-alerts.check-interval and tps-alerts.alert-staff, avoiding message spam.
  • Improved overall robustness of the TPS monitoring task on modern 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
    Code (Text):

    message_es.yml
    ,
    Code (Text):

    message_de.yml
    , etc.
  • Localization Consistency: Ensured every single key exists in all language files with preserved variables.
• Advanced Persistence & Core Stability:
  • Vanish State Persistence: Staff remain vanished upon rejoining the server.
  • Intelligent Join Handling: Active states (staff/vanish) are applied instantly during login.
  • Zero-Duplicate Messaging: No more double messages in chat when joining with active modes.
• Critical Bug Fixes:
  • Fixed critical
    Code (Text):

    NullPointerException
    on startup (command registration).
  • Restored missing player-head items in Portuguese menus.
  • Fixed diamond/netherite mining alerts and TPS/Lag sections in multiple languages.
• Internal Optimization: Refactored memory management and added silent state methods to the API.

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
    Code (Text):

    craftersstaff.note.admin
    is used).
  • Collaboration: Send requests to note owners; use
    Code (Text):

    /note accept
    to approve.
• Discord Webhooks: Added
  Code (Text):

  Enable: true/false
  toggles for all event types.
• Fixes:
  • Fixed staff list default language.
  • Fixed
    Code (Text):

    /note
    tab completion.
  • Fixed
    Code (Text):

    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:
    Code (Text):

    /note add <player> <text>
    (Persistent storage).
  • Manage Notes:
    Code (Text):

    /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
    Code (Text):

    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 (
    Code (Text):

    material: basehead
    ).
• Portuguese Translation: fully updated
  Code (Text):

  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
Full Color System Support
• MiniMessage format (<red>, <gradient>)
• Hex colors (&#RRGGBB)
• Legacy colors (&a, &c)
• All messages support advanced formatting

Mining Alert System
• Configurable watched blocks list
• Threshold-based alerts
• Discord webhook integration
• Staff notifications with craftersstaff.alerts.view permission

TPS Monitoring
• Real-time server TPS tracking
• Automatic alerts when TPS drops
• Discord webhook notifications
• Compatible with Spigot and Paper

Unified Alert System
• Centralized webhook configuration
• Active staff receive in-game alerts
• Fully customizable Discord embeds
• Messages section in config.yml

Bug Fixes
Flight Bug Fixed
• Staff Mode no longer leaves flight enabled incorrectly
• Flight now properly disables when exiting Staff Mode
• Exception: Creative and Spectator modes retain flight

Menu Translation Errors
• Fixed red error messages in player list menu
• Fixed missing translations in staff info menu
• ConfigManager now properly reloads language files
• No more double server restart needed

Duplicate Messages
• Removed duplicate chat messages
• Cleaned up 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
• Works on both 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
• Both Spanish and English fully supported

Config 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

Updates.yml
• Version 8.5.0 changelog added
• Complete history of changes documented

⚙️ Configuration Updates
New Sections:

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

CraftersStaff v8.0.0 - Command Restructure & Clean UI
This update represents one of many improvements we have planned for the future. We're committed to making CraftersStaff the best staff management plugin available.

✔ New Features
Command Restructure

• Centralized all commands under /staff
• /staff list - Staff menu (previously /stafflist)
• /staff chat - Toggle staff chat (previously /staffchat)
• /staff players - Player list menu (NEW)
• Smart tab completion based on permissions

Self-Action Protection

• Players cannot ban themselves from menu
• Players cannot freeze themselves from menu
• Players cannot teleport to themselves from menu
• Error message: "You cannot perform this action on yourself"

Discord Webhook Formats

• New config.yml option to choose webhook format
• embed - Rich embeds with colors and fields (professional)
• message - Plain text format (simple)

Bug Fixes
Menu Visual Cleanup

• Removed [CraftersStaff] prefix from all menu labels
• Before: [CraftersStaff] Rank:, [CraftersStaff] World:
• After: Rank:, Mundo:, Pos:, Estado: (clean and translatable)
• Fixed hardcoded labels ("Argent" → "Dinero")
• All menu text now uses language files

Player Name Detection

• Fixed invisible spaces in player names causing "Player Not Found" errors
• Click detection on player heads now works correctly
• Commands execute properly from menu clicks

Server Startup

• Fixed critical NullPointerException on server start
• Plugin loads correctly with new command structure
• Stable initialization process

Frozen Chat Format

• Improved private chat between staff and frozen players
• Cleaner message format
• Better readability

✘ Removed
Annoying Inventory Messages

• Removed spam messages when opening player inventories
• Removed spam messages when opening ender chests
• Silent inventory inspection for staff

Hardcoded Prefixes

• Removed all hardcoded [CraftersStaff] prefixes in menus
• ConfigManager no longer adds prefixes to menu labels

Old Command Structure

• /stafflist removed (use /staff list)
• /staffchat removed (use /staff chat)

Version Management
Unified Release

• All patches from 8.0.1 and 8.0.2 merged into 8.0.0
• Single stable release
• Updated updates.yml with complete changelog

Version: 8.0.0
Status: Stable Release
Future: This is one of many improvements planned - stay tuned for more updates!

CraftersStaff v7.8.9 - Enhanced Freeze System & Critical Fixes
New Features
Complete Freeze System Overhaul
Total Command Block

• Frozen players can no longer use ANY commands
• Complete interaction lockdown
• Players cannot interact with the environment while frozen
• Prevents any form of evasion or manipulation

Recurring Warning Messages

• Automatic warning message every 10 seconds in chat
• Displays Discord server link for appeals
• Keeps frozen players informed of their status
• Configurable message interval and content

Private 1v1 Chat System

• Exclusive communication channel between staff member and frozen player
• Staff who freezes can communicate privately with the frozen player
• Messages don't appear in public chat
• Allows for private questioning and investigation
• Format: Staff can type normally, frozen player sees messages
• Frozen player can respond using chat

Anti-Evasion System (Auto-Ban on Disconnect)

• Automatic ban if frozen player disconnects
• Prevents players from avoiding punishment by logging out
• Fully configurable ban command in config.yml
• Compatible with any ban plugin (Essentials, LiteBans, AdvancedBan, etc.)
• Default command: ban %player% 10d Evadir Sancion
• %player% placeholder automatically replaced with player name

Critical Bug Fixes
Blaze Rod Double Interaction Fixed

• Fixed critical bug: Blaze rod was freezing and immediately unfreezing players
• Players would instantly toggle between frozen/unfrozen states
• Now works correctly - single click freezes, another click unfreezes
• No more accidental instant unfreeze
• Smooth and predictable behavior

Hardcoded French Message Removed

• Removed hardcoded message "Vous ne pouvez pas interagir en étant gelé!"
• All messages now properly use language files
• Full translation support working correctly
• No more mixed language messages

Duplicate Invisibility Messages Fixed

• Fixed duplicate vanish/invisibility messages when players join
• Players no longer see multiple "You are now invisible" messages
• Clean single message on vanish toggle
• Better user experience

Help Command Prefix Removed

• Removed unnecessary [CraftersStaff] prefix from help command
• Cleaner help command output
• Uses only the configured prefix from language files
• More professional appearance

Compilation Errors Fixed

• Resolved all internal compilation errors
• Plugin compiles cleanly without warnings
• Stable and production-ready
• All dependencies properly configured

⚙️ New Configuration Options
Freeze Ban on Disconnect Configuration
freeze:
ban-on-quit:
enabled: true # Enable/disable auto-ban on disconnect
command: "ban %player% 10d Evadir Sancion" # Customizable ban command

Configuration Examples:

For Essentials:

command: "ban %player% 10d Disconnected while frozen"

For LiteBans:

command: "ban %player% 10d Freeze evasion -s"

For AdvancedBan:

command: "tempban %player% 10d Evaded freeze check"

For Vanilla:

command: "ban %player% Disconnected while frozen"

Recurring Freeze Messages
freeze:
recurring-message:
enabled: true
interval: 10 # seconds
message: "&cYou are frozen! Join our Discord for appeals: discord.gg/yourserver"

Private Chat System
freeze:
private-chat:
enabled: true
format-staff: "&8[&6Freeze Chat&8] &7You &8→ &c{player}&7: {message}"
format-player: "&8[&6Freeze Chat&8] &e{staff} &8→ &7You&7: {message}"

Updated Files
config.yml Updates

• Added freeze.ban-on-quit section
• Added freeze.recurring-message section
• Added freeze.private-chat section
• Improved freeze system documentation

updates.yml

• Added complete changelog for v7.8.9
• Documented all new features
• Listed all bug fixes
• Updated version history

Technical Improvements
Freeze System Architecture

• Complete refactor of freeze detection logic
• Better event handling for player interactions
• Improved command blocking system
• More robust disconnect detection
• Thread-safe freeze state management

Message System

• Removed all hardcoded messages
• Full internationalization support
• Consistent message formatting
• Proper placeholder replacement

Performance

• Optimized recurring message task
• Efficient freeze state checking
• Minimal impact on server performance
• Proper task cleanup on unfreeze

Use Cases
Investigation Scenario

1. Staff member suspects player of cheating
2. Staff uses blaze rod to freeze player
3. Player receives recurring message with Discord link
4. Staff uses private chat to question player
5. If player disconnects → automatic ban
6. If innocent → staff unfreezes player

Moderation Scenario

1. Player breaks rules
2. Staff freezes player for investigation
3. Player cannot run commands or interact
4. Player sees warning every 10 seconds
5. Staff decides punishment
6. If player tries to escape by disconnecting → banned

✅ Changes Summary
Added:

• Total command block for frozen players
• Recurring warning messages every 10 seconds
• Private 1v1 chat between staff and frozen player
• Auto-ban system when frozen player disconnects
• Fully configurable ban command
• Enhanced freeze state management

Fixed:

• Blaze rod double interaction (instant freeze/unfreeze)
• Hardcoded French message removed
• Duplicate invisibility messages on join
• Unnecessary prefix in help command
• All compilation errors resolved

Improved:

• Freeze system reliability
• Message consistency
• Code organization
• Performance optimization
• User experience

Configured:

• Ban-on-disconnect system
• Recurring message intervals
• Private chat formatting
• All customizable via config.yml

Installation
File: CraftersStaff-v7.8.9.jar

New Installation:

1. Download CraftersStaff-v7.8.9.jar
2. Place in plugins/ folder
3. Restart server
4. Configure freeze settings in config.yml
5. Test freeze system

Updating from Previous Version:

1. Stop server
2. Replace old JAR with CraftersStaff-v7.8.9.jar
3. Start server
4. Config auto-updates with new freeze options
5. Review and customize ban command
6. Test new freeze features

⚠️ Important Notes

• Configure ban command for your specific ban plugin
• Test freeze system on test server first
• Inform staff about new private chat feature
• Set appropriate ban duration for your server rules
• Discord link in recurring message is customizable

Version: 7.8.9
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Status: Stable Release
Critical Fixes: Yes - Blaze rod bug resolved
Major Feature: Complete freeze system overhaul
Breaking Changes: None - Fully backward compatible
Recommended: Yes - Critical bug fixes included

CraftersStaff v7.6.2 - Major Feature Update & Complete Overhaul
New Features
Advanced Staff List Menu

• Created a new fully customizable menu: menus/staff_list.yml
• Fixed Player Heads: Menu now correctly renders player skins instead of Steve heads
• Completely translatable by users
• Clean and professional interface for managing online staff
• Easy to customize items, layout, and appearance

New Command: /invsee

• Added /invsee <player> command for quick inventory inspection
• Permission: craftersstaff.invsee
• Faster alternative to the menu-based inventory viewer
• Works with both online and offline players

Mining Alerts System

• Diamond Mining Alerts: Configurable alerts when players mine diamonds
• Netherite Mining Alerts: Configurable alerts for ancient debris/netherite mining
• Customizable threshold for alerts (e.g., alert after 5 diamonds mined)
• Both in-game staff notifications and Discord webhook support
• Helps detect X-ray and suspicious mining patterns
• Full configuration in config.yml

Server Lag Alerts

• Real-time TPS monitoring with automatic alerts
• Alerts when server TPS drops below configured threshold
• In-game notifications for staff members
• Discord webhook integration for remote monitoring
• Customizable TPS threshold and alert intervals
• Helps identify performance issues quickly

Discord Integration Enhanced

• Webhooks for mining alerts (Diamond and Netherite)
• Webhooks for lag/TPS alerts
• Rich embed messages with detailed information
• Configurable webhook URLs per alert type
• Asynchronous sending (doesn't block server)

Non-Destructive Config Updater

• Intelligent configuration migration system
• Automatically adds missing configuration options when updating
• Preserves all existing settings - never overwrites your customizations
• Works for config.yml and all language files
• Seamless updates without manual configuration editing
• Version tracking to prevent duplicate updates

Complete Translation Support

• All new features fully translated in Spanish and English
• message_es.yml and message_en.yml updated
• Easy to add more languages
• Consistent translation system across entire plugin

Bug Fixes
Staff Mode Restriction Messages Silenced

• Removed spam messages when breaking blocks in staff mode
• Removed spam messages when hitting mobs in staff mode
• Cleaner experience - actions are blocked silently
• No more chat clutter while in staff mode

Staff Chat Tags/Prefixes Fixed

• Completely fixed the issue where rank prefixes weren't showing
• Staff chat now correctly displays rank prefixes from Vault/LuckPerms
• Uses the format defined in language files
• Proper placeholder replacement for {rank_prefix}
• Compatible with all permission plugins

Action Bar Format Updated

• New improved format: Invisibility: (✔/✘) Staff Chat: (✔/✘) TPS: 20.00
• More professional and cleaner appearance
• Fully translatable via language files
• Real-time TPS display with 2 decimal precision
• Color-coded status indicators

Help Command Translation

• Fixed /craftersstaff help to use language files
• No more hardcoded English text
• Fully supports Spanish and English
• Consistent with rest of plugin translations

Improvements
Instant Reload System

• /craftersstaff reload now applies ALL changes instantly:
  • Configuration files (config.yml)
  • Language files (message_es.yml, message_en.yml)
  • Menu files (staff_list.yml)
  • Staff mode items
  • All managers and systems
• No server restart needed for any changes
• Faster workflow for server administrators
• Test changes immediately

Player Head Rendering

• Fixed player heads in staff list menu showing correct skins
• Uses proper Bukkit API for skull textures
• Supports both online and offline player skins
• Cached for better performance

Alert System Architecture

• New AlertManager for centralized alert handling
• New MiningListener for ore mining detection
• New LagTask for TPS monitoring
• Modular design for easy expansion
• Performance optimized with async operations

⚙️ New Configuration Options
Mining Alerts Configuration
alerts:
mining:
enabled: true
diamonds:
enabled: true
threshold: 5 # Alert after 5 diamonds
discord-webhook: true
netherite:
enabled: true
threshold: 3 # Alert after 3 ancient debris
discord-webhook: true

Lag Alerts Configuration
alerts:
lag:
enabled: true
tps-threshold: 18.0 # Alert if TPS < 18
check-interval: 60 # Check every 60 seconds
discord-webhook: true

Discord Webhooks
discord:
mining-alerts-url: "your-webhook-url"
lag-alerts-url: "your-webhook-url"

Action Bar Format
action-bar:
format: "&fInvisibility: &7({vanish}) &fStaff Chat: &7({staffchat}) &fTPS: &7({tps})"

New Commands

Command Description Permission
/invsee <player> View player inventory craftersstaff.invsee
New Permissions

• craftersstaff.invsee - Use /invsee command
• craftersstaff.alerts.mining - Receive mining alerts
• craftersstaff.alerts.lag - Receive lag alerts

New Configuration Files
menus/staff_list.yml

• Fully customizable staff list menu
• Control title, size, items, lore
• Support for placeholders
• Easy to translate

Technical Improvements
Code Structure

• New AlertManager class for alert management
• New MiningListener for ore detection
• New LagTask for TPS monitoring
• Better separation of concerns
• Cleaner, more maintainable code

Performance

• Optimized player head rendering with caching
• Async Discord webhook sending
• Efficient TPS calculation
• Minimal impact on server performance

Config Management

• Smart config updater that preserves user settings
• Version tracking in configuration
• Automatic addition of new options
• Backward compatible with old configs

Installation & Update
File: CraftersStaff-v7.6.2.jar

New Installation:

1. Download CraftersStaff-v7.6.2.jar
2. Place in plugins/ folder
3. Restart server
4. Configure as needed
5. Use /craftersstaff reload to apply changes

Updating from Previous Version:

1. Stop server
2. Replace old JAR with CraftersStaff-v7.6.2.jar
3. Start server
4. Config auto-updates - all your settings preserved
5. New options added automatically with defaults
6. Review new features in config.yml

✅ Changes Summary
Added:

• Staff list menu with working player heads
• /invsee command
• Mining alerts (Diamond & Netherite)
• Lag/TPS alerts
• Discord webhooks for alerts
• Non-destructive config updater
• Complete translation system

Fixed:

• Staff chat tags/prefixes not showing
• Player heads showing Steve instead of skins
• Block breaking messages spam in staff mode
• Mob hitting messages spam in staff mode
• Help command not using translations
• Action bar format inconsistencies

Improved:

• Instant reload system for all configs
• Action bar display format
• Alert system architecture
• Config management
• Translation coverage
• Code organization

Optimized:

• Player head rendering
• Alert processing
• Config loading
• Memory usage
• Performance impact

Version: 7.6.2
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Status: Stable Release
Major Update: Yes - Multiple new systems
Breaking Changes: None - Fully backward compatible
Optional Dependencies: Vault, LuckPerms, ProtocolLib (for enhanced features)

CraftersStaff v7.5.0 - GameMode Persistence & Staff Chat Improvements
New Features
GameMode Persistence System

• The plugin now saves the player's GameMode before activating Staff Mode
• Restores the original GameMode when deactivating Staff Mode (Creative, Adventure, etc.) instead of forcing Survival
• If the player was in Creative, they will return to Creative
• If no previous data exists (first time), defaults to Survival for safety
• Intelligent state management for better user experience

Staff Chat Prefix System

• Fixed prefix issues in Staff Chat
• Added support for {rank_prefix} placeholder that retrieves the player's rank prefix from Vault
• Chat format now respects the configuration in message_es.yml
• To display rank in chat, use {rank_prefix} in the format configuration
• Full LuckPerms/Vault integration for rank display

Bug Fixes
Inventory Messages Removed

• Eliminated "Inventory saved" and "Inventory restored" messages when toggling staff mode
• Cleaner and less spammy user experience
• Staff mode toggle is now more seamless

Staff Chat Format Fixed

• Corrected prefix display issues in Staff Chat
• Proper placeholder replacement for rank prefixes
• Chat format configuration now works as expected
• Support for custom formats with multiple placeholders

Code Cleanup & Optimization
Configuration System Cleanup

• Removed obsolete messages.yml file
• Plugin now exclusively uses the lang/ folder structure
• message_es.yml and message_en.yml for multi-language support
• Cleaner configuration management

General Logic Verification

• Reviewed entire codebase for potential errors
• Improved error handling in critical sections
• Better state management for player data

Build Optimization

• Generated optimized CraftersStaff-v7.5.0.jar
• Uses Libby to download heavy dependencies (SQLite) at runtime
• Reduced JAR file size significantly
• Faster server startup times

Technical Details
GameMode State Management

• Stores original GameMode in database before Staff Mode activation
• HashMap cache for quick access during session
• Automatic cleanup when player disconnects
• Fallback to Survival if no saved state exists

Placeholder System

• New {rank_prefix} placeholder for Vault integration
• Compatible with existing {player}, {message}, etc.
• Supports color codes and formatting
• Works with LuckPerms and other permission plugins

Language System

• Dual language support (Spanish and English)
• Easy to add more languages by creating new YAML files
• Automatic language detection based on configuration
• All messages centralized in language files

⚙️ Configuration Updates
Staff Chat Format Example
staff-chat:
format: "&8[&6StaffChat&8] {rank_prefix}&r{player}&7: &f{message}"

This will display:

[StaffChat] [Admin] PlayerName: Hello staff!

GameMode Persistence
No configuration needed - works automatically!

• Automatically saves GameMode on Staff Mode activation
• Automatically restores on Staff Mode deactivation
• Stored in database for persistence across restarts

Installation
File: CraftersStaff-v7.5.0.jar

Simply replace the old JAR file with the new one and restart your server. Configuration will auto-update if needed.

✅ Changes Summary
Added:

• GameMode persistence system
• {rank_prefix} placeholder support
• Better state management

Fixed:

• GameMode always resetting to Survival
• Staff Chat prefix display issues
• Inventory spam messages

Removed:

• Obsolete messages.yml file
• "Inventory saved/restored" messages

Optimized:

• JAR file size with Libby
• Configuration system
• Code structure and error handling

Version: 7.5.0
Compatibility: Minecraft 1.21+ (Paper/Spigot)
File Size: Optimized
Dependencies: Vault (optional), LuckPerms (optional)

CraftersStaff v7.0.0 'Connector' - Complete optimization for free hosts and new integrations
Important Update Notice
This version 7.0.0 represents a major milestone in CraftersStaff development. During the implementation of new features and optimizations, we encountered several unexpected errors and challenges that required extensive debugging and reworking of core systems. After intensive testing and multiple iterations, we've successfully resolved all critical issues to deliver a stable and optimized release.

New Features
Lazy Loading

• Player data is loaded only when they join the server
• Automatically removed from memory when they disconnect
• Significant reduction in RAM consumption
• Optimized for free hosting environments

Task Batching

• Data saved in batches every 2 minutes
• Instead of individual operations
• 80% reduction in I/O operations
• Reduced database load significantly

Packet-Based Vanish with ProtocolLib

• More efficient packet-based vanish
• Up to 40% fewer resources than traditional hidePlayer
• Better performance on older versions
• Automatic ProtocolLib detection with fallback to traditional vanish

PlaceholderAPI - Full Integration

• 9 new placeholders available:
  • %craftersstaff_staffmode%
  • %craftersstaff_staffmode_status%
  • %craftersstaff_vanish%
  • %craftersstaff_vanish_status%
  • %craftersstaff_frozen%
  • %craftersstaff_frozen_status%
  • %craftersstaff_full_status%
  • %craftersstaff_staff_count%
  • %craftersstaff_vanish_count%
• Compatible with TAB, DeluxeChat and other plugins

EssentialsX / CMI Compatibility

• Automatic external vanish detection
• Prevents double invisibility conflicts
• External vanish verification system

Quick Ban from Menu

• Integration with LiteBans and AdvancedBan
• Quick ban button from staff menu
• Executes commands from installed ban plugin

Staff Chat with RGB Colors

• Hex Colors support via IridiumColorAPI
• Hexadecimal colors and gradients
• Compatible with 1.16+ servers
• Customizable RGB format

Command Whitelist

• Blocks non-moderation related commands
• 26 allowed commands by default in staff mode
• Anti-abuse system to prevent staff from playing while on duty
• Bypass permission: craftersstaff.commandwhitelist.bypass

Discord Webhooks

• Automatic notifications to Discord
• Events: clearchat, freeze, unfreeze, staffmode, ban
• Basic system with configurable URL in config.yml
• Asynchronous tasks (doesn't block the server)

Auto Spectator Mode

• Option to automatically switch to /gamemode spectator
• When activating staff mode
• Returns to previous mode when exiting
• Configurable in config.yml

Real-Time Action Bar

• Shows information in the action bar
• Vanish status, staff mode and TPS
• Real-time updates
• Cleaner than chat messages

Data Cache Manager

• Intelligent cache management
• Auto-save every 5 minutes
• ConcurrentHashMap for thread-safety
• Cache system with last access timestamp

External Vanish Detector

• Detects vanish from other plugins
• Prevents invisibility conflicts
• Compatible with multiple vanish plugins

Critical Bug Fixes
Action Bar Flickering Issue - RESOLVED
During development, we encountered a critical visual bug where the Action Bar would flicker or appear desynchronized when updating in real-time. This issue was particularly noticeable on servers with higher player counts or lower TPS.

The Problem:

• Action Bar messages were being sent too frequently
• Multiple concurrent updates caused visual "lag"
• Text would flicker between different states
• Created a distracting and unprofessional experience for staff members

The Solution:

• Implemented a throttling system for Action Bar updates
• Added intelligent update scheduling to prevent overlapping sends
• Optimized the update frequency to balance responsiveness with stability
• Completely eliminated the visual desynchronization

Result: The Action Bar now updates smoothly without any flickering, providing a clean and professional real-time status display.

Action Bar Message Spam on Staff Mode Disable - FIXED
Another issue we discovered was excessive messaging when staff members disabled their staff mode.

The Problem:

• When disabling staff mode, players would see "Staff Mode: OFF" in both chat AND Action Bar
• This created redundant messages and cluttered the player's screen
• The Action Bar message was unnecessary since the status bar would disappear anyway
• Players reported it felt "spammy" and intrusive

The Solution:

• Removed the "Staff Mode: OFF" message from the Action Bar
• Kept only the chat message for confirmation
• Action Bar now cleanly disappears when staff mode is disabled
• More intuitive user experience

Result: Staff mode disable is now cleaner with a single confirmation message in chat, eliminating visual clutter.

Staff Mode Persistence Issues - RESOLVED
During testing, we encountered unexpected behavior with staff mode state persistence across server restarts and player reconnections.

The Problem:

• Staff mode state wasn't being saved properly to database
• Players reconnecting would lose their staff mode status
• This forced staff members to manually re-enable staff mode after each disconnect
• Caused frustration during server maintenance or network issues

The Solution:

• Implemented new restore-on-rejoin configuration option
• Added robust state saving to database before player disconnect
• Created automatic state restoration system on player join
• Added proper error handling for edge cases

Configuration Added:

staff-mode:
restore-on-rejoin: true # Auto-restore staff mode on reconnect

Result: Staff members can now disconnect and reconnect without losing their staff mode status, maintaining continuity during moderation duties.

⚡ Database Optimizations
Optimized SQLite

• PRAGMA journal_mode=WAL
• PRAGMA synchronous=NORMAL
• PRAGMA cache_size=10000
• WAL mode for better concurrency
• PreparedStatement with batch for multiple insertions

Database Connection Issues - RESOLVED
Multiple unexpected database-related errors occurred during development that required significant refactoring.

Challenges Encountered:

• Connection pool exhaustion under load
• Database locks during concurrent operations
• Transaction rollback failures
• Memory leaks from unclosed connections

Solutions Implemented:

• Complete rewrite of database connection management
• Implementation of proper connection pooling
• Added automatic connection cleanup
• Implemented transaction retry logic
• Added comprehensive error logging for debugging

New Commands and Permissions
Commands

• /staffchat - Dedicated chat for staff (alias: /sc)

Permissions

• craftersstaff.staffchat - Use staff chat
• craftersstaff.commandwhitelist.bypass - Bypass command whitelist
• craftersstaff.quickban - Use quick ban system

⚙️ Updated Configuration
config.yml v7.0.0 - New Sections

• staff-chat: RGB chat configuration
• command-whitelist: Allowed commands list
• discord: Webhook configuration
• integrations: PlaceholderAPI, EssentialsX/CMI, LiteBans/AdvancedBan
• action-bar: Action bar configuration
• performance: Optimizations (lazy loading, batch interval, packet-vanish)
• auto-spectator: Auto spectator mode
• restore-on-rejoin: Staff mode persistence (NEW)

Automatic Configuration Migration
The plugin will automatically update your existing config.yml to version 7.0.0 when you first start the server with this update. Your existing settings will be preserved, and new options will be added with default values.

messages.yml v7.0.0

• Messages for staff-chat
• Command whitelist messages
• Quick ban messages
• Integration messages

plugin.yml v7.0.0

• Extended optional dependencies: PlaceholderAPI, ProtocolLib, Essentials, CMI, LiteBans, AdvancedBan

Performance Improvements

• Reduced RAM consumption with lazy loading
• 80% reduction in I/O operations with batch saving
• Packet-based vanish lighter on servers with many players
• SQLite database optimization in WAL mode
• ConcurrentLinkedQueue for pending save operations
• Eliminated Action Bar flickering and unnecessary updates
• Optimized database connection handling

General Improvements

• Greater compatibility with 6 popular plugins
• Improved security with command whitelist
• Better staff experience with RGB chat and smooth action bar
• Traceability with Discord webhooks
• More modular code with separated managers
• Better error handling with comprehensive try-catch blocks
• All optimizations designed for free hosting environments
• Cleaner visual experience with reduced message spam
• Persistent staff mode state across reconnections

Technical Details

• IridiumColorAPI with fallback to traditional colors
• Reflection for compatibility without hard dependencies
• ProtocolLib PacketContainer for destroy/spawn packets
• Auto-detection of external plugins with softdepend
• Batch saving with transactions and rollback on error
• Throttled Action Bar updates for smooth performance
• Robust state persistence system with error recovery

Development Challenges Overcome
This version required solving several complex technical challenges:

1. Action Bar Update Race Conditions: Resolved through implementation of update throttling and scheduling
2. Database Transaction Conflicts: Fixed with proper transaction management and retry logic
3. Memory Leaks: Eliminated through comprehensive resource cleanup
4. Plugin Compatibility: Achieved through extensive testing with popular plugins
5. State Persistence: Implemented reliable save/restore mechanism across server lifecycles

Installation Notes
File: CraftersStaff-v7.0.0-.jar

When you install this version, the plugin will:

1. Automatically migrate your config.yml to version 7.0.0
2. Add new configuration options with sensible defaults
3. Preserve all your existing settings
4. Create backup of old configuration (optional)

No manual configuration changes are required, though you may want to review the new options to customize them to your needs.

⚠️ Important Notes

• This is a major update with significant internal changes
• Backup your server before updating
• Configuration will auto-update on first startup
• All new features are enabled by default but can be disabled
• Optional dependencies (PlaceholderAPI, ProtocolLib, etc.) enhance functionality but are not required

Version: 7.0.0 'Connector'
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Release Status: Stable
Development Time: Extensive testing and debugging to ensure reliability
Optional Dependencies: Vault, LuckPerms, PlaceholderAPI, ProtocolLib, EssentialsX, CMI, LiteBans, AdvancedBan

CraftersStaff v7.0.0 'Connector' - Complete optimization for free hosts and new integrations
New Features
Lazy Loading

• Player data is loaded only when they join the server
• Automatically removed from memory when they disconnect
• Significant reduction in RAM consumption

Task Batching

• Data saved in batches every 2 minutes
• Instead of individual operations
• 80% reduction in I/O operations

Packet-Based Vanish with ProtocolLib

• More efficient packet-based vanish
• Up to 40% fewer resources than traditional hidePlayer
• Better performance on older versions
• Automatic ProtocolLib detection with fallback to traditional vanish

PlaceholderAPI - Full Integration

• 9 new placeholders available:
  • %craftersstaff_staffmode%
  • %craftersstaff_staffmode_status%
  • %craftersstaff_vanish%
  • %craftersstaff_vanish_status%
  • %craftersstaff_frozen%
  • %craftersstaff_frozen_status%
  • %craftersstaff_full_status%
  • %craftersstaff_staff_count%
  • %craftersstaff_vanish_count%
• Compatible with TAB, DeluxeChat and other plugins

EssentialsX / CMI Compatibility

• Automatic external vanish detection
• Prevents double invisibility conflicts
• External vanish verification system

Quick Ban from Menu

• Integration with LiteBans and AdvancedBan
• Quick ban button from staff menu
• Executes commands from installed ban plugin

Staff Chat with RGB Colors

• Hex Colors support via IridiumColorAPI
• Hexadecimal colors and gradients
• Compatible with 1.16+ servers
• Customizable RGB format

Command Whitelist

• Blocks non-moderation related commands
• 26 allowed commands by default in staff mode
• Anti-abuse system to prevent staff from playing while on duty
• Bypass permission: craftersstaff.commandwhitelist.bypass

Discord Webhooks

• Automatic notifications to Discord
• Events: clearchat, freeze, unfreeze, staffmode, ban
• Basic system with configurable URL in config.yml
• Asynchronous tasks (doesn't block the server)

Auto Spectator Mode

• Option to automatically switch to /gamemode spectator
• When activating staff mode
• Returns to previous mode when exiting
• Configurable in config.yml

Real-Time Action Bar

• Shows information in the action bar
• Vanish status, staff mode and TPS
• Real-time updates
• Cleaner than chat messages

Data Cache Manager

• Intelligent cache management
• Auto-save every 5 minutes
• ConcurrentHashMap for thread-safety
• Cache system with last access timestamp

External Vanish Detector

• Detects vanish from other plugins
• Prevents invisibility conflicts
• Compatible with multiple vanish plugins

⚡ Database Optimizations
Optimized SQLite

• PRAGMA journal_mode=WAL
• PRAGMA synchronous=NORMAL
• PRAGMA cache_size=10000
• WAL mode for better concurrency
• PreparedStatement with batch for multiple insertions

New Commands and Permissions
Commands

• /staffchat - Dedicated chat for staff (alias: /sc)

Permissions

• craftersstaff.staffchat - Use staff chat
• craftersstaff.commandwhitelist.bypass - Bypass command whitelist
• craftersstaff.quickban - Use quick ban system

⚙️ Updated Configuration
config.yml v7.0.0 - New Sections

• staff-chat: RGB chat configuration
• command-whitelist: Allowed commands list
• discord: Webhook configuration
• integrations: PlaceholderAPI, EssentialsX/CMI, LiteBans/AdvancedBan
• action-bar: Action bar configuration
• performance: Optimizations (lazy loading, batch interval, packet-vanish)
• auto-spectator: Auto spectator mode

messages.yml v7.0.0

• Messages for staff-chat
• Command whitelist messages
• Quick ban messages
• Integration messages

plugin.yml v7.0.0

• Extended optional dependencies: PlaceholderAPI, ProtocolLib, Essentials, CMI, LiteBans, AdvancedBan

Bug Fixes

• Fixed: Player data remained in memory after disconnect
• Fixed: Multiple database writes caused lag on large servers
• Fixed: Traditional vanish consumed too many resources on older versions
• Fixed: Invisibility conflicts when using vanish from other plugins
• Fixed: Staff could use game commands while on duty
• Optimized: SQLite now uses optimal configuration for Minecraft servers

Performance Improvements

• Reduced RAM consumption with lazy loading
• 80% reduction in I/O operations with batch saving
• Packet-based vanish lighter on servers with many players
• SQLite database optimization in WAL mode
• ConcurrentLinkedQueue for pending save operations

General Improvements

• Greater compatibility with 6 popular plugins
• Improved security with command whitelist
• Better staff experience with RGB chat and action bar
• Traceability with Discord webhooks
• More modular code with separated managers
• Better error handling with appropriate try-catch
• All optimizations designed for free hosting

Technical Details

• IridiumColorAPI with fallback to traditional colors
• Reflection for compatibility without hard dependencies
• ProtocolLib PacketContainer for destroy/spawn packets
• Auto-detection of external plugins with softdepend
• Batch saving with transactions and rollback on error

Version: 7.0.0 'Connector'
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Optional Dependencies: Vault, LuckPerms, PlaceholderAPI, ProtocolLib, EssentialsX, CMI, LiteBans, AdvancedBan

CraftersStaff v6.0.0 - Complete Staff Management System
New Features
Interactive Management Menu

• Player menu (/staffmenu) with player heads
• Complete information: location, money (Vault), rank (LuckPerms/Vault), status (staff/vanish/freeze)
• Right click: Teleport to player
• Left click: Freeze/unfreeze player
• Shift + Click: View player inventory
• Menu with real-time automatic updates

Clear Chat Command

• /clearchat (aliases: /clear, /cc) to clear server chat
• New permission craftersstaff.clearchat to use the command

TPS Alert System

• Real-time TPS alerts with complete configuration
• Configurable threshold, interval, and staff-only visibility
• Automatic server performance monitoring

Plugin Integration

• Full integration with LuckPerms for permissions and rank display
• Full integration with Vault for economy and permissions
• Compatibility with popular permission managers

Database System

• SQLite database for state persistence
• MySQL support (configurable)
• State persistence between server restarts

Configuration Auto-Update

• Auto-update system for config.yml and messages.yml files
• Detects versions and adds new configurations without deleting existing ones
• Versioned configuration system

Updates File

• New updates.yml file with complete version changelog
• Full history of all updates

⚙️ New Configurations
Staff Mode

• staff-mode.can-break-blocks - Allow breaking blocks in staff mode (default: false)
• staff-mode.can-open-chests - Allow opening chests in staff mode (default: true)
• staff-mode.silent-chest-opening - Silent chest opening (default: true)
• staff-mode.can-damage-entities - Allow damaging entities in staff mode (default: false)
• staff-mode.invisible-to-mobs - Invisibility to mobs in staff mode (default: true)
• staff-mode.restore-on-rejoin - Automatic staff mode restoration on reconnect (default: true)

Vanish Mode

• vanish-mode.invisible-to-mobs - Invisibility to mobs in vanish mode (default: true)

Advertising

• ads.show-startup-ads - Show/hide Spigot startup messages (default: true)

New Permissions

• craftersstaff.view - Allows viewing other players in staff mode
• craftersstaff.vanish.view - Allows viewing other players in vanish mode
• craftersstaff.clearchat - Allows using the /clearchat command

️ Implemented Protections
Staff Mode Item Protection

• Staff mode items are completely protected
• Cannot be dropped by the player
• Cannot be moved by other players
• Cannot be deleted
• Multi-level protection against external manipulation
• If someone opens a staff's inventory in staff mode, they cannot move protected items

Inventory Protection

• Complete staff mode inventory protection system
• Prevention of manipulation by other players or plugins

Bug Fixes

• Fixed repetitive advertising messages issue (now configurable)
• Protection against staff item manipulation by other players
• Fixed vanish player visibility according to permissions
• Better data persistence handling with SQLite
• Improved staff mode inventory management

Improvements and Optimizations
Performance

• Implemented optimization system with caching
• General performance improvements
• Cache system for optimization

Architecture

• General code optimization with modular architecture
• Modular architecture with separation of managers, commands, listeners and utils
• More robust configuration system with versioning

Permission System

• Improved permission system compatible with LuckPerms
• All permissions registered in plugin.yml for compatibility
• Greater compatibility with permission managers

User Interface

• Improved user interface with interactive menu
• Greater configuration flexibility for all functionalities

Freeze System

• Player freeze system with configurable effects
• Improved movement and command prevention

Visibility

• Complete player visibility handling (vanish with view permissions)
• Configurable silent chest opening
• Configurable mob invisibility in staff and vanish

Technical Details

• SQLite database with MySQL support (configurable)
• Vault API integration for economy and permissions
• LuckPerms compatibility for advanced permission management
• State persistence system between restarts
• Real-time TPS monitoring with configurable alerts
• GUI menu with automatic updates and complete player management
• Versioned configuration system with automatic updates

Version: 6.0.0
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Optional Dependencies: Vault, LuckPerms