Kmenu — GUI Menu Plugin (zMenu Compatible)

OVERVIEW

Kmenu is a GUI menu plugin for Paper 26.2+ servers. Create professional interfaces (hub, warps, profile, shop, rules…) using simple YAML files.

Fully zMenu format compatible — perfect if you're migrating from zMenu or reusing existing configurations. Kmenu is an independent, lightweight plugin optimized for Paper 26.2.

FEATURES

• zMenu YAML compatible — inventories/, commands/, items, matrix, fillItem

• Custom commands — bind /menu, /warps, /hub via commands/*.yml

• MiniMessage + legacy colors — &l, &c, Adventure gradients

• PlaceholderAPI — %player_name%, %kmenu_page%, %kmenu_max_page%

• Click actions — open menu, command, console, message, sound, title, actionbar, close, back, connect

• Requirements — permissions, cooldowns, deny messages

• Button types — NEXT, PREVIOUS, BACK, HOME, CLOSE, SWITCH, FILLER

• Player heads — skull-owner with placeholders

• Open with item — openWithItem support

• Auto-refresh — live menu updates (configurable)

• Command override — replace commands already taken (e.g. Essentials)

• No database — 100% YAML files

INCLUDED EXAMPLE MENUS

On first install, Kmenu generates demo files you can copy, edit, or delete:

• example_hub — central demo hub

• example_basic — simple menu (button, head, fillItem)

• example_navigation — back, home, sub-menus

• example_actions — message, sound, title, actionbar, command

Each file is commented in the YAML to guide you.

Try it: /example or /kmenu open example_hub

COMMANDS

• /kmenu (alias /km) — main command

• /kmenu open [menu] [page] — open a menu

• /kmenu open <player> <menu> [page] — open for another player

• /kmenu list — list loaded menus & commands

• /kmenu reload — reload configs

• /example — default demo menu

PERMISSIONS

• kmenu.use — use /kmenu and /example

• kmenu.admin — reload & open menus for others

• kmenu.open.* — open any menu

• kmenu.open.<menu> — per-menu permission

REQUIREMENTS

• Paper 26.2+

• Java 21+ (25 recommended)

• PlaceholderAPI (optional)

INSTALLATION

1. Drop Kmenu.jar into /plugins/

2. Restart your server

3. Test with /example

4. Edit or delete files in /plugins/Kmenu/

5. Run /kmenu reload after each change

FILE STRUCTURE

plugins/Kmenu/

config.yml

inventories/

example_hub.yml (demo — deletable)

example_basic.yml

example_navigation.yml

example_actions.yml

commands/

example-commands.yml (/example — deletable)

ZMENU COMPATIBILITY

• inventories/*.yml and commands/*.yml format

• open-command, fillItem, matrix

• player-commands, console-commands, messages

• Requirements with deny: and cooldowns

KMENU PLACEHOLDERS

• %kmenu_menu% — currently open menu

• %kmenu_page% — current page

• %kmenu_max_page% — total pages

SUPPORT

Get help on Discord: https://discord.gg/j9776xVJzD

Kmenu is developed by Kayz. Independent plugin, zMenu format compatible — not affiliated with official zMenu.