⚡ KaMenu⚡ - Unprecedented Menu Plugin | Dialog Box | Powerfu

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

Support chest menu! [ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

Full Spigot support

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

Fixed a runtime exception that could occur when running /km guide on some Paper 26.2 / Adventure API environments

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

Fix the condition judgment permission bug

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ CHANGELOG]

[ ChangeLog]

[ CHANGELOG]

Supports hexadecimal color and abbreviated syntax for item icons Hex color code text: &#FF4455 Hello Item icon: &item:[diamond] Display a diamond icon.

New PlaceholderAPI %kamenu_hasitem_[item_attributes]% Query the number of items in the player's inventory that match the conditions Example: %kamenu_hasitem_[mats=DIAMOND]%Returns the number of diamonds in the inventory %kamenu_hasstockitem_<item_name>% Query the number of specified stock items in the player's inventory. Example: %kamenu_hasstockitem_Mystic-Fruit% Returns the number of "Mystic-Fruit" in the inventory

New Features · item component amount configuration - Support setting item stack quantity (1-64), supports conditional expressions · item component description_width configuration - Support custom description text width (1-1024 pixels), supports conditional expressions · item component show_overlays configuration - Control display of item overlay elements (durability bar, quantity, cooldown timer) · Multi-line support for message text and item description - Support YAML list format and \n newline character

New Features New Action: - 'server: lobby' Connect player to "lobby" server. Target Selector System Description: All actions support target selectors, allowing you to specify which players actions should affect, supporting conditional expression filtering. This is a powerful feature that enables actions to flexibly target different player groups. Syntax: Code (YAML): # Format: {player: selector} - 'tell : Hello!' # No selector, sends to executor - 'tell : Hello! {player : *}' # Sends to all online players - 'tell : Hello! {player : all }' # Sends to all online players - 'tell : Hello! {player : %player_level% >= 10}' # Sends to players meeting condition - 'tell : Hello! {player : hasPerm.user.vip }' # Sends to players with VIP permission

New Features 1. Player Click Listener Description: Added a listener for right-clicking players to open menus, with configurable menu and sneaking conditions. Configuration: listeners: player-click: enabled: false # Enable this listener menu: 'inspect_player' # Menu file to open require-sneaking: false # Require sneaking to trigger Features: · Automatically sets {metalayer} to the clicked player's name · Supports both normal right-click and Shift+Right-Click · Can display player equipment using slot references in menus 2. Item Slot Reference Description: The item component now supports referencing player equipment slots with variable resolution. Format: · [HEAD] - Current player's helmet · [HEADlayerName] - Specified player's helmet · [HEAD:{metalayer}] - Use meta variable Supported Slots: · HEAD - Helmet · CHEST - Chestplate · LEGGINGS - Leggings · BOOTS - Boots · MAINHAND - Main Hand · OFFHAND - Off Hand Empty Slot Handling: · Empty helmet slot: Render player skull · Other empty slots: Render light gray glass pane named "无" Variable Support: · PAPI variables: [HEAD:%player_name%] · Built-in variables: [HEAD:{data:target_player}] · Meta variables: [HEAD:{metalayer}] 3. Player Interaction Menu File: menus/inspect_player.yml Features: · Display 4 player equipment slots (32x32 size) · 6 interaction buttons: · Add Friend · Teleport to Player · Teleport Player to You · Private Message · Inspect Inventory · Kick Player Usage: · Enable the player-click listener in config.yml · Right-click any player to open the interaction menu · View their equipment and interact Improvements 1. Item Component Enhancement Optional Name Property: · name is now optional · If not provided, uses the item's default name · If provided, overrides the item's name Lore Optimization: · Lore is only set when not empty · Prevents empty lists from overwriting existing item lore

Fix potential errors caused by asynchronous task execution

JavaScript Supports KaMenu includes a powerful JavaScript engine built in (based on OpenJDK Nashorn 15.3), allowing you to use JavaScript code in menus to perform various complex operations. Features · Ready to use: No extra plugins required · Automatic download: Required dependencies are automatically downloaded on first startup · Bukkit API integration: Direct access to the Bukkit API · Variable binding: Automatically binds player-related variables · Predefined functions: Supports defining reusable JavaScript functions in menus · Parameter passing: Supports passing multiple types of parameters to predefined functions

