CargoToGo

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.