Types/EnergySource
Basics
Specifies the way the entity gets its energy.
type
Type: Types/string
Mandatory. Only valid values are "electric", "burner", "heat", "fluid" or "void", it specifies the type of the energy source to be used.
emissions_per_minute
Type: Types/double
Default: 0
Optional. Preferred over using emissions and emissions_per_second_per_watt. The pollution an entity emits per minute at full energy consumption. emissions_per_minute is exactly the value that is shown in the entity tooltip.
emissions_per_second_per_watt
Type: Types/double
Default: 0
Optional. Does the same thing as emissions_per_minute but will be removed at some point.
emissions
Type: Types/double
Default: 0
Optional. Does the same thing as emissions_per_second_per_watt but will be removed at some point.
render_no_power_icon
Type: Types/bool
Default: true
Optional. Whether to render the 
icon on the entity if it is low on power. Also applies to 
when using a burner energy source.
render_no_network_icon
Type: Types/bool
Default: true
Optional. Whether to render the 
icon on the entity if it is not connected to a electric network.
Electric energy source
buffer_capacity
Type: Types/Energy
Optional. How much power the entity holds.
usage_priority
Type: Types/ElectricUsagePriority
Mandatory.
input_flow_limit
Type: Types/Energy
Default: max double
Optional. How fast the energy can flow into the entity. 0 means 0.
output_flow_limit
Type: Types/Energy
Default: max double
Optional. How fast the energy can flow out of the entity. 0 means 0.
drain
Type: Types/Energy
Optional.
Burner
fuel_inventory_size
Type: Types/ItemStackIndex
Mandatory.
burnt_inventory_size
Type: Types/ItemStackIndex
Default: 0
Optional.
smoke
Type: Types/table of Types/SmokeSource
Optional. Array of 1 or more smoke sources.
light_flicker
Type: Types/LightFlickeringDefinition
Optional.
effectivity
Type: Types/double
Default: 1
Optional. 1 means 100% effectivity. Must be greater than 0. Multiplier of the energy output.
fuel_category
Type: Types/string
Default: "chemical"
Optional. The energy source can be used with fuel from this fuel category. For a list on built-in categories, see Data.raw#fuel-category.
fuel_categories
Type: Types/table of Types/string
Optional. Same as above, only one of them can exist. For a list on built-in categories, see Data.raw#fuel-category.
Heat energy source
max_temperature
Type: Types/double
Mandatory. max_temperature must be >= default_temperature.
default_temperature
Type: Types/double
Default: 15
Optional.
specific_heat
Type: Types/Energy
Mandatory.
max_transfer
Type: Types/Energy
Mandatory.
min_temperature_gradient
Type: Types/double
Default: 1
Optional.
min_working_temperature
Type: Types/double
Default: 15
Optional. min_working_temperature must be >= default_temperature. min_working_temperature must be <= max_temperature.
minimum_glow_temperature
Type: Types/float
Default: 1
pipe_covers
Type: Types/Sprite4Way
heat_pipe_covers
Type: Types/Sprite4Way
heat_picture
Type: Types/Sprite4Way
heat_glow
Type: Types/Sprite4Way
connections
Type: Types/table of Types/HeatConnection
Optional. The table may only contain up to 32 connections.
pipe_covers
Type: Types/Sprite4Way
Optional.
Void energy source
Void is free energy, there are no additional entries required.
energy_source = {type = "void"}
Fluid energy source
fluid_box
Type: Types/FluidBox
Mandatory. All standard fluid box configurations are acceptable, but the type must be "input" or "input-output" to function correctly. Scale_fluid_usage, fluid_usage_per_tick or a filter on the fluidbox must be set to be able to calculate the fluid usage of the energy source.
smoke
Type: Types/table of Types/SmokeSource
Optional. Array of 1 or more smoke sources.
light_flicker
Type: Types/LightFlickeringDefinition
Optional.
effectivity
Type: Types/double
Default: 1
Optional. 1 means 100% effectivity. Must be greater than 0. Multiplier of the energy output.
burns_fluid
Type: Types/bool
Default: false
Optional. If set to true, the energy source will calculate power based on the fluid's fuel_value entry, else it will calculate based on fluid temperature, like Prototype/Generator.
scale_fluid_usage
Type: Types/bool
Default: false
Optional. If set to true, the energy source will consume as much fluid as required to produce the desired power, if set to false it will consume as much as it is allowed to, wasting any excess.
fluid_usage_per_tick
Type: Types/double
Default: 0
Optional. The number of fluid units the energy source uses per tick. If used with scale_fluid_usage, this specifies the maximum. If this value is not set, scale_energy_usage = false and a fluid box filter is set, the game will attempt to calculate this value from the fluid box filter's fluid's fuel_value or heat_capacity and the entity's energy_usage. If burns_fluid is false, maximum_temperature will also be used.
maximum_temperature
Type: Types/double
Default: unlimited
If it is specified while scale_fluid_usage = false and fluid_usage_per_tick is not specified, the game will use this value to calculate fluid_usage_per_tick.
Prototype properties that use this type
- Prototype/Accumulator : energy_source
- Prototype/Beacon : energy_source
- Prototype/Boiler : energy_source
- Prototype/BurnerGenerator : burner
- Prototype/BurnerGenerator : energy_source
- Prototype/Car : burner or energy_source
- Prototype/Combinator : energy_source
- Prototype/CraftingMachine : energy_source
- Prototype/ElectricEnergyInterface : energy_source
- Prototype/ElectricTurret : energy_source
- Prototype/Equipment : energy_source
- Prototype/Generator : energy_source
- Prototype/GeneratorEquipment : burner
- Prototype/Inserter : energy_source
- Prototype/Lab : energy_source
- Prototype/Lamp : energy_source
- Prototype/Locomotive : burner or energy_source
- Prototype/MiningDrill : energy_source
- Prototype/ProgrammableSpeaker : energy_source
- Prototype/Pump : energy_source
- Prototype/Radar : energy_source
- Prototype/Reactor : energy_source
- Prototype/Roboport : energy_source
- Prototype/RoboportEquipment : burner
- Prototype/SolarPanel : energy_source
- Prototype/SpiderVehicle : burner or energy_source