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/.

1.1.0 — batch recycling and chests

• New two-column inventory/chest window with item icons, selection highlighting and resource totals.
• Select multiple stacks or every recyclable item in the open chest.
• Preview, explicit batch confirmation, per-row protection and a short opening fade.
• Atomic staging across all selected items; rewards remain in the source inventory/container.
• Container access/ownership/distance checks and stale-preview cancellation.
• Preserve protected items, non-recyclable stacks and incomplete crafting batches.
• Hotbar protection only applies to the player's inventory.
• Fix reversed quantity/name in the completion message.
• Assembly and package versions now both 1.1.0.
• New batch/container runtime checks added; see VALIDATION.md for actual execution status.

1.0.1 — packaging

• Previously distributed icon update; original source assembly remained 1.0.0.

1.0.0 — initial release

• New RecycleCore identity and independent plugin/configuration identifier.
• Resource preview with quantity selection and Russian/English interface.
• Separate permanent-deletion confirmation.
• Custom-data item protection and optional hotbar/prefab exclusion policy.
• Batch-aware accounting with upgrade costs and downward rounding.
• Inventory staging, stale-preview checks and one inventory commit.
• ServerSync configuration synchronization.

Built against Valheim 1.0.7. Accounting and isolated runtime checks are recorded in the source archive. Multiplayer and third-party inventory overhaul compatibility have not been established.