CraftersStaff v11.0.0 — AdvancedBan, LiteBans & Diagnostics

---

🔌 AdvancedBan Integration Upgraded

• Added comprehensive debug logging to the hook: event type, punished player, issuer, reason and duration.
• Console messages now announce when the hook is registered and list detected event classes.

👁️ Sanctions Command Listener Improved

• Every console or in-game sanction command now produces a detailed log entry with target, reason and duration.
• Console-executed commands are now treated identically to player-executed ones.
• Granular debug output for ban/tempban, mute, kick, warn, unban, unmute and unwarn.

🛡️ Error Handling & Diagnostics Hardened

• Individual reflection failures are now logged, showing which getter (getActor() vs getStaff()) succeeded.
• Unhandled exceptions inside event handlers are no longer silently swallowed — logged with full context.

🌐 Webhook Behaviour Refined

• Console-executed sanction commands now correctly trigger Discord embeds.
• Per-type toggles and proper URL handling (webhook-url with link fallback).
• JSON escaping and HTTP error body logging for easier debugging.

⚖️ LiteBans Integration Prepared

• Added the same detailed logging and event handling used for AdvancedBan.
• If LiteBans is present, the hook will activate and report punishments with full diagnostics.

---

These changes provide robust monitoring of moderation actions and give server operators full visibility when using AdvancedBan, LiteBans or similar sanction systems alongside CraftersStaff.

CraftersStaff v10.9.7 — English Alerts Fix

Release Date: March 10, 2026

---

🆕 What's New

English Alerts Fix

• Fixed mining alert messages now display in English instead of Spanish.
• Updated MiningListener.java to use is mining instead of está minando.
• Discord webhooks now show Mining Alert instead of Alerta de Minería.

Technical Changes

• File Modified: MiningListener.java
• Lines: 86-87 (fallback message strings)
• Before: &e[%server%] &c[X-Ray] %player% está minando %block%.
• After: &e[%server%] &c[X-Ray] %player% is mining %block%.

CraftersStaff v10.7.9 — Sanctions Webhooks & LibertyBans Integration

---

📋 Summary

• More flexible and granular sanctions webhook integration.
• New sanction types: UNMUTE and UNWARN with their own templates.
• Per-type toggles (enabled: true/false) to easily enable/disable each webhook.
• Clear separation between the Discord endpoint (webhook-url) and the embed clickable link (link).
• Reinforced webhook client: correct JSON escaping and HTTP error body logging.
• Command observer for sanctions (ban/mute/warn/kick/unban/unmute/unwarn).
• Reflective LibertyBans hook (PunishEvent) prepared; ID capture temporarily disabled.
• Unified console prefix (no duplicates), independent of general.prefix.
• Safe "update available" message with fallback.
• Safe cstaff_ aliases to avoid command name conflicts.

---

⚙️ Technical Changes

🔨 Sanctions Manager

• New types: UNMUTE and UNWARN.
• Per-type enabled: true/false check before sending each webhook.
• Support for webhook-url (endpoint) and link (embed URL), with url as backwards compatibility fallback.

👁️ Sanctions Command Observer

• Maps commands to sanction types and fires the webhook:
  • ban/tempban/ipban → BAN (or BANIP if contains ip)
  • mute/tempmute/ipmute → MUTE
  • unban/pardon → UNBAN
  • unmute → UNMUTE
  • warn → WARN
  • unwarn → UNWARN

⚖️ LibertyBans Integration (Reflective)

• Hook to PunishEvent via Omnibus to capture sanction data without compile-time dependency.
• ID capture temporarily disabled (sends null) for multi-version stability.
• LibertyBans added to softdepend in plugin.yml.

🌐 Discord Webhook Client

• Correct escaping of JSON characters (quotes, slashes, newlines, control unicode).
• Error body reading on HTTP 4xx/5xx responses for clear diagnostics.

🖥️ Unified Console Prefix

• All logs go through ConsoleUtil with the internal prefix [CraftersStaff], without using or duplicating general.prefix.

🔄 Safe Update Fallback

• If general.update-available is missing from language files, a default message is used.

🔗 Conflict-free Command Aliases

• A cstaff_<name> alias is automatically added for every command loaded from commands.yml.

