1.0.0 — First release

First public release. BentoMenu is a container-menu framework for Spigot, Paper and Folia: menus in YAML, themes players can switch, and an API for everything YAML can't reach.

Added

• Menus and layouts — menus/*.yml holds content, layouts/*.yml holds shape (1–6 rows, border and content regions). Layouts are reusable across menus.
• Four themes — aurora, ember, mono and sakura, switchable at runtime. Theme and language choices persist per player.
• Dynamic content — pagination, category filters, anvil or chat search, and configurable refresh intervals.
• Action chains — player/console commands, economy withdraw/deposit, item give/take, open/close menu, page change, messages, titles, sounds and theme switching.
• Conditions — permission, balance, held items, server time, random chance, plus a registry for custom conditions from other plugins.
• Cooldowns — per-button, with configurable click debounce.
• Text engine — gradients, hex colors, tags and PlaceholderAPI placeholders wherever a player sees text.
• Localization — zh_CN and en_US included; every player-facing string lives in messages/ and can be replaced wholesale.
• Developer API — dev.bento.menu.api.v1 plus a Kotlin DSL, already shaded into the jar. Register menus, actions, conditions, data sources and themes; listen to open and close events.
• Optional resource pack — real gradient borders and custom icons when installed, stained-glass fallback when not.
• Commands — open, list, theme, language, close, info, reload, validate, stats.

Compatibility

• Spigot 1.18.2, Paper 1.18.2 / 1.21.11 / 26.1.2 and Folia 1.21.8 passed functional tests.
• Paper and Folia 26.3 were verified up to startup and plugin enable.
• No NMS, no ProtocolLib, no client mods.
• Requires Java 17+, Vault (VaultUnlocked on Folia) and PlaceholderAPI.

Performance

Measured with 200 mineflayer bots on a 4-core / 8 GB test machine:

• TPS 20.00 with 200 menus open.
• 2,225 clicks in 30 seconds: TPS 19.25–20.00.
• Average click handling 0.061 ms; average render 4.00 ms.
• 5,632 renders produced 38,680 item updates — no full-inventory resends.

Known limitations

• Hybrid servers (Mohist, Arclight, …) are best-effort and untested here.
• 26.3 was only checked for startup; there is no mineflayer protocol for it yet.
• The resource pack must be delivered by the server owner.
• Some newer sound and material names fall back on 1.18 clients.

Notes

• The API package v1 is the stable surface; internal classes may change in later versions.
• An optional example addon is attached to this release.
• MIT licensed. Source, docs and issue tracker: https://github.com/chcucu/BentoMenu