ZenDistributor

v1.3.0·Updated 2026-09-13

Unload cargo from ships and carts. Put items into nearby chests. Improved cart handling and ease of use.

Screenshots 1 screenshots

About this mod Author’s original text

ZenDistributor

Distribute the contents of your cart or ship into nearby chests with visual feedback.

Features:

  • Unload your cart into nearby chests.
  • Unload your ship into nearby chests or carts.
  • Visual feedback to see where your items went.

Improved Cart Handling:

  • Ignore upside down: Can attach even if it's upside down.
  • Increased attach distance: Makes carts easier to connect.
  • Quickly detach by attacking, crouching, or doing other common actions.

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 trivialized gameplay leading to a loss of immersion from excessive automation. This mod rewards the player for using carts and makes distribution a deterministic process.

Additionally, you can use the Distributor to move items directly from your ship into a nearby cart or chest on the shore.

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

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

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.
  • ZenPath No stamina use on paved roads, half stamina use on dirt paths.

Known Issues

Some mods apply slot favorites that prevent stacking from certain slots. Sometimes these mods do not check that the slot they are protecting is inside the player's inventory. In those cases they will cause ZenDistributor to fail to distribute protected slots. If you are experiencing this issue, please disable the slot favorite features in conflicting mods and talk to the mod author about validating the favorites. They need to make sure the slot is in the player's inventory, not just a general X/Y position on any container's inventory.

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:

  • Dedicated server admins can put the mod on the server to enforce all clients to have the mod installed and sync admin configs.
  • 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 v1.2.1

Plugin GUID: ZenDragon.ZenDistributor

[Cart]

[Admin] Attach the cart to the player much more easily. (Vanilla: false)

Setting type: Boolean

Defaul

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

ZenDragon-Zen_ModLib

File & checksum

Filename
ZenDistributor-1.3.0.zip
File size
30.1 KiB