---

📁 Configuration Changes

New file: sanctions-webhooks.yml

• Global:
  • sanctions-webhook.enabled – enables/disables all sanction webhooks.
  • sanctions-webhook.use-embed – use embed or simple message.
• Per type (ban, mute, unmute, kick, warn, unwarn, unban, banip):
  • enabled: true/false (new)
  • webhook-url – Discord endpoint (new; url still works as fallback)
  • link – clickable embed title URL (new)
  • title, description, content, color
• New sections for unmute and unwarn with their own titles, descriptions and colors.
• ID removed from templates temporarily (capture disabled for stability).

---

🔁 Webhook Send Flow

1. A staff member executes a sanction command (or LibertyBans fires the event).
2. SanctionsCommandListener (or LibertyBansHook) interprets type, target, staff, duration and reason.
3. SanctionsWebhookManager checks if the type is enabled, resolves webhook-url and link, builds the embed and sends it.
4. On HTTP error, the log shows the code and Discord's response body.

---

🧪 Quick Testing Guide

1. Set webhook-url for the desired types in sanctions-webhooks.yml. Optionally set link and enabled.
2. Restart the server.
3. Run e.g. /mute <player> 10m test and check your Discord channel.
4. Test /unmute <player> and /unwarn <player> to see the new embeds.
5. Set a type to enabled: false and repeat — that webhook should not fire.

---

📝 Final Notes

The webhook system is now modular per type and more resilient against API errors. LibertyBans ID capture will be re-enabled once the stable API for version 1.1.2 is confirmed in your environment. In the meantime, ID will not appear in embeds to avoid empty placeholders.

CraftersStaff v10.2.9 – Unified Language & Official PlaceholderAPI Support

This version 10.2.9 is focused on polishing the plugin's foundation for international networks and better preparing integration with other server systems.

---

• 🌐 Unified Default Language – English

  • Fixed the language selector to always respect the value configured in general.language inside config.yml.
  • The internal default language is now English (en), with normalization of invalid codes and better fallbacks when unsupported values are used.

• 🖥️ Improved Branding & Console Messages

  • Fixed startup branding colors in console; legacy color codes & now display correctly.
  • All console messages respect the configurable prefix defined in general.prefix, maintaining a consistent visual identity in server logs.

• 📊 Official PlaceholderAPI Support (cstaff expansion)

  • New official PlaceholderAPI support via the cstaff expansion, designed specifically for HUDs, scoreboards, TAB and staff network menus.
  • Includes placeholders to display the player's Staff Mode and Vanish status, as well as staff counters both at individual server level and across the entire network (proxy).
  • The system is ready to work in hybrid Spigot/Paper + Velocity environments, leveraging the craftersstaff:main messaging channel to request and receive staff counts from the proxy when needed.

---

In summary, CraftersStaff v10.2.9 strengthens the plugin's internationalization, improves the administration experience in console and opens the door to more advanced integrations with PlaceholderAPI in professional network configurations.

Version 10.0.0

• Advanced Notes 2.0:

  • New /note deny and /note info commands with full pagination and rich formatting.
  • Automatic persistence and conflict-safe handling of numeric note IDs with daily YAML backups.

• Staff Inspect Quick Actions:

  • Quick-Action GUI inside /inspect fully driven from config.yml.
  • Per-button actions execute custom commands replacing %player% with the inspected target.

• Staff Pass (Activity Logger):

  • Transparent logging for Freeze, Note and Vanish actions with timestamps and staff names.
  • New /staff log command to review recent staff activity directly in chat with pages.

• Proxy Independence & Decoupled Config:

  • Automatic proxy-config.yml generation only when running in proxy environments.
  • Backends rely solely on their local configuration files without reading proxy settings.

• Premium Console Loader:

  • Startup branding banner with ASCII art, gradient-like coloring and environment detection.
  • MySQL status line showing CONECTADO, ERROR DE CONEXIÓN or BASE DE DATOS NO CONFIGURADA.
  • Credits line dedicated to xUnknowns for easy recognition on startup.

• Cleaner Console Logging: Refined update checker and config merge messages to avoid noisy duplicate logs.

• Compatibility: Compatible with Spigot/Paper 1.16–1.21.5.