Easymenu

Major Refactoring of Internal Logic The internal logic has been extensively overhauled. Backward compatibility for configuration files is strictly maintained as much as possible. For more details, please visit: https://wiki.mitubasite.org/docs/easymenu/upgrading Additionally, the plugin should now theoretically work on Folia as well. 内部ロジックを大規模に改造しました 設定ファイルの後方互換性は最大限維持されています 詳しくはhttps://wiki.mitubasite.org/docs/easymenu/upgradingをご覧ください また理論的にFoliaでもプラグインが動作するようになりました

Changelog

v5.0.0

Changes for Plugin Administrators

This release includes major configuration and directory structure changes from v4.2.0 to v5.0.0. ---

Directory Structure Changes

v4.2.0

plugins/EasyMenuPlugin/
├── config.yml          # Includes menu definitions
└── sub/
    └── *.yml

v5.0.0

plugins/EasyMenu/
├── config.yml          # Plugin settings only
├── main.yml            # New: main menu definition
└── sub/
    └── *.yml

Important: The plugin folder name has changed from EasyMenuPlugin to EasyMenu. ---

Configuration File Separation

v4.2.0

All settings were managed in a single config.yml.

config.yml
├── language settings
├── load-on-startup
├── menu-title
├── menu-opensound
├── menu-size
└── menu-items          # Main menu definition

v5.0.0

Settings are now separated into two files.

config.yml             # Plugin settings
├── language
├── debug
├── load-on-startup
├── precache-submenus
├── async settings      # New
├── cache settings      # New
└── submenu settings    # New

main.yml               # Main menu definition
├── menu-title
├── menu-opensound
├── menu-background-item
├── menu-size
└── menu-items

---

New Configuration Options

| Option | File | Description | |---|---|---| | debug | config.yml | Enables or disables debug mode. | | async.worker-threads | config.yml | Number of worker threads for asynchronous processing. Default: 2. | | cache.submenu-expiry-seconds | config.yml | Expiration time for submenu cache entries. Default: 300 seconds. | | cache.submenu-max-size | config.yml | Maximum number of cached submenus. Default: 100. | | cache.cleanup-interval-seconds | config.yml | Cache cleanup interval. Default: 60 seconds. | | cache.resolved-path-max-size | config.yml | Maximum number of cached resolved paths. Default: 200. | | submenu.search-depth | config.yml | Recursive search depth for submenus. Default: 3. | | submenu.listener-failsafe-seconds | config.yml | Listener failsafe timeout. Default: 30 seconds. | ---

Command Changes

| Command | v4.2.0 | v5.0.0 | Change | |---|---|---|---| | /menu | Opens the menu only. | Opens the menu or reloads the configuration. | /menu reload can now reload settings. | | /menureload | Reloads the configuration. | Reloads the configuration, but is deprecated. | Still available for compatibility. | | /submenu <id> | Opens a submenu. | Opens a submenu. | No change. |

Usage Examples

/menu              # Open the main menu
/menu reload       # New: reload settings, administrators only
/menureload        # Legacy method, deprecated
/submenu shop      # Open the shop submenu

---

Permission Changes

v4.2.0

menu.reload        # Reload permission

v5.0.0

easymenu.admin     # New recommended reload permission
menu.reload        # Legacy permission kept for compatibility

Migration Example

permissions:
  easymenu.admin:
    description: "EasyMenu administrator permission"
    default: op

---

Initial Setup for v5.0.0

1. Install the plugin.

Place EasyMenu-5.0.0.jar into the plugins/ directory.

2. Start the server.

The plugins/EasyMenu/ folder and default configuration files are generated automatically.

3. Edit the configuration files.

plugins/EasyMenu/config.yml    # Plugin settings
plugins/EasyMenu/main.yml      # Main menu definition

4. Restart the server or reload the configuration.

/menu reload

---

New Performance Tuning Options

The new version includes configurable performance-related settings.

Example for Large Servers

async:
  worker-threads: 4

cache:
  submenu-max-size: 200
  cleanup-interval-seconds: 30

Example for Small Servers

async:
  worker-threads: 1

cache:
  submenu-max-size: 50
  cleanup-interval-seconds: 120

---

Upgrade Checklist

- [ ] Confirm the plugin folder name: plugins/EasyMenu/. - [ ] Migrate from the old EasyMenuPlugin/ folder if needed. - [ ] Update config.yml to the new format. - [ ] Create main.yml and move the main menu definition into it. - [ ] Update permissions to use easymenu.admin. - [ ] Tune cache settings for your server environment. - [ ] Verify plugin behavior using the /menu command. ---

Other Improvements

| Area | Improvement | |---|---| | Cache system | Submenu cache expiration can now be managed. | | Debug mode | Detailed logs can now be output during troubleshooting. | | Asynchronous processing | Worker thread count can now be adjusted. |

Ver4.1.2

- Added multi-language support. We encountered an issue generating wikis in /wiki/readme.md and /wiki/wiki.md, so we will distribute settings via Discord: https://discord.gg/7y6kgJ7XZG - - 複数言語対応しました - /wiki/readme.mdと/wiki/wiki.mdにwikiを生成する予定でしたが失敗したのでDiscordで設定を配布します - https://discord.gg/7y6kgJ7XZG

changelog

