## EasyMenu 7.0.2 This release focuses on security improvements, bug fixes, and overall stability. ### Improvements & Bug Fixes - **Security:** Fixed potential denial-of-service issues caused by extremely large numeric inputs and exponent expansion. - **Session Management:** Fixed race conditions and stale operations during menu closure and player disconnection. - **Reload Stability:** Improved configuration reload safety and prevented outdated tasks from executing after reloads. - **Input Handling:** Improved input validation, cancellation, and cleanup of pending requests. - **Configuration:** Prevented previously validated menu definitions from being unexpectedly reloaded. ### Compatibility - Requires **NegiLib 1.1.1**. - Supports Paper, Purpur, and Folia. - Supports Java Native Dialog and Bedrock Rich UI through NegiLib.

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 ```text plugins/EasyMenuPlugin/ ├── config.yml # Includes menu definitions └── sub/ └── *.yml ``` ### v5.0.0 ```text 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`. ```text 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. ```text 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 ```text /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 ```text menu.reload # Reload permission ``` ### v5.0.0 ```text easymenu.admin # New recommended reload permission menu.reload # Legacy permission kept for compatibility ``` ### Migration Example ```yaml permissions: easymenu.admin: description: "EasyMenu administrator permission" default: op ``` --- ## Initial Setup for v5.0.0 1. Install the plugin. ```text Place EasyMenu-5.0.0.jar into the plugins/ directory. ``` 2. Start the server. ```text The plugins/EasyMenu/ folder and default configuration files are generated automatically. ``` 3. Edit the configuration files. ```text plugins/EasyMenu/config.yml # Plugin settings plugins/EasyMenu/main.yml # Main menu definition ``` 4. Restart the server or reload the configuration. ```text /menu reload ``` --- ## New Performance Tuning Options The new version includes configurable performance-related settings. ### Example for Large Servers ```yaml async: worker-threads: 4 cache: submenu-max-size: 200 cleanup-interval-seconds: 30 ``` ### Example for Small Servers ```yaml 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://blog.mitubasite.org/2025/05/03/easy-menu/)

# これが3.xの最終βです 解説書いたらRelease版を公開します

これはベータ版です 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のα版はありますがデバッグしていないため公開しません。