Skip to main content

Global settings

plugins/EasyMenu/config.yml contains settings shared by every menu.

Put visual layout and menu items in main.yml or a YAML file inside sub.

Default configuration

language: "en_us"
debug: false

load-on-startup: true
precache-submenus: true

async:
worker-threads: 2

cache:
submenu-expiry-seconds: 300
submenu-max-size: 100
cleanup-interval-seconds: 60
resolved-path-max-size: 200

submenu:
search-depth: 3

Settings

SettingDescription
languageLanguage code such as en_us, ja_jp, or ru_ru
debugEnable detailed debug logs
load-on-startupCheck menus during startup
precache-submenusCache submenus during startup or reload
async.worker-threadsNumber of workers used to read files
cache.submenu-expiry-secondsSeconds a loaded menu stays in cache
cache.submenu-max-sizeMaximum number of cached menus
cache.cleanup-interval-secondsInterval for removing expired cache entries
cache.resolved-path-max-sizeMaximum number of remembered menu file paths
submenu.search-depthNumber of folder levels searched below sub

EasyMenu replaces zero or negative performance values with safe defaults.

How reload works

/menu reload first checks the new config.yml, language, main.yml, and every submenu.

EasyMenu switches to the new settings only after every check succeeds.

If a YAML file is malformed or contains an invalid material, EasyMenu keeps the last working settings and menus.

Worker and cache settings also take effect after reload, without a server restart.