Fix the bug where the "wait" action may cause the server to crash.

Major Updates Full MiniMessage Support Complete support for all Adventure MiniMessage features, including: · Colors and Formatting: <red>, <bold>, <italic>, etc. · Gradients: <gradient:red:blue> · Click Events: <click:run_command:xxx>, <clickpen_url:xxx>, <click:copy_to_clipboard:xxx> · Hover Events: <hover:show_text:xxx>, <hover:show_item:xxx> · Item Sprites and Player Heads (1.21.9+): <sprite:block/stone>, <head:Notch> Legacy Color Code Compatibility Support mixing Legacy color codes with MiniMessage tags: · Automatically converts &a, &c, etc. to <green>, <red>, etc. · Freely mix both formats with full backward compatibility Action List Reuse New actions action to execute predefined action lists when clicking text or buttons: · Reference actions via <text="xxx";actions=yyy> or actions: yyy · Supports conditional logic and variable replacement · Avoid duplicating the same action sequences Bug Fixes · Fixed error when clicking buttons without actions list · Fixed ClickCallback.Options API usage

Bug Fixes: · Fixed potential crashes caused by modifying values in data/gdata; data/gdata operations are now executed asynchronously · Fixed Slider component error issues; now validates min < max to ensure proper display of the slider bar

1. Flexible Material Name Matching Added intelligent normalization for material name matching, supporting multiple format variations. This improvement applies to: · Body component item displays · hasItem condition checks · hasStockItem condition checks · item actions · stock-item actions · item-lore listeners in config Supported Formats: · Standard: DIAMOND_SWORD · Lowercase: diamond_sword · Mixed case: DiAMond swORd · Hyphen: Diamond-Sword · Space: diamond sword Normalization Rules: · Case-insensitive: Auto-convert to standard uppercase · Separator unification: Replace hyphens - and spaces with underscores _ · Multi-separator merging: Multiple consecutive underscores are merged · Leading/trailing cleanup: Auto-remove leading and trailing whitespace 2. MiniMessage Text Format Support Introduced Minecraft's modern text formatting system, MiniMessage, supporting both text formats simultaneously: · Legacy Color Codes: &aGreen text · MiniMessage Format: <green>Green text</green> Auto-Detection Mechanism: · MiniMessage tags <...> detected → Use MiniMessage parsing · No MiniMessage tags detected → Use Legacy color code parsing · Both formats can be mixed MiniMessage Advantages: · More modern text formatting with additional styles (bold, italic, underline, etc.) · Clearer tag structure, easier to maintain · Full compatibility with Minecraft's official Adventure API · Better internationalization support 3. Config and Language File Auto-Update Mechanism Implemented intelligent config and language file management. config.yml Auto-Update: · Version detection: Check config-version field in current config · Fallback for old versions: Auto-set to 0 if config-version is missing · Update process: · Extract all keys and values from user's current config · Backup old config file · Copy new default config from plugin internals · Write user config values to new config file Language File Auto-Update: · Missing detection: Auto-trigger when a language key is called but doesn't exist in file · Auto-completion: Load corresponding language file from plugin internals, use English as fallback if not available · Auto-write: Automatically write missing keys to user's language file 4. New chat Action Added new chat action to let players send messages in the chat box. Use Cases: · Broadcasting: Allow players to send system announcements or notifications · Chat interaction: Quick chat message sending from menu · Command execution: Execute commands requiring player identity · Social features: Send private chat, public chat, etc.

1. Right-Click Item Lore to Open Menu (item-lore Listener) Feature Description Added new listener functionality allowing players to open menus by right-clicking items with specific material and lore text. This feature supports: · Item material (Material) matching · Item lore (description) text matching (fuzzy matching) · Optional sneaking (Shift) trigger · Supports configuring multiple listeners (different items open different menus) Configuration Format Add item-lore configuration under the listeners node in config.yml: Code (YAML): listeners: item-lore : # Main menu configuration main-menu: enabled : true material : 'CLOCK' # Item material target-lore : 'menu' # Text contained in lore menu : 'main_menu' # Menu to open require-sneaking : false # Whether sneaking is required 2. PlaceholderAPI Extension Dependency Check (need_placeholder Configuration) Feature Description Added need_placeholder configuration option for menus to check if required PlaceholderAPI extensions are loaded. Before opening a menu, it automatically verifies: · Admin players (with kamenu.admin permission): Display detailed prompt with missing extension list and clickable download button · Regular players: Display simplified prompt message This feature ensures placeholder variables in menus work correctly, avoiding display errors due to missing extensions. Configuration Format Add need_placeholder configuration under the Settings node in the menu file: Code (YAML): Settings: need_placeholder : - 'player' # Player extension - 'server' # Server extension - 'vault' # Vault extension

