Prototype/Locomotive

The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/LocomotivePrototype.html

This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.

Prototype definitions » PrototypeBase » Prototype/Entity » Prototype/EntityWithHealth » Prototype/EntityWithOwner » Prototype/Vehicle » Prototype/RollingStock » Prototype/Locomotive

A locomotive.

Prototype/Locomotive — locomotive
burner or energy_source	::	EnergySource
max_power	::	Energy
reversing_power_modifier	::	double
darkness_to_render_light_animation	::	float (optional)
front_light	::	LightDefinition (optional)
front_light_pictures	::	RotatedSprite (optional)
max_snap_to_train_stop_distance	::	float (optional)
Inherited from Prototype/RollingStock
air_resistance	::	double
connection_distance	::	double
joint_distance	::	double
max_speed	::	double
pictures	::	RotatedSprite
vertical_selection_shift	::	double
allow_manual_color	::	bool (optional)
allow_robot_dispatch_in_automatic_mode	::	bool (optional)
back_light	::	LightDefinition (optional)
color	::	Color (optional)
drive_over_tie_trigger	::	TriggerEffect (optional)
horizontal_doors	::	Animation (optional)
stand_by_light	::	LightDefinition (optional)
tie_distance	::	double (optional)
vertical_doors	::	Animation (optional)
wheels	::	RotatedSprite (optional)
Inherited from Prototype/Vehicle
braking_power or braking_force	::	Energy or double
energy_per_hit_point	::	double
friction or friction_force	::	double
weight	::	double
allow_passengers	::	bool (optional)
crash_trigger	::	TriggerEffect (optional)
equipment_grid	::	string (optional)
minimap_representation	::	Sprite (optional)
selected_minimap_representation	::	Sprite (optional)
sound_minimum_speed	::	double (optional)
sound_scaling_ratio	::	double (optional)
stop_trigger	::	TriggerEffect (optional)
stop_trigger_speed	::	double (optional)
terrain_friction_modifier	::	float (optional)
Inherited from Prototype/EntityWithOwner
allow_run_time_change_of_is_military_target	::	bool (optional)
is_military_target	::	bool (optional)
Inherited from Prototype/EntityWithHealth
alert_when_damaged	::	bool (optional)
attack_reaction	::	AttackReaction (optional)
corpse	::	string or table of strings (optional)
create_ghost_on_death	::	bool (optional)
damaged_trigger_effect	::	TriggerEffect (optional)
dying_explosion	::	ExplosionDefinition or table of ExplosionDefinition (optional)
dying_trigger_effect	::	TriggerEffect (optional)
healing_per_tick	::	float (optional)
hide_resistances	::	bool (optional)
integration_patch	::	Sprite4Way (optional)
integration_patch_render_layer	::	RenderLayer (optional)
loot	::	Loot (optional)
max_health	::	float (optional)
random_corpse_variation	::	bool (optional)
repair_sound	::	Sound (optional)
repair_speed_modifier	::	float (optional)
resistances	::	Resistances (optional)
Inherited from Prototype/Entity
icons, icon, icon_size (IconSpecification)	::	IconSpecification
additional_pastable_entities	::	table of string (optional)
alert_icon_scale	::	float (optional)
alert_icon_shift	::	vector (optional)
allow_copy_paste	::	bool (optional)
autoplace	::	AutoplaceSpecification (optional)
build_base_evolution_requirement	::	double (optional)
build_grid_size	::	uint8 (optional)
build_sound	::	Sound (optional)
close_sound	::	Sound (optional)
collision_box	::	BoundingBox (optional)
collision_mask	::	CollisionMask (optional)
created_effect	::	Trigger (optional)
created_smoke	::	CreateTrivialSmokeEffectItem (optional)
drawing_box	::	BoundingBox (optional)
emissions_per_second	::	double (optional)
enemy_map_color	::	Color (optional)
fast_replaceable_group	::	string (optional)
flags	::	EntityPrototypeFlags (optional)
friendly_map_color	::	Color (optional)
hit_visualization_box	::	BoundingBox (optional)
map_color	::	Color (optional)
map_generator_bounding_box	::	BoundingBox (optional)
minable	::	MinableProperties (optional)
mined_sound	::	Sound (optional)
mining_sound	::	Sound (optional)
next_upgrade	::	string (optional)
open_sound	::	Sound (optional)
placeable_by	::	ItemToPlace or table of ItemToPlace (optional)
protected_from_tile_building	::	bool (optional)
radius_visualisation_specification	::	RadiusVisualisationSpecification (optional)
remains_when_mined	::	string or table of string (optional)
remove_decoratives	::	string (optional)
rotated_sound	::	Sound (optional)
selectable_in_game	::	bool (optional)
selection_box	::	BoundingBox (optional)
selection_priority	::	uint8 (optional)
shooting_cursor_size	::	double (optional)
sticker_box	::	BoundingBox (optional)
subgroup	::	string (optional)
tile_height	::	uint32 (optional)
tile_width	::	uint32 (optional)
trigger_target_mask	::	TriggerTargetMask (optional)
vehicle_impact_sound	::	Sound (optional)
water_reflection	::	WaterReflectionDefinition (optional)
working_sound	::	WorkingSound (optional)
Inherited from PrototypeBase
name	::	string
type	::	string
localised_description	::	LocalisedString (optional)
localised_name	::	LocalisedString (optional)
order	::	Order (optional)

Mandatory properties

This prototype inherits all the properties from Prototype/RollingStock.

max_power

Type: Energy

reversing_power_modifier

Type: double

burner or energy_source

Type: EnergySource
Must be a burner energy source when using "burner", otherwise it can also be a void energy source.

Optional properties

front_light

Type: LightDefinition

front_light_pictures

Type: RotatedSprite

darkness_to_render_light_animation

Type: float
Default: 0.3

max_snap_to_train_stop_distance

Type: float
Default: 3.0
In tiles. A locomotive will snap to a nearby train stop when the player places it within this distance to the stop.