Official Factorio Wiki - User contributions [en]

Types/AutoplaceSpecification

2015-05-08T09:30:22Z

Dysoch: /* Dimensions */

{{Languages}}
Autoplace specification is used to determine which entities are placed when generating map.
Currently it is used for enemy bases, resources and other entities (trees, fishes, ...).

== General structure ==
Autoplace specification consists of a set of peaks that describe conditions for placing the entity and
several parameters.

== Properties ==

=== sharpness ===
'''Type''': [[Types/double]]

'''Default''': 0
[[File:sharpness.png|thumb|Example of sharpness filter with value 0.5]]

Parameter of the sharpness filter for post-processing probability of entity placement. Value of 0 disables the filter, with value 1, the filter is a step function centered around 0.5.
See [[#Probability_Calculation|Probability Calculation]].

=== max_probability ===
'''Type''': [[Types/double]]

'''Default''': 1

'''Since''': 0.9.0

Multiplier for output of the sharpness filter.
See [[#Probability_Calculation]].

=== tile_restriction ===
'''Type''': list of specifications, see below

'''Default''': empty list

'''Since''': 0.9.0

Restricts surfaces or transition the entity can appear on.

Contains list of specifications, each specification is a single [[Types/string]] with the ID of an allowed tile, or a
list of two [[Types/string]]s for entities allowed on transitions.

=== richness_base ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== richness_multiplier ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== control ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/AutoplaceControl|autoplace control]] that applies to this entity.

=== force ===
'''Type''': [[Types/string]]

'''Default''': "neutral"

'''Since''': 0.8.0

Force of the placed entity. One of "enemy", "player" or "neutral". Only matters for EntityWithForce or EntityWithOwner.

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

'''Default''': ""

'''Since''': 0.9.0

Order for placing the entity (has no effect when placing tiles). Entities whose order compares less are placed earlier (this influences placing multiple entities which collide with itself), from entities with equal order string only one with the highest probability is placed.

=== size_control_multiplier ===
''' Type''': [[Types/double]]

'''Default''': Magic. Based on sum of influences of noises.

'''Since''': 0.9.2

This value times the size control setting is added to influence right before sharpness filter.
Very small has a multiplier of -1, very big has 1.5.

=== peaks ===
'''Type''': list of [[#Autoplace Peaks]]

If this property is missing, then the whole autoplace specification is interpreted as a single peak

== Autoplace Peaks ==

=== influence ===
'''Type''': [[Types/double]]

'''Default''': 1

Influence multiplier.
See [[#Influence_Calculation]].

=== min_influence ===
'''Type''': [[Types/double]]

'''Default''': min double

Minimal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== max_influence ===
'''Type''': [[Types/double]]

'''Default''': max double

Maximal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== richness_influence ===
'''Type''': [[Types/double]]

'''Default''': 0

Bonus for influence multiplier when calculating richness.
See [[#Influence Calculation]].

=== noise_layer ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/NoiseLayer|noise layer]] to use for this peak.
If empty, then no noise is added to this peak.
See [[#Noise]].

=== noise_persistence ===
'''Type''': [[Types/double]]

'''Default''': 0.5

'''Min''': 0

'''Max''': 1

Persistence of the noise.
See [[#Noise]].

=== noise_octaves_difference ===
'''Type''': [[Types/int]]

'''Default''': 0

Difference between number of octaves of the world and of the noise.
See [[#Noise]]

=== *_optimal ===
'''Type''': [[Types/double]]

Optimal value of a tile property. If the property is close to this value, peak influence is 1.
See [[#Dimensions]].

=== *_range ===
'''Type''': [[Types/double]]

'''Default''': 0

Distance from the optimal parameters that is still considered optimal.
See [[#Dimensions]].

=== *_max_range ===
'''Type''': [[Types/double]]

Distance from the optimal parameters that get influence of -1.
See [[#Dimensions]].

=== *_top_property_limit ===
'''Type''': [[Types/double]]

'''Default''': max double

Limit distance from the optimum on a single (positive) side. This is pure magic.
See [[#Dimensions]].

== Dimensions ==
Peaks may reference a number of tile properties, specifying range of optimal values of the property
and a range over which it is interpolated to no effect.

Currently the properties are:
* starting_area_weight -- Number from 1 (inside starting area) to 0 (not influenced by starting area).
* roughness -- a number between -1.5 and 1.5 which describe roughness of the terrain. In 0.7.2 roughness is visible only on the edges of lakes (smooth vs jagged).
* elevation -- elevation of the terrain, up to 5000. Values smaller than 0 mean under water (elevation < 0 doesn't imply water tile, though)
* water -- amount of available water on tile. Very simple dependence on elevation for now.
* temperature -- average temperature on tile. Depends on elevation and some noise.
* tier_from_start -- Distance from start in starting area sizes, rounded to integers.

You can see sheets on the generation of trees, doodads, biomes, water and tiles on this page: [[AutoplaceSheets]]

== Influence Calculation ==
Influence of a peak is obtained by calculating a distance from each of its dimensions.
A sum of these individual distances is used as a distance from optimal conditions.

Based on this distance a peak gets influence between -1 and 1, which is then multiplied
by the noise function, if it is specified, and by the [[#influence|influence]] constant (or by [[#influence|influence]] + [[#richness_influence|richness_influence]]
if calculating richness).
Finally this value is clamped to a range between [[#min_influence|min_influence]] and [[#max_influence|max_influence]].

== Probability_Calculation ==
Probability of placing an entity at a given position is calculated as a sum of influences plus a [[#size_control_multiplier|bonus for autoplace control]], passed through a [[#sharpness|sharpening filter]]
and multiplied by [[#max_probability|max_probability]]

== Richness_Calculation ==
If an entity is to be placed at a position and it a resource or a part of an enemy base, then richness is calculated in the next step.
as sum of influences * [[#richness_multiplier|richness_multiplier]] + [[#richness_base|richness_base]].

Note, that when calculating richness, influences of individual peaks use [[#richness_influence|richness_influence]] bonus.

== Noise ==
A peak may have a noise multiplied with its influence.
Noise used is a 2D multioctave perlin noise ( http://freespace.virgin.net/hugo.elias/models/m_perlin.htm ).
Range of the noise is approximately from -1.5 to 1.5.

Factorio uses up to 256 different (non correlated) layers of perlin noise, a noise layer has to be defined as a prototype before use (see [[Prototype/NoiseLayer]]).

Intended use is to have noise layers separate for different types of objects that might appear (trees vs dry_trees vs enemy-bases).
Also it has proven useful not to mix peaks containing noise with peaks referencing tile properties.

== Controls ==
If the autoplace specification has a [[#control|control]] selected, then its influence is affected by the row in map generator gui.
Autoplace controls must be defined before use, see [[Prototype/AutoplaceControl]].

* Frequency -- If frequency is set to low, then it increases number of octaves for all noises in this specification
* Size -- Set to large adds a bonus to all the final influence, also very slightly increases number of octaves
* Richness -- Adds a simple multiplier to richness.

In case you are wondering why we can "very slightly increase number of octaves" and not just add whole octaves, it is because we sacrificed a goat to gods of computer graphics and to Ken Perlin in particular.

File:Water.png

2015-05-08T09:21:25Z

Dysoch: Dysoch uploaded a new version of "File:Water.png": Reverted to version as of 20:36, 31 March 2014

File:Water.png

2015-05-08T09:20:48Z

Dysoch: Dysoch uploaded a new version of "File:Water.png"

Types/AutoplaceSpecification

2015-05-08T09:19:24Z

Dysoch: /* Dimensions */

{{Languages}}
Autoplace specification is used to determine which entities are placed when generating map.
Currently it is used for enemy bases, resources and other entities (trees, fishes, ...).

== General structure ==
Autoplace specification consists of a set of peaks that describe conditions for placing the entity and
several parameters.

== Properties ==

=== sharpness ===
'''Type''': [[Types/double]]

'''Default''': 0
[[File:sharpness.png|thumb|Example of sharpness filter with value 0.5]]

Parameter of the sharpness filter for post-processing probability of entity placement. Value of 0 disables the filter, with value 1, the filter is a step function centered around 0.5.
See [[#Probability_Calculation|Probability Calculation]].

=== max_probability ===
'''Type''': [[Types/double]]

'''Default''': 1

'''Since''': 0.9.0

Multiplier for output of the sharpness filter.
See [[#Probability_Calculation]].

=== tile_restriction ===
'''Type''': list of specifications, see below

'''Default''': empty list

'''Since''': 0.9.0

Restricts surfaces or transition the entity can appear on.

Contains list of specifications, each specification is a single [[Types/string]] with the ID of an allowed tile, or a
list of two [[Types/string]]s for entities allowed on transitions.

=== richness_base ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== richness_multiplier ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== control ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/AutoplaceControl|autoplace control]] that applies to this entity.

=== force ===
'''Type''': [[Types/string]]

'''Default''': "neutral"

'''Since''': 0.8.0

Force of the placed entity. One of "enemy", "player" or "neutral". Only matters for EntityWithForce or EntityWithOwner.

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

'''Default''': ""

'''Since''': 0.9.0

Order for placing the entity (has no effect when placing tiles). Entities whose order compares less are placed earlier (this influences placing multiple entities which collide with itself), from entities with equal order string only one with the highest probability is placed.

=== size_control_multiplier ===
''' Type''': [[Types/double]]

'''Default''': Magic. Based on sum of influences of noises.

'''Since''': 0.9.2

This value times the size control setting is added to influence right before sharpness filter.
Very small has a multiplier of -1, very big has 1.5.

=== peaks ===
'''Type''': list of [[#Autoplace Peaks]]

If this property is missing, then the whole autoplace specification is interpreted as a single peak

== Autoplace Peaks ==

=== influence ===
'''Type''': [[Types/double]]

'''Default''': 1

Influence multiplier.
See [[#Influence_Calculation]].

=== min_influence ===
'''Type''': [[Types/double]]

'''Default''': min double

Minimal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== max_influence ===
'''Type''': [[Types/double]]

'''Default''': max double

Maximal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== richness_influence ===
'''Type''': [[Types/double]]

'''Default''': 0

Bonus for influence multiplier when calculating richness.
See [[#Influence Calculation]].

=== noise_layer ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/NoiseLayer|noise layer]] to use for this peak.
If empty, then no noise is added to this peak.
See [[#Noise]].

=== noise_persistence ===
'''Type''': [[Types/double]]

'''Default''': 0.5

'''Min''': 0

'''Max''': 1

Persistence of the noise.
See [[#Noise]].

=== noise_octaves_difference ===
'''Type''': [[Types/int]]

'''Default''': 0

Difference between number of octaves of the world and of the noise.
See [[#Noise]]

=== *_optimal ===
'''Type''': [[Types/double]]

Optimal value of a tile property. If the property is close to this value, peak influence is 1.
See [[#Dimensions]].

=== *_range ===
'''Type''': [[Types/double]]

'''Default''': 0

Distance from the optimal parameters that is still considered optimal.
See [[#Dimensions]].

=== *_max_range ===
'''Type''': [[Types/double]]

Distance from the optimal parameters that get influence of -1.
See [[#Dimensions]].

=== *_top_property_limit ===
'''Type''': [[Types/double]]

'''Default''': max double

Limit distance from the optimum on a single (positive) side. This is pure magic.
See [[#Dimensions]].

== Dimensions ==
Peaks may reference a number of tile properties, specifying range of optimal values of the property
and a range over which it is interpolated to no effect.

Currently the properties are:
* starting_area_weight -- Number from 1 (inside starting area) to 0 (not influenced by starting area).
* roughness -- a number between -1.5 and 1.5 which describe roughness of the terrain. In 0.7.2 roughness is visible only on the edges of lakes (smooth vs jagged).
* elevation -- elevation of the terrain, up to 5000. Values smaller than 0 mean under water (elevation < 0 doesn't imply water tile, though)
* water -- amount of available water on tile. Very simple dependence on elevation for now.
* temperature -- average temperature on tile. Depends on elevation and some noise.
* tier_from_start -- Distance from start in starting area sizes, rounded to integers.

You can see sheets on the generation of trees, doodads, biomes, water and tiles on this page: [[Types/AutoplaceSheets]]

== Influence Calculation ==
Influence of a peak is obtained by calculating a distance from each of its dimensions.
A sum of these individual distances is used as a distance from optimal conditions.

Based on this distance a peak gets influence between -1 and 1, which is then multiplied
by the noise function, if it is specified, and by the [[#influence|influence]] constant (or by [[#influence|influence]] + [[#richness_influence|richness_influence]]
if calculating richness).
Finally this value is clamped to a range between [[#min_influence|min_influence]] and [[#max_influence|max_influence]].

== Probability_Calculation ==
Probability of placing an entity at a given position is calculated as a sum of influences plus a [[#size_control_multiplier|bonus for autoplace control]], passed through a [[#sharpness|sharpening filter]]
and multiplied by [[#max_probability|max_probability]]

== Richness_Calculation ==
If an entity is to be placed at a position and it a resource or a part of an enemy base, then richness is calculated in the next step.
as sum of influences * [[#richness_multiplier|richness_multiplier]] + [[#richness_base|richness_base]].

Note, that when calculating richness, influences of individual peaks use [[#richness_influence|richness_influence]] bonus.

== Noise ==
A peak may have a noise multiplied with its influence.
Noise used is a 2D multioctave perlin noise ( http://freespace.virgin.net/hugo.elias/models/m_perlin.htm ).
Range of the noise is approximately from -1.5 to 1.5.

Factorio uses up to 256 different (non correlated) layers of perlin noise, a noise layer has to be defined as a prototype before use (see [[Prototype/NoiseLayer]]).

Intended use is to have noise layers separate for different types of objects that might appear (trees vs dry_trees vs enemy-bases).
Also it has proven useful not to mix peaks containing noise with peaks referencing tile properties.

== Controls ==
If the autoplace specification has a [[#control|control]] selected, then its influence is affected by the row in map generator gui.
Autoplace controls must be defined before use, see [[Prototype/AutoplaceControl]].

* Frequency -- If frequency is set to low, then it increases number of octaves for all noises in this specification
* Size -- Set to large adds a bonus to all the final influence, also very slightly increases number of octaves
* Richness -- Adds a simple multiplier to richness.

In case you are wondering why we can "very slightly increase number of octaves" and not just add whole octaves, it is because we sacrificed a goat to gods of computer graphics and to Ken Perlin in particular.

Types/AutoplaceSpecification

2015-05-08T09:18:07Z

Dysoch: /* Dimensions */

{{Languages}}
Autoplace specification is used to determine which entities are placed when generating map.
Currently it is used for enemy bases, resources and other entities (trees, fishes, ...).

== General structure ==
Autoplace specification consists of a set of peaks that describe conditions for placing the entity and
several parameters.

== Properties ==

=== sharpness ===
'''Type''': [[Types/double]]

'''Default''': 0
[[File:sharpness.png|thumb|Example of sharpness filter with value 0.5]]

Parameter of the sharpness filter for post-processing probability of entity placement. Value of 0 disables the filter, with value 1, the filter is a step function centered around 0.5.
See [[#Probability_Calculation|Probability Calculation]].

=== max_probability ===
'''Type''': [[Types/double]]

'''Default''': 1

'''Since''': 0.9.0

Multiplier for output of the sharpness filter.
See [[#Probability_Calculation]].

=== tile_restriction ===
'''Type''': list of specifications, see below

'''Default''': empty list

'''Since''': 0.9.0

Restricts surfaces or transition the entity can appear on.

Contains list of specifications, each specification is a single [[Types/string]] with the ID of an allowed tile, or a
list of two [[Types/string]]s for entities allowed on transitions.

=== richness_base ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== richness_multiplier ===
'''Type''': [[Types/double]]

'''Default''': 0

See [[#Richness_Calculation]].

=== control ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/AutoplaceControl|autoplace control]] that applies to this entity.

=== force ===
'''Type''': [[Types/string]]

'''Default''': "neutral"

'''Since''': 0.8.0

Force of the placed entity. One of "enemy", "player" or "neutral". Only matters for EntityWithForce or EntityWithOwner.

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

'''Default''': ""

'''Since''': 0.9.0

Order for placing the entity (has no effect when placing tiles). Entities whose order compares less are placed earlier (this influences placing multiple entities which collide with itself), from entities with equal order string only one with the highest probability is placed.

=== size_control_multiplier ===
''' Type''': [[Types/double]]

'''Default''': Magic. Based on sum of influences of noises.

'''Since''': 0.9.2

This value times the size control setting is added to influence right before sharpness filter.
Very small has a multiplier of -1, very big has 1.5.

=== peaks ===
'''Type''': list of [[#Autoplace Peaks]]

If this property is missing, then the whole autoplace specification is interpreted as a single peak

== Autoplace Peaks ==

=== influence ===
'''Type''': [[Types/double]]

'''Default''': 1

Influence multiplier.
See [[#Influence_Calculation]].

=== min_influence ===
'''Type''': [[Types/double]]

'''Default''': min double

Minimal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== max_influence ===
'''Type''': [[Types/double]]

'''Default''': max double

Maximal influence (after all calculations) of current peak.
See [[#Influence Calculation]].

=== richness_influence ===
'''Type''': [[Types/double]]

'''Default''': 0

Bonus for influence multiplier when calculating richness.
See [[#Influence Calculation]].

=== noise_layer ===
'''Type''': [[Types/string]]

'''Default''': ""

ID of [[Prototype/NoiseLayer|noise layer]] to use for this peak.
If empty, then no noise is added to this peak.
See [[#Noise]].

=== noise_persistence ===
'''Type''': [[Types/double]]

'''Default''': 0.5

'''Min''': 0

'''Max''': 1

Persistence of the noise.
See [[#Noise]].

=== noise_octaves_difference ===
'''Type''': [[Types/int]]

'''Default''': 0

Difference between number of octaves of the world and of the noise.
See [[#Noise]]

=== *_optimal ===
'''Type''': [[Types/double]]

Optimal value of a tile property. If the property is close to this value, peak influence is 1.
See [[#Dimensions]].

=== *_range ===
'''Type''': [[Types/double]]

'''Default''': 0

Distance from the optimal parameters that is still considered optimal.
See [[#Dimensions]].

=== *_max_range ===
'''Type''': [[Types/double]]

Distance from the optimal parameters that get influence of -1.
See [[#Dimensions]].

=== *_top_property_limit ===
'''Type''': [[Types/double]]

'''Default''': max double

Limit distance from the optimum on a single (positive) side. This is pure magic.
See [[#Dimensions]].

== Dimensions ==
Peaks may reference a number of tile properties, specifying range of optimal values of the property
and a range over which it is interpolated to no effect.

Currently the properties are:
* starting_area_weight -- Number from 1 (inside starting area) to 0 (not influenced by starting area).
* roughness -- a number between -1.5 and 1.5 which describe roughness of the terrain. In 0.7.2 roughness is visible only on the edges of lakes (smooth vs jagged).
* elevation -- elevation of the terrain, up to 5000. Values smaller than 0 mean under water (elevation < 0 doesn't imply water tile, though)
* water -- amount of available water on tile. Very simple dependence on elevation for now.
* temperature -- average temperature on tile. Depends on elevation and some noise.
* tier_from_start -- Distance from start in starting area sizes, rounded to integers.

You can see sheets on the generation of trees, doodads, biomes, water and tiles on this page: [AutoplaceSheets]

== Influence Calculation ==
Influence of a peak is obtained by calculating a distance from each of its dimensions.
A sum of these individual distances is used as a distance from optimal conditions.

Based on this distance a peak gets influence between -1 and 1, which is then multiplied
by the noise function, if it is specified, and by the [[#influence|influence]] constant (or by [[#influence|influence]] + [[#richness_influence|richness_influence]]
if calculating richness).
Finally this value is clamped to a range between [[#min_influence|min_influence]] and [[#max_influence|max_influence]].

== Probability_Calculation ==
Probability of placing an entity at a given position is calculated as a sum of influences plus a [[#size_control_multiplier|bonus for autoplace control]], passed through a [[#sharpness|sharpening filter]]
and multiplied by [[#max_probability|max_probability]]

== Richness_Calculation ==
If an entity is to be placed at a position and it a resource or a part of an enemy base, then richness is calculated in the next step.
as sum of influences * [[#richness_multiplier|richness_multiplier]] + [[#richness_base|richness_base]].

Note, that when calculating richness, influences of individual peaks use [[#richness_influence|richness_influence]] bonus.

== Noise ==
A peak may have a noise multiplied with its influence.
Noise used is a 2D multioctave perlin noise ( http://freespace.virgin.net/hugo.elias/models/m_perlin.htm ).
Range of the noise is approximately from -1.5 to 1.5.

Factorio uses up to 256 different (non correlated) layers of perlin noise, a noise layer has to be defined as a prototype before use (see [[Prototype/NoiseLayer]]).

Intended use is to have noise layers separate for different types of objects that might appear (trees vs dry_trees vs enemy-bases).
Also it has proven useful not to mix peaks containing noise with peaks referencing tile properties.

== Controls ==
If the autoplace specification has a [[#control|control]] selected, then its influence is affected by the row in map generator gui.
Autoplace controls must be defined before use, see [[Prototype/AutoplaceControl]].

* Frequency -- If frequency is set to low, then it increases number of octaves for all noises in this specification
* Size -- Set to large adds a bonus to all the final influence, also very slightly increases number of octaves
* Richness -- Adds a simple multiplier to richness.

In case you are wondering why we can "very slightly increase number of octaves" and not just add whole octaves, it is because we sacrificed a goat to gods of computer graphics and to Ken Perlin in particular.

Mods

2014-04-07T07:05:26Z

Dysoch:

== List of user made mods ==

This is only the tip of the iceberg! '''A more or less complete list of mods is in the [http://www.factorioforums.com/forum/viewforum.php?f=14 Mods forum].'''

You are invited to add other mods to this list! See down how.

{| class="wikitable sortable"
|-
! Mod !! Latest release !! Compatible with Factorio !! Author !! Dependencies !! Link to Forum/Download page !! Additional notes/Info
|-
| {{subpage|DyTech}} || 2.0.0 || 0.9.7+ || Dysoch || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1563] || Usage together with Inserter mod is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|F-mod}} || 1.8 || 0.8.x || ficolas || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=390] || --
|-
| {{subpage|Inserters}} || 1.0.1 || 0.8.x || Heinrich, but maintained by Dysoch || base >= 0.7.1, ?DyTech || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1631] || Usage together with DyTech is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|Treefarm}} || 0.8.4 || 0.8.x || drs9999 || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=522] || this mod add treefarm,cokery + woodprocessing and fertilizer
|}

== Dependencies? ==
Dependencies are used to tell the game what order mods should be loaded. A mod that has dependency gets loaded after the mod it depends. The mod will not be active if it has dependency to a mod that is missing, disabled (by user) or invalid (by dependency of depended mod)

*'''base''' is the default game data that comes with Factorio.
[[Modding_overview#Mod_meta_information]]

== How to use mods ==

Using the mods is very easy.

# Download the mod you would like and unzip it.
# Copy the mod into the game's mods directory. Mods directory locations depends on your operating system.
#* Windows: C:\Program Files\Factorio\mods
#* OSx: ~/Library/Application Support/factorio/mods
#* Linux: ~/.factorio/mods
# Run the game
# Open the Mods menu and make sure the mod is enabled (requires restart on changes)
# Enjoy your installed mod

== How to add my/another mod into this page? ==

Two possibilities:
# become user of the wiki (get an account) and add it. You can use the {{subpage|ExampleMod}}, to see, how you can structure the information about your own mod!
# ask in the forum, if someone would add it

== Subpages ==

{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

Factorio:Wiki rules

2014-04-05T23:33:28Z

Dysoch: /* Pictures */

This page is used for contributors into this wiki.

== Get an account ==

Just follow the instruction.

== How to contribute? ==

This wiki is the work of a team of some people. The wiki is created in an agile process. If someone asks something in the forum, it's a good idea to add it into the forum. No special knowledge is needed for that, just write and if it is ok, this information stars, otherwise it will be changed or removed by others. There is nothing, which you can break, because the wiki has a version history.

== Basic ==
* Read the wiki pages.
** If you don't like something, change it.
** If you find typos, change it.
** If you find something is wrong described, make a prove, that it is wrong and change it.

== Advanced ==

* Add missing information it at the right place.

This is in most cases easy, but sometimes could be really difficult. Ask for help, if you don't know.

* Split the information on big pages into subpages.

See for example the [[Railway network]].

* If you find that a topic belongs to two pages, then don't copy the information into the two pages, but create a new page and link.

Best example for this is the [[Power production]] page.

* Take the right words.

Factorio has a set of words, which have a fixed meaning. Ask the factorio wiki, if you are unsure.

* A pic says more than 1000 words.

Make pictures, if possible. In some case use GIF-animations! See down.

== Pictures ==

=== Making pictures out of the game ===

Do's:

* make pictures at day! [[Lua/Game#alwaysday|Turn on daylight]]! Use night or dawn only, if needed to explain something.
* use god mode! [[Lua/Player#controllertype]]. You can go to every place and don't stand in the way.
* you can [[Lua/Game#speed|slowdown the game]] to find the right moment for the picture.
* you can use also the [[Lua/Game#peacefulmode]], to be not disturbed by the natives.
* you can stop the game in the right moment using SHIFT-SPACE key. That blends also the grid in.
* learn how to use the [[Debug mode]] to add relevant information into this pic.
* go into the highest zoom level you possibly can.

Dont's

* don't make pics of ultra-complicated stuff! Add only as much elements, which are needed to understand, how that might work.
* don't make just a screenshot. Try to remove all unneeded informations from the pic.
* try not to make a photo with the character, except it should show something, facing to it.

See http://www.factorioforums.com/forum/viewtopic.php?f=6&t=2472 for more.

=== Optimizing the picture before upload ===

* cut as much as possible/nice.
* resolution should be normally not higher than 800x800 px.
* do not add textual information into the pics! Instead add numbers or letters in it and add the text on the wiki-page. Otherwise it isn't searchable information.

=== Making animations ===

: [http://blog.bahraniapps.com/?page_id=21 Gifcam]

Prototype/MiningDrill

2014-02-17T23:56:53Z

Dysoch: /* resource_searching_radius */

== Basics ==
A mining drill. Based on [[Prototype/EntityWithHealth]].

== Properties ==

This prototype inherits the properties of [[Prototype/EntityWithHealth]].

=== animations ===
Type: Map of [[Types/string]] -> [[Types/Animation]]

The animations to use. Should look like this:

<pre>
animations = {
north = {
... animation goes here ...
},
south = {
... animation goes here ...
},
east = {
... animation goes here ...
},
west = {
... animation goes here ...
}
}
</pre>

=== mining_speed ===
Type: [[Types/double]]

The speed of this drill. Electric mining drills have 0.5. Burner mining drills have 0.35.

=== energy_source ===
Type: [[Types/EnergySource]]

The energy source of this mining drill.

=== energy_usage ===
Type: [[Types/EnergyPower]]

The amount of energy used by the drill while mining.

=== mining_power ===
Type: [[Types/double]]

Unknown. Burner mining drills have 3.5. Electric mining drills have 3.

=== resource_searching_radius ===
Type: [[Types/double]]

The distance from the centre of the mining drill to search for resources in.

This is 2.49 for electric mining drills (a 5x5 area) and 0.99 for burner mining drills (a 2x2 area). There is presumably a reason that these are not 2.5 and 1.0.

(Dysoch) The reason is that it searches resource outside its natural boundary box, which is 0.01. (the middle of the entity) making it 2.5 and 1.0 gives it another block radius

=== vector_to_place_result ===
Type: [[Types/vector]]

The position where the result is placed, when the mining drill is facing south (?).

=== module_slots ===
Type: [[Types/unsigned]]

The number of module slots.

=== radius_visualization_picture ===
Type: [[Types/Sprite]]

The sprite used to show the range of the mining drill.

User:Dysoch

2014-01-19T15:37:20Z

Dysoch:

Mods

2014-01-16T14:21:05Z

Dysoch:

== List of user made mods ==

Process not defined. Please look into the discussion [[Talk:Mods]].

{| class="wikitable sortable"
|-
! Mod !! Latest release !! Compatible with Factorio !! Author !! Dependencies !! Link to Forum/Download page !! Additional notes/Info
|-
| {{subpage|DyTech}} || 1.4.0 || 0.8.4 and above || Dysoch || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1563] || Usage together with Inserter mod is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|F-mod}} || 1.7.2 || 0.8.x || ficolas || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=390] || --
|-
| {{subpage|Inserters}} || 1.0.1 || 0.8.x || Heinrich, but maintained by Dysoch || base >= 0.7.1, ?DyTech || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1631] || Usage together with DyTech is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|Treefarm}} || 0.8.4 || 0.8.x || drs9999 || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=522] || this mod add treefarm,cokery + woodprocessing and fertilizer
|}

Use the {{subpage|ExampleMod}}, to see, how you can structure the information about your own mod!

== Dependencies? ==
Dependencies are used to tell the game what order mods should be loaded. A mod that has dependency gets loaded after the mod it depends. The mod will not be active if it has dependency to a mod that is missing, disabled (by user) or invalid (by dependency of depended mod)

*'''base''' is the default game data that comes with Factorio.
[[Modding_overview#Mod_meta_information]]

== How to use mods ==

Using the mods is very easy.

# Download the mod you would like and unzip it.
# Copy the mod into the game's mods directory. Mods directory locations depends on your operating system.
#* Windows: C:\Program Files\Factorio\mods
#* OSx: ~/Library/Application Support/factorio/mods
#* Linux: ~/.factorio/mods
# Run the game
# Open the Mods menu and make sure the mod is enabled (requires restart on changes)
# Enjoy your installed mod

== Subpages ==

{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

Mods

2013-12-24T22:06:10Z

Dysoch:

== List of user made mods ==

Process not defined. Please look into the discussion [[Talk:Mods]].

{| class="wikitable sortable"
|-
! Mod !! Latest release !! Compatible with Factorio !! Author !! Dependencies !! Link to Forum/Download page !! Additional notes/Info
|-
| {{subpage|DyTech}} || 1.1.0 || 0.8.x || Dysoch || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1563] || Usage together with Inserter mod is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|F-mod}} || 1.6.6 || 0.7.x || ficolas || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=390] || --
|-
| {{subpage|Inserters}} || 1.0.1 || 0.8.x || Heinrich, but maintained by Dysoch || base >= 0.7.1, ?DyTech || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1631] || Usage together with DyTech is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| {{subpage|ExampleMod}} || 0.1 || 0.0.1 || [[User:Ssilk]] and others || base || [http://www.factorioforums.com/forum/] || you may use this {{subpage|ExampleMod|template}} to create a new mod
|}

== Dependencies? ==
Dependencies are used to tell the game what order mods should be loaded. A mod that has dependency gets loaded after the mod it depends. The mod will not be active if it has dependency to a mod that is missing, disabled (by user) or invalid (by dependency of depended mod)

*'''base''' is the default game data that comes with Factorio.
[[Modding_overview#Mod_meta_information]]

== How to use mods ==

Using the mods is very easy.

# Download the mod you would like and unzip it.
# Copy the mod into the game's mods directory. Mods directory locations depends on your operating system.
#* Windows: C:\Program Files\Factorio\mods
#* OSx: ~/Library/Application Support/factorio/mods
#* Linux: ~/.factorio/mods
# Run the game
# Open the Mods menu and make sure the mod is enabled (requires restart on changes)
# Enjoy your installed mod

== Subpages ==

{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

Mods

2013-12-12T09:41:02Z

Dysoch:

== List of user made mods ==

Process not defined. Please look into the discussion [[Talk:Mods]].

{| class="wikitable sortable"
|-
! Mod !! Latest release !! Compatible with Factorio !! Author !! Dependencies !! Link to Forum/Download page !! Additional notes/Info
|-
| [[Mods/DyTech|DyTech]] || 1.0.2 || 0.8.x || Dysoch || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1563] || Usage together with Inserter mod is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| [[Mods/F-mod|F-mod]] || 1.6.6 || 0.7.x || ficolas || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=390] || --
|-
| [[Mods/Inserters|Inserters]] || 1.0.1 || 0.8.x || Heinrich, but maintained by Dysoch || base >= 0.7.1, ?DyTech || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1631] || Usage together with DyTech is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| [[Mods/ExampleMod|ExampleMod]] || 0.1 || 0.0.1 || [[User:Ssilk]] and others || base || [http://www.factorioforums.com/forum/] || you may use this [[Mods:ExampleMod|template]] to create a new mod
|}

== Dependencies? ==
Dependencies are used to tell the game what order mods should be loaded. A mod that has dependency gets loaded after the mod it depends. The mod will not be active if it has dependency to a mod that is missing, disabled (by user) or invalid (by dependency of depended mod)

*'''base''' is the default game data that comes with Factorio.
[[Modding_overview#Mod_meta_information]]

== How to use mods ==

Using the mods is very easy.

# Download the mod you would like and unzip it.
# Copy the mod into the game's mods directory. Mods directory locations depends on your operating system.
#* Windows: C:\Program Files\Factorio\mods
#* OSx: ~/Library/Application Support/factorio/mods
#* Linux: ~/.factorio/mods
# Run the game
# Open the Mods menu and make sure the mod is enabled (requires restart on changes)
# Enjoy your installed mod

== Subpages ==

{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

Mods

2013-12-12T00:21:12Z

Dysoch:

== List of user made mods ==

Process not defined. Please look into the discussion [[Talk:Mods]].

{| class="wikitable sortable"
|-
! Mod !! Latest release !! Compatible with Factorio !! Author !! Dependencies !! Link to Forum/Download page !! Additional notes/Info
|-
| [[Mods/DyTech|DyTech]] || 1.0.1 || 0.8.x || Dysoch || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1563] || Usage together with Inserter mod is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| [[Mods/F-mod|F-mod]] || 1.6.6 || 0.7.x || ficolas || base || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=390] || --
|-
| [[Mods/Inserters|Inserters]] || 1.0.1 || 0.8.x || Heinrich, but maintained by Dysoch || base >= 0.7.1, ?DyTech || [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=1631] || Usage together with DyTech is not recommended! Inserter Mod doesnt add anything when detecting DyTech, Dytech has better and other inserters added!
|-
| [[Mods/ExampleMod|ExampleMod]] || 0.1 || 0.0.1 || [[User:Ssilk]] and others || base || [http://www.factorioforums.com/forum/] || you may use this [[Mods:ExampleMod|template]] to create a new mod
|}

== Dependencies? ==
Dependencies are used to tell the game what order mods should be loaded. A mod that has dependency gets loaded after the mod it depends. The mod will not be active if it has dependency to a mod that is missing, disabled (by user) or invalid (by dependency of depended mod)

*'''base''' is the default game data that comes with Factorio.
[[Modding_overview#Mod_meta_information]]

== How to use mods ==

Using the mods is very easy.

# Download the mod you would like and unzip it.
# Copy the mod into the game's mods directory. Mods directory locations depends on your operating system.
#* Windows: C:\Program Files\Factorio\mods
#* OSx: ~/Library/Application Support/factorio/mods
#* Linux: ~/.factorio/mods
# Run the game
# Open the Mods menu and make sure the mod is enabled (requires restart on changes)
# Enjoy your installed mod

== Subpages ==

{{Special:PrefixIndex/{{FULLPAGENAME}}/}}