Description
Gallery
Changelog
Versions
Trash is a basic plugin designed for those who want a simple and customizable /trash command without requiring the use of plugins like EssentialsX, CMI or other plugins. Now compatible with PlaceholderAPI.
You can support the plugin by making a donation through this link: https://paypal.me/PabloHernandez601
📤 Installation Guide
This plugin is compatible from version 1.11x to 1.21x.
Download the latest version of the plugin and upload it to your server's plugins folder.
Once uploaded, restart the server for the changes to take effect.
✅ Features:
- Simple command /trash, is responsible for opening a temporary inventory to delete your objects.
- /trash reload command for users with trash.reload or OP permissions.
- config.yml file to customize all functions to the maximum.
- Integrated economy to be able to charge for the use of the /trash command. (Required Vault and Economy Plugin - ex. XConomy)
- Open cooldown.
- Trash enable or disable.
- Trash Filter (enable/disable) in the config.yml.
- Trash Filter you can now block specific items.
- Trash Status Discord Webhook
🧑💼 Permissions:
- trash.use (Permission to use /trash command)
- trash.row.(number) (Max. 6 rows)
- trash.reload
- trash.economy.free
- trash.top
- trash.toggle
⌨️ Commands:
- /trash [/t, /basura]
- /trash reload
- /trash top opens
- /trash top items
- /trash [enable/disable/toogle]
- /trashadmin history (user)
📸 Screenshots:
Various language support will be expanded.
Economy parameter of the config.yml file
Trash can Inventory
SpigotMC:
https://www.spigotmc.org/resources/trash-1-18x-1-21x.127985/
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 | ||||
| 9h ago | 1 |
[4.9.2] Trash 4.9.2
by Pablitoo_h on Oct 15, 2026
Download
## EN:
## ES:
- Fixed messages file not properly loading certain entries.
## ES:
- Corrección de un fallo al cargar ciertos mensajes desde el archivo de configuración de mensajes.
[4.9.1] Trash 4.9.1
by Pablitoo_h on Oct 15, 2026
Download
## EN:
## ES:
- Fixed an issue that prevented items from being picked up from the trash once inside.
## ES:
- Se ha solucionado un problema que no permitía recoger los ítems de la basura una vez dentro.
[4.9] Trash 4.9
by Pablitoo_h on Oct 15, 2026
Download
## An issue has been identified that prevents items from being retrieved from the Trash once placed; this is fixed in v4.9.1.
## EN:
## ES:
## EN:
- Trash bin dupe fix: Added a tracking system for cursor items originating from the trash bin to prevent duplication exploits.
- Trash drag protection: Blocked dragging and relocating items directly out of the trash bin into the bottom inventory.
- Admin History GUI fix: Fixed inventory click detection so interacting with your own inventory while viewing history menus no longer triggers unintended GUI actions.
## ES:
- Corrección de duplicación en la papelera: Se añadió un sistema de rastreo para ítems en el cursor provenientes de la papelera, evitando exploits de duplicación.
- Protección al arrastrar desde la papelera: Se bloqueó el arrastre y la reubicación de objetos directamente desde la papelera hacia el inventario inferior.
- Corrección en la GUI de historial: Se ajustó la detección de clics para que interactuar con tu propio inventario mientras ves menús de historial ya no active acciones involuntarias del menú.
[4.8] Trash 4.8
by Pablitoo_h on Oct 15, 2026
Download
### EN:
### ES:
- A fully configurable sound system has been added to the plugin.
### ES:
- Se ha añadido un sistema de sonidos completamente configurable al plugin.
[4.7] Trash 4.7
by Pablitoo_h on Oct 15, 2026
Download
## Improved:
- Various internal plugin improvements have been made.
- New Update Checker System: Introduced a dedicated UpdateChecker class. All logic regarding version checking (API connection, response parsing, and comparison) is now isolated and encapsulated.
- Economy Setup Optimization: Merged Vault and UnlockedEconomy setup methods into a single generic method, reducing code duplication and paving the way for future economy providers.
- Improved Configuration Reload (/trashadmin reload): Implemented a native reload() method within HistoryManager. The configuration now updates without recreating the class instance, completely preventing session history loss.
[4.6] Trash 4.6
by Pablitoo_h on Oct 15, 2026
Download
## Added:
- A new command ``
/trashadmin history (user)`has been added, allowing access to a GUI to view the times that user has discarded items using`/trash``. This gives the ability to restore items for players.
[4.5] Trash 4.5
by Pablitoo_h on Oct 15, 2026
Download
## Added:
- Added compatibility with Folia
- The plugin's performance has been optimized.
[4.4] Trash 4.4
by Pablitoo_h on Oct 15, 2026
Download
## Improved:
- Internal optimizations have been made to the plugin.
[4.3] Trash 4.3
by Pablitoo_h on Oct 15, 2026
Download
## Added:
- The ability to add custom aliases to **Trash commands** via the ``
config.yml`` file has been implemented.
[4.2] Trash 4.2
by Pablitoo_h on Oct 15, 2026
Download
## Bug Fixes
## Updated
- Discord Webhook: The User and Status field labels in embed messages were hardcoded in English regardless of the configured language. They are now fully localized using the language system.
- Italian language file ``
messages_it.yml`was corrupted. — The file has been completely recreated with proper Italian translations across all message keys.
## Updated
- Added 4 new translation keys to all 11 supported languages for the Discord webhook embed fields:
- `
about.discord.field-user`— label for the User field - `
about.discord.field-status`— label for the Status field - `
about.discord.status-enabled`— value shown when trash is enabled - `
about.discord.status-disabled`` — value shown when trash is disabled - The ConfigUpdater will automatically add the missing keys to existing language files on next server start (requires **config.auto-update: true**).
[4.1] Trash 4.1
by Pablitoo_h on Oct 15, 2026
Download
## Added
- Full support for multiline messages.
- You can now use \n inside a string to create line breaks.
- Support for YAML multiline blocks (|).
- Support for lists (-) combined with \n.
- Fixed 400 error when querying the Modrinth API.
- Improved API compatibility (proper query parameter encoding).
- Prevented crashes when handling invalid Modrinth responses.
- More stable and reliable update checking system.
[4.0] Trash 4.0
by Pablitoo_h on Oct 15, 2026
Download
## 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 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 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.
[3.9] Trash 3.9
by Pablitoo_h on Oct 15, 2026
Download
## 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 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 missing Discord localization entries related to trash disable notifications.
[3.8] Trash 3.8
by Pablitoo_h on Oct 15, 2026
Download
## 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:_**
``
# ==========================================================
# Discord Webhook
# ==========================================================
discord-webhook:
enabled: false
url: ""
username: "Trash"
avatar-url: ""
footer: "Trash Plugin"
thumbnail-url: ""
- _messages_en.yml_** example:
discord:
trash-enabled: "Trash activado"
trash-enabled-description: "El trash ha sido activado por &e%1%&7."
trash-disabled: "Trash desactivado"
trash-disabled-description: "El trash ha sido desactivado por &e%1%&7."
[3.7.1] Trash 3.7.1
by Pablitoo_h on Oct 15, 2026
Download
- Missing language files are now created automatically.
- The ``
lang/`` folder is now generated if needed. - Existing language files are preserved and are not overwritten.
- Improved message loading for incomplete or fresh installations.
[3.7] Trash 3.7
by Pablitoo_h on Oct 15, 2026
Download
- Fixed an issue where players could not remove items from the trash after placing them inside.
- Fixed deleted item counting so only items left in the trash on close are counted.
- Added configurable deleted-items notification mode: chat, action bar, both, or disabled.
- Updated all language files for consistency and placeholder fixes.
[3.6] Trash 3.6
by Pablitoo_h on Oct 15, 2026
Download
## Added
## Fixed
- Added a new config option to globally enable or disable item filters.
- Filters can now be turned off directly from config.yml with:
filters:
enabled: false
## Fixed
- Fixed the trash.filter.bypass permission being declared but not actually used in the code.
[3.5] Trash 3.5
by Pablitoo_h on Oct 15, 2026
Download
## Added:
- Added multi-line messages support for ``
/trash about`` command.
[3.4] Trash 3.4
by Pablitoo_h on Oct 15, 2026
Download
## Added:
- New command **/trash about**.
- Updated language files.
- New default ``
trash.about`` permission.
[3.3] Trash 3.3
by Pablitoo_h on Oct 15, 2026
Download
### 🆕 New Features
#### Personal Item Filters (
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.
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.
The state persists across server restarts automatically via
#### Stats Persistence
Player statistics (items trashed, opens, rankings) are now saved to disk in
### 🐛 Bug Fixes
### 🔑 New Permissions
| Permission | Description | Default |
|---|---|---|
|
|
|
### 📄 Config Changes
A new key has been added to
``
#### 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
OpenTrashCommandwas inverted, causing the opposite behaviour of what was intended. - Fixed
/trash enable|disable|togglecrashing** —setTrashEnabled()was called but never implemented, causing a runtime error on every toggle attempt. - Fixed
/trashfilter listshowing 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
TrashHolderinstance. - 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.``
yaml
# Controls whether the trash is enabled for all players.
# Use /trash enable | disable | toggle to change in-game.
trash-disabled: false
``
[3.1] Trash 3.1
by Pablitoo_h on Oct 15, 2026
Download
## Fixed
- Fixed multiple internal bugs and improved overall stability.
- Improved compatibility with newer Paper versions (inventory handling).
- Added /trash toggle to switch the trash state between enabled/disabled.
- Added %trash_cost% placeholder support in messages.
- Added the key message: items_deleted
[3.0] Trash 3.0
by Pablitoo_h on Oct 15, 2026
Download
## 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.
[2.9] Trash 2.9
by Pablitoo_h on Oct 15, 2026
Download
- Added global **enable/disable system** for Trash: ``
/trash enable`and`/trash disable.` - Trash enabled state is now **saved persistently** and remains after server restarts (`
data.yml`). - Added new messages:
- `
trash-disabled`(shown when players try to use Trash while disabled) - `
trash-enabled`/`trash-disabled-admin`` (admin feedback) - Added new permission: **trash.toggle** (default: OP).
[2.8.2] Trash 2.8.2
by Pablitoo_h on Oct 15, 2026
Download
- Language files have been fully updated (it is recommended to completely delete the language folder before updating the plugin).
- The issue with the cooldown variable has been fixed.
[2.8.1] Trash 2.8.1
by Pablitoo_h on Oct 15, 2026
Download
- Added new **language files** and auto-generation on first run:
- Italian ``
(messages_it.yml)` - Portuguese `
(messages_pt.yml)` - Russian `
(messages_ru.yml)` - Dutch `
(messages_nl.yml)` - Turkish `
(messages_tr.yml)` - Japanese `
(messages_ja.yml)``
- Reviewed** and **fixed** various internal plugin issues.
[2.8] Trash 2.8
by Pablitoo_h on Oct 15, 2026
Download
## Added
## Changed
- 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.
[2.7] Trash 2.7
by Pablitoo_h on Oct 15, 2026
Download
## Added
## Changed
## Fixed
- 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).
[2.6.1] Trash 2.6.1
by Pablitoo_h on Oct 15, 2026
Download
- Bugs in the UpdateChecker have been fixed.
- Automatic updates for the config files have been added (in testing).
[2.6] Trash 2.6
by Pablitoo_h on Oct 15, 2026
Download
## Added
## Changed
## Fixed
- 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).
[2.5.2] Trash-2.5.2
by Pablitoo_h on Oct 15, 2026
Download
- Bug Solved:** Small internal error in message management.
