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:

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:

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:

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

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

---

Folia Support

MythicTrash is lightweight and Folia-friendly because it mainly uses inventory events and player actions.

For Folia-supported builds, the plugin should include:

folia-supported: true

Always test on your target server software before using any plugin on a live server.

---

Installation

1. Download the MythicTrash .jar
2. Place it into your server’s plugins folder
3. Restart your server
4. Edit the config if needed
5. Use /trash in-game

---

Why use MythicTrash?

MythicTrash is made for server owners who want a simple, clean, and reliable trash system without unnecessary bloat.

It helps reduce ground item clutter, removes the need for lava bins, gives players a faster way to clean their inventory, and protects important custom items from being accidentally deleted.

It is simple enough for small SMP servers, but configurable enough for larger survival, RPG, economy, skyblock, and network servers.

---

Support

Found a bug or have a suggestion?

Please include your server version, plugin version, any console errors, what you expected to happen, what actually happened, and your relevant config section if needed.

This helps issues get fixed much faster.