━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What is MythicTrash?

MythicTrash is a lightweight trash GUI plugin that allows players to quickly dispose of unwanted items using a clean inventory menu.

Instead of throwing junk on the ground, filling hoppers with garbage, using lava bins, or leaving items scattered around the server, players can simply open the trash menu, place unwanted items inside, and anything left in the GUI is deleted when the menu is closed.

It is perfect for survival, SMP, RPG, SkyBlock, prison, economy, and custom servers that want a simple but polished item disposal system.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Main Features

✔ Simple player trash command
✔ Clean trash GUI
✔ Items are deleted when the GUI closes
✔ Optional confirmation menu before deletion
✔ Detailed trash summary after disposal
✔ Shows exactly what items were disposed of
✔ Shows total amount of items deleted
✔ Fully configurable messages
✔ Fully configurable GUI title
✔ Fully configurable GUI size
✔ Fully configurable GUI buttons
✔ Configurable button materials
✔ Configurable button names
✔ Configurable button lore
✔ Configurable button glow
✔ Custom Model Data support for GUI icons
✔ Decorative/protected GUI slots
✔ Fully configurable confirmation menu
✔ Configurable confirm/cancel buttons
✔ Configurable blocked items
✔ Block items by material
✔ Block items by display name
✔ Block items by lore
✔ Supports colour-code checks using & codes
✔ Plain-text fallback for blocked name/lore checks
✔ Protected items are returned instead of deleted
✔ Admin bypass permission for blocked items
✔ Optional sounds
✔ Optional particles
✔ Admin reload command
✔ Auto config updater
✔ Config backup before automatic updates
✔ Permission-based access
✔ Lightweight and performance friendly
✔ No database required
✔ No complicated setup
✔ Clean console startup banner
✔ Designed for modern Minecraft servers

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

How It Works

Using MythicTrash is simple:

1. A player runs /trash
2. The trash GUI opens
3. The player places unwanted items inside
4. The player closes the GUI
5. MythicTrash checks for protected items
6. Protected items are returned
7. Normal items are disposed of
8. The player receives a disposal summary

This keeps your server cleaner and gives players an easy way to remove junk items without needing lava pits, cactus bins, or messy disposal machines.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Trash Summary

MythicTrash can show players a clean summary after they dispose of items.

Example:

[/LIST]
This helps players clearly see what was removed instead of only receiving a generic deleted-items message.

The summary is fully configurable in the config.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Protected Items

Server owners can prevent important items from being deleted.

This is useful for protecting:

• Nether Stars
• Dragon Eggs
• Elytras
• Crate keys
• Quest items
• Event items
• Custom RPG items
• Server menu items
• Soulbound items
• Important custom rewards

Blocked items can be checked by:

• Material type
• Item display name
• Item lore
• Colour-coded text
• Plain text fallback

If a blocked item is placed into the trash menu, MythicTrash returns it to the player instead of deleting it.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Fully Configurable GUI

MythicTrash now supports full GUI customization.

You can configure:

• GUI title
• GUI size
• Decorative/protected slots
• Button icons
• Button names
• Button lore
• Button glow
• Button amount
• Custom Model Data
• Confirmation menu title
• Confirmation menu size
• Confirm button slot
• Cancel button slot
• Confirm/cancel materials
• Confirm/cancel names
• Confirm/cancel lore

Decorative GUI slots are protected, meaning players cannot place trash items inside those slots.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Optional Confirmation System

MythicTrash can open a confirmation menu before items are permanently deleted.

This is useful for servers that want extra protection against accidental item deletion.

The confirmation menu is fully configurable, including:

• Menu title
• Menu size
• Filler item
• Confirm button
• Cancel button
• Button materials
• Button names
• Button lore
• Button glow
• Custom Model Data

If the player cancels the confirmation menu, their items are returned.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Auto Config Updater

MythicTrash includes an automatic config updater.

When new config options are added in future updates, MythicTrash can add missing paths to your existing config without wiping your current settings.

Before changes are applied, a backup is created.

This means server owners do not need to delete and regenerate their config every time new options are added.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Command	Description	Permission
/trash	Opens the trash GUI.	mythictrash.use
/mythictrash	Shows plugin usage/help.	None
/mythictrash reload	Reloads the plugin configuration.	mythictrash.reload
/mt reload	Short alias for reloading the plugin, if enabled in plugin.yml.	mythictrash.reload

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

