BetterCarts

Better Carts makes hauling with Carts more pleasant with quality-of-life features, all configurable in-game

Features

• Chain Overflow - when a full Cart picks up an item, it is passed to the next Cart in the chain with a free slot. Nothing is left behind until every chained Cart is full
• Bucket Priority - prefer grabbing an empty Bucket when unloading a Cart
• Cart Release Fix - releasing a pulled Cart never grabs a different Cart on the same press
• Cart Capacity - set how many items the vanilla Carts can carry (0-64, default 4). The Mercury cart-capacity blessing adds a configurable bonus on top (0-64, default 1), and Eject Overflow drops anything above the limit beside the Cart when a world loads. Modded Cart types are not covered
• Cart Overlays - the item count is shown above a Cart carrying more than 5 items, and a Cart that comes loose from the chain by itself says so. Counts for ordinary capacity and for empty Carts can be turned on too
• Collect Range - Carts automatically pick up loose items within a configurable range (0-10 tiles, default 2). 0 = vanilla
• Deposit Range - Carts deposit matching cargo into Material Storages within range (0-10 tiles, default 2). 0 = vanilla
• Connect Range - free Carts are pulled toward a Cart the player is pulling once in range (0-10 tiles, default 2). 0 = vanilla
• Stockpile Range - Carts take resources from building output stockpiles within range, into free slots and empty Buckets on the Cart (0-10 tiles, default 2). 0 = vanilla

Configuration

All settings (master toggle, per-feature toggles etc.) are configured from the Mod Settings button in the main menu (added by Mod Settings Menu), or in BepInEx/config/com.beesq.romestead.bettercarts.cfg

Requirements

• BepInExPack_Romestead (Mod Loader) by Ice Box Studio
• ModSettingsMenu (Settings Menu) by Ice Box Studio

They are installed automatically as dependencies by your mod manager

Multiplayer

Server-side - only the host needs the mod, joining players do not need anything installed

• Chain Overflow
• Cart Capacity - the host's values apply to everyone, but each player needs the mod to SEE cargo beyond the vanilla slots
• Collect Range
• Deposit Range
• Connect Range
• Stockpile Range

Client-side - applies to each player that has the mod installed

• Bucket Priority
• Cart Release Fix
• Cart Overlays - the cargo count appears for every player with the mod, and the disconnect message is shown to whoever was pulling the Cart

Compatibility

• Iron Cart by burdock12 - compatible but not supported by the Cart Capacity feature
• Cart Capacity by Specsfo/Encordeo - not compatible
• CartEnhancements by chuxiaaaa - not compatible (it does not currently load, with or without Better Carts)

Install

Automatic (recommended): click Install with Mod Manager on this page, works with Thunderstore Mod Manager, r2modman, or Gale

Manual: download the zip and extract its contents into Romestead/BepInEx/plugins/

Notes

• The mod stores nothing in your save unless a Cart actually carries more than the game allows on its own - more than 4 items, or more than 5 with the Mercury blessing
• Eject Overflow is the only part of the mod that moves your cargo: on world load, a Cart over its capacity drops the surplus beside itself
• High capacity values can cause stutter and stack cargo into a tall tower above the Cart
• Before removing the mod, change Carts Capacity and Mercury's blessing values back to vanilla, leave Eject Overflow on, and load each affected world once so extra cargo is released
• Deposit Range takes only matching resources from Cart cargo
• Stockpile Range takes only from output stockpiles, a building's input storage is never drained

Known Issues

• The game rarely stops responding while saving. Reopening the world loads the last completed save

Bug Reports and Feedback

Please submit through GitHub Issues on the source repo (link below)

Credits

Thanks to Beartwigs for creating Romestead

AI Disclosure

• AI does the writing - the code and all the text that comes with it
• I write the rules it follows: what gets built, how it works, how it reads
• I test every build

Links

• Source code (MIT): https://github.com/BeesQ/Romestead-BetterCarts-Mod
• Also on Nexus Mods: https://www.nexusmods.com/romestead/mods/91
• More from me: https://solo.to/BeesQ

1.4.2

• Added Troubleshooting Mode (off by default): after a restart it shows diagnostic logging for bug reports and a Load switch for each feature. Memory monitoring and the separate log file stay OFF unless turned on
• The Cart Overlays count now updates as soon as a Cart takes or drops an item
• Fixed Connect Range jolting Carts to a new direction, joining players sometimes seeing extra cargo on the ground, and thrown items keeping their thrown state in the save
• Extra cargo is no longer dropped when a Cart is temporarily unloaded, or when Cart Capacity or Eject Overflow is turned off
• Better performance with many Carts or high capacities
• Added a Known Issues section to the mod page, plus small text changes

1.4.1

• Fixed the Disconnect Message description
• The Mod Settings Menu entry now links the Thunderstore page alongside the Nexus Mods page
• Updated the Thunderstore dependency to Mod Settings Menu 1.1.2
• Small text changes

1.4.0

• Updated to Romestead 0.26.1
• Added Cart Overlays: the item count is shown above a Cart carrying more than 5 items (client-side, applies per player with the mod)
• Counts for ordinary capacity and for empty Carts are available in the settings, off by default
• Added the disconnect message: a Cart that comes loose from the chain by itself now says so, shown to the player who was pulling it (client-side, applies per player with the mod)
• Small Config text changes

1.3.1

• Fixed Bucket Priority failing on Carts carrying more than the vanilla slots - the empty Bucket is now found whatever the Cart's capacity
• Bucket Priority now takes the Bucket from the Cart being unloaded rather than the nearest Cart in range
• When a Cart holds several empty Buckets, the one at the bottom of the stack is taken first
• Cargo stacked high on a Cart can now be taken by hand instead of only the lower layers

1.3.0

• Added Cart Capacity: set how many items the vanilla Carts can carry (0-64, default 4). Modded Cart types are not covered
• Added Blessing Bonus: how much the Mercury cart-capacity blessing adds on top of a Cart's base capacity (0-64, default 1)
• Added Eject Overflow (on by default): on world load, a Cart over its capacity drops the surplus beside itself
• Stockpile Range now fills a Cart up to its configured capacity instead of stopping at the vanilla slots
• Items collected beyond the vanilla slots now play the Cart pickup sound
• Settings toggles are now labelled by what each feature does instead of "Enabled"
• Corrected the settings location: Mod Settings is its own button in the main menu, not a page inside Settings

1.2.0

• Added Cart Release Fix: releasing a pulled Cart never grabs a different Cart on the same press (client-side, applies per player with the mod)
• Added Stockpile Range: Carts take resources from building Output stockpiles within range - solid resources go into free slots, bucket resources fill empty Buckets on the Cart (0-10 tiles, default 2). 0 = vanilla. While Pulled / While Parked toggles decide when it runs; Chain Overflow applies to taken items
• Added Mod Settings Menu integration: named and ordered settings, mod icon, Nexus link, and an update check when Mod Settings Menu is installed. The mod still works without it
• The mod now ships icon.png next to BetterCarts.dll

1.1.0

• Added Bucket Priority: prefer grabbing an empty Bucket when unloading a Cart
• Added Connect Range: free Carts are pulled toward a Cart the player is pulling once in range (0-10 tiles, default 2). 0 = vanilla

1.0.0

• Initial release: Chain Overflow, Collect Range, Deposit Range - all configurable in-game