home
Valheim
Terms of Service | Privacy Policy
Copyright © 2024 Robin Scott. All rights reserved.
0 of 0

File information

Last updated

Original upload

Created by

Azumatt

Uploaded by

Azumatt

Virus scan

Safe to use

Tags for this mod

Tag this mod
Current section

About this mod

A mod that allows you to recycle items back into resources used to make them. Adds a 'Reclaim' tab/button to the crafting menu. Additionally can be used inside of your inventory directly. Fully compatible with Jewelcrafting and EpicLoot.

Requirements
Permissions and credits
Mirrors
Changelogs
Donations

Description




A mod that allows you to recycle/reclaim items back into resources used to make them. Adds a 'Reclaim' tab/button to the crafting menu. Additionally can be used inside of your inventory directly.

Version checks with itself. If installed on the server, it will kick clients who do not have it installed.

This mod uses ServerSync, if installed on the server and all clients, it will sync all configs to client

This mod uses a file watcher. If the configuration file is not changed with BepInEx Configuration manager, but changed in the file directly on the server, upon file save, it will sync the changes to all clients.


Compatible with:

  • VNEI
  • Jewelcrafting (never worry about losing your gems again!)
  • EpicLoot (never worry about losing your enchanted items again!)
  • AzuExtendedPlayerInventory
  • Auga
---

Original Author's Credits

All original code for the crafting tab/button was written by ABearCodes
Original Mod Link: Simple Recycling


Mod Information

This mod is a combination of OdinsInventoryDiscard and the mod above. The aim is to provide an all-in-one solution for recycling items back into resources.

All code changes after the initial release of this mod was written by me. This includes the merging of the two mods, addition of ServerSync and any improvements made to the code.

Installation Instructions

You must have BepInEx installed correctly! I can not stress this enough.


Manual Installation

Note: (Manual installation is likely how you have to do this on a server, make sure BepInEx is installed on the server correctly)

  • Download the latest release of BepInEx.
  • Extract the contents of the zip file to your game's root folder.
  • Download the latest release of Recycle_N_Reclaim from Thunderstore.io.
  • Extract the contents of the zip file to the BepInEx/plugins
    folder.
  • Launch the game.



Configuration Options (Azumatt.Recycle_N_Reclaim.cfg)


Please note that Inventory Recycle and Reclaiming are different sections as well as different functionality within the game. Recycling happens only in the inventory and (by default) limited to admins only. Change the config should you wish to give this ability to everyone. Admins will always (by default) get 100% of the resources returned to them. Reclaiming happens in the crafting menu and is available to everyone. The amount of resources returned is configurable but is 50% by default.


What this looks like in the BepInEx Configuration Manager




1 - General

Lock Configuration [Synced with Server]

  • If on, the configuration is locked and can be changed by server admins only.
    • Default Value: On

2 - Inventory Recycle
Enabled [Synced with Server]

  • If on, you'll be able to discard things inside of the player inventory.
    • Default Value: On

Lock to Admin [Synced with Server]
  • If on, only admin's can use this feature.
    • Default Value: On

DiscardHotkey(s) [Not Synced with Server]
  • The hotkey to discard an item or regain resources. Must be enabled
    • Default Value: Delete

ReturnUnknownResources [Synced with Server]
  • If on, discarding an item in the inventory will return resources if recipe is unknown
    • Default Value: Off

ReturnEnchantedResources [Synced with Server]
  • If on and Epic Loot or Jewelcrafting is installed, discarding an item in the inventory will return resources for Epic
    Loot enchantments or Jewelcrafting gems
    • Default Value: On
ReturnResources [Synced with Server]

  • Fraction of resources to return (0.0 - 1.0). This setting is forced to be between 0 and 1. Any higher or lower values
    will be set to 0 or 1 respectively.
    • Default Value: 1
3 - Reclaiming

RecyclingRate [Synced with Server]

  • 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. If the recycling rateis 0.5 (50%), the player will receive half of the resources they would usually need to craft the item, assuming asingle item in a stack and the item is of quality level 1. If the item is of higher quality, the resulting yield wouldbe higher as well.
    • Default Value: 0.5
ReturnEnchantedResources [Synced with Server]

  • If on and Epic Loot or Jewelcrafting is installed, discarding an item in the inventory will return resources for Epic
    Loot enchantments or Jewelcrafting gems
    • Default Value: On
UnstackableItemsAlwaysReturnAtLeastOneResource [Synced with Server]

  • If enabled and recycling a specific unstackable item would yield 0 of a material,
    instead you will receive 1. If disabled, you get nothing.
    • Default Value: On
RequireExactCraftingStationForRecycling [Synced with Server]

  • If enabled, recycling will also check for the required crafting station type and level.
    If disabled, will ignore all crafting station requirements altogether.Enabled by default, to keep things close to how Valheim operates.
    • Default Value: On