Permission	Description	Default
mythictrash.use	Allows players to open and use the trash GUI.	true
mythictrash.reload	Allows access to the reload command.	op
mythictrash.bypass.blockeditems	Allows players to delete items normally protected by the blocked item config.	op

Important:
OP players usually receive all permissions automatically. This means OP players may bypass blocked item protection unless the bypass permission is negated in your permissions plugin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration

MythicTrash is designed to be simple but highly configurable.

You can adjust:

• Confirmation before deletion
• Empty trash messages
• Detailed delete summaries
• Maximum summary items shown
• GUI title
• GUI size
• Decorative GUI items
• Protected GUI slots
• Confirm GUI title
• Confirm GUI size
• Confirm/cancel buttons
• Blocked materials
• Blocked item names
• Blocked item lore
• Sounds
• Particles
• All messages

Example config section:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Messages

All messages are configurable, including:

• Prefix
• No permission
• Trash opened
• Items disposed
• Nothing disposed
• Reload complete
• Cancelled deletion
• Blocked item returned
• Trash summary format
• Trash summary item format

Example message section:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why Use MythicTrash?

Many servers use lava bins, cactus bins, or command blocks to let players destroy unwanted items.

MythicTrash gives your server a cleaner and safer option.

✔ No dangerous lava bins at spawn
✔ No messy item drops
✔ No complicated disposal machines
✔ No unnecessary lag from dropped junk
✔ No ugly command-block systems
✔ Easy for players to understand
✔ Useful for both small and busy servers
✔ Helps keep inventories and bases cleaner

It is especially useful on survival servers where players regularly end up with junk blocks, mob drops, damaged gear, random loot, and unwanted items.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Performance Friendly

MythicTrash is lightweight and only works when a player actively opens and uses the trash GUI.

It does not constantly scan the world.
It does not run heavy background tasks.
It does not require a database.
It does not store unnecessary player data.

The plugin is designed to be simple, clean, and safe for busy survival servers.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

1. Download MythicTrash.
2. Place the jar file into your server's /plugins folder.
3. Restart your server.
4. Edit the config if needed.
5. Run /mythictrash reload after making config changes.
6. Give players the mythictrash.use permission if your permissions plugin requires it.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements

Required:

• A Spigot or Paper based Minecraft server
• Java version supported by your server version
• Minecraft server version supported by the plugin

Optional:

• A permissions plugin for managing access

MythicTrash does not require Vault, PlaceholderAPI, WorldGuard, ProtocolLib, or any database to run.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Important Notes

Items placed inside the trash GUI are deleted when the menu closes, unless confirmation is enabled.

Players should only place items inside the trash if they are sure they want to dispose of them.

Server owners should configure blocked items if they want to protect rare server items, crate keys, custom menu items, quest items, or valuable rewards.

Deleted items are not stored in a database and cannot be recovered by MythicTrash after deletion.

If confirmation is enabled and a player cancels, their items are returned.

If blocked items are placed into the trash, they are returned unless the player has the bypass permission.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Good For

✔ Survival servers
✔ SMP servers
✔ RPG servers
✔ SkyBlock servers
✔ Prison servers
✔ Economy servers
✔ Minigame hubs
✔ Servers with custom loot
✔ Servers with lots of junk drops
✔ Servers with crate keys
✔ Servers with quest items
✔ Servers with custom RPG gear

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Example Use Cases

• Players clearing mining junk after a long mining trip
• Removing unwanted mob drops
• Cleaning inventories after events
• Letting players safely dispose of damaged tools
• Giving survival players a simple item disposal command
• Replacing lava trash bins at spawn
• Reducing dropped item clutter around bases and farms
• Protecting server items from accidental deletion
• Giving players a cleaner inventory management tool

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Planned Ideas

Future updates may include:

• Trash history/logs
• Admin trash viewer
• Per-rank trash sizes
• Per-world trash settings
• In-game GUI layout editor
• Trash signs
• Trash NPC support
• More confirmation menu options
• Economy cost to use trash
• More permission-based options

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support

If you need help, find a bug, or have a suggestion, please contact me before leaving a review.

Reviews are not the best place to report issues, as I cannot properly help you there.

When reporting a bug, please include:

• Your server version
• Your Java version
• Your MythicTrash version
• Any console errors
• A description of what happened
• Steps to reproduce the issue

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━