1. Item Management Extensions New Condition Methods · hasItem - Check if player has enough regular items in inventory · Supports material specification (Material) · Supports lore (description) matching · Supports item_model matching · Usage: hasItem.[mats=DIAMOND;amount=10] · Advanced usage: hasItem.[mats=DIAMOND;amount=10;lore=Test Item;model=oraxen:mana_crystal] · hasStockItem - Check if player has enough saved items in inventory · For items saved via /km item save · Usage: hasStockItem.ItemName;Amount New Actions · item - Regular item give/take operations · type=give - Give items with specified material · Usage: item: type=give;mats=DIAMOND;amount=10 · Supports unlimited quantity (no 64 stack limit) · Automatically drops items on ground when inventory is full · type=take - Take items from player inventory · Usage: item: type=take;mats=DIAMOND;amount=10 · Supports lore matching: lore=Test Item · Supports item_model matching: model=oraxen:mana_crystal · Can specify both lore and model for precise matching · stock-item - Saved item give/take operations · type=give - Give saved items · Usage: stock-item: type=give;name=ItemName;amount=16 · Supports unlimited quantity (no 64 stack limit) · Automatically drops items on ground when inventory is full · type=take - Take saved items · Usage: stock-item: type=take;name=ItemName;amount=16 2. Button Tooltip Feature · Added tooltip property support for buttons · Display hint text when hovering over buttons · Supports multi-line display (YAML list format) · Supports color codes · Supports variable replacement Configuration Example: Code (Text): Bottom: type: 'multi' columns: 3 buttons: my_button: text: '&9[ Button ]' tooltip: - '&7This is tooltip line 1' - '&7This is tooltip line 2' - '&fClick to execute action' actions: - 'tell: Button clicked' 3. Body Component Enhancements · Added item_model Property Support · Added item_model configuration option for Body's item component · Supports namespace-based item models (namespace:key format) · Compatible with Minecraft 1.21.7 and later versions · Used to display items with special appearance (e.g., custom weapons, items with unique textures) Configuration Example: Code (Text): Body: custom_model_item: type: 'item' material: 'DIAMOND_SWORD' name: '&b&lHoly Sword of Light' lore: - '&7A legendary artifact with unique appearance' - '&aAttack Power: &f+50' item_model: 'minecraft:custom_sword' # Use namespace-based item model description: '&fThis is a special item using a custom model' Notes: · Format: namespace:key, e.g., minecraft:custom_sword or your_plugin:special_item · How it works: Stores model data in item's PersistentDataContainer, Minecraft client renders special appearance based on model definition · All fields support conditional logic

New Features · Added action command: Quick test and execute various menu actions, supporting built-in variables and PlaceholderAPI variables · Usage: /kamenu action <player> <action> · Supports all action types: tell, actionbar, title, hovertext, command, console, sound, open, close, data, gdata, meta, set-data, set-gdata, set-meta, toast, money, etc. · Supports player variables, global data, metadata, and PAPI variables · Added list command: Display all loaded menus on the server · Paginated display with 10 menus per page · Clickable menu items to open directly · Previous/Next page navigation buttons · Usage: /kamenu list [page] · Added help command: Display all plugin command help information · Contains detailed usage instructions for all commands · Clickable documentation link at the bottom · Multi-language support (shows documentation link based on language setting) · Implemented custom command registration feature: · Define custom commands in menu configuration · Automatic registration without manual configuration · Supports command aliases · Supports permission configuration · Auto-update custom commands on reload Improvements · Enhanced open command: Support opening menu for specified player · Format: /kamenu open <menu_name> [player] · If no player specified, opens for self · Console must specify player when using this command · Improved console compatibility: action and open commands now support console usage · Optimized logging output: Simplified custom command registration logs · Display registered custom command count on startup and reload