World Cleaner

Leave the loot. Keep the resources.

Mark a container and let World Cleaner magically suck up dropped items from your world. Turn on the built-in AutoPicker to pop nearby pickables as you travel, and let your cleaner handle eligible dropped loot while you keep exploring.

Great for Vikings who need resources but never seem to have enough inventory space to carry them home.

Obviously cheaty! This mod is for players who want less hauling, less clicking, and more resources waiting back at base.

By ArcByte Software · Plugin version 0.31.0

Features

• Marked cleaner containers: Turn an accessible chest into a collection anchor.
• Dropped-item collection: Discover and process dropped items in the background, with configurable collection rules and performance budgets.
• Built-in AutoPicker: Automatically interact with nearby resources, stones, branches, flowers, and crops as you move.
• Nearby chest delivery: Route collected resources into eligible storage near your cleaner.
• Virtual overflow storage: Keep overflow in a persistent archive with search, filters, sorting, and stack withdrawals.
• Inventory deposits: Deposit inventory into virtual storage while keeping hotbar and equipped items.
• Optional crop replanting: Replant supported cultivated seed crops when you carry the matching seeds.
• Optional natural-container looting: Enable automatic Take All for eligible wild treasure containers.

Installation

Mod manager

Install WorldCleaner with Thunderstore Mod Manager or r2modman. The required BepInExPack Valheim dependency installs automatically. Launch the game through the mod manager.

Manual

1. Install BepInExPack Valheim.
2. Copy BepInEx/plugins/WorldCleaner/WorldCleaner.dll from this package into the same path inside your Valheim installation.
3. Launch Valheim once to generate the configuration file.

For multiplayer collection and shared storage, install the mod on the server/host and participating clients. Server policy controls access to cleaner marking, AutoPicker, wild-container looting, and replanting.

Quick start

1. Place a chest where you want your resources delivered.
2. Stand within 8 metres of an accessible chest. Make sure the intended chest is the nearest one.
3. Press Left Ctrl + Left Shift + F8 to mark it as a World Cleaner. Use the same shortcut to unmark it.
4. Press Left Ctrl + Left Shift + F9 to enable AutoPicker, then explore and harvest as you travel.
5. Open the marked cleaner to browse physical and virtual storage, or press Left Ctrl + Left Shift + F10 to open virtual storage.

Collection is enabled by default. AutoPicker is disabled by default until you enable it.

Default controls

Action	Shortcut
Mark/unmark the nearest chest	Left Ctrl + Left Shift + F8
Toggle AutoPicker	Left Ctrl + Left Shift + F9
Open virtual storage	Left Ctrl + Left Shift + F10

Shortcuts can be changed in the configuration file or through BepInEx Configuration Manager if installed. Configuration Manager is optional.

How collection works

The cleaner handles dropped items, while AutoPicker performs nearby harvest interactions. AutoPicker has its own toggle and can run independently of the cleaner. This combination lets you harvest while travelling and collect eligible drops without carrying every resource yourself.

World scanning and transfers run incrementally. This is not an instant sweep of every item on the map: discovery, loaded state, access rules, grace periods, storage capacity, and performance settings affect when a drop can be collected.

At the defaults:

• Newly observed drops have a 5-second grace period.
• Drops within 100 metres of other connected players are excluded. This exclusion does not apply to the local/solo host.
• Nearby chest delivery searches within 50 metres of the cleaner.
• Virtual overflow storage is enabled, with a default 4096 MB disk cap per world.
• AutoPicker uses a 5-metre radius.
• Moving unloaded dropped-item records near the cleaner is disabled. Collection.StageUnloadedDrops enables that optional behaviour; persistent discovery alone does not load those drops.

Configuration

Edit this file after the first launch:

BepInEx/config/arcbyte.worldcleaner.cfg

Section	Setting	Default	Purpose
General	Enabled	true	Master switch.
Collection	Enabled	true	Enables cleaner collection.
Collection	CollectNearPlayers	false	Allows collection near other players when enabled.
Collection	PlayerExclusionMeters	100	Exclusion distance around other players.
Collection	ObservedDropGraceSeconds	5	Delay before a newly observed drop is eligible.
Collection	StageUnloadedDrops	false	Allows discovered unloaded drops to be moved for initialization.
Storage	UseNearbyChests	true	Enables nearby physical storage delivery.
Storage	ChestRadiusMeters	50	Nearby storage search radius.
Storage	UseVirtualStorage	true	Enables persistent virtual overflow storage.
AutoPicker	Enabled	false	Enables automatic harvesting.
AutoPicker	RadiusMeters	5	Harvest radius; configurable from 1 to 50 metres.
AutoPicker	LootWildContainers	false	Enables eligible natural-container looting.
AutoPicker	ReplantCultivatedSeedCrops	true	Replants supported cultivated crops using matching seeds in your inventory.

Additional settings control archive limits, prefab exclusions, chest refilling, background cleaner areas, scanning budgets, diagnostics, and server permissions.

Compatibility

• Disable standalone ComfyAutoPicker when using the integrated AutoPicker. If the standalone plugin is detected, the integrated picker suspends itself to prevent double harvesting.
• SpiritStorage integration is optional. Supported vessels can act as cleaner anchors and delivery destinations when that mod is installed.
• Optional SeneaL UI / MidgardPlus integrations are included for supported interfaces and crafting flows. They are not required dependencies.
• Without a World Cleaner server connection, the standalone AutoPicker option can allow local harvesting and native wild-container looting. Shared archive access and server collection require the server plugin.
• Wild-container looting excludes player-built chests, graves, carts, and ships. Access and native Take All checks still apply.
• Modded archived items require their original item mods to remain available for restoration.

Saves and troubleshooting

Back up your world, character, and World Cleaner archive/recovery data before changing or removing the mod. Virtual storage is separate from the chest's physical inventory; withdraw archived resources before uninstalling. Keep the storage key and associated archive data consistent with the world that uses them.

If a chest will not mark, move closer, check access, close its inventory, and confirm the chest owner/server has the mod installed. If collection seems delayed, check AutoPicker status, player exclusions, storage space, and unloaded-drop settings.

For help, include BepInEx/LogOutput.log, your installed mods, and a short description of the problem. This package contains plugin version 0.31.0; the supplied DLL's file version is 0.31.0.1.