่ทณ่ฝฌ่‡ณ

๐Ÿ  Home

The next-generation Minecraft GUI plugin powered by the Paper Dialog API โ€” a fresh interactive experience beyond traditional chest menus

KaMenu is a GUI plugin built for modern Minecraft Paper servers. It abandons the traditional Inventory (chest) menu pattern in favor of the native Paper 1.21.7+ Dialog API, providing players with a modern menu interface featuring rich interactive components such as text inputs, sliders, dropdowns, and checkboxes. Configuration is YAML-based โ€” clean, intuitive, and ready to use out of the box.

โš ๏ธ Important:

  • Minimum version: Paper 1.21.7
  • Recommended version: Paper 1.21.8+
  • Full feature version: Paper 1.21.9+ (supports sprite item icons, player head avatars, and other advanced features)

KaMenu does not support Paper 1.21.6 or earlier. Make sure your server meets the version requirements!

โœจ Core Features

๐Ÿ–ฅ๏ธ Modern GUI Based on the Dialog API

Say goodbye to chest menus and embrace native UI:

  • A brand-new Paper Dialog menu interface with a more modern look
  • Multiple rich interactive components: text inputs, numeric sliders, dropdown selects, checkboxes
  • Supports Item (item display) and Message (plain text) content components
  • Three bottom button layout modes: notice, confirmation, multi

๐Ÿ”ง Highly Customizable

  • Fully YAML-based configuration โ€” no programming knowledge required
  • Supports multi-level folder structures for easy management of large numbers of menus
  • Hot-reload support โ€” no server restart needed after editing configs

๐Ÿ”€ Powerful Action System

Supports a wide range of button click actions:

  • tell / actionbar / title โ€” multiple message delivery methods
  • command / console โ€” execute player or console commands
  • sound โ€” play sounds (with volume, pitch, and category parameters)
  • open / close โ€” menu navigation and dismissal
  • hovertext โ€” hoverable and clickable chat text
  • actions โ€” execute predefined action lists (supports reuse and conditional branching)
  • wait โ€” delay subsequent actions
  • set-data / set-gdata โ€” read/write persistent data
  • url / copy โ€” open links or copy to clipboard

๐Ÿ” Universal Condition System

  • Use conditions in any text field (title, button text, component text)
  • Nest conditions within action lists for branching execution logic
  • Supports PlaceholderAPI variables, comparison operators (== != > < >= <=), and logical operators (&& ||)

๐Ÿ’พ Built-in Data Storage

  • Supports SQLite (default) and MySQL
  • Player data ({data:key}): individual key-value pairs stored by player UUID
  • Global data ({gdata:key}): key-value pairs shared across all players
  • Data variables are exposed externally via PlaceholderAPI

๐ŸŒ Multiple Ways to Open Menus

  • /km open <menuId> โ€” standard command
  • Hotkey listener: configure pressing F (swap offhand) to open a specified menu
  • Custom command registration: map any word to a menu with a single line of config

๐Ÿ“Š PlaceholderAPI Support

  • Full PAPI variable parsing (usable in menu titles, component text, and actions)
  • Provides %kamenu_data_<key>% and %kamenu_gdata_<key>% variables

๐Ÿ’ฐ Support

KaMenu is a free and open-source plugin. You can download the source code from GitHub and build the latest experimental features yourself.

GitHub - Katacr/KaMenugithub.com/Katacr/KaMenu/

๐Ÿค Community & Feedback

๐Ÿ“„ License

This project is open-sourced under the GPL-3.0 license.

ไธŠไธ€้กต
๐Ÿ”– PlaceholderAPI
ไธ‹ไธ€้กต
๐Ÿš€ Getting Started