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

This is a BETA build


Added

• Itemsadder support alongside Nexo Support Example:
  Spoiler: Example

  Code (YAML):

        #sapphire:
  [/LIST ]
        #  nexo-id: "sapphire_gem"  # Nexo item ID
        #  display-name: "<blue><bold>Sapphire</bold>"
        #  lore:
        #    - "<gray>Collected: <gradient:white:blue>{amount}</gradient>"
        #    - "<dark_blue><italic>A Nexo custom gem!"
        #  slot: 7
        #  page: 0
        # Example: ItemsAdder custom item (requires ItemsAdder plugin)
        #topaz:
        #  itemsadder-id: "custom_items:topaz"  # ItemsAdder namespace:id format
        #  display-name: "<yellow><bold>Topaz</bold>"
        #  lore:
        #    - "<gray>Collected: <gradient:white:gold>{amount}</gradient>"
        #    - "<gold><italic>An ItemsAdder custom gem!"
        #  slot: 8
        #  page: 0
  • added an optional broadcast message to the config
    
    Spoiler: Example

    Code (YAML):

    broadcast-message : "<gold>✦</gold> <gradient:green:yellow>{player}</gradient> <green>has completed the <bold>{category}</bold> collection!</green> <gold>✦</gold>"
  • Add a permissions check for items that will auto unlock if a player has the permission
    
    Spoiler: Example

    Code (YAML):

    unlock-permission : "collections.vip.ruby"
  • new placeholder for specifying amount of items collected %collections_<category>_<item>%
  • Multi commands support for category completion
    
    Spoiler: Example

    Code (YAML):

       complete-commands :
         - "give {player} emerald 10"
          - "xp give {player} 100"
          - "title {player} title {\"text\ ":\"Gems Completed!\ ",\"color\ ":\"gold\ "}"
    
    

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
  
  Code (YAML):

  must-match : false
• You can now configure sounds and messages when a player obtains an item within a category add
  
  Code (YAML):

  
  
  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
  
  Code (YAML):

  
  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
  
  Spoiler: Config Changes

  Code (YAML):

  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