CraftersStaff v1.2

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.

The web panel was redesigned to feel more modern and useful in practice, with better mobile compatibility and a clearer information layout.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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.

StaffLog now works as a more complete workflow, generating unique sessions and supporting direct access links between Minecraft and the web editor.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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.

Users now receive clearer feedback when something goes wrong, whether from connectivity, invalid usage or server-side failures.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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)
• 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. Un miembro del personal ejecuta un comando de sanción (o LibertyBans dispara el evento).
2. SanctionsCommandListener (o LibertyBansHook) interpreta el tipo, el objetivo, el personal, la duración y el motivo.
3. SanctionsWebhookManager comprueba si el tipo está habilitado, resuelve webhook-url y link, crea la incrustación y la envía.
4. En caso de error HTTP, el registro muestra el código y el cuerpo de respuesta de Discord.
   [/LISTA]
   
   [TAMAÑO=5]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/TAMAÑO]
   
   [TAMAÑO=4] Guía de prueba rápida[/TAMAÑO]
   [LISTA=1]
5. Establezca webhook-url para los tipos deseados en sanctions-webhooks.yml. Opcionalmente, establezca link y enabled.
6. Reinicie el servidor.
7. Ejecutar, por ejemplo. /mute <player> 10m prueba y comprueba tu canal de Discord.
8. Pruebe /unmute <player> y /unwarn <player> para ver las nuevas incrustaciones.
9. Establezca un tipo en enabled: false y repita — que webhook no debe disparar.
   [/LISTA]
   
   [TAMAÑO=5]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/TAMAÑO]
   
   [TAMAÑO=4] Notas finales[/TAMAÑO]
   
   El sistema webhook ahora es modular por tipo y más resistente a errores de API. La captura de ID de LibertyBans se volverá a habilitar una vez que se confirme la API estable para la versión 1.1.2 en su entorno. Mientras tanto, ID no aparecerá en las incrustaciones para evitar marcadores de posición vacíos.

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.