Перейти к содержимому
Mineforgian

X-Commands

You can create custom commands with an interactive GUI.

Загрузки
559
Подписчики
2
Обновлён
6 июня 2026 г.
Лицензия
MIT

Опубликован 30 января 2026 г.

SpigotMC Wiki Discord


Manage your custom commands easily and visually.

X-Commands is a simple yet powerful plugin that allows you to create, edit, and manage custom commands for your server directly from an intuitive GUI or via advanced CLI commands.

✨ Features

  • 🚀 Folia & Paper Ready: Built for modern high-performance servers.
  • 🎨 Modern Color Support: Native support for MiniMessage, RGB (&#RRGGBB), and Legacy (&).
  • 🖥 Visual & CLI Management: Create and edit commands using the GUI or the new command line interface.
  • 📜 Unified Language System: All messages centralized in root language files. Support for EN, ES, PT, RU, JA.
  • 🛠 Advanced Action System: Execute messages, titles, sounds, particles, and more in a sequential order.
  • 💰 Vault Integration: Full economy support (give/take money) using Vault.
  • ⏱ Timed Commands: Execute actions automatically every X seconds using intervals.
  • 🌐 Proxy Support: Send players to other servers using [VELOCITY] or [SENT_TO] tags.
  • ⚡ Highly Optimized: Designed for high performance with minimal resource usage.

🛠 Commands

Command Description
/xc help Shows the help menu
/xc -gui Opens the visual editor
/xc create <name> Creates a new custom command
/xc delete <name> Deletes an existing command
/xc list Lists all your custom commands
/xc info <name> Shows details about a command
/xc edit <cmd> <attr> <val> Modifies an attribute via CLI
/xc reload Reloads the configuration and languages
/xc locate <lang> Changes the plugin language
/xc update Checks for updates
/xc version Shows plugin and server info

🔐 Permissions

Permission Description
xcommands.admin.* Full access to all features (Default: OP)
xcommands.admin.gui Access to the GUI editor
xcommands.admin.create Permission to create new commands
xcommands.admin.delete Permission to delete commands
xcommands.admin.edit Permission to edit existing commands
xcommands.admin.reload Use the reload command
xcommands.admin.locate Use the locate command
xcommands.admin.update Use the update command and join notifications
xcommands.admin.version Use the version command

⚡ Actions & Conditions

Actions are executed following a sequential order. If a condition is not met, the following action is skipped.

  • Key Actions: Messages, Titles, Sounds, Effects, Commands, Teleport, Particles, Bungee, Vault, etc.
  • Smart Conditions: Permissions, Money, OP, Worlds, Chance.

Ченджлог

2.7Релиз26.1, 26.1.1, 26.1.2 · 6 июня 2026 г.

🚀 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.
2.6Релиз26.1, 26.1.1, 26.1.2 · 6 июня 2026 г.

🚀 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.
2.5Релиз26.1, 26.1.1, 26.1.2 · 22 мая 2026 г.

🚀 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
2.4Релиз26.1, 26.1.1, 26.1.2 · 17 мая 2026 г.

🚀 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]
2.3Релиз26.1, 26.1.1, 26.1.2 · 15 мая 2026 г.

🚀 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.
2.2Релиз1.21.10, 1.21.11, 26.1 · 31 марта 2026 г.

🚀 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.

2.1Релиз1.21.9, 1.21.10, 1.21.11 · 27 марта 2026 г.

🚀 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.
2.0Релиз1.21.9, 1.21.10, 1.21.11 · 4 марта 2026 г.

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

Комментарии

Загружаем…