CommandPrompter

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.