Moder Warehouse 1.1.0

Moder Warehouse is a free, unofficial, server-only warehouse automation mod for Valheim. Players connect with unchanged vanilla clients. The server sorts an input chest, fulfils withdrawal requests, tracks target stock and displays totals on an interactive rotating 4×4 board.

Author: Cris Haani
License: MIT
Status: first public release candidate

Moder Warehouse is not affiliated with or endorsed by Iron Gate Studio or Coffee Stain Publishing. Use it at your own risk and back up the world before installing or updating it.

Requirements

Install on the dedicated server only:

1. BepInExPack for Valheim 5
2. ServersideQoL 2.0.10 or a confirmed compatible later version
3. Moder Warehouse

BepInEx and ServersideQoL are separate dependencies and are not included. Clients do not need to install this mod.

Installation

1. Stop the server and create a tested world backup.
2. Install BepInEx and ServersideQoL from their official project pages.
3. Copy ModerWarehouse.dll to BepInEx/plugins/ModerWarehouse/ModerWarehouse.dll.
4. Start the server.
5. Confirm Loading [Moder Warehouse 1.1.0] and the initialization message in the BepInEx log.

Quick start

Choose a warehouse id such as main. Place ordinary signs no more than three metres from their intended chests:

Sign text	Purpose
[WH:main:IN]	input chest, warehouse centre and optional language selector
[WH:main:OUT]	output chest
[WH:main:REQ]	request and target-stock sign
[WH:main:INFO]	live container-capacity sign
[WH:main:BOARD]	bottom-left anchor of the automatic 4×4 board
[WH:IGNORE]	exclude the nearest container
[WH:DELETE]	remove a generated warehouse sign
[WH:CLEAN]	clean overlapping generated signs at one position

All suitable ordinary containers within 100 metres of the input chest are managed by default. Private, open, in-use, cart and unsuitable auto-destroy containers are not used. Items stay safely in the input chest when no destination has capacity.

Languages

English and German are maintained built-in languages. Set the server-wide default in ch.cris.valheim.moderwarehouse.cfg:

[Localization]
Language = English

Use English, German, en or de. A warehouse can override the server default by adding a second line to its IN sign:

[WH:main:IN]
LANG=DE

Changing LANG= updates the board, help, capacity, request, delivery and automatic chest-label text on the next scans. Physical signs are shared world objects, so one warehouse shows one language to every player. Manually written signs are deliberately never translated or rewritten.

Additional interface languages can be installed as JSON data files. See docs/TRANSLATING.md. Missing entries fall back to English. English and German item names are accepted for searches regardless of display language.

Input and automatic labels

Put unsorted items into the IN chest. Existing matching stacks are filled before empty slots are used.

To prepare a destination explicitly, place one item type into an otherwise unlabeled storage chest. Once the chest contains only that item type, Moder Warehouse recognises it as a destination for matching items. If AutoCreateLabels is enabled, it also gets a persistent white label after AutoLabelDelay (90 seconds by default).

For exact sign placement, attach and orient an ordinary vanilla sign yourself and set its complete text to .... Moder Warehouse reuses that sign instead of creating one. The first automatic assignment records the underlying Valheim item token. From then on, the label follows LANG=/Language, even while the chest is empty. Do not use ... on a sign that should remain manually controlled.

Existing non-empty manual labels still reserve and route their nearest chest, but their text is never translated. Older automatic signs are migrated only when the mod can identify them safely; if an old label does not switch language, clear its text to ... once and let Moder Warehouse adopt it.

Requests

Initialize a request sign once with [WH:main:REQ]. Its warehouse association is stored persistently, after which the sign accepts requests such as:

Wood 100
Stone 10, Wood 20, Resin 5

German names, English names and internal prefab names are supported. Each comma- separated request receives its own result. Available items are delivered even if another requested item is missing. Results remain visible for 30 seconds by default. Keep the OUT chest closed while the server performs a request. The saved target-stock list returns after the result display time and never overwrites a fresh command.

Target stock

Store a persistent shopping list on the initialized REQ sign:

