Factorio.com|Forums|Wiki|Mod Portal|API Docs

# Factorio Prototype Docs Version 2.0.77

# MapGenSettings - Prototype Docs

## MapGenSettings :: struct

## Properties

- default
- sorted

default_enable_all_autoplace_controls optional | :: boolean | Whether undefined `autoplace_controls` should fall back to the default controls or not.
Whether undefined `autoplace_controls` should fall back to the default controls or not.
autoplace_controls optional | :: dictionary[AutoplaceControlID → FrequencySizeRichness] |
autoplace_settings optional | :: dictionary[`"entity"` or `"tile"` or `"decorative"` → AutoplaceSettings] | Each setting in this table maps the string type to the settings for that type.
Each setting in this table maps the string type to the settings for that type.
property_expression_names optional | :: dictionary[string → string or boolean or double] | Map of property name (`"elevation"`, etc) to name of noise expression that will provide it. [...]
Map of property name (`"elevation"`, etc) to name of noise expression that will provide it. [...]
starting_points optional | :: array[MapPosition] | Array of the positions of the starting areas.
Array of the positions of the starting areas.
seed optional | :: uint32 | Read by the game, but not used or set in the GUI.
Read by the game, but not used or set in the GUI.
width optional | :: uint32 | Width of the map in tiles. [...]
Width of the map in tiles. [...]
height optional | :: uint32 | Height of the map in tiles. [...]
Height of the map in tiles. [...]
starting_area optional | :: MapGenSize | Size of the starting area. [...]
Size of the starting area. [...]
peaceful_mode optional | :: boolean | If true, enemy creatures will not attack unless the player first attacks them.
If true, enemy creatures will not attack unless the player first attacks them.
no_enemies_mode optional | :: boolean | If true, enemy creatures will not naturally spawn from spawners, map gen, or trigger effects.
If true, enemy creatures will not naturally spawn from spawners, map gen, or trigger effects.
cliff_settings optional | :: CliffPlacementSettings |
territory_settings optional | :: TerritorySettings |

autoplace_controls optional | :: dictionary[AutoplaceControlID → FrequencySizeRichness] |
autoplace_settings optional | :: dictionary[`"entity"` or `"tile"` or `"decorative"` → AutoplaceSettings] | Each setting in this table maps the string type to the settings for that type.
Each setting in this table maps the string type to the settings for that type.
cliff_settings optional | :: CliffPlacementSettings |
default_enable_all_autoplace_controls optional | :: boolean | Whether undefined `autoplace_controls` should fall back to the default controls or not.
Whether undefined `autoplace_controls` should fall back to the default controls or not.
height optional | :: uint32 | Height of the map in tiles. [...]
Height of the map in tiles. [...]
no_enemies_mode optional | :: boolean | If true, enemy creatures will not naturally spawn from spawners, map gen, or trigger effects.
If true, enemy creatures will not naturally spawn from spawners, map gen, or trigger effects.
peaceful_mode optional | :: boolean | If true, enemy creatures will not attack unless the player first attacks them.
If true, enemy creatures will not attack unless the player first attacks them.
property_expression_names optional | :: dictionary[string → string or boolean or double] | Map of property name (`"elevation"`, etc) to name of noise expression that will provide it. [...]
Map of property name (`"elevation"`, etc) to name of noise expression that will provide it. [...]
seed optional | :: uint32 | Read by the game, but not used or set in the GUI.
Read by the game, but not used or set in the GUI.
starting_area optional | :: MapGenSize | Size of the starting area. [...]
Size of the starting area. [...]
starting_points optional | :: array[MapPosition] | Array of the positions of the starting areas.
Array of the positions of the starting areas.
territory_settings optional | :: TerritorySettings |
width optional | :: uint32 | Width of the map in tiles. [...]
Width of the map in tiles. [...]

## Properties

### default_enable_all_autoplace_controls :: boolean optional

Default: `true`

Whether undefined `autoplace_controls` should fall back to the default controls or not.

### autoplace_controls :: dictionary[AutoplaceControlID → FrequencySizeRichness] optional

### autoplace_settings :: dictionary[`"entity"` or `"tile"` or `"decorative"` → AutoplaceSettings] optional

Each setting in this table maps the string type to the settings for that type.

### property_expression_names :: dictionary[string → string or boolean or double] optional

Map of property name (`"elevation"`, etc) 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 :: array[MapPosition] optional

Array of the positions of the starting areas.

### seed :: uint32 optional

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

### width :: uint32 optional

Width of the map in tiles. Silently limited to 2 000 000, ie. +/- 1 million tiles from the center in both directions.

### height :: uint32 optional

Height of the map in tiles. Silently limited to 2 000 000, ie. +/- 1 million tiles from the center in both directions.

### starting_area :: MapGenSize optional

Default: `1`

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

### peaceful_mode :: boolean optional

If true, enemy creatures will not attack unless the player first attacks them.

### no_enemies_mode :: boolean optional

If true, enemy creatures will not naturally spawn from spawners, map gen, or trigger effects.

### cliff_settings :: CliffPlacementSettings optional

### territory_settings :: TerritorySettings optional

Type used in

- MapGenPreset::basic_settings