X-Commands

🚀 X-Commands v2.8 - Changelog ## ✨ New Features - **Debug system**: New `/xc debug` command to toggle debug mode at runtime, plus a `DebugLogger` that logs detailed internal operations for easier troubleshooting. - **PlaceholderAPI expansion**: Added `%xcommands_version%`, `%xcommands_total_commands%`, `%xcommands_language%`, `%xcommands_cooldown_remaining_<command>%`, `%xcommands_on_cooldown_<command>%`, and `%xcommands_player_cooldown_<command>%` placeholders. - **Config auto-update with backup**: When the config version changes, the old config is backed up as `config_old.yml` before generating the new one. - **Update checker**: Checks the SpigotMC API for new versions on startup. - **Adventure MiniMessage color support**: Internal color system upgraded to use Adventure's MiniMessage for better formatting. - **Shared dependency directory**: Libby now downloads runtime libraries to `plugins/X-API/` so all X plugins share dependencies instead of each having their own copy. - Updated startup messages with standardized logging format. - Standardized plugin lifecycle (onEnable/onDisable) with proper error handling and graceful degradation. ## 🐛 Bug Fixes - Fixed compilation against Paper 1.18.2 for broader compatibility. - Debug system now sends messages to the player who toggled it via command, and to console only when enabled via config. Command responses now use the prefix from `config.yml`. - Debug messages now include the plugin name in the format: `[DEBUG] [X-Commands] [Category] message`.

🚀 **X-Commands v2.7 - Changelog** ## 🛡️ Security Fixes - Added null byte (`\0`) and control character removal in command sanitization (`ConsoleAction`, `PlayerAction`) to prevent potential injection exploits. - Fixed `PermissionCondition` allowing server operators to bypass LuckPerms negation nodes — OP players are now properly checked against negative permissions. ## 🐛 Bug Fixes - Fixed `CommandManager` still referencing old template names (`ejemplo.yml` and `aviso.yml`) instead of the renamed `example.yml` and `announce.yml`, causing command creation to fail. - Fixed `HealAction` crashing on servers running pre-1.20.6 due to direct use of `org.bukkit.Registry.ATTRIBUTE`. Added fallback compatibility using `Attribute.valueOf()`. - Fixed `UpdateChecker` throwing `NumberFormatException` when parsing version strings like `v1.0.0-beta`, which caused the update checker to crash silently. - Fixed `ActionsMenu` not finding commands case-insensitively, causing commands with uppercase letters to not appear in the menu. - Fixed `SchedulerUtils` thread safety issues — task references are now `volatile` to prevent race conditions. - Fixed `CompatibilityUtils.isPaper` not being `volatile`, causing unreliable Paper detection from async threads. - Fixed `ConfigUpdater` crashing with `NullPointerException` when a resource template was missing from the JAR. - Fixed `VelocityAction` sending messages through the `BungeeCord` channel, which Velocity doesn't listen to. Added console warning and corrected channel usage. - Fixed `KickAction` applying double color translation, which could corrupt formatted kick messages. - Fixed `BaseMenu` sharing a single mutable `ItemStack` reference across all empty glass pane slots — modifying one would corrupt all others. - Fixed `LocateCommand` showing a misleading "language changed" message when only displaying the current language. - Fixed `SendToAction` using tag `"SENT_TO"` instead of the expected `"SEND_TO"`, causing proxy forwarding to fail. - Fixed `EffectAction` unnecessarily initializing a variable to `null`. - Fixed `MenuHolder.getInventory()` potentially returning `null` on plugin disable. - Fixed `InventoryListener` showing hardcoded Spanish text (`"Anterior"` / `"Siguiente"`) as fallback for pagination buttons instead of using translated keys. - Fixed `LoggerUtils` eagerly initializing `Bukkit.getConsoleSender()` at class load time, which could fail during early startup. - Fixed 9 silently swallowed exceptions in `CompatibilityUtils` — all compatibility checks now log debug messages on failure for easier troubleshooting. ## 🔧 Code Quality - Added `volatile` modifier to all fields accessed from async threads (`UpdateChecker`, `SchedulerUtils`, `CompatibilityUtils`) to ensure proper memory visibility. - Improved error handling and logging across the entire codebase for better diagnostics. - Reduced code duplication in proxy-related actions (`BungeeAction`, `VelocityAction`, `SendToAction`). - Cleaned up unnecessary initializations and dead code. - Standardized error messages to use language keys instead of hardcoded strings.

🚀 X-Commands v2.6 - Changelog ## ✨ New Features - New command `/xc forcemessages <keep|new> <language|all>` to update and reload language files without restarting the server. (In beta) - All chat inputs (name, description, permission, etc.) now have a 30-second timeout with a translated message. - The cancel word for chat inputs is now translated (e.g. "cancelar" in Spanish, "cancel" in English). - GiveMenu display name editing now shows translated prompts. - Guides update - Example commands update ## 🐛 Bug Fixes - Fixed a crash when disabling the plugin while tasks were running. - Fixed player data loading issues. - Fixed stack overflow on repetitive actions. - Fixed errors when clicking empty inventory slots. - Fixed crash when translations were missing. - Fixed command creation and duplicate command issues. - Fixed menus not loading correctly when data was missing. - Fixed GiveMenu crashing with no actions configured. - Fixed material selection errors in menus. - Fixed numeric value errors in menus. - Fixed editing custom names in GiveMenu no longer deletes material and amount. - Added protection against inventory exploits. - Players open chats, menus and cooldowns are now cleaned up on disconnect. - Minor bugs fixed.