SOLL Wood 1000, Stone 500, Resin 100

Red means missing or critically low, orange means below target and green means the target has been met. Normal withdrawal requests remain available at any time.

INFO sign

[WH:main:INFO] shows free unlabeled chests, empty reserved/labeled chests and occupied chests versus total managed capacity. The warehouse association persists after the first successful initialization.

Interactive 4×4 stock board

Place [WH:main:BOARD] as the bottom-left cell and leave space to its right and above. The server creates fifteen additional vanilla signs. The sign's written face defines the board front; the board grows right and upward.

The top row shows warehouse, filter, page and container occupancy. Twelve alphabetical item totals are shown below it. Pages rotate every seven seconds.

• Edit BESTAND with a prefix such as G to filter and freeze the list.
• Edit SEITE with a page number to hold that page.
• Use both controls together when required.
• Enter AUTO or clear the control to resume rotation immediately.
• Automatic rotation resumes after 60 seconds without another filter change.

The board wakes while a player is within five metres. Otherwise it displays a large sleep message and stops rotating. On waking it briefly shows stock changes since the last visit. After input sorting it shows an EINGELAGERT delivery confirmation.

Container occupancy is green below 80 percent, orange from 80 percent, and red with an expansion warning from 95 percent.

Expanding and running multiple warehouses

Build more suitable chests within the configured radius; capacity updates on the next scan. Use another id for an independent site, for example [WH:harbour:IN] and [WH:harbour:OUT].

Configuration defaults

Setting	Default	Meaning
Enabled	true	enable warehouse processing
Language	English	default interface and automatic-label language
Radius	100	storage radius around the IN chest
MarkerDistance	3	maximum sign-to-chest distance
ScanInterval	3	seconds between scans
MaxMovesPerCycle	250	safety limit for stack movements
AutoCreateLabels	true	create automatic chest labels
AutoLabelDelay	90	seconds before automatic labeling
ResultDisplaySeconds	30	request-result display time
BoardPageSeconds	7	stock-board page duration
BoardWakeDistance	5	stock-board wake distance
DeliveryNoticeSeconds	6	delivery-message duration
VisitSummarySeconds	12	visit-difference duration
CapacityWarningPercent	80	orange capacity threshold
CapacityCriticalPercent	95	red capacity threshold

Test configuration changes on a world copy. Very short scan intervals and very large radii may increase server load.

Troubleshooting

• Plugin does not load: verify BepInEx and ServersideQoL, remove duplicate DLLs, and check the log for Loading [Moder Warehouse 1.1.0].
• IN or OUT is not detected: verify exact spelling, matching warehouse id and a sign-to-chest distance below three metres.
• Items remain in IN: check capacity, matching stacks, private/open containers and nearby [WH:IGNORE] signs.
• Request fails: use Item amount, separate entries with commas, and keep enough free space in OUT.
• Automatic label stays in the old language: only mod-managed labels are rewritten. Manual signs stay untouched. Replace an old automatic label's text with ... once to let the mod adopt it safely.
• Board grows incorrectly: the anchor is the bottom-left cell; clear the space to the right and above, remove it with [WH:DELETE] or [WH:CLEAN], then rebuild once.

Updating, rollback and removal

Stop the server and back up both the world and old DLL before every update. After an update, verify the log and test one small deposit and withdrawal. For rollback, restore the matching world backup and previous DLL together.

Before removal, optionally delete generated boards and signs with [WH:DELETE]. Then stop the server, back up the world and remove ModerWarehouse.dll. Chests and their contents are vanilla world objects; generated signs may remain as ordinary signs.

Privacy, support and license

Moder Warehouse contains no telemetry, analytics, advertising or intentional external network communication. Remove passwords, IP addresses and platform identifiers before sharing logs.

Reports should include the Valheim, BepInEx, ServersideQoL and Moder Warehouse versions, server operating system, reproduction steps and a privacy-cleaned log excerpt.

The source code is available under the MIT License. Use, modification and redistribution are allowed while retaining the copyright and license notice. The software is supplied without warranty and is used entirely at your own risk.