Multi-Hauling

If you liked this item, please rate it up on Steam Workshop page.

Author: L. Loire

Last revision: 21 Nov, 2025 at 19:34 UTC (2)

File size: 116.72 KB

On Steam Workshop

Description:

[This mod requires DFHack!]

This tool allows dwarves to collect several adjacent items at once when performing hauling jobs with a wheelbarrow. When enabled, new StoreItemInStockpile jobs with wheelbarrows will automatically attach nearby items so they can be hauled in a single trip.
Jobs without wheelbarrows would try to attach one if autowheelbarrows option is on.
Items claimed by another jobs or already stored in stockpiles would be ignored.
By default, up to ten additional items within 10 tiles of the original item are collected.

Warnings:
1. Destination stockpile filters are currently ignored by the job (because of DF logic). Which items qualify can be controlled with the –mode option.
2. Be careful about QSP and minecarts that accept wheelbarrows. It can go crazy.
3. autowheelbarrows would use any free wheelbarrows nearby, regardless of their connection to any stockpile.
4. Disable autowheelbarrows if you exp big fps drop.
5. Use "any" mode carefully: it could end up with unexpected things.
6. Script automaticly checks if there are any stuck jobs once in a while. But you can focre it with "multihaul unstuckjobs"

Usage
multihaul enable [<options>]
multihaul disable
multihaul status
multihaul unstuckjobs
multihaul config [<options>]
The script can also be enabled persistently with enable multihaul.

Options
–radius <tiles>
Search this many tiles around the target item for additional items. Default is 10.
–max-items <count>
Attach at most this many additional items to each hauling job. Default is 10.
–mode <any|sametype|samesubtype|identical>
Control which nearby items are attached. any collects any items nearby, even if they are not related to an original job item, sametype only matches the item type (like STONE or WOOD), samesubtype requires type and subtype to match, and identical additionally matches material. The default is sametype.
–autowheelbarrows <on|off|enable|disable>
Automatically assign wheelbarrows to jobs that lack them.
–debug <on|off|enable|disable>
Show debug messages via dfhack.gui.showAnnouncement when items are attached.

Code on github:
https://github.com/LoireLab/df_scripts/tree/multihaul

You can support me here:
https://ko-fi.com/loirelab

Download
Revisions:

Old revisions of this mod are available below. Click the link to download.