zMenu

New Features

• Pagination Management System: Introduced PaginationManager with PaginationButton, PaginationNextButton, and PaginationPreviousButton classes, allowing a single button to handle pagination. Includes max page tracking and optimized page size handling.
• Pagination Placeholders: Added pagination-related placeholders to MenuPlaceholders for enhanced inventory navigation.
• Reset Pagination Action: New ResetPaginationAction and loader to reset pagination state for button paginations.
• Skip Close Actions on Inventory Switch: Added skip-close-actions-on-switch configuration option to prevent close actions from firing when switching between inventories, fixing issues with back/inventory actions triggering on close.
• PacketManager Interface: Introduced PacketManager API interface and refactored title name handling in packet events for cleaner architecture.
• ClickAction Enum: Added ClickAction enum to streamline action handling in InventoryLoader.

Bug Fixes

• Fixed CustomModelDataComponent data handling (removed Optional) and added Paper-specific implementation (PaperCustomModelDataComponent) for proper Paper compatibility.
• Fixed head cache issue in ZMenuItemStack.
• Fixed unnecessary toLowerCase conversion on dialog names in CommandDialogOpen.
• Fixed item button click handling by removing redundant null check for clickable buttons.

Internal Changes

• Added javadocs.
• API fixes.
• Removed unused class.

Bug Fixes

• Fixed openWithOldInventories method crash on 1.20 by using CompatibilityUtil.getTopInventory() for safe inventory access.
• Fixed trim pattern and material validation: now uses Bukkit Registry instead of the hardcoded TrimHelper, with proper error messages listing all available patterns/materials when a key is not found.
• Fixed null ItemFlag entries causing errors when applying flags to item meta.
• Fixed EnchantmentGlintOverrideComponent not handling false values correctly — previously only true was applied, now both true and false are respected.
• Fixed click requirements defaulting to an empty click list when none are specified — now defaults to all click types.
• Fixed AttributeWrapper to support an optional NamespacedKey instead of always generating a random UUID, preventing attribute duplication on item rebuild.
• Fixed database connection logger initialization order in ZStorageManager.
• Fixed item loading from map (loadItemStack) to use MenuItemStackLoader instead of the removed MenuItemStackFormMap class.

Improvements

• Command Permissions: Added dedicated permissions for CommandMenuEditor (ZMENU_EDITOR), CommandMenuVersion (ZMENU_VERSION), and CommandMenuGiveOpenItem (ZMENU_GIVE_OPEN_ITEM).
• API: Added getClickRequirementKeys() method to MenuPlugin interface, allowing addons to retrieve the supported click requirement configuration keys.
• Default Configs: Updated default configuration files (pro_inventory.yml, playtime_reward.yml) to use kebab-case (view-requirement, click-requirement, open-requirement) matching current conventions.
• Dependencies: Added adventure-text-minimessage as a library dependency in plugin.yml.

Internal Changes

• Removed unused PlayerSkin class.
• Removed unused MenuItemStackFormMap class and associated fromMap static method.
• Cleaned up imports and formatting across multiple files.

New Features

• MMOItems Support: Added material loader for MMOItems plugin integration.
• Enchantments Component: Added enchantments component support for item configuration.

Performance

• Performance improvement for items that will use a player's nickname to be displayed (player-head optimization).

Bug Fixes

• Fixed enchant key parsing in configuration.
• Fixed enchantments component initialization.
• Fixed title parsing before sending to player in PlayerTitleAnimation.
• Fixed dynamic material check in menu item stack caching logic.
• Fixed %player% as a valid player argument in validators.
• Fixed error handling and formatting in various loaders and actions.
• Fixed basehead itemstack rendering.
• Fixed French translations in message strings.
• Fixed wrong format issues.
• Fixed null checks for player in packet listeners.
• Fixed [] display when placeholder returns an empty list.
• Fixed null message handling in getLegacyMessage method.

Internal Changes

• Refactored placeholder package structure and usage.
• Renamed SpigotDyeColorItemComponentLoader to SpigotDyedColorItemComponentLoader.
• Changed item model type from String to NamespacedKey in MenuItemStack classes.
• Updated @Contract annotations in BaseInventory.java for clarity.
• Removed unnecessary whitespace in ComponentMeta.java.
• Removed debug messages.

New Features

• Performance Debug System: Added per-operation performance monitoring for inventory opening. Measures execution time for each step (permission checks, button building, item rendering, etc.) and logs results to console. Configurable via enable-performance-debug, with threshold filtering and whitelist/blacklist support for operation names.

Performance

• ItemStack Build Optimization: Optimized ZMenuItemStack.build() to reduce redundant work on each inventory open:
  • Eliminated duplicate PlaceholderAPI resolution for material strings (was called twice per build)
  • Pre-resolve Material at load time when no placeholders are present, skipping PAPI parsing at runtime
  • Replaced exception-based control flow for numeric material IDs with a simple numeric check
  • Pre-compute NamespacedKey for tooltipStyle, itemModel, and equippedModel in setters instead of splitting/creating on every build
  • Cache the glowing enchantment lookup instead of querying the enchantment registry on every build
  • Pre-split lore lines containing \n at load time instead of splitting on every build
  • Added early exit in Placeholders.parse() when the string contains no % character, avoiding unnecessary iteration over all placeholder entries

Internal Changes

• MiniMessage Color Parsing Refactor: Consolidated color parsing methods into MiniMessageColorUtils class for better maintainability and code reuse.
• Added unit tests to verify preservation of MiniMessage color tags.

Bug Fixes

• Fixed hex color parsing regex to correctly handle edge cases.
• Fixed typo in PlayerCommandLoader constructor parameter list.

New Features

• Dynamic Inventory Title Updates: Added PacketEventChangeTitleName and PacketTitleListener for changing inventory titles dynamically without reopening the inventory. Requires PacketEvents.
• ClearInvType for Inventory Management: Introduced ClearInvType enum and temporary inventory storage system for better inventory state management.
• Per-Inventory Click Limiter: The click limiter now only applies to zMenu inventories and can be configured per inventory with click-limiter-enabled: true/false. It no longer interferes with non-zMenu inventories.
• Enhanced ItemButton Context: ItemButton now includes inventory context for improved button logic and interactions.

Bug Fixes

• Fixed parsing of map structures inside arrays in YAML configuration. #219
• Fixed click limiter applying to all inventories instead of only zMenu inventories. #219
• Fixed inventory restoration on plugin disable. #215
• Fixed PacketEvents warning on plugin disable. #215
• Resolved scheduler compatibility issue with Folia.
• Fixed task registration during plugin shutdown.
• Enhanced variant component initialization with proper error handling and version checks.