CartTrain Locomotives

An addon for CartTrain that lets the vanilla Scout and Hauler act as the lead vehicle for a train of large carts.

Controls

1. Move a vanilla large cart behind the Scout or Hauler.
2. Hold either the cart or the Scout/Hauler.
3. Press Left Shift + X to connect them.
4. Hold either connected object and press Left Shift + X again to disconnect.

There is no automatic coupling.

Features

• Scout and Hauler can tow the first vanilla large cart.
• CartTrain can continue the chain behind that first cart.
• Visible connection beam while the locomotive/cart connection is active.
• Virtual-hand towing: forces are applied to the cart, not the Scout/Hauler.
• Soft stay-behind handling keeps the first cart closer to the vehicle centerline and reduces wall/floor snagging.
• Only the vanilla Item Cart Medium is accepted as the locomotive follower, avoiding accidental links to unrelated modded carts.

Requirements

• BepInEx
• CartTrain 1.3.1

Notes

CartTrain Locomotives is designed as an addon to CartTrain rather than a replacement for it. The Scout/Hauler handles the first cart; CartTrain handles carts farther back in the chain.

0.3.3

0.3.4

• First cart now follows a short breadcrumb trail of the locomotive rear path.

• Reduces inside-corner cutting and wall snagging during sharp turns and narrow doorways.

• Preserves physics-driven movement, heavy-load assist, manual Shift+X coupling, and connection beam.

• Fixed heavily loaded first carts preventing the Scout/Hauler from moving.

• Coupled locomotive and first cart now ignore collisions with each other while connected.

• Added a capped mass-independent horizontal catch-up assist for the first cart.

• Restores locomotive/cart collisions when the connection is removed.

• Preserves manual hold + Left Shift + X coupling, connection beam, and stay-behind handling.

Changelog

0.3.2

• Added soft stay-behind handling for the first cart.
• Added lateral centering so the cart stays closer to the Scout/Hauler centerline.
• Added gentle yaw alignment to reduce sideways swinging and wall snagging.
• Preserved normal gravity, ramps, bumps, and collision response.
• Kept manual hold-object + Left Shift + X attach/detach behavior.
• Kept the visible connection beam and vanilla large-cart filtering.

0.3.1

• Replaced automatic coupling with manual attach/detach.
• Hold either the large cart or Scout/Hauler and press Left Shift + X to toggle the connection.
• Prevented automatic reattachment after disconnecting.

0.3.0

• Restricted locomotive towing to the vanilla large cart (Item Cart Medium).
• Prevented accidental coupling to unrelated modded PhysGrabCart objects.

0.2.9

• Added visible connection beam between locomotive and cart.

0.2.7

• Introduced the virtual-hand towing model.