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

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

Bug Reports and Feedback

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

AI Disclosure

• Claude 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