vTrash

Managing inventory clutter is a constant challenge on any Minecraft server. Players accumulate junk items, and admins need a clean, efficient way to let them dispose of unwanted goods without lag or messy world drops. That is exactly where vTrash for Minecraft shines. This lightweight plugin adds a sleek trash bin GUI that permanently deletes items with a single click, while offering powerful Discord webhook logging, customizable themes, and full admin control.

What Makes vTrash Stand Out?

Unlike basic clear-inventory commands, vTrash provides a visual, drag-and-drop interface that feels native to the game. The 54-slot menu gives players plenty of room to dump items, and the protected border slots prevent accidental interaction. A central close button instantly deletes everything inside—no second chances, no item drops. But the real magic lies in its Discord integration. Three separate webhook types log plugin events, command usage, and detailed item deletions directly to your Discord server. This means you can monitor trash activity in real time, track what players are discarding, and even set up alerts for suspicious behavior.

Customization is another core strength. Every color, material, and message can be tweaked through auto-generated YAML files. Want a dark oak border instead of light blue glass? Change it in config.yml. Need multilingual messages? Edit messages.yml with full support for hex colors and formatting codes. The plugin also hooks into Vault and EssentialsX for optional recycle rewards, turning trash disposal into a mini-economy feature.

Supported Minecraft Versions and Server Software

vTrash is built for modern Minecraft environments. It officially supports Minecraft 1.20 and above, tested thoroughly on Paper 1.21.4 with Java 17. The plugin is compatible with a wide range of server software, including Paper, Purpur, Spigot, Bukkit, Leaf, and PufferFish. While it may work on other forks like Cardboard, those are untested. Always ensure your server runs Java 17 or newer to avoid startup errors. For the best experience, use Paper or Purpur, as they offer the most stable API support for GUI-heavy plugins like this one.

How to Install vTrash

Getting started with vTrash is straightforward. Follow these steps to download vTrash and set it up on your server:

• Download the vTrash.jar file from the official source (check the plugin's Discord or wiki for the latest release).
• Place the JAR file into your server's plugins/ folder.
• Restart the server or run /reload to load the plugin.
• Once loaded, type /trash in-game to open the trash bin menu and verify everything works.

For optional features like recycle rewards, make sure you have Vault and an economy plugin like EssentialsX installed. Then grant the vtrash.recycle permission to players. To set up Discord webhooks, use the admin commands detailed below. All configuration files will generate automatically inside plugins/vTrash/ after the first run.

For those who prefer a streamlined setup, the foxygame.net launcher includes vTrash in its curated add-on catalog, allowing you to install and auto-update the plugin with a single click.

Commands and Permissions

vTrash uses a simple command structure with intuitive aliases. The main command is /trash, but players can also use /dustbin, /garbage, or /bin. Here is a quick overview:

Player Commands

• /trash – Opens the trash bin menu.
• /recycle (alias /recbin) – Opens the recycle bin menu if enabled.
• /trash help – Displays the help menu.

Admin Commands

• /trash reload – Reloads all configuration files and messages.
• /trash features webhook enable – Enables all webhook integrations.
• /trash features webhook disable – Disables all webhook integrations.
• /trash features webhook add <logs|commands|items> <webhook_url> – Adds a new webhook for a specific event type.
• /trash features webhook update <logs|commands|items> <new_webhook_url> – Updates an existing webhook.
• /trash features webhook remove <logs|commands|items> – Removes a webhook.

Permissions

• vtrash.use – Allows using the trash bin (default: true).
• vtrash.recycle – Allows using the recycle bin for rewards (default: false).
• vtrash.reload – Allows reloading the plugin (default: op).
• vtrash.admin – Grants access to webhook management and advanced features (default: op).

Discord Webhook Integration

One of vTrash's most powerful features is its ability to send real-time logs to Discord. You can configure three distinct webhook types, each targeting a different aspect of plugin activity:

• Logs Webhook – Plugin enable, disable, reload events with server name, version, and timestamp. Ideal for uptime monitoring.
• Commands Webhook – Player executes /trash, logs name, UUID, world, location, and timestamp. Tracks usage patterns.
• Items Webhook – Player closes menu with items inside, sends item count, list, world, and timestamp. Supports a minimum item trigger to avoid spam.

To set up a webhook, create a webhook URL in your Discord server, then use the admin command to add it. Invalid URLs are automatically