- Implemented significant optimizations in internal processing. - This version is a beta release. - Debugging is not yet complete. - In the next version, we plan to add explanations in Japanese, Russian, and English. - A website explaining the plugins will also be released soon. - If you have any features you'd like to see added, please feel free to contact us on Discord. -内部処理の大幅な最適化を実施 -このバージョンはベータ版です -またデバッグが完了していません -次バージョンでは日本語・ロシア語・英語の説明を追加する予定です -またpluginの解説サイトを近日中に公開予定です -追加してほしい機能があったら気軽にDiscordまで

ただ今プラグインの設定方法を書いたwikiを準備中です それが終わり次第Easymenu 4.0.0を出す可能性もあります また1.21.4以上はテストをしていませんが多分動くと思われます 動かなかった場合はDiscordまでお願いします

警告

2.xと3.xの初期バージョンのconfigと このバージョンは互換性がないため 必ず一度バックアップを取ってから起動してください

Warning!!

2.x and 3.x early versions of config and This version is incompatible with Be sure to back it up once before launching it! [https://blog.mitubasite.org/2025/05/03/easy-menu/](https:…

これはベータ版です This is beta version 設定方法のドキュメントがないため使用はおすすめしません 設定方法のドキュメントが書き終わり次第リリースでも出します

easy menu 2.2.3!!

English

Fixed bugs that were included in 2.1.7. <br> Also, the notation for location in the config has changed to X Y.<br> You can now also specify lore in the config. <br> I am planning to implement submenus in the next major update. <br> I have also confirmed that it works on 1.21.1. <br> Also, there is an alpha version of ver3, but I will not release it because it has not been debugged.

Japanese

2.1.7に含まれていたバグを修正しました。<br> またconfigのlocationの表記がX Y に変わりました<br> またconfigでloreを指定できるようになりました。<br> 次のメジャーアップデートではサブメニューの実装を予定しています。<br> また1.21.1での動作も確認しました。<br> またver3のα版はありますがデバッグしていないため公開しません。

Easy menu 2.1.7 !

English

Important Notes

The configuration file name for the plugin has been changed to EasyMenuPlugin*. * The configuration syntax has also been slightly modified. It is recommended to generate a new configuration file first and then migrate your settings from the old file. * Simply transferring the old configuration file will not work. Please keep this in mind.

Changes

* Added menu-title, menu-opensound, and menu-background-item to the configuration. * Added sound and close-menu options to menu-items. If the command executed by a menu item opens another GUI*, you should specify: close-menu: false Some commands may work without this setting, but it is recommended for consistent behavior.

Remarks

* This version has only been debugged on PaperMC 1.20.1. Bugs may occur on other versions. * If you encounter any issues, please report them on Discord.<br> I am planning to implement submenus in the next major update.

Japanese

注意点

プラグインのconfigがあるファイル名がEasyMenuPluginに変更されました<br> またconfigの構文も若干変更があるため最初にconfigを一回生成してから<br> 前のファイルから設定を移行することをおすすめします<br> 前バージョンのconfigをそのまま移すだけでは動かないのでそこに留意してください<br>

変更点

　configにmenu-titleとmenu-opensoundと<br>menu-background-itemを追加。　　<br> またmenu-itemsのオプションでsoundとclose-menuを追加。<br> 実行するコマンドがGUIを開く処理をするものの場合は<br> close-menu: false<br> を指定してください。一部指定しなくても動くものがあります。

備考

1.20.1 papermcでしかデバッグしていないため他のバージョンでバグが生じる可能性があります。<br> もし発生したらdiscordまでお願いします<br> 次のメジャーアップデートではサブメニューの実装を予定しています。

WARNING: This is a Beta Version

There is a high possibility that it may not work properly.

Changes:

Now supports Java 17+ Ability to specify a sound to play when opening the menu. Ability to play a sound when each item in the menu is pressed (configurable). Config file compatibility is maintained (please take a backup just in case). Optimization. Ability to specify a menu title.

警告

これはβ版です。動作しない可能性が高いです

変更点

- ・Java17～に対応 - ・メニューを開いたときのサウンドを指定できるように - ・メニューのそれぞれの項目を押したとき、サウンド鳴らせるように（指定できます） - ・configの互換性は維持（一応バックアップを取ってください） - ・最適化 - ・メニュータイトルを指定できるように その他の解説は2.x.xでRelease版が出た際にサイトを更新する予定です。

R1.0を使用している人はすぐのアップデートを推薦します。\ Users of R1.0 are strongly recommended to update immediately. support 1.21 (papermc) [https://x.com/izfvh2xn/status/1865408913304437203](https:…

重大なバグを修正

アイテム増殖を防げるようになりました。\ その他最適化。\ このバージョンはR1.xのstバージョンです。\ 2.xは開発中です...

Major Bug Fixes

Fixed an issue that allowed item duplication.\ Additional optimizations applied.\ This version is the stable release (st) for the R1.x series.\ Development for 2.x is currently ongoing...

Please visit https://teamchill.xsrv.jp/wordpress/2024/11/mituba-menu-p… for more detailed information.

Please visit https://teamchill.xsrv.jp/wordpress/2024/11/mituba-menu-p… for more detailed information.

Please note: This plugin is compatible with Minecraft versions bukkit 1.16 and newer, but has been verified to work only on PaperMC 1.20.1. ![pl](https://cdn.modrinth.com/data/cached_images/95b54302975ac…