PreventZeroResourceYields [Synced with Server]

  • If enabled and recycling an item that would yield 0 of any material,
    instead you will receive 1. If disabled, you get nothing.
    • Default Value: On
AllowRecyclingUnknownRecipes [Synced with Server]

  • 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.
    • Default Value: Off
4 - UI

ContainerButtonPosition [Synced with Server]

  • The last saved recycling button position stored in JSON
    • Default Value: {"x":496.0,"y":-374.0,"z":-1.0}

ContainerRecyclingEnabled [Synced with Server]
  • If enabled, the mod will display the container recycling button
    • Default Value: On

NotifyOnSalvagingImpediments [Synced with Server]
  • 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
    • Default Value: On

EnableExperimentalCraftingTabUI [Synced with Server]
  • If enabled, will display the experimental work in progress crafting tab UI
    Enabled by default.
    • Default Value: On
HideRecipesForEquippedItems [Synced with Server]

  • If enabled, it will hide equipped items in the crafting tab.
    This does not make the item recyclable and only influences whether or not it's shown.Enabled by default.
    • Default Value: On
IgnoreItemsOnHotbar [Synced with Server]

  • If enabled, it will hide hotbar items in the crafting tab.
    Enabled by default.
    • Default Value: On
StationFilterEnabled [Synced with Server]

  • If enabled, will filter all recycling recipes based on the crafting station
    used to produce said item. Main purpose of this is to prevent showing foodas a recyclable item, but can be extended further if needed.Enabled by default
    • Default Value: On
StationFilterList [Synced with Server]

  • Comma separated list of crafting stations (by their "prefab name")
    recipes from which should be ignored in regards to recycling.Main purpose of this is to prevent showing food as a recyclable item,but can be extended further if needed.

Full list of stations used in recipes as of 0.216.9:

  • identifier: forge in game name: Forge
  • identifier: blackforge in game name: Black Forge
  • identifier: piece_workbench in game name: Workbench
  • identifier: piece_cauldron in game name: Cauldron
  • identifier: piece_stonecutter in game name: Stonecutter
  • identifier: piece_artisanstation in game name: Artisan table
  • identifier: piece_magetable in game name: Galdr table
    • Default Value: piece_cauldron
zDebug

DebugAlwaysDumpAnalysisContext [Synced with Server]

  • 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.
    • Default Value: Off
DebugAllowSpammyLogs [Synced with Server]

  • If enabled, will spam recycling checks to the console.
    VERY. VERY. SPAMMY. Influences performance.
    • Default Value: Off




Example YAML (Azumatt.Recycle_N_Reclaim_ExcludeLists.yml)

# Below you can find example groups. Groups are used to exclude or includeOverride quickly. They are reusable lists!
# Please note that some of these groups & limitations are kinda pointless but are here for example.
# Make sure to follow the format of the example below. If you have any questions, please ask in my discord.

# Full vanilla prefab name list: https://valheim-modding.github.io/Jotunn/data/prefabs/prefab-list.html
# Item prefab name list: https://valheim-modding.github.io/Jotunn/data/objects/item-list.html

# There are several predefined groups set up for you that are not listed. You can use these just like you would any group you create yourself.
# These are the "All", "Food", "Potion", "Fish", "Swords", "Bows", "Crossbows", "Axes", "Clubs", "Knives", "Pickaxes", "Polearms", "Spears", "Equipment",
# "Boss Trophy", "Trophy", "Crops", "Seeds", "Ores", "Metals", "Woods", "Armor", "Helmets", "Ammunition", "Utilities", "Tools", "Miscellaneous", and "Customizations" groups.
# The criteria for these groups are as follows:
# groups:
#Food:
# - Criteria: Both of the following properties must have a value greater than 0.0 on the sharedData property of the ItemDrop script:
#- food
#- foodStamina
#Potion:
# - Criteria: The following properties must meet the specified conditions on the sharedData property of the ItemDrop script:
#- food > 0.0
#- foodStamina == 0.0
#Fish:
# - itemType: Fish
#Swords, Bows, Crossbows, Axes, Clubs, Knives, Pickaxes, Polearms, Spears:
# - itemType: OneHandedWeapon, TwoHandedWeapon, TwoHandedWeaponLeft, Bow
# - Criteria: Items in these groups have a specific skillType on the sharedData property of the ItemDrop script. Each group corresponds to the skillType as follows:
#- Swords: skillType == Skills.SkillType.Swords
#- Bows: skillType == Skills.SkillType.Bows
#- Crossbows: skillType == Skills.SkillType.Crossbows
#- Axes: skillType == Skills.SkillType.Axes
#- Clubs: skillType == Skills.SkillType.Clubs
#- Knives: skillType == Skills.SkillType.Knives
#- Pickaxes: skillType == Skills.SkillType.Pickaxes
#- Polearms: skillType == Skills.SkillType.Polearms
#- Spears: skillType == Skills.SkillType.Spears
#Example:An item with itemType set to OneHandedWeapon and skillType set to Skills.SkillType.Swords would belong to the Swords group.
#Equipment:
# - itemType: Torch
#Boss Trophy:
# - itemType: Trophie
# - Criteria: sharedData.m_name ends with any of the following boss names:
#- eikthyr, elder, bonemass, dragonqueen, goblinking, SeekerQueen
#Trophy:
# - itemType: Trophy
# - Criteria: sharedData.m_name does not end with any boss names
#Crops:
# - itemType: Material
# - Criteria: Can be cultivated and grown into a pickable object with an amount greater than 1
#Seeds:
# - itemType: Material
# - Criteria: Can be cultivated and grown into a pickable object with an amount equal to 1
#Ores:
# - itemType: Material
# - Criteria: Can be processed by any of the following smelters:
#- smelter
#- blastfurnace
#Metals:
# - itemType: Material
# - Criteria: Is the result of processing an ore in any of the following smelters:
#- smelter
#- blastfurnace
#Woods:
# - itemType: Material
# - Criteria: Can be processed by the charcoal_kiln smelter
#Armor:
# - itemType: Chest, Shoulder, Legs, Hands
#Helmets:
# - itemType: Helmet
#Ammunition:
# - itemType: Ammo, AmmoNonEquipable
#Utilities:
# - itemType: Utility
#Tools:
# - itemType: Tool
#Miscellaneous:
# - itemType: Misc
#Customizations:
# - itemType: Customization
#All:
# - Criteria: Item has an ItemDrop script and all needed fields are populated. (all items)




