Simple Recycler

Adds a tab to the crafting station that recycles (uncrafts) items from player's inventory.

Previously this mod operated via a button placed on containers. Both are still in and can be enabled via settings. Container approach is kept for compatibility and will be removed in future versions.

Key points

• Returns 50% of the resources by default. Configurable via settings.

• You need to know the recipe for the item to "uncraft" it

• You can move the recycling button by pressing the left Ctrl and right click dragging the button

• Has a fail safe to prevent accidental presses

  

Manual installation

Drop the .dll into <GameLocation>\BepInEx\plugins

Encountered an issue?

Please create an issue in the GitHub repo here:

https://github.com/abearcodes/Valheim/issues/new

Development plans

• introduce a separate buildable "station" to do the uncrafting
• add option to uncraft even if recipe is unknown

Configurability

## Settings file was created by plugin SimpleRecycling v0.0.7
## Plugin GUID: com.github.abearcodes.valheim.simplerecycling

[General]

## Rate at which the resources are recycled. Value must be between 0 and 1.
## The mod always rolls *down*, so if you were supposed to get 2.5 items, you would only receive 2.
# Setting type: Single
# Default value: 0.5
RecyclingRate = 0.5

## If enabled and recycling a specific _unstackable_ item would yield 0 of a material,
## instead you will receive 1. If disabled, you get nothing.
# Setting type: Boolean
# Default value: true
UnstackableItemsAlwaysReturnAtLeastOneResource = true

## If enabled and recycling an item would yield 0 of any material,
## instead you will receive 1. If disabled, you get nothing.
# Setting type: Boolean
# Default value: true
PreventZeroResourceYields = true

## If enabled, it will allow you to recycle items that you do not know the recipe for yet.
## Disabled by default as this can be cheaty, but sometimes required due to people losing progress.
# Setting type: Boolean
# Default value: false
AllowRecyclingUnknownRecipes = false

[Recycling on containers]

## If enabled, the mod will display the container recycling button
# Setting type: Boolean
# Default value: true
ContainerRecyclingEnabled = true

## The last saved recycling button position stored in JSON
# Setting type: String
# Default value: {\"x\":502.42425537109377,\"y\":147.06060791015626,\"z\":-1.0}
ContainerButtonPosition = {\"x\":502.42425537109377,\"y\":147.06060791015626,\"z\":-1.0}

[UI]

## If enabled and recycling a specific item runs into any issues, the mod will print a message
## in the center of the screen (native Valheim notification). At the time of implementation,
## this happens in the following cases:
##  - not enough free slots in the inventory to place the resulting resources
##  - player does not know the recipe for the item
##  - if enabled, cases when `PreventZeroResourceYields` kicks in and prevent the crafting
# Setting type: Boolean
# Default value: true
NotifyOnSalvagingImpediments = true

[zDebug]

## If enabled will dump a complete detailed recycling report every time. This is taxing in terms
## of performance and should only be used when debugging issues. 
# Setting type: Boolean
# Default value: false
DebugAlwaysDumpAnalysisContext = false

Changelog

0.0.9

• fixed null reference exceptions when plugin starts up (missed due to plugin being loaded before as a script)

0.0.8

• added new experimental UI that addds a new tab to the crafting station. Enabled by default.
• container recycle button no longer enabled by default

0.0.7

• fixed a bug where recycling an upgraded item with a rate of 1 that used additional resources than the initial recipe (per level rather than initially), would still return that ingredient back
• fixed some config naming consistency

0.0.6

• introduced the option to prevent recycling if item yield after recycling is 0. On by default
• added notifications for when the mod cannot (or decides not to) recycle. On by default

0.0.5

• fixed a bug when uncrafting a single stacked item would yield returns for the whole stack

0.0.4

• (!) Added "RecyclingRate" setting

  This sets the rate at which the items are recycled. The mod used to return 100% of the resources, but now the rate is 50% by default.

• added a setting that when enabled, will prevent recycling 0 resources on unstackable items

• button position is now movable by pressing left ctrl and dragging it with right click. Persists on reload

• refactored code in preparation for containerless recycling

0.0.3

• now searches all recipes
• calculates the amount of resources based on quality level
• will not recycle if not enough slots are available

0.0.2

• Fix a null reference exception in main game menu

0.0.1

Initial release