Official Factorio Wiki - User contributions [en]

Mod portal API

2026-01-09T19:49:25Z

CodeGreen:

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal|Internal API]]</div>

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

To get even more information about a mod, you can use the following URL.

<code>https://mods.factorio.com/api/mods/{name}/full</code>

List of bookmarked mods can be accessed from following URL (requires authentication).

<code>https://mods.factorio.com/api/bookmarks?username={username}&token={token}</code>

You can also toggle a bookmark using following URL, with <code>state</code> being <code>on</code> or <code>off</code>.

<code>https://mods.factorio.com/api/bookmarks/toggle?username={username}&token={token}&mod={name}&state={state}</code>

== Endpoints ==

=== /api/mods ===

GET Parameters (sent as query parameters):

{| class="wikitable"
! Key !! Values !! Description
|-
| hide_deprecated || {boolean} || Only return non-deprecated mods.
|-
| page ||{an integer}||Page number you would like to show. Makes it so you can see a certain part of the list without getting detail on all
|-
| page_size ||{an integer or 'max'}||The amount of results to show in your search
|-
| sort || {enum, one of name, created_at or updated_at} || Sort results by this property. Defaults to name when not defined. Ignored for <code>page_size=max</code> queries.
|-
| sort_order || {enum, one of asc or desc} || Sort results ascending or descending. Defaults to descending when not defined. Ignored for <code>page_size=max</code> queries.
|-
| namelist || {array of strings} || Return only mods that match the given names. Either comma-separated names or supply the namelist parameter more than once. Response will include <code>releases</code> instead of <code>latest_release</code>.
|-
| version || {enum, one of 0.13, 0.14, 0.15, 0.16, 0.17, 0.18, 1.0, 1.1 or 2.0} || Only return non-deprecated mods compatible with this Factorio version
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

Return short information of a specific mod.

See [[#Result Entry]], "Short" column.

=== /api/mods/{mod_name}/full ===

Returns more information of a mod.

See [[#Result Entry]], "Full" column.

=== /api/bookmarks ===

Returns array of mod names

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "api/mods endpoint" column, those returned by the api/mods/{name} endpoint are marked with a check in the "Short" column and those returned by the api/mods/{name}/full endpoint are marked in the "Full" column. Fields may be absent if there is no data.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | api/mods endpoint !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| latest_release || [[#Releases|Release]]? || ✓ || ||
| The latest version of the mod available for download. Absent when the <code>namelist</code> [[#/api/mods|parameter]] is used.
|-
| downloads_count || Integer || ✓ || ✓ || ✓
| Number of downloads.
|-
| name || String || ✓ || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓ || ✓
| The Factorio username of the mod's author.
|-
| releases || [[#Releases|Release]][] || ✓* || ✓ || ✓
| A list of different versions of the mod available for download. See [[#Releases]]. *Only when using <code>namelist</code> [[#/api/mods|parameter]].
|-
| summary || String || ✓ || ✓ || ✓
| A shorter mod description.
|-
| title || String || ✓ || ✓ || ✓
| The mod's human-readable name.
|-
| category || [[Mod_details_API#Category|Category]]? || ✓ || ✓ || ✓
| A single category describing the mod. See [[Mod_details_API#Category]].

|-
| score || Integer || ✓ || ✓* || ✓*
| The score of the mod. *Only when not 0.
|-
| thumbnail || String(relative URL)? || || ✓ || ✓
| The relative path to the thumbnail of the mod. For mods that have no thumbnail it may be absent or default to <code>"/assets/.thumb.png"</code>. Prepend "assets-mod.factorio.com".
|-
| changelog || String? || || || ✓
| A string describing the recent changes to a mod.
|-
| created_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was created. (RFC 3339 nano)
|-
| updated_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was last updated. (RFC 3339 nano)
|-
| last_highlighted_at || String(ISO 8601)? || || || ✓
| ISO 8601 for when the mod was last featured on the "Highlighted mods" tab. (RFC 3339 nano)
|-
| description || String? || || || ✓
| A longer description of the mod, in text only format.
|-
| source_url || String? || || || ✓
| A URL to the mod's source code.
|-
| github_path || String? || || || ✓
| Deprecated: Use <code>source_url</code> instead. A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || || || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| tags || [[#Tags|Tag]][] || || || ✓
| A list of tag names that categorize the mod. See [[#Tags]].
|-
| license || [[#License]][] || || || ✓
| The license that applies to the mod. See [[#License]].
|-
| deprecated || Boolean? || || || ✓
| True if the mod is marked as deprecated by its owner. Absent when false.
|-
|}

=== Releases ===

Only difference here between the api/mods/{name} endpoint and the api/mods/{name}/full endpoint is that the full one includes an array of dependencies in the info_json object.

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String
| Path to download for a mod. starts with "/download" and does not include a full url. See [[#Downloading Mods]]
|-
| file_name || String
| The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| info_json || Object
| A copy of the mod's info.json file, only contains factorio_version in short version, also contains an array of dependencies in full version
|-
| released_at || String(ISO 8601)
| ISO 8601 for when the mod was released. (RFC 3339 nano)
|-
| version || String
| The version string of this mod release. Used to determine dependencies.
|-
| sha1 || String
| The sha1 key for the file.
|-
| feature_flags || String[]?
| The feature flags this mod uses. See [https://lua-api.factorio.com/latest/types/FeatureFlags.html FeatureFlags]
|-
|}

=== Tags ===

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| ?? || t || planets || Planets || New places to build more factories.
|-
| 12 || t || transportation || Transportation || Transportation of the player, be it vehicles or teleporters.
|-
| 13 || t || logistics || Logistics || Augmented or new ways of transporting materials - belts, inserters, pipes!
|-
| ?? || t || combat || Combat || New ways to deal with enemies, be it attack or defense.
|-
| 17 || t || enemies || Enemies || Changes to enemies or entirely new enemies to deal with.
|-
| 18 || t || armor || Armor || Armors or armor equipment.
|-
| ?? || t || environment || Environment || Map generation and terrain modification.
|-
| 20 || t || logistic-network || Logistics Network || Related to roboports and logistic robots
|-
| ?? || t || circuit-network || Circuit network || Entities which interact with the circuit network.
|-
| 21 || t || storage || Storage || More than just chests.
|-
| 22 || t || power || Power Production || Changes to power production and distribution.
|-
| 23 || t || manufacturing || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints || Change blueprint behavior.
|-
| 25 || t || cheats || Cheats || Play it your way.
|-
| 27 || t || mining || Mining || New ores and resources as well as machines.
|-
| ?? || t || fluids || Fluids || Things related to oil and other fluids.
|-
| 29 || t || trains || Trains || Trains are great, but what if they could do even more?
|}

=== License ===

{| class="wikitable"
! Key !! Type !! Description
|-
| description || String || A short description of the license.
|-
| id || String || The unique id of the license.
|-
| name || String || The internal name of the license.
|-
| title || String || The human-readable title of the license.
|-
| url || String || Usually a URL to the full license text, but can be any string.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| message || String ||
|}

== Downloading Mods ==

You can get the full url by appending the download_url to mods.factorio.com, but if you're not authenticated, you will be redirected to mods.factorio.com/login. Logging in to that would give you access to the file. Fortunately, there's a better way to do this. Simply adding username and token parameters to the download url will prevent the redirecting and let you download the file immediately. The token can be acquired from a json file called "player-data.json", located in the User Data directory (see [[Application_directory#User_data_directory]]). You can also get the token by using the [[Web_authentication_API | Web Authentication API]].

Example usage:
https://mods.factorio.com/{download_url}?username={username}&token={token}

[[Category:Technical]]

Mod portal API

2026-01-09T19:48:54Z

CodeGreen: Added planets tag

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal|Internal API]]</div>

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

To get even more information about a mod, you can use the following URL.

<code>https://mods.factorio.com/api/mods/{name}/full</code>

List of bookmarked mods can be accessed from following URL (requires authentication).

<code>https://mods.factorio.com/api/bookmarks?username={username}&token={token}</code>

You can also toggle a bookmark using following URL, with <code>state</code> being <code>on</code> or <code>off</code>.

<code>https://mods.factorio.com/api/bookmarks/toggle?username={username}&token={token}&mod={name}&state={state}</code>

== Endpoints ==

=== /api/mods ===

GET Parameters (sent as query parameters):

{| class="wikitable"
! Key !! Values !! Description
|-
| hide_deprecated || {boolean} || Only return non-deprecated mods.
|-
| page ||{an integer}||Page number you would like to show. Makes it so you can see a certain part of the list without getting detail on all
|-
| page_size ||{an integer or 'max'}||The amount of results to show in your search
|-
| sort || {enum, one of name, created_at or updated_at} || Sort results by this property. Defaults to name when not defined. Ignored for <code>page_size=max</code> queries.
|-
| sort_order || {enum, one of asc or desc} || Sort results ascending or descending. Defaults to descending when not defined. Ignored for <code>page_size=max</code> queries.
|-
| namelist || {array of strings} || Return only mods that match the given names. Either comma-separated names or supply the namelist parameter more than once. Response will include <code>releases</code> instead of <code>latest_release</code>.
|-
| version || {enum, one of 0.13, 0.14, 0.15, 0.16, 0.17, 0.18, 1.0, 1.1 or 2.0} || Only return non-deprecated mods compatible with this Factorio version
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

Return short information of a specific mod.

See [[#Result Entry]], "Short" column.

=== /api/mods/{mod_name}/full ===

Returns more information of a mod.

See [[#Result Entry]], "Full" column.

=== /api/bookmarks ===

Returns array of mod names

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "api/mods endpoint" column, those returned by the api/mods/{name} endpoint are marked with a check in the "Short" column and those returned by the api/mods/{name}/full endpoint are marked in the "Full" column. Fields may be absent if there is no data.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | api/mods endpoint !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| latest_release || [[#Releases|Release]]? || ✓ || ||
| The latest version of the mod available for download. Absent when the <code>namelist</code> [[#/api/mods|parameter]] is used.
|-
| downloads_count || Integer || ✓ || ✓ || ✓
| Number of downloads.
|-
| name || String || ✓ || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓ || ✓
| The Factorio username of the mod's author.
|-
| releases || [[#Releases|Release]][] || ✓* || ✓ || ✓
| A list of different versions of the mod available for download. See [[#Releases]]. *Only when using <code>namelist</code> [[#/api/mods|parameter]].
|-
| summary || String || ✓ || ✓ || ✓
| A shorter mod description.
|-
| title || String || ✓ || ✓ || ✓
| The mod's human-readable name.
|-
| category || [[Mod_details_API#Category|Category]]? || ✓ || ✓ || ✓
| A single category describing the mod. See [[Mod_details_API#Category]].

|-
| score || Integer || ✓ || ✓* || ✓*
| The score of the mod. *Only when not 0.
|-
| thumbnail || String(relative URL)? || || ✓ || ✓
| The relative path to the thumbnail of the mod. For mods that have no thumbnail it may be absent or default to <code>"/assets/.thumb.png"</code>. Prepend "assets-mod.factorio.com".
|-
| changelog || String? || || || ✓
| A string describing the recent changes to a mod.
|-
| created_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was created. (RFC 3339 nano)
|-
| updated_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was last updated. (RFC 3339 nano)
|-
| last_highlighted_at || String(ISO 8601)? || || || ✓
| ISO 8601 for when the mod was last featured on the "Highlighted mods" tab. (RFC 3339 nano)
|-
| description || String? || || || ✓
| A longer description of the mod, in text only format.
|-
| source_url || String? || || || ✓
| A URL to the mod's source code.
|-
| github_path || String? || || || ✓
| Deprecated: Use <code>source_url</code> instead. A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || || || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| tags || [[#Tags|Tag]][] || || || ✓
| A list of tag names that categorize the mod. See [[#Tags]].
|-
| license || [[#License]][] || || || ✓
| The license that applies to the mod. See [[#License]].
|-
| deprecated || Boolean? || || || ✓
| True if the mod is marked as deprecated by its owner. Absent when false.
|-
|}

=== Releases ===

Only difference here between the api/mods/{name} endpoint and the api/mods/{name}/full endpoint is that the full one includes an array of dependencies in the info_json object.

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String
| Path to download for a mod. starts with "/download" and does not include a full url. See [[#Downloading Mods]]
|-
| file_name || String
| The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| info_json || Object
| A copy of the mod's info.json file, only contains factorio_version in short version, also contains an array of dependencies in full version
|-
| released_at || String(ISO 8601)
| ISO 8601 for when the mod was released. (RFC 3339 nano)
|-
| version || String
| The version string of this mod release. Used to determine dependencies.
|-
| sha1 || String
| The sha1 key for the file.
|-
| feature_flags || String[]?
| The feature flags this mod uses. See [https://lua-api.factorio.com/latest/types/FeatureFlags.html FeatureFlags]
|-
|}

=== Tags ===

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 12 || t || planets || Planets || New places to build more factories.
|-
| 12 || t || transportation || Transportation || Transportation of the player, be it vehicles or teleporters.
|-
| 13 || t || logistics || Logistics || Augmented or new ways of transporting materials - belts, inserters, pipes!
|-
| ?? || t || combat || Combat || New ways to deal with enemies, be it attack or defense.
|-
| 17 || t || enemies || Enemies || Changes to enemies or entirely new enemies to deal with.
|-
| 18 || t || armor || Armor || Armors or armor equipment.
|-
| ?? || t || environment || Environment || Map generation and terrain modification.
|-
| 20 || t || logistic-network || Logistics Network || Related to roboports and logistic robots
|-
| ?? || t || circuit-network || Circuit network || Entities which interact with the circuit network.
|-
| 21 || t || storage || Storage || More than just chests.
|-
| 22 || t || power || Power Production || Changes to power production and distribution.
|-
| 23 || t || manufacturing || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints || Change blueprint behavior.
|-
| 25 || t || cheats || Cheats || Play it your way.
|-
| 27 || t || mining || Mining || New ores and resources as well as machines.
|-
| ?? || t || fluids || Fluids || Things related to oil and other fluids.
|-
| 29 || t || trains || Trains || Trains are great, but what if they could do even more?
|}

=== License ===

{| class="wikitable"
! Key !! Type !! Description
|-
| description || String || A short description of the license.
|-
| id || String || The unique id of the license.
|-
| name || String || The internal name of the license.
|-
| title || String || The human-readable title of the license.
|-
| url || String || Usually a URL to the full license text, but can be any string.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| message || String ||
|}

== Downloading Mods ==

You can get the full url by appending the download_url to mods.factorio.com, but if you're not authenticated, you will be redirected to mods.factorio.com/login. Logging in to that would give you access to the file. Fortunately, there's a better way to do this. Simply adding username and token parameters to the download url will prevent the redirecting and let you download the file immediately. The token can be acquired from a json file called "player-data.json", located in the User Data directory (see [[Application_directory#User_data_directory]]). You can also get the token by using the [[Web_authentication_API | Web Authentication API]].

Example usage:
https://mods.factorio.com/{download_url}?username={username}&token={token}

[[Category:Technical]]

Mod portal API

2026-01-09T19:43:48Z

CodeGreen: Added feature_flags to Release object

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal|Internal API]]</div>

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

To get even more information about a mod, you can use the following URL.

<code>https://mods.factorio.com/api/mods/{name}/full</code>

List of bookmarked mods can be accessed from following URL (requires authentication).

<code>https://mods.factorio.com/api/bookmarks?username={username}&token={token}</code>

You can also toggle a bookmark using following URL, with <code>state</code> being <code>on</code> or <code>off</code>.

<code>https://mods.factorio.com/api/bookmarks/toggle?username={username}&token={token}&mod={name}&state={state}</code>

== Endpoints ==

=== /api/mods ===

GET Parameters (sent as query parameters):

{| class="wikitable"
! Key !! Values !! Description
|-
| hide_deprecated || {boolean} || Only return non-deprecated mods.
|-
| page ||{an integer}||Page number you would like to show. Makes it so you can see a certain part of the list without getting detail on all
|-
| page_size ||{an integer or 'max'}||The amount of results to show in your search
|-
| sort || {enum, one of name, created_at or updated_at} || Sort results by this property. Defaults to name when not defined. Ignored for <code>page_size=max</code> queries.
|-
| sort_order || {enum, one of asc or desc} || Sort results ascending or descending. Defaults to descending when not defined. Ignored for <code>page_size=max</code> queries.
|-
| namelist || {array of strings} || Return only mods that match the given names. Either comma-separated names or supply the namelist parameter more than once. Response will include <code>releases</code> instead of <code>latest_release</code>.
|-
| version || {enum, one of 0.13, 0.14, 0.15, 0.16, 0.17, 0.18, 1.0, 1.1 or 2.0} || Only return non-deprecated mods compatible with this Factorio version
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

Return short information of a specific mod.

See [[#Result Entry]], "Short" column.

=== /api/mods/{mod_name}/full ===

Returns more information of a mod.

See [[#Result Entry]], "Full" column.

=== /api/bookmarks ===

Returns array of mod names

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "api/mods endpoint" column, those returned by the api/mods/{name} endpoint are marked with a check in the "Short" column and those returned by the api/mods/{name}/full endpoint are marked in the "Full" column. Fields may be absent if there is no data.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | api/mods endpoint !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| latest_release || [[#Releases|Release]]? || ✓ || ||
| The latest version of the mod available for download. Absent when the <code>namelist</code> [[#/api/mods|parameter]] is used.
|-
| downloads_count || Integer || ✓ || ✓ || ✓
| Number of downloads.
|-
| name || String || ✓ || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓ || ✓
| The Factorio username of the mod's author.
|-
| releases || [[#Releases|Release]][] || ✓* || ✓ || ✓
| A list of different versions of the mod available for download. See [[#Releases]]. *Only when using <code>namelist</code> [[#/api/mods|parameter]].
|-
| summary || String || ✓ || ✓ || ✓
| A shorter mod description.
|-
| title || String || ✓ || ✓ || ✓
| The mod's human-readable name.
|-
| category || [[Mod_details_API#Category|Category]]? || ✓ || ✓ || ✓
| A single category describing the mod. See [[Mod_details_API#Category]].

|-
| score || Integer || ✓ || ✓* || ✓*
| The score of the mod. *Only when not 0.
|-
| thumbnail || String(relative URL)? || || ✓ || ✓
| The relative path to the thumbnail of the mod. For mods that have no thumbnail it may be absent or default to <code>"/assets/.thumb.png"</code>. Prepend "assets-mod.factorio.com".
|-
| changelog || String? || || || ✓
| A string describing the recent changes to a mod.
|-
| created_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was created. (RFC 3339 nano)
|-
| updated_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was last updated. (RFC 3339 nano)
|-
| last_highlighted_at || String(ISO 8601)? || || || ✓
| ISO 8601 for when the mod was last featured on the "Highlighted mods" tab. (RFC 3339 nano)
|-
| description || String? || || || ✓
| A longer description of the mod, in text only format.
|-
| source_url || String? || || || ✓
| A URL to the mod's source code.
|-
| github_path || String? || || || ✓
| Deprecated: Use <code>source_url</code> instead. A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || || || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| tags || [[#Tags|Tag]][] || || || ✓
| A list of tag names that categorize the mod. See [[#Tags]].
|-
| license || [[#License]][] || || || ✓
| The license that applies to the mod. See [[#License]].
|-
| deprecated || Boolean? || || || ✓
| True if the mod is marked as deprecated by its owner. Absent when false.
|-
|}

=== Releases ===

Only difference here between the api/mods/{name} endpoint and the api/mods/{name}/full endpoint is that the full one includes an array of dependencies in the info_json object.

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String
| Path to download for a mod. starts with "/download" and does not include a full url. See [[#Downloading Mods]]
|-
| file_name || String
| The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| info_json || Object
| A copy of the mod's info.json file, only contains factorio_version in short version, also contains an array of dependencies in full version
|-
| released_at || String(ISO 8601)
| ISO 8601 for when the mod was released. (RFC 3339 nano)
|-
| version || String
| The version string of this mod release. Used to determine dependencies.
|-
| sha1 || String
| The sha1 key for the file.
|-
| feature_flags || String[]?
| The feature flags this mod uses. See [https://lua-api.factorio.com/latest/types/FeatureFlags.html FeatureFlags]
|-
|}

=== Tags ===

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 12 || t || transportation || Transportation || Transportation of the player, be it vehicles or teleporters.
|-
| 13 || t || logistics || Logistics || Augmented or new ways of transporting materials - belts, inserters, pipes!
|-
| ?? || t || combat || Combat || New ways to deal with enemies, be it attack or defense.
|-
| 17 || t || enemies || Enemies || Changes to enemies or entirely new enemies to deal with.
|-
| 18 || t || armor || Armor || Armors or armor equipment.
|-
| ?? || t || environment || Environment || Map generation and terrain modification.
|-
| 20 || t || logistic-network || Logistics Network || Related to roboports and logistic robots
|-
| ?? || t || circuit-network || Circuit network || Entities which interact with the circuit network.
|-
| 21 || t || storage || Storage || More than just chests.
|-
| 22 || t || power || Power Production || Changes to power production and distribution.
|-
| 23 || t || manufacturing || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints || Change blueprint behavior.
|-
| 25 || t || cheats || Cheats || Play it your way.
|-
| 27 || t || mining || Mining || New ores and resources as well as machines.
|-
| ?? || t || fluids || Fluids || Things related to oil and other fluids.
|-
| 29 || t || trains || Trains || Trains are great, but what if they could do even more?
|}

=== License ===

{| class="wikitable"
! Key !! Type !! Description
|-
| description || String || A short description of the license.
|-
| id || String || The unique id of the license.
|-
| name || String || The internal name of the license.
|-
| title || String || The human-readable title of the license.
|-
| url || String || Usually a URL to the full license text, but can be any string.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| message || String ||
|}

== Downloading Mods ==

You can get the full url by appending the download_url to mods.factorio.com, but if you're not authenticated, you will be redirected to mods.factorio.com/login. Logging in to that would give you access to the file. Fortunately, there's a better way to do this. Simply adding username and token parameters to the download url will prevent the redirecting and let you download the file immediately. The token can be acquired from a json file called "player-data.json", located in the User Data directory (see [[Application_directory#User_data_directory]]). You can also get the token by using the [[Web_authentication_API | Web Authentication API]].

Example usage:
https://mods.factorio.com/{download_url}?username={username}&token={token}

[[Category:Technical]]

Artillery turret

2025-01-28T16:04:36Z

CodeGreen: Updated places talking about one-shotting enemies to account for behemoth worms and spawner health scaling, and added a section about damage + damage research

{{Languages}}{{:Infobox:Artillery turret}}
The '''artillery turret''' is a super-long-range static defense structure added in game version 0.16. It fires [[Artillery shell|artillery shells]], relatively slow-moving projectiles that explore chunks of terrain they travel across. The turret has both automatic and manual (even longer-ranged) firing modes. Projectiles have sufficient damage to destroy any type of worm up to behemoths with a single hit, and have a modest area of effect. They can also one-shot spawners up to just below 75% evolution, since spawner health increases with evolution. Infinitely-stacking research upgrades are available for range, firing speed, and damage.

The [[Artillery wagon|artillery wagon]] is essentially the same weapon, only mounted on a train car and therefore mobile.

[[Inserters]] can insert and remove artillery shells from artillery turrets. This allows chaining multiple turrets together with inserters, each inserter taking shells, as needed, from one turret and placing it into the next.

The artillery turret can be connected to the [[circuit network]] to read its current ammunition and/or enable it on a condition.

== Mechanics ==
Artillery turrets have a massive range, outranging other fixed fortifications by a factor of 10 or more. There are no special limits on how many may be built or where and, being ammunition-based, these turrets do not require electric power to operate.

In automatic mode, they function much the same as other turrets, automatically scanning for valid targets within range and firing on them. Automatic mode can only target [[Military units and structures|enemy structures]] (spawners and worms), not mobile units (biters and spitters); shells do, however, damage mobile units in the vicinity of impact normally. Automatic mode can be disabled by opening the GUI of the artillery turret and toggling the "Auto targeting" box.

In manual mode, an [[artillery targeting remote]] is used to point-and-click anywhere in the world, map, or zoomed-in map; Each click corresponds to one shell delivered to that location, so long as any working artillery turrets and / or wagons are in range. Targeting remotes show the number of fire-ready (loaded and, for wagons, stationary) artillery pieces in range of cursor position when held. Manual fire can be ordered on unexplored areas; shells will explore all chunks they travel across (but no surrounding chunks).

Range in automatic mode is 224 tiles (7 chunks); in manual mode, 560 tiles (17.5 chunks). Infinite [[Artillery shell range (research)|research]] is available to increase range, at +30% of base range per level, applied to both automatic and manual range.

Artillery turrets are capable of killing most enemies with a single shot, although Behemoth worms and spawners with enough extra health from the evolution factor (just below 75%) take two shots to kill instead. Damage can be increased with infinite [[Artillery shell damage (research)|research]] to combat this; To one-shot behemoth worms, you'll need 8 levels of damage research, and to one-shot spawners at 100% evolution, you'll need 9 levels. Do note that spawner health increases gradually with evolution factor, so you do not need all 9 levels to one-shot them right away. Instead, each time they break that one-shot threshold, just one more research level is enough until the next time they get enough health to survive again.

== Limitations ==
Aside from the considerable expense of research and assembly for both turrets and shells, there are certain considerations that make a base defense based purely on these turrets unwise, despite their phenomenal range.

Artillery shelling will antagonize enemy mobile units in the vicinity of the impact into rushing the turret emplacement, regardless of their normal "aggro radius". Artillery turrets are relatively slow-firing, although infinite [[Artillery shell shooting speed (research)|research]] is available to improve firing speed, at +100% per level, affecting both stationary turrets and wagons and applying to both automatic and manual mode. They also cannot target mobile units in automatic mode. Importantly, artillery has a ''minimum'' range as well, which is 32 tiles.

Together, these limitations mean that an artillery turret needs to be defended by other means. Any conventional approach such as walls, gun, laser, and / or flamethrower turrets, or the personal intervention of the player will do. However, players should keep in mind that extensive shelling of large biter-infested areas will produce massive attack waves centered on the position of the artillery piece at time of firing, and should plan close-range defenses accordingly.

Logistic considerations are also important, as artillery shells have a stack size of 1, meaning any-size container can only hold a modest supply and an inserter will only ever move a single shell at a time. Players may wish to consider on-site assembly for permanent and semi-permanent emplacements. The turret itself can hold 15 shells, and the wagon version can hold a full 100, providing a buffer of some size when continuous supply is not available. Some players use artillery wagons with auto targeting disabled as storage for artillery shells to deliver to regular turret outposts, since they can hold twice as much as a cargo wagon.

== Gallery ==
<gallery widths=236px heights=162px>
File:artillery_turret_firing_anim.gif|Animation of the turret seeking a target, then firing.
</gallery>

== History ==
{{history|2.0.7|
* All turrets (including artillery) can now be connected to the circuit network to read their current ammo count and/or deactivate them
* Doubled the damage of artillery.
* Default "use item" control changed from {{keybinding|left click}} to {{keybinding|right click}}.}}

{{history|0.16.0|
* Introduced}}

== See also ==
* [[Artillery wagon]]
* [[Artillery shell]]
* [[Artillery targeting remote]]

{{CombatNav}}
{{C|Defense}}

Mod portal API

2025-01-04T18:24:12Z

CodeGreen: Added two missing fields from the full mod request and specified the RFC 3339 nano format for the places iSO 8601 is mentioned

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal|Internal API]]</div>

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

To get even more information about a mod, you can use the following URL.

<code>https://mods.factorio.com/api/mods/{name}/full</code>

== Endpoints ==

=== /api/mods ===

GET Parameters (sent as query parameters):

{| class="wikitable"
! Key !! Values !! Description
|-
| hide_deprecated || {boolean} || Only return non-deprecated mods.
|-
| page ||{an integer}||Page number you would like to show. Makes it so you can see a certain part of the list without getting detail on all
|-
| page_size ||{an integer or 'max'}||The amount of results to show in your search
|-
| sort || {enum, one of name, created_at or updated_at} || Sort results by this property. Defaults to name when not defined. Ignored for <code>page_size=max</code> queries.
|-
| sort_order || {enum, one of asc or desc} || Sort results ascending or descending. Defaults to descending when not defined. Ignored for <code>page_size=max</code> queries.
|-
| namelist || {array of strings} || Return only mods that match the given names. Either comma-separated names or supply the namelist parameter more than once. Response will include <code>releases</code> instead of <code>latest_release</code>.
|-
| version || {enum, one of 0.13, 0.14, 0.15, 0.16, 0.17, 0.18, 1.0, 1.1 or 2.0} || Only return non-deprecated mods compatible with this Factorio version
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

Return short information of a specific mod.

See [[#Result Entry]], "Short" column.

=== /api/mods/{mod_name}/full ===

Returns more information of a mod.

See [[#Result Entry]], "Full" column.

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "api/mods endpoint" column, those returned by the api/mods/{name} endpoint are marked with a check in the "Short" column and those returned by the api/mods/{name}/full endpoint are marked in the "Full" column. Fields may be absent if there is no data.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | api/mods endpoint !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| latest_release || [[#Releases|Release]]? || ✓ || ||
| The latest version of the mod available for download. Absent when the <code>namelist</code> [[#/api/mods|parameter]] is used.
|-
| downloads_count || Integer || ✓ || ✓ || ✓
| Number of downloads.
|-
| name || String || ✓ || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓ || ✓
| The Factorio username of the mod's author.
|-
| releases || [[#Releases|Release]][] || ✓* || ✓ || ✓
| A list of different versions of the mod available for download. See [[#Releases]]. *Only when using <code>namelist</code> [[#/api/mods|parameter]].
|-
| summary || String || ✓ || ✓ || ✓
| A shorter mod description.
|-
| title || String || ✓ || ✓ || ✓
| The mod's human-readable name.
|-
| category || [[Mod_details_API#Category|Category]]? || ✓ || ✓ || ✓
| A single category describing the mod. See [[Mod_details_API#Category]].

|-
| score || Integer || ✓ || ✓* || ✓*
| The score of the mod. *Only when not 0.
|-
| thumbnail || String(relative URL) || || ✓ || ✓
| The relative path to the thumbnail of the mod. For mods that have no thumbnail it may be absent or default to <code>"/assets/.thumb.png"</code>. Prepend "assets-mod.factorio.com".
|-
| changelog || String || || || ✓
| A string describing the recent changes to a mod.
|-
| created_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was created. (RFC 3339 nano)
|-
| updated_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was last updated. (RFC 3339 nano)
|-
| last_highlighted_at || String(ISO 8601) || || || ✓
| ISO 8601 for when the mod was last featured on the "Highlighted mods" tab. (RFC 3339 nano)
|-
| description || String || || || ✓
| A longer description of the mod, in text only format.
|-
| source_url || String || || || ✓
| A URL to the mod's source code.
|-
| github_path || String || || || ✓
| Deprecated: Use <code>source_url</code> instead. A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || || || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| tags || [[#Tags|Tag]][] || || || ✓
| A list of tag names that categorize the mod. See [[#Tags]].
|-
| license || [[#License]][] || || || ✓
| The license that applies to the mod. See [[#License]].
|-
| deprecated || Boolean? || || || ✓
| <ref></ref>True if the mod is marked as deprecated by its owner. Absent when false.
|-
|}

=== Releases ===

Only difference here between the api/mods/{name} endpoint and the api/mods/{name}/full endpoint is that the full one includes an array of dependencies in the info_json object.

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String
| Path to download for a mod. starts with "/download" and does not include a full url. See [[#Downloading Mods]]
|-
| file_name || String
| The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| info_json || Object
| A copy of the mod's info.json file, only contains factorio_version in short version, also contains an array of dependencies in full version
|-
| released_at || String(ISO 8601)
| ISO 8601 for when the mod was released. (RFC 3339 nano)
|-
| version || String
| The version string of this mod release. Used to determine dependencies.
|-
| sha1 || String
| The sha1 key for the file
|-
|}

=== Tags ===

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 12 || t || transportation || Transportation || Transportation of the player, be it vehicles or teleporters.
|-
| 13 || t || logistics || Logistics || Augmented or new ways of transporting materials - belts, inserters, pipes!
|-
| ?? || t || combat || Combat || New ways to deal with enemies, be it attack or defense.
|-
| 17 || t || enemies || Enemies || Changes to enemies or entirely new enemies to deal with.
|-
| 18 || t || armor || Armor || Armors or armor equipment.
|-
| ?? || t || environment || Environment || Map generation and terrain modification.
|-
| 20 || t || logistic-network || Logistics Network || Related to roboports and logistic robots
|-
| ?? || t || circuit-network || Circuit network || Entities which interact with the circuit network.
|-
| 21 || t || storage || Storage || More than just chests.
|-
| 22 || t || power || Power Production || Changes to power production and distribution.
|-
| 23 || t || manufacturing || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints || Change blueprint behavior.
|-
| 25 || t || cheats || Cheats || Play it your way.
|-
| 27 || t || mining || Mining || New ores and resources as well as machines.
|-
| ?? || t || fluids || Fluids || Things related to oil and other fluids.
|-
| 29 || t || trains || Trains || Trains are great, but what if they could do even more?
|}

=== License ===

{| class="wikitable"
! Key !! Type !! Description
|-
| description || String || A short description of the license.
|-
| id || String || The unique id of the license.
|-
| name || String || The internal name of the license.
|-
| title || String || The human-readable title of the license.
|-
| url || String || Usually a URL to the full license text, but can be any string.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| message || String ||
|}

== Downloading Mods ==

You can get the full url by appending the download_url to mods.factorio.com, but if you're not authenticated, you will be redirected to mods.factorio.com/login. Logging in to that would give you access to the file. Fortunately, there's a better way to do this. Simply adding username and token parameters to the download url will prevent the redirecting and let you download the file immediately. The token can be acquired from a json file called "player-data.json", located in the User Data directory (see [[Application_directory#User_data_directory]]). You can also get the token by using the [[Web_authentication_API | Web Authentication API]].

Example usage:
https://mods.factorio.com/{download_url}?username={username}&token={token}

[[Category:Technical]]

Permissions

2024-08-16T03:49:44Z

CodeGreen:

The permissions system provides control over what players are allowed to do while in a specific game. This system is most useful in [[multiplayer]], but may also be used in singleplayer. The permissions menu can be opened using the /permissions command. It is important to note that the permissions system is based on input actions, which are what gets sent from clients to the host. This means that some permissions don't prevent you from changing things that are client side, only that changing those things won't be reflected from the server's perspective.

== Overview ==
{| class="wikitable"
! Permission !! Description
|-
| Activate copy || Get a copy tool by pressing Ctrl + C or the copy button on the shortcut bar.
|-
| Activate cut || Get a cut tool by pressing Ctrl + X or the cut button on the shortcut bar.
|-
| Activate paste || Get a paste tool by pressing Ctrl + V or the paste button on the shortcut bar.
|-
| Add permission group || Create a new permission group in the permissions settings.
|-
| Add train station || Add a train station to a train schedule.
|-
| Admin action || Do anything that requires admin permissions, such as using commands like /ban or opening other players.
|-
| Alt reverse select area || Right click and hold Shift while using a selection tool.
|-
| Alt select area || Hold Shift when using a selection tool.
|-
| Alt select blueprint entities || Select blueprint while holding shift to skip the blueprint edit window.
|-
| Alternative copy || Copy while holding Shift to open a blueprint edit window.
|-
| Begin mining || Mine an entity
|-
| Begin mining terrain || Mine any tile (removing paving)
|-
| Build || Place an entity.
|-
| Build rail || Use the rail planner
|-
| Build terrain || Place any tile.
|-
| Cancel craft || Cancel items in the handcrafting queue
|-
| Cancel deconstruct || Cancel deconstruction plans by selecting entities/tiles marked for deconstruction with a deconstruction planner while holding Shift.
|-
| Cancel new blueprint || Exit out of the blueprint editing menu by pressing escape (X button still works).
|-
| Cancel research || Cancel ongoing research (Does not correctly show in research gui in singleplayer, research will appear cancelled but resumes as soon as window is closed)
|-
| Cancel upgrade || Cancel an entity upgrade created with the upgrade planner.
|-
| Change active character tab || ? (Switching between the crafting and logistics tabs when flat gui is enabled still works as normal)
|-
| Change active item group for crafting || ? (supposed to be the different recipe tabs in crafting menus)
|-
| Change active item group for filters || ? (supposed to be the different tabs in filter menus)
|-
| Change active quick bar || Change which quick bar row is selected (only affects server)
|-
| Change arithmetic combinator parameters || Make changes to any of the settings of arithmetic combinators.
|-
| Change decider combinator parameters || Make changes to any of the settings of decider combinators.
|-
| Change entity label || ?
|-
| Change item description || ?
|-
| Change item label || ?
|-
| Change multiplayer config || Use /config to edit the multiplayer settings.
|-
| Change picking state || Pick up items from the floor by holding F.
|-
| Change programmable speaker alert parameters || Change any of the programmable speaker's alert settings.
|-
| Change programmable speaker circuit parameters || Change the programmable speaker's "signal value is pitch" setting.
|-
| Change programmable speaker parameters || Change the programmable speaker's "Volume", "Global playback" and "Allow polyphony" settings.
|-
| Change riding state || Control any vehicle (getting in and out is still possible).
|-
| Change shooting state || Shoot at anything.
|-
| Change train stop station || Change the name of a train stop.
|-
| Change train wait condition || Add or remove wait conditions in a train schedule.
|-
| Change train wait condition data || Edit the contents of wait conditions in a train schedule.
|-
| Clear cursor || Clear the cursor by pressing Q.
|-
| Connect rolling stock || Connect multiple trains together using the "connect rolling stock" keybind.
|-
| Copy || Copy entities using the copy tool.
|-
| Copy entity settings || Copy the settings of an entity with Shift + RMB.
|-
| Copy opened blueprint || Make a copy of an opened blueprint using the "create copy of this" button.
|-
| Copy opened item || Make a copy of an opened item that is not a blueprint (i.e. planners) using the "create copy of this" button.
|-
| Craft || Handcraft recipes from your inventory.
|-
| Cursor split || Pick up half a stack of items from an inventory by right clicking it.
|-
| Cursor transfer || Pick up a stack of items from an inventory by clicking it.
|-
| Custom input || Use custom inputs defined by mods.
|-
| Cycle blueprint book backwards || Cycle through the blueprints in a blueprint book in reverse order with Shift + Scroll.
|-
| Cycle blueprint book || Cycle through the blueprints in a blueprint book by scrolling.
|-
| Deconstruct || Mark items for deconstruction using a deconstruction planner.
|-
| Delete blueprint library || Delete a blueprint that is placed in the player's personal blueprint library. (Taking the blueprint out and then deleting it still works.)
|-
| Delete blueprint record || Delete a blueprint that is placed in the Game blueprints menu. (Taking the blueprint out and then deleting it still works.)
|-
| Delete custom tag || Delete a custom tag that has been placed on the map.
|-
| Delete permission group || Delete a permission group in the permission setting.
|-
| Destroy item || Ctrl + MMB in the editor to delete an item.
|-
| Destroy opened item || Destroy a blueprint or planner that is opened using the Destroy button.
|-
| Disconnect rolling stock || Disconnect wagons using the "disconnect rolling stock" keybind.
|-
| Drag train schedule || Rearrange stations in a train schedule by dragging them.
|-
| Drag train wait condition || Rearrange wait conditions in a train schedule by dragging them.
|-
| Drop blueprint record || Drop a blueprint from your blueprint library onto the ground by pressing Z.
|-
| Drop item || Drop an item onto the floor by pressing Z.
|-
| Edit blueprint tool preview || Edit the name, icon or description fields of a blueprint.
|-
| Edit custom tag || Edit a custom tag that has been placed on the map.
|-
| Edit permission group || Edit the settings for an existing permission group in the permissions settings.
|-
| Export blueprint || Export a blueprint to a blueprint string.
|-
| Fast entity split || Fast transfer half a stack of items to an entity by holding a stack and pressing Ctrl + RMB.
|-
| Fast entity transfer || Fast transfer a stack of items to an entity by holding a stack and pressing Ctrl + LMB.
|-
| Flush opened entity fluid || Flush fluids from a specific entity.
|-
| Flush opened entity specific fluid || Flush fluids from a connected fluid network.
|-
| Go to train station || Send a train to a specific station in its schedule. (Temporary stops still work)
|-
| Grab blueprint record || Take blueprints out of the blueprint library. (Copying still works)
|-
| Gui checked state changed || Toggle check boxes in modded GUIs
|-
| Gui click || Click elements in modded GUIs.
|-
| Gui confirmed || Press E to confirm modded GUIs.
|-
| Gui elem changed || Change a button's selected element in modded GUIs.
|-
| Gui hover || Hover over elements in modded GUIs.
|-
| Gui leave || Stop hovering over elements in modded GUIs.
|-
| Gui location changed || Drag modded GUIs around the screen.
|-
| Gui selected tab changed || Select tabs of tabbed panes in modded GUIs.
|-
| Gui selection state changed || Change dropdowns or list boxes in modded GUIs.
|-
| Gui switch state changed || Toggle switches in modded GUIs.
|-
| Gui text changed || Edit textboxes or textfields in modded GUIs.
|-
| Gui value changed || Change sliders in modded GUIs.
|-
| Import blueprint || ? (May only work in multiplayer?)
|-
| Import blueprint string || Import blueprints using the import blueprint string menu.
|-
| Import blueprints filtered || ? (multiplayer importing blueprints by getting them from the library as client?)
|-
| Import permissions string || Import a permissions string in the permissions settings.
|-
| Inventory split || Quick transfer half of all items or all items of a specific kind to another inventory with Ctrl + RMB
|-
| Inventory transfer || Quick transfer all items or all items of a specific kind from one inventory to another with Ctrl + LMB
|-
| Launch rocket || Launch a rocket from the rocket silo
|-
| Lua shortcut || Use a modded shortcut from the bottom right buttons.
|-
| Map editor action || Use any of the features of the map editor (opening it is still possible).
|-
| Market offer || Interact with the market entity.
|-
| Mod settings changed || Change any mod settings.
|-
| Open achievements gui || Open the Achievements menu.
|-
| Open blueprint library gui || Open the blueprint library.
|-
| Open blueprint record || Open the blueprint edit menu for any blueprint in the blueprint library.
|-
| Open bonus gui || Open the bonuses menu.
|-
| Open character gui || Open the character inventory/crafting menu
|-
| Open current vehicle gui || Open the gui of the currently driven vehicle with the button at the bottom-left of the screen.
|-
| Open equipment || Open the menus of individual personal equipment items. (No openable equipment exists in vanilla)
|-
| Open gui || Open any entity menus.
|-
| Open item || Open the editing menus of blueprints and planners.
|-
| Open logistic gui || Open the logistic networks menu.
|-
| Open mod item || ?
|-
| Open parent of opened item || Directly open the parent inventory of items such as blueprint books.
|-
| Open production gui || Open the production statistics menu.
|-
| Open technology gui || Open the tech tree menu.
|-
| Open tips and tricks gui || Open the tips and tricks menu.
|-
| Open train gui || Open the trains overview menu.
|-
| Paste entity settings || Paste the settings of an entity with Shift + LMB.
|-
| Place equipment || Place personal equipment into equipment grids.
|-
| Quick bar pick slot || Select items placed on the quick bar.
|-
| Quick bar set selected page || Change the selected quick bar page.
|-
| Quick bar set slot || Reassign a quick bar slot to hold a new item. (Assigning items to empty slots is still possible)
|-
| Reassign blueprint || Select new contents for a blueprint.
|-
| Remove cables || Remove cables from power boles using Shift + LMB.
|-
| Remove train station || Remove stations from train schedules.
|-
| Reset assembling machine || Remove the recipe from an assembling machine.
|-
| Reset item || Reset items such as spidertron remotes.
|-
| Reverse select area || Right click while using a selection tool.
|-
| Rotate entity || Rotate already placed entities.
|-
| Select area || Left click while using a selection tool.
|-
| Select blueprint entities || Select entities to include in a blueprint.
|-
| Select entity slot || Set entity filters in deconstruction planners.
|-
| Select item || ? (something to do with spidertrons)
|-
| Select mapper slot || Set upgrade filters in upgrade planners.
|-
| Select next valid gun || Switch between weapons by pressing Tab.
|-
| Select tile slot || Set tile filters in deconstruction planners.
|-
| Send spidertron || Use the remote control to send a spidertron somewhere.
|-
| Set auto launch rocket || Set a rocket silo to automatically launch rockets.
|-
| Set autosort inventory || Change the "always keep the player's main inventory sorted" setting. (Setting will still change, but the change has no effect.)
|-
| Set behaviour mode || ? (possibly circuit network?)
|-
| Set car weapons control || Change who has control of the weapons in a car when there are multiple people on board.
|-
| Set circuit condition || Change the enabled condition settings on any circuit connected entities.
|-
| Set circuit mode of operation || Change the mode of operation settings on any circuit controlled entities.
|-
| Set controller logistic trash filter item || Change the maximum count for a personal logistic request.
|-
| Set deconstruction item trees and rocks only || Change the deconstruction planner's "trees/rocks only" checkbox.
|-
| Set entity color || Change the color of any entity that supports this.
|-
| Set entity energy property || Change the settings on an electric energy interface (editor only item).
|-
| Set entity logistic trash filter item || Change the maximum count for an entity's logistic request.
|-
| Set filter || Filter inventory slots to a specific item.
|-
| Set flat controller gui || ? (does not affect changing to/from flat character gui)
|-
| Set heat interface mode || Set the mode of a heat interface (editor only item).
|-
| Set heat interface temperature || Set the temperature on a heat interface (editor only item).
|-
| Set infinity container filter item || Change the filters on infinity chests (editor only item)
|-
| Set infinity container remove unfiltered items || Change the remove unfiltered items setting on infinity chests (editor only item).
|-
| Set infinity pipe filter || Set the fluid type on an infinity pipe (editor only item).
|-
| Set inserter max stack size || Change the stack size limit on inserters.
|-
| Set inventory bar || Set the inventory limit in chests or other inventories.
|-
| Set linked container link ID || Change which network linked chests are connected to (editor only item).
|-
| Set logistic filter item || Change any personal logistics request filters.
|-
| Set logistic filter signal || Change output signals on constant combinators.
|-
| Set player color || Change the color of the player's character.
|-
| Set recipe notifications || Change whether new recipes are marked as new in the crafting menu.
|-
| Set request from buffers || Change the "request from buffer chests" setting on requester chests.
|-
| Set research finished stops game || Set whether the technology tree opens automatically after finishing a research.
|-
| Set signal || ? (not setting signals in circuit connected entities)
|-
| Set splitter priority || Change the priority settings on splitters.
|-
| Set train stopped || Toggle trains between manual and automatic modes.
|-
| Set trains limit || Change the train limit setting on train stops.
|-
| Set vehicle automatic targeting parameters || Change the automatic targeting settings on autonomous vehicles such as the spidertron.
|-
| Setup assembling machine || Set the recipe on assembling machines that do not have a recipe set.
|-
| Setup blueprint || Create a blueprint from the blueprint edit menu.
|-
| Setup single blueprint record || ?
|-
| Smart pipette || Smart pipette functions such as selecting a miner when using the pipette on ore.
|-
| Spawn item || ? (something to do with modded shortcuts that spawn items?)
|-
| Stack split || Transfer half a stack of items to another inventory with Shift + RMB.
|-
| Stack transfer || Transfer a stack of items to another inventory with Shift + LMB.
|-
| Start repair || Repair entities using a repair pack.
|-
| Start research || Start new research in the tech tree menu.
|-
| Start walking || Walk around.
|-
| Stop building by moving || ?
|-
| Switch connect to logistic network || Connect or disconnect machines from the logistic network.
|-
| Switch constant combinator state || Toggle constant combinators on or off.
|-
| Switch inserter filter mode state || Switch between blacklist and whitelist on filter inserters.
|-
| Switch power switch state || Toggle power switches on or off.
|-
| Switch to rename stop gui || Open the rename train stop menu by clicking the pencil icon next to the stop name.
|-
| Take equipment || Remove equipment from an equipment grid.
|-
| Toggle deconstruction item entity filter mode || Toggle the "entities only" switch on deconstruction planners.
|-
| Toggle deconstruction item tile filter mode || Toggle the "tiles only" switch on deconstruction planners.
|-
| Toggle driving || Enter or exit vehicles.
|-
| Toggle enable vehicle logistic requests || Toggle logistic requests of vehicles on or off.
|-
| Toggle entity logistic requests || Toggle personal logistics and auto-trash on or off for entities.
|-
| Toggle equipment movement bonus || Toggle exoskeletons on or off.
|-
| Toggle map editor || Open or close the map editor.
|-
| Toggle personal logistic requests. || Toggle personal logistic requests on or off.
|-
| Toggle personal roboport || Toggle personal roboports on or off.
|-
| Toggle show entity info || Toggle "alt mode".
|-
| Translate string || ? (possibly something to do with the API translating for mods)
|-
| Undo || Undo the previous action with Ctrl + Z.
|-
| Upgrade || Apply an upgrade using the upgrade planner.
|-
| Upgrade opened blueprint by item || Apply a pre-existing upgrade planner to an open blueprint.
|-
| Upgrade opened blueprint by record || Apply a default upgrade planner to an open blueprint.
|-
| Use artillery remote || Use the artillery remote to target artillery.
|-
| Use item || Use consumable items such as capsules.
|-
| Wire dragging || Manually place circuit network wires.
|-
| Write to console || Allow use of chat/console.
|}

Permissions

2024-08-16T03:41:24Z

CodeGreen:

The permissions system provides control over what players are allowed to do while in a specific game. This system is most useful in [[multiplayer]], but may also be used in singleplayer. The permissions menu can be opened using the /permissions command. It is important to note that the permissions system is based on input actions, which are what gets sent from clients to the host. This means that some permissions don't prevent you from changing things that are client side, only that changing those things won't be reflected from the server's perspective.

== Overview ==
{| class="wikitable"
! Permission !! Description
|-
| Activate copy || Get a copy tool by pressing Ctrl + C or the copy button on the shortcut bar.
|-
| Activate cut || Get a cut tool by pressing Ctrl + X or the cut button on the shortcut bar.
|-
| Activate paste || Get a paste tool by pressing Ctrl + V or the paste button on the shortcut bar.
|-
| Add permission group || Create a new permission group in the permissions settings.
|-
| Add train station || Add a train station to a train schedule.
|-
| Admin action || Do anything that requires admin permissions, such as using commands like /ban or opening other players.
|-
| Alt reverse select area || Right click and hold Shift while using a selection tool.
|-
| Alt select area || Hold Shift when using a selection tool.
|-
| Alt select blueprint entities || Select blueprint while holding shift to skip the blueprint edit window.
|-
| Alternative copy || Copy while holding Shift to open a blueprint edit window.
|-
| Begin mining || Mine an entity
|-
| Begin mining terrain || Mine any tile (removing paving)
|-
| Build || Place an entity.
|-
| Build rail || Use the rail planner
|-
| Build terrain || Place any tile.
|-
| Cancel craft || Cancel items in the handcrafting queue
|-
| Cancel deconstruct || Cancel deconstruction plans by selecting entities/tiles marked for deconstruction with a deconstruction planner while holding Shift.
|-
| Cancel new blueprint || Exit out of the blueprint editing menu by pressing escape (X button still works).
|-
| Cancel research || Cancel ongoing research (Does not correctly show in research gui in singleplayer, research will appear cancelled but resumes as soon as window is closed)
|-
| Cancel upgrade || Cancel an entity upgrade created with the upgrade planner.
|-
| Change active character tab || ? (Switching between the crafting and logistics tabs when flat gui is enabled still works as normal)
|-
| Change active item group for crafting || ?
|-
| Change active item group for filters || ?
|-
| Change active quick bar || Change which quick bar row is selected (only affects server)
|-
| Change arithmetic combinator parameters || Make changes to any of the settings of arithmetic combinators.
|-
| Change decider combinator parameters || Make changes to any of the settings of decider combinators.
|-
| Change entity label || ?
|-
| Change item description || ?
|-
| Change item label || ?
|-
| Change multiplayer config || Use /config to edit the multiplayer settings.
|-
| Change picking state || Pick up items from the floor by holding F.
|-
| Change programmable speaker alert parameters || Change any of the programmable speaker's alert settings.
|-
| Change programmable speaker circuit parameters || Change the programmable speaker's "signal value is pitch" setting.
|-
| Change programmable speaker parameters || Change the programmable speaker's "Volume", "Global playback" and "Allow polyphony" settings.
|-
| Change riding state || Control any vehicle (getting in and out is still possible).
|-
| Change shooting state || Shoot at anything.
|-
| Change train stop station || Change the name of a train stop.
|-
| Change train wait condition || Add or remove wait conditions in a train schedule.
|-
| Change train wait condition data || Edit the contents of wait conditions in a train schedule.
|-
| Clear cursor || Clear the cursor by pressing Q.
|-
| Connect rolling stock || Connect multiple trains together using the "connect rolling stock" keybind.
|-
| Copy || Copy entities using the copy tool.
|-
| Copy entity settings || Copy the settings of an entity with Shift + RMB.
|-
| Copy opened blueprint || Make a copy of an opened blueprint using the "create copy of this" button.
|-
| Copy opened item || Make a copy of an opened item that is not a blueprint (i.e. planners) using the "create copy of this" button.
|-
| Craft || Handcraft recipes from your inventory.
|-
| Cursor split || Pick up half a stack of items from an inventory by right clicking it.
|-
| Cursor transfer || Pick up a stack of items from an inventory by clicking it.
|-
| Custom input || Use custom inputs defined by mods.
|-
| Cycle blueprint book backwards || Cycle through the blueprints in a blueprint book in reverse order with Shift + Scroll.
|-
| Cycle blueprint book || Cycle through the blueprints in a blueprint book by scrolling.
|-
| Deconstruct || Mark items for deconstruction using a deconstruction planner.
|-
| Delete blueprint library || Delete a blueprint that is placed in the player's personal blueprint library. (Taking the blueprint out and then deleting it still works.)
|-
| Delete blueprint record || Delete a blueprint that is placed in the Game blueprints menu. (Taking the blueprint out and then deleting it still works.)
|-
| Delete custom tag || Delete a custom tag that has been placed on the map.
|-
| Delete permission group || Delete a permission group in the permission setting.
|-
| Destroy item || Ctrl + MMB in the editor to delete an item.
|-
| Destroy opened item || Destroy a blueprint or planner that is opened using the Destroy button.
|-
| Disconnect rolling stock || Disconnect wagons using the "disconnect rolling stock" keybind.
|-
| Drag train schedule || Rearrange stations in a train schedule by dragging them.
|-
| Drag train wait condition || Rearrange wait conditions in a train schedule by dragging them.
|-
| Drop blueprint record || Drop a blueprint from your blueprint library onto the ground by pressing Z.
|-
| Drop item || Drop an item onto the floor by pressing Z.
|-
| Edit blueprint tool preview || Edit the name, icon or description fields of a blueprint.
|-
| Edit custom tag || Edit a custom tag that has been placed on the map.
|-
| Edit permission group || Edit the settings for an existing permission group in the permissions settings.
|-
| Export blueprint || Export a blueprint to a blueprint string.
|-
| Fast entity split || Fast transfer half a stack of items to an entity by holding a stack and pressing Ctrl + RMB.
|-
| Fast entity transfer || Fast transfer a stack of items to an entity by holding a stack and pressing Ctrl + LMB.
|-
| Flush opened entity fluid || Flush fluids from a specific entity.
|-
| Flush opened entity specific fluid || Flush fluids from a connected fluid network.
|-
| Go to train station || Send a train to a specific station in its schedule. (Temporary stops still work)
|-
| Grab blueprint record || Take blueprints out of the blueprint library. (Copying still works)
|-
| Gui checked state changed || Toggle check boxes in modded GUIs
|-
| Gui click || Click elements in modded GUIs.
|-
| Gui confirmed || Press E to confirm modded GUIs.
|-
| Gui elem changed || Change a button's selected element in modded GUIs.
|-
| Gui hover || Hover over elements in modded GUIs.
|-
| Gui leave || Stop hovering over elements in modded GUIs.
|-
| Gui location changed || Drag modded GUIs around the screen.
|-
| Gui selected tab changed || Select tabs of tabbed panes in modded GUIs.
|-
| Gui selection state changed || Change dropdowns or list boxes in modded GUIs.
|-
| Gui switch state changed || Toggle switches in modded GUIs.
|-
| Gui text changed || Edit textboxes or textfields in modded GUIs.
|-
| Gui value changed || Change sliders in modded GUIs.
|-
| Import blueprint || ? (May only work in multiplayer?)
|-
| Import blueprint string || Import blueprints using the import blueprint string menu.
|-
| Import blueprints filtered || ?
|-
| Import permissions string || Import a permissions string in the permissions settings.
|-
| Inventory split || Quick transfer half of all items or all items of a specific kind to another inventory with Ctrl + RMB
|-
| Inventory transfer || Quick transfer all items or all items of a specific kind from one inventory to another with Ctrl + LMB
|-
| Launch rocket || Launch a rocket from the rocket silo
|-
| Lua shortcut || Use a modded shortcut from the bottom right buttons.
|-
| Map editor action || Use any of the features of the map editor (opening it is still possible).
|-
| Market offer || Interact with the market entity.
|-
| Mod settings changed || Change any mod settings.
|-
| Open achievements gui || Open the Achievements menu.
|-
| Open blueprint library gui || Open the blueprint library.
|-
| Open blueprint record || Open the blueprint edit menu for any blueprint in the blueprint library.
|-
| Open bonus gui || Open the bonuses menu.
|-
| Open character gui || Open the character inventory/crafting menu
|-
| Open current vehicle gui || Open the gui of the currently driven vehicle with the button at the bottom-left of the screen.
|-
| Open equipment || Open the menus of individual personal equipment items. (No openable equipment exists in vanilla)
|-
| Open gui || Open any entity menus.
|-
| Open item || Open the editing menus of blueprints and planners.
|-
| Open logistic gui || Open the logistic networks menu.
|-
| Open mod item || Open a modded item with inventory.
|-
| Open parent of opened item || Directly open the parent inventory of items such as blueprint books.
|-
| Open production gui || Open the production statistics menu.
|-
| Open technology gui || Open the tech tree menu.
|-
| Open tips and tricks gui || Open the tips and tricks menu.
|-
| Open train gui || Open the trains overview menu.
|-
| Paste entity settings || Paste the settings of an entity with Shift + LMB.
|-
| Place equipment || Place personal equipment into equipment grids.
|-
| Quick bar pick slot || Select items placed on the quick bar.
|-
| Quick bar set selected page || Change the selected quick bar page.
|-
| Quick bar set slot || Reassign a quick bar slot to hold a new item. (Assigning items to empty slots is still possible)
|-
| Reassign blueprint || Select new contents for a blueprint.
|-
| Remove cables || Remove cables from power boles using Shift + LMB.
|-
| Remove train station || Remove stations from train schedules.
|-
| Reset assembling machine || Remove the recipe from an assembling machine.
|-
| Reset item || Reset items such as spidertron remotes.
|-
| Reverse select area || Right click while using a selection tool.
|-
| Rotate entity || Rotate already placed entities.
|-
| Select area || Left click while using a selection tool.
|-
| Select blueprint entities || Select entities to include in a blueprint.
|-
| Select entity slot || Set entity filters in deconstruction planners.
|-
| Select item || ? (something to do with spidertrons)
|-
| Select mapper slot || Set upgrade filters in upgrade planners.
|-
| Select next valid gun || Switch between weapons by pressing Tab.
|-
| Select tile slot || Set tile filters in deconstruction planners.
|-
| Send spidertron || Use the remote control to send a spidertron somewhere.
|-
| Set auto launch rocket || Set a rocket silo to automatically launch rockets.
|-
| Set autosort inventory || Change the "always keep the player's main inventory sorted" setting. (Setting will still change, but the change has no effect.)
|-
| Set behaviour mode || ?
|-
| Set car weapons control || Change who has control of the weapons in a car when there are multiple people on board.
|-
| Set circuit condition || Change the enabled condition settings on any circuit connected entities.
|-
| Set circuit mode of operation || Change the mode of operation settings on any circuit controlled entities.
|-
| Set controller logistic trash filter item || Change the maximum count for a personal logistic request.
|-
| Set deconstruction item trees and rocks only || Change the deconstruction planner's "trees/rocks only" checkbox.
|-
| Set entity color || Change the color of any entity that supports this.
|-
| Set entity energy property || Change the settings on an electric energy interface (editor only item).
|-
| Set entity logistic trash filter item || Change the maximum count for an entity's logistic request.
|-
| Set filter || Filter inventory slots to a specific item.
|-
| Set flat controller gui || ? (does not affect changing to/from flat character gui)
|-
| Set heat interface mode || Set the mode of a heat interface (editor only item).
|-
| Set heat interface temperature || Set the temperature on a heat interface (editor only item).
|-
| Set infinity container filter item || Change the filters on infinity chests (editor only item)
|-
| Set infinity container remove unfiltered items || Change the remove unfiltered items setting on infinity chests (editor only item).
|-
| Set infinity pipe filter || Set the fluid type on an infinity pipe (editor only item).
|-
| Set inserter max stack size || Change the stack size limit on inserters.
|-
| Set inventory bar || Set the inventory limit in chests or other inventories.
|-
| Set linked container link ID || Change which network linked chests are connected to (editor only item).
|-
| Set logistic filter item || Change any personal logistics request filters.
|-
| Set logistic filter signal || Change output signals on constant combinators.
|-
| Set player color || Change the color of the player's character.
|-
| Set recipe notifications || Change whether new recipes are marked as new in the crafting menu.
|-
| Set request from buffers || Change the "request from buffer chests" setting on requester chests.
|-
| Set research finished stops game || Set whether the technology tree opens automatically after finishing a research.
|-
| Set signal || ?
|-
| Set splitter priority || Change the priority settings on splitters.
|-
| Set train stopped || Toggle trains between manual and automatic modes.
|-
| Set trains limit || Change the train limit setting on train stops.
|-
| Set vehicle automatic targeting parameters || Change the automatic targeting settings on autonomous vehicles such as the spidertron.
|-
| Setup assembling machine || Set the recipe on assembling machines that do not have a recipe set.
|-
| Setup blueprint || Create a blueprint from the blueprint edit menu.
|-
| Setup single blueprint record || ?
|-
| Smart pipette || Smart pipette functions such as selecting a miner when using the pipette on ore.
|-
| Spawn item || ?
|-
| Stack split || Transfer half a stack of items to another inventory with Shift + RMB.
|-
| Stack transfer || Transfer a stack of items to another inventory with Shift + LMB.
|-
| Start repair || Repair entities using a repair pack.
|-
| Start research || Start new research in the tech tree menu.
|-
| Start walking || Walk around.
|-
| Stop building by moving || ?
|-
| Switch connect to logistic network || Connect or disconnect machines from the logistic network.
|-
| Switch constant combinator state || Toggle constant combinators on or off.
|-
| Switch inserter filter mode state || Switch between blacklist and whitelist on filter inserters.
|-
| Switch power switch state || Toggle power switches on or off.
|-
| Switch to rename stop gui || Open the rename train stop menu by clicking the pencil icon next to the stop name.
|-
| Take equipment || Remove equipment from an equipment grid.
|-
| Toggle deconstruction item entity filter mode || Toggle the "entities only" switch on deconstruction planners.
|-
| Toggle deconstruction item tile filter mode || Toggle the "tiles only" switch on deconstruction planners.
|-
| Toggle driving || Enter or exit vehicles.
|-
| Toggle enable vehicle logistic requests || Toggle logistic requests of vehicles on or off.
|-
| Toggle entity logistic requests || Toggle personal logistics and auto-trash on or off for entities.
|-
| Toggle equipment movement bonus || Toggle exoskeletons on or off.
|-
| Toggle map editor || Open or close the map editor.
|-
| Toggle personal logistic requests. || Toggle personal logistic requests on or off.
|-
| Toggle personal roboport || Toggle personal roboports on or off.
|-
| Toggle show entity info || Toggle "alt mode".
|-
| Translate string || ?
|-
| Undo || Undo the previous action with Ctrl + Z.
|-
| Upgrade || Apply an upgrade using the upgrade planner.
|-
| Upgrade opened blueprint by item || Apply a pre-existing upgrade planner to an open blueprint.
|-
| Upgrade opened blueprint by record || Apply a default upgrade planner to an open blueprint.
|-
| Use artillery remote || Use the artillery remote to target artillery.
|-
| Use item || Use consumable items such as capsules.
|-
| Wire dragging || Manually place circuit network wires.
|-
| Write to console || Allow use of chat/console.
|}

Railway/Train path finding

2024-05-17T18:29:37Z

CodeGreen:

{{Languages}}
Before a train moves to a target (in this case, a [[Train stop]]), it calculates the best route based on the railway network at that time.

== Path finding penalties ==

For calculation it uses a simple [[WIKIPEDIA:A*_search_algorithm|A*-algorithm]]<sup>[https://www.factorio.com/blog/post/fff-331]</sup>: The pathfinder first builds a list of non-disabled stops that match the name in the schedule, then searches outward from both ends of the train at once, if applicable, in segments. A segment is an uninterrupted plain sequence of rails, with no intersections, stops, or signals (all of which define segment borders). The cost (distance) is calculated using the following weighting rules:
* Base cost for a block/segment is the length of the segment (linear grid length along the center of the rail).
* When the rail block is occupied by a train -> Add a penalty of 2 * length of the block divided by the number of blocks from the start, so the far away occupied paths don't matter much.
* When the rail block is guarded by a [[rail signal]] set to red by the [[circuit network]] -> Add a penalty of 1000.
* When the path includes a train stop -> Add a penalty of 2000.
* When the rail block contains a train that is stopped at a train stop -> Add a penalty of 500.
* When the rail block contains a train that is stopped at a train stop and the train doesn't have other valid stops in its schedule -> Add a penalty of 1000.
* When the rail block contains a manually controlled stopped train with a passenger -> Add a penalty of 2000.
* When the rail block contains a manually controlled stopped train without a passenger -> Add a penalty of 7000.
* When the rail block contains an automatic train without a schedule -> Add a penalty of 7000.
* When the rail block contains a train currently arriving to a train stop -> Add a penalty of 100.
* When the rail block contains a train currently arriving to a rail signal -> Add a penalty of 100.
* When the rail block contains a train currently waiting at a rail signal -> Add a penalty of 100 + 0.1 for every tick the train has already waited.
* When the rail block contains a train that doesn't have a path -> Add a penalty of 1000.

== Path Revalidation ==
A rail path will be revalidated if any event happens that could make this trains path invalid. If the path is found to be invalid then the game will repath the train. Path revalidation just confirms that the current path is still valid and does not confirm that it is still the best.
The following events cause path revalidation:
* A rail is destroyed (all trains are revalidated).
* A rail is created and invalidates a signal (all trains are revalidated) .
* A signal (chain or regular) is created or destroyed (all trains are revalidated).
* A rail block changes and invalidates a signal (chain or regular) (all trains are revalidated).
* [https://lua-api.factorio.com/latest/LuaTrain.html#LuaTrain.recalculate_path LuaTrain::recalculate_path()] is called on the train by a script.
* The train's schedule is changed.
* The train's braking force gets changed and the train is currently driving normally, arriving at a signal (chain or regular) or arriving at a station.
* The train has waited at a chain signal for a multiple of 5 seconds.

== Repath events ==
There are a number of events that can cause a train to repath listed below. When one of these conditions is met the game considers possible paths from the train's current location to any train stop matching the destination name in the train's schedule and will chose the path with the lowest score according to the penalties listed above.
=== User / script generated events ===
* A locomotive that is part of the train is rotated.
* [https://lua-api.factorio.com/latest/LuaTrain.html#LuaTrain.recalculate_path LuaTrain::recalculate_path(true)] is called on the train by a script.
* The train is switched to automatic control when it was previously manually controlled.
* The train is set to go to a station using the "Go to stop" button in the train's GUI.
* A waypoint (train stop without wait condition) is removed from the train's schedule.

=== Repaths that happen as part of normal train operation ===
* A train fails a revalidation.
* The train stop a train is heading to is renamed or destroyed.
* The train is preparing to stop at a signal (chain or regular) that changes so that the train can now continue.
* The train is braking for a signal (chain or regular) it cant reserve.
* The train enters a new rail block and can't reserve the next needed signal (chain or regular).
* The train has waited at a chain signal for a multiple of 5 seconds and there are multiple train stops with the same name as the destination.
* The train has waited at a chain signal for a multiple of 30 seconds and there is only a single train stop with the same name as the destination.
* The train wants to depart from a signal (chain or regular) that it stopped at.
* The train wants to depart from a train stop.
* The train is pathing to a train stop that gets disabled.

=== Destination full / No path trains ===
* A rail gets created.
* A train stop that is part of the train's schedule gets enabled, renamed or created.
* The train limit of a train stop that is part of the train's schedule becomes not full.
* The train stop that it currently cannot reach gets disabled or destroyed.

=== Others ===
* The train collides with something that is not a train (like a player).

== History ==

{{History|0.18.1|
* Train stop at train's starting segment exit is no longer counted into penalty. (Not mentioned above)}}

{{History|0.17.38|
* When a train performs path finding while in a chain signal sequence, the pathfinding will have a constraint to not go through reserved block before exiting the chain sequence. This solves a problem of train intersections being possible to be deadlocked even with proper chain signals usage in cases of using temporary stops or when path is changed because of station is being enabled/disabled by a circuit network. This also allowed us to to let train recalculate path spontaneously even in chain signal sequence, as it shouldn't break anything now.}}

{{History|0.16.42|
* Added train path finding penalty for train with no path equal to 1000 tiles}}

{{History|0.16.0|
* The specific penalties can now be found in the utility constants, which allows mods to change them. (Undocumented)}}

{{History|0.15.0|
* Train station adds 2000 tiles penalty when path finding, so trains try to avoid stations not related to their path.}}

{{History|0.11.17|
* Increased the pathing penalty for non-moving train in manual mode from 200 to 1000.}}

{{History|0.11.13|
* Stopped, manually controlled train adds additional penalty (related to train path finding) of 200 tiles to the block it occupies.}}

{{History|0.11.11|
* The pathfinding is based on penalties for blocked segments now. For trains waiting in station, the more remaining time in the station, the bigger penalty.}}

== See also ==

* [https://gist.github.com/Rseding91/c0d4d08d6feaed618ed4a03f6c6a8fe6 Train pathfinding code]
* [https://www.factorio.com/blog/post/fff-331 FFF #331]
* [https://www.factorio.com/blog/post/fff-68 FFF #68]
* [[Railway]]

{{C|Railway{{!}}#Railway/Train path finding}}

User:CodeGreen

2024-02-27T19:45:06Z

CodeGreen:

Hello!

I make [https://mods.factorio.com/user/_CodeGreen mods], [https://forums.factorio.com/viewtopic.php?f=194&t=100614 rail intersections], and anything else that comes to mind I post over on the [https://discord.gg/factorio main discord].

User:CodeGreen

2024-02-27T19:43:56Z

CodeGreen: Created page with "Hello! I make [https://mods.factorio.com/user/%20CodeGreen mods], [https://forums.factorio.com/viewtopic.php?f=194&t=100614 rail intersections], and anything else that comes to mind I post over on the [https://discord.gg/factorio main discord]."

Hello!

I make [https://mods.factorio.com/user/%20CodeGreen mods], [https://forums.factorio.com/viewtopic.php?f=194&t=100614 rail intersections], and anything else that comes to mind I post over on the [https://discord.gg/factorio main discord].

Iron plate

2023-10-22T01:10:48Z

CodeGreen: missing period lol

{{Languages}}
{{:Infobox:Iron plate}}

The '''iron plate''' is a material that can be made by smelting [[iron ore]] in a [[furnace]]. It is a component or subcomponent of almost every item in Factorio, and it is recommended to create a large stockpile when possible. When smelted in a furnace for a second time, iron plates will transform into [[steel plate]]s, with a ratio of 5 iron plates per 1 steel plate.

When starting a new freeplay game, the player starts out with 8 iron plate, along with 1 [[burner mining drill]] and 1 [[stone furnace]].
== Achievements ==
{{Achievement|iron-throne-1}}
{{Achievement|iron-throne-2}}
{{Achievement|iron-throne-3}}

== History ==
{{History|0.17.0|
* Crafting time reduced from 3.5 to 3.2 seconds.}}
{{History|0.1.0|
* Introduced}}

== See also ==
* [[Iron gear wheel]]
* [[Copper plate]]

{{IntermediateNav}}
{{C|Materials}}

Steel plate

2023-10-22T01:10:18Z

CodeGreen:

{{Languages}}
{{:Infobox:Steel plate}}
The '''steel plate''' is an advanced material made by smelting [[iron plate]]s again. It is used in many advanced recipes, including electrical distribution logistics, military items, and upgraded production machines. Some of these products in turn are used in the [[Production science pack]], which requires a total of 25 steel plates.

Because the recipe for steel contains a ratio of 5 iron : 1 steel, it requires less space to transport once processed. Because of this, it is easier to transport the finished steel instead of smelting the steel where it needs to be used.

== History ==

{{History|0.17.0|
* Crafting time reduced from 17.5 to 16 seconds.}}

{{history|0.10.0|
* New icons}}

{{history|0.2.8|
* Proper ordering of steel plate vs iron plate.}}

{{history|0.2.1|
* Larger stack size}}

{{history|0.1.0|
* Introduced}}

{{IntermediateNav}}
{{C|Materials}}

Iron plate

2023-10-22T01:09:35Z

CodeGreen:

{{Languages}}
{{:Infobox:Iron plate}}

The '''iron plate''' is a material that can be made by smelting [[iron ore]] in a [[furnace]]. It is a component or subcomponent of almost every item in Factorio, and it is recommended to create a large stockpile when possible. When smelted in a furnace for a second time, iron plates will transform into [[steel plate]]s, with a ratio of 5 iron plates per 1 steel plate.

When starting a new freeplay game, the player starts out with 8 iron plate, along with 1 [[burner mining drill]] and 1 [[stone furnace]].
== Achievements ==
{{Achievement|iron-throne-1}}
{{Achievement|iron-throne-2}}
{{Achievement|iron-throne-3}}

== History ==
{{History|0.17.0|
* Crafting time reduced from 3.5 to 3.2 seconds}}
{{History|0.1.0|
* Introduced}}

== See also ==
* [[Iron gear wheel]]
* [[Copper plate]]

{{IntermediateNav}}
{{C|Materials}}

Mod images API

2023-08-13T04:54:10Z

CodeGreen: wrong type on URL + Thumbnail

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Public|Public API]]</div>
The mod images API is used to add, reorder or remove mod images on the Factorio mod portal. It requires an API key with the <code>ModPortal: Edit Mods</code> usage, which can be created on https://factorio.com/profile.

It accepts <code>multipart/form-data</code> HTTP requests and responds with JSON encoded objects.

== Endpoints ==

=== add ===

{| class="wikitable"
| URL || https://mods.factorio.com/api/v2/mods/images/add
|-
| HTTP Method || <code>POST</code>
|}

HTTP Request Header
{| class="wikitable"
| Authorization|| <code>Bearer $APIKey</code> || Authorization header with the APIKey and a "Bearer " prefix -> "Bearer $APIKey"
|}

HTTP Request Body
{| class="wikitable"
| mod || string || Name of the mod, for which a new image will be uploaded
|}

JSON object response
{| class="wikitable"
| upload_url || string || URL the image should be uploaded to
|-
| error || string || This attribute only appears on <strong>failed</strong> requests.
|-
| message || string || This attribute only appears on <strong>failed</strong> requests. Has details about the problem.
|}

=== finish_upload ===
{| class="wikitable"
|-
| URL || <code>$upload_url</code> URL returned by the add endpoint
|-
| HTTP Method || <code>POST</code>
|-
|}

HTTP Request Body
{| class="wikitable"
| image || Image file
|}

JSON object response
{| class="wikitable"
| id || string || This attribute only appears on <strong>successful</strong> uploads. SHA1 of the uploaded image.
|-
| url || string || This attribute only appears on <strong>successful</strong> uploads. Url of the uploaded image.
|-
| thumbnail || string || This attribute only appears on <strong>successful</strong> uploads. Url of thumbnail of the uploaded image.
|-
| error || string || This attribute only appears on <strong>failed</strong> uploads.
|-
| message || string || This attribute only appears on <strong>failed</strong> uploads. Has details about the problem.
|}

=== edit ===
{| class="wikitable"
|-
| URL || https://mods.factorio.com/api/v2/mods/images/edit
|-
| HTTP Method || <code>POST</code>
|-
|}

HTTP Request Header
{| class="wikitable"
| Authorization|| <code>Bearer $APIKey</code> || Authorization header with the APIKey and a "Bearer " prefix -> "Bearer $APIKey"
|}

HTTP Request Body
{| class="wikitable"
|-
| mod || string || Name of the mod, for which a new image will be uploaded
|-
| images || string || List of comma-seperated image ids that should be displayed on the mod page
|-
|}

JSON object response
{| class="wikitable"
| success || bool || This attribute only appears on <strong>successful</strong> uploads. It's set to true.
|-
| images || list || This attribute only appears on <strong>successful</strong> uploads. List of objects with id, url and thumbnail attribute same as finish_upload endpoint.
|-
| error || string || This attribute only appears on <strong>failed</strong> uploads.
|-
| message || string || This attribute only appears on <strong>failed</strong> uploads. Has details about the problem.
|}

== Possible API Error Responses ==
Possible values for the <code>error</code> property of API responses
{| class="wikitable"
| InvalidApiKey || Missing or invalid API key for the current endpoint
|-
| InvalidRequest || Invalid request.
|-
| InternalError || Internal error, please try again later.
|-
| Forbidden || Insufficent permission for current endpoint
|-
| Unknown || Unknown error, please try again later.
|-
| InvalidImageUpload || Invalid image file uploaded.
|-
| UnknownMod || Mod does not exist in mod portal
|-

|}

== Python Examples ==
=== Add Image ===
<syntaxhighlight lang="python">
import sys
import requests
from os import getenv

MOD_PORTAL_URL = "https://mods.factorio.com"
INIT_UPLOAD_URL = f"{MOD_PORTAL_URL}/api/v2/mods/images/add"

apikey = getenv("MOD_EDIT_API_KEY")
modname = sys.argv[1]
filepath = sys.argv[2]

request_body = data = {"mod": modname}
request_headers = {"Authorization": f"Bearer {apikey}"}

response = requests.post(INIT_UPLOAD_URL, data=request_body, headers=request_headers)

if not response.ok:
print(f"init_upload failed: {response.text}")
sys.exit(1)

upload_url = response.json()["upload_url"]

with open(filepath, "rb") as f:
request_body = {"image": f}
response = requests.post(upload_url, files=request_body)

if not response.ok:
print(f"upload failed: {response.text}")
sys.exit(1)

print(f"upload successful: {response.text}")

</syntaxhighlight>

=== Edit Images ===
<syntaxhighlight lang="python">
import sys
import requests
from os import getenv

MOD_PORTAL_URL = "https://mods.factorio.com"
EDIT_MOD_URL = f"{MOD_PORTAL_URL}/api/v2/mods/images/edit"

apikey = getenv("MOD_EDIT_API_KEY")
modname = getenv("MOD_NAME")

image_ids = ["fdc375d5ca3c263fedafb7ef143c82f9fb668472", "47bda5cd27ef49fe86fe03f803cb5c351a848586"]
image_ids_text = ",".join(image_ids)

request_body = data = {"mod": modname, "images": image_ids_text}
request_headers = {"Authorization": f"Bearer {apikey}"}

response = requests.post(EDIT_MOD_URL, data=request_body, headers=request_headers)

if not response.ok:
print(f"edit failed: {response.text}")
sys.exit(1)

print(f"edit successful: {response.text}")

</syntaxhighlight>
{{Languages}}[[Category:Technical]]

Prototype/SelectionTool

2023-05-15T01:56:43Z

CodeGreen: Selecty -> Selects

{{Prototype parent|Prototype/ItemWithLabel}}
Used in the base game as a base for the blueprint item and the deconstruction item.

{{Prototype TOC|selection-tool}}

== Extensions ==
* [[Prototype/BlueprintItem]] '''blueprint'''
* [[Prototype/CopyPasteTool]] '''copy-paste-tool'''
* [[Prototype/DeconstructionItem]] '''deconstruction-item'''
* [[Prototype/UpgradeItem]] '''upgrade-item'''

== Mandatory properties ==
This prototype inherits all the properties from [[Prototype/ItemWithLabel]].

{{Prototype property|selection_color|[[Types/Color|Color]]}}
The color of the rectangle used when standard selection is done in-game.

{{Prototype property|alt_selection_color|[[Types/Color|Color]]}}
The color of the rectangle used when alt-selection is done in-game.

{{Prototype property|selection_mode|[[Types/table|table]] of [[Types/string|string]]}}
A list of selection mode flags that define how the selection tool selects things in-game.

Possible values are:
{| class="wikitable"
|-
! Flag !! meaning
|-
| blueprint || Selects entities and tiles as if selecting them for a blueprint.
|-
| deconstruct || Selects entities and tiles as if selecting them for deconstruction.
|-
| cancel-deconstruct || Selects entities and tiles as if selecting them for deconstruction cancellation.
|-
| items || Selects items on the ground.
|-
| trees || Selects trees.
|-
| buildable-type || Selects entities which are considered [https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building a building], plus landmines.
|-
| nothing || Selects no entities or tiles, but is useful to select an area.
|-
| items-to-place || Selects entities and tiles that can be built by an item.
|-
| any-entity || Selects all entities.
|-
| any-tile || Selects all tiles.
|-
| same-force || Selects entities with the same force as the selecting player.
|-
| not-same-force || Selects entities with a different force as the selecting player.
|-
| friend || Selects entities from a friendly force.
|-
| enemy || Selects entities from an enemy force.
|-
| upgrade || Selects entities as if selecting them for upgrading.
|-
| cancel-upgrade || Selects entities as if selecting them for upgrade cancellation.
|-
| downgrade || Selects entities as if selecting them for downgrading.
|-
| entity-with-health || Selects entities that are an [[Prototype/EntityWithHealth]].
|-
| entity-with-force || Deprecated. Replaced by "is-military-target".
|-
| is-military-target || Selects entities which are [[Prototype/EntityWithOwner#is_military_target]].
|-
| entity-with-owner || Selects entities that are an [[Prototype/EntityWithOwner]].
|-
| avoid-rolling-stock || Selects entities that are not a [[Prototype/RollingStock]].
|-
| entity-ghost || Selects entities that are an [[Prototype/EntityGhost]].
|-
| tile-ghost || Selects entities that are a [[Prototype/TileGhost]].
|}

{{Prototype property|alt_selection_mode|[[Types/table|table]] of [[Types/string|string]]}}
A list of selection mode flags that define how the selection tool alt-selects things in-game. Possible values are identical to normal selection_mode.

{{Prototype property|selection_cursor_box_type|[[Types/CursorBoxType|CursorBoxType]]}}
The type of cursor box used to render selection of entities/tiles when standard selecting.

{{Prototype property|alt_selection_cursor_box_type|[[Types/CursorBoxType|CursorBoxType]]}}
The type of cursor box used to render selection of entities/tiles when alt selecting.

== Optional properties ==

{{Prototype property|reverse_selection_color|[[Types/Color|Color]]|Value of <code>selection_color</code>|optional=true}}

{{Prototype property|alt_reverse_selection_color|[[Types/Color|Color]]|Value of <code>reverse_selection_color</code>|optional=true}}

{{Prototype property|selection_count_button_color|[[Types/Color|Color]]|Value of <code>selection_color</code>|optional=true}}

{{Prototype property|alt_selection_count_button_color|[[Types/Color|Color]]|Value of <code>alt_selection_color</code>|optional=true}}

{{Prototype property|reverse_selection_count_button_color|[[Types/Color|Color]]|Value of <code>reverse_selection_color</code>|optional=true}}

{{Prototype property|alt_reverse_selection_count_button_color|[[Types/Color|Color]]|Value of <code>alt_reverse_selection_color</code>|optional=true}}

{{Prototype property|chart_selection_color|[[Types/Color|Color]]|Value of <code>selection_color</code>|optional=true}}

{{Prototype property|chart_alt_selection_color|[[Types/Color|Color]]|Value of <code>alt_selection_color</code>|optional=true}}

{{Prototype property|chart_reverse_selection_color|[[Types/Color|Color]]|Value of <code>reverse_selection_color</code>|optional=true}}

{{Prototype property|chart_alt_reverse_selection_color|[[Types/Color|Color]]|Value of <code>alt_reverse_selection_color</code>|optional=true}}

{{Prototype property|reverse_selection_mode|[[Types/table|table]] of [[Types/string|string]]|Value of <code>selection_mode</code>|optional=true}}
A list of selection mode flags that define how the selection tool reverse-selects things in-game. Possible values are identical to normal selection_mode.

{{Prototype property|alt_reverse_selection_mode|[[Types/table|table]] of [[Types/string|string]]|Value of <code>reverse_selection_mode</code>|optional=true}}
A list of selection mode flags that define how the selection tool alt-reverse-selects things in-game (using {{Keybinding|shift|rmb}}). Possible values are identical to normal selection_mode.

{{Prototype property|reverse_selection_cursor_box_type|[[Types/CursorBoxType|CursorBoxType]]|Value of <code>selection_cursor_box_type</code>|optional=true}}
The type of cursor box used to render selection of entities/tiles when reverse-selecting.

{{Prototype property|alt_reverse_selection_cursor_box_type|[[Types/CursorBoxType|CursorBoxType]]|Value of <code>reverse_selection_cursor_box_type</code>|optional=true}}
The type of cursor box used to render selection of entities/tiles when alt-reverse-selecting (using {{Keybinding|shift|rmb}}).

{{Prototype property|always_include_tiles|[[Types/bool|bool]]|false|optional=true}}
If tiles should be included in the selection regardless of entities also being in the selection. This is a visual only setting.

{{Prototype property|mouse_cursor|[[Types/string|string]]|"selection-tool-cursor"|optional=true}}
Name of a [[Prototype/MouseCursor]].

{{Prototype property|entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Entity]] names.

{{Prototype property|alt_entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Entity]] names.

{{Prototype property|reverse_entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Entity]] names.

{{Prototype property|alt_reverse_entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Entity]] names.

{{Prototype property|entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}

{{Prototype property|alt_entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}

{{Prototype property|reverse_entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}

{{Prototype property|alt_reverse_entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}

{{Prototype property|tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Tile]] names.

{{Prototype property|alt_tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Tile]] names.

{{Prototype property|reverse_tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Tile]] names.

{{Prototype property|alt_reverse_tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Tile]] names.

{{Prototype property|entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|alt_entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|reverse_entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|alt_reverse_entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|alt_tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|reverse_tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

{{Prototype property|alt_reverse_tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
One of "whitelist" and "blacklist".

Mod portal API

2023-05-09T20:21:17Z

CodeGreen: deprecated github_path in favor of source_url

<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal|Internal API]]</div>

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

To get even more information about a mod, you can use the following URL.

<code>https://mods.factorio.com/api/mods/{name}/full</code>

== Endpoints ==

=== /api/mods ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| hide_deprecated || {boolean} || Only return non-deprecated mods.
|-
| page ||{an integer}||Page number you would like to show. Makes it so you can see a certain part of the list without getting detail on all
|-
| page_size ||{an integer or 'max'}||The amount of results to show in your search
|-
| sort || {enum, one of name, created_at or updated_at} || Sort results by this property. Defaults to name when not defined. Ignored for <code>page_size=max</code> queries.
|-
| sort_order || {enum, one of asc or desc} || Sort results ascending or descending. Defaults to descending when not defined. Ignored for <code>page_size=max</code> queries.
|-
| namelist || {array of strings} || Return only mods that match the given names. Response will include <code>releases</code> instead of <code>latest_release</code>.
|-
| version || {enum, one of 0.13, 0.14, 0.15, 0.16, 0.17, 0.18, 1.0 or 1.1} || Only return non-deprecated mods compatible with this Factorio version
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

Return short information of a specific mod.

See [[#Result Entry]], "Short" column.

=== /api/mods/{mod_name}/full ===

Returns more information of a mod.

See [[#Result Entry]], "Full" column.

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "api/mods endpoint" column, those returned by the api/mods/{name} endpoint are marked with a check in the "Short" column and those returned by the api/mods/{name}/full endpoint are marked in the "Full" column. Fields may be absent if there is no data.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | api/mods endpoint !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| downloads_count || Integer || ✓ || ✓ || ✓
| Number of downloads.
|-
| latest_release || [[#Releases|Release]]? || ✓ || ||
| The latest version of the mod available for download. Absent when the <code>namelist</code> [[#/api/mods|parameter]] is used.
|-
| name || String || ✓ || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓ || ✓
| The Factorio username of the mod's author.
|-
| releases || [[#Releases|Release]][] || ✓* || ✓ || ✓
| A list of different versions of the mod available for download. See [[#Releases]]. *Only when using <code>namelist</code> [[#/api/mods|parameter]].
|-
| summary || String || ✓ || ✓ || ✓
| A shorter mod description.
|-
| title || String || ✓ || ✓ || ✓
| The mod's human-readable name.
|-
| category || [[#Tags|Tag]]? || ✓ || ✓ || ✓
| A single tag describing the mod. See [[#Tags]].
|-
| thumbnail || String(relative URL) || || ✓ || ✓
| The relative path to the thumbnail of the mod. For mods that have no thumbnail it may be absent or default to <code>"/assets/.thumb.png"</code>. Prepend "assets-mod.factorio.com".
|-
| changelog || String || || || ✓
| A string describing the recent changes to a mod.
|-
| created_at || String(ISO 8601) || || || ✓
| ISO 6501 for when the mod was created.
|-
| description || String || || || ✓
| A longer description of the mod, in text only format.
|-
| source_url || String || || || ✓
| A URL to the mod's source code.
|-
| github_path || String || || || ✓
| Deprecated: Use <code>source_url</code> instead. A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || || || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| tag || [[#Tags|Tag]][] || || || ✓
| A list of tag objects that categorize the mod. See [[#Tags]].
|-
| license || [[#License]][] || || || ✓
| The license that applies to the mod. See [[#License]].
|-
|}

=== Releases ===

Only difference here between the api/mods/{name} endpoint and the api/mods/{name}/full endpoint is that the full one includes an array of dependencies in the info_json object.

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String
| Path to download for a mod. starts with "/download" and does not include a full url. See [[#Downloading Mods]]
|-
| file_name || String
| The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| info_json || Object
| A copy of the mod's info.json file, only contains factorio_version in short version, also contains an array of dependencies in full version
|-
| released_at || String(ISO 8601)
| ISO 6501 for when the mod was released.
|-
| version || String
| The version string of this mod release. Used to determine dependencies.
|-
| sha1 || String
| The sha1 key for the file
|-
|}

=== Tags ===

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this tag.
|-
| name || String || An all lower-case string used to identify this tag internally.
|-
| title || String || The tag's human-readable tag name.
|-
| description || String || A short description for the tag.
|-
| type || String ||
|}

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 1 || t || general || General || Mods that cannot be sorted into other categories
|-
| 2 || t || non-game-changing || Non-Game-Changing || Changes only look&feel. New graphics, new sounds, ... such things.
|-
| 3 || t || helper-mods || Helper Mods || These mods are not game-changing, but enhance the gameplay by helping you with useful functions. Mods like showing the current game-time, keep track over your resources, rail-laying...
|-
| 6 || t || big-mods || Big Mods || Too big and/or changes too much of the game to be fit anywhere else
|-
| 12 || t || transportation || Transportation || Player transport
|-
| 13 || t || logistics || Logistics || Transport of materials
|-
| 14 || t || utility || Utility || Helps with certain things the player is doing.
|-
| 15 || t || balancing || Balancing || Makes the game much more fair
|-
| 17 || t || enemies || Enemies || Adds more enemies for more challange
|-
| 16 || t || weapons || Weapons || Adds more weapons to annihilate the enemy
|-
| 18 || t || armor || Armor || Armors or armor equipment related.
|-
| 19 || t || oil || Oil || Things related to oil related manufacture
|-
| 20 || t || logistics-network || Logistics Network || Related to roboports and logistic robots
|-
| 21 || t || storage || Storage || Allows more ways to be able to store items
|-
| 22 || t || power-production || Power Production || Allows more ways to create mass amounts of energy
|-
| 23 || t || manufacture || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints ||
|-
| 25 || t || cheats || Cheats || Well, they let you cheat
|-
| 26 || t || defense || Defense || Mods that add the ability to protect your base more
|-
| 27 || t || mining || Mining || Mods that provide better or new ways of mining resources
|-
| 28 || t || info || Info || Mods that provide additional information to the player
|-
| 29 || t || trains || Trains || Related to trains
|}

=== License ===

{| class="wikitable"
! Key !! Type !! Description
|-
| description || String || A short description of the license.
|-
| id || String || The unique id of the license.
|-
| name || String || The internal name of the license.
|-
| title || String || The human-readable title of the license.
|-
| url || String || Usually a URL to the full license text, but can be any string.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| detail || String ||
|}

== Downloading Mods ==

You can get the full url by appending the download_url to mods.factorio.com, but if you're not authenticated, you will be redirected to mods.factorio.com/login. Logging in to that would give you access to the file. Fortunately, there's a better way to do this. Simply adding username and token parameters to the download url will prevent the redirecting and let you download the file immediately. The token can be acquired from a json file called "player-data.json", located in the User Data directory (see [[Application_directory#User_data_directory]]). You can also get the token by using the [[Web_authentication_API | Web Authentication API]].

Example usage:
https://mods.factorio.com/{download_url}?username={username}&token={token}

{{Languages}}[[Category:Technical]]

Types/FlameThrowerExplosionTriggerDelivery

2023-04-23T21:59:57Z

CodeGreen:

Extends [[Types/TriggerDelivery]].

== Mandatory properties ==

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

Name of a [[Prototype/Explosion]].

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

== Optional properties ==
Inherits "source_effects" and "target_effects" properties from [[Types/TriggerDelivery]].

=== direction_deviation ===
'''Type''': [[Types/float]]

'''Default''': 0

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

'''Default''': 0

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

'''Default''': 0

=== projectile_starting_speed ===
'''Type''': [[Types/float]]

'''Default''': 1

Prototype/Entity

2023-01-08T15:49:11Z

CodeGreen: Added electric network statistics to icon usage description

{{Prototype parent|PrototypeBase}}
Abstract base of all entities in the game.
Entity is basically everything that can be on the map (except tiles).
For in game script access to entity, take a look at [http://lua-api.factorio.com/latest/LuaEntity.html LuaEntity]

{{Prototype TOC|''abstract''}}

== Extensions ==
<div class="factorio-list">
* [[Prototype/Arrow]] '''arrow'''
* [[Prototype/ArtilleryFlare]] '''artillery-flare'''
* [[Prototype/ArtilleryProjectile]] '''artillery-projectile'''
* [[Prototype/Beam]] '''beam'''
* [[Prototype/CharacterCorpse]] '''character-corpse'''
* [[Prototype/Cliff]] '''cliff'''
* [[Prototype/Corpse]] '''corpse'''
** [[Prototype/RailRemnants]] '''rail-remnants'''
* [[Prototype/DeconstructibleTileProxy]] '''deconstructible-tile-proxy'''
* [[Prototype/EntityGhost]] '''entity-ghost'''
* [[Prototype/EntityParticle]] '''particle''' (for migration, cannot be used)
** [[Prototype/LeafParticle]] '''leaf-particle''' (for migration, cannot be used)
* [[Prototype/EntityWithHealth]] <abstract>
** [[Prototype/EntityWithOwner]] <abstract>
*** [[Prototype/Accumulator]] '''accumulator'''
*** [[Prototype/ArtilleryTurret]] '''artillery-turret'''
*** [[Prototype/Beacon]] '''beacon'''
*** [[Prototype/Boiler]] '''boiler'''
*** [[Prototype/BurnerGenerator]] '''burner-generator'''
*** [[Prototype/Character]] '''character'''
*** [[Prototype/Combinator]] <abstract>
**** [[Prototype/ArithmeticCombinator]] '''arithmetic-combinator'''
**** [[Prototype/DeciderCombinator]] '''decider-combinator'''
*** [[Prototype/ConstantCombinator]] '''constant-combinator'''
*** [[Prototype/Container]] '''container'''
**** [[Prototype/LogisticContainer]] '''logistic-container'''
***** [[Prototype/InfinityContainer]] '''infinity-container'''
*** [[Prototype/CraftingMachine]] <abstract>
**** [[Prototype/AssemblingMachine]] '''assembling-machine'''
***** [[Prototype/RocketSilo]] '''rocket-silo'''
**** [[Prototype/Furnace]] '''furnace'''
*** [[Prototype/ElectricEnergyInterface]] '''electric-energy-interface'''
*** [[Prototype/ElectricPole]] '''electric-pole'''
*** [[Prototype/EnemySpawner]] '''unit-spawner'''
*** [[Prototype/FlyingRobot]] <abstract>
**** [[Prototype/CombatRobot]] '''combat-robot'''
**** [[Prototype/RobotWithLogisticInterface]] <abstract>
***** [[Prototype/ConstructionRobot]] '''construction-robot'''
***** [[Prototype/LogisticRobot]] '''logistic-robot'''
*** [[Prototype/Gate]] '''gate'''
*** [[Prototype/Generator]] '''generator'''
*** [[Prototype/HeatInterface]] '''heat-interface'''
*** [[Prototype/HeatPipe]] '''heat-pipe'''
*** [[Prototype/Inserter]] '''inserter'''
*** [[Prototype/Lab]] '''lab'''
*** [[Prototype/Lamp]] '''lamp'''
*** [[Prototype/LandMine]] '''land-mine'''
*** [[Prototype/LinkedContainer]] '''linked-container'''
*** [[Prototype/Market]] '''market'''
*** [[Prototype/MiningDrill]] '''mining-drill'''
*** [[Prototype/OffshorePump]] '''offshore-pump'''
*** [[Prototype/Pipe]] '''pipe'''
**** [[Prototype/InfinityPipe]] '''infinity-pipe'''
*** [[Prototype/PipeToGround]] '''pipe-to-ground'''
*** [[Prototype/PlayerPort]] '''player-port'''
*** [[Prototype/PowerSwitch]] '''power-switch'''
*** [[Prototype/ProgrammableSpeaker]] '''programmable-speaker'''
*** [[Prototype/Pump]] '''pump'''
*** [[Prototype/Radar]] '''radar'''
*** [[Prototype/Rail]] <abstract>
**** [[Prototype/CurvedRail]] '''curved-rail'''
**** [[Prototype/StraightRail]] '''straight-rail'''
*** [[Prototype/RailSignalBase]] <abstract>
**** [[Prototype/RailChainSignal]] '''rail-chain-signal'''
**** [[Prototype/RailSignal]] '''rail-signal'''
*** [[Prototype/Reactor]] '''reactor'''
*** [[Prototype/Roboport]] '''roboport'''
*** [[Prototype/SimpleEntityWithOwner]] '''simple-entity-with-owner'''
**** [[Prototype/SimpleEntityWithForce]] '''simple-entity-with-force'''
*** [[Prototype/SolarPanel]] '''solar-panel'''
*** [[Prototype/StorageTank]] '''storage-tank'''
*** [[Prototype/TrainStop]] '''train-stop'''
*** [[Prototype/TransportBeltConnectable]] <abstract>
**** [[Prototype/LinkedBelt]] '''linked-belt'''
**** [[Prototype/Loader1x1]] '''loader-1x1'''
**** [[Prototype/Loader1x2]] '''loader'''
**** [[Prototype/Splitter]] '''splitter'''
**** [[Prototype/TransportBelt]] '''transport-belt'''
**** [[Prototype/UndergroundBelt]] '''underground-belt'''
*** [[Prototype/Turret]] '''turret'''
**** [[Prototype/AmmoTurret]] '''ammo-turret'''
**** [[Prototype/ElectricTurret]] '''electric-turret'''
**** [[Prototype/FluidTurret]] '''fluid-turret'''
*** [[Prototype/Unit]] '''unit'''
*** [[Prototype/Vehicle]] <abstract>
**** [[Prototype/Car]] '''car'''
**** [[Prototype/RollingStock]] <abstract>
***** [[Prototype/ArtilleryWagon]] '''artillery-wagon'''
***** [[Prototype/CargoWagon]] '''cargo-wagon'''
***** [[Prototype/FluidWagon]] '''fluid-wagon'''
***** [[Prototype/Locomotive]] '''locomotive'''
**** [[Prototype/SpiderVehicle]] '''spider-vehicle'''
*** [[Prototype/Wall]] '''wall'''
** [[Prototype/Fish]] '''fish'''
** [[Prototype/SimpleEntity]] '''simple-entity'''
** [[Prototype/SpiderLeg]] '''spider-leg'''
** [[Prototype/Tree]] '''tree'''
* [[Prototype/Explosion]] '''explosion'''
** [[Prototype/FlameThrowerExplosion]] '''flame-thrower-explosion'''
* [[Prototype/FireFlame]] '''fire'''
* [[Prototype/FluidStream]] '''stream'''
* [[Prototype/FlyingText]] '''flying-text'''
* [[Prototype/HighlightBoxEntity]] '''highlight-box'''
* [[Prototype/ItemEntity]] '''item-entity'''
* [[Prototype/ItemRequestProxy]] '''item-request-proxy'''
* [[Prototype/ParticleSource]] '''particle-source'''
* [[Prototype/Projectile]] '''projectile'''
* [[Prototype/ResourceEntity]] '''resource'''
* [[Prototype/RocketSiloRocket]] '''rocket-silo-rocket'''
* [[Prototype/RocketSiloRocketShadow]] '''rocket-silo-rocket-shadow'''
* [[Prototype/Smoke]] <abstract>
** [[Prototype/SimpleSmoke]] '''smoke''' (for migration, cannot be used)
** [[Prototype/SmokeWithTrigger]] '''smoke-with-trigger'''
* [[Prototype/SpeechBubble]] '''speech-bubble'''
* [[Prototype/Sticker]] '''sticker'''
* [[Prototype/TileGhost]] '''tile-ghost'''
</div>

== Mandatory properties ==
Inherits all properties from [[PrototypeBase]].

{{Prototype property|icons, icon, icon_size (IconSpecification)|[[Types/IconSpecification|IconSpecification]]}}
An icon is mandatory for entities that have at least one of these flags active: placeable-neutral, placeable-player, placeable-enemy.

The icon will be used in the electric network statistics, editor building selection, and the bonus gui.
<syntaxhighlight lang="lua">icon = "__base__/graphics/icons/wooden-chest.png"</syntaxhighlight>

== Optional properties ==

=== order ===
:''See [[PrototypeBase#order]]''
Inherited from [[PrototypeBase]].

The order string is taken from the items in <code>placeable_by</code> if they exist, or from an item that has its [[Prototype/Item#place_result|place_result]] set to this entity if it exists.

{{Prototype property|collision_box|[[Types/BoundingBox|BoundingBox]]|Empty=<nowiki>{{0, 0}, {0, 0}} means no collisions.</nowiki>|optional=true}}
Specification of the entity collision boundaries.

Empty collision box is used for smoke, projectiles, particles, explosions etc.
<syntaxhighlight lang="lua">collision_box = {{-0.4, -0.4}, {0.4, 0.4}}</syntaxhighlight>
The {0,0} coordinate in the collision box will match the entity position.

It should be near the center of the collision box, to keep correct entity drawing order. It must include the {0,0} coordinate.

Note, that for buildings, it is customary to leave 0.1 wide border between the edge of the tile and the edge of the building, this lets the player move between the building and electric poles/inserters etc.

{{Prototype property|collision_mask|[[Types/CollisionMask|CollisionMask]]|<nowiki>{"item-layer", "object-layer", "player-layer", "water-tile"}</nowiki>|optional=true}}

Two entities can collide only if they share a layer from the collision mask.

<div class="toccolours mw-collapsible mw-collapsed">
NOTE: '''Some entity types have their own default''' that differs from the above default. They are listed here:
<div class="mw-collapsible-content">
* [[Prototype/Arrow]] - no masks
* [[Prototype/ArtilleryFlare]] - no masks
* [[Prototype/ArtilleryProjectile]] - no masks
* [[Prototype/Beam]] - no masks
* [[Prototype/Car]] - <code>{"player-layer", "train-layer", "consider-tile-transitions"}</code>
* [[Prototype/Character]] - <code>{"player-layer", "train-layer", "consider-tile-transitions"}</code>
* [[Prototype/CharacterCorpse]] - no masks
* [[Prototype/Cliff]] - <code>{ "item-layer", "object-layer", "player-layer", "water-tile", "not-colliding-with-itself"}</code>
* [[Prototype/Corpse]] - no masks
* [[Prototype/DeconstructibleTileProxy]] - <code>{"ground-tile"}</code>
* [[Prototype/EntityGhost]] - <code>{"ghost-layer"}</code>
* [[Prototype/EntityParticle]] - no masks
* [[Prototype/Explosion]] - no masks
* [[Prototype/FireFlame]] - no masks
* [[Prototype/Fish]] - <code>{"ground-tile", "colliding-with-tiles-only"}</code>
* [[Prototype/FluidStream]] - no masks
* [[Prototype/FlyingRobot]] - no masks
* [[Prototype/FlyingText]] - no masks
* [[Prototype/Gate]] - <code>{"item-layer", "object-layer", "player-layer", "water-tile", "train-layer"}</code>
* [[Prototype/HeatPipe]] - <code>{"object-layer", "floor-layer", "water-tile"}</code>
* [[Prototype/HighlightBoxEntity]] - no masks
* [[Prototype/ItemEntity]] - <code>{"item-layer"}</code>
* [[Prototype/ItemRequestProxy]] - no masks
* [[Prototype/LandMine]] - <code>{"object-layer", "water-tile"}</code>
* [[Prototype/LinkedBelt]] - <code>{"object-layer", "item-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/Loader1x1]] - <code>{"object-layer", "item-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/Loader1x2]] - <code>{"object-layer", "item-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/ParticleSource]] - no masks
* [[Prototype/PlayerPort]] - <code>{"object-layer", "floor-layer", "water-tile"}</code>
* [[Prototype/Projectile]] - no masks
* [[Prototype/Rail]] - <code>{"item-layer", "object-layer", "rail-layer", "floor-layer", "water-tile"}</code>
* [[Prototype/RailSignalBase]] - <code>{"floor-layer", "rail-layer", "item-layer"}</code>
* [[Prototype/ResourceEntity]] - <code>{"resource-layer"}</code>
* [[Prototype/RollingStock]] - <code>{"train-layer"}</code>
* [[Prototype/Smoke]] - no masks
* [[Prototype/SpeechBubble]] - no masks
* [[Prototype/SpiderLeg]] - <code>{"player-layer", "rail-layer"}</code>
* [[Prototype/Splitter]] - <code>{"object-layer", "item-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/Sticker]] - no masks
* [[Prototype/TileGhost]] - <code>{"ghost-layer"}</code>
* [[Prototype/TransportBelt]] - <code>{"object-layer", "floor-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/UndergroundBelt]] - <code>{"object-layer", "item-layer", "transport-belt-layer", "water-tile"}</code>
* [[Prototype/Unit]] - <code>{"player-layer", "train-layer", "not-colliding-with-itself"}</code>
* [[Prototype/Vehicle]] - <code>{"player-layer", "train-layer"}</code>
</div></div>

{{Prototype property|map_generator_bounding_box|[[Types/BoundingBox|BoundingBox]]|The value of collision box.|optional=true}}
Used instead of the collision box during map generation. Allows space entities differently during map generation, for example if the box is bigger, the entities will be placed farther apart.

{{Prototype property|selection_box|[[Types/BoundingBox|BoundingBox]]|<nowiki>Empty = {{0, 0}, {0, 0}}</nowiki>|optional=true}}
Specification of the entity selection area.
When empty the entity will have no selection area (and thus is not selectable).
<syntaxhighlight lang="lua">selection_box = {{-0.5, -0.5}, {0.5, 0.5}}</syntaxhighlight>
The selection box is usually a little bit bigger than the collision box, for tilable entities (like buildings) it should match the tile size of the building.

{{Prototype property|drawing_box|[[Types/BoundingBox|BoundingBox]]|<nowiki>Empty = {{0, 0}, {0, 0}} (selection_box is used instead)</nowiki>|optional=true}}
Specification of space needed to see the whole entity.

This is used to calculate the correct zoom and positioning in the entity info gui.
<syntaxhighlight lang="lua">drawing_box = {{-0.5, -0.5}, {0.5, 0.5}}</syntaxhighlight>

{{Prototype property|sticker_box|[[Types/BoundingBox|BoundingBox]]|The value of collision box.|optional=true}}
Used to set the area of the entity that can have stickers on it, currently only used for units to specify the area where the green slow down stickers can appear.
It is optional and the collision box is used when not specified.
<syntaxhighlight lang="lua">sticker_box = {{-0.5, -0.5}, {0.5, 0.5}}</syntaxhighlight>

{{Prototype property|hit_visualization_box|[[Types/BoundingBox|BoundingBox]]|<nowiki>Empty = {{0, 0}, {0, 0}}</nowiki>|optional=true}}
Where beams should hit the entity. Useful if the bounding box only covers part of the entity (e.g. feet of the character) and beams only hitting there would look weird.

{{Prototype property|trigger_target_mask|[[Types/TriggerTargetMask|TriggerTargetMask]]|optional=true}}

{{Prototype property|flags|[[Types/EntityPrototypeFlags|EntityPrototypeFlags]]|optional=true}}

{{Prototype property|minable|[[Types/MinableProperties|MinableProperties]]|not minable|optional=true}}

{{Prototype property|subgroup|[[Types/string|string]]|optional=true}}
The name of the subgroup this entity should be sorted into in the map editor building selection.

{{Prototype property|allow_copy_paste|[[Types/bool|bool]]|true|optional=true}}

{{Prototype property|selectable_in_game|[[Types/bool|bool]]|true|optional=true}}

{{Prototype property|selection_priority|[[Types/uint8|uint8]]|50|optional=true}}
The entity with the higher number is selectable before the entity with the lower number. When two entities have the same selection priority, the one with the highest [[Types/CollisionMask|collision mask]] (as determined by the order on that page) is selected.

{{Prototype property|build_grid_size|[[Types/uint8|uint8]]|1|optional=true}}
Supported values are 1 (for 1x1 grid) and 2 (for 2x2 grid, like rails).

Internally forced to be <code>2</code> for [[Prototype/Rail]], [[Prototype/RailRemnants]] and [[Prototype/TrainStop]].

{{Prototype property|remove_decoratives|[[Types/string|string]]|"automatic"|optional=true}}
Either "automatic", "true" or "false". Whether this entity should remove decoratives that collide with it when this entity is built. When set to "automatic", if the entity type is considered [https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building a building] (e.g. an assembling machine or a wall) it will remove decoratives.

{{Prototype property|emissions_per_second|[[Types/double|double]]|0|optional=true}}
Amount of emissions created (positive number) or cleaned (negative number) every second by the entity.
This is passive, and it is independent concept of the emissions of machines, these are created actively depending on the power consumption.
Currently used just for trees.

<syntaxhighlight lang="lua">emissions_per_second = -0.001 -- cleaning effect of big tree</syntaxhighlight>

{{Prototype property|shooting_cursor_size|[[Types/double|double]]|optional=true}}
The cursor size used when shooting at this entity.

{{Prototype property|created_smoke|[[Types/CreateTrivialSmokeEffectItem|CreateTrivialSmokeEffectItem]]|The "smoke-building"-smoke|optional=true}}
The smoke that is shown when the entity is placed.

{{Prototype property|working_sound|[[Types/WorkingSound|WorkingSound]]|optional=true}}
Will also work on entities that don't actually do work.

{{Prototype property|created_effect|[[Types/Trigger|Trigger]]|optional=true}}
The effect/trigger that happens when the entity is placed.

{{Prototype property|build_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|mined_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|mining_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|rotated_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|vehicle_impact_sound|[[Types/Sound|Sound]]|optional=true}}
When playing this sound, the volume is scaled by the speed of the vehicle when colliding with this entity.

{{Prototype property|open_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|close_sound|[[Types/Sound|Sound]]|optional=true}}

{{Prototype property|radius_visualisation_specification|[[Types/RadiusVisualisationSpecification|RadiusVisualisationSpecification]]|optional=true}}

{{Prototype property|build_base_evolution_requirement|[[Types/double|double]]|0|optional=true}}

{{Prototype property|alert_icon_shift|[[Types/vector|vector]]|optional=true}}

{{Prototype property|alert_icon_scale|[[Types/float|float]]|optional=true}}

{{Prototype property|fast_replaceable_group|[[Types/string|string]]|""|optional=true}}
This allows you to replace an entity that's already placed, with a different one in your inventory. For example, replacing a burner inserter with a fast inserter. The replacement entity can be a different rotation to the replaced entity and you can replace an entity with the same type.

This is simply a string, so any string can be used here. The entity that should be replaced simply has to use the same string here.

The ones the game uses are:

"constant-combinator"
"container"
"furnace"
"transport-belt"
"electric-pole"
"steam-engine"
"inserter"
"long-handed-inserter"
"pipe"
"assembling-machine"
"wall"
"loader"
"rail-signal"
"linked-belts"
"mining-drill"
"pumpjack"

{{Prototype property|next_upgrade|[[Types/string|string]]|optional=true}}
Name of the entity that will be automatically selected as the upgrade of this entity when using the [[upgrade planner]] without configuration.

This entity may not have 'not-upgradable' flag set and must be minable. This entity mining result must not contain item product with "hidden" flag set. Mining results with no item products are allowed. The entity may not be a [[Prototype/RollingStock]].<br>
The upgrade target entity needs to have the same bounding box, collision mask, and fast replaceable group as this entity. The upgrade target entity must have least 1 item that builds it that isn't hidden.

{{Prototype property|protected_from_tile_building|[[Types/bool|bool]]|true|optional=true}}
When this is true, this entity prototype should be included during tile collision checks with tiles that have [[Prototype/Tile#check_collision_with_entities]] set to true.

{{Prototype property|placeable_by|[[Types/ItemToPlace|ItemToPlace]] or [[Types/table|table]] of [[Types/ItemToPlace|ItemToPlace]]|optional=true}}
Item that when placed creates this entity. Determines which item is picked when "Q" (smart pipette) is used on the entity, determines which item is needed in a blueprint of this entity.

The item count specified here can't be larger than the stack size of that item.

{{Prototype property|remains_when_mined|[[Types/string|string]] or [[Types/table|table]] of [[Types/string|string]]|optional=true}}
The entity that remains when this one is mined, deconstructed or fast-replaced. The entity wont actually be spawned if it would collide with the entity that is in the process of being mined.

{{Prototype property|additional_pastable_entities|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Names of the entity prototypes this entity prototype can be pasted on to in addition to the standard supported types.
This is used to allow copying between types that aren't compatible on the C++ code side, by allowing mods to receive the [https://lua-api.factorio.com/latest/events.html#on_entity_settings_pasted on_entity_settings_pasted] event for the given entity and do the setting pasting via script.<br>
additional_pastable_entities = {"steel-chest", "iron-chest"}

{{Prototype property|tile_width|[[Types/uint32|uint32]]|calculated by the collision box width rounded up.|optional=true}}
Used to determine how the center of the entity should be positioned when building (unless the offgrid [[Types/EntityPrototypeFlags|flag]] is specified).
When the tile width is odd, the center will be in the center of the tile, when it is even, the center is on the tile transition.

{{Prototype property|tile_height|[[Types/uint32|uint32]]|calculated by the collision box height rounded up.|optional=true}}

{{Prototype property|autoplace|[[Types/AutoplaceSpecification|AutoplaceSpecification]]|nil (entity is not autoplacable)|optional=true}}
Used to specify the rules for placing this entity during map generation.

{{Prototype property|map_color|[[Types/Color|Color]]|optional=true}}

{{Prototype property|friendly_map_color|[[Types/Color|Color]]|optional=true}}

{{Prototype property|enemy_map_color|[[Types/Color|Color]]|optional=true}}

{{Prototype property|water_reflection|[[Types/WaterReflectionDefinition|WaterReflectionDefinition]]|optional=true}}
May also be defined inside <code>graphics_set</code> instead of directly in the entity prototype. This is useful for entities that use the a <code>graphics_set</code> property to define their graphics, because then all graphics can be defined in one place.<br>
Currently only renders for [[Prototype/EntityWithHealth]].[https://forums.factorio.com/100703]

== Example ==
<syntaxhighlight lang="lua">{
type = "container",
name = "wooden-chest",
icon = "__base__/graphics/icons/wooden-chest.png",
flags = {"placeable-neutral", "player-creation"},
minable = {mining_time = 1, result = "wooden-chest"},
max_health = 100,
corpse = "small-remnants",
collision_box = {{-0.35, -0.35}, {0.35, 0.35}},
fast_replaceable_group = "container",
selection_box = {{-0.5, -0.5}, {0.5, 0.5}},
inventory_size = 16,
open_sound = { filename = "__base__/sound/wooden-chest-open.ogg" },
close_sound = { filename = "__base__/sound/wooden-chest-close.ogg" },
vehicle_impact_sound = { filename = "__base__/sound/car-wood-impact.ogg", volume = 1.0 },
picture =
{
filename = "__base__/graphics/entity/wooden-chest/wooden-chest.png",
priority = "extra-high",
width = 46,
height = 33,
shift = {0.25, 0.015625}
},
circuit_wire_connection_point =
{
shadow =
{
red = {0.734375, 0.453125},
green = {0.609375, 0.515625},
},
wire =
{
red = {0.40625, 0.21875},
green = {0.40625, 0.375},
}
},
circuit_connector_sprites = get_circuit_connector_sprites({0.1875, 0.15625}, nil, 18),
circuit_wire_max_distance = 9
}</syntaxhighlight>

Enemies

2022-09-21T10:51:33Z

CodeGreen: /* Advanced: Evolution factor components and computation */

{{Languages}}
[[File:biter_intro.png|175px|right]]'''Enemies''' (also commonly called '''Biters''') are creatures that want to [[Damage|harm]] the [[player]]. They are the native inhabitants of the extraterrestrial world in the form of arthropods living in organic nests, coexisting with each other peacefully. They are encountered in three species: Biters, spitters and worms. The species are further distinguished in four stages of growth, and thus strength. Enemies and nests show up on the map as red dots. Much like the player, enemies can slowly regain lost health.

== Achievements ==
Enemies are directly connected to the following achievements:
{{Achievement|it-stinks-and-they-dont-like-it}}
{{Achievement|steamrolled}}

==Creatures==
===Biters===
Biters are one of two main antagonists in the game. They come in four sizes: small, medium, big and behemoth. In the beginning of a game, there will only be the small ones. With increasing [[pollution]], they will become bigger, related to the enemy's [[#Evolution|evolution]]. As common sense may suggest, their method of attack is a straightforward charge to "bite" things.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_biter.png|center]] || Small Biter
| Weakest of biters, can be easily killed with a pistol.
* Health: 15
* Damage: 7 Physical
* Attack speed: 1.71/s
* Speed: 43.2km/h
* Range: 1
* Pollution to join attack: 4
|-
| [[File:medium_biter.png|center]] || Medium Biter
| Stronger and slightly faster than the small biter. Can pose a problem for and even kill weaker players.
* Health: 75
* Damage: 15 Physical
* Attack speed: 1.71/s
* Speed: 51.8km/h
* Range: 1
* Pollution to join attack: 20

[[Damage#Resistance|Resistances]]:
*Explosion: 0/10%
*Physical: 4/10%
|-
| [[File:big_biter.png|center]] || Big Biter
| Dangerous, resistant to small arms. Can attack through walls, hitting objects directly behind them.
* Health: 375
* Damage: 30 Physical
* Attack speed: 1.71/s
* Speed: 49.7km/h
* Range: 2
* Pollution to join attack: 80

Resistances:
*Explosion: 0/10%
*Physical: 8/10%
|-
| [[File:behemoth_biter.png|center]] || Behemoth Biter
| Extremely durable and nearly immune to small arms, except for the strongest ordnance. Can attack through walls, hitting objects directly behind them.
* Health: 3000
* Damage: 90 Physical
* Attack speed: 1.2/s
* Speed: 64.8km/h
* Range: 2
* Pollution to join attack: 400

Resistances:
*Explosion: 12/10%
*Physical: 12/10%

|}

===Spitters===
'''Spitters''' are much like [[Enemies#Biters|biters]] and only appear slightly later on in the game as the evolution factor increases. Their main difference from biters is their ranged attack. Using predictive aiming, they spit a stream of acid at enemies which leaves behind a puddle of acid where it hits the ground. Due to the spitters' predictive aiming, the acid stream can be dodged by suddenly changing walking directions or standing still.[https://factorio.com/blog/post/fff-279] Both the stream and the puddle of acid deal damage of time and slow down players and vehicles. Most entities of the game have a much lower resistance to acid than other damage types (including [[turret]]s and [[armor]]), so spitters are effectively more potent against the player and their factories. Their behaviour and size classification are the same as with biters, but their health is universally lower and they are resistant exclusively against explosives, with no physical resistance.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_spitter.png|center]] || Small Spitter
| Weakest of spitters. Easy to kill with any weapon, but attacks at range.
* Health: 10
* Range: 13
* Pollution to join attack: 4
* Speed: 40.0km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1
* Damage (on contact): 12 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 7.2 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 60%
** Duration: 2 seconds

|-
| [[File:medium_spitter.png|center]] || Medium Spitter
| Stronger and slower than the smaller version. Can pose a problem for and even kill weaker players.
* Health: 50
* Range: 14
* Pollution to join attack: 12
* Speed: 35.6km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.25
* Damage (on contact): 24 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 28.8 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 50%
** Duration: 2 seconds

Resistances:
*Explosion: 0/10%
|-
| [[File:big_spitter.png|center]] || Big Spitter
| An even bulkier spitter and so can take more damage.
* Health: 200
* Range: 15
* Pollution to join attack: 30
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.35
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 130 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 40%
** Duration: 2 seconds

Resistances:
*Explosion: 0/15%
|-
| [[File:behemoth_spitter.png|center]] || Behemoth Spitter
| The bulkiest of the spitters and so can take even more damage.
* Health: 1500
* Range: 16
* Pollution to join attack: 200
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.75
* Damage (on contact): 60 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 360 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 30%
** Duration: 2 seconds

Resistances:
*Explosion: 0/30%
|}

===Worms===

The Worms are natural allies of biters and spitters and will attack the player if they get close enough with an attack similar to spitters'. They act like static [[turret]]s and will not follow attackers. They rely on high damage, great range and splash damage to keep the player away from the worms and the nests they protect, but either one of these advantages can be overcome. Unlike other enemies, they are also highly resistant to fire. They will spit acid at the player, which can also leave acidic puddles on the ground that can still damage players and vehicles, as well as slow them both down and leave a brief acidic, damaging effect for a few seconds. However, placed buildings and tiles are unaffected by the acid puddles, but still take damage normally by the acid projectile.

Worms come in 4 sizes, their power increasing with size. Like biters and spitters, behemoth, big and medium worms spawning is influenced by the evolution factor. Worms are only created during enemy expansion when a certain evolution factor requirement is fulfilled. This is 0.3 for the medium worm, 0.5 for the big worm and 0.9 for the behemoth worm. Below these evolution factors, worms can only be created by the map generation. In map generation, the game restricts higher tier worms behind the distance from the starting point. The further away the player goes from the starting area, the stronger the worms become.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:Small worm.png|center]] || Small Worm
| A weak worm. It is still capable of killing the player unless it is targeted as priority.
* Health: 200
* Range: 25

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.4
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 21.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 60%
|-
| [[File:Medium worm.png|center]] || Medium Worm
| Medium worms are dangerous to even more advanced players. They should be handled with care.
* Health: 400
* Range: 30

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.55
* Damage (on contact): 48 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 57.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 50%

Resistances:
*Explosion: 5/15%
*Fire: 2/50%
*Physical: 5/0%
|-
| [[File:Big worm.png|center]] || Big Worm
| Big worms are not as much more dangerous as resilient. They are almost immune to common gunfire of any sort.
* Health: 750
* Range: 38

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.75
* Damage (on contact): 72 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 259 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 40%

Resistances:
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|-
| [[File:Behemoth worm.png|center]] || Behemoth Worm
| Behemoth worms are the most dangerous of worms. They are just as resilient as Big worms, with much greater range.
* Health: 750
* Range: 48

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 2
* Damage (on contact): 96 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 691 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 30%

Resistances:
*Acid: 0/100%
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|}

{| class="wikitable"
|-
! Picture !! Description
|-
| [[File:worm.gif]] || A worm's attack animation.
|-
|}

==Nests==

The spawn points of biters and spitters. While nests themselves are generally defenseless, the enemies they release over time effectively serve as a form of guards to distract the player and any nearby turrets, and are often accompanied by worms. Nests exposed to pollution will use it to send enemies to join attacks. Enemies not engaged in combat may seek out the nearest nest for protection.

The nests are highly resistant to fire and otherwise generally more resilient than a medium worm.

{| class="wikitable"
|-
! Picture !! Name !! Description
|-
| [[File:biter_nest.png]] || Biter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|-
| [[File:spitter_nest.png]] || Spitter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|}

=== Expansions ===
Every 4-60 minutes, a group of 5-20 biters/spitters will leave their base to create a new base which will consist of as many worms/nests as there are members in the group. This group will search for a suitable spot that's 3-7 chunks away from existing bases. The interval between enemy expansions is global, and the higher enemy evolution, the shorter the interval is on average. Furthermore, with higher evolution, the groups are bigger on average.

Once they have found a suitable spot, each biter/spitter in the group dies and forms a new nest or worm. Forming a new nest or worm will destroy anything that is in the way, which can include members of the expansion group. There is a delay between each member sacrificing itself for to create a worm/nest, so creating the new base from the expansion group can take quite a long time, depending on the group size. Medium worms are only formed if the current evolution is higher than 0.3, big worms only if the current evolution is higher than 0.5 and behemoth worms are only formed if current evolution is higher than 0.9. The game randomly chooses whether to form a new biter nest, spitter nest, small worm, or bigger worm if the evolution factor is high enough. [https://gist.github.com/Bilka2/aa88490c23124a6f214c02c73a368aa7]

==Defense==
[[File:kills_gui.png|thumb|220px|right|"Kills" tab on the [[production statistics]] screen.]]Nests spawn biters and spitters freely. However, biters and spitters will only aggressively engage the player's factory if the pollution cloud of the factory reaches a nest because pollution is consumed to send biters or spitters to join the next attack. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers. The attack then proceeds to their target over the shortest path possible, accounting for terrain, but not for player entities that could pose an obstacle (like [[wall]]s).

If there is a clear path somewhere around those obstacles, the biters will attempt to go around. If there is no clear passage or a clear passage would mean deviating too far from the original course, the biters will attack whatever is in their way to go through. This can be exploited to an extent; creating mazes at regular intervals along a barrier can direct the biters through a gauntlet not dissimilar to tower defense.

However, if a biter comes in proximity of a [[Military units and structures|military unit or structure]], it will prioritize these and attempt to immediately attack them instead, again trying to reach the new target over the shortest possible path with no too great detours, if possible.

==Evolution==
[[File:Evolution Biters.png|thumb|right|400px|Spawn chances of biters from biter spawners by evolution factor.]]
[[File:Evolution Spitters.png|thumb|right|400px|Spawn chances of spitters from spitter spawners by evolution factor.]]
[[File:Evolution Weights.png|thumb|right|400px|Weight graph of both spawners by evolution factor. The values shown are primarily for indicating when certain types start and stop spawning, for actual chances refer to the tables or other charts.]]
The evolution factor is a global variable that determines what kind of biters will be spawned. You can check the variable in the dev console via the following command (does not disable achievements):

/evolution

The evolution factor goes from 0 (not evolved at all) to 1 (maximal evolution). At the moment the evolution factor can only increase.

Besides choosing what kind of biter will be spawned, the evolution factor also influences the spawning interval. This interval (<code>spawning_cooldown</code> in the <code>enemy-spawner</code> definition) is interpolated between 360 (0 evolution) and 150 (1 evolution) game ticks (= 6 to 2.5 seconds).

=== Methods of increasing ===

The evolution factor is increased by three kinds of events:

* The passage of time very slightly increases the evolution factor.
* The global [[Pollution|pollution production]] increases the evolution factor.
* Destroying [[Enemies#Nests|nests]] significantly increases the evolution factor.

All these values are set in <code>game.map_settings.enemy_evolution</code>. From there they can be changed or modded.

The default settings are:

{| class="wikitable"
!Source per
!Variable in <code>enemy_evolution</code>
!Percent increase
|-
| [[Time#Seconds|Second]] || <code>time_factor</code> || 0.0004%
|-
| 1 Pollution unit || <code>pollution_factor</code> || 0.00009%
|-
| Destroyed enemy spawner || <code>destroy_factor</code> || 0.2%
|}

Pollution production is the total pollution produced by [[Pollution#Polluters|buildings]] per tick, not the pollution spreading on the map, so it is not reduced by trees or other absorbers.
e.g. : 10 boilers produce 300 pollution in one minute, raising the evolution factor by around 0.027%.

The percentages are applied on the base of <code>(1 - current_evolution_factor)²</code>. So for instance destroying enemy spawners in the beginning of the game results in increase of evolution factor by 0.002 (0.2%) while doing this when the evolution factor is 0.5 the increase is only 0.0005 (0.05%).

This also means that the evolution factor approaches 1 asymptotically - generally, increases past 0.9 or so are ''very'' slow and the number never actually reaches 1.0.

=== Spawn chances by evolution factor ===

The probability charts show the chances of each type of biter/spitter for each spawner at all evolution levels.

<div id="evoChecker"></div>

=== Advanced: Evolution factor components and computation ===
<div class="toccolours mw-collapsible mw-collapsed" style="width:calc(100%-400px); overflow:auto;">
This section has charts plotting the individual evolution factor components and discusses possibilities for manually estimating the evolution factor.
<div class="mw-collapsible-content">

[[File:Evolution_factor_by_time.png|400px|thumb|right|1. Single-component evolution factor increase with time]]
[[File:Evolution_factor_by_pollution.png|400px|thumb|right|2. Single-component evolution factor increase with pollution]]
[[File:Evolution_factor_by_spawners.png|400px|thumb|right|3. Single-component evolution factor increase with destroyed spawners]]

'''Notes'''

* Data from version 1.1.50.

* All charts end at approximately an evolution factor of 0.90.

* The calculation steps for time and spawner kills match those used by the game, so these charts should be accurate. The pollution chart assumes a pollution production of 1000 units per second, and due to the recursive nature of the chart values will slightly diverge at different pollution rates. The effect of this is negligible for any reasonable amount pollution production, however.

*Given that the game reports the actual evolution factor (console: <code>/evolution</code>) whenever the player wishes, these charts are intended primarily to help estimate the impact of planned base expansions and similar activities on the evolution factor's future development.

'''Comments'''

These charts (click to enlarge) represent the situation where each evolution factor component (time, pollution, destroyed spawners) is the ''only'' component contributing to the evolution factor in that entire game. They are therefore '''not realistic''', as in a typical game all three components will contribute, some at varying times and intensities.

Because of how contributions to the evolution factor (hereinafter, EF) are calculated (multiplied by <code>(1 - current EF)</code>), it is '''not''' possible to simply add the values indicated by these charts for a game's time passed, pollution generated, and / or spawners destroyed so far to retrieve the total evolution factor.

For example, if 20 hours have passed (single-component EF =~ 0.25), 10 million pollution units were released (single-component EF =~ 0.15), and 200 spawners were destroyed (single-component EF =~ 0.35), the actual evolution factor will '''not''' be (0.25 + 0.15 + 0.35 =) ~0.85.

However, the evolution factor will always be '''less''' than the sum of all individual components as indicated by these charts, and '''at least''' as high as the highest individual component. Thus, using the values from above, the EF will be ''at least'' 0.35 and ''less than'' 0.85. A smarter approach is required to compute the amount of pollution released.

'''Computation of actual evolution factor'''

The actual EF can be computed as follow :

<code> 1 - EF = (1 - E[t]) * (1 - E[p]) * (1 - E[s])</code>, where ''E[t]'', ''E[p]'', and ''E[s]'' are the single-component values from the pollution, time, and spawner charts, in that order.

A key observation in understanding where this formula comes from is that each incremental change of the evolution factor is effectively a multiplication of <code>1 - EF</code> by a constant (depending on the nature of the change). For example, another way of saying that killing a biter nest augments evolution by 0.2% of <code>1 - EF</code>, is to say that killing a biter nest multiplies <code>1 - EF</code> by 0.998.

So, like multiplication, evolution is, barring rounding errors, associative and commutative. The commutativity means that the order in which you take evolution-increasing actions does not matter, and along with the associativity results in the formula above.

That knowledge can also be applied to compute the above charts exactly, or to compute a component of evolution without having to refer to the chart at all. For example, evolution as a function of time only is <code>1 - 0.999996 ^ t</code> where t is the time in seconds.

For the values from above, we can deduce the evolution factor <code>1 - EF = (1 - 0.25) * (1 - 0.15) * (1 - 0.35) = 0.75 * 0.85 * 0.35 = 0.41</code>, which gives an evolution factor of <code>0.59</code>.

This formula can also be used to estimate impact of future player activities on the EF: a set of actions that is known to bring the evolution factor of a world from 0 to EF(2) (eg using the above chart and formula) will bring it from EF(1) to <code>1 - (1-EF(1)) * (1-EF(2))</code>

For example, if the player planned to spend the next 20 hours building up their base, releasing 10 million pollution and destroying 200 spawners in the meantime (i.e., the same numbers as in the example above), and the EF at the start of this period were, say, 0.55, then the estimated EF at its end will be <code>1 - (1 - 0.55) * (1 - 0.59) = 0.81</code>.
</div></div>

== Gallery ==
<gallery widths=270px heights=140px>
File:player_near_enemy_nests.png|The player near some enemy nests and worms.
File:player_worms_acid.png|The player among acid puddles created by attacking worms.
File:player_attacked_by_biters.png|Both the player and some buildings getting attacked by biters.
File:enemy_nests_mapgen.png|Enemy nests seen in a map generation preview (deathworld setting).
File:turret_wall_biters.png|Line of gun turrets defending against biters.
File:titlescreen_enemies.png|Enemies seen at the title screen.
</gallery>

== History ==
{{history|0.17.0|
* Behemoth worm added.}}

{{history|0.15.0|
* Increased the damage, range, and health of worms.
* Decreased health and resist of Behemoth biters.}}

{{history|0.13.10|
* Biters and other units won't become aggressive as a result of friendly-fire.}}

{{history|0.13.0|
* Big and behemoth enemies now spawn 50% slower.
* Changed the way evolution factor approaches the maximum (1).
** The addition of evolution factor was changed from addition * (1 - evolution) to addition * (1 - evolution)^2
** This means that the progress gets more slower towards the high values.}}

{{history|0.12.26|
* Running biters over with a vehicle will now anger them in peaceful mode.}}

{{history|0.12.0|
* Updated sounds for enemies.}}

{{history|0.11.17|
* Items dropped by enemies([[alien artifact|*]]) are now collected automatically and from longer distances.}}

{{history|0.11.6|
* Range of spitters is now 15, less than turrets.}}

{{history|0.11.0|
* Spitters added.
* Drawing of enemies optimised, so adding new colors does not impact VRAM.
* Blood splashes on death are now procedural.}}

{{history|0.9.0|
* Turrets no longer search for enemies when none are near.
* Biters can no longer destroy the shipwreck in the 3rd new hope campaign.}}

{{history|0.8.1|
* Further improvement to enemy AI.}}

{{history|0.8.0|
* Decreased the range of medium worm from 25 to 20.}}

{{history|0.7.2|
* Biter AI improved.}}

{{history|0.7.1|
* Peaceful mode added for freeplay.}}

{{history|0.7.0|
* Enemy creepers were replaced by small, medium and big biters.
* Enemy turrets were replaced by small, medium and big shooting worms.
* Enemies move and attack in groups.
* Enemies wander around their base when they have nothing to do.
* Enemies call for help when attacked.
* Enemies can create new bases.
* Enemies can now destroy all player creations they find.}}

{{history|0.1.0|
* Introduced, called 'creepers'}}

== See also ==
* [[Damage]]
* [[Pollution]]

Enemies

2022-09-21T10:44:46Z

CodeGreen: /* Advanced: Evolution factor components and computation */

{{Languages}}
[[File:biter_intro.png|175px|right]]'''Enemies''' (also commonly called '''Biters''') are creatures that want to [[Damage|harm]] the [[player]]. They are the native inhabitants of the extraterrestrial world in the form of arthropods living in organic nests, coexisting with each other peacefully. They are encountered in three species: Biters, spitters and worms. The species are further distinguished in four stages of growth, and thus strength. Enemies and nests show up on the map as red dots. Much like the player, enemies can slowly regain lost health.

== Achievements ==
Enemies are directly connected to the following achievements:
{{Achievement|it-stinks-and-they-dont-like-it}}
{{Achievement|steamrolled}}

==Creatures==
===Biters===
Biters are one of two main antagonists in the game. They come in four sizes: small, medium, big and behemoth. In the beginning of a game, there will only be the small ones. With increasing [[pollution]], they will become bigger, related to the enemy's [[#Evolution|evolution]]. As common sense may suggest, their method of attack is a straightforward charge to "bite" things.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_biter.png|center]] || Small Biter
| Weakest of biters, can be easily killed with a pistol.
* Health: 15
* Damage: 7 Physical
* Attack speed: 1.71/s
* Speed: 43.2km/h
* Range: 1
* Pollution to join attack: 4
|-
| [[File:medium_biter.png|center]] || Medium Biter
| Stronger and slightly faster than the small biter. Can pose a problem for and even kill weaker players.
* Health: 75
* Damage: 15 Physical
* Attack speed: 1.71/s
* Speed: 51.8km/h
* Range: 1
* Pollution to join attack: 20

[[Damage#Resistance|Resistances]]:
*Explosion: 0/10%
*Physical: 4/10%
|-
| [[File:big_biter.png|center]] || Big Biter
| Dangerous, resistant to small arms. Can attack through walls, hitting objects directly behind them.
* Health: 375
* Damage: 30 Physical
* Attack speed: 1.71/s
* Speed: 49.7km/h
* Range: 2
* Pollution to join attack: 80

Resistances:
*Explosion: 0/10%
*Physical: 8/10%
|-
| [[File:behemoth_biter.png|center]] || Behemoth Biter
| Extremely durable and nearly immune to small arms, except for the strongest ordnance. Can attack through walls, hitting objects directly behind them.
* Health: 3000
* Damage: 90 Physical
* Attack speed: 1.2/s
* Speed: 64.8km/h
* Range: 2
* Pollution to join attack: 400

Resistances:
*Explosion: 12/10%
*Physical: 12/10%

|}

===Spitters===
'''Spitters''' are much like [[Enemies#Biters|biters]] and only appear slightly later on in the game as the evolution factor increases. Their main difference from biters is their ranged attack. Using predictive aiming, they spit a stream of acid at enemies which leaves behind a puddle of acid where it hits the ground. Due to the spitters' predictive aiming, the acid stream can be dodged by suddenly changing walking directions or standing still.[https://factorio.com/blog/post/fff-279] Both the stream and the puddle of acid deal damage of time and slow down players and vehicles. Most entities of the game have a much lower resistance to acid than other damage types (including [[turret]]s and [[armor]]), so spitters are effectively more potent against the player and their factories. Their behaviour and size classification are the same as with biters, but their health is universally lower and they are resistant exclusively against explosives, with no physical resistance.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_spitter.png|center]] || Small Spitter
| Weakest of spitters. Easy to kill with any weapon, but attacks at range.
* Health: 10
* Range: 13
* Pollution to join attack: 4
* Speed: 40.0km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1
* Damage (on contact): 12 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 7.2 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 60%
** Duration: 2 seconds

|-
| [[File:medium_spitter.png|center]] || Medium Spitter
| Stronger and slower than the smaller version. Can pose a problem for and even kill weaker players.
* Health: 50
* Range: 14
* Pollution to join attack: 12
* Speed: 35.6km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.25
* Damage (on contact): 24 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 28.8 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 50%
** Duration: 2 seconds

Resistances:
*Explosion: 0/10%
|-
| [[File:big_spitter.png|center]] || Big Spitter
| An even bulkier spitter and so can take more damage.
* Health: 200
* Range: 15
* Pollution to join attack: 30
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.35
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 130 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 40%
** Duration: 2 seconds

Resistances:
*Explosion: 0/15%
|-
| [[File:behemoth_spitter.png|center]] || Behemoth Spitter
| The bulkiest of the spitters and so can take even more damage.
* Health: 1500
* Range: 16
* Pollution to join attack: 200
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.75
* Damage (on contact): 60 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 360 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 30%
** Duration: 2 seconds

Resistances:
*Explosion: 0/30%
|}

===Worms===

The Worms are natural allies of biters and spitters and will attack the player if they get close enough with an attack similar to spitters'. They act like static [[turret]]s and will not follow attackers. They rely on high damage, great range and splash damage to keep the player away from the worms and the nests they protect, but either one of these advantages can be overcome. Unlike other enemies, they are also highly resistant to fire. They will spit acid at the player, which can also leave acidic puddles on the ground that can still damage players and vehicles, as well as slow them both down and leave a brief acidic, damaging effect for a few seconds. However, placed buildings and tiles are unaffected by the acid puddles, but still take damage normally by the acid projectile.

Worms come in 4 sizes, their power increasing with size. Like biters and spitters, behemoth, big and medium worms spawning is influenced by the evolution factor. Worms are only created during enemy expansion when a certain evolution factor requirement is fulfilled. This is 0.3 for the medium worm, 0.5 for the big worm and 0.9 for the behemoth worm. Below these evolution factors, worms can only be created by the map generation. In map generation, the game restricts higher tier worms behind the distance from the starting point. The further away the player goes from the starting area, the stronger the worms become.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:Small worm.png|center]] || Small Worm
| A weak worm. It is still capable of killing the player unless it is targeted as priority.
* Health: 200
* Range: 25

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.4
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 21.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 60%
|-
| [[File:Medium worm.png|center]] || Medium Worm
| Medium worms are dangerous to even more advanced players. They should be handled with care.
* Health: 400
* Range: 30

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.55
* Damage (on contact): 48 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 57.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 50%

Resistances:
*Explosion: 5/15%
*Fire: 2/50%
*Physical: 5/0%
|-
| [[File:Big worm.png|center]] || Big Worm
| Big worms are not as much more dangerous as resilient. They are almost immune to common gunfire of any sort.
* Health: 750
* Range: 38

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.75
* Damage (on contact): 72 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 259 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 40%

Resistances:
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|-
| [[File:Behemoth worm.png|center]] || Behemoth Worm
| Behemoth worms are the most dangerous of worms. They are just as resilient as Big worms, with much greater range.
* Health: 750
* Range: 48

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 2
* Damage (on contact): 96 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 691 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 30%

Resistances:
*Acid: 0/100%
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|}

{| class="wikitable"
|-
! Picture !! Description
|-
| [[File:worm.gif]] || A worm's attack animation.
|-
|}

==Nests==

The spawn points of biters and spitters. While nests themselves are generally defenseless, the enemies they release over time effectively serve as a form of guards to distract the player and any nearby turrets, and are often accompanied by worms. Nests exposed to pollution will use it to send enemies to join attacks. Enemies not engaged in combat may seek out the nearest nest for protection.

The nests are highly resistant to fire and otherwise generally more resilient than a medium worm.

{| class="wikitable"
|-
! Picture !! Name !! Description
|-
| [[File:biter_nest.png]] || Biter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|-
| [[File:spitter_nest.png]] || Spitter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|}

=== Expansions ===
Every 4-60 minutes, a group of 5-20 biters/spitters will leave their base to create a new base which will consist of as many worms/nests as there are members in the group. This group will search for a suitable spot that's 3-7 chunks away from existing bases. The interval between enemy expansions is global, and the higher enemy evolution, the shorter the interval is on average. Furthermore, with higher evolution, the groups are bigger on average.

Once they have found a suitable spot, each biter/spitter in the group dies and forms a new nest or worm. Forming a new nest or worm will destroy anything that is in the way, which can include members of the expansion group. There is a delay between each member sacrificing itself for to create a worm/nest, so creating the new base from the expansion group can take quite a long time, depending on the group size. Medium worms are only formed if the current evolution is higher than 0.3, big worms only if the current evolution is higher than 0.5 and behemoth worms are only formed if current evolution is higher than 0.9. The game randomly chooses whether to form a new biter nest, spitter nest, small worm, or bigger worm if the evolution factor is high enough. [https://gist.github.com/Bilka2/aa88490c23124a6f214c02c73a368aa7]

==Defense==
[[File:kills_gui.png|thumb|220px|right|"Kills" tab on the [[production statistics]] screen.]]Nests spawn biters and spitters freely. However, biters and spitters will only aggressively engage the player's factory if the pollution cloud of the factory reaches a nest because pollution is consumed to send biters or spitters to join the next attack. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers. The attack then proceeds to their target over the shortest path possible, accounting for terrain, but not for player entities that could pose an obstacle (like [[wall]]s).

If there is a clear path somewhere around those obstacles, the biters will attempt to go around. If there is no clear passage or a clear passage would mean deviating too far from the original course, the biters will attack whatever is in their way to go through. This can be exploited to an extent; creating mazes at regular intervals along a barrier can direct the biters through a gauntlet not dissimilar to tower defense.

However, if a biter comes in proximity of a [[Military units and structures|military unit or structure]], it will prioritize these and attempt to immediately attack them instead, again trying to reach the new target over the shortest possible path with no too great detours, if possible.

==Evolution==
[[File:Evolution Biters.png|thumb|right|400px|Spawn chances of biters from biter spawners by evolution factor.]]
[[File:Evolution Spitters.png|thumb|right|400px|Spawn chances of spitters from spitter spawners by evolution factor.]]
[[File:Evolution Weights.png|thumb|right|400px|Weight graph of both spawners by evolution factor. The values shown are primarily for indicating when certain types start and stop spawning, for actual chances refer to the tables or other charts.]]
The evolution factor is a global variable that determines what kind of biters will be spawned. You can check the variable in the dev console via the following command (does not disable achievements):

/evolution

The evolution factor goes from 0 (not evolved at all) to 1 (maximal evolution). At the moment the evolution factor can only increase.

Besides choosing what kind of biter will be spawned, the evolution factor also influences the spawning interval. This interval (<code>spawning_cooldown</code> in the <code>enemy-spawner</code> definition) is interpolated between 360 (0 evolution) and 150 (1 evolution) game ticks (= 6 to 2.5 seconds).

=== Methods of increasing ===

The evolution factor is increased by three kinds of events:

* The passage of time very slightly increases the evolution factor.
* The global [[Pollution|pollution production]] increases the evolution factor.
* Destroying [[Enemies#Nests|nests]] significantly increases the evolution factor.

All these values are set in <code>game.map_settings.enemy_evolution</code>. From there they can be changed or modded.

The default settings are:

{| class="wikitable"
!Source per
!Variable in <code>enemy_evolution</code>
!Percent increase
|-
| [[Time#Seconds|Second]] || <code>time_factor</code> || 0.0004%
|-
| 1 Pollution unit || <code>pollution_factor</code> || 0.00009%
|-
| Destroyed enemy spawner || <code>destroy_factor</code> || 0.2%
|}

Pollution production is the total pollution produced by [[Pollution#Polluters|buildings]] per tick, not the pollution spreading on the map, so it is not reduced by trees or other absorbers.
e.g. : 10 boilers produce 300 pollution in one minute, raising the evolution factor by around 0.027%.

The percentages are applied on the base of <code>(1 - current_evolution_factor)²</code>. So for instance destroying enemy spawners in the beginning of the game results in increase of evolution factor by 0.002 (0.2%) while doing this when the evolution factor is 0.5 the increase is only 0.0005 (0.05%).

This also means that the evolution factor approaches 1 asymptotically - generally, increases past 0.9 or so are ''very'' slow and the number never actually reaches 1.0.

=== Spawn chances by evolution factor ===

The probability charts show the chances of each type of biter/spitter for each spawner at all evolution levels.

<div id="evoChecker"></div>

=== Advanced: Evolution factor components and computation ===
<div class="toccolours mw-collapsible mw-collapsed" style="width:calc(100%-400px); overflow:auto;">
This section has charts plotting the individual evolution factor components and discusses possibilities for manually estimating the evolution factor.
<div class="mw-collapsible-content">

[[File:Evolution_factor_by_time.png|400px|thumb|right|1. Single-component evolution factor increase with time]]
[[File:Evolution_factor_by_pollution.png|400px|thumb|right|2. Single-component evolution factor increase with pollution]]
[[File:Evolution_factor_by_spawners.png|400px|thumb|right|3. Single-component evolution factor increase with destroyed spawners]]

'''Notes'''

* Data from version 1.1.50.

* All charts end at approximately an evolution factor of 0.90.

* The calculation steps for time and spawner kills match those used by the game, so these charts should be accurate. The pollution chart assumes a pollution production of 1000 units per second, and due to the recursive nature of the chart values will slightly diverge at different pollution rates. The effect of this is negligible for any reasonable amount pollution production, however.

*Given that the game reports the actual evolution factor (console: <code>/evolution</code>) whenever the player wishes, these charts are intended primarily to help estimate the impact of planned base expansions and similar activities on the evolution factor's future development.

'''Comments'''

These charts (click to enlarge) represent the situation where each evolution factor component (time, pollution, destroyed spawners) is the ''only'' component contributing to the evolution factor in that entire game. They are therefore '''not realistic''', as in a typical game all three components will contribute, some at varying times and intensities.

Because of how contributions to the evolution factor (hereinafter, EF) are calculated (multiplied by <code>(1 - current EF)</code>), it is '''not''' possible to simply add the values indicated by these charts for a game's time passed, pollution generated, and / or spawners destroyed so far to retrieve the total evolution factor.

For example, if 20 hours have passed (single-component EF =~ 0.25), 10 million pollution units were released (single-component EF =~ 0.15), and 200 spawners were destroyed (single-component EF =~ 0.35), the actual evolution factor will '''not''' be (0.25 + 0.15 + 0.35 =) ~0.85.

However, the evolution factor will always be '''less''' than the sum of all individual components as indicated by these charts, and '''at least''' as high as the highest individual component. Thus, using the values from above, the EF will be ''at least'' 0.35 and ''less than'' 0.85. A smarter approach is required to compute the amount of pollution released.

'''Computation of actual evolution factor'''

The actual EF can be computed as follow :

<code> 1 - EF = (1 - E[t]) * (1 - E[p]) * (1 - E[s])</code>, where ''E[t]'', ''E[p]'', and ''E[s]'' are the single-component values from the pollution, time, and spawner charts, in that order.

A key observation in understanding where this formula comes from is that each incremental change of the evolution factor is effectively a multiplication of <code>1 - EF</code> by a constant (depending on the nature of the change). For example, another way of saying that killing a biter nest augments evolution by 0.2% of <code>1 - EF</code>, is to say that killing a biter nest multiplies <code>1 - EF</code> by 0.998.

So, like multiplication, evolution is, barring rounding errors, associative and commutative. The commutativity means that the order in which you take evolution-increasing actions does not matter, and along with the associativity results in the formula above.

That knowledge can also be applied to compute the above charts exactly, or to compute a component of evolution without having to refer to the chart at all. For example, pollution as a function of time only is <code>1 - 0.999996 ^ t</code> where t is the time in seconds.

For the values from above, we can deduce the evolution factor <code>1 - EF = (1 - 0.25) * (1 - 0.15) * (1 - 0.35) = 0.75 * 0.85 * 0.35 = 0.41</code>, which gives an evolution factor of <code>0.59</code>.

This formula can also be used to estimate impact of future player activities on the EF: a set of actions that is known to bring the evolution factor of a world from 0 to EF(2) (eg using the above chart and formula) will bring it from EF(1) to <code>1 - (1-EF(1)) * (1-EF(2))</code>

For example, if the player planned to spend the next 20 hours building up their base, releasing 10 million pollution and destroying 200 spawners in the meantime (i.e., the same numbers as in the example above), and the EF at the start of this period were, say, 0.55, then the estimated EF at its end will be <code>1 - (1 - 0.55) * (1 - 0.59) = 0.81</code>.
</div></div>

== Gallery ==
<gallery widths=270px heights=140px>
File:player_near_enemy_nests.png|The player near some enemy nests and worms.
File:player_worms_acid.png|The player among acid puddles created by attacking worms.
File:player_attacked_by_biters.png|Both the player and some buildings getting attacked by biters.
File:enemy_nests_mapgen.png|Enemy nests seen in a map generation preview (deathworld setting).
File:turret_wall_biters.png|Line of gun turrets defending against biters.
File:titlescreen_enemies.png|Enemies seen at the title screen.
</gallery>

== History ==
{{history|0.17.0|
* Behemoth worm added.}}

{{history|0.15.0|
* Increased the damage, range, and health of worms.
* Decreased health and resist of Behemoth biters.}}

{{history|0.13.10|
* Biters and other units won't become aggressive as a result of friendly-fire.}}

{{history|0.13.0|
* Big and behemoth enemies now spawn 50% slower.
* Changed the way evolution factor approaches the maximum (1).
** The addition of evolution factor was changed from addition * (1 - evolution) to addition * (1 - evolution)^2
** This means that the progress gets more slower towards the high values.}}

{{history|0.12.26|
* Running biters over with a vehicle will now anger them in peaceful mode.}}

{{history|0.12.0|
* Updated sounds for enemies.}}

{{history|0.11.17|
* Items dropped by enemies([[alien artifact|*]]) are now collected automatically and from longer distances.}}

{{history|0.11.6|
* Range of spitters is now 15, less than turrets.}}

{{history|0.11.0|
* Spitters added.
* Drawing of enemies optimised, so adding new colors does not impact VRAM.
* Blood splashes on death are now procedural.}}

{{history|0.9.0|
* Turrets no longer search for enemies when none are near.
* Biters can no longer destroy the shipwreck in the 3rd new hope campaign.}}

{{history|0.8.1|
* Further improvement to enemy AI.}}

{{history|0.8.0|
* Decreased the range of medium worm from 25 to 20.}}

{{history|0.7.2|
* Biter AI improved.}}

{{history|0.7.1|
* Peaceful mode added for freeplay.}}

{{history|0.7.0|
* Enemy creepers were replaced by small, medium and big biters.
* Enemy turrets were replaced by small, medium and big shooting worms.
* Enemies move and attack in groups.
* Enemies wander around their base when they have nothing to do.
* Enemies call for help when attacked.
* Enemies can create new bases.
* Enemies can now destroy all player creations they find.}}

{{history|0.1.0|
* Introduced, called 'creepers'}}

== See also ==
* [[Damage]]
* [[Pollution]]

Enemies

2022-09-21T10:33:29Z

CodeGreen: /* Evolution */

{{Languages}}
[[File:biter_intro.png|175px|right]]'''Enemies''' (also commonly called '''Biters''') are creatures that want to [[Damage|harm]] the [[player]]. They are the native inhabitants of the extraterrestrial world in the form of arthropods living in organic nests, coexisting with each other peacefully. They are encountered in three species: Biters, spitters and worms. The species are further distinguished in four stages of growth, and thus strength. Enemies and nests show up on the map as red dots. Much like the player, enemies can slowly regain lost health.

== Achievements ==
Enemies are directly connected to the following achievements:
{{Achievement|it-stinks-and-they-dont-like-it}}
{{Achievement|steamrolled}}

==Creatures==
===Biters===
Biters are one of two main antagonists in the game. They come in four sizes: small, medium, big and behemoth. In the beginning of a game, there will only be the small ones. With increasing [[pollution]], they will become bigger, related to the enemy's [[#Evolution|evolution]]. As common sense may suggest, their method of attack is a straightforward charge to "bite" things.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_biter.png|center]] || Small Biter
| Weakest of biters, can be easily killed with a pistol.
* Health: 15
* Damage: 7 Physical
* Attack speed: 1.71/s
* Speed: 43.2km/h
* Range: 1
* Pollution to join attack: 4
|-
| [[File:medium_biter.png|center]] || Medium Biter
| Stronger and slightly faster than the small biter. Can pose a problem for and even kill weaker players.
* Health: 75
* Damage: 15 Physical
* Attack speed: 1.71/s
* Speed: 51.8km/h
* Range: 1
* Pollution to join attack: 20

[[Damage#Resistance|Resistances]]:
*Explosion: 0/10%
*Physical: 4/10%
|-
| [[File:big_biter.png|center]] || Big Biter
| Dangerous, resistant to small arms. Can attack through walls, hitting objects directly behind them.
* Health: 375
* Damage: 30 Physical
* Attack speed: 1.71/s
* Speed: 49.7km/h
* Range: 2
* Pollution to join attack: 80

Resistances:
*Explosion: 0/10%
*Physical: 8/10%
|-
| [[File:behemoth_biter.png|center]] || Behemoth Biter
| Extremely durable and nearly immune to small arms, except for the strongest ordnance. Can attack through walls, hitting objects directly behind them.
* Health: 3000
* Damage: 90 Physical
* Attack speed: 1.2/s
* Speed: 64.8km/h
* Range: 2
* Pollution to join attack: 400

Resistances:
*Explosion: 12/10%
*Physical: 12/10%

|}

===Spitters===
'''Spitters''' are much like [[Enemies#Biters|biters]] and only appear slightly later on in the game as the evolution factor increases. Their main difference from biters is their ranged attack. Using predictive aiming, they spit a stream of acid at enemies which leaves behind a puddle of acid where it hits the ground. Due to the spitters' predictive aiming, the acid stream can be dodged by suddenly changing walking directions or standing still.[https://factorio.com/blog/post/fff-279] Both the stream and the puddle of acid deal damage of time and slow down players and vehicles. Most entities of the game have a much lower resistance to acid than other damage types (including [[turret]]s and [[armor]]), so spitters are effectively more potent against the player and their factories. Their behaviour and size classification are the same as with biters, but their health is universally lower and they are resistant exclusively against explosives, with no physical resistance.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:small_spitter.png|center]] || Small Spitter
| Weakest of spitters. Easy to kill with any weapon, but attacks at range.
* Health: 10
* Range: 13
* Pollution to join attack: 4
* Speed: 40.0km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1
* Damage (on contact): 12 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 7.2 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 60%
** Duration: 2 seconds

|-
| [[File:medium_spitter.png|center]] || Medium Spitter
| Stronger and slower than the smaller version. Can pose a problem for and even kill weaker players.
* Health: 50
* Range: 14
* Pollution to join attack: 12
* Speed: 35.6km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.25
* Damage (on contact): 24 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 28.8 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 50%
** Duration: 2 seconds

Resistances:
*Explosion: 0/10%
|-
| [[File:big_spitter.png|center]] || Big Spitter
| An even bulkier spitter and so can take more damage.
* Health: 200
* Range: 15
* Pollution to join attack: 30
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.35
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 130 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 40%
** Duration: 2 seconds

Resistances:
*Explosion: 0/15%
|-
| [[File:behemoth_spitter.png|center]] || Behemoth Spitter
| The bulkiest of the spitters and so can take even more damage.
* Health: 1500
* Range: 16
* Pollution to join attack: 200
* Speed: 32.4km/h

Acid projectile:
* Attack speed: 0.6/s
* Area of effect size: 1.75
* Damage (on contact): 60 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 360 Acid/second
* Applies effect (on contact):
** Movement/vehicle speed modifier: 30%
** Duration: 2 seconds

Resistances:
*Explosion: 0/30%
|}

===Worms===

The Worms are natural allies of biters and spitters and will attack the player if they get close enough with an attack similar to spitters'. They act like static [[turret]]s and will not follow attackers. They rely on high damage, great range and splash damage to keep the player away from the worms and the nests they protect, but either one of these advantages can be overcome. Unlike other enemies, they are also highly resistant to fire. They will spit acid at the player, which can also leave acidic puddles on the ground that can still damage players and vehicles, as well as slow them both down and leave a brief acidic, damaging effect for a few seconds. However, placed buildings and tiles are unaffected by the acid puddles, but still take damage normally by the acid projectile.

Worms come in 4 sizes, their power increasing with size. Like biters and spitters, behemoth, big and medium worms spawning is influenced by the evolution factor. Worms are only created during enemy expansion when a certain evolution factor requirement is fulfilled. This is 0.3 for the medium worm, 0.5 for the big worm and 0.9 for the behemoth worm. Below these evolution factors, worms can only be created by the map generation. In map generation, the game restricts higher tier worms behind the distance from the starting point. The further away the player goes from the starting area, the stronger the worms become.

{| class="wikitable"
|-
! Picture !! Name !! Info
|-
| [[File:Small worm.png|center]] || Small Worm
| A weak worm. It is still capable of killing the player unless it is targeted as priority.
* Health: 200
* Range: 25

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.4
* Damage (on contact): 36 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 21.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 60%
|-
| [[File:Medium worm.png|center]] || Medium Worm
| Medium worms are dangerous to even more advanced players. They should be handled with care.
* Health: 400
* Range: 30

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.55
* Damage (on contact): 48 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 57.6 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 50%

Resistances:
*Explosion: 5/15%
*Fire: 2/50%
*Physical: 5/0%
|-
| [[File:Big worm.png|center]] || Big Worm
| Big worms are not as much more dangerous as resilient. They are almost immune to common gunfire of any sort.
* Health: 750
* Range: 38

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 1.75
* Damage (on contact): 72 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 259 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 40%

Resistances:
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|-
| [[File:Behemoth worm.png|center]] || Behemoth Worm
| Behemoth worms are the most dangerous of worms. They are just as resilient as Big worms, with much greater range.
* Health: 750
* Range: 48

Acid projectile:
* Attack speed: 0.66/s
* Area of effect size: 2
* Damage (on contact): 96 Acid

Acid puddle:
* Lifetime: 32 seconds
* Damage: 691 Acid/second
* Applies effect (on contact):
** Duration: 2 seconds
** Movement/vehicle speed modifier: 30%

Resistances:
*Acid: 0/100%
*Explosion: 10/30%
*Fire: 3/70%
*Physical: 10/0%
|}

{| class="wikitable"
|-
! Picture !! Description
|-
| [[File:worm.gif]] || A worm's attack animation.
|-
|}

==Nests==

The spawn points of biters and spitters. While nests themselves are generally defenseless, the enemies they release over time effectively serve as a form of guards to distract the player and any nearby turrets, and are often accompanied by worms. Nests exposed to pollution will use it to send enemies to join attacks. Enemies not engaged in combat may seek out the nearest nest for protection.

The nests are highly resistant to fire and otherwise generally more resilient than a medium worm.

{| class="wikitable"
|-
! Picture !! Name !! Description
|-
| [[File:biter_nest.png]] || Biter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|-
| [[File:spitter_nest.png]] || Spitter's nest
|
* Health: 350

Resistances:
*Explosion: 5/15%
*Fire: 3/60%
*Physical: 2/15%
|}

=== Expansions ===
Every 4-60 minutes, a group of 5-20 biters/spitters will leave their base to create a new base which will consist of as many worms/nests as there are members in the group. This group will search for a suitable spot that's 3-7 chunks away from existing bases. The interval between enemy expansions is global, and the higher enemy evolution, the shorter the interval is on average. Furthermore, with higher evolution, the groups are bigger on average.

Once they have found a suitable spot, each biter/spitter in the group dies and forms a new nest or worm. Forming a new nest or worm will destroy anything that is in the way, which can include members of the expansion group. There is a delay between each member sacrificing itself for to create a worm/nest, so creating the new base from the expansion group can take quite a long time, depending on the group size. Medium worms are only formed if the current evolution is higher than 0.3, big worms only if the current evolution is higher than 0.5 and behemoth worms are only formed if current evolution is higher than 0.9. The game randomly chooses whether to form a new biter nest, spitter nest, small worm, or bigger worm if the evolution factor is high enough. [https://gist.github.com/Bilka2/aa88490c23124a6f214c02c73a368aa7]

==Defense==
[[File:kills_gui.png|thumb|220px|right|"Kills" tab on the [[production statistics]] screen.]]Nests spawn biters and spitters freely. However, biters and spitters will only aggressively engage the player's factory if the pollution cloud of the factory reaches a nest because pollution is consumed to send biters or spitters to join the next attack. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers. The attack then proceeds to their target over the shortest path possible, accounting for terrain, but not for player entities that could pose an obstacle (like [[wall]]s).

If there is a clear path somewhere around those obstacles, the biters will attempt to go around. If there is no clear passage or a clear passage would mean deviating too far from the original course, the biters will attack whatever is in their way to go through. This can be exploited to an extent; creating mazes at regular intervals along a barrier can direct the biters through a gauntlet not dissimilar to tower defense.

However, if a biter comes in proximity of a [[Military units and structures|military unit or structure]], it will prioritize these and attempt to immediately attack them instead, again trying to reach the new target over the shortest possible path with no too great detours, if possible.

==Evolution==
[[File:Evolution Biters.png|thumb|right|400px|Spawn chances of biters from biter spawners by evolution factor.]]
[[File:Evolution Spitters.png|thumb|right|400px|Spawn chances of spitters from spitter spawners by evolution factor.]]
[[File:Evolution Weights.png|thumb|right|400px|Weight graph of both spawners by evolution factor. The values shown are primarily for indicating when certain types start and stop spawning, for actual chances refer to the tables or other charts.]]
The evolution factor is a global variable that determines what kind of biters will be spawned. You can check the variable in the dev console via the following command (does not disable achievements):

/evolution

The evolution factor goes from 0 (not evolved at all) to 1 (maximal evolution). At the moment the evolution factor can only increase.

Besides choosing what kind of biter will be spawned, the evolution factor also influences the spawning interval. This interval (<code>spawning_cooldown</code> in the <code>enemy-spawner</code> definition) is interpolated between 360 (0 evolution) and 150 (1 evolution) game ticks (= 6 to 2.5 seconds).

=== Methods of increasing ===

The evolution factor is increased by three kinds of events:

* The passage of time very slightly increases the evolution factor.
* The global [[Pollution|pollution production]] increases the evolution factor.
* Destroying [[Enemies#Nests|nests]] significantly increases the evolution factor.

All these values are set in <code>game.map_settings.enemy_evolution</code>. From there they can be changed or modded.

The default settings are:

{| class="wikitable"
!Source per
!Variable in <code>enemy_evolution</code>
!Percent increase
|-
| [[Time#Seconds|Second]] || <code>time_factor</code> || 0.0004%
|-
| 1 Pollution unit || <code>pollution_factor</code> || 0.00009%
|-
| Destroyed enemy spawner || <code>destroy_factor</code> || 0.2%
|}

Pollution production is the total pollution produced by [[Pollution#Polluters|buildings]] per tick, not the pollution spreading on the map, so it is not reduced by trees or other absorbers.
e.g. : 10 boilers produce 300 pollution in one minute, raising the evolution factor by around 0.027%.

The percentages are applied on the base of <code>(1 - current_evolution_factor)²</code>. So for instance destroying enemy spawners in the beginning of the game results in increase of evolution factor by 0.002 (0.2%) while doing this when the evolution factor is 0.5 the increase is only 0.0005 (0.05%).

This also means that the evolution factor approaches 1 asymptotically - generally, increases past 0.9 or so are ''very'' slow and the number never actually reaches 1.0.

=== Spawn chances by evolution factor ===

The probability charts show the chances of each type of biter/spitter for each spawner at all evolution levels.

<div id="evoChecker"></div>

=== Advanced: Evolution factor components and computation ===
<div class="toccolours mw-collapsible mw-collapsed" style="width:calc(100%-400px); overflow:auto;">
This section has charts plotting the individual evolution factor components and discusses possibilities for manually estimating the evolution factor.
<div class="mw-collapsible-content">

[[File:Evolution_factor_by_time.png|400px|thumb|right|1. Single-component evolution factor increase with time]]
[[File:Evolution_factor_by_pollution.png|400px|thumb|right|2. Single-component evolution factor increase with pollution]]
[[File:Evolution_factor_by_spawners.png|400px|thumb|right|3. Single-component evolution factor increase with destroyed spawners]]

'''Notes'''

* Data from version 1.1.50.

* All charts end at approximately an evolution factor of 0.90.

* The calculation steps for time and spawner kills match those used by the game, so these charts should be accurate. The pollution chart assumes a pollution production of 1000 units per second, and due to the recursive nature of the chart values will slightly diverge at different pollution rates. The effect of this is negligible for any reasonable amount pollution production, however.

*Given that the game reports the actual evolution factor (console: <code>/evolution</code>) whenever the player wishes, these charts are intended primarily to help estimate the impact of planned base expansions and similar activities on the evolution factor's future development.

'''Comments'''

These charts (click to enlarge) represent the situation where each evolution factor component (time, pollution, destroyed spawners) is the ''only'' component contributing to the evolution factor in that entire game. They are therefore '''not realistic''', as in a typical game all three components will contribute, some at varying times and intensities.

Because of how contributions to the evolution factor (hereinafter, EF) are calculated (multiplied by <code>(1 - current EF)²</code>), it is '''not''' possible to simply add the values indicated by these charts for a game's time passed, pollution generated, and / or spawners destroyed so far to retrieve the total evolution factor.

For example, if 20 hours have passed (single-component EF =~ 0.25), 10 million pollution units were released (single-component EF =~ 0.15), and 200 spawners were destroyed (single-component EF =~ 0.35), the actual evolution factor will '''not''' be (0.25 + 0.15 + 0.35 =) ~0.85.

However, the evolution factor will always be '''less''' than the sum of all individual components as indicated by these charts, and '''at least''' as high as the highest individual component. Thus, using the values from above, the EF will be ''at least'' 0.35 and ''less than'' 0.85. A smarter approach is required to compute the amount of pollution released.

'''Computation of actual evolution factor'''

The actual EF can be computed as follow :

<code> 1 - EF = (1 - E[t]) * (1 - E[p]) * (1 - E[s])</code>, where ''E[t]'', ''E[p]'', and ''E[s]'' are the single-component values from the pollution, time, and spawner charts, in that order.

A key observation in understanding where this formula comes from is that each incremental change of the evolution factor is effectively a multiplication of <code>1 - EF</code> by a constant (depending on the nature of the change). For example, another way of saying that killing a biter nest augments evolution by 0.2% of <code>1 - EF</code>, is to say that killing a biter nest multiplies <code>1 - EF</code> by 0.998.

So, like multiplication, evolution is, barring rounding errors, associative and commutative. The commutativity means that the order in which you take evolution-increasing actions does not matter, and along with the associativity results in the formula above.

That knowledge can also be applied to compute the above charts exactly, or to compute a component of evolution without having to refer to the chart at all. For example, pollution as a function of time only is <code>1 - 0.999996 ^ t</code> where t is the time in seconds.

For the values from above, we can deduce the evolution factor <code>1 - EF = (1 - 0.25) * (1 - 0.15) * (1 - 0.35) = 0.75 * 0.85 * 0.35 = 0.41</code>, which gives an evolution factor of <code>0.59</code>.

This formula can also be used to estimate impact of future player activities on the EF: a set of actions that is known to bring the evolution factor of a world from 0 to EF(2) (eg using the above chart and formula) will bring it from EF(1) to <code>1 - (1-EF(1)) * (1-EF(2))</code>

For example, if the player planned to spend the next 20 hours building up their base, releasing 10 million pollution and destroying 200 spawners in the meantime (i.e., the same numbers as in the example above), and the EF at the start of this period were, say, 0.55, then the estimated EF at its end will be <code>1 - (1 - 0.55) * (1 - 0.59) = 0.81</code>.
</div></div>

== Gallery ==
<gallery widths=270px heights=140px>
File:player_near_enemy_nests.png|The player near some enemy nests and worms.
File:player_worms_acid.png|The player among acid puddles created by attacking worms.
File:player_attacked_by_biters.png|Both the player and some buildings getting attacked by biters.
File:enemy_nests_mapgen.png|Enemy nests seen in a map generation preview (deathworld setting).
File:turret_wall_biters.png|Line of gun turrets defending against biters.
File:titlescreen_enemies.png|Enemies seen at the title screen.
</gallery>

== History ==
{{history|0.17.0|
* Behemoth worm added.}}

{{history|0.15.0|
* Increased the damage, range, and health of worms.
* Decreased health and resist of Behemoth biters.}}

{{history|0.13.10|
* Biters and other units won't become aggressive as a result of friendly-fire.}}

{{history|0.13.0|
* Big and behemoth enemies now spawn 50% slower.
* Changed the way evolution factor approaches the maximum (1).
** The addition of evolution factor was changed from addition * (1 - evolution) to addition * (1 - evolution)^2
** This means that the progress gets more slower towards the high values.}}

{{history|0.12.26|
* Running biters over with a vehicle will now anger them in peaceful mode.}}

{{history|0.12.0|
* Updated sounds for enemies.}}

{{history|0.11.17|
* Items dropped by enemies([[alien artifact|*]]) are now collected automatically and from longer distances.}}

{{history|0.11.6|
* Range of spitters is now 15, less than turrets.}}

{{history|0.11.0|
* Spitters added.
* Drawing of enemies optimised, so adding new colors does not impact VRAM.
* Blood splashes on death are now procedural.}}

{{history|0.9.0|
* Turrets no longer search for enemies when none are near.
* Biters can no longer destroy the shipwreck in the 3rd new hope campaign.}}

{{history|0.8.1|
* Further improvement to enemy AI.}}

{{history|0.8.0|
* Decreased the range of medium worm from 25 to 20.}}

{{history|0.7.2|
* Biter AI improved.}}

{{history|0.7.1|
* Peaceful mode added for freeplay.}}

{{history|0.7.0|
* Enemy creepers were replaced by small, medium and big biters.
* Enemy turrets were replaced by small, medium and big shooting worms.
* Enemies move and attack in groups.
* Enemies wander around their base when they have nothing to do.
* Enemies call for help when attacked.
* Enemies can create new bases.
* Enemies can now destroy all player creations they find.}}

{{history|0.1.0|
* Introduced, called 'creepers'}}

== See also ==
* [[Damage]]
* [[Pollution]]

Pollution

2022-09-10T04:04:36Z

CodeGreen:

{{languages}}
[[File:Pollution.png|300px|thumb|Example of in-game pollution (red squares) in the map]]
[[File:pollution_gui.png|300px|thumb|Pollution tab in the production GUI.]]

Pollution is represented as an abstract "cloud", updated [[Map_structure#Chunk|per chunk]] every 64 [[Time#Ticks|ticks]] (which is 4 ticks more than a game-second), and visible on the map, when "alt-view" is on (default [[Keyboard bindings|Alt-Key]]). It appears as a red colored blocky cloud.

It is produced by many buildings involved in processing items and spreads outwards at a steady rate.

The [[Enemies#Evolution|evolution factor]] is not increased by the spreading/absorbed pollution, but by the pollution produced by all the player's [[Pollution#Polluters|machinery]] at every tick. This means that no matter how hard the player tries to contain the pollution, [[enemies]] will still evolve at the same rate. They just won't attack the player as frequently. The pollution cloud is used to trigger biter attacks and determines the size of the attacks.

Pollution settings can be changed via [[map generator|map generation]] settings, or can be disabled entirely.

== Pollution spread ==

As soon as a chunk has reached 15.0 pollution it starts spreading in all four cardinal directions at a rate of 2% per 64 ticks. Pollution can generate new chunks if it needs to spread to them.

For example, a chunk with 400.0 pollution and 4 adjacent chunks with 100.0 pollution each, raises the pollution in all adjacent chunks by 8.0 while reducing its own pollution by 32.0. But every one of the 4 surrounding spreads 2.0 pollution "back" to the center chunk, so it only loses 24.0 + [[Pollution#De-polluters|absorbed value]].

== Pollution dissipation==

* Every [[Map_structure#Chunk|chunk]] (32x32) of map slowly reduces the pollution it covers (See [[#Chunks]]). So the more the pollution spreads, the more is absorbed.
* [[Tree]]s also absorb some pollution (See [[#Trees]]).
* [[Enemies#Spawner|Spawners]] absorb a great amount of pollution, and use this to assign enemies to attacks.

== Native life ==
Pollution attracts [[Enemies#Biters|biters]] to the Player's factory. Biters who find themselves in a polluted area will attempt to reach the source of pollution and destroy it. Any [[water]] near the source of pollution will turn green, which is a visual-only effect. The effect can be turned off by disabling animated water in the graphics settings.

If a chunk's pollution is greater than 20, each enemy spawner absorbs 20 + 0.01 * [chunk's pollution] every 64 ticks, otherwise it absorbs 3 times the amount of pollution needed for the most expensive unit it can spawn for the current evolution factor.

Higher pollution values decrease the time it takes for biters to join the attack force. After a certain amount of pollution is absorbed the spawner sends one of its biters/spitters to a rendezvous point. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers.

Required pollution to add an additional biter/spitter to the attack wave:
{| class="wikitable" style="text-align:right;"
! style="width: 100px;" | Pollution 
! style="width: 130px;" | Type 
|-
| 4  || Small biter 
|-
| 20  || Medium biter 
|-
| 80  || Big biter 
|-
| 400  || Behemoth biter 
|-
| 4  || Small spitter 
|-
| 12  || Medium spitter 
|-
| 30  || Big spitter 
|-
| 200  || Behemoth spitter 
|-
|}

== Modules ==
[[Module]]s that list "+x% pollution" increase pollution multiplier, not a flat pollution rate. Final pollution value is (pollution multiplier * energy usage multiplier * base pollution), meaning heavily boosted buildings are likely to account for most of the pollution produced in a factory.

== Production/Absorption ==
These tables contain information about the levels of pollution produced/absorbed by items in the game.
=== Polluters ===
{| class="wikitable"
! Structure !! Pollution per minute at full power
|-
| {{Imagelink|Stone furnace}} || 2
|-
| {{Imagelink|Steel furnace}} || 4
|-
| {{Imagelink|Electric furnace}} || 1
|-
| {{Imagelink|Burner mining drill}} || 12
|-
| {{Imagelink|Electric mining drill}} || 10
|-
| {{imagelink|Pumpjack}} || 10
|-
| {{Imagelink|Assembling machine 1}} || 4
|-
| {{Imagelink|Assembling machine 2}} || 3
|-
| {{Imagelink|Assembling machine 3}} || 2
|-
| {{imagelink|Boiler}} || 30
|-
| {{Imagelink|Oil refinery}} || 6
|-
| {{Imagelink|Chemical plant}} || 4
|-
| {{Imagelink|Centrifuge}} || 4
|-
|}

Fire on the ground and burning trees produce 0.3 pollution per minute.

=== De-polluters ===

==== Spawners ====
Every 64 ticks, spawners absorb pollution until they have absorbed more than 3 times the amount needed to send the [[Enemies#Creatures|most expensive unit]] at the current evolution level.

If they have not absorbed more than that threshold, they will absorb 20 + 0.01 * [chunk's pollution] and check the threshold again.

Note that absorbing pollution is not for spawning biters, but for sending biters to an attack group. Spawners will spawn enemies regardless of pollution absorption until they reach their spawn limit.

==== Chunks ====
Every chunk has a natural absorption rate per second which is determined by the sum of the pollution absorption of its floor tiles.

Following numbers are the pollution reduction for a single tile per second.
{| class="wikitable"
! Tile !! Pollution per second !! Absorption rating
|-
| Grass 1-4 || -0.0000075 || 10
|-
| Dirt 1-7, dry dirt || -0.0000066 || 9
|-
| Red desert 0-3 || -0.0000066 || 9
|-
| Sand 1-3 || -0.0000058 || 8
|-
| Water, green water, deep water, deep green water, shallow water, mud water || -0.000005 || 7
|-
| Nuclear ground || -0.0000025 || 3
|-
| Path tiles (Stone bricks, concrete etc), landfill || 0 || 0
|-
| Special tiles (Lab tiles, tutorial grid, Water Wube) || 0 || 0
|-
| Out of map || -0.00001 || 13
|-
|}

==== Trees ====

Every single tree absorbs a small amount of pollution in its chunk per second. If the total pollution in a chunk is above 60 units, once per second some of the trees in that chunk each have a chance to either lose one stage of leaves or have their leaves become one stage more gray. Regardless of whether the tree loses leaves or gets grayer, 10 pollution are absorbed by the tree.<br>
A tree stops losing leaves/becoming more gray once the sum of its gray percentage and its leaves lost percentage is above 120%. 50% of trees stop their leaf progression one stage earlier. As the grayness and leaf stage are then locked for that tree forever, it is possible for trees to keep some leaves in heavily polluted chunks but in turn be very gray, or the other way around.<br>
The less dense the leaves, the slower the tree absorbs pollution, however tree grayness does not affect pollution absorption.

{| class="wikitable"
! Object !! Stage !! Pollution per second
|-
| rowspan="4" | [[File:Green tree.png|120px]] Tree, red tree, brown tree || 0 (Max leaf density) || -0.001
|-
| 1 || -0.00067
|-
| 2 || -0.00033
|-
| 3 (Min leaf density) || 0
|-
| [[File:Dead dry hairy tree.png|120px]] Dead dry hairy tree || No stages || -0.0001
|-
| [[File:Dead grey trunk.png|120px]] Dead gray trunk || No stages || -0.0001
|-
| [[File:Dead tree desert.png|120px]] Dead tree - desert|| No stages || -0.0001
|-
| [[File:Dry hairy tree.png|120px]] Dry hairy tree || No stages || -0.0001
|-
| [[File:Dry tree.png|120px]] Dry tree || No stages || -0.0001
|-
|}

== Achievements ==
Pollution is directly connected to the following achievement:
{{Achievement|it-stinks-and-they-dont-like-it}}

== History ==

{{history|0.17.12|
* Added pollution tab to the production statistics.
* Spawner tooltip (including the pollution statistics), shows distribution of biters spawn for the current evolution factor with the pollution costs.
* Pollution generation is now shown in the x/s format both on the entity and in the item/crafting slot.
* Internal pollution values have been normalized, and they are now roughly 60 times less compared to what they were.}}

{{history|0.17.0|
* Rebalanced assembling machine 1,2 and 3 power consumption and pollution - higher tiers eat more power, but produce less pollution.
* Changed spawner pollution absorption logic so that all the pollution on a chunk doesn't build up un-spent in a single spawner.}}

{{history|0.13.2|
* Optimized rendering of huge pollution clouds on the map.}}

{{history|0.13.0|
* Large amounts of pollution is created when burning fires.
* Pollution creation of the productivity module was reduced drastically.
* Optimized pollution rendering on map and minimap.
}}

{{history|0.12.0|
* [[Tree]]s degenerate slowly when exposed to pollution at high levels. }}

{{history|0.8.0|
* Added option to turn off pollution visibility even when detailed info is on. }}

{{history|0.7.1|
* Speed modules no longer produce extra pollution.
* Added missing pollution descriptions.
* Pollution is only shown on the minimap with alt mode on.
}}

{{history|0.7.0|
* Introduced concept of pollution.}}

== See also ==
* [[Crafting]]
* [[Module]]s
* [[Enemies]]

Pollution

2022-09-10T04:03:57Z

CodeGreen: /* Spawners */ formatting

{{languages}}
[[File:Pollution.png|300px|thumb|Example of in-game pollution (red squares) in the map]]
[[File:pollution_gui.png|300px|thumb|Pollution tab in the production GUI.]]

Pollution is represented as an abstract "cloud", updated [[Map_structure#Chunk|per chunk]] every 64 [[Time#Ticks|ticks]] (which is 4 ticks more than a game-second), and visible on the map, when "alt-view" is on (default [[Keyboard bindings|Alt-Key]]). It appears as a red colored blocky cloud.

It is produced by many buildings involved in processing items and spreads outwards at a steady rate.

The [[Enemies#Evolution|evolution factor]] is not increased by the spreading/absorbed pollution, but by the pollution produced by all the player's [[Pollution#Polluters|machinery]] at every tick. This means that no matter how hard the player tries to contain the pollution, [[enemies]] will still evolve at the same rate. They just won't attack the player as frequently. The pollution cloud is used to trigger biter attacks and determines the size of the attacks.

Pollution settings can be changed via [[map generator|map generation]] settings, or can be disabled entirely.

== Pollution spread ==

As soon as a chunk has reached 15.0 pollution it starts spreading in all four cardinal directions at a rate of 2% per 64 ticks. Pollution can generate new chunks if it needs to spread to them.

For example, a chunk with 400.0 pollution and 4 adjacent chunks with 100.0 pollution each, raises the pollution in all adjacent chunks by 8.0 while reducing its own pollution by 32.0. But every one of the 4 surrounding spreads 2.0 pollution "back" to the center chunk, so it only loses 24.0 + [[Pollution#De-polluters|absorbed value]].

== Pollution dissipation==

* Every [[Map_structure#Chunk|chunk]] (32x32) of map slowly reduces the pollution it covers (See [[#Chunks]]). So the more the pollution spreads, the more is absorbed.
* [[Tree]]s also absorb some pollution (See [[#Trees]]).
* [[Enemies#Spawner|Spawners]] absorb a great amount of pollution, and use this to assign enemies to attacks.

== Native life ==
Pollution attracts [[Enemies#Biters|biters]] to the Player's factory. Biters who find themselves in a polluted area will attempt to reach the source of pollution and destroy it. Any [[water]] near the source of pollution will turn green, which is a visual-only effect. The effect can be turned off by disabling animated water in the graphics settings.

If a chunk's pollution is greater than 20, each enemy spawner absorbs 20 + 0.01 * [chunk's pollution] every 64 ticks, otherwise it absorbs 3 times the amount of pollution needed for the most expensive unit it can spawn for the current evolution factor.

Higher pollution values decrease the time it takes for biters to join the attack force. After a certain amount of pollution is absorbed the spawner sends one of its biters/spitters to a rendezvous point. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers.

Required pollution to add an additional biter/spitter to the attack wave:
{| class="wikitable" style="text-align:right;"
! style="width: 100px;" | Pollution 
! style="width: 130px;" | Type 
|-
| 4  || Small biter 
|-
| 20  || Medium biter 
|-
| 80  || Big biter 
|-
| 400  || Behemoth biter 
|-
| 4  || Small spitter 
|-
| 12  || Medium spitter 
|-
| 30  || Big spitter 
|-
| 200  || Behemoth spitter 
|-
|}

== Modules ==
[[Module]]s that list "+x% pollution" increase pollution multiplier, not a flat pollution rate. Final pollution value is (pollution multiplier * energy usage multiplier * base pollution), meaning heavily boosted buildings are likely to account for most of the pollution produced in a factory.

== Production/Absorption ==
These tables contain information about the levels of pollution produced/absorbed by items in the game.
=== Polluters ===
{| class="wikitable"
! Structure !! Pollution per minute at full power
|-
| {{Imagelink|Stone furnace}} || 2
|-
| {{Imagelink|Steel furnace}} || 4
|-
| {{Imagelink|Electric furnace}} || 1
|-
| {{Imagelink|Burner mining drill}} || 12
|-
| {{Imagelink|Electric mining drill}} || 10
|-
| {{imagelink|Pumpjack}} || 10
|-
| {{Imagelink|Assembling machine 1}} || 4
|-
| {{Imagelink|Assembling machine 2}} || 3
|-
| {{Imagelink|Assembling machine 3}} || 2
|-
| {{imagelink|Boiler}} || 30
|-
| {{Imagelink|Oil refinery}} || 6
|-
| {{Imagelink|Chemical plant}} || 4
|-
| {{Imagelink|Centrifuge}} || 4
|-
|}

Fire on the ground and burning trees produce 0.3 pollution per minute.

=== De-polluters ===

==== Spawners ====
Every 64 ticks, spawners absorb pollution until they have absorbed more than 3 times the amount needed to send the [[Enemies#Creatures|most expensive unit]] at the current evolution level.
If they have not absorbed more than that threshold, they will absorb 20 + 0.01 * [chunk's pollution] and check the threshold again.
Note that absorbing pollution is not for spawning biters, but for sending biters to an attack group. Spawners will spawn enemies regardless of pollution absorption until they reach their spawn limit.

==== Chunks ====
Every chunk has a natural absorption rate per second which is determined by the sum of the pollution absorption of its floor tiles.

Following numbers are the pollution reduction for a single tile per second.
{| class="wikitable"
! Tile !! Pollution per second !! Absorption rating
|-
| Grass 1-4 || -0.0000075 || 10
|-
| Dirt 1-7, dry dirt || -0.0000066 || 9
|-
| Red desert 0-3 || -0.0000066 || 9
|-
| Sand 1-3 || -0.0000058 || 8
|-
| Water, green water, deep water, deep green water, shallow water, mud water || -0.000005 || 7
|-
| Nuclear ground || -0.0000025 || 3
|-
| Path tiles (Stone bricks, concrete etc), landfill || 0 || 0
|-
| Special tiles (Lab tiles, tutorial grid, Water Wube) || 0 || 0
|-
| Out of map || -0.00001 || 13
|-
|}

==== Trees ====

Every single tree absorbs a small amount of pollution in its chunk per second. If the total pollution in a chunk is above 60 units, once per second some of the trees in that chunk each have a chance to either lose one stage of leaves or have their leaves become one stage more gray. Regardless of whether the tree loses leaves or gets grayer, 10 pollution are absorbed by the tree.<br>
A tree stops losing leaves/becoming more gray once the sum of its gray percentage and its leaves lost percentage is above 120%. 50% of trees stop their leaf progression one stage earlier. As the grayness and leaf stage are then locked for that tree forever, it is possible for trees to keep some leaves in heavily polluted chunks but in turn be very gray, or the other way around.<br>
The less dense the leaves, the slower the tree absorbs pollution, however tree grayness does not affect pollution absorption.

{| class="wikitable"
! Object !! Stage !! Pollution per second
|-
| rowspan="4" | [[File:Green tree.png|120px]] Tree, red tree, brown tree || 0 (Max leaf density) || -0.001
|-
| 1 || -0.00067
|-
| 2 || -0.00033
|-
| 3 (Min leaf density) || 0
|-
| [[File:Dead dry hairy tree.png|120px]] Dead dry hairy tree || No stages || -0.0001
|-
| [[File:Dead grey trunk.png|120px]] Dead gray trunk || No stages || -0.0001
|-
| [[File:Dead tree desert.png|120px]] Dead tree - desert|| No stages || -0.0001
|-
| [[File:Dry hairy tree.png|120px]] Dry hairy tree || No stages || -0.0001
|-
| [[File:Dry tree.png|120px]] Dry tree || No stages || -0.0001
|-
|}

== Achievements ==
Pollution is directly connected to the following achievement:
{{Achievement|it-stinks-and-they-dont-like-it}}

== History ==

{{history|0.17.12|
* Added pollution tab to the production statistics.
* Spawner tooltip (including the pollution statistics), shows distribution of biters spawn for the current evolution factor with the pollution costs.
* Pollution generation is now shown in the x/s format both on the entity and in the item/crafting slot.
* Internal pollution values have been normalized, and they are now roughly 60 times less compared to what they were.}}

{{history|0.17.0|
* Rebalanced assembling machine 1,2 and 3 power consumption and pollution - higher tiers eat more power, but produce less pollution.
* Changed spawner pollution absorption logic so that all the pollution on a chunk doesn't build up un-spent in a single spawner.}}

{{history|0.13.2|
* Optimized rendering of huge pollution clouds on the map.}}

{{history|0.13.0|
* Large amounts of pollution is created when burning fires.
* Pollution creation of the productivity module was reduced drastically.
* Optimized pollution rendering on map and minimap.
}}

{{history|0.12.0|
* [[Tree]]s degenerate slowly when exposed to pollution at high levels. }}

{{history|0.8.0|
* Added option to turn off pollution visibility even when detailed info is on. }}

{{history|0.7.1|
* Speed modules no longer produce extra pollution.
* Added missing pollution descriptions.
* Pollution is only shown on the minimap with alt mode on.
}}

{{history|0.7.0|
* Introduced concept of pollution.}}

== See also ==
* [[Crafting]]
* [[Module]]s
* [[Enemies]]

Pollution

2022-09-10T04:02:49Z

CodeGreen: Changed pollution cycle time from 60 ticks to the correct number, 64 ticks, and fixed the spawner absorption section to be accurate to it's actual behavior

{{languages}}
[[File:Pollution.png|300px|thumb|Example of in-game pollution (red squares) in the map]]
[[File:pollution_gui.png|300px|thumb|Pollution tab in the production GUI.]]

Pollution is represented as an abstract "cloud", updated [[Map_structure#Chunk|per chunk]] every 64 [[Time#Ticks|ticks]] (which is 4 ticks more than a game-second), and visible on the map, when "alt-view" is on (default [[Keyboard bindings|Alt-Key]]). It appears as a red colored blocky cloud.

It is produced by many buildings involved in processing items and spreads outwards at a steady rate.

The [[Enemies#Evolution|evolution factor]] is not increased by the spreading/absorbed pollution, but by the pollution produced by all the player's [[Pollution#Polluters|machinery]] at every tick. This means that no matter how hard the player tries to contain the pollution, [[enemies]] will still evolve at the same rate. They just won't attack the player as frequently. The pollution cloud is used to trigger biter attacks and determines the size of the attacks.

Pollution settings can be changed via [[map generator|map generation]] settings, or can be disabled entirely.

== Pollution spread ==

As soon as a chunk has reached 15.0 pollution it starts spreading in all four cardinal directions at a rate of 2% per 64 ticks. Pollution can generate new chunks if it needs to spread to them.

For example, a chunk with 400.0 pollution and 4 adjacent chunks with 100.0 pollution each, raises the pollution in all adjacent chunks by 8.0 while reducing its own pollution by 32.0. But every one of the 4 surrounding spreads 2.0 pollution "back" to the center chunk, so it only loses 24.0 + [[Pollution#De-polluters|absorbed value]].

== Pollution dissipation==

* Every [[Map_structure#Chunk|chunk]] (32x32) of map slowly reduces the pollution it covers (See [[#Chunks]]). So the more the pollution spreads, the more is absorbed.
* [[Tree]]s also absorb some pollution (See [[#Trees]]).
* [[Enemies#Spawner|Spawners]] absorb a great amount of pollution, and use this to assign enemies to attacks.

== Native life ==
Pollution attracts [[Enemies#Biters|biters]] to the Player's factory. Biters who find themselves in a polluted area will attempt to reach the source of pollution and destroy it. Any [[water]] near the source of pollution will turn green, which is a visual-only effect. The effect can be turned off by disabling animated water in the graphics settings.

If a chunk's pollution is greater than 20, each enemy spawner absorbs 20 + 0.01 * [chunk's pollution] every 64 ticks, otherwise it absorbs 3 times the amount of pollution needed for the most expensive unit it can spawn for the current evolution factor.

Higher pollution values decrease the time it takes for biters to join the attack force. After a certain amount of pollution is absorbed the spawner sends one of its biters/spitters to a rendezvous point. Every 1 to 10 minutes (random) the mustered biters launch an attack. If not all biters have arrived at the rendezvous point by that time, they will wait up to an additional 2 minutes for stragglers.

Required pollution to add an additional biter/spitter to the attack wave:
{| class="wikitable" style="text-align:right;"
! style="width: 100px;" | Pollution 
! style="width: 130px;" | Type 
|-
| 4  || Small biter 
|-
| 20  || Medium biter 
|-
| 80  || Big biter 
|-
| 400  || Behemoth biter 
|-
| 4  || Small spitter 
|-
| 12  || Medium spitter 
|-
| 30  || Big spitter 
|-
| 200  || Behemoth spitter 
|-
|}

== Modules ==
[[Module]]s that list "+x% pollution" increase pollution multiplier, not a flat pollution rate. Final pollution value is (pollution multiplier * energy usage multiplier * base pollution), meaning heavily boosted buildings are likely to account for most of the pollution produced in a factory.

== Production/Absorption ==
These tables contain information about the levels of pollution produced/absorbed by items in the game.
=== Polluters ===
{| class="wikitable"
! Structure !! Pollution per minute at full power
|-
| {{Imagelink|Stone furnace}} || 2
|-
| {{Imagelink|Steel furnace}} || 4
|-
| {{Imagelink|Electric furnace}} || 1
|-
| {{Imagelink|Burner mining drill}} || 12
|-
| {{Imagelink|Electric mining drill}} || 10
|-
| {{imagelink|Pumpjack}} || 10
|-
| {{Imagelink|Assembling machine 1}} || 4
|-
| {{Imagelink|Assembling machine 2}} || 3
|-
| {{Imagelink|Assembling machine 3}} || 2
|-
| {{imagelink|Boiler}} || 30
|-
| {{Imagelink|Oil refinery}} || 6
|-
| {{Imagelink|Chemical plant}} || 4
|-
| {{Imagelink|Centrifuge}} || 4
|-
|}

Fire on the ground and burning trees produce 0.3 pollution per minute.

=== De-polluters ===

==== Spawners ====
Every 64 ticks, spawners absorb pollution until they have absorbed more than 3 times the amount needed to send the [[Enemies#Creatures|most expensive unit]] at the current evolution level. If they have not absorbed more than that threshold, they will absorb 20 + 0.01 * [chunk's pollution] and check the threshold again. Note that absorbing pollution is not for spawning biters, but for sending biters to an attack group. Spawners will spawn enemies regardless of pollution absorption until they reach their spawn limit.

==== Chunks ====
Every chunk has a natural absorption rate per second which is determined by the sum of the pollution absorption of its floor tiles.

Following numbers are the pollution reduction for a single tile per second.
{| class="wikitable"
! Tile !! Pollution per second !! Absorption rating
|-
| Grass 1-4 || -0.0000075 || 10
|-
| Dirt 1-7, dry dirt || -0.0000066 || 9
|-
| Red desert 0-3 || -0.0000066 || 9
|-
| Sand 1-3 || -0.0000058 || 8
|-
| Water, green water, deep water, deep green water, shallow water, mud water || -0.000005 || 7
|-
| Nuclear ground || -0.0000025 || 3
|-
| Path tiles (Stone bricks, concrete etc), landfill || 0 || 0
|-
| Special tiles (Lab tiles, tutorial grid, Water Wube) || 0 || 0
|-
| Out of map || -0.00001 || 13
|-
|}

==== Trees ====

Every single tree absorbs a small amount of pollution in its chunk per second. If the total pollution in a chunk is above 60 units, once per second some of the trees in that chunk each have a chance to either lose one stage of leaves or have their leaves become one stage more gray. Regardless of whether the tree loses leaves or gets grayer, 10 pollution are absorbed by the tree.<br>
A tree stops losing leaves/becoming more gray once the sum of its gray percentage and its leaves lost percentage is above 120%. 50% of trees stop their leaf progression one stage earlier. As the grayness and leaf stage are then locked for that tree forever, it is possible for trees to keep some leaves in heavily polluted chunks but in turn be very gray, or the other way around.<br>
The less dense the leaves, the slower the tree absorbs pollution, however tree grayness does not affect pollution absorption.

{| class="wikitable"
! Object !! Stage !! Pollution per second
|-
| rowspan="4" | [[File:Green tree.png|120px]] Tree, red tree, brown tree || 0 (Max leaf density) || -0.001
|-
| 1 || -0.00067
|-
| 2 || -0.00033
|-
| 3 (Min leaf density) || 0
|-
| [[File:Dead dry hairy tree.png|120px]] Dead dry hairy tree || No stages || -0.0001
|-
| [[File:Dead grey trunk.png|120px]] Dead gray trunk || No stages || -0.0001
|-
| [[File:Dead tree desert.png|120px]] Dead tree - desert|| No stages || -0.0001
|-
| [[File:Dry hairy tree.png|120px]] Dry hairy tree || No stages || -0.0001
|-
| [[File:Dry tree.png|120px]] Dry tree || No stages || -0.0001
|-
|}

== Achievements ==
Pollution is directly connected to the following achievement:
{{Achievement|it-stinks-and-they-dont-like-it}}

== History ==

{{history|0.17.12|
* Added pollution tab to the production statistics.
* Spawner tooltip (including the pollution statistics), shows distribution of biters spawn for the current evolution factor with the pollution costs.
* Pollution generation is now shown in the x/s format both on the entity and in the item/crafting slot.
* Internal pollution values have been normalized, and they are now roughly 60 times less compared to what they were.}}

{{history|0.17.0|
* Rebalanced assembling machine 1,2 and 3 power consumption and pollution - higher tiers eat more power, but produce less pollution.
* Changed spawner pollution absorption logic so that all the pollution on a chunk doesn't build up un-spent in a single spawner.}}

{{history|0.13.2|
* Optimized rendering of huge pollution clouds on the map.}}

{{history|0.13.0|
* Large amounts of pollution is created when burning fires.
* Pollution creation of the productivity module was reduced drastically.
* Optimized pollution rendering on map and minimap.
}}

{{history|0.12.0|
* [[Tree]]s degenerate slowly when exposed to pollution at high levels. }}

{{history|0.8.0|
* Added option to turn off pollution visibility even when detailed info is on. }}

{{history|0.7.1|
* Speed modules no longer produce extra pollution.
* Added missing pollution descriptions.
* Pollution is only shown on the minimap with alt mode on.
}}

{{history|0.7.0|
* Introduced concept of pollution.}}

== See also ==
* [[Crafting]]
* [[Module]]s
* [[Enemies]]