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.