HyTrash

A Hytale plugin that adds a portable trash bin with undo functionality - delete items anywhere, anytime, and recover them with a simple command. Think of it as Windows Recycle Bin for your Hytale inventory.

Press Q to empty instantly! No commands needed - just hold your trash bin and press Q for quick deletion with confirmation.

Features

Portable Trash Bin Item

Craftable container - Holds 36 items (full inventory page worth)
Carry it anywhere - Take your trash bin on adventures, no need to run back to a static trash can
Right-click to open - Add items to your trash bin from your hotbar
Visual 3D model - Realistic trash can appearance when held or dropped
One-time craft - Only need 1 Stone Rubble at a Workbench (Tinkering station)

Deletion System

Close confirmation - Closing the bin with items inside shows a Delete / Keep Items dialog
No ESC bypass - Close confirmation cannot be dismissed with ESC; you must choose
Q-key empty - Press Q to empty with confirmation dialog
Batch deletion - Empty entire trash bin at once with /hytrash empty
Safety first - Can't accidentally delete items without confirmation
Item count preview - Dialog shows "Delete X items?" with detailed count message

Backpack Mode

Toggle with /hytrash backpack - Skip the close confirmation; items stay in the bin
Persisted across restarts - Your backpack mode preference survives server restarts
Per-player setting - Each player controls their own mode independently

Undo Functionality

5-level undo history - Recover items from your last 5 emptying operations
Per-player tracking - Each player has their own independent undo history
Simple command - Just type /hytrash undo to restore your last emptied items
Smart space check - Won't restore if your trash bin doesn't have enough slots
Visual notification - Shows confirmation with item icon and count when items are restored

Immersive Sound Effects

All audio feedback uses Hytale's native sound system:

Empty Trash - SFX_Campfire_Close_Local plays when you permanently delete items (trash bin lid sound)
Undo Restore - SFX_Divine_Respawn plays when items are restored (magical restoration sound)

Why Use HyTrash?

Mobility > Static Trash Cans

Traditional trash systems force you to:

❌ Build trash cans in your base
❌ Run back home every time you want to delete items
❌ Clutter your base with disposal systems
❌ Lose items permanently with no recovery option

HyTrash lets you:

✅ Delete items anywhere in the world
✅ Keep your inventory clean during long adventures
✅ Recover accidentally deleted items
✅ Carry one item instead of building infrastructure

Perfect For

Explorers - Clean up junk loot during dungeon runs
Builders - Quick disposal of extra blocks without cluttering chests
Miners - Delete cobblestone and dirt on the go
Everyone - Mistakes happen - undo is a lifesaver!

Commands

All commands work in-game:

/hytrash - Show plugin info and command list
/hytrash empty - Empty your held trash bin (shows confirmation dialog)
/hytrash undo - Restore last emptied items (up to 5 times)
/hytrash backpack - Toggle backpack mode (skip close confirmation)

Crafting Recipe

Workbench (Tinkering Station)

Input: 1x Stone Rubble
Output: 1x Trash Bin (36 slots)

Stone Rubble is commonly found by breaking stone blocks or rubble piles.

Installation

Download HyTrash-1.1.1.jar
Place the JAR file in your Hytale mods folder:
- %AppData%\Roaming\Hytale\UserData\Mods\
Restart Hytale
Craft your trash bin at a Workbench!

Requirements

Hytale Early Access
Java 21+

Technical Details

Container capacity: 36 slots (matches inventory page size)
Undo history: 5 operations per player
Data persistence: Uses UUID-based tracking
Threading: Safe execution on world thread
UI system: Custom interactive pages with event binding

Version

Version: 1.1.1

Known Limitations

Trash bin icon display in confirmation dialog not yet supported by Hytale UI API
Item metadata (enchantments, durability) fully preserved in undo system

Future Updates

Change trash bin model/icon

Support

For issues or suggestions, please comment on this mod.

HyTrash - Your portable solution for inventory management. Delete with confidence, restore with ease!