CartTrain Locomotives

A host-side companion addon for The_Land_of_Death-CartTrain for R.E.P.O.

CartTrain normally links large carts into a train. CartTrain Locomotives extends the front of that train so a Scout or Hauler can tow the first large cart:

Scout / Hauler -> Large Cart -> Large Cart -> Large Cart -> ...

Requirements

• BepInExPack 5.4.2305
• CartTrain 1.3.1
• Install on the lobby host, matching CartTrain's host-only design.

Supported locomotives

• Scout (Item Vehicle Semiscooter Small)
• Hauler (Item Vehicle Semiscooter)

How it works

The back of the Scout/Hauler acts like a virtual player hand holding one end of the first cart.

• The addon never applies force to the Scout/Hauler.
• It does not teleport or force-rotate the cart.
• It applies spring/damping force only to the cart, at the selected cart end, toward a tow point behind the vehicle.
• Because the force is applied off-center, the cart naturally turns and trails behind the vehicle.
• Additional carts can be connected behind the first cart using CartTrain normally.

How to use

1. Install CartTrain and CartTrain Locomotives on the lobby host.
2. Bring either end of a large cart close to the rear of a Scout or Hauler.
3. The first cart couples automatically when it is in range.
4. Connect more large carts behind it using CartTrain normally.
5. Press Left Shift + X to manually detach the locomotive from the first cart.

Configuration

After the game launches once, configuration is created at:

BepInEx/config/CandyKane.CartTrainLocomotives.cfg

Configuration includes coupling range, tow-point placement, spring/damping strength, vertical-force limiting, emergency breakaway distance, manual detach controls, and debug logging.

Multiplayer

This addon is intended for the lobby host. It does not add custom Photon RPCs and relies on the game's existing object/cart synchronization, matching CartTrain's host-only deployment model.

Compatibility

Designed and runtime-tested with:

• R.E.P.O. v0.4.4.3
• CartTrain 1.3.1
• BepInEx 5.4.23.5 / BepInExPack 5.4.2305

0.2.7 behavior

Version 0.2.7 replaces the earlier route-lock experiments with the virtual-hand towing model. In testing, both Scout and Hauler were detected and coupled correctly, manual Shift+X detach worked, and the cart followed with the intended hand-pulled feel.

If you run into a problem, include BepInEx/LogOutput.log and note whether you were using Scout or Hauler.

Changelog

0.2.7

• Replaced route-lock/forced-position follower logic with a virtual-hand towing model.
• The rear of Scout/Hauler now acts like a player holding the first cart.
• Only the cart receives towing force; the locomotive is never moved or rotated by the addon.
• Force is applied at the selected end of the cart so it naturally steers behind the vehicle.
• Added strong vertical-force limiting to avoid lifting/scooping the vehicle.
• Confirmed Scout coupling, Hauler coupling, persistent connection, and manual Shift+X detach in runtime testing.

0.2.6

• Experimental recorded-route follower. Superseded by 0.2.7.

0.2.5

• Fixed accidental immediate detach behavior.
• Changed manual detach to Left Shift + X.
• Added explicit detach reasons and Rigidbody reacquisition.

0.2.4

• Added persistent first-cart assignment, coupling grace period, and a larger emergency breakaway distance.

0.2.3

• Removed expensive scene searches from the physics loop.
• Added cached discovery/dimensions and cheaper follower checks.

0.2.2

• First successfully compiled build against supplied R.E.P.O. and CartTrain assemblies.

0.2.0

• Reworked project as a CartTrain companion addon.

0.1.0

• Initial locomotive-following prototype.