SmarterContainers
Want to quickly drop your loot? Tired of looking for chest with a specific item-stack in order to store some more of it? Teach your containers to arrange items with their neighbors!
Last updated | a year ago |
Total downloads | 66456 |
Total rating | 8 |
Categories | Mods Tweaks Client-side |
Dependency string | Roses-SmarterContainers-1.7.0 |
Dependants | 276 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202README
Smarter Containers
This is a upload from the Nexus to get a new version. I take no credit in their work. Below is the README from Nexus.
Features
Teaches your containers to automatically send items you put in them to other containers if they are already containing this item-stack. Puts same-kinded items to their siblings; copper-ore goes to chest containing tin-ore and so on. You can create such item-groups from any items combination - just put your carrots, stones and feathers in one box, click the button and from now on your carrots will go to chest with feathers. Configure mod to load-out all specific loot-items from your inventory to a proper chests via a single button click.
How it works
When you put an item stack to a container via [Ctrl + Click]
, if container is full or doesn't contain same items:
- Check each nearby container and if it is not full and has same item (stack) - your item is routed there.
- Otherwise if none found, check each nearby container and if it is not full and has "relevant" group items - your items are routed there.
In other words: If group contains your item and chest contains any other item from a group, then your item will go to this chest.
General Configuration parameters
- range - defines area to locate "nearby" containers
- onlyStackableItems - (enabled by default) when enabled - non stackable items (tools, weapons, armor) are NOT rearranged
- hudMessageEnabled - (enabled by default) Enables hud message indicating that item was placed to some other chest.
- hudMessageText - HUD message consists of Icon, item-name plus this hudMessageText
- audioFeedbackEnabled - play ingame-sound if items are successfully distributed
- effectFeedbackEnabled - display a temporary visual effect over chests where your items were distributed
Grouping items
There are three available options to define an item-group:
- by explicitly listing all item-names of group-members
- by matching item-name prefixes: trophyboar and trophytroll are members of group with 'trophy' prefix
- by matching item-name postfixes: carrotSeeds and turnipSeeds are members of group with 'seeds' postfix
- by matching in-game
item-type
: Tool, Weapon, Ammo, Armor, Trophie
Grouping Configuration parameters
- enabled - (true by default) enables item groups logic
- itemTypeGroupsEnabled - enables grouping by item-types (Trophie, Tool, Ammo, Armor, Weapon).
- groupingKeyModifier - LeftControl. Change to "LeftControl + LeftShift" if you want separate hotkey for triggering grouping logic. (holding ctrl is mandatory since it's a "move-stack" ingame key)
- createGroupBtnEnabled - (true by default) adds a UI button which helps to create custom item-groups
- createGroupBtnPos - adjusts button position
- fuzzyGroupingEnabled - (false by default) enable grouping by more broad criteria.
Preconfigured item groups
[ItemGroup]
config section contains a set of item-names based groups:
valuables = ruby,coins,amber,amberpearl
ore = copperore,flametalore,ironore,silverore,tinore,ironscrap,blackmetalscrap
rock = stone,flint,obsidian
ingots = copper,bronze,flametal,iron,silver,tin,blackmetal
wood = wood,finewood,corewood,ancientbark
mushrooms = Mushroom,MushroomBlue,MushroomYellow
berries = Blueberries,Cloudberry,Raspberry,Honey
vegetables = Carrot,Turnip
cookedMeat = CookedLoxMeat,NeckTailGrilled,MeatCooked,FishCooked,SerpentMeatCooked
food = CarrotSoup,Sausages,QueensJam,SerpentStew,TurnipStew,BloodPudding
Preconfigured groups matching item-names by postfixes or prefixes
[PostfixedItemGroups] posfixes = cone,seeds,pelt,hide # i.e. CarrotSeeds will go to TurnipSeeds
[PrefixedItemGroups] prefixes = trophy,mead,arrow,armor,cape,helmet,atgeir,bow,battleaxe,knife,mace,shield,sledge,spear,sword,tankard # i.e. ArrowFire will go to ArrowFlint
How it works: When you put an item stack to container via [Ctrl + Click]
if simple container lookup by same-item-name described above has no results then: check each nearby container and if both container and your item are
- members of same item-names based group (either preconfigured or user-created group form [ItemGroup] config section) - or members of same item-names-prefix based group - or members of same item-names-postfix based group - then item is routed there.
if none matched - check each nearby container and if container has any item with
item-type
same as your items type then item is routed there (could be disabled withitemTypeGroupsEnabled
config option) if none of the above matched andfuzzyGroupingEnabled
option enabled - additionalitem-types
based groups are checked: IsMaterial, IsConsumable, IsCustomization, IsMisc
Adding custom item groups
Put desired items set to a chest, click the [☼] button (at the bottom-left corner of chest panel). New group will contain all unique item-names from this chest.
Merging or extending item groups
When you click the [☼] button mod will check if items in current chest are already members of some item-names based group. In such case - a prompt dialog will appear with options:
- to continue with creating new group anyway
- to merge all detected groups into a single (largest group will be used as a "base" group)
Disabling preconfigured groups
You can disable any preconfigured group
- In config file: by deleting part after '=' symbol. Example: "vegetables ="
- From ConfigurationManager UI: by setting value to empty string
ⓘ You can manually verify, merge or add new groups to [ItemGroup] config section.
Example: "fishes = FishRaw,FishCooked". (requires game-restart) Item-names could be discovered:
- By googling some "valheim Spawn items list".
- By pressing "Ctrl + L + click" (instead of Ctrl + click) while moving item to chest: item-name will be printed to console (F5).
Unloading items
Configure item-groups & names which should be allowed for 'unloading'. Open any chest and click the [⇓⇓] button.
'Unloading' Configuration parameters
enabled - (true by default) enables unloading logic & UI button
btnPos - adjust button position
groupsList - List of items group-ids from [ItemGroup] config section allowed to be "unloaded"
itemsList - List of item-names allowed to be "unloaded"
itemsSkipList - High-priority list of item-names to exclude from being "unloaded"
alwaysGrouping - (true by default) - grouping logic is always on for uloading. Otherwise - pressing of groupingKeyModifier required.
addToItemsFilterKeyModifier - If pressed - overrides createGroupBtn behaviour by passing item-names to unload "itemsList" instead of creating new items group
addToSkipItemsFilterKeyModifier - If pressed - overrides createGroupBtn behaviour by passing item-names to unload "itemsSkipList" instead of creating new items group
materialsFiltering - always allow "materials" item type to be "unloaded"
trophiesFiltering - always allow trophies to be "unloaded"
consumableFiltering - (disabled by default) always allow any consubable item to be "unloaded"
How it works
Checks each non-equipped item in your inventory and:
- if item is NOT in
itemsSkipList
config option
- if item matches any group from
groupsList
config option - or item-name is listed in
itemsList
config option - or item-type is
Materials
andmaterialsFiltering
config option enabled - or item-type is
Trophy
andtrophiesFiltering
config option enabled - or item-type is
Consumable
andconsumableFiltering
config option enabled
- try to move item to nearby 'relevant' chest
Configuring from game UI
[Shift + click]
[☼] button: allow all items in currently opened chest to be unloaded by adding their names toitemsList
config option.[Ctrl + click]
[☼] button: disable all items in currently opened chest to be unloaded by adding their names toitemsSkipList
config option.
Controller support
- set [Grouping] groupingKeyModifier to JoystickButton0 value: RTrigger+A will always use grouping. Alternatively - set it to JoystickButton6 (map button)
- RightStick click : trigger Create group ([☼]) while at containers-panel .
- RightStick click + RTrigger : same as addToItemsFilterKey.
- RightStick click + LTrigger : same as addToSkipItemsFilterKey.
- menuButton (☰) : triggers Unload-all-items button ([⇓⇓]) while at containers-panel.
- merge-or-create dialog: LeftBumper= Merge, RightBumper=Create
- I've tried to mimic games tooltips but they overlap with buttons a bit now. Set [Unload] btnPos = {"x":1.5,"y":7.9}
- from 1.6.0 version merge-prompt dialog is not fully supported :!
Configuring mod
- Recommended: enable in-game console (opened by F5) by adding
-console
launch option. - Recommended: install latest BepInEx.ConfigurationManager
- Start the game. Adjust config via ConfigurationManager while playing game (press F1 while in menu or at inventory UI)
- From a config file at
Valheim\BepInEx\config\flueno.SmartContainers.cfg
. Requires game restart.