ВЕРСИИ (14)

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

# 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://x.com/izfvh2xn/status/1865408913304437203) ## 重大なバグを修正 アイテム増殖を防げるようになりました。\ その他最適化。\ このバージョンは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-plugin/ for more detailed information.

# Please visit https://teamchill.xsrv.jp/wordpress/2024/11/mituba-menu-plugin/ 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.