Types/MapGenPreset

2020-08-30T17:02:30Z

Maxreader: /* Optional properties */

== Basics ==
A map gen preset. Used in [[Prototype/MapGenPresets]].

== Mandatory properties ==

=== order ===
'''Type''': [[Types/Order]]

Specifies the ordering in the [[map generator]] gui.

== Optional properties ==

=== default ===
'''Type''': [[Types/bool]]

'''Default''': true

Whether this is the default preset. If set to true, this preset may not have any other properties besides this and order.

=== basic_settings ===
'''Type''': [https://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]

All properties can be omitted. If not set they will just use the default values. <code>seed</code> is ignored for a map gen preset.

==== terrain_segmentation ====
'''Type''': [[Types/MapGenSize]]

This is the inverse of "water scale" in the map generator GUI. So a water scale that shows as 50% in the GUI is a value of <code>1/0.5 = 2</code> for <code>terrain_segmentation</code>.

==== water ====
'''Type''': [[Types/MapGenSize]]

Shown as water coverage in the map generator GUI.

==== default_enable_all_autoplace_controls ====
'''Type''': [[Types/bool]]

'''Default''': true

If this is false, then all autoplace controls will be disabled.

==== autoplace_controls ====
'''Type''': [[Types/table]]

Table of [[Data.raw#autoplace-control]] name keys mapped to table values. Each table can have the following fields:
* frequency - [[Types/MapGenSize]]
* size - [[Types/MapGenSize]]
* richness - [[Types/MapGenSize]]

Example:

<syntaxhighlight lang="lua">autoplace_controls =
{
["iron-ore"] = { richness = 2, size = 0.5, frequency=2},
["enemy-base"] = { size = 1},
["trees"] = { richness = 4}
}</syntaxhighlight>

==== autoplace_settings ====
'''Type''': [[Types/table]]

==== property_expression_names ====
'''Type''': [[Types/table]]

Map of property name (e.g. "elevation") to name of noise expression that will provide it. Entries may be omitted. A notable usage is changing autoplace behavior of an entity based on the preset, which cannot be read from a noise expression.

==== starting_points ====
'''Type''': [[Types/table]] of [[Types/Position]]

Array of the positions of the starting areas.

==== seed ====
'''Type''': [[Types/uint32]]

Read by the game, but not used or set in the GUI.

==== width ====
'''Type''': [[Types/uint32]]

==== height ====
'''Type''': [[Types/uint32]]

==== starting_area ====
'''Type''': [[Types/MapGenSize]]

Size of the starting area. The starting area only effects enemy placement, and has no effect on resources.

==== peaceful_mode ====
'''Type''': [[Types/bool]]

==== cliff_settings ====
'''Type''': [https://lua-api.factorio.com/latest/Concepts.html#CliffPlacementSettings CliffPlacementSettings]

=== advanced_settings ===
'''Type''': [[Types/table]]

All properties can be omitted, if not set they will just use the existing values.

==== pollution ====
'''Type''': [[Types/table]]

{| class="wikitable"
|-
! Property name !! Type !! Comment
|-
| enabled || [[Types/bool]]
|-
| diffusion_ratio || [[Types/double]] || Must be <= 0.25.
|-
| ageing || [[Types/double]] || Also known as dissipation rate. Must be >= 0.5.
|-
| enemy_attack_pollution_consumption_modifier || [[Types/double]]
|-
| min_pollution_to_damage_trees || [[Types/double]]
|-
| pollution_restored_per_tree_damage || [[Types/double]]
|-
|}

==== enemy_evolution ====
'''Type''': [[Types/table]]

{| class="wikitable"
|-
! Property name !! Type
|-
| enabled || [[Types/bool]]
|-
| time_factor || [[Types/double]]
|-
| destroy_factor || [[Types/double]]
|-
| pollution_factor || [[Types/double]]
|-
|}

==== enemy_expansion ====
'''Type''': [[Types/table]]

{| class="wikitable"
|-
! Property name !! Type !! Comment
|-
| enabled || [[Types/bool]]
|-
| max_expansion_distance || [[Types/double]]
|-
| settler_group_min_size || [[Types/double]]
|-
| settler_group_max_size || [[Types/double]]
|-
| min_expansion_cooldown || [[Types/double]] || In ticks.
|-
| max_expansion_cooldown || [[Types/double]] || In ticks.
|-
|}

==== difficulty_settings ====
'''Type''': [[Types/table]]

{| class="wikitable"
|-
! Property name !! Type !! Comment
|-
| recipe_difficulty || [[Types/uint8]] || 0 is normal, 1 is expensive
|-
| technology_difficulty || [[Types/uint8]] || 0 is normal, 1 is expensive
|-
| technology_price_multiplier || [[Types/double]]
|-
| research_queue_setting || [[Types/string]] || Either "after-victory", "always" or "never".
|-
|}

Official Factorio Wiki - User contributions [en]

Types/MapGenPreset