Added

• Added the missing Discord messages for trash status updates.
• Added proper compatibility support for VaultUnlocked.
• Added fallback support for classic Vault if VaultUnlocked is not available.

Improved

• Improved economy hook handling by introducing a shared economy abstraction.
• Improved provider detection to support both VaultUnlocked and Vault setups.
• Improved reload behavior so economy hooks are re-initialized correctly after /trash reload.
• Improved language/config maintenance for smoother updates on existing servers.

Fixed

• Fixed missing message issues in /trash about caused by outdated key paths being used in code.
• Fixed Discord webhook message lookups so the correct language keys are used.
• Fixed economy errors when VaultUnlocked is installed.
• Fixed incorrect fallback behavior when no compatible economy provider is available.
• Fixed English locale issues where some Discord messages were not properly aligned with the expected keys.

Added

• Added automatic language file updating when new missing keys are detected.
• Added the missing Discord messages:
  • about.discord.trash-disabled
  • about.discord.trash-disabled-description
• Added compatibility with VaultUnlocked.

Improved

• Improved configuration updating so missing keys can be merged into existing files more safely.
• Improved language file handling to keep older message files up to date after updates.

Fixed

• Fixed missing Discord localization entries related to trash disable notifications.

Added:

• Added Discord webhook support for trash status updates.
• Added embed webhook messages for trash state changes.
• Added multilingual webhook message support through MessageManager.
• Added webhook configuration options for username, avatar, footer, and thumbnail.

config.yml:

messages_en.yml example:

Added

• Added a new config option to globally enable or disable item filters.
• Filters can now be turned off directly from config.yml with:

Fixed

• Fixed the trash.filter.bypass permission being declared but not actually used in the code.

Added:

• Added multi-line messages support for /trash about command.

Added:

• New command /trash about.
• Updated language files.
• New default trash.about permission.

New Features
Personal Item Filters (/trashfilter)
Players can now manage their own personal item blacklist directly in-game. Items added to the blacklist will be blocked when trying to trash them, giving players full control over what they can accidentally delete.

• /trashfilter blacklist <material> — Add a material to your personal blacklist
• /trashfilter whitelist <material> — Remove a material from your personal blacklist
• /trashfilter list — View all materials currently in your blacklist
• /trashfilter reload — Reload filter configuration (admin only)

Tab completion is supported for all material names.

Global Trash Toggle
Admins can now enable or disable the trash for all players server-wide without restarting or editing config files.

• /trash enable — Enable the trash globally
• /trash disable — Disable the trash globally
• /trash toggle — Toggle between enabled/disabled

The state persists across server restarts automatically via config.yml.

Stats Persistence
Player statistics (items trashed, opens, rankings) are now saved to disk in stats.yml and survive server restarts. Stats auto-save every N minutes (configurable via stats.auto-save-minutes) and also save on plugin shutdown.

Bug Fixes

• Fixed trash being blocked when enabled and open when disabled — The enable/disable logic in OpenTrashCommand was inverted, causing the opposite behaviour of what was intended.
• Fixed /trash enable|disable|toggle crashing — setTrashEnabled() was called but never implemented, causing a runtime error on every toggle attempt.
• Fixed /trashfilter list showing nothing — The %materials% placeholder was never replaced with the actual list of blacklisted materials.
• Fixed stats not persisting — savePlayerStats() only logged a message but never wrote anything to disk.
• Fixed trash GUI detection — Any chest inventory could be mistakenly detected as the trash GUI. Now correctly checks for the TrashHolder instance.
• Fixed cooldown message not sending — Cooldown remaining time now correctly uses the %seconds% placeholder in the message.
• Fixed placeholder conflicts in MessageManager — args[0] was being applied to multiple named placeholders simultaneously (%latest_version%, %items%, %1%), causing wrong values to appear in messages.

New Permissions
Permission Description Default
trash.toggle Allow enabling/disabling trash globally op
trash.filter.blacklist Manage personal item blacklist true
trash.filter.bypass Bypass all filters op
Config Changes
A new key has been added to config.yml. Existing configs will not be overwritten.

# Controls whether the trash is enabled for all players.
# Use /trash enable | disable | toggle to change in-game.
trash-disabled: false

✨ New Features

• Pagination system in /trash top: The /trash top command now displays results divided into pages of 10 players
• Page navigation: Added commands /trash top opens <page> and /trash top items <page>

Improvements

• Updated Trash Top:
  • Now you can set custom messages.
  • Implemented full pagination with page validation
  • Displays current and total page numbers

Updated Commands

• /trash top [opens|items] [page] - Displays top with pagination
• Command now shows format: "#1 Player - 100" with colors

Fixed

• Fixed multiple internal bugs and improved overall stability.
• Improved compatibility with newer Paper versions (inventory handling).

Added

• Added /trash toggle to switch the trash state between enabled/disabled.
• Added %trash_cost% placeholder support in messages.
• Added the key message: items_deleted

Added:

• Some internal bugs have been fixed.
• Various optimizations have been made to the plugin to improve its performance and overall functionality.
• A new parameter has been added to config.yml that allows statistics to be saved automatically at set intervals.

Added

• Trash cooldown system
• New configurable cooldown between /trash uses.
• Config options: cooldown.enabled, cooldown.seconds, cooldown.bypass-permission.
• New bypass permission: trash.cooldown.bypass.
• New cooldown message showing remaining time: trash-cooldown.

Changed

• Updated language files.

Added

• Player statistics system
  • Tracks how many times a player opens /trash.
  • Tracks how many items a player trashes (total amount).
  • Data is stored persistently in data.yml.
• Leaderboards
  • New command: /trash top opens [page] — Top players by trash opens.
  • New command: /trash top items [page] — Top players by trashed items.
  • New permission: trash.top (default: OP).
  • PlaceholderAPI support (extended)
  • Kept existing placeholder: %trash_cost%
  • New placeholders:
    • %trash_opens% — Player open count.
    • %trash_items% / %trash_items_trashed% — Player trashed items count.
    • %trash_rank_opens% — Player rank by opens.
    • %trash_rank_items% — Player rank by items trashed.

Changed

• Language files are now only created if missing (prevents repeated “already exists” warnings).

Fixed

• Prevents item loss when charging on close and a player can’t afford the cost (items are returned).

Added

• Default FREE usage: /trash is free for everyone out of the box (economy.enabled: false by default).
• Optional economy charging system configurable in config.yml.
• Free access bypass via permission when charging is enabled:
  • Config key: economy.free-permission (default: trash.economy.free)
  • Permission declared in plugin.yml.

Changed

• Economy logic now respects economy.charge-on-open:
  • true → charge when opening the trash GUI.
  • false → charge when closing the GUI only if items were actually trashed.

Fixed

• When charging on close and a player can’t afford the cost, items are returned to the player (or dropped if inventory is full) and a proper message is sent (not-enough-money-on-close).

- Support for the French language has been added.

- Spanish language support has been added. It is now configured through the config.yml file.

- Bug Solved Update Checker

The plugin always showed that there was an update even when there wasn't one.

- config.yml Updated

The default-rows parameter has been added for users who do not have permissions or in case this permission is not configured.

- Update Checker Added

- It is now possible to modify which messages will show the default prefix through the messages.yml file.
- The prefix is now changed from the config.yml file.

- File messages.yml added, now you can edit the default messages.

- Added /trash reload for reload plugin configuration.

- English Version
- Bug solved: Previously, you could use Trash for free even if you had the charging option activated.
- Plugin enabled message updated.