SafeTrash

SafeTrash is a safety-focused item disposal mod for Valheim by ADERiGMS.

Items dragged into SafeTrash are placed into a pending queue and remain in the player's inventory until permanent deletion is explicitly confirmed.

Features

• Pending queue instead of instant deletion.
• DESTROY -> CONFIRM deletion flow.
• Configurable confirmation timeout: 3–30 seconds.
• Full-stack and partial-stack support.
• Multiple queued items and separate physical stack tracking.
• Protection against duplicate queue entries.
• Queue totals for ITEMS and SLOTS.
• Multi-row queue with scrollbar support.
• Remove individual entries or clear the entire queue safely.
• Draggable window with saved position.
• Adjustable UI scale: 0.75x–1.50x.
• Configurable toggle key.
• Optional debug logging.

Screenshots

SafeTrash Window

Destruction Confirmation

Settings

Large Pending Queue

Safety Protection

Safety

SafeTrash validates queued items again before permanent deletion.

Deletion is blocked or restricted when:

• The item is in the hotbar.
• The item is equipped.
• A queued item becomes equipped before confirmation.
• The item comes from a chest or another non-player inventory.
• A queued item is moved out of the player's inventory.
• The original source stack is reduced or split.
• The queued source can no longer be safely identified.

If the source stack increases after queueing, SafeTrash deletes only the originally queued quantity.

Moving a queued item between normal player inventory slots is supported.

Items crafted by another player trigger an additional OTHER PLAYER ITEM warning.

SafeTrash does not provide refunds, recycler rewards, coins, materials, or other economy mechanics.

Usage

1. Open the normal Valheim inventory.
2. Press Delete to open SafeTrash.
3. Drag an item into the DROP ZONE.
4. Review the pending queue.
5. Press DESTROY.
6. Press CONFIRM to permanently delete the queued items.

Additional controls:

If the confirmation timer expires, SafeTrash returns to the normal DESTROY state without deleting anything.

Configuration

Available through the UI button:

• Window Size: 0.75x–1.50x
• Toggle Key: Delete
• Confirmation Time: 3–30 seconds
• Debug Logging: OFF by default
• Reset Defaults

Installation

Mod Manager

Install SafeTrash using Thunderstore Mod Manager, r2modman, or another compatible Thunderstore client.

Required dependencies are handled automatically by compatible mod managers.

Manual Installation

Install BepInExPack Valheim, then place:

SafeTrash.dll

inside:

Valheim/BepInEx/plugins/

Start Valheim, open the inventory, and press Delete.

Requirements

• Valheim
• BepInExPack Valheim

Tested Environment

SafeTrash 1.0.0 was release-tested with:

• Valheim: 1.0.15
• Network version: 40
• Unity: 6000.0.75.2503836
• BepInExPack Valheim: 5.4.2351
• BepInEx: 5.4.23.5
• Harmony: 2.9.0
• Target Framework: netstandard2.1
• Assembly/File Version: 1.0.0.0

Troubleshooting

SafeTrash does not open

Check that:

• BepInEx is installed correctly.
• SafeTrash.dll is inside BepInEx/plugins/.
• The normal Valheim inventory is open.

Item cannot be queued

Common status messages:

MOVE FROM HOTBAR
UNEQUIP FIRST

QUEUE CHANGED - RE-ADD

The original queued source changed and can no longer be safely validated.

Remove the affected queue entry and add the item again.

OTHER PLAYER ITEM

The item was crafted by another player.

SafeTrash requires an additional warning step before permanent deletion.

Logging

Normal release logging includes plugin startup, important warnings, and errors.

Additional diagnostics are available when DEBUG LOGGING is enabled.

Log file:

Valheim/BepInEx/LogOutput.log

Author

ADERiGMS

Version

1.0.0

SafeTrash Changelog

All notable changes to SafeTrash are documented in this file.

[1.0.1] - 2026-09-27

Documentation

• Updated the Thunderstore README image links to use full direct image URLs.
• Fixed screenshot presentation on the Thunderstore package page.
• No gameplay, code, configuration, or assembly changes.

[1.0.0] - 2026-09-25

Added

• Initial full release of SafeTrash for Valheim.
• Added a safe pending-trash queue: dragging an item into SafeTrash does not destroy it immediately.
• Added explicit DESTROY -> CONFIRM flow before permanent deletion.
• Added configurable confirmation timeout from 3 to 30 seconds.
• Added protection against accidental fast double-click deletion.
• Added support for full stacks, partial stacks, and multiple queued items.
• Added separate queue entries for separate physical stacks of the same item type.
• Added duplicate-source protection so the same physical item cannot be queued twice.
• Added CLEAR for safely removing all pending entries without deleting inventory items.
• Added removal of individual queue entries with left click.
• Added queue totals for ITEMS and SLOTS.
• Added multi-row queue layout with scrollbar support for large queues.
• Added protection for hotbar items with the MOVE FROM HOTBAR status.
• Added protection for equipped items with the UNEQUIP FIRST status.
• Added destroy-time revalidation so an item that becomes equipped after queueing is still protected.
• Added protection against direct item dragging from chests and other non-player inventories.
• Added validation when a queued source item is moved out of the local player inventory.
• Added protection against reduced, split, or otherwise invalidated queued stacks with QUEUE CHANGED - RE-ADD.
• Added support for increasing a queued source stack while preserving the originally queued quantity.
• Added support for moving queued items between normal player inventory slots without invalidating the queue.
• Added an extra OTHER PLAYER ITEM warning for items crafted by another player.
• Added full queue validation immediately before permanent destruction.
• Added automatic queue clearing when the player character or session changes.
• Added configurable SafeTrash window scale from 0.75x to 1.50x.
• Added draggable SafeTrash window with saved position.
• Added screen and safe-area clamping so SafeTrash windows cannot be dragged outside the usable display area.
• Added dedicated Settings and About sections.
• Added About information for mod version, BepInEx version, and author.
• Added optional debug logging for diagnostics.
• Added button press feedback for interactive UI controls.
• Added embedded SafeTrash icon resources.

Changed

• Removed the OPEN BETA label from the main SafeTrash window for the full release.
• Simplified plugin naming in logs to SafeTrash.
• Reduced routine release-log noise by moving non-critical diagnostic messages behind debug logging.
• Improved UI alignment, border consistency, spacing, and scaling behavior.
• Kept the Settings window at a fixed scale while only the main SafeTrash window follows the configured window-size setting.
• Kept normal inventory-slot movement valid instead of treating a simple slot change as an unsafe queue mutation.

Safety

• Items remain in the player's real inventory while queued.
• Initial drag into SafeTrash never permanently destroys an item.
• Permanent deletion only happens after explicit confirmation.
• The queued source item and quantity are validated again before destruction.
• If the source item is no longer valid, SafeTrash blocks deletion instead of guessing.
• Items moved into chests or other inventories are never deleted by SafeTrash.
• Hotbar and equipped-item protections are checked both while queueing and before destruction.
• No recycler rewards, refunds, coins, or hidden economy mechanics are included.

Compatibility

Tested with:

• Valheim: 1.0.15
• Valheim network version: 40
• Unity: 6000.0.75.2503836
• BepInExPack Valheim: 5.4.2351
• BepInEx: 5.4.23.5
• Harmony: 2.9.0
• Target Framework: netstandard2.1
• SafeTrash Assembly/File Version: 1.0.0.0