CargoToGo

Pack the materials for any build piece into a single cargo item, carry it in your inventory, and build with it later.

Gather the wood, stone and nails for a house once, turn each piece into one compact item, and take it with you instead of hauling stacks of raw materials around.

How it works

Action	Controls
Pack a cargo	Select a piece in the hammer menu, then Ctrl + Alt + Left click. Works on the piece in the build menu and (by default) in the world.
Build with a cargo	Select the piece and place it as usual. If you hold a cargo for that piece, it is used up instead of the materials.
Repack a piece	Alt + Destroy (middle mouse by default) on a piece that was built from a cargo. You get the cargo back instead of loose materials.
Unpack a cargo	Ctrl + Alt + Right click the cargo in your inventory. It is destroyed and the materials are returned.

When you pack, materials are taken from nearby chests first (20 m by default) and then from your inventory. A cargo always contains exactly the materials the piece costs, and it needs one free inventory slot.

If the world has free building enabled, packing needs no materials and unpacking returns none, the same as vanilla building and deconstructing.

Cargo rules

• Cargos are unstackable and weigh as much as the materials inside (adjustable in the config).
• A cargo stays in your inventory. It can't be dropped, moved to a chest or used for anything except building its piece.
• Portals: a cargo can pass through a portal only if every material inside it can. A cargo holding ores or ingots is blocked just like the loose items would be. World portal settings are respected.
• Crafting station requirements for the piece still apply when you place it.

The Cargos tab

A fifth tab, Cargos, is added to the build menu. It lists only the pieces you currently hold a cargo for and updates live as you pack, build and unpack.

Key hints

While in build mode, the key hint bar shows Pack cargo and Repack with your current key bindings (keyboard only).

AzuCraftyBoxes (optional)

If AzuCraftyBoxes is installed, CargoToGo can also pack from the containers it reaches. This follows AzuCraftyBoxes' own container range, chest toggles, item include/exclude rules, "leave one", drawers and bags. It works even if CargoToGo's own range is set to 0. AzuCraftyBoxes is not required.

Configuration

The config file is generated on first launch at BepInEx/config/com.kydldev.CargoToGo.cfg.

Setting	Default	Description
ContainerRange	20	Radius in metres to search for chests when packing. 0 turns CargoToGo's own search off (combine with UseAzuCraftyBoxes to rely only on AzuCraftyBoxes' range).
PullFromContainers	true	Allow packing materials from nearby chests.
UseAzuCraftyBoxes	true	Also pack from containers reached by AzuCraftyBoxes, if installed. Needs PullFromContainers.
ContainersFirst	true	Take materials from chests before your inventory.
PackInWorld	true	Ctrl + Alt + Left click in the world packs a cargo instead of placing the piece.
AltDestroyAnyPiece	false	Alt + Destroy returns a cargo even for pieces that were not built from one.
PackEffects	true	Play build dust, sound and the piece's break effect when packing.
ShowKeyHints	true	Show the Pack cargo / Repack hints in the build-mode key hint bar.
ShowCargoTab	true	Add the Cargos tab to the build menu. Needs a game restart.
WeightMultiplier	1	Cargo weight = weight of its contents × this value. Needs a game restart.
VerboseLogging	false	Also write DEBUG lines to the BepInEx log.

Troubleshooting

Log lines from this mod look like …-CargoToGo-LEVEL-… in BepInEx/LogOutput.log. If something goes wrong, enable VerboseLogging and include the CargoToGo lines when reporting an issue.

Credits

Created by kydldev.