v3.0.0 - The PaperMC Rewrite

Welcome to CommandPrompter v3! This is the largest update in the plugin's history. We have completely rewritten the plugin from the ground up to be a modern, high-performance, native PaperMC plugin.

By dropping legacy Bukkit/Spigot support, v3 takes full advantage of Paper's exclusive APIs, bringing you native dialog menus, Folia compatibility, MiniMessage formatting, and a vastly improved configuration system.

Major Features & Additions

• Modularized Architecture: The plugin has been completely restructured into distinct modules (prompt-core, prompt-ui-api, prompt-paper, etc.). This separates the core logic from version-specific UI implementations, offering a much cleaner, more maintainable prompt architecture and making it significantly easier to support future Minecraft versions.
• Native Paper Dialog UI (<d:Prompt>): Say goodbye to clunky inventory workarounds. v3 introduces native support for Paper's Dialog API. You can now create beautiful, client-native confirmation screens, multi-action menus, and tab-completion pickers.
• 100% Folia Supported: CommandPrompter has been completely decoupled from the legacy Bukkit scheduler. It now uses Paper's RegionScheduler, making it fully compatible with Folia servers out of the box.
• MiniMessage & ComponentLogger: The entire plugin has been ported to use Adventure's MiniMessage format. You can now use gradients, hex colors, and click events in your prompts. (Legacy & color codes are still supported and will automatically convert!)
• Preset Configurations: You can now define complex prompts and dialogs in a dedicated presets.json file, keeping your command configurations clean and reusable across multiple menus.
• i18n Language System: Introduced a robust internationalization system. All plugin messages are now fully translatable and customizable.
• Smart NMS & 26.2 Support: Added dedicated modules for Paper 26.1 and the experimental 26.2 builds. The plugin now features an intelligent fallback system—if you update your server to an unsupported future version, it will gracefully fall back to the newest available NMS module.

Breaking Changes & Migration Guide

Because v3 is a complete rewrite, there are several breaking changes you need to be aware of when upgrading from v2:

• Paper 26.1+ Required: CommandPrompter v3 requires PaperMC 26.1 or higher (Minecraft 26.1+). Spigot and older Minecraft versions (like 1.21.x) are no longer supported.
• Tag Syntax Changes: The old legacy tag syntax (e.g., <-a Prompt>) has been completely removed. You must update your commands to use the modern syntax (e.g., <a:Prompt>).
• Commands & Permissions Renamed: To match modern Paper standards, the base commands and permissions have been renamed. You will need to update your permission manager (e.g., promptpaper.admin, promptpaper.use, promptpaper.reload).
• Configuration Reset: The plugin now uses a native SnakeYAML configuration system. You will need to transfer your old settings (timeouts, prefixes, etc.) into the newly generated v3 configuration files.

The v2 codebase has been officially retired and archived to the v2-archive branch.

Version 2.16.0

What's Changed

• Support for 1.21.9
• Support for 1.21.10
• Support for 1.21.11
• Fix custom model data setting

Full Changelog: 2.15.0...2.16.0

Version 2.15.0

What's Changed

• Support for 1.21.8
• Post commands will now ignore prompts that are cancelled by timeout
• Fix empty line for multi-line chat prompt
• Fix post command sender context for piping.

Full Changelog: 2.14.0...2.15.0

Version 2.14.0

What's Changed

• Support for 1.21.6
• Support for 1.21.7
• Ability to pipe post commands to a different executor
• Fixed formatting issues

Version 2.13.0

What's Changed

• Added PremiumVanish Hook, fixed Vanish Players Bug by @flutz1 in #60
• Version 2.13.0 by @CyR1en in #63

New Contributors

• @flutz1 made their first contribution in #60

Full Changelog: 2.12.0...2.13.0

Version 2.12.0

Changes:

• Support for 1.21.4
• AnvilGUI Improvements
  • Hide tooltip
  • Add cancel item
• Fix clickable cancel text for chat prompts

Version 2.8.2

Minor update

• This fixes a major issue with the prompt system where prompt answers doesn't replace prompts with format.

Version 2.8.1

Minor Change

• fix dependency issues by @CyR1en in #38

Full Changelog: 2.8.0...2.8.1

Version 2.8.0

Changes

• Added Towny PlayerUI filters
• Added LuckPerms PlayerUI filters
• Online Player input validator
• Ability to ignore MiniMessage syntax
• Custom model data for PlayerUI heads

Auto Generated

What's Changed

• Update README.md by @CyR1en in #35
• sync to main by @CyR1en in #36
• Add more filters & other features by @CyR1en in #37

Full Changelog: 2.7.0...2.8.0

Version 2.7.0

What's Changed

• re-write README by @CyR1en in #33
• Big changes click the p.r to learn more @CyR1en in #34

Full Changelog: 2.6.0...2.7.0