
CraftersStaff
Complete staff management solution with vanish, freeze, alerts, Discord integration, and customizable menus for Minecraft servers.
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
LocalWebServerHTTP endpoint system. - Manager Updates: Disabled
WebConsoleManagerand 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
/unfreezecommand to unfreeze players directly. - Persistent Vanish System — Vanish state now persists when disabling Staff Mode.
- New
vanish.persist-on-staff-disableoption (default:true). - New
vanish.auto-enable-on-staff-disableoption (default:false).
- New
- Proxy Bridge Plugin — New
CraftersStaff-Proxyfor Velocity, BungeeCord and Waterfall.- New
proxy-config.ymlwith 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).
- New
- Ban-on-quit system — Frozen players who disconnect are automatically banned via a configurable console command.
- Self-action prevention —
/freeze,/unfreeze,/reportand/notecan no longer be used on yourself. - Freeze state validation — Freezing an already frozen player shows an
already frozenmessage. Unfreezing an unfrozen player shows anot frozenmessage. - New
freeze.still-frozenmessage 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+Clickcombinations 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.ymlinstead of a separate config variable. - Removed
discord-messageconfiguration 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
- Staff see:
- 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
ConfigManagerwith default fallback values. - Version updated to
1.8across all components.
🐛 Fixed
- Fixed all freeze messages no longer including the plugin prefix for cleaner notifications.
- Fixed
freeze.discord-messagereference causingMessage not founderror. - Fixed freeze chat format now using single
>instead of double>>. - Fixed
UnsupportedOperationExceptionon player join — now uses properStaffManagermethods. - 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 helpcommand showingMessage not founderrors. - Fixed help messages updated with all available commands including
/reportand/stafflog. - Fixed Velocity proxy
NullPointerException— updatedvelocity-plugin.jsonwith correct version and main class. - Fixed
Message not found: freeze.still-frozenerror. - 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— removedvelocity-plugin.jsonfrom backend JAR. - Fixed Velocity proxy
IllegalArgumentException: plugin main instance automatically registered.
- Added
FRESH START — Version 1.2
✦ Added
- Quick Actions Menu — New interactive GUI accessible via
Shift + Right-Clickon 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.actionsis 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-linksetting. - 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.2acrosspom.xml,plugin.yml, andconfig.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.ymlfor a cleaner and simpler configuration experience.
CraftersStaff is built for serious moderation. FRESH START marks a new standard.
- Quick Actions Menu — New interactive GUI accessible via
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.0across all plugin resources and build metadata.
🗑️ Removed
- Removed the sanctions webhook bridge for external punishment plugins.
- Removed
sanctions-webhooks.ymland 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.netwithcrafatar.comfallback.
📋 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()vsgetStaff()) 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-urlwithlinkfallback). - 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.javato useis mininginstead ofestá minando. - Discord webhooks now show
Mining Alertinstead ofAlerta 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:
UNMUTEandUNWARNwith 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:
UNMUTEandUNWARN. - Per-type
enabled: true/falsecheck before sending each webhook. - Support for
webhook-url(endpoint) andlink(embed URL), withurlas backwards compatibility fallback.
👁️ Sanctions Command Observer
- Maps commands to sanction types and fires the webhook:
- ban/tempban/ipban →
BAN(orBANIPif containsip) - mute/tempmute/ipmute →
MUTE - unban/pardon →
UNBAN - unmute →
UNMUTE - warn →
WARN - unwarn →
UNWARN
- ban/tempban/ipban →
⚖️ LibertyBans Integration (Reflective)
- Hook to
PunishEventvia Omnibus to capture sanction data without compile-time dependency. - ID capture temporarily disabled (sends
null) for multi-version stability. LibertyBansadded tosoftdependinplugin.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
ConsoleUtilwith the internal prefix[CraftersStaff], without using or duplicatinggeneral.prefix.
🔄 Safe Update Fallback
- If
general.update-availableis missing from language files, a default message is used.
🔗 Conflict-free Command Aliases
- A
cstaff_<name>alias is automatically added for every command loaded fromcommands.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;urlstill works as fallback)link– clickable embed title URL (new)title,description,content,color
- New sections for
unmuteandunwarnwith their own titles, descriptions and colors. IDremoved from templates temporarily (capture disabled for stability).
🔁 Webhook Send Flow
- A staff member executes a sanction command (or LibertyBans fires the event).
SanctionsCommandListener(orLibertyBansHook) interprets type, target, staff, duration and reason.SanctionsWebhookManagerchecks if the type is enabled, resolveswebhook-urlandlink, builds the embed and sends it.- On HTTP error, the log shows the code and Discord's response body.
🧪 Quick Testing Guide
- Set
webhook-urlfor the desired types insanctions-webhooks.yml. Optionally setlinkandenabled. - Restart the server.
- Run e.g.
/mute <player> 10m testand check your Discord channel. - Test
/unmute <player>and/unwarn <player>to see the new embeds. - Set a type to
enabled: falseand 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,
IDwill 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.languageinsideconfig.yml. - The internal default language is now English (
en), with normalization of invalid codes and better fallbacks when unsupported values are used.
- Fixed the language selector to always respect the value configured in
-
🖥️ 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.
- Fixed startup branding colors in console; legacy color codes
-
📊 Official PlaceholderAPI Support (
cstaffexpansion)- New official PlaceholderAPI support via the
cstaffexpansion, 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:mainmessaging channel to request and receive staff counts from the proxy when needed.
- New official PlaceholderAPI support via the
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 denyand/note infocommands with full pagination and rich formatting. - Automatic persistence and conflict-safe handling of numeric note IDs with daily YAML backups.
- New
-
Staff Inspect Quick Actions:
- Quick-Action GUI inside
/inspectfully driven fromconfig.yml. - Per-button actions execute custom commands replacing
%player%with the inspected target.
- Quick-Action GUI inside
-
Staff Pass (Activity Logger):
- Transparent logging for Freeze, Note and Vanish actions with timestamps and staff names.
- New
/staff logcommand to review recent staff activity directly in chat with pages.
-
Proxy Independence & Decoupled Config:
- Automatic
proxy-config.ymlgeneration only when running in proxy environments. - Backends rely solely on their local configuration files without reading proxy settings.
- Automatic
-
Premium Console Loader:
- Startup branding banner with ASCII art, gradient-like coloring and environment detection.
- MySQL status line showing
CONECTADO,ERROR DE CONEXIÓNorBASE 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
ConfigManagerfor a cleaner codebase and zero internal warnings.
🌐 Hybrid Spigot/Velocity Core
- Single JAR Solution: One
CraftersStaff.jarfor both Spigot/Paper backends and Velocity proxies. - Auto-Detection: Lightweight environment detection using safe class-loading (prevents
ClassNotFoundException). - Unified Messaging: Introduced the
craftersstaff:mainchannel 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.ymltocommands.yml. - Runtime Registration: Commands are injected via Bukkit's
CommandMapusing 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-nameoption. 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 | Support & Donations
- Non-Destructive Config Merge: Automatic merging for
🚀 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.alertacross all supported languages. - Anti-Spam Logic: TPS alerts now strictly respect
check-intervalandalert-staffsettings. - Modern Support: Improved overall robustness of the TPS monitoring task on the latest Paper/Spigot versions.
- Dynamic Menus: All core interfaces (
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
cleanuplogic to prevent clearing active states while a player is briefly disconnected, ensuring data integrity.
- Critical Bug Fixes:
- Command Registration Fix: Resolved a
NullPointerExceptionthat could occur on startup if certain commands (/report,/staffchat) were not properly initialized inplugin.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.
- Command Registration Fix: Resolved a
- 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.
- Silent State Methods: Added
- Massive Translation Synchronization (Full Multilingual Support):
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.adminis used). - Collaboration: Send requests to note owners; use
/note acceptto approve.
- Discord Webhooks: Added
Enable: true/falsetoggles for all event types. - Fixes:
- Fixed staff list default language.
- Fixed
/notetab completion. - Fixed
Shift + Right Clicklogic for note requests.
Version 8.5.8
- Added support for 1.21.x.
- Fixed some minor bugs.
- Advanced Note Management:
🚀 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 listopens a paginated GUI. - Secure: Only the creator or admins can remove notes.
- Add 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.ymlincluding all new features. - 🌐 Localization Improvements: Added multilingual comments to configuration files for easier editing.
- ❄️ Isolated Frozen Chat: Communication with frozen players is now private and isolated.
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.viewpermission
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,ChatListenerfully translatedPlayerListenerandStaffMenuBuildersupport translations- Complete Spanish and English support
Configuration Translation
- Complete
config.ymlrewritten 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.ymlupdated with v8.5.0 changelog- Complete history of changes documented
⚙️ Configuration Updates
New Alert Configuration
alerts: mining: watched-blocks: [DIAMOND_ORE, DEEPSLATE_DIAMOND_ORE, ANCIENT_DEBRIS] threshold: 5 interval: 300 tps: enabled: true threshold: 18.0 check-interval: 60 discord: webhook-url: "your-webhook-here" messages: mining-title: "Mining Alert" tps-title: "TPS Warning"📝 Technical Details
- ColorUtils implementation for advanced formatting
- Reflection-based TPS monitoring
- Smart language file reloading
- Optimized performance across all systems
Version: 8.5.0
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Status: Stable Release
Languages: English, Spanish, Portuguese- MiniMessage format support (

