New features and some bug fixes
- Colours will no longer parse inside dialog input fields
- Colours will no longer parse on command execution
- Inventory lock added, when enabled players will not be able to move their inventory items while a panel is open
- Messages will not send if set to an empty string in the lang file
- Close commands has been added, commands run when panel is closed (only works on Inventory Panels)
- Commands (open commands) layout has been updated. (See Below)
Before:
commands:
- '[msg] Panel has been opened'
After:
open:
commands:
- '[msg] Panel opened'
The change was made to keep it uniform with outside and close commands, and it now supports requirements and fail by using the Command Actions system.
Bug fixes and head improvements
- Command event is correctly cancelled when players have no permission to open the panel
- Fixes commands running after the panel is already open
- Custom heads methods improved, queue added to avoid timeouts
Enhancements and bug fixes
- Inventory panels now have outside commands (commands can be defined when clicking outside the GUI)
- Fixes teleport tag when using folia
- Added the Permission Observer feature. The Permission Observer can be disabled in the config.yml, it will detect which permissions are used in a panel, and will automatically refresh the panel when those permissions change for the player
- Data will save to file more frequently than just on server close
Minor update release
- Moved plugin to 1.21.9 (this version had had extra testing on 1.21.7 - 1.21.10)
- Added support for Folia servers
- Colour parsing has been overhauled, now supports all colour formats at the same time
- Added missing default field for dropdown in floodgate forms
- [delay] tag has been added.
- Session logic between panels has been simplified and other optimisations have been made
- Cooldown between opening panels has been added (configurable in config.yml)
- There is no longer a requirement for a minimum of one item to be in inventory panels
Important note when updating
[refresh] numberno longer works, use the new [delay] tag instead to delay your refresh
Small bug fixes and improvements
- Improvements for custom heads, now using Papers API
- Added missing width and height properties for Dialog Item and Text components
- Bundle and Shulker box attributes will now be hidden when attributes are toggled off
- Fixes armour trims, some options missing/ did not work correctly
Language Updates
- Fixes so sound tag can now play resource pack sounds
- Music disc attributes are now hidden
- Language file has been improved, now generates a lang.yml file by default with all translation keys included
- Old language files will no longer work, new ones are much easier to use and will take just a couple minutes to migrate to
Bug Fixes and Improvements
- Conditions cannot contain spaces, placeholders that contain spaces will change them to underscores
- Removes no vault error messages for some when vault isn't configured fully on their server
- Different panels can now contain the same base command, eg
/shop redstoneand/shop farmingfor different panels - Conditions to open a panel can now contain arguments from open commands
- Fixes for placeholders, no longer break when reloading placeholderapi
- Other placeholders using brackets can now be used inside commandpanels placeholders
- Conditions now work in requirements section (condition tag has been added)
Bug fixes
- Conditions do not accept spaces so spaces in placeholders will automatically be replaced with underscores
- MMOItems material tag fixed
- Label component type missing from floodgate forms has been added
- Dependencies loop problem fixes
- Vault tag no longer provides errors with economy problems (likely just not using vault)
- Fixes range in dialogs no longer always outputs true
Fixes and additions
- Data placeholder now accepts optional player name to read other players data
- Added
[grant]command tag, execute a chat/command for the player while granting the player a specific permission to run the command temporarily [msg]tag now allows ALL minimessage functionality (eg hover text)- Fixes to some attributes not being hidden (fireworks)
- Errors when conditions are invalid will now state the error is due to conditions
- Fixed double chests not working when generating panels in game
Alias feature and fixes
- Added aliases which can now be used for commands to open panels
- Itemsadder and Nexo fixed, now loads correctly (before commandpanels)
- Adventure api removed from dependencies, already bundled in paper
Bug fixes and improvements
- Moved from plugin to paper-plugin
- Fixes issues with panels not updating automatically while open
- Fixes animations
- Fixes [previous] command tag
- Some improvements to commandpanels data methods
Server tag fixes
- Adds missing channel register code for server command tag
Bug fixes and small features
- [item] requirement tag now has custom model data support
- Custom model data can now be used with numbers instead of just strings
- Conditions will now ignore colour formatting
- Refresh tag now has an optional delay function
Bug Fixes & Improvements
- Resolves issues with custom heads saving their state across panels from cache
- Fixes item names on items such as potions
- Conditions now parse ignoring color codes
- Session data & panel data no longer parse color prematurely
- Changed the default for color from legacy codes to mini message
- Session data is now persistent while the player is online instead of only during panel interaction, this resolves issues with data being cleared after panel refresh
Fixes and 1.21.8
- Updated dependencies for 1.21.8
- leather-armor -> leather-color (now only accepts RGB values)
- Fixes issues with & symbol in strings when using mini message
- Started moving ItemMeta implementations to Papers DataComponentTypes
- Some attributes like potions are now hidden correctly
Converter and Bug Fixes
- Added a panel converter for v3 -> v4 panels. To convert panels, place them in a folder named
old_panelsnext to the panels folder and type/pa convertto start the conversion. Note: the two versions are incompatible and you WILL need to modify the panels after converting them, this will just save you from doing most of the repetitive work - Some bug fixes, inventory panels cannot be opened if they do not contain any items and fixed xp requirement tag
- Better example panels on folder generation have been added
v4 – Major Release
Breaking Changes
-
Minecraft 1.21.8+ only:
CommandPanels v4 supports only the latest Minecraft version. Older versions (1.8.8–1.20.x) remain supported by v3 at v3.commandpanels.net downloads available on SpigotMC. -
PaperMC exclusive:
SpigotMC support has been dropped. New builds will be available primarily on Modrinth as SpigotMC does not have PaperMC only plugins. -
Config overhaul:
New config format incompatible with v3.
No converter yet, but a new online editor will be released shortly after this update.
New Features
-
Dialogs support:
Full integration with Minecraft’s new Dialogs feature (1.21.7+). -
Improved performance and stability:
Refactored codebase with fewer, more reliable features.
Notes
- This is an early release so please report bugs on the Discord server.
- Focused on modern Minecraft versions for a cleaner, faster plugin.
Legacy Support
Use CommandPanels v3 for older Minecraft versions:
🌐 v3.commandpanels.net



