ZenDistributor

Distribute the contents of your Cart into nearby chests with visual feedback.

• Unload your cart's cargo into nearby chests.
• Visual feedback to see where your items went.
• Does not distribute the player's inventory.

Best When Combined With...

• ZenHoverItem Easily view the content of containers and other objects in the world.
• ZenSign See the amount of each item you have in your hoard.
• ZenWorldSettings Makes using and handling the cart much easier.
• ZenPath No stamina use on paved roads, half stamina use on dirt paths.

The idea behind this mod is to make unloading your cargo easier. There are other mods that allow you to unload your player inventory directly. However, I felt that was over optimized and detracted from the need to use the cart and over simplified gameplay leading to a loss of immersion.

This mod aims to create a balance where immersion is not lost from full automation yet still allows for quickly unloading your cart in one button press.

If you want to automatically distribute your character's inventory into the nearby chests, that is not the purpose of this mod. Instead, you put the items you want to distribute into a Cart and use the cart to distribute them. This manual selection is important for preserving the atmosphere and tone of the game's experience and encourages the player to use Carts for hauling large quantities of items.

Client / Server Requirements

NOTE: Technically it is not required on the server. However, if it is installed on the server then it will force all clients to have it installed as well. This is to enable two modes of usage:

1. Dedicated server admins can put the mod on the server to enforce all clients to have the mod installed and sync admin configs.
2. Trusted friends can agree to run the same mods and connect through a vanilla dedicated server with no enforcement but with locked admin configs.

Client Only

This mod operates entirely client side. That means you can connect to any vanilla server with this mod installed. Other players do not need to have the mod installed.

NOTE: If you host a game session with this mod installed then it will be considered to be installed on the server since your session is the server. Therefor, all clients will be required to have it. If you don't want to require all players to have this mod then you will need to host your game in a dedicated server. You can easily download and run the Valheim Dedicated Server from Steam or host one in the cloud.

Extend Functionality with Additional ZenMods

• ZenHoverItem: Peek into chests and everything else with quick visual feedback.
• ZenSign: Organize your hoard, view the amount of every item in your warehouse and quickly find it.
• ZenRedecorate: Move chests and other things around without destroying them.
• ZenItemStand: Item Stands and Armor Stands behave like containers. Quickly swap your gear.

Improve Your Experience

CORE MODS

The full collection of all Zen MODS:

• Radically improved QoL
• Incredible performance
• Pre-configured
• 100% Gamepad support
• Spectacularly immersive

Enjoy!

Sample Config File

## Settings file was created by plugin ZenDistributor v0.1.0
## Plugin GUID: ZenDragon.ZenDistributor

[General]

## [Admin] Only distribute to these container prefab names. They must have a Container component or they will not work.
# Setting type: StringList
# Default value: piece_chest_wood, piece_chest, piece_chest_blackmetal, piece_chest_barrel
Allowed Container Prefabs = piece_chest_wood, piece_chest, piece_chest_blackmetal, piece_chest_barrel

## [Admin] How far away to search for containers from the cart's location
# Setting type: Single
# Default value: 10
# Acceptable value range: From 3 to 20
Max Distribution Range = 10

## [Admin] Highlight color for chests that had items distributed into them
# Setting type: Color
# Default value: 00FFFFFF
Higlight Color = 00FFFFFF

## [Admin] Highlight duration for chests that had items distributed into them (in seconds)
# Setting type: Single
# Default value: 5
# Acceptable value range: From 3 to 30
Higlight Duration = 5

Like My Mods? Donations Welcome

Bitcoin

v0.1.7

• add a "Known Issues" section to the readme. no code changes.

v0.1.6

• small change to work better with MultiUserChest

v0.1.5

• fix ZDO ownership issues in multiplayer games.

v0.1.4

• update readme, no code changes.
• update Zen.ModLib dependency to v1.1.24

v0.1.3

• disable distribution processing if no allowed containers are defined in the configs. (provides an easy way to disable the distribution mechanism while still retaining cart QoL handling improvements)
• check for warded containers before distribution.

v0.1.2

• updated readme and description, no code changes.

v0.1.1

• moved cart handling code from ZenWorldSettings into this mod.

v0.1.0

• Initial release