Download File

## New Features - **Live sync for button patterns**: the website can now push button patterns as well as inventories. A new `pattern.sync` event installs a pattern sent from the Pattern Studio, and an inventory that depends on patterns now downloads and installs **all of its patterns first** (sequentially, so the inventory never reloads on a half-updated set) before being reloaded. Patterns are written into `patterns/` (or into another plugin's `patterns/` folder when the website sends a `plugin_name`), with the same guarantees as inventories: SHA-256 verification, size limit, path sanitisation, `BUTTON` type validation, atomic write with a `.bak` backup and rollback on a load failure. - **New requirement `item-rule`**: check the item a player is holding or wearing against a zMenu rule. Configure it with `rule` (any rule supported by the rule engine), `item-source` (`HAND`, `OFF_HAND`, `HELMET`, `CHESTPLATE`, `LEGGINGS`, `BOOTS` or `INVENTORY`), `amount` (minimum quantity, counted across the whole inventory when `item-source: INVENTORY`) and the usual `deny` / `success` actions. - **Give an item on the first join of a world**: custom items can use `give-first-world-join` in their `mechanics.itemjoin` section (a single world name or a list). The item is given the first time the player enters that world - on join or on a world change - and the visited worlds are stored in database (new `first_world_join` table, created automatically), so the item is never given twice. - **Localized dialog messages**: `dialog-plain-message-body` now accepts a `localized-messages` section with one message list per locale, used when the client's language matches. ## Improvements - Updated [CurrenciesAPI](https://github.com/GroupeZ-dev/CurrenciesAPI) to version 1.0.14 (fixed the `ExcellentEconomy` enum name, old usage deprecated) - **All economy and item plugins are now declared in `paper-plugin.yml`** as optional dependencies (Vault, PlayerPoints, BeastTokens, CoinsEngine, EcoBits, ElementalTokens, ElementalGems, ExcellentEconomy, RedisEconomy, RoyaleEconomy, VotingPlugin, zEssentials, plus CraftEngine, Denizen, Shopkeepers, zItems, eco, Nexo, NextGens, Nova), so their classes are always visible to zMenu when they are installed - and none of them is required to start. - **Commands accept a target player again in a uniform way**: player arguments no longer use a raw string argument (a name with a space could break the parsing) and every command resolves its target through the same helper - selector, online player or offline player - falling back to the command sender. `/zmenu players convert` can now be run from the console / on another player. - `/zmenu save <name> [type]`: the `type` argument is now a real enum argument (`YML` / `BASE64`) with proper completion, and it is **optional** - it defaults to `BASE64`. - **CraftEngine items are now built with the player context**, so per-player CraftEngine items resolve correctly inside menus. - **PacketEvents listeners are thread-safe**: animation and click-limiter data now use `ConcurrentHashMap`, and inventory tasks are scheduled on the player's region instead of resolving a container location (safer on Folia). - **More logs to debug items**: eco item lookup failures are logged in debug mode, and an unknown mechanic now reports the file it comes from and the list of available mechanics. ## Fixes - Fixed the on-click mechanic never running: `OnClickMechanicFactory` was not registered in the item manager. - Fixed `clearInventory: true` leaving the player inventory untouched: the saved items are now actually removed after being cloned, and only the 36 storage slots are processed (armor and off-hand are left alone). - Fixed color values not being clamped in `ColorUtils` (and a potential `NullPointerException`). - Fixed the offline player cache never being uninstalled on disable. - Cooldowns now clean up their expired entries and drop empty maps instead of growing forever.