🚀 X-Commands v2.5 - Changelog ## ✨ New Features - New actions `[` `]` were added to support compatibility; all actions within these will be executed together if a condition is met. - The numeric menu for subtraction has been improved. - Performance was improved ## 🐛 Bug Fixes - A problem with the [DELAY] action, which had no delay, was fixed. - A bug that allowed players to keep inventory items has been fixed. - Minor bugs were fixed

🚀 X-Commands v2.4 - Changelog ## ✨ New Features - Added support for wildcard permission checking. For example, using `[IF_PERMISSION] meta.subname.%` to check if a player has any permission starting with `meta.subname.` or any. - Added support for dynamic command arguments in actions using `{args}`, `{0}`, `{1}`, etc. (Example: typing `/test Hello` with the action `[CONSOLE] say {0}` will execute `say Hello` in console). ## 🐛 Bug Fixes - Implemented compatibility with spigot again - Fixed a bug where colors couldn't be seen in some messages - Fixed a bug where commands couldn't be created from the GUI - Fixed and improved conditional actions `[IF_PERMISSION]` and `![IF_PERMISSION]`

🚀 X-Commands v2.3 - Changelog ## ✨ New Features - Modern Color Support: Full compatibility with MiniMessage (gradients, hex), legacy hex (&#RRGGBB, &xRRGGBB), and HTML tags (`<b>`, `<i>`, etc.). - MiniMessage Support: Seamless mixing of legacy codes (&l, &c) with advanced gradient tags. - Integrated Economy: Native Vault support for giving/taking money actions ([GIVE_MONEY], [TAKE_MONEY]). - Timed Commands: New 'interval' option to execute actions automatically every X seconds. - New Command: Added `/xc locate` to change and list plugin languages. - Fluid Navigation: In-place inventory update system to maintain mouse cursor position. - Dynamic Iconography: All actions show representative icons (Chests, Potions, etc.) in menus. - Alphabetical Sorting: Action selection menu is now sorted ignoring color codes. - Cross-Server Support: New tags for proxy networks ([VELOCITY], [SENT_TO]). - Action Improvements: Enhanced 26.1+ support (Updated health attributes and potion effects). - Dynamic Registration: Name and alias changes are applied when executing /xc reload. - Reorder Menu: Improved item interaction and smart sequence saving logic. ## 🐛 Bug Fixes - Fixed duplication/ "ghost" command bug when renaming commands. - Fixed "Unsaved changes" warning when leaving menus without making modifications. - Fixed `/xc reload` logic to properly clear memory before reloading. - Fixed GENERIC_MAX_HEALTH compatibility error in modern versions (1.21+). - Fixed navigation behavior and the back button in the editor. - Fixed interaction in action reordering where items could get stuck. - Fixed the permission system for dynamic command registration. - Fixed an issue where broadcasts were incorrectly sent to the console. - Fixed an issue when activating hide-namespaced-commands followed by /xc reload.

# 🚀 X-Commands v2.2 - CHANGELOG * ⭐ **Folia & Paper Support:** Folia support is now complete. * ⚙️ **Try/Crash Resilience:** Try/Crash functionality has been improved. * 🛡️ **Version 26.1 Support:** Version 26.1 compatibility has been implemented. * 📝 **Detailed Diagnostics:** A new logging system with support for stack traces and enhanced context for action execution, enabling more professional debugging.

# 🚀 X-Commands v2.1 - CHANGELOG * ✨ **Folia Support:** Fully region-aware threading. * 🛡️ **Thread-Safety:** Maximum stability with concurrent data structures. * ⚙️ **Conditions:** Added negation (`!` or `_NOT`) and fixed parsing bugs. * 📂 **Auto-Migration:** Automatic folder rename from `X-Comands` to `X-Commands`. * 💾 **GUI Save Fix:** Action reordering now preserves comments correctly. * 📂 **Reorder actions:** A bug that prevents you from redoing the action you were moving.

## <center>**v2.0 - CHANGELOG** **⭐ NEW CORE FEATURE** **Custom Command Intervals:** Now you can schedule your commands to run by themselves! Added the ``` interval ``` option that allows automatic execution every few seconds. **⚙️ HOW TO USE** ``` # interval: 60 Will execute every 1 minute ``` </center>

<div align="center"> v1.9 - CHANGELOG ⭐ NEW FEATURES Enhanced GIVE Action: New format [GIVE] material;amount;name with custom item names and color support. Flexible Languages: Case-insensitive loading (e.g., es -> ES.yml ) and full UTF-8 support for all translations. ⚡ STABILITY & FIXES Anti-Corruption: Fixed a critical bug in the "Smart Edit" logic that caused file corruption when editing via GUI. YAML Updater: Improved hierarchy and auto-indentation when automatically adding missing configuration keys. Performance: 100% Asynchronous command saving to ensure zero impact on server performance. ⚙️ CONFIGURATION & GUIDES Detailed Documentation: Highly specific and helpful comments added to all .yml configuration files. Action Guides: Updated internal guides with documentation for all conditional actions ([IF_PERMISSION], [IF_MONEY], etc.). <div align="center"> <br> </div>