Prototype/Generator: Difference between revisions
No edit summary |
(maximum_temperature clarification, max_power_output and scale_fluid_usage explanation) |
||
| Line 11: | Line 11: | ||
{{Prototype property|fluid_box|[[Types/FluidBox|FluidBox]]}} | {{Prototype property|fluid_box|[[Types/FluidBox|FluidBox]]}} | ||
This must have a filter if <code>max_power_output</code> is not defined. | |||
{{Prototype property|horizontal_animation|[[Types/Animation|Animation]]}} | {{Prototype property|horizontal_animation|[[Types/Animation|Animation]]}} | ||
| Line 23: | Line 24: | ||
{{Prototype property|maximum_temperature|[[Types/double|double]]}} | {{Prototype property|maximum_temperature|[[Types/double|double]]}} | ||
The maximum temperature to which the efficiency can increase. | Used to calculate the <code>max_power_output</code> if it is not defined and <code>burns_fluid</code> is false. Then, the max power output is <code>(min(fluid_max_temp, maximum_temperature) - fluid_default_temp) × fluid_usage_per_tick × fluid_heat_capacity × effectivity</code>, the fluid is the filter specified on the <code>fluid_box</code>. | ||
The maximum temperature to which the efficiency can increase. At this temperature the generator will run at 100% efficiency. Note: Higher temperature fluid can still be consumed. | |||
== Optional properties == | == Optional properties == | ||
| Line 34: | Line 37: | ||
{{Prototype property|scale_fluid_usage|[[Types/bool|bool]]|false|optional=true}} | {{Prototype property|scale_fluid_usage|[[Types/bool|bool]]|false|optional=true}} | ||
Scales the generator's fluid usage to its maximum power output. | Scales the generator's fluid usage to its maximum power output. | ||
Setting this to true prevents the generator from overconsuming fluid, for example when higher than <code>maximum_temperature</code> fluid is fed to the generator.<br> | |||
If scale_fluid_usage is false, the generator consumes the full <code>fluid_usage_per_tick</code> and any of the extra energy in the fluid (in the form of higher temperature) is wasted. The [[steam engine]] exhibits this behavior when fed steam from [[heat exchanger]]s. | |||
{{Prototype property|min_perceived_performance|[[Types/double|double]]|0.25|optional=true}} | {{Prototype property|min_perceived_performance|[[Types/double|double]]|0.25|optional=true}} | ||
| Line 41: | Line 47: | ||
{{Prototype property|max_power_output|[[Types/Energy|Energy]]|optional=true}} | {{Prototype property|max_power_output|[[Types/Energy|Energy]]|optional=true}} | ||
The power production of the generator is capped to this value. This is also the value that is shown as the maximum power output in the tooltip of the generator. | |||
<code>fluid_box</code> must have a filter if this is not defined. | |||
Revision as of 18:22, 4 November 2021
Template:Prototype parent An entity that produces power from fluids, for example a steam engine.
Mandatory properties
This prototype inherits all the properties from Prototype/EntityWithHealth.
Template:Prototype property Must be an electric energy source.
Template:Prototype property
This must have a filter if max_power_output is not defined.
Template:Prototype property The effectivity of the generator with 0.5 being half as effective as a regular steam-engine generator.
Template:Prototype property The number of fluid units the generator uses per tick.
Template:Prototype property
Used to calculate the max_power_output if it is not defined and burns_fluid is false. Then, the max power output is (min(fluid_max_temp, maximum_temperature) - fluid_default_temp) × fluid_usage_per_tick × fluid_heat_capacity × effectivity, the fluid is the filter specified on the fluid_box.
The maximum temperature to which the efficiency can increase. At this temperature the generator will run at 100% efficiency. Note: Higher temperature fluid can still be consumed.
Optional properties
Template:Prototype property Array of 1 or more smoke sources.
Template:Prototype property Scales the generator's fluid usage to its maximum power output.
Setting this to true prevents the generator from overconsuming fluid, for example when higher than maximum_temperature fluid is fed to the generator.
If scale_fluid_usage is false, the generator consumes the full fluid_usage_per_tick and any of the extra energy in the fluid (in the form of higher temperature) is wasted. The steam engine exhibits this behavior when fed steam from heat exchangers.
Template:Prototype property Animation runs at least this fast. This corresponds to the sound.
Template:Prototype property The power production of the generator is capped to this value. This is also the value that is shown as the maximum power output in the tooltip of the generator.
fluid_box must have a filter if this is not defined.