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

Command Changes

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

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/