ВЕРСИИ (42)

## EN: - 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.

## EN: - 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.

## An issue has been identified that prevents items from being retrieved from the Trash once placed; this is fixed in v4.9.1. ## 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ú.

### EN: - A fully configurable sound system has been added to the plugin. ### ES: - Se ha añadido un sistema de sonidos completamente configurable al plugin.

## 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.

## 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.

## Added: - Added compatibility with Folia ## Improved: - The plugin's performance has been optimized.

## Improved: - Internal optimizations have been made to the plugin.

## Added: - The ability to add custom aliases to **Trash commands** via the ```config.yml``` file has been implemented.

## Bug Fixes - 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**).

## 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 - Fixed 400 error when querying the Modrinth API. - Improved API compatibility (proper query parameter encoding). - Prevented crashes when handling invalid Modrinth responses. ## Improved - More stable and reliable update checking system.

## 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:_** ``` # ========================================================== # 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." ```

- 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.

- 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.

## Added - 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.

## 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. ```yaml # Controls whether the trash is enabled for all players. # Use /trash enable | disable | toggle to change in-game. trash-disabled: false ```

## 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 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).

- 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.

- 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.

## 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).

- Bugs in the UpdateChecker have been fixed. - Automatic updates for the config files have been added (in testing).

## 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).

- **Bug Solved:** Small internal error in message management.

- **Bug Solved:** Fixed a minor issue that occurred due to missing messages in files.

- Now you can modify the **UpdateChecker** message (this is only for players with permissions on the server).

- **UpdateChecker message** modified.

- Issues with languages ​​have been fixed, the parameter was not working correctly.

- **Bug Solved:** The %Items% variable was not working correctly.

- UpdateChecker Modified

- **Bug Solved:** An issue with color codes that weren't working correctly in plugin messages has been fixed.

- New variables and PlaceholderAPI support have been added. - There is no complete assurance that all variables are working at the moment. Tests have been carried out mainly with the Vault variables, in this case: **%vault_eco_balance_formatted%**. - **Message files** have been updated. - The **%trash_cost%** variable displays the cost data that has been configured in the **config.yml** file. - The aliases **/t** and **/basura** have been added. More aliases will be added gradually. If you want to add your own aliases, it is recommended to use the **MyCommand** plugin.

- **Bug Solved:** The **trash.row.1** permission was set by default, so the **default-rows** parameter in **config.yml** was not working correctly.

- Bug Solved: You can now execute the **/trash reload** command in the console.

- An optional action bar has been added that will display items you have deleted when you close **/trash**. - German language has been added.

## Changes v2.0: - Free Trash permission added: trash.economy.free - Added Tab Complete for **/trash reload** only for users with **trash reload** or **OP** permissions. - Added **Close Button** at the Trash can inventory. - Added **support** for the Polish language. ### Older Versions Changelogs: - **Plugin enabled message updated.** - Bug solved: Previously, you could use Trash for free even if you had the carging option activated. - English Version. - Added **/trash reload** for reload plugin configuration without restarting Server. - File **messages.yml** added, now you can edit the default messages. - The prefix is now changed from the **messages_x.yml**. - It is now possible to modify which messages will show the default prefix through the **messages_x.yml**. - **Update Checker** added. - **config.yml** Updated - **Update Checker Bug** Solved - Spanish language support has been added. It is now configured through the config.yml file. - Support for the French language has been added.