Factorio Train Network for Players

Project maintained by leehuk Hosted on GitHub Pages — Theme by mattgraham


Train Network for Players (Factorio Mod)


QoL and advanced functionality for players using trains for transport, including improved destination selection dialog and automated train calling.

There are two core concepts for this mod:

Station Select Dialog

The station select dialog provides a quick way of moving between stations and can be opened when onboard any train via either the input hotkey (ALT-P default) or toolbar shortcut:

TNfP Station Select   TNfP Station Select Search

TNfP Network

If one or more trains are assigned into a TNfP network they can be automatically dispatched to the players location using the two shortcuts:

TNfP Shortcut Bar


Miscellaneous features:

TNfP Network Creation

Trains are available for players if they have a train stop marked for TNfP use anywhere in their schedule, which is done via a single combinator signal.

To assign trains into a TNfP network:

  1. Research trains, train stops and the circuit network.
  2. Have a train stop thats only intended for player use.
  3. Have a train thats only intended for player use, with the player train stop anywhere in its schedule.
  4. Place a Constant Combinator near your personal train stop.
  5. Set the combinator to output the new ‘TNfP Station’ virtual signal (with any value) – found under ‘Signals’.
  6. Connect the combinator to the train stop, with either red or green wire.

TNfP Combinator

When dispatching trains TNfP will find the nearest train which has anywhere in its schedule a train stop receiving the ‘TNfP Station’ signal.

TNfP Rail Tool

The railtool provides a way of dispatching via the map or player view, with the ability to create a temporary train stop if needed. It’s used by selecting/dragging over an area containing train stations and/or rail segments:

TNfP Rail Tool Selection   TNfP Rail Tool Stop

TNfP Home Station

The ‘TNfP Home Station’ is an additional circuit signal found under ‘Signals’. When this signal is provided to a train stop, that train stop becomes marked as a home station.

TNfP Combinator Home

Home stations appear at the very top of the ‘all stations’ and ‘tnfp stations’ lists in the Station Select Dialog above pinned stations, allowing them to be quickly selected for dispatch.

Important Notes

This mod should be mostly stable for both single player and multiplayer. Bug reports, feature requests or any comments are preferred via github.com or via the forum. Please include the crash log and version information about both factorio and the mod in bug reports.

TNfP should be compatible with all mods relating to trains, providing they don’t change train schedules or add custom types of train stops. When used with mods which add custom types of train stops, TNfP will work as follows:

Technical Information

General technical information, for the curious.

Dispatching Logic

When dispatching trains, TNfP will prioritise as follows:

  1. A TNfP train the player is currently in.
  2. A TNfP train stop with an unallocated train already waiting.
  3. A TNfP train stop.
  4. A standard train stop, if it is not blocked by another train.

If TNfP needs to dispatch a train to a player, it will dispatch the closest valid and unallocated train based on straight line distance.

TNfP will apply a configurable arrival timeout for the train to arrive at the requested location. If the train does not arrive before this timeout, the request will be cancelled and the train will have its original schedule restored.

Arrival Logic

The destination train stop for a TNfP dispatch request is added with a standard station wait condition, using a configurable time ‘Boarding Timeout’. If the player does not board in this time, TNfP will detect the train departing and restore its original schedule. If the player does board the train, it will immediately reset the schedule and perform the configurable ‘Boarding Behaviour’.

Boarding Behaviour

When a player boards a dispatched train, the original schedule is restored but the train is immediately switched to manual mode and so will not resume the schedule. If TNfP is configured to display the optional station selection dialog this will appear, allowing the player to select an onward destination.

If the station selection dialog is closed or the player exits the train, it will remain in manual mode but with its original schedule.

Redispatch Behaviour

When a player has selected an onward destination, TNfP will add the new station with a standard station wait condition of ‘Passenger Not Present’. This station will then remain in the schedule until it becomes true (i.e. the passenger leaves the train), or the passenger selects another onward destination.

If the station is already in the trains schedule, the station wait conditions will not be altered. Additionally if it is a tnfp train and the redispatch station is already in the trains schedule, it will not resume its previous schedule on arrival but will instead remain at the redispatch station under its normal wait conditions.

Temporary Station Cleanup

TNfP relies on a particular quirk in factorio, in that once a train is waiting at a station – if the station is destroyed/deleted, factorio will continue to wait until the station condition is true before departing. This allows TNfP to clean up the temporary stations as early as possible, but with the caveat the schedule looks a little odd.