Rail Unload

From StarMade Wiki
Rail Unload
Rail Unload.png
Hit Points100
Data Value (ID)1105

Rail Unloads are special rail docks that are designed to allow any docked entity to automatically transfer items to the parent entity. The process requires permission from the parent entity as well as having Storage containers connected to the Rail Unload. It has the opposite function of Rail Loads.

Item Description

"This is the unload rail module. Docking to a block like this will pull items from the chests that are connected to the rail docker of the docked ship to the chests that are connected to this rail block. You can put more of them together to make a track. Use the 'Rail Docker' to dock to this block."


Production Info
Produced in a Standard Factory Standard Factory.png
RequiresTo create
Sintyr Capsule
Sintyr Capsule.png Rail Unload
Rail Unload.png


A Rail Docker can be attached to a Rail Unload by using the Rail Docker's docking beam on the rail it should dock to. The arrows on the rail and docker indicate which way the docked entities will align.

Cargo Transfer

The primary purpose of the Rail Unload is to allow for cargo transfer between docked entities. The Rail Unload will transfer cargo from the docked entity to the parent entity.

To transfer cargo, first both the Rail Unload and the Rail Docker that is docked to it must be linked to at least one Storage block on their entity. Second, the linked storage on the parent entity must have its Auto-Pull active and defined items to pull. Third, the docked entity must give permission to have cargo transferred from it. This can currently only be done by entering the docked entity, opening the radial menu Tab, and navigating to the Load/Unload Rail Settings in the "Ship" section of the menu, and there choose the desired setting. (See the Cargo Permissions section below for details.) This will cause items to be transferred from the docked entity to the parent entity. There will be no interaction with Storage blocks that are not linked to the Rail Docker or Rail Unload.

Cargo Permissions

In order for cargo to be transferred from a docked entity to the parent entity, the docked entity must give the parent entity permission to pull items from its storage blocks.

Cargo permissions can currently only be configured by entering the docked entity, opening the radial menu Tab, and navigating to the Load/Unload Rail Settings in the "Ship" section of the menu.

This table lists and explains the available options:

Function Description
Always Allow Cargo will always be transferred.
Always Ask Cargo will not be transferred until a one-time permission is given. If a player is inside the docked entity, they will be presented with a popup asking for this permission (when the next pull tick completes). Permission can also be given or revoked with the "Allow current Dock to pull/Disable current Dock pulling" options.
Always allow faction, ask for rest Will behave like "Always Allow" if docked to an entity aligned to the same faction, or if the pilot that docked the entity belongs to that faction, if the docked entity is neutral. If the parent entity is from a different faction or neutral, it will behave like "Always Ask".
Never Cargo will never be transferred.
Allow current Dock to Pull This is a special option. It will give or revoke the one-time permission required by the settings "Always Ask", and "Always allow faction, ask for rest". If permission has already been given, the option will be displayed as "Disable current Dock pulling", and can be used to revoke the permission. It has no effect on "Always Allow", and "Never".

Logic Functions

When the Rail Unload receives a high signal from any logic block that is linked to it, it will release the entity that is docked to it.

Exchanging Rails

Using an Activation Module it is possible to replace or reorient rails. This is often used to switch the direction of rails, and for advanced manipulation of docked entities.

To exchange rails, place an Activation Module and link it to all rails you want to change. Place any rail with the type and orientation you want to change the other rails to adjacent to the Activation Module. When the Activation Module is activated, the rails it links to are replaced with copies of the rail adjacent to the Activation Module. To ensure this works correctly, only one rail block should be adjacent to the Activation Module.

This also works when using Button, Inner Ship Remote, and Wireless Logic Module in place of an Activation Module.

Rail Turret Axis can not be modified this way.


Rail BasicRail Basic.pngRail DockerRail Docker.pngRail LoadRail Load.pngRail Mass EnhancerRail Mass Enhancer.pngRail Rotator Clock WiseRail Rotator Clock Wise.pngRail Rotator Counter Clock WiseRail Rotator Counter Clock Wise.pngRail Speed ControllerRail Speed Controller.pngRail Turret AxisRail Turret Axis.pngRail UnloadRail Unload.pngPickup PointPickup Point.pngPickup RailPickup Rail.pngShootout RailShootout Rail.png