✨Wandering Collectors ✨ | Despawned Items Trader | Remake icon

✨Wandering Collectors ✨ | Despawned Items Trader | Remake -----

Despawned & Lost Items will be offered as trades!




This update focuses on /wctrade improvements, GUI/category fixes, safer random handling, and stronger database/trader cleanup logic.

Added
  • Added VirtualTradeSessionManager to track /wctrade merchant sessions.
  • Added support for removing traded items from the database when using /wctrade.
  • Added getVirtualTradeSessionManager() to WanderingCollector.
  • Added getStorageKey(ItemStack item) to ItemDatabase for unified category detection.
  • Added custom category icon support in DatabaseGUI for ItemsAdder/Oraxen entries.
  • Added safer command registration with null checks for wc and wctrade.
  • Added one-use trade recipes for spawned traders and /wctrade virtual merchant offers.
  • Added randomBetween(min, max) safety helper to prevent crashes from reversed config ranges.
  • Added trader cleanup support and wired cleanup on trader death/removal.
  • Added improved database persistence safety with atomic save/backup logic and shutdown flush behavior.
  • Added migration cleanup for legacy owner/gui marker PDC data and accidentally persisted last-owner lore.

Changed
  • Updated /wctrade to use database entries instead of plain random item stacks.
  • Updated GUI category filtering to use itemDatabase.getStorageKey(item) instead of only vanilla material names.
  • Updated category GUI click handling so unnamed items can still be taken by admins.
  • Updated random price generation to use ThreadLocalRandom via randomBetween(...).
  • Updated random database selection helpers to shuffle copies instead of mutating the original list.
  • Updated startup flow so core listeners are registered immediately instead of after an unnecessary async load.
  • Updated trader cleanup to use EntityRemoveFromWorldEvent instead of the deprecated EntityRemoveEvent.
  • Changed database removal to remove only a single matching item instead of all similar items.
  • Kept GUI-only last-owner lore stripping/restoration flow for traded items.
  • Preserved last-owner tracking through despawn, drop, spawn, and merge flows.
  • Updated the Spigot update checker URL to the correct endpoint format.
  • Hardened latestVersion handling for safer async/main-thread access.

Fixed
  • Fixed /wctrade not removing purchased items from the database.
  • Fixed /wc gui so console use no longer causes a ClassCastException.
  • Fixed category GUI not showing custom whitelist categories properly.
  • Fixed category GUI not opening/clicking correctly for items without custom display names.
  • Fixed empty-category pagination showing Page 1/0.
  • Fixed possible side effects from shuffling input lists directly in ItemDatabase.
  • Fixed incorrect Spigot update-check request path.
  • Hardened GUI click handling against null, AIR, and missing display name cases.
Please consider leaving a good review for the plugin.
Discord Support
----------, Mar 18, 2026

- Fixes and better implementation of the last owner feature, the info of the last owner should appear on the trade menu only, the item returns to its original state on trade.

Please consider leaving a good review for the plugin.
Discord Support
----------, Dec 21, 2025

- Important fix, made sure items drop don't get any extra NBT tags unless they actually enter the database.
- Made sure the database is never corrupted in case of hard crashes or out of disk space errors.
- Improved database performances, latest libraries, better organization.

Please consider leaving a good review for the plugin.
Discord Support
----------, Nov 11, 2025

- New feature added that shows the last owner of each item, the lore will only appear in the trader window and it will be automatically be removed on trade so that it won't "ruin" the items.
imag11111e.png
- The new feaure is configurable in the config.yml

config.yml additions
Code (YAML):
trade_settings :
  # -------------------------------------------------------------------
  # last_owner: It will mark all trades offered by the traders
  # with the name of the last owner the item had in its lore.
  # It will ONLY appear in the trader window,
  # the final item will not be effected!
  # -------------------------------------------------------------------
  last_owner
:
    enable
: true
    message
: "&7Last Owner: &d<PLAYER>"
----------, Jul 27, 2025

- Added the command /wctrade that will open a random trade window without the need to actually summon a trader entity.

Please consider leaving a good review for the plugin.
Discord Support
----------, Mar 18, 2025

- You can now select in which worlds you want despawned items to go to the database.

