CartTrain Locomotives

A CartTrain addon for R.E.P.O. that lets the vanilla Scout and Hauler act as powered lead locomotives for a CartTrain chain.

How it works

The Scout/Hauler acts like a player holding the first large cart. The addon applies towing force only to that first cart; CartTrain remains responsible for carts behind it.

Typical setup:

Scout/Hauler -> first large cart -> CartTrain cart 2 -> CartTrain cart 3 -> ...

Attach / detach

There is no automatic coupling.

1. Put a vanilla large cart near the rear of the Scout or Hauler.
2. Physically hold either the large cart or the Scout/Hauler.
3. Press Left Shift + X to connect them.
4. Hold either member of the connected pair and press Left Shift + X again to disconnect.

The pair stays disconnected until you deliberately attach it again.

Connection indicator

A visible tow/hand-hold beam appears between the rear of the Scout/Hauler and the connected end of the cart while the connection is active.

Compatibility / safety

• Requires CartTrain 1.3.1.
• Designed for the vanilla Scout and Hauler.
• Only the vanilla large cart (Item Cart Medium) can be selected as the locomotive's first follower.
• PocketCartPlus and other unrelated PhysGrabCart objects are ignored.
• The addon does not teleport or force-rotate the Scout/Hauler.
• Towing force is applied only to the connected cart.

Controls

• Left Shift + X while holding the cart or Scout/Hauler: toggle connection.

Configuration

A BepInEx config file is generated at:

BepInEx/config/CandyKane.CartTrainLocomotives.cfg

It includes towing strength, damping, snap distance, tow gap, connection beam visibility/width, and related safety settings.

Multiplayer

The addon follows CartTrain's host-authoritative model. Install and run it on the host alongside CartTrain.

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.