Front coupler Issues:
A Summary Of The Current Situation And Some Solutions

by Lukas A Lusser

Overview

The front coupler is one of the ongoing problem zones of MSTS although a lot of people have done a lot of research; their combined fixes, tips etc. might help you overcome the issues with the front coupler

 

The Four Elements

There are four elements:

  1. The "fix" Microsoft provided solved only the problem of train brakes initially not releasing when the front coupler was in use.  Later versions of MSTS (especially the current 1.2) already have the fix implemented by default.
     
  2. The coupling process itself is hard-coded into the sim. The logic governing that process is that the couplers will only engage when the engine is rolling backwards towards a car at a speed between ca. 0.5mph and 3mph (these figures can be altered via the file trains/trainset/default/default.wag, see below).

    The programmer's logic here was well-intentioned, as this set-up avoids that your coupler accidentally re-engages after you have uncoupled from a car at your tail end and pull away from it, or even worse, that you derail on pulling away if you exceeded the maximum coupling speed of 3mph while still within the "coupling zone".  That is all nice and works well when coupling is done by the rear coupler.  However, the same logic also applies to the front coupler, where it produces not-so-logical results. Remember, the coupling only works with the engine rolling backwards, so when you want to couple to or uncouple from the front coupler, you need to observe the following steps:

    a.   To couple to a loose consist with the front coupler, follow this procedure exactly:

    1. Move slowly forward towards the car(s) all the way until your engine/train gently bumps into it, not exceeding a speed of 2 mph when contact is made;
    2. Apply the train or engine brakes immediately, before the spring of the couplers presses you back, away from the car(s);
    3. Put the reverser into reverse and notch up to notch 1;
    4. Release the brakes, start to back away from the car(s), keep power applied in notch 1 until the speed displayed in your track monitor jumps to 2 mph.  Immediately cut power if you reach 2 mph;

    In most cases, the coupler should lock when you leave the far end of the coupling zone of the car. If not, repeat from step 1 until couplers lock.

    b.   To uncouple from cars attached to the front coupler, follow this procedure exactly:

    1. Set the train brakes;
    2. Uncouple from the car by clicking on the coupler in the F9 display (note: if you have more than five cars on your front hook, the F9 display does not show your engine, but only the six foremost cars. Uncouple in steps of six cars until you see the engine appearing in the F9 monitor);
    3. Release the brakes and move forward gently, towards the car(s) you want to uncouple from, until your engine won’t go further;
    4. Notch back to idle and let the pressure of the coupler springs push you away from the cars. Do not notch up until you are well clear of the coupler zone of the cars. As a rule of thumb, I recommend that a distance of five yards or five metres respectively should be a safe distance to avoid re-coupling;
    5. If you notched up too early and increased your speed too hastily while still in the coupling zone, MSTS thinks that you bumped into the cars and will end the activity with a derail message – regardless of the fact that the opposite were true…

    c.   Remember: Always save your activity before engaging or releasing the front couplers. Actually, many MSTS users recommend to save your progress along the track at least every 15 – 30 minutes, regardless of what you do.

  3. An important element in the fix was discovered by Jim "Sniper297" Ward (author of the very popular Port Odgen & Northern route). The physical behaviour of couplers is not only calculated from the settings in the .eng or .wag file of the rolling stock you use. The sim also takes the file default.wag into account which resides in your trains/trainset directory/default. As Jim Ward pointed out, the settings in that file includes the settings for the minimal and maximal speed within which range the couplers engage. See the following three lines:

    	"30cm # Minimum couple distance"
    	(...)
    	"0.2 # min coupling velocity"
    	"3.0 # max coupling velocity"
    
    The 30cm define the "coupling zone" within which the couplers engage (with the engine rolling backwards only, as described above in 2), the second and third parameter define the minimum and maximum speed in metres/second for the coupling to work. Staying under the limit allows means couplers will not engage, exceeding the limit results in a collision with the car you want to couple to). If you use the front coupler often, you may want to increase the min coupling velocity to 0.4 or 0.5. That will let you roll away from a car uncoupled from the front without the couplers re-engaging a bit faster than the 0.5 mph the original setting allows.BEBE


  4. James W. Titus found another important piece in the puzzle with regard to the sim freezing when the front coupler is engaged.   The solution goes a long way to overcoming this problem and making the front coupler pretty reliable, but it includes manual editing as it involves the modification of the coupler physics for each engine in its respective .ENG file. This may sound like an option for advanced users, but as there is quite a lot of editing to do within these files anyway, most users rather dig into them sooner than later.

    Please observe the following safety rules, should you intend to dare jumping into the cold water here: whenever editing .ENG or .WAG files back up the original first.  Furthermore, use only WordPad to edit the file as this is the best way to safeguard that the file is properly saved in Unicode format: this is crucial for its functioning.

    Now for the coupler physics in there: By default, engine (and wagon) files only feature one set of coupler physics - designed for the rear coupler. As the front coupler looks the other way, a second set of inverted physics needs to be applied otherwise the sim uses the rear coupler physics for the front coupler wherein some values then cause errors.

    Typically, the coupler physics for the rear coupler should look something like the following example (taken from some modified file of mine where I have standardised the coupler physics of all engines to the same settings):

    Coupling (
    	Type ( Automatic )
    		Spring (
    		Stiffness ( 1.1e6N/m 4.8e6N/m )
    		Damping ( 1.2e6N/m/s 3.4e6N/m/s )
    		Break ( 3.4e7N 3.4e7N )
    		r0 ( 1 cm 30cm )
    		)
    Velocity ( 0.1m/s )
    )

    The front coupler physics need to be inserted immediately after this section. Again, MSTS is a bit illogical here, as the first set of coupler physics always applies to the rear coupler, and an (optional) second set always applies to the front coupler (check any steam engine which has an automated coupler on the front, and a bar coupler connecting to the tender in the rear: The first set of parameters in the .eng file will be the ones for the bar coupler).

    Using James' method, I have then added the inverted front coupler physics (note also the minus sign for velocity!), this is the complete set of front coupler physics to pair with the above physics for the rear coupler:

    Coupling (
    	Type ( Automatic )
    		Spring (
    		Stiffness ( 4.8e6N/m 1.1e6N/m )
    		Damping ( 3.4e6N/m/s 1.2e6N/m/s )
    		Break ( 3.4e7N 3.4e7N )
    		r0 ( 30cm 1cm )
    		)
    	Velocity ( -0.1m/s )
    )
    
    Note 1: Whenever some passage is added or deleted from the file, it is very important to pay attention not to forget/leave out one of the opening or closing parenthesis, otherwise MSTS will get lost where a specific section ends and the next begins;

    Note 2: The individual values can vary, e.g. for a higher or lower break. What is important is that you use the correct unit of measurement N/m/s for the damping or your couplers might break way too often where they should not break (many default and add-on files have an error here!). Avoid a value of 0 (zero) for any one of the values in the line r0 ( ... ) - according to James, any zeroes in there are key suspects for the sim crashing with send/don't send upon coupling.

    Note 3: The presence of two sets of coupler values might cause error messages in ConBuilder, especially when using this tool to edit the .ENG or .WAG files directly, e.g. when changing the coupler types or altering the name line (usually with a warning message: "Coupler settings could not be changed").