Add this to your configs
Code (YAML):

###########################################################
#                     WORLD WHITELIST                      #
# Only items despawned in these worlds will be processed   #
# and saved to the database. Set whitelist_enabled to true #
# if you want to enable this check.                        #
###########################################################
worlds
:
  whitelist_enabled
: false
  whitelist
:
   - world
    - world_nether
    - world_the_end
Please consider leaving a good review for the plugin.
Discord Support
----------, Mar 1, 2025

- Added tier list for items so you can customize the min and max price of trades based on their tiers.

REGENERATE YOUR CONFIGS OR APPLY THE CHANGES
New Config.yml

Please consider leaving a good review for the plugin.
Discord Support
----------, Feb 13, 2025

- Hotfix from the previous version causing the plugin to interfere with other inventories. (Check the update bellow.)

Please consider leaving a good review for the plugin.
Discord Support
----------, Feb 9, 2025

- Organized code for better management and efficiency.
- Introduced cache mechanics for faster operations.
- New feature added, a GUI that will dynamically populate categories based on your items listed in your config.yml and then admins can use to remove items from the database while in game.
The gui can be accessed using /wc gui

[​IMG]

Please consider leaving a good review for the plugin.
Discord Support
----------, Feb 9, 2025

- Exception fix for fetching the trade material from the config.
- You can now add custom items in the whitelist section.

under whitelist:
Code (YAML):
#   - 'namespace:custom_sword'   # ItemsAdder & Oraxen custom item with its namespace
#   - 'another_namespace:another_custom_item'

Please consider leaving a good review for the plugin.
Discord Support
----------, Feb 1, 2025

- Added a config option that once enabled it will make items be deleted from the database when traded once. (Items will not be removed from existing traders though!)

Add this to your configs.

Code (YAML):
# System that will remove items from the database once they are traded.
# It won't be removed on existing already spawned traders.
one_time_trades
:
  enabled
: false # True or false
Please consider leaving a good review for the plugin.
Discord Support
----------, Jan 27, 2025

- Made the /wc status command async so that it doesnt lag the server

- Added compatibility with 1.17+

Please consider leaving a good review for the plugin.
Discord Support
----------, Aug 21, 2024

- Small dependencies update.

Please consider leaving a good review for the plugin.
Discord Support
----------, Jun 25, 2024

- Added a new command /wc status that will print important info about the plugin and its database.
- Updated dependecies.
- Optimized file imports.
- Added an update checker.

Please consider leaving a good review for the plugin.
Discord Support
----------, Apr 15, 2024

- Added a new command " /wc egg PLAYER" this will give to that player an egg that will spawn a wondering collector, the appearance of that egg is configurable in the config.yml

add this at the bottom of your config

Code (YAML):
trader_egg:
  enchanted
: true
  name
: '&dWondering Collector'
  lore
:
   - '&7Spawn me!'
    - '&7Find lost items from players!'
Please consider leaving a good review for the plugin.
Discord Support
----------, Nov 28, 2023

- Fix plugin not loading because of a wrong command registretion.

READ THE PREVIOUS UPDATE

Please consider leaving a good review for the plugin.
Discord Support
----------, Nov 2, 2023

- Added the ability to limit how many items per type can be saved in the database.
- The items database will be cleaned and adjusted based on your configs on start up.
- Added a new command that can adjust the database immedietly instead of waiting for the server startup.

Commands:
/wc reload
/wc database adjust
Permission
wanderingcollector.admin

Config Change (Ether add this section or generate a new config)
Code (YAML):
item_limits:
  default
: 200   # This is the default limit for any item not explicitly listed
  BLAZE_ROD
: 100
  BROWN_DYE
: 100
  CROSSBOW
: 100
  DIAMOND
: 50
  # Add more items and their respective limits if needed.
Please consider leaving a good review for the plugin.
Discord Support
----------, Nov 2, 2023

Please consider leaving a good review for the plugin.
Discord Support
----------, Oct 30, 2023

Resource Information
Author:
----------
Total Downloads: 42
First Release: Oct 30, 2023
Last Update: Mar 18, 2026
Category: ---------------
All-Time Rating:
4 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings