🚀 Quick Start¶

This guide will help you quickly install and configure the KaMenu plugin.

🎮 System Requirements¶

Item	Details
Minecraft Version	1.21.7+
Java Version	Java 21+
Server Type	Paper and its forks (Purpur, etc.)
Database	SQLite (default), MySQL 5.7+

信息

Version Feature Support:

✅ Paper 1.21.7+: Full basic functionality
✨ Paper 1.21.8+: Recommended — more stable API
🎨 Paper 1.21.9+: Full features (sprite item icons, player head avatars, and more)

警告

KaMenu depends on the Paper Dialog API and does not support:

Please ensure your server runs Paper 1.21.7 or higher!

Build from source on GitHub:

Or download from these plugin distribution platforms:

All KaMenu features work standalone — no hard dependencies. The following are optional:

Optional Dependencies:

PlaceholderAPI — Use %variable% PAPI placeholders in menus
Vault — Economy integration (if you need to manipulate player balances in actions)

信息

After the first startup, sample menu files are automatically generated in plugins/KaMenu/menus/. You can reference or modify them directly.

After starting the server, the console should show the KaMenu startup banner, including the version, database type, and number of loaded menus.

You can also verify in-game with:

/km open example/actions_demo

If a demo menu pops up, the installation is working correctly.

After modifying configuration or menu files, reload without restarting the server:

/km reload

Requires the kamenu.admin permission.