• Drastically reduced the file size

• Added Support for enchant requirements
• Added support for 26.x

Collections 1.4

What's New

Easier Configuration The plugin configuration has been split into separate files to make editing easier:

• 
  
• config.yml - Database and collection feedback settings
• gui.yml - How the menus look (titles, buttons, placeholders)
• categories.yml - Your collection categories and items
• messages.yml - Plugin messages

Nexo & ItemsAdder Support You can now use custom items from Nexo and ItemsAdder throughout your collection menus including category icons, navigation buttons, filler items, and placeholder items. If the custom item plugin isn't installed, it falls back to regular Minecraft items automatically.

Native Display Option New use-native-display option lets you keep the original name and description from your Nexo/ItemsAdder items instead of overriding them with config text.

Progress Indicators Category icons now show your collection progress with item count, visual progress bar, glowing effect when completed, and a checkmark indicator.

Reset Command Admins can now reset player collections:

• 
  
• /collections reset <player> - Reset everything
• /collections reset <player> <category> - Reset specific category

Category Dependencies Lock categories until players complete other categories first - great for creating progression paths.

Offline Player Viewing Admins can view any player's collections, even when they're offline.

Global Statistics New PlaceholderAPI placeholders for server-wide stats including total items collected, number of players with collections, and category completion counts.

Bug Fixes

• 
  
• Fixed duplicate item processing when clicking in inventories
• Fixed thread safety issues with player cache updates
• Fixed database connection leaks with proper resource cleanup
• Fixed custom items (Nexo/ItemsAdder) not being detected by collection listeners
• Fixed stale database connections not automatically reconnecting

Removals

Amount Counter Removed The plugin no longer tracks how many of each item you've collected - it now simply tracks whether an item has been collected or not. This simplifies the system and improves performance.

• 
  
• The {amount} placeholder in item lore no longer works
• PlaceholderAPI %collections_category_amount% replaced with %collections_category_collected%
• Individual item placeholders now return true/false instead of numbers

Added:

• Added support for 1.20-1.21.10 (Tested on 1.21.8)
• You can now select whether or not the plugin should listen for the item with the exact lore,displayname, custom model data or not. add this to your items config
  must-match: false
  
  
• You can now configure sounds and messages when a player obtains an item within a category add
  
  
  

  collection-feedback:
    # Set to true to enable collection messages and sounds.
    enabled: true
    # Message sent to the player when they collect an item (supports MiniMessage formatting).
    # Placeholders: {item} = item display name, {amount} = amount collected, {category} = category display name
    message: "<gray>» <gradient:green:aqua>{item}</gradient> <gray>collected! <white>({amount})"
    # Sound that plays when an item is collected.
    # See: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
    sound:
      enabled: true
      type: "ENTITY_EXPERIENCE_ORB_PICKUP"  # Sound effect (e.g., ENTITY_EXPERIENCE_ORB_PICKUP, BLOCK_NOTE_BLOCK_PLING)
      volume: 0.5  # Volume (0.0 - 1.0)
      pitch: 1.2   # Pitch (0.5 - 2.0, higher = higher pitch)

  
  
•  You can now set a filler item in the GUI for those pesky empty spaces

filler:
  enabled: true  # Set to false to disable filler items
  material: GRAY_STAINED_GLASS_PANE  # Material for filler items
  display-name: " "  # Name of the filler item (use " " for blank)
  custom-model-data: 0  # Custom model data for resource packs (0 = default)

Fixed

• Fixed Minimessage support
• Fixed back buttons not working
• Fixed recognizing custom items
• fixed items being taken from the latest  gui

Added

• Messages are now configurable within the messages.yml (Minimessage Support ONLY)

Changed

• Changed the way Pagination buttons populate the GUI
  
  
  
  

  Change

  
  

  
  

  pagination:
  
    previous:
  
      material: ARROW
  
      display-name: "<green>Previous Page"
  
      lore:
  
        - "<gray>Go to the previous page"
  
      custom-model-data: 0
  
      slot: -9  # Relative to GUI size: -9 means 9 slots from the end (first slot of last row)
  
    next:
  
      material: ARROW
  
      display-name: "<green>Next Page"
  
      lore:
  
        - "<gray>Go to the next page"
  
      custom-model-data: 0
  
      slot: -1  # Relative to GUI size: -1 means last slot of the GUI
  
    back:
  
      material: BARRIER
  
      display-name: "<red>Back to Categories"
  
      lore:
  
        - "<gray>Return to the category selector"
  
      custom-model-data: 0
  
      slot: -5  # Relative to GUI size: -5 means middle of the last row