MythicTrash

# MythicTrash **A clean, safe, configurable trash GUI for Minecraft servers.** MythicTrash gives players a simple double-chest trash menu where they can place unwanted items. When the menu closes, anything left inside is deleted. It is lightweight, easy to use, and perfect for survival, SMP, RPG, economy, skyblock, factions, and general Minecraft servers that want a clean way for players to dispose of junk. No complicated setup. No messy commands. Just open the trash, place items inside, and close it. --- ## What does MythicTrash do? MythicTrash adds a simple `/trash` command that opens a large disposal GUI. Players can move unwanted items into the menu, close it, and the plugin safely removes the contents. It is perfect for clearing out mob drops, mining junk, farming clutter, unwanted tools, spare blocks, random loot, and general inventory filler. Instead of players throwing items on the ground, building lava bins, or waiting for clutter to despawn, MythicTrash gives them a clean and reliable disposal system. --- ## Features * Simple double-chest trash GUI * Items are deleted when the GUI closes * Configurable GUI title * Configurable messages * Optional disposal summary * Shows what items were disposed of * Shows the total amount of items deleted * Blocked item protection * Block items by material * Block items by display name * Block items by lore * Supports colour codes in name and lore checks * Returns protected items instead of deleting them * Drops returned items safely if the player inventory is full * Lightweight and easy to use * No database required * Great for survival, SMP, RPG, economy, skyblock, factions, and network servers --- ## Safe Item Protection MythicTrash includes blocked item protection to help stop players from accidentally deleting important items. You can protect items by material, display name, or lore. This is useful for protecting quest items, crate keys, custom currency, admin tools, special RPG gear, event items, donor items, rare rewards, and server-specific custom items. If a blocked item is placed into the trash GUI, MythicTrash returns it to the player instead of deleting it. Example blocked item config: ```yml Blocked-Items: Enabled: true Materials: - NETHER_STAR - DRAGON_EGG - COMMAND_BLOCK - STRUCTURE_BLOCK - BARRIER Name-Contains: - "&8📍 QUEST ITEM" Lore-Contains: - "&8TEST" ``` --- ## Disposal Summary MythicTrash can show players a clean summary after they close the trash GUI. Instead of only saying that items were deleted, it can show what was disposed of and the total amount removed. Example: ```text Selling has never been easier! You disposed of: - Rotten Flesh x3 - Bone x12 - Cobblestone x64 Total items disposed: 79 ``` This makes the plugin feel more polished and gives players clear confirmation that the trash system worked. --- ## Configurable Messages Most player-facing messages can be changed in the config. You can customize the trash GUI title, blocked item messages, reload messages, delete messages, disposal summary format, item list format, and more. Example message config: ```yml Messages: Blocked-Item-Returned: "&cSome items cannot be trashed and were returned to you." Items-Deleted: "&7Disposed of &c%amount% &7item(s)." Delete-Summary: - "&8&m------------------------------" - "&a&lSelling has never been easier!" - "&7You disposed of:" - "%items%" - "&7Total items disposed: &c%total%" - "&8&m------------------------------" Delete-Summary-Item-Format: "&8- &f%item% &7x%amount%" Delete-Summary-More: "&8- &7and &f%amount% &7more item type(s)..." ``` --- ## Commands | Command | Description | | --------------------- | -------------------------------- | | `/trash` | Opens the trash GUI | | `/bin` | Opens the trash GUI | | `/dispose` | Opens the trash GUI | | `/mythictrash reload` | Reloads the plugin configuration | Command aliases may depend on your installed version. --- ## Permissions | Permission | Description | Default | | -------------------- | ------------------------------------------------ | -------- | | `mythictrash.use` | Allows players to open the trash GUI | Everyone | | `mythictrash.admin` | Allows access to admin commands | OP | | `mythictrash.bypass` | Allows bypassing certain restrictions if enabled | OP | --- ## Example Config ```yml Trash-GUI: Title: "&8MythicTrash" Settings: Send-Delete-Message: true Detailed-Delete-Summary: true Max-Summary-Items: 8 Blocked-Items: Enabled: true Materials: - NETHER_STAR - DRAGON_EGG - COMMAND_BLOCK - STRUCTURE_BLOCK - BARRIER Name-Contains: - "&8📍 QUEST ITEM" Lore-Contains: - "&8TEST" Messages: Blocked-Item-Returned: "&cSome items cann