RecycleCore

Recycle several items or an entire chest in one operation, with a redesigned interface, resource preview and item protection.

By Ketanol. Built for Valheim 1.0.7 and BepInExPack Valheim 5.4.2350.

See VALIDATION.md for the build, accounting, in-game checks and remaining compatibility limits.

Features

• Pick up an item with the inventory cursor and press Delete to preview recycling.
• With an empty cursor, Delete or RecycleCore opens the multi-item window. With a held item, it opens the quantity preview.
• Choose the quantity and see each returned material before confirming.
• Upgrade costs are included. Returns are rounded down per selected stack after combining its complete batches and upgrade costs.
• Complete crafting batches are consumed; any remainder stays in the inventory.
• No room for all returned materials means the operation is cancelled.
• Ctrl + Delete toggles protection on the held item. Protection can also be changed in the preview.
• Equipped and quest items are protected; optional hotbar and prefab exclusions are configurable.
• Permanent deletion has its own explicit confirmation and returns no resources.
• Russian and English interface; automatic selection follows the game language.
• ServerSync synchronizes resource percentage, exclusions and deletion policy when the mod is installed on the server.

Installation

1. Install BepInExPack Valheim 5.4.2350 or later.
2. Disable RecyclePlus before enabling RecycleCore. RecycleCore declares the original mod incompatible to prevent overlapping actions.
3. Put RecycleCore.dll in BepInEx/plugins/RecycleCore/.
4. Launch once to create BepInEx/config/Ketanol.RecycleCore.cfg.

No separate ServerSync DLL is required: its source is compiled into this plugin.

Behaviour and boundaries

• Select several stacks from your inventory or an opened chest. Select entire chest selects every recyclable stack; it does not destroy the chest object.
• Chest materials remain in the same chest. Protected items, recipe-less items and incomplete crafting batches remain untouched.
• Batch recycling has a resource preview and a second confirmation. Permanent deletion remains a separate single-item action.
• All selected inputs are removed in staging before rewards are allocated. If the complete result does not fit, the whole batch is rejected.
• Open-chest access, distance, network ownership, ward permissions and contents are checked before committing. The mod never claims chest ownership itself.
• Hotbar protection applies only to the player inventory, not the first row of a chest.
• Each stack is calculated separately: partial crafting batches are not combined across stacks. Fractional returns round down per stack.
• Recipes with alternative ingredients are not automatically refunded: the original ingredient cannot reliably be inferred.
• If a crafting recipe does not exist or its return is zero, recycling is disabled. Deletion remains a separate choice if server policy permits it.
• The inventory is staged using Valheim's own stacking methods, then committed in one change while preserving existing ItemData identities.
• The commit updates the inventory list and invokes its change notification once. Mods which rely specifically on intercepting Inventory.AddItem/RemoveItem on the live player inventory require compatibility testing.
• Client-side recycling is not a server anti-cheat system. ServerSync synchronizes policy; it does not move item ownership to the server.
• Item protection is saved in item custom data. Compatibility with other mods that overwrite custom data or merge stacks needs verification.
• Keyboard and mouse are the initial input target; controller navigation has not been implemented.

Development

Full source code and the runtime test harness are distributed separately from this installable package. See VALIDATION.md for the checks performed and compatibility limits.

Credits

Based on RecyclePlus by TastyChickenLegs, published under the Unlicense: https://github.com/TastyChickenLegs/RecyclePlus

RecyclePlus also credits aedenthorn for the original recycling code/idea and VirutaCode for its trashcan asset. RecycleCore uses its own code-built interface and does not bundle the original trashcan images or sounds.

ServerSync by Tykea / blaxxun-boop, MIT-0: https://github.com/blaxxun-boop/ServerSync

See THIRD_PARTY_NOTICES.md and licenses/.