Prototype/NamedNoiseExpression: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
m (Note that intended_property is how you make expressions show up in the map generator GUI)
m (Alternate expressions can be made available in the map generator GUI by blah blah blah)
Line 12: Line 12:
can override which named expression is used to calculate a given property by having an entry in
can override which named expression is used to calculate a given property by having an entry in
<code>property_expression_names</code>.  e.g. <code>elevation = "0.16-elevation"</code>
<code>property_expression_names</code>.  e.g. <code>elevation = "0.16-elevation"</code>
 
Alternate expressions can be made available in the map generator GUI by setting their
<code>intended_property</code> to the name of the property they should override.


== Mandatory properties ==
== Mandatory properties ==

Revision as of 21:18, 22 May 2019

Basics

Prototype type: noise-expression


A Types/NoiseExpression together with a name.

Named noise expressions are used to specify functions for elevation, temperature, moisture, aux, and cliffiness.

e.g. the "elevation" expression is used to calculate elevation for every point on a map.

MapGenSettings can override which named expression is used to calculate a given property by having an entry in property_expression_names. e.g. elevation = "0.16-elevation" Alternate expressions can be made available in the map generator GUI by setting their intended_property to the name of the property they should override.

Mandatory properties

Inherits all properties from Prototype.

expression

Type: Types/NoiseExpression

The expression itself.

Optional properties

intended_property

Type: Types/string

Names the property that this expression is intended to provide a value for, if any. This will make the expression show up as an option in the map generator GUI, unless it is the only expression with that intended property, in which case it will be hidden and selected by default.

For example if a noise expression is intended to be used as an alternative temperature generator, intended_property should be "temperature".

order

Type: Types/Order

Used to order alternative expressions in the map generator GUI. For a given property (e.g. 'temperature'), the NamedNoiseExpression with that property's name as its intended_property with the lowest order will be chosen as the default in the GUI.

If no order is specified, it defaults to "2000" if the property name matches the expression name (making it the 'technical default' generator for the property if none is specified in MapGenSettings), or "3000" otherwise. A generator defined with an order less than "2000" but with a unique name can thereby override the default generator used when creating a new map through the GUI without automatically overriding the 'technical default' generator, which is probably used by existing maps.