Skip to content

Couplers & Buffers

Katy Fox edited this page Feb 14, 2022 · 7 revisions

Default Buffer Models

Dummy coupler/buffer rigs are provided in the car template. These must stay at X=0.0 and Y=1.05 (to align with other cars), and then should be aligned to the ends of your model along the Z axis. Once aligned, you should delete the children under [coupler_rig_front] and [coupler_rig_rear], leaving just the parents. This will save file size when you export your car later, but it won't harm anything if you leave the dummy visual parts of the coupler rig in your model.

The coupler rigs must be part of your car prefab and must have the names [coupler_rig_front] and [coupler_rig_rear]. As usual, the "front" side of the model is in the +Z direction.

Coupler Rig Alignment

Custom Buffer Models

The models of the buffer pads (the spring-loaded mushroom-shaped plates) are replaceable by the modder. These objects are the Buffer_FL, Buffer_RR etc. transforms under [coupler_rig_front] and [coupler_rig_rear]. The meshes on these can be replaced with your own, but make sure to keep the original names (and check that there are no trailing spaces) as the CCL loader expects to find the buffers by name. Finally, make sure to check the "Use Custom Buffers" checkbox on the TrainCarSetup script to tell CCL to use your new meshes.

Buffer Plate Objects

Custom Hose Positions

The default car template contains both the air hose and MU connector in each coupler rig. If "Use Custom Hose Positions" is checked (the custom buffers box must also be enabled), CCL will use the hose positions provided in your prefab instead of the default locations. If your car is not an MU capable locomotive, the MU connector can be ignored or deleted. Care must be taken when adjusting the connector positions to ensure that the cables can still connect properly in-game.

Hose Adjustments

Clone this wiki locally