WorldCleaner

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