groups:
Example Group: # Group name
- APrefabName # Item prefab name, note that this is case sensitive and must be the prefab name
Another Custom Group: # Group name
- APrefabName # Item prefab name, note that this is case sensitive and must be the prefab name
- AnotherPrefabName
- YetAnotherPrefabName
Tier 2 Items: # Group name
- Bronze # Item prefab name, note that this is case sensitive and must be the prefab name
- PickaxeBronze
- ArmorBronzeChest
- ArmorBronzeLeggings


# Inventory section determines which items can be recycled. Remember that recycling from inventory is defaulted to only admins.
inventory:
exclude: # Exclude these items from being recycled
- Metals # Exclude all items in the "Metals" group from being recycled in inventory
includeOverride:
- Metals # Override the setting above, allowing "Metals" group to be recycled in inventory

# Reclaiming section determines which items can be reclaimed via Containers or the Reclaim tab.
reclaiming:
exclude:
- Metals # Exclude all items in the "Metals" group from being reclaimed
- Armor # Exclude all items in the "Armor" group from being reclaimed
- Helmets # Exclude all items in the "Helmets" group from being reclaimed
- Hammer # Exclude this specific item from being reclaimed
includeOverride:
- All # Allow all items to be reclaimed, overrides the exclude rules above for "reclaiming" section

# Containers section determines the rules for specific containers. It follows the limitations of the "reclaiming" section to determine what is actually reclaimed.
# This section is primarily used for managing the items included or excluded from the "Reclaim All" functionality of containers, allowing you to prevent certain items
# from being a part of the reclaim logic.
containers:
piece_chest: # Container prefab name, note that this is case sensitive and must be the prefab name
exclude:
- Food # Exclude or "skip" all items in the "Food" group from this container. Food will not be deconstructed back into its ingredients.
- PickaxeBronze # Exclude or "skip" this specific item from this container. Excluding it from being reclaimed will prevent it from being deconstructed back into its ingredients.
includeOverride:
- Foods # Override
- PickaxeBronze # Allow this specific item to be included in the reclaiming process. Overrides the exclude rules above.
- All # Just here for cleaning up the example, allowing default behavior

piece_chest_wood:
exclude:
- Swords # Exclude all items in the "Swords" group from this container
- Tier 2 Items # Exclude all items in the "Tier 2 Items" group from this container
- Bows # Exclude all items in the "Bows" group from this container
includeOverride:
- BowFineWood # Allow this specific item to be included in this container
- Wood # Allow this specific item to be included in this container
- Bronze # Allow this specific item to be included in this container
- All # Just here for cleaning up the example, allowing default behavior

piece_chest_private:
exclude:
- All # Exclude all items from this container
includeOverride:
- All # Just here for cleaning up the example, allowing default behavior

piece_chest_blackmetal:
exclude:
- Swords # Exclude all items in the "Swords" group from this container
- Tier 2 Items # Exclude all items in the "Tier 2 Items" group from this container
- Bows # Exclude all items in the "Bows" group from this container
includeOverride:
- BowFineWood # Allow this specific item to be included in this container
- Wood
- Bronze
- All # Just here for cleaning up the example, allowing default behavior











Feel free to reach out to me on discord if you need manual download assistance.


Author Information


Azumatt

DISCORD: Azumatt#2625

STEAM: https://steamcommunity.com/id/azumatt/

For Questions or Comments, find me in the Odin Plus Team Discord or in mine: