Official Factorio Wiki - User contributions [en]

Tutorial:Modding tutorial/Gangsir

2023-09-20T14:10:36Z

Justarandomgeek: /* Creation of the directory structure */ Stronger hint not to use zips while working

{{Languages}}
This is a modding tutorial for Factorio version 1.1. In this tutorial, the author will explain how Factorio works behind the scenes, how to modify Factorio, where to find documentation, and explain concepts.

== Overview ==
Before we start the tutorial, a few things to note:

<pre style="background-color:#AAFFAA!important; color:black">
Code tinted green like this should be included into the mod this tutorial is going to create; If the reader follows along with it. The best way to do this is to copy and paste, to ensure faithful reproduction.
Whenever code is added to the mod, a Lua comment with the file name will be at the beginning of the green box. Place the code in the box into that file. Eg:
--control.lua
</pre>

<pre style="background-color:#DDA0DD!important; color:black">
Code tinted purple like this should not be included into the mod, it's just for educational/example purposes, and to boost understanding.
</pre>

This tutorial was updated to version 1.1, so any ''viewers in the future should take note that some minor changes may have been made'', and should look at the changelogs up to the current version.

== Terminology used in modding ==

Before we start the tutorial, a few terms and definitions should be laid out, to ensure the reader understands.

; Mod : A script or series of scripts that allow modifications to the game through the API.
; Entity : An entity in Factorio is anything in the game that is not a concept, event, or tile. Examples of entities include the character, an assembling machine, a biter, etc. This can be 'machines' or free-moving objects like the character.
; Character : The actual entity that the player manipulates the world through.
; Player : All the data that defines a player, such as username, online time or the current zoom level.
; Prototype : A prototype describes an instance of an entity, item or recipe etc, a bit like a template. It defines stats, like what an entity actually is, an item's stack size, a recipe's ingredients etc. A prototype is used to create an instance of an entity/item/etc, and many functionally identical entities/items/etc will use the same prototype.
; Surface : A surface is a bit like a dimension. It is composed of terrain, such as grass, sand, and water, and all the entities on the surface. By default, there is only one surface in Factorio, referred to internally as "nauvis", or <code style="background-color:#DDA0DD; color:black">game.surfaces[1]</code>, but mods may create additional surfaces through the API.
; Event : An event is a recurring...event, that is triggered internally by the game. There are several events that mods may connect functions to, such as <code style="background-color:#DDA0DD; color:black">on_entity_died</code>, etc. More on this in the control scripting section.
; Item : Items are what is moved around in inventories, by inserters and on belts, etc. Each item in-game is an instance of the respective item prototype.

More terminology may be declared and defined later in this tutorial.

== Before beginning to mod ==

Before we can start modding Factorio, we must understand what Factorio is. You may be tempted to answer in lieu of the [[Factorio:About|about page]], but that is what a player would say. Since we are trying to become a modder, we need a more detailed explanation. Factorio is a game that is coded in the language C++, with an API provided by Wube (the developers of Factorio) to mod Factorio in the programming language Lua (version 5.2.1). This API allows adding scripts to the Factorio init process, to modify it without the source code of the base game being exposed, or modifying memory. This may be different than other games that offer modding, but this is a more professional and proper way of supporting modding.

To aid in the use of this API, the devs have kindly provided fairly comprehensive documentation of scripting at their [https://lua-api.factorio.com/latest/ API site] and documentation all around prototypes on [[Prototype definitions|this wiki]]. Get used to using these sites, as they will become frequent visits you will make while you develop mods. The scripting API site contains information on [https://lua-api.factorio.com/latest/Classes.html Factorio's classes] and information on [https://lua-api.factorio.com/latest/events.html events] that you can hook into. [[Prototype definitions]] contains and links to information all around prototypes, listing their inheritance structure and their properties. You will need to check these sites often, so the author recommends bookmarking them. In addition to these sites, there is also many resources to be found created by the community, such as this tutorial.

=== Setup ===

The best way to develop a mod is to develop it in a place where it can be easily tested. When the tutorial gets to making the mod, this will be explained further. Additionally, using an editor that allows ease of typing and Lua language support is recommended. Emacs, Vim, Sublime Text, VSCode, and Notepad++ are all viable candidates.

== How Factorio loads mods ==

=== Load order ===
Within stages, mods are loaded by dependency, then by alphabetical order. This is ''very important'' to understand, as it can cause you problems if you neglect it and try to add inter-mod support to your mod.

Factorio has three kinds of dependencies. There are required dependencies, and optional dependencies. The third kind, restrictive dependencies, does not affect mod order and instead prevents the game from loading if the other mod is found. Required dependencies are loaded first, always. The game will fail to initialize if one of these is not present. Optional dependencies are loaded first if present, but do not have to be present. This is useful for enabling bonus features if mods are used together. Required dependencies should be used for mod libraries, and similar infrastructure.

=== The settings stage ===
The very first mod stage that is loaded when Factorio initializes is the settings stage. This stage is used to define all mod settings that are later shown in the in-game mod settings GUI, and has no other functions or possibilities. When running through this stage, the game looks through all mods for a file called <code>settings.lua</code>. After settings.lua has been executed for all mods, each mod's <code>settings-updates.lua</code> is executed, and finally each mod's <code>settings-final-fixes.lua</code> is called. These 3 different phases of the settings stage allow to change settings of other mods without needing to rely on dependencies to load last. All other files to be loaded will need to be required. All the files run here should contain nothing but setting definitions and code to produce setting definitions.

The settings stage does not have access to prototype or runtime data because it is loaded before those stages. The settings are expected to have a certain format, and all additional code will be discarded once the stage is over.

Mod settings are not covered in this tutorial, see [[Tutorial:Mod settings]] for further info on them.

=== The data stage ===

This is the most restricted part of the Factorio init, there's not much you can do here other than declare prototypes for technologies, entities, items and more. Things like manipulating files, affecting the world, etc, are blocked/unavailable. In fact, any functions or changes made will be discarded, as the lua session is terminated. You also cannot mess with the data table, it will error or be ignored. When using <code>data:extend({})</code>, it expects a specific format, more on this later.

When running through this stage, the game looks through all mods for a file called <code>data.lua</code>. After data.lua has been executed for all mods, each mod's <code>data-updates.lua</code> is executed, and finally each mod's <code>data-final-fixes.lua</code> is called. These 3 different phases of the data stage allow to change data of other mods without needing to rely on dependencies to load last. For example, the base mod creates barrelling recipes for all (then present) fluids in data-updates.lua. This means that if you add a fluid in data.lua, the base mod's data-updates.lua will add barreling recipes for it, regardless of whether your mod depends on base. Of course this also means that if you add a fluid in data-final-fixes.lua, it is created after the barrelling code runs in data-updates.lua, so no barrelling recipe gets created, even when desired. Because of this and similar mod interactions, it is recommended to create prototypes as early as possible. So, don't use data-final-fixes.lua to exclude a fluid from barreling, instead create it in data.lua and utilize "auto_barrel = false" on the fluid.

All other files to be loaded will need to be required. All the files run here should contain nothing but prototype definitions and code to produce prototype definitions. More on requiring files later.

All prototypes are documented here on the wiki: [[Prototype definitions]].

=== Migrations ===

[https://lua-api.factorio.com/latest/Migrations.html Migrations] are scripts that are used to "fix" a save after a mod updates. Whenever prototype names change within a mod, migrations must be setup to replace all the old instances of the prototyped entity in the world. This must be done for all updated entities, or the old entities will be removed from the world, which is an unprofessional fallback that makes users dislike you. While this tutorial will not discuss migrations, there are many resources on migrations to be found around the community, and the API site.

To avoid having to write migrations, avoid changing prototype names and technology unlocks. Prototypes names cannot be dynamically changed and technology unlocks of already researched technologies do not apply automatically, making migrations necessary. Try to avoid these changes after shipping the mod out to the public. Try to come up with a finalized version of prototype names that you can base the mod around. Of course, migrations are unnecessary if the user simply starts a new world with each mod update, but do not expect the community to do this.

=== Runtime stage ===

Within most mods is a file called <code>control.lua</code>. This file contains scripting that makes the mod do things during the game, rather than just adding entities to the game. During this stage, each mod's control.lua is run, in it's own lua instance (this means no inter-communication without special setup) which it will own for the rest of the play session. During the play session, access to all tables provided by the game can be done inside of event handlers. (More on those below.) Because the control.lua is run every time a save file is created or loaded you don't need to restart the game to see changes made to the control.lua file. Simply restarting or reloading a save will re-run this stage. '''There are a few other caveats to this stage, reading the [https://lua-api.factorio.com/latest/Data-Lifecycle.html data life cycle] page on the API site provides the best overview.'''

The control stage documented is documented on [https://lua-api.factorio.com/latest lua-api.factorio.com].

== The major components to any Factorio mod ==

Within the average mod, there are several components that make the mod function.

Mods that define new entities will need to declare these entities in <code>data.lua</code>, <code>data-updates.lua</code>, <code>data-final-fixes.lua</code>, or another file <code>require</code>d by one of these three.

Mods with in-game effects will also need a <code>control.lua</code> file, to add scripting.

Mods with configurable user settings will use <code>settings.lua</code> to describe those settings.

Mods that define any game element with a readable name may also provide a <code>locale</code> directory and subdirectories with names/descriptions in one or more languages.

The mod that we'll make in this tutorial will include both data.lua prototypes and control.lua scripting, to give you a feel for both.

== The tutorial mod ==

And now for the moment you've been waiting for. Let's start making your first mod. You'll need:

* A recent install of Factorio
* A text editor, such as Emacs, Vim, Sublime text, etc
* An understanding of the tutorial above
* An understanding of Lua as a programming language. Enough to know the syntax and how it works. If you have prior programming experience, it should not be difficult to pick up.

Once you have all of these things, we can begin.

For this mod, we're going to make a set of armor that leaves behind damaging fire behind you as you walk. It will be fully resistant to fire, but weaker towards physical damage than heavy armor, making it an armor for hit and run attacks.

=== Creation of the directory structure ===

The game expects mod to be laid out [[Tutorial:Mod structure|in a certain way]]. To start out, create a folder in your [[Application directory|user data directory]]/mods folder. This folder must have a specific name, <code>fire-armor</code>. You don't need to zip anything for now, that will come later when you're done working on the mod. When you're finished, the mod directory should look like this:

* (user data directory, sometimes called .factorio)
** mods
*** fire-armor

Then, inside fire-armor, create two files, <code>info.json</code> and <code>data.lua</code>. The directory should now look like:

* (user data directory, sometimes called .factorio)
** mods
*** fire-armor
**** data.lua
**** info.json

=== The info.json file ===

Then, inside [[Tutorial:Mod_structure#info.json|info.json]], copy and paste the following into it:

<pre style="background-color:#AAFFAA!important; color:black">
{
"name": "fire-armor",
"version": "0.1.0",
"title": "Fire Armor",
"author": "You",
"factorio_version": "1.1",
"dependencies": ["base >= 1.1"],
"description": "This mod adds in fire armor that leaves behind damaging fire as you walk around."
}
</pre>

To explain each field:

{| class="wikitable"
! Item
! Explanation
|-
| name
| This is the internal name of your mod, it is used to identify your mod in code.
|-
| version
| This is the version of your mod. This can be anything you want, provided it's a of the format "number.number.number".
|-
| title
| The pretty title of your mod, this will be displayed on the mods screen and when you submit it to the mod portal.
|-
| author
| Your name! You can change this in the example above.
|-
| factorio_version
| This tells the game what version the mod is for, this must match the version you're developing the mod for, 1.1 in this case.
|-
| dependencies
| Any dependencies of your mod.
|-
| description
| A short description of your mod, which appears in game. The mod portal is better for a long description.
|}

And that's all for info.json! Next, in the data.lua file:

<pre style="background-color:#AAFFAA!important; color:black">
--data.lua

require("item")
</pre>

It's a pretty simple file, all we're doing here is just telling the game to execute the file called item.lua, which we're about to create. Create a file in fire-armor called <code>item.lua</code>. Notice how our earlier require used the file name in it?

We are creating this file just for our own organisation inside the mod, so there are no naming or other requirements from the game's side. As long as we tell the game to load the file with "require", the file name or its exact location inside the mod does not matter.

=== Prototype creation ===

Now, there are two ways to create prototypes in Factorio. There's the short way, and the long way. The long way requires to create a complete prototype definition based on [[prototype definitions|the documentation]], and the short way just uses a lua function to copy and modify an already existing definition. For the sake of this tutorial, we'll do it the short way.

In item.lua, copy and paste the following:

<pre style="background-color:#AAFFAA!important; color:black">
--item.lua

local fireArmor = table.deepcopy(data.raw["armor"]["heavy-armor"]) -- copy the table that defines the heavy armor item into the fireArmor variable

fireArmor.name = "fire-armor"
fireArmor.icons = {
{
icon = fireArmor.icon,
tint = {r=1,g=0,b=0,a=0.3}
},
}

fireArmor.resistances = {
{
type = "physical",
decrease = 6,
percent = 10
},
{
type = "explosion",
decrease = 10,
percent = 30
},
{
type = "acid",
decrease = 5,
percent = 30
},
{
type = "fire",
decrease = 0,
percent = 100
}
}

local recipe = table.deepcopy(data.raw["recipe"]["heavy-armor"])
recipe.enabled = true
recipe.name = "fire-armor"
recipe.ingredients = {{"copper-plate",200},{"steel-plate",50}}
recipe.result = "fire-armor"

data:extend{fireArmor,recipe}

</pre>

What we've just done here is we've copied the definition of heavy armor, then changed it's properties, and injected it into the Factorio init with data:extend. The first line of code is probably the most interesting. <code>table.deepcopy</code> copies a table fully into another table. We do this from data.raw. The <code>data</code> part is a table, which will be used by the game to setup the Factorio universe. In fact, it contains the function <code>extend(self, prototypes)</code> and a table called <code>raw</code>. The former is a customary way to add new stuff to the latter. It is actually data.raw that holds the prototypes for the game. (You can view the implementation in the file [https://github.com/wube/factorio-data/blob/master/core/lualib/dataloader.lua /factorio/data/core/lualib/dataloader.lua]). It is important to note that data.raw only exists during the data loading stage of the game. During the control stage, when the game is running and being played, you cannot read this data; instead you read processed values through the API from the various types like LuaEntityPrototype.

In addition to defining the item prototype, we also define a recipe for it. This is necessary if you want to be able to craft the thing. We also set it to enabled so it doesn't need a technology to unlock.

=== More on data.raw ===

When Factorio initializes, all prototypes are put into a table called data.raw. This table holds all prototype types, and within those types, individual prototypes identified by name: <code>local prototype = data.raw["prototype-type"]["internal-name"]</code>. You saw earlier how we deepcopied from the definition of heavy armor, and modified some fields. In fact, let's go over each part of the deepcopy line:

<pre style="background-color:#DDA0DD!important; color:black">
local fireArmor = table.deepcopy(data.raw["armor"]["heavy-armor"])
</pre>

We assign a variable called fireArmor that holds our copy of the heavy armor definition. Notice how in data.raw, there is a type table that holds all armors, and the specific armor we're looking for is called heavy-armor. We can find [[heavy armor]]'s prototype type and internal name in the infobox of its page on this wiki and just copy it from there. 
Alternatively, we can find the items prototype type and internal name by opening the game, inserting the item into our inventory and then pressing {{Keybinding|shift|ctrl|F}} while hovering over the item. This will open the prototype explorer GUI, which has rows showing the name and type of the item.

As another example, the [[player|character]]'s prototype would be, according to the infobox on the page:

<pre style="background-color:#DDA0DD!important; color:black">
data.raw["character"]["character"]
</pre>

Because the character is ''the'' character, his type matches his name. You could define a new type of character with a mod. You can see all the available prototype fields of the charater in the documenation: [[Prototype/Character]].

You may be thinking at this point, "Can I modify Factorio's existing prototypes without making new ones?" Well, the answer is yes! You would simply access the data.raw table during init, in data-final-fixes.lua if you want to run after all other mods, and change a property. For example, make the iron chest instead have 1000 health:

<pre style="background-color:#DDA0DD!important; color:black">
data.raw["container"]["iron-chest"].max_health = 1000
</pre>

The reason why this code is in data-final-fixes.lua is because that is the last file run, after all mod files have been run. This prevents (to a degree) your changes from being messed with by other mods. Of course, it is still possible to have incompatibilities. You should note any that you know of in your mod's description. Again, the [https://lua-api.factorio.com/latest/Data-Lifecycle.html dev's documentation] on this should be looked at.

This can also be applied to other mods, not just Factorio's base. You could mod a mod, as long as you add the mod (that you modified with your mod) to your dependencies so it gets loaded first.

=== The control scripting ===

And now, to finalize the mod, we have to make it be more than just simple armor. Let's think about what we want the armor to do. We want the armor to create fire on the ground as we walk with the armor on. The event we're going to use is called [https://lua-api.factorio.com/latest/events.html#on_player_changed_position on_player_changed_position], since we want the fire to be created when the player moves.

In our mod folder, create a file called <code>control.lua</code>. The game will automatically execute this file, so requiring it is not necessary.

Inside control.lua, copy and paste the following:

<pre style="background-color:#AAFFAA!important; color:black;">
--control.lua

script.on_event(defines.events.on_player_changed_position,
function(event)
local player = game.get_player(event.player_index) -- get the player that moved
-- if they're wearing our armor
if player.character and player.get_inventory(defines.inventory.character_armor).get_item_count("fire-armor") >= 1 then
-- create the fire where they're standing
player.surface.create_entity{name="fire-flame", position=player.position, force="neutral"}
end
end
)

</pre>

I've used lua comments in the code above to explain each step. It's fairly easy to understand, and it shows how you would get the current armor that the player character is wearing, with defines.inventory.character_armor, which is an inventory constant. You can read the list of defines [https://lua-api.factorio.com/latest/defines.html#defines.inventory here].

=== Locale ===

If you've already tried loading up Factorio and trying the mod so far (which you can at this point without it crashing), you may have noticed that the item name of the armor says "Unknown key". This means that Factorio has the internal name, but it doesn't know what it should look like to the user. So, we need to create a locale for our mod.

In the mod folder, create a folder called <code>locale</code>, then create another folder inside that called <code>en</code>, then a file called <code>any_name_can_be_here.cfg</code>.

If you know another language, you can also translate your mod by making other language code files inside locale, such as de for German.

Inside the .cfg file, paste the following:

<pre style="background-color:#AAFFAA!important; color:black">

[item-name]
fire-armor=Fire armor

[item-description]
fire-armor=An armor that seems to catch the ground itself on fire when you take a step. It's warm to the touch.
</pre>

Notice how this is not a lua file. Locale is handled with C config files, so the format is different.

== The finished tutorial mod ==

Well, the mod is finished. Since this mod is only a tutorial, there isn't much balance to it.

If you want to share a mod with other users, it needs to be a zip file. For that, simply zip the <code>fire-armor</code> folder and then rename the archive to <code>fire-armor_0.1.0</code> so that it follows the expected mod zip name pattern of <code>mod-name_version</code>. Keep in mind to not submit this tutorial mod to the mod portal as your own, since it's from the Wiki.

However, you're free to take this mod and modify it for your own use, changing recipes, adding technologies, whatever.

== Resolving common errors in modding ==

As you continue to write mods from scratch instead of from a tutorial, you may encounter the infamous error. There are several types of errors that you can encounter in modding Factorio, and knowing how to deal with these errors will allow you to continue working.

=== Syntax errors ===

The lua programming language expects things to be laid out a certain way. If you miss a bracket, = sign, or dot, you will encounter a syntax error. As an example, see the error below:

<pre style="background-color:#DDA0DD!important; color:black">
Failed to load mods: __fire-armor__/data.lua:1:__fire-armor__/prototypes/item.lua:36: syntax error near 'true'
</pre>

As of version 0.15, you'll see an error like the one above whenever you make a syntax error within the prototype definitions. The game will offer to restart, disable the troubling mod, disable all mods, or exit. Let's dissect the error, shall we?

Right away, we see the reason why Factorio didn't start normally. "Failed to load mods:". So, we know that it's a mod that messed up, and by extension, we know it's our mod. Whenever the Lua engine of Factorio has a syntax error, it will print a mini stack-trace that follows through all requires, listing the call order. First, we see that the problem was indirectly caused by line 1 of data.lua. There's no problem there, so it must be the next entry, line 36 of prototypes/item.lua. After stating where it is line-wise, it will attempt to give you an estimate of where in the line the problem is. Don't trust this estimate, only roughly trust the line number, plus or minus a few lines.

Going to line 36 of item.lua, we find:

<pre style="background-color:#DDA0DD!important; color:black">
recipe.enabled true
</pre>

Hmm, that doesn't look right. Can you see what's missing? We left off an = between enabled and true. Thus, syntax error. Fixing these can be difficult for new programmers, who don't know what to look for.

=== Illogical actions, indexing nil ===

In lua, "nothing" is defined as the keyword nil. This is similar to null in other programming languages. Whenever the programmer tries to access something in a table that is nil, they will get an error like the following:

<pre style="background-color:#DDA0DD!important; color:black">
Error while running event fire-armor::on_player_changed_position (ID 82)
__fire-armor__/control.lua:3: attempt to index field '?' (a nil value)
</pre>

The "attempt to index field ..." error is often caused by the modder making an assumption that didn't work out. These types of errors will always be identifiable by their signature line, "attempt to index field". If we look at line 3 of control.lua (where the error is), we see:

<pre style="background-color:#DDA0DD!important; color:black">
game.print(game.players[23])
</pre>

What assumption has the modder made here? Well, there's actually two problems with this line. The first thing is that the modder has assumed that <code>game.players[23]</code> is a valid player, which isn't the case; this is why we get the "index field '?'" bit. The game doesn't know what the field is that we tried to index, because it hasn't been created yet. These errors are difficult to debug unless you know the ins and outs of the modding API well.

The second issue is a lot more subtle, and won't work. The modder is attempting to print a userdata table. [https://lua-api.factorio.com/latest/LuaPlayer.html A player] is a table of several values. Trying to print it simply print "LuaPlayer" instead of providing useful data.

=== Error while running event ===

Another common type of error in Factorio is the "Error while running event" error. This type of error only happens in control.lua scripting, and it happens when something goes wrong in an event function, such as a syntax error. '''Note that syntax errors in control.lua do not stop the game from starting, but may trigger after a save is loaded'''. There are a great deal of errors under this broad category, here's an example:

<pre style="background-color:#DDA0DD!important; color:black">
Error while running event fire-armor::on_player_changed_position (ID 82)
Unknown entity name: fire-flam
stack traceback:
__fire-armor__/control.lua:7: in function <__fire-armor__/control.lua:2>
</pre>

As you saw with the prototypes syntax error, Factorio gives a small traceback and the error name itself. In this case, we've attempted to spawn an entity called "fire-flam" on line 7 of control.lua, inside of an on_player_changed_position event hook. Fire-flam isn't a real entity type, so we crashed.

These types of errors can range from being a simple fix (like the one above, add the missing e), or can be very difficult.

=== Internal errors ===

The most rare form of error and the worst form is the internal error. This is an error with the C++ code of the game, and there's nothing you can do but report it to the devs. Mods occasionally cause these, and almost all of them are considered bugs, as mods ''should not'' be able to cause these, if that makes sense. They often get thrown into the logs.

An example:

<pre style="background-color:#DDA0DD!important; color:black">
696.148 Error FlowStatistics.cpp:236: FlowStatistics attempted to save value larger than uint16 as uint16. Exiting to prevent save corruption.
Logger::writeStacktrace skipped.
696.148 Error CrashHandler.cpp:190: Map tick at moment of crash: 432029
696.148 Error Util.cpp:97: Unexpected error occurred. If you're running the latest version of the game you can help us solve the problem by posting the contents of the log file on the Factorio forums.
Please also include the save file(s), any mods you may be using, and any steps you know of to reproduce the crash.
</pre>

== Multiplayer and desyncs ==

The reader may be wondering at this point how Factorio handles multiplayer with mods. It's fairly simple, but is still worth considering.

Factorio is [https://en.wikipedia.org/wiki/Deterministic_algorithm deterministic], which means that when you provide a constant input, you get a constant output, with no variance. Every client and the server all reach the same points at the same time in simulation, so they all agree on what happened. When this differs, the players experience a ''desync''.

; Desync : Misalignment with server and clients. Client 1 expected A, but got B. All other clients got A. Thus, Client 1 will desync. Desync can also happen when all clients have information (for example a variable) but a client that recently joined the game doesn't. That client will be desynced.
: ''See also: [[Desynchronization]]''

Desyncs happen a lot to new devs of Factorio mods, because they are unaware that a particular piece of code they used causes desyncs. As a general rule, there are a few things that should never be done.

=== Use local variables that are not final outside of event hooks ===

<pre style="background-color:#DDA0DD!important; color:black">
local globalLocal = 1
script.on_event(defines.events.on_player_built_item, function()
globalLocal = math.random()
end)
</pre>

If the modder places a local variable outside of an event hook that gets changed during runtime, desyncs will happen when that variable is utilised to modify the game state (i.e. manipulate an entity, print text to players). If making a "global" variable is necessary, place the variable in the [https://lua-api.factorio.com/latest/Global.html global] table instead. The game syncs this table between all clients, so they can all be aware of and reach the same conclusion as each other.

=== Selective requiring ===

<pre style="background-color:#DDA0DD!important; color:black">
if setting1 then
require("settingOne.lua")
end
</pre>

Selective requiring, aka requiring different lua files based on settings can cause connection rejections as the checksum of the mods will not match, as they load different data. All clients' mods must require the same series of files.

=== Conditional event subscribing ===

Mods in factorio may subscribe to events in order to be notified when they happen. This allows mods to react to events when they occur. Typically, event subscription is done at the top level of a lua file.

Doing event subscription inside of a conditional, function, or other event is dangerous, as doing it incorrectly will lead to desyncs. Basically, since both the server and client need to reach the same conclusion after running code, conditional subscription can lead to certain clients or the server being subscribed to an event when the others are not, causing desyncs.

=== Improper use of on_load ===

Another way to cause desyncs is to make improper actions inside of an on_load call, which some players new to modding might try to do. According to the [https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_load documentation], the on_load functionality is meant for 3 purposes '''only''':

* Re-register conditional event handlers
* Re-setup meta tables
* Create local references to tables stored in the global table

Doing anything else will cause desyncs. The game will catch most attempts, crashing instead and terminating the mod.

=== Comparison by reference ===

Be cautious of comparing tables by reference. In multiplayer syncing, tables deserialized from the server state will be new objects, not equal by reference to any table initialized by client code.

<pre style="background-color:#DDA0DD!important; color:black">
if a == b then
</pre>
<pre style="background-color:#DDA0DD!important; color:black">
if a ~= b then
</pre>
If <code>a</code> and <code>b</code> are tables in the above conditionals, there will for example be different results between server and client if <code>a</code> is created locally and <code>b</code> is downloaded from the server.

Note that LuaObjects provided by the game have their equality operator overwritten to prevent this behaviour, so code such as <code>LuaEntityA ~= LuaEntityB</code> will not desync.
However, this does not apply when LuaObjects are used as keys in tables:
<pre style="background-color:#DDA0DD!important; color:black">
if table[LuaObject] then
</pre>
This will desync in the same way as described for the plain tables <code>a</code> and <code>b</code> above. For entities it is recommended to use [https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.unit_number LuaEntity.unit_number] as the table key instead of the whole entity.

== Extended learning ==

One of the best ways to learn how to mod beyond this is to look at other mods. The [[Tutorial:Inspecting a live mod]] is a good starting point for touring a particularly well-commented mod. As all mods can be opened and inspected, looking at the mods of experienced modders can help significantly when making your own mod.

=== Keeping your mod working ===

As Factorio evolves, things will change. Previously, you probably ignored the modding part of the changelog, you now need to read it and see if any changes affect your mod(s). If so, you'll need to fix them. If there's something wrong with your mod, the game will fail to init and explain why.

== See also ==

* [[Modding]]
* [[Modding FAQ]]

Types/NoiseExpression

2023-04-18T23:06:23Z

Justarandomgeek: /* Functions */ functions only support up to 32 args

== Basics ==

A fragment of a functional program used to generate coherent noise, probably for purposes related to terrain generation.

Noise expressions can be provided as table literals or built using functions in the [https://github.com/wube/factorio-data/blob/master/core/lualib/noise.lua built-in <code>noise</code> library]. The built-in noise library allows writing much more concise code, so its usage will be shown in most examples on this page. 
[https://github.com/wube/factorio-data/blob/master/core/lualib/noise.lua#L272 <code>noise.define_noise_function</code>] allows noise expressions to be defined using a shorthand
that's a subset of Lua (see [[#Example definition|example definition]] for an example and its literal equivalent).

'''Types/NoiseExpression''' is used by [[Prototype/NamedNoiseExpression#expression|NamedNoiseExpressionPrototype::expression]], [[Types/AutoplaceSpecification#Properties_for_Expression-based_AutoplaceSpecifications|AutoplaceSpecification::probability_expression]] and [[Types/AutoplaceSpecification#Properties_for_Expression-based_AutoplaceSpecifications|AutoplaceSpecification::richness_expression]].

== Mandatory properties ==

=== type ===

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

Name of the type of this expression.
Which other properties apply depend on the expression type.

== Expression types ==

=== variable ===
Properties:
* '''variable_name''': a [[Types/string]]

Reference to a pre-defined variable, constant, or a [[Prototype/NamedNoiseExpression|named noise expression]]. Variables referencing named noise expressions may have their reference overridden by other named noise expression if their intended_property is the variable name and it is selected by the user in the map generator GUI. See [[Prototype/NamedNoiseExpression#Custom intended_property]].

Predefined variables:
* x - number - Current x position on the map
* y - number - Current y position on the map

Predefined constants (note that map gen settings can also be provided by a [[Types/MapGenPreset]]):
* map_seed - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* map_width - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* map_height - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* water_level - number - Don't use; use wlc_elevation_minimum instead
* finite_water_level - number - Don't use; use wlc_elevation_offset instead
* wlc_elevation_offset - number - When the result of 10 × log2("water") with "water" from [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings] is finite, <code>wlc_elevation_offset = -(10 * log2(water))</code>, else <code>wlc_elevation_offset = 0</code>
* wlc_elevation_minimum - number - When the result of 10 × log2("water") with "water" from [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings] is infinite, <code>wlc_elevation_minimum = -∞</code>, else <code>wlc_elevation_minimum = 4</code>
* cliff_elevation_offset - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings] ([https://lua-api.factorio.com/latest/Concepts.html#CliffPlacementSettings CliffPlacementSettings])
* cliff_elevation_interval - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings] ([https://lua-api.factorio.com/latest/Concepts.html#CliffPlacementSettings CliffPlacementSettings])
* control-setting:cliffs:richness:multiplier - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings] ([https://lua-api.factorio.com/latest/Concepts.html#CliffPlacementSettings CliffPlacementSettings])
* terrace_elevation_offset - number - Calculated from the cliff and water settings.
* terrace_elevation_interval - number - Same as "cliff_elevation_interval"
* starting_area_radius - number - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* starting_positions - map position list - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* starting_lake_positions - map position list - Calculated from starting positions and map seed
* peaceful_mode - boolean - Taken from the [http://lua-api.factorio.com/latest/Concepts.html#MapGenSettings MapGenSettings]
* control-setting:<prototype name>:frequency - number - Provided for all of the [[Prototype/Tile|tile]], [[Prototype/Entity|entity]], [[Prototype/Decorative|decorative]], [[Prototype/AutoplaceControl|autoplace-control]] prototypes.
* control-setting:<prototype name>:size - number - Provided for all of the [[Prototype/Tile|tile]], [[Prototype/Entity|entity]], [[Prototype/Decorative|decorative]], [[Prototype/AutoplaceControl|autoplace-control]] prototypes.
* control-setting:<prototype name>:richness - number - Provided for all of the [[Prototype/Tile|tile]], [[Prototype/Entity|entity]], [[Prototype/Decorative|decorative]], [[Prototype/AutoplaceControl|autoplace-control]] prototypes.

A list of all named noise expression defined in the base game can be found at [[Data.raw#noise-expression]]. Notable expressions defined by the base game are:
* distance - number - <code>noise.distance_from(noise.var("x"), noise.var("y"), noise.var("starting_positions"))</code>, so the distance from the closest starting position. distance is never < 0.
* tier_from_start - number - <code>noise.max(0.0, noise.var("distance") - noise.var("starting_area_radius")) / noise.var("starting_area_radius)</code>
* tier - number - <code>noise.var("tier_from_start")</code>, so same as tier_from_start.
* starting_area_weight - number - <code>1 - noise.min(1.0, noise.var("tier_from_start") / 2.0)</code>
* moisture - number - A value between 0 and 1 that determines whether a tile becomes sandy (low moisture) or grassy (high moisture).
* aux - number - A value between 0 and 1 that determines whether low-moisture tiles become sand or red desert.
* temperature - number - Provides a value (vaguely representing degrees Celsius, varying between -20 and 50) that is used (together with moisture and aux) as part of tree and decorative placement.
* elevation - number - Tiles values less than zero become water. Cliffs are placed along certain contours according to CliffPlacementSettings.
* cliffiness - number - Determines whether (when >0.5) or not (when <0.5) a cliff will be placed at an otherwise suitable (according to CliffPlacementSettings) location.
* enemy-base-intensity - number - Is referenced by both enemy-base-frequency and enemy-base-radius. i.e. if this is overridden, enemy base frequency and size will both be affected and do something reasonable. By default, this expression returns a value proportional to distance from any starting point, clamped at about 7.
* enemy-base-frequency - number - Represents average number of enemy bases per tile for a region, by default in terms of enemy-base-intensity.
* enemy-base-radius - number - Represents the radius of an enemy base, if one were to be placed on the given tile, by default proportional to a constant plus enemy-base-intensity.

Note that the named noise expressions are all defined in Lua, so mods may remove or change the notable expressions listed above or change how they are used in the map generation.

Examples:
<syntaxhighlight lang="lua">
local noise = require("noise")

local y =
{
type = "variable",
variable_name = "y" -- predefined variable
}
local x = noise.var("x") -- predefined variable, with the noise lib

local width =
{
type = "variable",
variable_name = "map_width" -- predefined constant
}
local height = noise.var("map_height") -- predefined constant, with the noise lib

local aux =
{
type = "variable",
variable_name = "aux" -- named noise expression
}
local cliffiness = noise.var("cliffiness") -- named noise expression, with the noise lib
</syntaxhighlight>

=== function-application ===

Apply a function to a list or associative array of arguments. Some functions expect arguments to be named and some expect them not to be.

Function calls are their own class of expression (as opposed to every function just being its own expression type) because function calls all have similar properties -- arguments are themselves expressions, a function call with all-constant arguments can be constant-folded (due to [[Wikipedia:Referential_transparency|referential transparency]]), etc.

Properties:

* '''function_name''' (a string; see [[#Functions]], below)
* '''arguments''' (a list or associative array of argument expressions)

=== literal-boolean ===

Evaluates to the same boolean value (true or false) every time, given by the '''literal_value''' property. May be used as a number value, evaluates to 1 for true and 0 for false.

=== literal-number ===

Evaluates to the same number every time, given by the '''literal_value''' property. All numbers are treated as [[Types/float]]s internally unless otherwise specified. May be used as a boolean value, evaluates to true for numbers > 0, anything else evaluates to false.

Example:
<syntaxhighlight lang="lua">
local ten =
{
type = "literal-number",
literal_value = 10
}

-- or with the noise lib, see the "Basics" section above
local noise = require("noise")
local twenty_point_five = noise.to_noise_expression(20.5)
</syntaxhighlight>

=== literal-string ===

Evaluates to the same string every time, given by the '''literal_value''' property.

Since the noise generation runtime has no notion of strings or use for them,
this is useful only in constant contexts.

=== literal-object ===

Evaluates to the same object every time, given by the '''literal_value''' property.

e.g.

<syntaxhighlight lang="lua">
{
type = "literal-object",
literal_value = {
name = "Bob Hope",
birth_date = {
year = 1903,
month = 5,
day_of_month = 29
}
}
}
</syntaxhighlight>

Since the noise generation runtime has no notion of objects or use for them,
this is useful only in constant contexts, such as the argument
of the '''autoplace-probability''' function (where the 'literal object' is an [[Types/AutoplaceSpecification|AutoplaceSpecitication]])

=== literal-expression ===

Returns the expression represented by its '''literal-value''' property.

Useful mostly for passing expressions (to be evaluated later) to the [[#spot-noise|'''spot-noise''']] function.

=== array-construction ===

'''value_expressions''' property should be a list of expressions,
each of which will be evaluated to come up with the corresponding value
in the resulting array.

Used to construct map positions ({x, y}) and map position lists ({{x0,y0}, {y1,y1}, ...}) for [[#offset-points|offset-points]] and [[#distance-from-nearest-point|distance-from-nearest-point]].

Examples of constructing a map position and map position list:
<syntaxhighlight lang="lua">
local noise = require("noise")
local tne = noise.to_noise_expression

local map_pos_1 = -- the map position {x = 100, y = -200} specified directly
{
type = "array-construction",
value_expressions = {tne(100), tne(-200)}
}
-- or with make_array from the noise lib required above
local map_pos_2 = noise.make_array({100, 200})

local map_pos_list = -- a map position list: {{x = 100, y = -200}, {x = 100, y = 200}}
{
type = "array-construction",
value_expressions = {map_pos_1, map_pos_2}
}
-- or with the noise lib
local also_map_post_list = noise.make_point_list({{100, -200}, {100, 200}})

</syntaxhighlight>

=== procedure-delimiter ===

Evaluates and returns the value of its '''expression''' property, which is itself an expression.

This hints to the compiler that it should break the subexpression into its own procedure
so that the result can be re-used in multiple places.
For instance if you want to re-use the same multioctave noise for determining probability
of multiple tiles/entities, wrap the multioctave noise expression in a procedure-delimiter.
Alternatively, make the noise its own [[Prototype/NamedNoiseExpression|NamedNoiseExpression]] and reference it by name, using a variable.

=== if-else-chain ===

Has an '''arguments''' property that is a list of condition-result expression pairs followed by a default result expression, like so:

<syntaxhighlight lang="lua">
{
type = "if-else-chain",
arguments = {
condition1, result1,
condition2, result2,
...
defaultResult
}
}
</syntaxhighlight >

The result of the if-else-chain is the value of the first result expression whose condition expression evaluated to true,
or the value of the default result ('else') expression.

== Functions ==

=== add ===

'''Arguments (positional)''': between 0 and 32 numbers

Takes the positional arguments and adds them.

=== subtract ===
'''Arguments (positional)''':
* '''minuend''' - number
* '''subtrahend''' - number

Takes 2 positional arguments and subtracts the second from the first.

=== multiply ===
'''Arguments (positional)''': between 0 and 32 numbers

Takes the positional arguments and multiplies them.

=== divide ===
'''Arguments (positional)''':
* '''dividend''' - number
* '''divisor''' - number

Takes 2 positional arguments and divides the first by the second.

=== exponentiate ===
'''Arguments (positional)''':
* '''base''' - number
* '''exponent''' - number

Takes 2 positional arguments, and raises the first to the second power.

=== absolute-value ===
'''Arguments (positional)''': value to be absoluted

Takes a single positional argument and returns its absolute value. i.e. If the argument is negative, it is inverted.

=== clamp ===
'''Arguments (positional)''':
* '''value''' - number to be clamped
* '''floor''' - lower limit
* '''ceiling''' - upper limit

First argument is clamped between the second and third. The second is treated as a lower limit and the third the upper limit.

=== compile-time-log ===
'''Arguments''': Between 1 and 32 values of any type

Prints all of its arguments to the [[log file]] when the expression is compiled. For that it needs to part of another expression that is compiled. The last argument of the compile-time-log is returned as the "result" of the compile-time-log.

Example of usage inside a [[Prototype/NamedNoiseExpression|NamedNoiseExpression]]:
<syntaxhighlight lang="lua">
local noise = require("noise")
local tne = noise.to_noise_expression

-- see the named noise expression docs linked above the code for how this works
data:extend{{
type = "noise-expression",
name = "compile-log-test",
intended_property = "elevation",
expression = noise.compile_time_log(2000, noise.var("y"), tne(100) - noise.var("distance"))
}}

-- When "compile-log-test" is selected as the map type and a map preview or map is generated, this logs:
-- Info data-updates.lua:24: 2000.000000 reference to variable 'y' subtract
-- Furthermore, the elevation noise expression is set to 'tne(100) - noise.var("distance")', producing a circular island with a 100 tile radius
</syntaxhighlight>

=== distance-from-nearest-point ===
'''Arguments (named)''':
* '''x''' - number
* '''y''' - number
* '''points''' - list of map positions
* '''maximum_distance''' (constant, default: max double) - number

Computes the [[Wikipedia:Euclidean_distance|euclidean distance]] of the position {x, y} to all position listed in '''points''' and returns the shortest distance. The returned distance can be '''maximum_distance''' at most.

See [[#array-construction|array-construction]] for how to specify a map position list.

Example:
<syntaxhighlight lang="lua">
-- Shortest distance at the current {x, y} from the two given points, but at most 1000

local noise = require("noise")
local tne = noise.to_noise_expression
local positions = noise.make_point_list({{-100, -40}, {-50, -200}})

local shortest_distance =
{
type = "function-application",
function_name = "distance-from-nearest-point",
arguments = {x = noise.var("x"), y = noise.var("y"), points = positions, maximum_distance = tne(1000)}
}
-- or with the noise lib
local also_shortest_distance = noise.function_application("distance-from-nearest-point", {x = noise.var("x"), y = noise.var("y"), points = positions, maximum_distance = 1000})
</syntaxhighlight>

=== ridge ===
'''Arguments (positional)''':
* '''value''' - number to be ridged
* '''floor''' - lower limit
* '''ceiling''' - upper limit

Similar to clamp but the input value is folded back across the upper and lower limits
until it lies between them.

Example:
<syntaxhighlight lang="lua">
local noise = require("noise")

local ridge_1 = noise.ridge(6, 1, 5) -- this returns 4

local ridge_2 = noise.ridge(-1, 1, 5) -- this returns 3
</syntaxhighlight>

=== terrace ===
'''Arguments (positional)''':
* '''value''' - number
* '''offset''' (constant) - number
* '''width''' (constant) - number
* '''strength''' - number

=== modulo ===
'''Arguments (positional)''':
* '''dividend''' - number
* '''divisor''' - number

Takes 2 positional arguments and divides the first by the second and returns the remainder. This is implemented using [https://en.cppreference.com/w/cpp/numeric/math/fmod fmod(double, double)].

=== floor ===
'''Arguments (positional)''':
* '''value''' - number

Takes one 1 numeric value and returns its floor.

=== ceil ===
'''Arguments (positional)''':
* '''value''' - number

Takes one 1 numeric value and returns its ceiling.

=== bitwise-and ===
'''Arguments (positional)''': between 0 and 32 numbers

Casts the positional arguments to signed 32-bit integers and performs bitwise AND on them.

=== bitwise-or ===
'''Arguments (positional)''': between 0 and 32 numbers

Casts the positional arguments to signed 32-bit integers and performs bitwise OR on them.

=== bitwise-xor ===
'''Arguments (positional)''': between 0 and 32 numbers

Casts the positional arguments to signed 32-bit integers and performs bitwise EXCLUSIVE OR on them.

=== bitwise-not ===
'''Arguments (positional)''':
* '''value''' - number to be negated

Casts the positional argument to a signed 32-bit integer and bitwise negates it.

=== sin ===
'''Arguments (positional)''':
* '''value''' - number

Takes one 1 value and returns its sine.

=== cos ===
'''Arguments (positional)''':
* '''value''' - number

Takes one 1 value and returns its cosine.

=== atan2 ===
'''Arguments (positional)''':
* '''y''' - number
* '''x''' - number

Returns the arc tangent of y/x using the signs of arguments to determine the correct quadrant.

=== less-than ===
'''Arguments (positional)''':
* '''lhs''' - number
* '''rhs''' - number

Returns the result of lhs < rhs as literal number that is 0 for false and 1 for true.

=== less-or-equal ===
'''Arguments (positional)''':
* '''lhs''' - number
* '''rhs''' - number

Returns the result of lhs <= rhs as literal number that is 0 for false and 1 for true.

=== equals ===
'''Arguments (positional)''':
* '''lhs''' - number
* '''rhs''' - number

Returns the result of lhs == rhs as literal number that is 0 for false and 1 for true.

=== factorio-basis-noise ===

'''Arguments (named)''':

* '''x'''
* '''y'''
* '''seed0''' (constant) - integer between 0 and 4294967295 (inclusive) used to populate the backing random noise
* '''seed1''' (constant) - integer between 0 and 255 (inclusive) used to provide extra randomness when sampling
* '''input_scale''' (constant, default: 1) - x and y will be multiplied by this before sampling
* '''output_scale''' (constant, default: 1) - output will be multiplied by this before being returned

Scaling input and output can be accomplished other ways, but are done so commonly
as to be built into this function for performance reasons.

=== factorio-quick-multioctave-noise ===

'''Arguments (named)''':

* '''x''' - number
* '''y''' - number
* '''seed0''' (constant) - number
* '''seed1''' (constant) - number
* '''input_scale''' (constant, default: 1) - number
* '''output_scale''' (constant, default: 1) - number
* '''octaves''' (constant) - number
* '''octave_input_scale_multiplier''' (constant, default: 0.5) - number
* '''octave_output_scale_multiplier''' (constant, default: 2) - number
* '''octave_seed0_shift''' (constant, default: 1) - number

=== random-penalty ===

'''Arguments (named)''':

* '''x''' - number used to seed the random generator
* '''y''' - number used to seed the random generator
* '''source''' - number that the penalty is applied to
* '''seed''' (constant, default: 1) - integer used to seed the random generator
* '''amplitude''' (constant, default: 1) - number

Subtracts a random value in the [0, amplitude) range from source if source is larger than 0.

=== log2 ===

'''Argument (positional)''': value (number)

=== noise-layer-name-to-id ===

'''Argument (positional)''': value (string)

=== autoplace-probability ===

'''Argument (positional)''': value (object)

=== autoplace-richness ===

'''Argument (positional)''': value (object)

=== offset-points ===

'''Arguments (positional)''':
* '''offset''' - map position - Vector of how the positions should be shifted
* '''positions''' - list of map positions - The positions that should be shifted

See [[#array-construction|array-construction]] for how to specify map positions.

Example:
<syntaxhighlight lang="lua">
-- Shifts "positions" by {100, 90}

local noise = require("noise")
local positions = noise.make_point_list({{-10, -40}, {-50, -20}})
local offset = noise.make_array({100, 90})
local offset_positions =
{
type = "function-application",
function_name = "offset-points",
arguments = {offset, positions}
}
-- or with the noise lib
local also_offset_positions = noise.function_application("offset-points", {offset, positions})
</syntaxhighlight>

=== factorio-multioctave-noise ===

'''Arguments (named)''':

* '''x'''
* '''y'''
* '''persistence''' (constant) - how strong is each layer compared to the next larger one
* '''seed0''' (constant) - integer between 0 and 4294967295 (inclusive) used to populate the backing random noise
* '''seed1''' (constant) - integer between 0 and 255 (inclusive) used to provide extra randomness when sampling
* '''input_scale''' (constant, default: 1) - x and y will be multiplied by this before sampling
* '''output_scale''' (constant, default: 1) - output will be multiplied by this before being returned
* '''octaves''' (constant) - how many layers of noise at different scales to sum

=== spot-noise ===

Generates random conical spots. The map is divided into square regions, and within each region, candidate points are chosen at random and target density, spot quantity, and radius are calculated for each point (or one of every '''skip_span''' candidate points) by configured expressions. Each spot contributes a quantity to a regional target total (which is the average of sampled target densities times the area of the region) until the total has been reached or a maximum spot count is hit. The output value of the function is the maximum height of any spot at a given point.

The parameters that provide expressions to be evaluated for each point (all named '''something_expression''') need to actually return expression objects.

The quantity of the spot is assumed to be the same as its volume. Since the volume of a cone is '''pi * radius^2 * height / 3''',
the height ('peak value') of any given spot is calculated as '''3 * quantity / (pi * radius^2)'''

'''Arguments (named)''':

* '''x''' (number)
* '''y''' (number)
* '''seed0''' (constant integer) - random seed, part 1 - usually the map seed is used
* '''seed1''' (constant integer) - random seed, part 2 - usually chosen to identify the noise layer
* '''region_size''' (constant integer, default: 512) - width/height of each region
* '''skip_offset''' (constant integer, default: 0) - offset of the first candidate point to use
* '''skip_span''' (constant integer, default: 1) - number of candidate points to skip over after each one used as a spot, including the used one
* '''candidate_point_count''' (constant integer, default:256) - how many candidate points to generate
* '''candidate_spot_count''' (constant integer, default depends on skip_span) - an alternative to candidate_point_count - number of spots to generate: '''candidate_spot_count = X''' is equivalent to '''candidate_point_count / skip_span = X'''
* '''suggested_minimum_candidate_point_spacing''' (constant number, default depends on region size and candidate_point_count) - minimum spacing to *try* to achieve while randomly picking points; spot noise may end up placing spots closer than this in crowded regions
* '''hard_region_target_quantity''' (constant boolean, default: true) - whether to place a hard limit on the total quantity in each region by reducing the size of any spot (which will be the last spot chosen) that would put it over the limit.
* '''density_expression''' (number-returningexpression) - an expression that will be evaluated for each candidate spot to calculate density at that point
* '''spot_quantity_expression''' (number-returningexpression) - an expression that will be evaluated for each candidate spot to calculate the spot's quantity
* '''spot_radius_expression''' (number-returning expression) - an expression that will be evaluated for each candidate spot to calculate the spot's radius (this, together with quantity, will determine the spots peak value)
* '''spot_favorability_expression''' (number-returning expression) - an expression that will be evaluated for each candidate spot to calculate the spot's favorability; spots with higher favorability will be considered first when building the final list of spots for a region
* '''basement_value''' (constant) - number
* '''maximum_spot_basement_radius''' (constant) - number
* '''comment''' (constant) - comment string

The infinite series of candidate points (of which '''candidate_point_count''' are actually considered) generated by '''spot-noise''' expressions with the same '''seed0''', '''seed1''', '''region_size''', and '''suggested_minimum_candidate_point_spacing''' will be identical. This allows multiple spot-noise expressions (e.g. for different ore patches) to avoid overlap by using different points from the same list, determined by '''skip_span''' and '''skip_offset'''.

== Example definition ==

To override the 'temperature' named noise expression with one that linearly increases to the southeast:

<syntaxhighlight lang="lua">
local noise = require("noise");

data:extend{
{
type = "noise-expression",
name = "new-temperature-function",
intended_property = "temperature", -- Makes this available in the 'temperature generator' drop-down
expression = noise.define_noise_function( function(x,y,tile,map)
return (x + y) / 1000
end)
}
}
</syntaxhighlight>

Which is equivalent to:

<syntaxhighlight lang="lua">
data:extend{
{
type = "noise-expression",
name = "new-temperature-function",
intended_property = "temperature",
expression = {
type = "function-application",
function_name = "divide",
arguments = {
{
type = "function-application",
function_name = "add",
arguments = {
{
type = "variable",
variable_name = "x"
},
{
type = "variable",
variable_name = "y"
}
}
},
{
type = "literal-number",
literal_value = 1000
}
}
}
}
}
</syntaxhighlight>

== See also ==

* [https://togos.github.io/togos-example-noise-programs/ A tutorial on authoring noise functions]

Prototype/Recipe

2023-02-05T03:02:06Z

Justarandomgeek: clarify subgroup

{{Prototype parent|PrototypeBase}}
A recipe. It can be a crafting recipe, a smelting recipe, or a custom type of recipe (see [[Prototype/RecipeCategory]]).

{{Prototype TOC|recipe}}

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

{{Prototype property|category|[[Types/string|string]]|"crafting"|optional=true}}
Optional. The category of this recipe. The built-in categories can be found [[Data.raw#recipe-category|here]]. See also [[Prototype/RecipeCategory]].

The recipe category "crafting" cannot contain recipes with fluid ingredients or products.

{{Prototype property|subgroup|[[Types/string|string]]||optional=true}}
Name of a [[Prototype/ItemSubGroup]]

Optional. The subgroup of this recipe. If not specified, defaults to the subgroup of the product if there is only 1, or main_product if multiple products exist. If multiple products exist and no main_product is specified, the subgroup is required.

{{Prototype property|icons, icon, icon_size (IconSpecification)|[[Types/IconSpecification|IconSpecification]]|optional=true}}
An icon is mandatory for recipe with more than 1 product and no main_product. Otherwise defaults to the icon of main_product/1 product.

If given, it overwrites the icon of the main_product/1 product.

{{Prototype property|crafting_machine_tint|[[Types/table|table]] of [[Types/Color|Color]]|optional=true}}
Optional. Used by crafting machine <code>[[Prototype/CraftingMachine#working_visualisations|working_visualisations]]</code> to tint certain layers with the recipe color. [[Types/WorkingVisualisation#apply_recipe_tint|apply_recipe_tint]] on the working visualisation determines which of the 4 colors is used for that layer (if any).

Format:
<syntaxhighlight lang="lua">crafting_machine_tint = { primary = {r=0,g=0,b=0,a=0}, secondary = {r=0,g=0,b=0,a=0}, tertiary = {r=0,g=0,b=0,a=0}, quaternary = {r=0,g=0,b=0,a=0}}</syntaxhighlight>

Each key/value pair is optional and defaults to the above value.

== Recipe data ==
{{#subobject:normal
|Prototype property name=normal
|Prototype property type=[[Prototype/Recipe#Recipe_data|Recipe data]] or [[Types/bool|bool]]
|Prototype property optional=true
|Prototype property pagename={{FULLPAGENAME}}
}}{{#subobject:expensive
|Prototype property name=expensive
|Prototype property type=[[Prototype/Recipe#Recipe_data|Recipe data]] or [[Types/bool|bool]]
|Prototype property optional=true
|Prototype property pagename={{FULLPAGENAME}}
}}
If the recipe does not have a difficulty, this is located directly in the prototype. Otherwise, if the "'''normal'''" or "'''expensive'''" property exists, the recipe has difficulty. Then, the recipe data has to be specified for each difficulty instead of directly in the prototype. If at least one difficulty has recipe data defined, the other difficulty can be set to <code>false</code>. This will disable the recipe for the difficulty, same as setting it <code>enabled = false</code>. If it is enabled (by technologies etc), it will use the data from the other difficulty. Not setting a difficulty, e.g. <code>normal = nil</code>, is possible and gives that difficulty the exact same properties as the difficulty that is defined. Setting one or both difficulties to <code>true</code> is not valid and will produce an error. See below for examples of difficulty.

{{Prototype property|ingredients|[[Types/table|table]] of [[Types/IngredientPrototype|IngredientPrototype]]}}
A table containing ingredient names and counts. Can also contain information about fluid temperature and catalyst amounts. The catalyst amounts are automatically calculated from the recipe, or can be set manually in the [[Types/IngredientPrototype|IngredientPrototype]].[https://factorio.com/blog/post/fff-256] 
Maximum ingredient amount is 65535. 
<code>ingredients</code> can be set to an empty table to create a recipe that needs no ingredients. 
Duplicate ingredients, e.g. two entries for the "wood" item, are ''not'' allowed. 
In-game, the item ingredients are ordered by [[Prototype/ItemGroup#order_in_recipe|item group order_in_recipe]].
<syntaxhighlight lang="lua">
ingredients = {{"iron-stick", 2}, {"iron-plate", 3}}
</syntaxhighlight>
The same with full format:
<syntaxhighlight lang="lua">
ingredients = {{type = "item", name = "iron-stick", amount = 2}, {type = "item", name = "iron-plate", amount = 3}}
</syntaxhighlight>
For fluids, the full format always has to be used:
<syntaxhighlight lang="lua">
ingredients = {{type="fluid", name="water", amount=50}, {type="fluid", name="crude-oil", amount=100}}
</syntaxhighlight>

{{Prototype property|result|[[Types/string|string]]|optional=true}}
Can be replaced with the results parameter. The item created by this recipe. Must be the name of an item, such as "iron-gear-wheel".
Note that <code>results</code> takes priority over <code>result</code>. So if a recipe has both keys set, <code>result</code> will be ignored. 

{{Prototype property|result_count|[[Types/uint32|uint32]]|1|optional=true}}
Optional. The number of items created by this recipe.

{{Prototype property|results|[[Types/table|table]] of [[Types/ProductPrototype|ProductPrototype]]|optional=true}}
A table containing result names and counts. Can also contain information about fluid temperature and catalyst amounts. The catalyst amounts are automatically calculated from the recipe, or can be set manually in the [[Types/ProductPrototype|ProductPrototype]].[https://factorio.com/blog/post/fff-256] 
<code>results</code> can be set to an empty table to create a recipe that produces nothing. 
Duplicate results, e.g. two entries for the "iron-plate" item, are allowed.

<syntaxhighlight lang="lua">
results=
{
{type="fluid", name="heavy-oil", amount=3},
{type="fluid", name="light-oil", amount=3},
{type="fluid", name="petroleum-gas", amount=4}
},
</syntaxhighlight>
<syntaxhighlight lang="lua">
results =
{
{type = "item", name = "iron-nuggets", amount = 9},
{type = "item", name = "gold-nuggets", amount = 1}
},
</syntaxhighlight>
<syntaxhighlight lang="lua">
results =
{
{type = "fluid", name = "steam", amount = 1, temperature = 165}
},
</syntaxhighlight>

{{Prototype property|energy_required|[[Types/double|double]]|0.5|optional=true}}
Optional. The amount of time it takes to make this recipe. Must be greater than 0.001.

This is the number of seconds it takes to craft at crafting speed 1.

{{Prototype property|emissions_multiplier|[[Types/double|double]]|1.0|optional=true}}

{{Prototype property|requester_paste_multiplier|[[Types/uint32|uint32]]|30|optional=true}}

{{Prototype property|overload_multiplier|[[Types/uint32|uint32]]|0|optional=true}}
Used to determine how many extra items are put into an assembling machine before it's considered "full enough". See [[Inserters#Insertion_limits]].

If set to 0, it instead uses the following formula: 1.166 / (energy_required / the assembler's crafting_speed), rounded up, and clamped between 2 and 100. The numbers used in this formula can be changed by the [[Prototype/UtilityConstants]] dynamic_recipe_overload_factor, minimum_recipe_overload_multiplier and maximum_recipe_overload_multiplier.

{{Prototype property|allow_inserter_overload|[[Types/bool|bool]]|true|optional=true}}
If the recipe is allowed to have the extra inserter overload bonus applied (4 * stack inserter stack size).

{{Prototype property|enabled|[[Types/bool|bool]]|true|optional=true}}
Optional. This can be false to disable the recipe at the start of the game, or "true" to leave it enabled.

If your recipe is unlocked by a technology, you should set this to "false".

{{Prototype property|hidden|[[Types/bool|bool]]|false|optional=true}}
Optional. Hides the recipe from crafting menus.

{{Prototype property|hide_from_stats|[[Types/bool|bool]]|false|optional=true}}
Optional. Hides the recipe from flow stats (item/fluid production statistics).

{{Prototype property|hide_from_player_crafting|[[Types/bool|bool]]|false|optional=true}}
Optional. Hides the recipe from the player's crafting screen. The recipe will still show up for selection in machines.

{{Prototype property|allow_decomposition|[[Types/bool|bool]]|true|optional=true}}
Optional. Whether this recipe is allowed to be broken down for the recipe tooltip "Total raw" calculations.

{{Prototype property|allow_as_intermediate|[[Types/bool|bool]]|true|optional=true}}
Optional. Whether the recipe can be used as an intermediate recipe in hand-crafting.

{{Prototype property|allow_intermediates|[[Types/bool|bool]]|true|optional=true}}
Optional. Whether the recipe is allowed to use intermediate recipes when hand-crafting.

{{Prototype property|always_show_made_in|[[Types/bool|bool]]|false|optional=true}}
Optional. Whether the "Made in: {Machine}" part of the tool-tip should always be present, not only when the recipe can not be hand-crafted.

{{Prototype property|show_amount_in_title|[[Types/bool|bool]]|true|optional=true}}
Optional. Whether the recipe name should have the product amount in front of it, e.g. "2 [[transport belt]]"

{{Prototype property|always_show_products|[[Types/bool|bool]]|false|optional=true}}
Optional. Whether the products are always shown in the recipe tool-tip.

{{Prototype property|unlock_results|[[Types/bool|bool]]|true|optional=true}}
Optional. Whether enabling this recipe unlocks its item products to show in selection lists (item filter, logistic request etc.).

{{Prototype property|main_product|[[Types/string|string]]|optional=true}}
Optional.

For recipes with more than one product: This defines of which result the icon, subgroup and name is used. If it is not set and the recipe has more than 1 result the recipe will use the recipe-name and recipe-description locale and its own subgroup and icon.

For recipes with 1 result: The recipe uses the icon, subgroup and name of the result by default. If this property is set to an empty string, the recipe will use the properties of the recipe instead of the result.

== Examples ==

=== "iron-plate" ===
<syntaxhighlight lang="lua">
{
type = "recipe",
name = "iron-plate",
category = "smelting",
energy_required = 3.5,
ingredients = {{"iron-ore", 1}},
result = "iron-plate"
}</syntaxhighlight>

=== "coal-liquefaction" ===

<syntaxhighlight lang="lua">{
type = "recipe",
name = "coal-liquefaction",
category = "oil-processing",
subgroup = "fluid-recipes",
order = "a[oil-processing]-c[coal-liquefaction]",
enabled = false,
energy_required = 5,
icon = "__base__/graphics/icons/fluid/coal-liquefaction.png",
icon_size = 32,
ingredients =
{
{type="item", name="coal", amount=10},
{type="fluid", name="heavy-oil", amount=25},
{type="fluid", name="steam", amount=50}
},
results=
{
{type="fluid", name="heavy-oil", amount=35},
{type="fluid", name="light-oil", amount=15},
{type="fluid", name="petroleum-gas", amount=20}
},
allow_decomposition = false
}</syntaxhighlight>

=== "iron-gear-wheel" — recipe with difficulty ===
<syntaxhighlight lang="lua"> {
type = "recipe",
name = "iron-gear-wheel",
normal =
{
ingredients = {{"iron-plate", 2}},
result = "iron-gear-wheel"
},
expensive =
{
ingredients = {{"iron-plate", 4}},
result = "iron-gear-wheel"
}
},</syntaxhighlight>

==== Modified so that it cannot be crafted in normal mode, unless unlocked via command/research ====
<syntaxhighlight lang="lua"> {
type = "recipe",
name = "iron-gear-wheel",
normal = false,
expensive =
{
ingredients = {{"iron-plate", 4}},
result = "iron-gear-wheel"
}
},</syntaxhighlight>

==== Modified so that the expensive recipe is always used, even in normal mode ====
<syntaxhighlight lang="lua"> {
type = "recipe",
name = "iron-gear-wheel",
normal = nil, --this line can be omitted
expensive =
{
ingredients = {{"iron-plate", 4}},
result = "iron-gear-wheel"
}
},</syntaxhighlight>

Mod images API

2022-09-21T16:48:11Z

Justarandomgeek: table formatting

<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 failed requests.
|-
| message || string || This attribute only appears on failed 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 successful uploads. SHA1 of the uploaded image.
|-
| url || bool || This attribute only appears on successful uploads. Url of the uploaded image.
|-
| thumbnail || bool || This attribute only appears on successful uploads. Url of thumbnail of the uploaded image.
|-
| error || string || This attribute only appears on failed uploads.
|-
| message || string || This attribute only appears on failed 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 successful uploads. It's set to true.
|-
| images || list || This attribute only appears on successful uploads. List of objects with id, url and thumbnail attribute same as finish_upload endpoint.
|-
| error || string || This attribute only appears on failed uploads.
|-
| message || string || This attribute only appears on failed 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]]

Mod details API

2022-09-21T14:17:41Z

Justarandomgeek: another one

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

The mod details API is used to change mod information like the description 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.

== Endpoint ==
=== edit_details ===

{| class="wikitable"
|-
| URL || https://mods.factorio.com/api/v2/mods/edit_details
|-
| 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, mandatory || Internal name of the mod whose details are to be changed
|-
| title || string, optional || Display name of the mod
|-
| summary || string, optional || Short description of the mod
|-
| description || string, optional || Long description of the mod in markdown format
|-
| category || enum, optional || Mod category, see [[#Category]]
|-
| license || enum, optional || Mod license, see [[#License]]
|-
| homepage || string, optional || URL of mod homepage
|-
| deprecated || bool, optional || Deprecated flag to hide mod from public listings
|-
| source_url || string, optional || URL of mod source code repository
|-
| faq || string, optional || FAQ for the mod in markdown format
|}

JSON object response
{| class="wikitable"
| success || bool || This attribute only appears for successful requests. It's set to true.
|-
| url || string || This attribute only appears for successful requests. URL path to get mod details endpoint
|-
| error || string || This attribute only appears on failed requests.
|-
| message || string || This attribute only appears on failed requests. 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.
|-
| UnknownMod || Mod does not exist in mod portal
|-
|}
== Enums ==
=== Category ===

{| class="wikitable"
! Value !! Name !! Description
|-
|<code><empty string></code>|| No category ||
|-
|<code>general</code>|| General || Mods that cannot be sorted into other categories
|-
|<code>non-game-changing</code>|| Non-Game-Changing || Changes only look&feel. New graphics, new sounds, etc.
|-
|<code>helper-mods</code>|| 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...
|-
|<code>transportation</code>|| Transportation || Player transport
|-
|<code>logistics</code>|| Logistics || Transport of materials
|-
|<code>utility</code>|| Utility || Helps with certain things the player is doing.
|-
|<code>balancing</code>|| Balancing ||
|-
|<code>weapons</code>|| Weapons ||
|-
|<code>enemies</code>|| Enemies ||
|-
|<code>armor</code>|| Armor || Armors or armor equipment related.
|-
|<code>oil</code>|| Oil || Things related to oil related manufacture
|-
|<code>logistic-network</code>|| Logistic network || Related to roboports and logistic robots
|-
|<code>circuit-network</code>|| Circuit network ||
|-
|<code>storage</code>|| Storage ||
|-
|<code>power-production</code>|| Power production ||
|-
|<code>manufacture</code>|| Manufacture || Furnaces, assembling machines, production chains
|-
|<code>blueprints</code>|| Blueprints ||
|-
|<code>cheats</code>|| Cheats ||
|-
|<code>defense</code>|| Defense ||
|-
|<code>mining</code>|| Mining ||
|-
|<code>environment</code>|| Environment ||
|-
|<code>info</code>|| Info || Mods that provide additional information to the player
|-
|<code>trains</code>|| Trains ||
|-
|<code>big-mods</code>|| Big mods || Too big and/or changes too much of the game to be fit anywhere else
|-
|<code>scenarios</code>|| Scenarios || Story mode campaigns on a premade map
|-
|<code>mod-packs</code>|| Mod packs || Collections of mods with tweaks to make them work together!
|-
|<code>libraries</code>|| Libraries || Mods used by other mods
|-
|}
=== License ===

{| class="wikitable"
! Value !! Name !! Description !! URL
|-
|<code>default_mit</code>|| MIT || A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty. || https://opensource.org/licenses/MIT
|-
|<code>default_gnugplv3</code>|| GNU GPLv3 || The GNU GPL is the most widely used free software license and has a strong copyleft requirement. When distributing derived works, the source code of the work must be made available under the same license. || https://opensource.org/licenses/gpl-3.0
|-
|<code>default_gnulgplv3</code>|| GNU LGPLv3 || Version 3 of the GNU LGPL is an additional set of permissions to the GNU GPLv3 license that requires that derived works be licensed under the same license, but works that only link to it do not fall under this restriction. || https://opensource.org/licenses/lgpl-3.0
|-
|<code>default_mozilla2</code>|| Mozilla Public License 2.0 || The Mozilla Public License (MPL 2.0) is maintained by the Mozilla foundation. This license attempts to be a compromise between the permissive BSD license and the reciprocal GPL license. || https://opensource.org/licenses/mpl-2.0
|-
|<code>default_apache2</code>|| Apache License 2.0 || A permissive license that also provides an express grant of patent rights from contributors to users. || https://opensource.org/licenses/apache-2.0
|-
|<code>default_unlicense</code>|| The Unlicense (Public Domain) || Because copyright is automatic in most countries, the Unlicense is a template to waive copyright interest in software you've written and dedicate it to the public domain. Use the Unlicense to opt out of copyright entirely. It also includes the no-warranty statement from the MIT/X11 license. || http://unlicense.org/
|-
|<code>custom_$ID</code>|| Custom || Custom license. The ID can be taken from the edit URL on the "My licenses" page on the mod portal. <code>mods.factorio.com/licenses/edit/$ID</code> || https://mods.factorio.com/licenses
|}
== Python Example ==

<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/edit_details"

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

request_body = data = {"mod": modname, "faq": "# hello world"}
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]]

Mod details API

2022-09-21T14:17:15Z

Justarandomgeek: typo strong -> string

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

The mod details API is used to change mod information like the description 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.

== Endpoint ==
=== edit_details ===

{| class="wikitable"
|-
| URL || https://mods.factorio.com/api/v2/mods/edit_details
|-
| 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, mandatory || Internal name of the mod whose details are to be changed
|-
| title || string, optional || Display name of the mod
|-
| summary || string, optional || Short description of the mod
|-
| description || string, optional || Long description of the mod in markdown format
|-
| category || enum, optional || Mod category, see [[#Category]]
|-
| license || enum, optional || Mod license, see [[#License]]
|-
| homepage || string, optional || URL of mod homepage
|-
| deprecated || bool, optional || Deprecated flag to hide mod from public listings
|-
| source_url || strong, optional || URL of mod source code repository
|-
| faq || string, optional || FAQ for the mod in markdown format
|}

JSON object response
{| class="wikitable"
| success || bool || This attribute only appears for successful requests. It's set to true.
|-
| url || string || This attribute only appears for successful requests. URL path to get mod details endpoint
|-
| error || string || This attribute only appears on failed requests.
|-
| message || string || This attribute only appears on failed requests. 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.
|-
| UnknownMod || Mod does not exist in mod portal
|-
|}
== Enums ==
=== Category ===

{| class="wikitable"
! Value !! Name !! Description
|-
|<code><empty string></code>|| No category ||
|-
|<code>general</code>|| General || Mods that cannot be sorted into other categories
|-
|<code>non-game-changing</code>|| Non-Game-Changing || Changes only look&feel. New graphics, new sounds, etc.
|-
|<code>helper-mods</code>|| 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...
|-
|<code>transportation</code>|| Transportation || Player transport
|-
|<code>logistics</code>|| Logistics || Transport of materials
|-
|<code>utility</code>|| Utility || Helps with certain things the player is doing.
|-
|<code>balancing</code>|| Balancing ||
|-
|<code>weapons</code>|| Weapons ||
|-
|<code>enemies</code>|| Enemies ||
|-
|<code>armor</code>|| Armor || Armors or armor equipment related.
|-
|<code>oil</code>|| Oil || Things related to oil related manufacture
|-
|<code>logistic-network</code>|| Logistic network || Related to roboports and logistic robots
|-
|<code>circuit-network</code>|| Circuit network ||
|-
|<code>storage</code>|| Storage ||
|-
|<code>power-production</code>|| Power production ||
|-
|<code>manufacture</code>|| Manufacture || Furnaces, assembling machines, production chains
|-
|<code>blueprints</code>|| Blueprints ||
|-
|<code>cheats</code>|| Cheats ||
|-
|<code>defense</code>|| Defense ||
|-
|<code>mining</code>|| Mining ||
|-
|<code>environment</code>|| Environment ||
|-
|<code>info</code>|| Info || Mods that provide additional information to the player
|-
|<code>trains</code>|| Trains ||
|-
|<code>big-mods</code>|| Big mods || Too big and/or changes too much of the game to be fit anywhere else
|-
|<code>scenarios</code>|| Scenarios || Story mode campaigns on a premade map
|-
|<code>mod-packs</code>|| Mod packs || Collections of mods with tweaks to make them work together!
|-
|<code>libraries</code>|| Libraries || Mods used by other mods
|-
|}
=== License ===

{| class="wikitable"
! Value !! Name !! Description !! URL
|-
|<code>default_mit</code>|| MIT || A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty. || https://opensource.org/licenses/MIT
|-
|<code>default_gnugplv3</code>|| GNU GPLv3 || The GNU GPL is the most widely used free software license and has a strong copyleft requirement. When distributing derived works, the source code of the work must be made available under the same license. || https://opensource.org/licenses/gpl-3.0
|-
|<code>default_gnulgplv3</code>|| GNU LGPLv3 || Version 3 of the GNU LGPL is an additional set of permissions to the GNU GPLv3 license that requires that derived works be licensed under the same license, but works that only link to it do not fall under this restriction. || https://opensource.org/licenses/lgpl-3.0
|-
|<code>default_mozilla2</code>|| Mozilla Public License 2.0 || The Mozilla Public License (MPL 2.0) is maintained by the Mozilla foundation. This license attempts to be a compromise between the permissive BSD license and the reciprocal GPL license. || https://opensource.org/licenses/mpl-2.0
|-
|<code>default_apache2</code>|| Apache License 2.0 || A permissive license that also provides an express grant of patent rights from contributors to users. || https://opensource.org/licenses/apache-2.0
|-
|<code>default_unlicense</code>|| The Unlicense (Public Domain) || Because copyright is automatic in most countries, the Unlicense is a template to waive copyright interest in software you've written and dedicate it to the public domain. Use the Unlicense to opt out of copyright entirely. It also includes the no-warranty statement from the MIT/X11 license. || http://unlicense.org/
|-
|<code>custom_$ID</code>|| Custom || Custom license. The ID can be taken from the edit URL on the "My licenses" page on the mod portal. <code>mods.factorio.com/licenses/edit/$ID</code> || https://mods.factorio.com/licenses
|}
== Python Example ==

<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/edit_details"

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

request_body = data = {"mod": modname, "faq": "# hello world"}
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]]

Types/Color

2020-08-29T14:52:30Z

Justarandomgeek:

Table of red, green, blue, and alpha float values between 0 and 1. All values are optional, default optional value for colors is 0, for alpha 1. Alternatively, values can be from 0-255, they are interpreted as such if at least one of value is > 1. 
Color allows the short-hand notation of passing an array of exactly 3 or 4 numbers. 
The game usually expects colors to be in pre-multiplied form (color channels are pre-multiplied by alpha).

{|class="wikitable"
! name !! meaning !! type
|-
| r || [optional, default 0] red value || [[Types/float|float]]
|-
| g || [optional, default 0] green value || [[Types/float|float]]
|-
| b || [optional, default 0] blue value || [[Types/float|float]]
|-
| a || [optional, default 1] alpha value - transparency || [[Types/float|float]]
|}

== Examples ==
color = {r=1, g=0, b=0, a=0.5} -- red
color = {r=1, a=0.5} -- the same red, omitting 0 colors
color = {1, 0, 0, 0.5} -- also the same red
color = {0, 0, 1} -- blue
color = {} -- black

Types/TileTransitions

2020-05-29T04:55:08Z

Justarandomgeek: /* Mandatory properties */ empty_transitions was listed inverted

== Basics ==
Used for tile graphics.

== Mandatory properties ==

=== side ===
'''Type''': [[Types/TileTransitionSprite]]

This or side_mask needs to be specified if <code>empty_transitions</code> is not true.

=== side_mask ===
'''Type''': [[Types/TileTransitionSprite]]

This or side needs to be specified if <code>empty_transitions</code> is not true.

=== inner_corner ===
'''Type''': [[Types/TileTransitionSprite]]

This or inner_corner_mask needs to be specified if <code>empty_transitions</code> is not true.

=== inner_corner_mask ===
'''Type''': [[Types/TileTransitionSprite]]

This or inner_corner needs to be specified if <code>empty_transitions</code> is not true.

=== outer_corner ===
'''Type''': [[Types/TileTransitionSprite]]

This or outer_corner_mask needs to be specified if <code>empty_transitions</code> is not true.

=== outer_corner_mask ===
'''Type''': [[Types/TileTransitionSprite]]

This or outer_corner needs to be specified if <code>empty_transitions</code> is not true.

== Optional properties ==

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

'''Default''': false

=== side_background ===
'''Type''': [[Types/TileTransitionSprite]]

=== side_background_mask ===
'''Type''': [[Types/TileTransitionSprite]]

=== side_effect_map ===
'''Type''': [[Types/TileTransitionSprite]]

=== side_weights ===
'''Type''': [[Types/table]] of [[Types/float]]

=== inner_corner_background ===
'''Type''': [[Types/TileTransitionSprite]]

=== inner_corner_background_mask ===
'''Type''': [[Types/TileTransitionSprite]]

=== inner_corner_effect_map ===
'''Type''': [[Types/TileTransitionSprite]]

=== inner_corner_weights ===
'''Type''': [[Types/table]] of [[Types/float]]

=== outer_corner_background ===
'''Type''': [[Types/TileTransitionSprite]]

=== outer_corner_background_mask ===
'''Type''': [[Types/TileTransitionSprite]]

=== outer_corner_effect_map ===
'''Type''': [[Types/TileTransitionSprite]]

=== outer_corner_weights ===
'''Type''': [[Types/table]] of [[Types/float]]

=== u_transition ===
'''Type''': [[Types/TileTransitionSprite]]

=== u_transition_mask ===
'''Type''': [[Types/TileTransitionSprite]]

=== u_transition_background ===
'''Type''': [[Types/TileTransitionSprite]]

=== u_transition_background_mask ===
'''Type''': [[Types/TileTransitionSprite]]

=== u_transition_effect_map ===
'''Type''': [[Types/TileTransitionSprite]]

=== u_transition_weights ===
'''Type''': [[Types/table]] of [[Types/float]]

=== o_transition ===
'''Type''': [[Types/TileSprite]]

=== o_transition_mask ===
'''Type''': [[Types/TileSprite]]

=== o_transition_background ===
'''Type''': [[Types/TileSprite]]

=== o_transition_background_mask ===
'''Type''': [[Types/TileSprite]]

=== o_transition_effect_map ===
'''Type''': [[Types/TileSprite]]

=== water_patch ===
'''Type''': [[Types/Sprite]]

=== effect_mask ===
'''Type''': [[Types/Animation]]

=== layer ===
'''Type''': [[Types/uint8]]

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

One of "zero", "water", "water-overlay", "ground" and "top".

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

One of "zero", "water", "water-overlay", "ground" and "top".

=== overlay_layer_offset ===
'''Type''': [[Types/int8]]

=== masked_overlay_layer_offset ===
'''Type''': [[Types/int8]]

'''Default''': 0

=== background_layer_offset ===
'''Type''': [[Types/int8]]

'''Default''': 0

=== masked_background_layer_offset ===
'''Type''': [[Types/int8]]

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

'''Default''': false

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

'''Default''': false

Version history/0.15.0

2020-05-29T02:31:50Z

Justarandomgeek: spelling

__NOTOC__

== 0.15.40 ==
Date: 29. 11. 2017
=== Locale ===
* Fixed Chinese translations.

== 0.15.39 ==
Date: 27. 11. 2017
=== Bugfixes ===
* Fixed corrupted Windows release. ([https://forums.factorio.com/54184 more])

== 0.15.38 ==
Date: 24. 11. 2017
=== Features ===
* Added Razer Chroma and Razer Chroma Link support (https://www.razerzone.com/chroma)

== 0.15.37 ==
Date: 17. 10. 2017
=== Bugfixes ===
* Fixed false positives in detection of crashes caused by incompatible version of RivaTuner Statistics Server.

== 0.15.36 ==
Date: 10. 10. 2017
=== Bugfixes ===
* Fixed a bug in the fix of electric network from 0.15.35.
* Fixed a crash when deleting chunks in specific cases. ([https://forums.factorio.com/52598 more])
* Fixed a crash when coupling/decoupling trains through the Lua API.
* Fixed crash when unknown program arguments were passed. ([https://forums.factorio.com/53219 more])

== 0.15.35 ==
Date: 28. 09. 2017
=== Bugfixes ===
* Fixed that after a player reconnected after a desync, while blueprints were uploaded, the game would crash. ([https://forums.factorio.com/52429 more])
* Fixed that in certain scenarios, the blueprint library wouldn't synchronise. ([https://forums.factorio.com/52634 more])
* Fixed that the server would sometimes quit if a player tried to connect after another player tried to connect unsuccessfully. ([https://forums.factorio.com/52718 more])
* Fixed a rare desync related to electric sub networks.
* Fixed archaic (from 0.12) migration that was supposed to fix rollingStockCounts on rails and it broke it instead.
* Fixed possible desync when rotating pipe to ground. ([https://forums.factorio.com/52709 more])
* Fixed a rare possibility of internal electric network crash when loading game. ([https://forums.factorio.com/52869 more])
* Handle network errors (caused by LavasoftTcpService64.dll corrupting Winsock) gracefully. ([https://forums.factorio.com/52290 more])
=== Scripting ===
* Fixed changing force of underground belt entity would cause desync. ([https://forums.factorio.com/52602 more])

== 0.15.34 ==
Date: 23. 08. 2017
=== Bugfixes ===
* Fixed that after a player reconnected after a desync, their blueprints would no longer upload. ([https://forums.factorio.com/51642 more])
* Fixed that it was possible to modify other players' blueprint libraries. ([https://forums.factorio.com/51908 more])
* Fixed a crash when loading a save that was transferring blueprints to a now offline player. ([https://forums.factorio.com/51884 more])
* Fixed that the blueprint library would remove duplicate blueprints even though they were in different books. ([https://forums.factorio.com/51552 more])
* Fixed game freezing when clicking the decrease replay speed button. ([https://forums.factorio.com/51870 more])
* Disabled possibility to open invalid save/replay by enter key or double click.
* Fixed rare crash when being disconnected from multiplayer. ([https://forums.factorio.com/52076 more])
* Fixed creating map from scenario would copy also system and hidden files from scenario folder. ([https://forums.factorio.com/52020 more])
* Fixed threading issue causing random server crashes. ([https://forums.factorio.com/51942 more])
* Fixed that if the server was launched with <code>--start-server-load-scenario</code>, the /save command with no name would cause the server to hang. ([https://forums.factorio.com/52055 more])
* Fixed <code>--start-server-load-scenario</code> would ignore <code>--map-gen-settings</code>, <code>--map-settings</code> and <code>--preset</code> options. ([https://forums.factorio.com/51424 more])
* Fixed disabling shaders would cause crashes. ([https://forums.factorio.com/52097 more])

== 0.15.33 ==
Date: 09. 08. 2017
=== Changes ===
* Mod name in mod info pane will no longer be localised. ([https://forums.factorio.com/51046 more])
* Optional mod dependencies now show as orange when invalid. ([https://forums.factorio.com/21008 more])
=== Bugfixes ===
* Fixed crash when trying to load replay that is not compatible with current version.
* Fixed ghosts might emit light. ([https://forums.factorio.com/51516 more])
* Fixed removing land mines didn't make any sound. ([https://forums.factorio.com/51588 more])
* Fixed creating window larger than screen. ([https://forums.factorio.com/51584 more])
* Improved performance of rendering uranium ore. ([https://forums.factorio.com/51549 more])
=== Modding ===
* Bonus UI now shows additional force modifiers ([https://forums.factorio.com/49732 more])
* simple-entity-with-owner (and simple-entity-with-force) now supports apply_runtime_tint in sprite definition.
=== Scripting ===
* simple-entity-with-owner exposes color property through <code>LuaEntity::color</code>. Set it to {r=0, g=0, b=0, a=0} to use color of entity's force.
* Fixed <code>LuaEntityPrototype::distribution_effectivity</code> would return value of supply_area_distance instead. ([https://forums.factorio.com/51568 more])

== 0.15.32 ==
Date: 02. 08. 2017
=== Bugfixes ===
* Fixed compatibility problem with several antivirus programs. ([https://forums.factorio.com/51375 more])
* Fixed seed in map-gen-settings.json would be ignored when creating map on headless server. ([https://forums.factorio.com/51254 more])
* Fixed that connecting to a multiplayer game with a large blueprint library might be difficult. ([https://forums.factorio.com/50898 more])
* Fixed that using capsules would open an Entity's GUI when clicked. ([https://forums.factorio.com/51123 more])
* Fixed that <code>--window-size</code>=maximized wouldn't work on Linux. ([https://forums.factorio.com/50977 more])
* Fixed that changing reactor consumption(production) values through a mod didn't update its production until rebuilt. ([https://forums.factorio.com/51251 more])
* Fixed that blueprints would sometimes stop transferring.
* Fixed crash when opening item/container and at the same time the controller is set to some that doesn't have inventory. ([https://forums.factorio.com/51349 more])
* Fixed 3 possible crashes related to getting malformed network packet over the network.
* Maybe fixed a biter path cache-related crash. ([https://forums.factorio.com/51183 more])
* Fixed that bad_alloc and similar low level errors were caught internally, so we couldn't get proper stack trace of those.
* Limited the size of a train chart tag when the map is zoomed in. ([https://forums.factorio.com/51401 more])
* Possible rare crash fix related to building rails and viewing preview of entities right after that. ([https://forums.factorio.com/51322 more])
* Limited technology cost multiplier to maximum of 1000. ([https://forums.factorio.com/51453 more])
=== Scripting ===
* The log method also specifies the mod that wrote that, not only script file.
* Added <code>LuaEntityPrototype::distribution_effectivity</code> read.
* Added <code>LuaEntityPrototype::time_to_live</code> read.
* Added <code>LuaControl::following_robots</code> read.
* Added <code>LuaPlayer::pipette_entity()</code>.
* Added <code>LuaEntity::can_be_destroyed()</code>.
* Added script_raised_destroy reserved event ID.
* Added script_raised_built reserved event ID.
* Added script_raised_revive reserved event ID.
* Changed <code>LuaEntity::time_to_live</code> to also work for combat robots.
* Changed <code>LuaEntityPrototype::fluid_capacity</code> read to also work on fluid-wagon.
* Changed <code>LuaEntityPrototype::turret_range</code> read returns nil instead of error if not turret.
* Changed <code>LuaEntity::train</code> to return nil if entity is not rolling stock.
* Added <code>LuaEntityPrototype::explosion_beam</code> read.
* Added <code>LuaEntityPrototype::explosion_rotate</code> read.

== 0.15.31 ==
Date: 25. 07. 2017
=== Minor Features ===
* Train stop text angle is now configurable in the graphics settings. Default value is 30 degrees.
=== Bugfixes ===
* Fixed that resizing the game window was very slow on Linux. ([https://forums.factorio.com/48023 more])
* Fixed rendering of turret ranges on map. ([https://forums.factorio.com/50932 more])
* Fixed "Disable listed mods" in minimal mode would disable all mods including Base if mod-list.json didn't exist. ([https://forums.factorio.com/50917 more])
* Fixed that pressing escape in the "mods error" GUI would close it and leave the game in a broken state. ([https://forums.factorio.com/50951 more])
* Fixed possible crash when loading game. ([https://forums.factorio.com/50955 more])
* Car and Tank now make a sound when deconstructed. ([https://forums.factorio.com/50997 more])
* Fixed that using the color command with no arguments would set your color to black.
* Fixed a crash when deleting a blueprint book while the label is being edited in the blueprint library. ([https://forums.factorio.com/50964 more])
* Fixed crash when closing the game in the Generate Map GUI. ([https://forums.factorio.com/50924 more])
* Fixed that the generate map GUI would show incorrect values for some of the enemy expansion settings in some cases. ([https://forums.factorio.com/51064 more])
* Fixed that some blueprints would always have to be reuploaded after connecting to a server, even if they weren't changed. ([https://forums.factorio.com/50878 more])
* Fixed that the map seed field wouldn't be used when given in a map-gen-settings.json file through the command line. ([https://forums.factorio.com/51176 more])
* Fixed that missing controls in "autoplace_controls" for map gen settings would get filled with default values instead of disabling unlisted controls.
* Fixed that blueprints would stop transferring if the game was loaded from a map that included some transfers in progress. ([https://forums.factorio.com/51025 more])
* Fixed missing font for Thai language.
* Changed the hazard concrete/concrete tile transition so it behaves predictively.
=== Modding ===
* Fixed layered icons would render incorrectly in some cases. ([https://forums.factorio.com/51059 more])
=== Scripting ===
* Fixed a crash when using <code>LuaPlayer::disable_all_prototypes()</code> and opening the technology GUI. ([https://forums.factorio.com/51003 more])
* Fixed that research bonus could be set to negative. ([https://forums.factorio.com/51114 more])
* Fixed that items in the character trash slots would get lost on reducing inventory size instead of spilling the items on the ground. ([https://forums.factorio.com/51181 more])
* Fixed validation for pickup_position and drop_position. ([https://forums.factorio.com/51143 more])
* Exposed internal buffer of fluid turret to Lua as its last fluidbox.
* Added <code>LuaEntityPrototype::fluid_capacity</code> read.

== 0.15.30 ==
Date: 14. 07. 2017
=== Bugfixes ===
* Fixed crash related to empty player blueprint shelf. ([https://forums.factorio.com/50854 more])
* Fixed crash related to handling focused state of widgets.
* Fixed possible crash when using font with size 0. ([https://forums.factorio.com/50859 more])
* Fixed focus error preventing to access GUI when the game is paused in multiplayer.
* Fixed a crash when the map can't be saved to disk due to permission errors when joining MP games. ([https://forums.factorio.com/45122 more])
=== Modding ===
* Added optional "hide_resistances" to entity prototype to control whether resistances should be hidden in description for friendly forces. Default is true.

== 0.15.29 ==
Date: 13. 07. 2017
=== Changes ===
* Underground pipes will no longer connect if there is candidate ghost underground pipe between them.
* Command line option <code>--window-size</code> can be also used to start the game in maximized mode when used as <code>--window-size</code>=maximized
* The library no longer shows unavailable blueprints of off-line players, since there is nothing that can be done with them.
=== Bugfixes ===
* Fixed that the edit field of a blueprint book in the shared pane would get reset every time crafting finished. ([https://forums.factorio.com/48771 more])
* Fixed that setting visibility to false on modded GUI elements while a text field had focus would keep blocking normal input. ([https://forums.factorio.com/50531 more])
* Fixed a performance problem when having the blueprint library GUI open while robots add/remove large amounts of items from the character. ([https://forums.factorio.com/49063 more])
* Fixed that walls and pipes built from blueprints could mark trees/rocks for deconstruction by mistake in some instances. ([https://forums.factorio.com/50739 more])
* Fixed entities with force color (turrets, gates, ...) would be drawn black in blueprint preview.
* Fixed false positive in game state corruption detection logic. ([https://forums.factorio.com/50758 more])
* Fixed pipette tool would pick diagonal rail with wrong direction. ([https://forums.factorio.com/50736 more])
* Fixed migrating save from level 4 of New Hope campaign would disable Plane recipe. ([https://forums.factorio.com/50762 more])
* Fixed that the blueprint library wouldn't close when Q is pressed and bound to the Close Window action. ([https://forums.factorio.com/50779 more])
* Fixed that blueprints would stop transferring if the game was saved whilst some transfers were in progress and then reloaded from this save. ([https://forums.factorio.com/50767 more])
* Fixed error with modal focus related to having blueprint error message and removed content message at the same time.
* Fixed server wouldn't close and delete a temporary save file made for a client that disconnected before the server finished saving. ([https://forums.factorio.com/50735 more])
* Fixed that standing on belts facing each other between two chunks would cause the player actions to run at double speed.
* Fixed that in an artificial test-case, two blueprints couldn't in the library at the same time. ([https://forums.factorio.com/50709 more])
* The Pipette tool will now copy the rotations of vehicles and trains. ([https://forums.factorio.com/50797 more])
* Fixed that making blueprints of ghost tiles on top of real tiles would have seemingly "random" results in the blueprint. ([https://forums.factorio.com/50801 more])
* Possible fix of the double "Communication with server failed" error. ([https://forums.factorio.com/35698 more])
* Fixed entities to be built wouldn't get rendered in some places when hovering over transparent GUI elements in the map editor. ([https://forums.factorio.com/50825 more])
=== Modding ===
* Added optional "render_not_in_network_icon" for logistic container prototypes defaulting to true.
* Fixed empty sprite path would cause game to crash instead of entering minimal mode. ([https://forums.factorio.com/50782 more])
=== Scripting ===
* Added <code>LuaItemStack::swap_stack()</code>.
* Added on_player_removed event.

== 0.15.28 ==
Date: 06. 07. 2017
=== Balancing ===
* Reduced time needed for an unit of Automation 2 research from 15 to 5 seconds to compensate for previous change of science packs requirements.
=== Minor Features ===
* Added <code>--window-size</code> launch option. For example <code>--window-size</code>=1680x1050 ([https://forums.factorio.com/44775 more])
* Damaging a tree with impact or physical damage generates some leaves.
* Warning icon for logistic chests that are not in a reach of roboport.
* Train stop names are rendered at 45 degrees to better show names.
=== Bugfixes ===
* Fixed that ghosts would stay over entities after deconstruction was canceled. ([https://forums.factorio.com/50015 more])
* Fixed that the controls menu wouldn't use a fixed common width between controls sections.
* Inserter researches now require equal ratios of science pack types.
* Fixed that transferring blueprints from the library could make the headless server crash. ([https://forums.factorio.com/50536 more])
* Fixed that blueprints could be duplicated when moving to a new version. ([https://forums.factorio.com/48977 more])
* Fixed progress bar not showing in the entity info panel if the text was too long. ([https://forums.factorio.com/50539 more])
* Fixed (at least one of the cases) of crashes related to not being able to connect to auth server while joining game. ([https://forums.factorio.com/50161 more])
* Fixed, possible crash related to changed bounding box of entity by a mod. When the mod is removed (added) the corner of the entity can occupy chunk that doesn't exist yet which would cause a loading error. ([https://forums.factorio.com/50371 more])
* Fixed that mining sounds and the leaves effect weren't present when mining tree from a car. ([https://forums.factorio.com/50441 more])
* Fixed possible crash when removing modded rails during save migration. ([https://forums.factorio.com/45436 more])
=== Modding ===
* Mod hotkeys are arranged per-mod.
* Disallowed defining different rail categories for this moment as having more than one will never work properly until we spent some non-trivial time with that, which is not a priority now.
=== Scripting ===
* Fixed that item-with-inventory filters wouldn't be preserved when cloned through the Lua API. ([https://forums.factorio.com/50527 more])

== 0.15.27 ==
Date: 03. 07. 2017
=== Balancing ===
* Speed and efficiency module 3 technology now requires high tech science packs instead of production science packs, so that working towards power armor mk2 does not require production science packs.
** This makes the branching between high tech and production science packs more meaningful.
* All researches now require equal ratios of science pack types. This reduces the cost of some researches.
=== Bugfixes ===
* Fixed manually inserting items into the blueprint book would disconnect you in multiplayer. ([https://forums.factorio.com/50408 more])
* Fixed a crash when clicking an alert the same tick the game is loaded. ([https://forums.factorio.com/50449 more])
* Fixed a crash when saving screenshot failed. ([https://forums.factorio.com/50501 more])
* Fixed that trains could stop in the middle of chain signal blocks in some specific setups causing deadlocks. ([https://forums.factorio.com/34844 more])
* Fixed that large drop-down widgets would render off the bottom of the screen in some cases. ([https://forums.factorio.com/50386 more])
=== Modding ===
* Added "render_layer" property to car prototype definition.
=== Scripting ===
* Fixed that calling <code>LuaForce::chart</code>(...) would try to chart chunks outside the map limits. ([https://forums.factorio.com/50451 more])
* Fixed that <code>LuaPlayer::unlock_achievement()</code> would keep showing the notification after the achievement was unlocked. ([https://forums.factorio.com/50395 more])
* Fixed that <code>LuaItemStack::create_blueprint</code> didn't behave the same way as normal blueprint creation in regards to ghost tiles. ([https://forums.factorio.com/50491 more])
* Fixed that <code>LuaEntity::selected_gun_index</code> write was 0-based. ([https://forums.factorio.com/50514 more])
* Fixed that mods could do remote calls outside of events when the game isn't in a valid state. ([https://forums.factorio.com/50509 more])
* Fixed that a time_before_removed of 0 on a corpse entity could crash the game in some instances. ([https://forums.factorio.com/50489 more])

== 0.15.26 ==
Date: 30. 06. 2017
=== Bugfixes ===
* Fixed a crash when rendering modded pumps in some instances. ([https://forums.factorio.com/50358 more])
* Fixed that biters building new bases could cause a player standing in the way to be destroyed instead of killed. ([https://forums.factorio.com/50357 more])
* Fixed that the auto-cursor-refill wouldn't refill if the cursor started with 1 item. ([https://forums.factorio.com/50370 more])
* Fixed crash related to removing power switch connected to electric pole in a blueprint.
* Fixed crash related to building electric pole that is connected to closed power switch by blueprint. ([https://forums.factorio.com/50384 more])
* Fixed that the player would respawn at {0,0} in the campaign levels. ([https://forums.factorio.com/50455 more])
=== Modding ===
* The God controller properties can now be set through the prototype system.
=== Scripting ===
* Fixed that using math.random in control.lua before the file was fully parsed was not deterministic. ([https://forums.factorio.com/50380 more])
* Fixed that create_entity{variation=...} was 0-based. ([https://forums.factorio.com/50385 more])

== 0.15.25 ==
Date: 29. 06. 2017
=== Bugfixes ===
* Fixed that energy shields would charge faster than normal when the generators couldn't provide full power and there was a battery with available energy in the grid. ([https://forums.factorio.com/47761 more])
* Fixed crash when making blueprint from power switch ghost.
* Fixed a desync when loading save files from different game versions. ([https://forums.factorio.com/50331 more])
* Fixed that the map gen presets list box wouldn't respond to mouse clicks. ([https://forums.factorio.com/50329 more])

== 0.15.24 ==
Date: 29. 06. 2017
=== Minor Features ===
* Power switch connections are stored in the blueprint.
=== Changes ===
* The F1-F12 debug hotkeys can now be reassigned.
* Disabled pumps don't block other pumps from connecting to fluid wagon anymore. ([https://forums.factorio.com/49336 more])
* Pump can connect to fluid tank that is slightly rotated, but only to tanks that are standing on straight rails.
* Blueprints in the library no longer transfer automatically when a player joins. Instead, they are transferred on-demand.
* Admins are allowed to modify other players' blueprints in the library, including deleting them.
* Changed default key binding for toggle filters on macOS to Command + Right Click ([https://forums.factorio.com/50253 more])
=== Bugfixes ===
* Fixed Info boxes sometimes going to the center of the screen on scale change or display size change. ([https://forums.factorio.com/47513 more])
* Fixed the direction of underground belts/pipes wouldn't get detected correctly when using the pipette tool in some cases. ([https://forums.factorio.com/50080 more])
* Fixed that accumulators had two energy bars and one of these was showing incorrect value. ([https://forums.factorio.com/50212 more])
* Fixed that Copy paste couldn't be used in the numeric edit box.
* Fixed that the recipe tooltip would resize/change every time something was crafted. ([https://forums.factorio.com/50209 more])
* Fixed burner inserter reading signal pulses twice ([https://forums.factorio.com/50183 more])
* Fixed electric buffer error that could happen when updating save to newer factorio version or changing mods. ([https://forums.factorio.com/50182 more])
* Fixed that failing to mine an entity wouldn't try to transfer all items in the entity. ([https://forums.factorio.com/50237 more])
* Fixed locomotive could snap to train stop after it was attached to an existing train. ([https://forums.factorio.com/50210 more])
* Fixed that the item counts when making blueprints or deconstructing things would render off-screen. ([https://forums.factorio.com/50258 more])
* Fixed impossible research tasks in team production challenge. ([https://forums.factorio.com/50257 more])
* Fixed that the blueprint library GUI wouldn't restore scrollbar position when moving in or out of a book. ([https://forums.factorio.com/50152 more])
* Fixed that setting inserter filters wouldn't update the last-user. ([https://forums.factorio.com/50286 more])
* Fixed that fluid would not flow through circuit network disabled mining drills. ([https://forums.factorio.com/50289 more])
* Fixed a crash when exiting multiplayer due to a script error while hosting a public game locally. ([https://forums.factorio.com/50243 more])
* Fixed pump would not connect to last tile of a train in some cases. ([https://forums.factorio.com/50279 more])
=== Modding ===
* Changed the format for localised mod name and description.
* Fixed that assembling machines using the heat energy source type would go inactive when out of power and stay inactive. ([https://forums.factorio.com/50091 more])
* Limited map gen presets pollution diffusion and dissipation rate values to prevent never-ending pollution bloating map sizes by mistake. ([https://forums.factorio.com/48680 more])
* Removed CustomInputPrototype consuming types "all" and "script-only".
* entity-with-owner now supports variation in blueprints.
=== Scripting ===
* Fixed that marking an entity for deconstruction through script wouldn't fire the event. ([https://forums.factorio.com/50180 more])
* Fixed that level based research wouldn't fire the research-finished event in some cases. ([https://forums.factorio.com/50223 more])
* Fixed that several of the drop-down related methods for LuaGuiElement were 0-based.
* Added a global Lua function "table_size" which will quickly compute the number of values in any lua table (not to be confused with the # operator).
* Added <code>LuaGuiElement::remove_item</code> for drop-down type elements.
* Added <code>LuaSurface::clear_pollution()</code>.
* Added events on_console_chat and on_console_command.
* Added <code>LuaEntityPrototype::production</code> read.
* Added <code>LuaControl::mine_tile()</code>.

== 0.15.23 ==
Date: 22. 06. 2017
=== Changes ===
* Reverted change that made Inserters no longer drop what they are holding when disabled by the circuit network. ([https://forums.factorio.com/49170 more])
=== Bugfixes ===
* Fixed that the UI scale option wouldn't apply until restarting the game in some cases. ([https://forums.factorio.com/50064 more])
* Fixed that number-input fields would also block letters/other keys. ([https://forums.factorio.com/50061 more])
* Fixed that tile filters in the deconstruction planner wouldn't get used in some cases when entity filters were also defined. ([https://forums.factorio.com/50069 more])
* Fixed curved rail ghosts wouldn't mark trees/rocks when force-built. ([https://forums.factorio.com/50039 more])
* Fixed construction robots could stop doing their jobs when roboport was destroyed or unpowered. ([https://forums.factorio.com/43680 more])
* Fixed long strings in the right description pane. ([https://forums.factorio.com/50040 more])
=== Modding ===
* Fixed that some mod mods would falsely be detected as removed and have GUI elements they added removed on load. ([https://forums.factorio.com/50055 more])
=== Scripting ===
* Fixed that teleporting entity ghosts didn't work correctly. ([https://forums.factorio.com/50030 more])

== 0.15.22 ==
Date: 21. 06. 2017
=== Changes ===
* Blueprints in the blueprint library are sorted using case-insensitive natural compare.
** E.g. the sorting order now is "1", "2", "10", instead of the previous "1", "10", "2".
* Inserters will no longer drop what they are holding when disabled by the circuit network. ([https://forums.factorio.com/49170 more])
* The deconstruction planner filter now treats any entity filter as also matching entity ghosts of that type.
* Multiplayer creation GUI now remembers game name. ([https://forums.factorio.com/49162 more])
=== Balancing ===
* Explosive Mine now only does damage to enemy units and structures.
** Sounds:
* Added missing vehicle collision sounds (pipes, solar panels, etc...)
* Reduced volume of ore mining and tree chopping.
=== Bugfixes ===
* Toggling fullscreen via options or Alt-Enter now keeps window on the same monitor. ([https://forums.factorio.com/49567 more])
* Fixed that in long recharging queues some robots would never get a chance to recharge. ([https://forums.factorio.com/49391 more])
* Fixed that it wasn't possible to click and drag blueprints into an empty blueprint book. ([https://forums.factorio.com/49746 more])
* Fixed that deconstruction/blueprinting selection would be canceled if the selection ended on one of the always-visible GUIs. ([https://forums.factorio.com/49264 more])
* Fixed the productivity bar in the furnace GUI wouldn't show in some instances. ([https://forums.factorio.com/49841 more])
* Fixed exiting a multiplayer game hosted through the in-game multiplayer option. ([https://forums.factorio.com/49785 more])
* Fixed that tile ghosts would always get selected over real entities. ([https://forums.factorio.com/49880 more])
* Fixed that the heat-connection icon was not visible on entities other than boiler and reactor. (related to modding)
* Fixed that furnace with heat source couldn't be rotated before placing it.
* Fixed the gui of furnace using heat as energy source.
* Fix PvP Gui script error. ([https://forums.factorio.com/49876 more])
* Fix that clearing items in Transport belt madness didn't give the items back. ([https://forums.factorio.com/49509 more])
* Fixed that rails marked for deconstruction wouldn't allow canceling deconstruction while a train was on them. ([https://forums.factorio.com/49950 more])
* Fixed that biters would change orientation rapidly when they were near a player whom they couldn't attack. ([https://forums.factorio.com/46763 more])
* Fixed that Rocket Silo would continue crafting for 1 tick after completing a rocket. ([https://forums.factorio.com/48974 more])
* Fixed that lot of other keys that can be used to write characters in the edit box (or console) were not blocked from affecting the game if they are assigned to do a game action. Having text box active now means that all of the keys are blocked from affecting the game.
* Fixed (hopefully), that the stretching of bounding boxes of walls to touch their neighbours was not taking into account when marking things in the way for the blueprint. ([https://forums.factorio.com/47324 more])
* Fixed that the description pane would change width depending on the content. It should now never change width. ([https://forums.factorio.com/49911 more])
* Fixed that the shooting-target would render as valid to shoot with rockets when it actually wasn't. ([https://forums.factorio.com/49425 more])
* Fixed that programmable speakers would get wrong instruments after importing pre-0.15.19 blueprint string. ([https://forums.factorio.com/49528 more])
* Fixed that maximized Factorio window had thin border around it. ([https://forums.factorio.com/49388 more])
* Fixed that vanilla and modded version of achievements could be mixed up. ([https://forums.factorio.com/49620 more])
* Fixed that inserters would try to insert items into other non-burner inserters. ([https://forums.factorio.com/49384 more])
* Fixed that fast-transferring modules into the rocket silo would put them into the module slots and the rocket at the same time. ([https://forums.factorio.com/49520 more])
* Fixed that the "rocket launched without satellite" message couldn't be dismissed in some cases. ([https://forums.factorio.com/43683 more])
* Fixed the mining drill GUI wouldn't show mining progress when it had a large number of modded module slots. ([https://forums.factorio.com/41597 more])
* Fixed fast-replacing an assembling machine with overloaded ingredients would spill the items. ([https://forums.factorio.com/49158 more])
* Fixed many ingredients or products in recipes would break the assembling machine GUI. ([https://forums.factorio.com/47407 more])
* Fixed wrong values when using /config set allowed-commands with invalid values would crash the game. ([https://forums.factorio.com/49839 more])
=== Modding ===
* Fixed that giving rolling stock entities invalid collision masks would crash the game. ([https://forums.factorio.com/49356 more])
* Mod title and description can now be localised.
* Fixed a crash when mods use reset technologies during the technology researched event. ([https://forums.factorio.com/49991 more])
* Fixed that modded GUI elements wouldn't get removed in some cases when the mod was removed. ([https://forums.factorio.com/50022 more])
* Fixed source_effects applying effects to the source by the target instead of to the source by the source. ([https://forums.factorio.com/49634 more])
=== Scripting ===
* Fixed setting robot.energy for logistic/construction robots wouldn't account for the robot battery upgrade. ([https://forums.factorio.com/49780 more])
* Fixed that setting <code>LuaBurner::currently_burning</code> didn't accept LuaItemPrototype as the docs said. ([https://forums.factorio.com/49893 more])
* Added <code>LuaEntityPrototype::count_as_rock_for_filtered_deconstruction</code> read.
* Added <code>LuaEntityPrototype::filter_count</code> read.
* Added <code>LuaEntity::spawner</code>/units read.

== 0.15.21 ==
Date: 15. 06. 2017
=== Bugfixes ===
* Fixed that the server would crash if someone tried to connect when there were no blueprints being transferred. ([https://forums.factorio.com/49770 more])

== 0.15.20 ==
Date: 14. 06. 2017
=== Changes ===
* Transports belt entities show belt speed in the tooltip and entity description.
* Reduced fluid wagon air resistance from 0.05 to 0.01
* Scenario names are now localised.
=== Bugfixes ===
* Fixed login details getting lost (hopefully). ([https://forums.factorio.com/45238 more])
* Fixed a crash that would happen if the game exited due to a script error that happened immediately after deleting a force. ([https://forums.factorio.com/49008 more])
* Fixed int mod settings would show incorrect values in the GUI. ([https://forums.factorio.com/49502 more])
* Fixed gun sounds would continue when switching weapons while firing. ([https://forums.factorio.com/49382 more])
* Fixed a performance issue caused by spawners being active all the time in peaceful mode. ([https://forums.factorio.com/48701 more])
* Fixed a crash when removing train stops next to other train stops and then building locomotives. ([https://forums.factorio.com/49539 more])
* Fixed a rare desync related to opening your player inventory. ([https://forums.factorio.com/49308 more])
* Fixed a crash when teleporting/setting the force of a offline roboport. ([https://forums.factorio.com/49515 more])
* Fixed inserters with custom pickup/drop locations from mods would retain the custom data when the mods were removed. ([https://forums.factorio.com/49513 more])
* Fixed a crash when deleting blueprint records from the blueprint library while another player is viewing the record tooltip. ([https://forums.factorio.com/49600 more])
* Fixed that some clients wouldn't be able to connect to a server when blueprints were being uploaded. ([https://forums.factorio.com/49680 more])
* Fixed that Factorio wouldn't start when run from an NFS partition. ([https://forums.factorio.com/49529 more])
* Fixed crash on macOS older than 10.9 ([https://forums.factorio.com/49555 more])
=== Modding ===
* Removed unused "energy consumption" from the roboport equipment. ([https://forums.factorio.com/49678 more])
=== Scripting ===
* Fixed that setting researched = true on level-based research in progress wouldn't update the research level displayed. ([https://forums.factorio.com/49468 more])
* Fixed that game.write_file would cause desyncs if it failed due to file permission issues. ([https://forums.factorio.com/49617 more])
* Fixed a crash related to the train changed state event. ([https://forums.factorio.com/49710 more])
* Added events on_player_setup_blueprint, on_player_deconstructed_area, and on_player_configured_blueprint.
* Added <code>LuaEntity::secondary_bounding_box</code> read.
* Added <code>LuaForce::worker_robots_battery_modifier</code> read/write.
* Added <code>LuaGuiElement::enabled</code> read/write.

== 0.15.19 ==
Date: 08. 06. 2017
=== Changes ===
* Added alarm sounds to programmable speaker.
* Fullscreen is on by default.
* Locomotive snaps to a train stop when placing the first locomotive next to the train stop.
* Changed automation and fluid wagon research so it doesn't have multiples of science packs per unit. ([https://forums.factorio.com/49128 more])
* <code>--start-server-load-scenario</code> can load scenarios provided by a mod.
** For example, <code>--start-server-load-scenario</code> base/wave-defense will load the wave-defense scenario from the base mod.
=== Graphics ===
* Changed the icon of the automation research, so it is not confused with the logistics research.
=== Bugfixes ===
* Fixed that destroyed transport belt could leave zombified items in nearby tile ([https://forums.factorio.com/49152 more])
* Fixed inserter zombification at rail junctions ([https://forums.factorio.com/49293 more])
* Fixed visual seams on map/minimap ([https://forums.factorio.com/45834 more])
* Fixed that gate over rail could be rotated
* Fixed GUI size problems with the logistic networks GUI. ([https://forums.factorio.com/48900 more])
* Fixed that the headless server didn't close when it failed. (Most typically because of script error) ([https://forums.factorio.com/49118 more])
* Fixed misaligned force color mask on capsule projectiles. ([https://forums.factorio.com/48996 more])
* Fixed crash when changing player's controller, when player was controlling a vehicle with god controller. ([https://forums.factorio.com/47239 more])
* Fixed a crash caused by manually deactivated units. ([https://forums.factorio.com/49017 more])
* Fixed that exporting blueprints wouldn't respect the current filter options in the setup GUI. ([https://forums.factorio.com/49123 more])
* Fixed that selection-by-typing in list boxes would also trigger normal game actions. ([https://forums.factorio.com/49004 more])
* Fixed that adding stops to a train could change the current station. ([https://forums.factorio.com/40845 more])
* Fixed that the search text didn't reset after leaving the browse-mods GUI. ([https://forums.factorio.com/49130 more])
* Fixed that the mods-load-error GUI could end up too large to fit on screen. ([https://forums.factorio.com/49165 more])
* Fixed a crash when interacting with the "save/quit/reconnect" window after losing connection with a server. ([https://forums.factorio.com/49023 more])
* Fixed crashes when locking bitmap fails. ([https://forums.factorio.com/49009 more])
* Fixed rail preview was rendered under entities. ([https://forums.factorio.com/48134 more])
* Fixed message box in main menu being not clickable ([https://forums.factorio.com/49226 more])
* Fixed trains stuttering on extremely short paths. ([https://forums.factorio.com/49105 more])
* Fixed flamethrower stream would destroy trees directly. ([https://forums.factorio.com/46428 more])
* Fixed that some information was missing from generator entities. ([https://forums.factorio.com/49327 more])
* Fixed that Factorio would hang on Linux after trying to paste a string when the clipboard was empty. ([https://forums.factorio.com/49251 more])
* Fixed generating unwinnable research tasks in team production scenario. ([https://forums.factorio.com/49329 more])
* Fixed that clicking escape while connecting to the game could lead to weird situations as the normal menu was opened.
** Pressing escape while connecting will abort the connection instead. ([https://forums.factorio.com/37460 more])
* Fixed the productivity bar in the mining drill wouldn't show in some cases. ([https://forums.factorio.com/40158 more])
* Fixed that the blueprint book gui didn't stretch vertically when possible. ([https://forums.factorio.com/49353 more])
* Fixed inconsistent hovered font color on buttons and dropdowns. ([https://forums.factorio.com/49213 more])
* Fixed train stuttering with only disabled stations in their schedule ([https://forums.factorio.com/47911 more])
* Fixed that you could disconnect wires at any distance. ([https://forums.factorio.com/46259 more])
* Fixed the icon used when rendering coal being held by construction robots. ([https://forums.factorio.com/49399 more])
* Fixed headless server on macOS getting stuck when in background ([https://forums.factorio.com/46295 more])
* Fixed that attempting to edit a blueprint label for the second time would show the original label before any edits were made. ([https://forums.factorio.com/49267 more])
* Fixed that <code>--start-server-load-scenario</code> wouldn't give an error when the specified scenario couldn't be found. ([https://forums.factorio.com/45532 more])
* Fixed that robots would leave items on the ground when building ghosts in some cases. ([https://forums.factorio.com/49449 more])
* Fixed train GUI size problems when the fuel tab is removed due to it going out of reach. ([https://forums.factorio.com/48991 more])
* Fixed that blacklisting tile ghosts in the deconstruction planner didn't work. ([https://forums.factorio.com/49450 more])
=== Modding ===
* Fixed that the fluid wagon wouldn't show the equipment grid when one was added through mods. ([https://forums.factorio.com/48167 more])
* Fixed loading the item-with-tags item type. ([https://forums.factorio.com/49234 more])
=== Scripting ===
* Fixed set_command with an empty list of commands would crash the game. ([https://forums.factorio.com/48226 more])
* Fixed LuaRandomGenerator docs. ([https://forums.factorio.com/48888 more])
* Added <code>LuaTechnology::level</code> write support for level-based technology. ([https://forums.factorio.com/47733 more])

== 0.15.18 ==
Date: 01. 06. 2017
=== Bugfixes ===
* Fixed that wire connections were not preserved in tightspot campaign. ([https://forums.factorio.com/48910 more])
* Fixed various crashes on macOS related to logistic counts. ([https://forums.factorio.com/49053 more])
=== Modding ===
* Changed default value of "allow_custom_vectors" in inserter prototype to true, vanilla inserters set it to false explicitly.

== 0.15.17 ==
Date: 01. 06. 2017
=== Graphics ===
* Inserters in high resolution; normal resolution inserters are unchanged.
=== Bugfixes ===
* Fixed some inconsistencies in programmable speaker gui ([https://forums.factorio.com/48593 more])
* Fixed that headless mode wiped out controls section of config file ([https://forums.factorio.com/47950 more])
* Fixed that detached roboports (e.g. after blackout) would not reset circuit network readings on number of robots ([https://forums.factorio.com/48915 more])
* Fixed that active blueprint/deconstruction-planner selection did not reset when switching between game and map ([https://forums.factorio.com/48815 more])
* Fixed AltGr behavior with special characters ([https://forums.factorio.com/47040 more])
* Fixed that mining bar would steal mouse focus ([https://forums.factorio.com/46999 more])
* Fixed the /evolution command would underflow when showing negative pollution values. ([https://forums.factorio.com/48786 more])
* Fixed crash when mod-list failed to save when exiting the game. ([https://forums.factorio.com/47371 more])
* Fixed game would not save at all if generating preview picture failed. ([https://forums.factorio.com/47342 more])
* Fixed desync related to driving vehicles. ([https://forums.factorio.com/48826 more])
* Fixed unnecessary quotes in programmable speaker note translations ([https://forums.factorio.com/48839 more])
* Fixed that the bonus GUI wouldn't fit on screen with a large amount of modded content. ([https://forums.factorio.com/48755 more])
* Fixed crash when closing public server. ([https://forums.factorio.com/48889 more])
* Fixed that filter inserters lost their filter in tightspot campaign. ([https://forums.factorio.com/48490 more])
* Fixed empty space would be rendered if glyph was missing in current font. ([https://forums.factorio.com/38937 more])
* Fixed that resizing the game window while catching up after joining a multiplayer game would leave the map blank. ([https://forums.factorio.com/48947 more])
* Fixed issue and desync when disconnecting one wire color of an entity connected to 2 wire colors. ([https://forums.factorio.com/48876 more])
* Fixed a multiplayer crash that would happen when a player left whilst uploading their blueprint library and then rejoined the same server. ([https://forums.factorio.com/47820 more])
* Fixed another issue that prevented spawners from spawning. ([https://forums.factorio.com/48931 more])
* Fixed game would fail to load if max-texture-size was too low. ([https://forums.factorio.com/48985 more])
=== Modding ===
* Moved the "mod-settings.json" file so it now resides in the "mods" subfolder allowing it to work with the mod-directory command line option.
* Added support for virtual-signal migrations.
* Inserters now require the inserter prototype property "allow_custom_vectors" to be true before they allow setting custom pickup/drop locations.
* Font paths were moved from locale cfg to locale info.json (see core/en/info.json).
* Changed default value of hand_length in inserter prototype to 0.75, to make inserter shadow look nicer.
=== Scripting ===
* Fixed crash when teleporting character entities while in vehicles. ([https://forums.factorio.com/45519 more])
* Fixed that character.character_maximum_following_robot_count_bonus didn't work. ([https://forums.factorio.com/48837 more])
* Fixed that /help for lua commands wouldn't do parameter substitution correctly. ([https://forums.factorio.com/47382 more])
* Added <code>LuaEntityPrototype::resource_categories</code>, fluid, and pumping_speed read.
* Added <code>LuaEntity::previous_recipe</code> read.
* Added <code>LuaEntityPrototype::stack</code>/allow_custom_vectors read.
* Changed <code>LuaEntityPrototype::speed</code> to also work for rolling stocks.

== 0.15.16 ==
Date: 27. 05. 2017
=== Changes ===
* Temporarily reverted GUI interaction changes (some GUI elements responding only to left mouse button, buttons clicked on mouse up instead of mouse down) introduced in 0.15.13 and 0.15.14.
=== Bugfixes ===
* Fixed the "back" button wouldn't work in the save-game GUI. ([https://forums.factorio.com/48657 more])
* Fixed the "cancel" button wouldn't work in the user-login GUI. ([https://forums.factorio.com/48677 more])
* Fixed that the map editor item/inventory buttons didn't work. ([https://forums.factorio.com/48685 more])
* Fixed beacons would "wobble" in blueprints. ([https://forums.factorio.com/48596 more])
* Fixed crashes related to clicking different buttons.
* As a one-time migration, enemy spawners will reset their absorbed pollution to zero when a save from a previous version of 0.15 is loaded. ([https://forums.factorio.com/48662 more])
** This is to avoid an extreme temporary spike in difficulty that would happen after loading a save with many spawners that were affected by a bug in the previous versions.
* Fixed the market GUI didn't work. ([https://forums.factorio.com/48664 more])
* Fixed crash when pollution reaches unreasonably far chunk. ([https://forums.factorio.com/48680 more])
* Fixed power bars glitch in electric network statistics dialog. ([https://forums.factorio.com/48630 more])
=== Scripting ===
* Fixed setting <code>LuaGuiElement::elem_value</code> would always expect the elem_type to be "item". ([https://forums.factorio.com/48610 more])

== 0.15.15 ==
Date: 26. 05. 2017
=== Bugfixes ===
* Fixed desync related to loading pre 0.15.14 save with beacons marked for deconstruction without resaving it first.
* Fixed that spawners would sometimes stop spawning units even when polluted. ([https://forums.factorio.com/46805 more])
* Fixed crash when changing assembling machine recipe. ([https://forums.factorio.com/48600 more])
* Fixed crash that would happen after clicking a button in the tech tree. ([https://forums.factorio.com/48609 more])
=== Scripting ===
* Fixed crash when creating smoke entity through create-entity trigger effect. ([https://forums.factorio.com/48598 more])
* Added <code>Entity::update_connections</code>. It updates connection of loader and beacon to entities that might have been teleported out or in. The effect might include more things later on.

== 0.15.14 ==
Date: 26.05.2017
=== Optimisations ===
* Optimised beacon update times which helps especially when the power is not full and it fluctuates.
=== Changes ===
* Added support for using username and password for proxy connections.
* Changed technology sorting. All of the science pack types affect the order, not just the most expensive one. ([https://forums.factorio.com/48448 more])
* Leading and trailing whitespace will be trimmed from host name or IP address entered to Direct Connect multiplayer dialog. ([https://forums.factorio.com/48489 more])
* Electric network info window shows all connected entities in the list and the graph even when they have 0 consumption/production.
** This means, that the count of entities connected to the network is shown even if they don't consume or produce.
* Electric poles that have 0 consumption as well as 0 production show empty electricity graph instead of full. ([https://forums.factorio.com/48513 more])
=== Bugfixes ===
* Keypad enter is treated as regular enter ([https://forums.factorio.com/47100 more])
* All buttons apart the inventory/recipe/crafting queue and item selection slot react on mouse click instead of just mouse down.
* Fixed that mining drills would continue to insert into entities when moved far away. ([https://forums.factorio.com/48332 more])
* Fixed that right click and drag in the blueprint setup GUI didn't work to remove things from the blueprint. ([https://forums.factorio.com/48354 more])
* Fixed that blueprint icons couldn't be removed with right click. ([https://forums.factorio.com/48354 more])
* Fixed that right-clicking items in the crafting queue didn't work to cancel 5.
* Fixed window being created slightly offscreen on certain resolutions. ([https://forums.factorio.com/45998 more])
* Fixed that the edit field for a blueprint book would get reset when bots delivered items to the player. ([https://forums.factorio.com/47498 more])
* Fixed that inserter facing north was slower compared to other directions. ([https://forums.factorio.com/9141 more])
* Fixed that the solaris achievement ignored usage of steam-turbines. ([https://forums.factorio.com/48429 more])
* Fixed that setting logistic requests didn't work in the map editor. ([https://forums.factorio.com/48432 more])
* Fixed crash after dropping a blueprint into a book inside the blueprint library. ([https://forums.factorio.com/48518 more])
* Fixed loading blueprint library from before 0.15.4 might crash. ([https://forums.factorio.com/48506 more])
* Fixed a crash related to changing the rail system when signals get disconnected from blocks. ([https://forums.factorio.com/48555 more])
* Fixed that furnaces and assembling machines weren't rotatable with heat pipe connection. ([https://forums.factorio.com/48574 more])
* Fixed crash when using <code>--load-game</code> with an error in a mod. ([https://forums.factorio.com/48550 more])
=== Modding ===
* Fixed reading <code>LuaCommandProcessor::commands</code> when one of the help keys was empty. ([https://forums.factorio.com/48032 more])
* Fixed that disabled mods could change the mod event order.
=== Scripting ===
* Fixed changing force of lab ghost would cause desync.
* Added LuaCustomGuiElement type "text-box".

== 0.15.13 ==
Date: 23. 05. 2017
=== Changes ===
* Most of the gui elements now work only with left mouse button, so other buttons might be used without interfering with gui.
=== Bugfixes ===
* Fixed that biters would sometimes try to attack indestructible entities. ([https://forums.factorio.com/45803 more])
* Fixed that clearing the blueprint label would make the GUI show the previous label. ([https://forums.factorio.com/45894 more])
* Fixed personal laser defense equipment shooting at player in vehicle would hit the player instead of the vehicle. ([https://forums.factorio.com/45461 more])
* Fixed that the edit label button on blueprint books in the library could get hidden behind the delete button. ([https://forums.factorio.com/45904 more])
* Fixed missing space after timestamp in server console output messages that didn't contain tag. ([https://forums.factorio.com/46766 more])
* Fixed that the blueprint library wouldn't update blueprints stored in books. ([https://forums.factorio.com/47544 more]) ([https://forums.factorio.com/45814 more])
* Fixed that reach-distance checks for curved rails only checked against one end of the rail. ([https://forums.factorio.com/47892 more])
* Fixed bonus GUI display values when the bonuses were negative. ([https://forums.factorio.com/47981 more])
* Fixed that the auto launch settings of rocket silo was not saved in blueprint. ([https://forums.factorio.com/47964 more])
* Fixed beta campaign level 02 would error for migrated save games. ([https://forums.factorio.com/47844 more])
* Fixed locked belts in demo campaign level 03. ([https://forums.factorio.com/44882 more])
* Localised programmable speaker notes and instruments. ([https://forums.factorio.com/47868 more])
* Fixed that mining drill window got repositioned to the center every time it switched to another resource. ([https://forums.factorio.com/45692 more])
* Fixed fluids/virtual signals in the blueprint library wouldn't migrate correctly between different modded saves. ([https://forums.factorio.com/47897 more])
* Before 0.14 the game didn't track online time of players, this caused that games transitioned from pre 0.14 could prevent players to get achievements until they spent enough of time in the game again. So for single player games, when transitioning to 0.15.13, the online time is reset to be full time of the map.
* Fixed that the bonus progress of assembling machine didn't reset when the recipe was changed by using copy paste.
** This could be exploited to get extra free product of expensive items. ([https://forums.factorio.com/48082 more])
* Fixed crash when loading modded saves that used the flamethrow-explosion entity type. ([https://forums.factorio.com/48101 more])
* Fixed performance problems when building rails related to large rail sections and chain signals. ([https://forums.factorio.com/48228 more])
* Fixed desync related to trains.
* Fixed blueprint library wouldn't use the Open Item GUI key binding. ([https://forums.factorio.com/48168 more])
* Fixed that errors in mod locale would only show in the log file instead of giving the standard mod-error GUI. ([https://forums.factorio.com/46914 more])
* Fixed that turret help view on map did show turrets from other surfaces. ([https://forums.factorio.com/47746 more])
* Fixed that silo script didn't validate items on configuration changes. ([https://forums.factorio.com/48236 more])
* Fixed that tightspot level 05 had incorrect recipes unlocked. ([https://forums.factorio.com/48174 more])
* Fixed that you could pipette items and break transport belt madness. ([https://forums.factorio.com/48171 more])
* Fixed that the game would crash when trying to load corrupt blueprint-storage.dat. ([https://forums.factorio.com/48265 more])
* Fixed that map was not updated correctly when tile editing ended up changing other tiles in different chunk. ([https://forums.factorio.com/48285 more])
* Fixed crash when loading modded saves that contained specific items without the mods. ([https://forums.factorio.com/48307 more])
* You can now open circuit network connectible entities while holding copper wire. ([https://forums.factorio.com/48279 more])
* Fixed crash when closing the game window in Browse Games/Play on LAN gui. ([https://forums.factorio.com/47253 more])
* Fixed that the bonus progress bar of furnace disappeared when the smelting was not currently in progress.
* Fixed that changing recipe in the furnace didn't reset the bonus progress bar. ([https://forums.factorio.com/47439 more])
* Fixed that selection box of rotated (and modded) storage tank wasn't respecting the rotation properly. ([https://forums.factorio.com/48315 more])
=== Modding ===
* Electric energy sources now support effectivity.
* Fixed crash when mods add values to data.raw incorrectly. ([https://forums.factorio.com/47932 more])
* Fixed some entities using heat energy source types wouldn't connect to heat pipes correctly when rotated. ([https://forums.factorio.com/47524 more])
* Mod settings now shows the mod display name instead of the mod ID name (My Mod Name instead of my-mod-name).
* Changing mod startup settings will now fire the on_configuration_changed event when appropriate.
=== Scripting ===
* Fixed crash when using game.take_screenshot and then deleting the surface. ([https://forums.factorio.com/46091 more])
* Fixed the old train ID wouldn't be included in some cases during the on_train_created event. ([https://forums.factorio.com/47958 more])
* Fixed crash when trying to register negative event ids. ([https://forums.factorio.com/47975 more])
* Fixed that force.reset_technology_effects() didn't preserve currently researched technology and saved technology progress. ([https://forums.factorio.com/48081 more])
* Fixed <code>LuaEntity::neighbours</code> return format to match the docs. ([https://forums.factorio.com/48176 more])
* Fixed <code>LuaPlayer::mine_entity()</code> would return false when successfully mining the given entity. ([https://forums.factorio.com/48243 more])
* Changed create_entity 'item-request-proxy' "modules" to take the same format as <code>LuaEntity::item_requests</code>. ([https://forums.factorio.com/47770 more])
* Changed <code>LuaSurface::freeze_daytime()</code> to freeze_daytime read/write.
* Removed <code>LuaPlayer::cursor_position</code>.
* Added <code>LuaEntity::proxy_target</code> read - the target an item-request-proxy is pointing at if any.
* Added LuaEntityPrototype/<code>LuaEquipmentPrototype::electric_energy_source_prototype</code> read.
* Added <code>LuaEntityPrototype::fluid_usage_per_tick</code>, maximum_temperature read, target_temperature.
* Added <code>LuaForce::get_saved_technology_progress()</code> and set_saved_technology_progress().
* Added <code>LuaFluidPrototype::gas_temperature</code> read.

== 0.15.12 ==
Date: 18. 05. 2017
=== Changes ===
* Zooming with the mouse wheel in the map and zoom-to-world is less aggressive.
* Fast entity transfer by dragging (ctrl + clicking and dragging) will remember if you're trying to insert or extract items.
* Changed the deconstruction planner "trees only" filter to "trees/rocks only".
* Lab speed info in the description contains the researched speed bonus as well.
* Sprite quality defaults to High when at least 2.7 GB VRAM is detected (instead of 1.7 GB).
* Video memory usage defaults to All when at least 1.5 GB VRAM is detected (instead of 0.8 GB).
=== Bugfixes ===
* The statistics window (electric/production/kills) will automatically move to avoid being partially offscreen. ([https://forums.factorio.com/37806 more])
* Fixed that keypad /*-+, enter and delete were not usable in the text boxes if assigned in the controls.
* Fixed that power poles could be built at any distance by exploiting click-and-drag. ([https://forums.factorio.com/46861 more])
* Fixed marking underground belt output for deconstruction wouldn't block input from pushing more items into the underground part. ([https://forums.factorio.com/47668 more])
* Fixed "Read Stopped Train" checkbox not showing the correct value. ([https://forums.factorio.com/47736 more])
* Fixed entities with a burner energy source would show the incorrect power consumption. ([https://forums.factorio.com/44741 more])
* Fixed that production achievements could not be obtained. ([https://forums.factorio.com/47793 more])
* Fixed that some achievements (raining bullets, logistic network embargo, maybe more) were not properly marked as gained. ([https://forums.factorio.com/47780 more])
* Show the productivity bonus on mining drills even when they have no other effects on them. ([https://forums.factorio.com/47786 more])
* Fixed some GUI shortcuts not working when colliding with other shortcuts. ([https://forums.factorio.com/45902 more])
* Fixed that electric network visualisation on chart showed electric poles from other surfaces. ([https://forums.factorio.com/47746 more])
* Fixed that non-ASCII input wasn't possible on Linux. ([https://forums.factorio.com/45484 more])
* Fixed error when loading a save containing a folder which contained only subfolders but no files. ([https://forums.factorio.com/45442 more])
* Fixed swinging axe as attack might spawn mining particles of a nearby tree or resource patch. ([https://forums.factorio.com/46265 more])
* Fixed that signals built by robots on places that didn't match the suggested direction didn't connect. This caused that some otherwise correct blueprints required manual intervention to fix the signals. ([https://forums.factorio.com/46381 more])
* Fixed handling of X11 focus events. ([https://forums.factorio.com/47768 more])
* Fixed trains wouldn't leave disabled stations when the next station in the schedule was the same station. ([https://forums.factorio.com/47805 more])
* Fixed train stops wouldn't import as string correctly. ([https://forums.factorio.com/47870 more])
* Fixed requester chests would render numbers larger than 2,147,483,647 as negative values. ([https://forums.factorio.com/47852 more])
* Fixed logging in with email in updater set your username to your email. ([https://forums.factorio.com/47908 more])
=== Modding ===
* Fixed that electric boiler didn't work. ([https://forums.factorio.com/47716 more])
* Fixed int mod setting error display message didn't show the upper limit correctly. ([https://forums.factorio.com/47862 more])
=== Scripting ===
* Fixed cloning blueprint books wouldn't copy the label/active index. ([https://forums.factorio.com/47801 more])
* Fixed that inoperable entities couldn't be rotated even when rotatable was true. ([https://forums.factorio.com/47842 more])
* Changed <code>LuaItemStack::trees_only</code> to trees_and_rocks_only.
* Added <code>LuaEntity::loader_type</code> write.
* Added <code>LuaFlowStatistics::on_flow()</code>.
* Fixed lua documentation for DeciderCombinatorParameters and CircuitCondition. ([https://forums.factorio.com/47829 more])
* Fixed passing invalid arguments to <code>LuaGame::take_screenshot</code> would cause desync. ([https://forums.factorio.com/47890 more])

== 0.15.11 ==
Date: 16. 05. 2017
=== Minor Features ===
* When a train is stopped at the train stop, a circuit network signal is sent with a unique number for that train. ([https://forums.factorio.com/46234 more])
=== Changes ===
* Added headless server option <code>--server-id</code> to allow specifying custom path to the server ID file.
* Increased the minimum custom UI scale from 50% to 80% to avoid some scaling issues.
* The zoom level at which the map switches from 'map view' to 'world view' was increased.
* The first level of infinite researches is not needed for the tech maniac achievement anymore.
* The game will default to low sprite quality on computers with less than 2.5GB RAM. ([https://forums.factorio.com/47525 more])
* Tweaked the rocket launch gui. It doesn't show the result inventory slot when it is empty to avoid confusion when people put the satellite in it.
* Removed the zoom-to-world-outside-coverage debug option because it was causing issues. ([https://forums.factorio.com/47442 more])
* Added "create specialized sprite atlases" option to graphics settings. If checked, tile and shadow sprites won't be put into separated sprite atlases instead of the main one. This should give graphics driver more room to fit required sprites to graphics memory.
* Added "atlas texture size" option to graphics settings. Larger atlas texture can fit more sprites into single atlas which reduces CPU load when rendering.
** But smaller atlases are more likely to fit into VRAM and reduce GPU load when rendering.
=== Bugfixes ===
* Fixed nuclear reactor and centrifuge were not placed into toolbelt automatically. ([https://forums.factorio.com/47155 more])
* Tweaked the way heat pipes work, mainly to make it work the same regardless order of build. ([https://forums.factorio.com/44972 more])
* Fixed that click-and-drag interaction logic didn't work for trains. ([https://forums.factorio.com/47180 more])
* Another attempt to fix the ranged-based research info in the technology icon.
* Fixed that not all items were cleared in the transport belt madness campaign. ([https://forums.factorio.com/47171 more])
* Fixed that browse games table was inconsistent after resizing. ([https://forums.factorio.com/47137 more])
* Achievements should no longer be unlocked when replaying a game. ([https://forums.factorio.com/47151 more])
* Updated supply challenge level requirements. ([https://forums.factorio.com/46796 more])
* Fixed fluids consumed/produced by boilers didn't show in the production stats. ([https://forums.factorio.com/47169 more])
* Fixed that pasting very large strings wouldn't work on Linux. ([https://forums.factorio.com/46802 more])
* Fixed naming convention of transport belt madness campaign levels. ([https://forums.factorio.com/47243 more])
* Fixed copy-paste with containers so they correctly copy the inventory size limit. ([https://forums.factorio.com/47262 more])
* Fixed the progress bars in the lab wouldn't show correctly in some cases. ([https://forums.factorio.com/47131 more])
* Achievements are no longer be unlocked when replaying a game. ([https://forums.factorio.com/47151 more])
* Achievements are no longer unlocked by playing multiplayer game in which the player spent less than 50% of time online.
* Fixed that the blueprint renaming text box would close every time crafting finished. ([https://forums.factorio.com/46970 more])
* core/backers.json is now included in the core data crc. This means that different content of this file will be properly detected when joining multiplayer game.
* Fixed that loader filters were not saved in the blueprint string. ([https://forums.factorio.com/47303 more])
* Gas color is now tinted with the fluids 'flow_color'. ([https://forums.factorio.com/47311 more])
* Fix wave defense crash when a silo died while nobody was connected. ([https://forums.factorio.com/47263 more])
* Fixed that the "confirm and download" button in the sync-mods-with-save wouldn't restart the game once all mods were downloaded. ([https://forums.factorio.com/47335 more])
* Fixed construction robots could get stuck trying to repair curved rail forever. ([https://forums.factorio.com/47359 more])
* Fixed that the technology cost tooltip description wouldn't scale correctly. ([https://forums.factorio.com/46445 more])
* Fixed that the /help command when run from the server console would always output the server commands list. ([https://forums.factorio.com/46406 more])
* Fixed strange behavior when a train has the same station in the list multiple times with no other valid station. ([https://forums.factorio.com/46473 more])
* Fixed crash related to dying with some GUI open. ([https://forums.factorio.com/47433 more])
* Fixed rail signals getting stuck reserved when mining/building rails in some setups. ([https://forums.factorio.com/47333 more])
* Fixed desync when pumps are setup to pump into the output of an assembling machine. ([https://forums.factorio.com/47402 more])
* Fixed the final level of formula based research would show the wrong name when researched.
* Fixed crash when maximizing the game with the achievements window open. ([https://forums.factorio.com/46936 more])
* Fixed switching weapons while firing in the tank would keep playing the previous weapon sound. ([https://forums.factorio.com/46103 more])
* The productivity value in the miner description now contains also the researched bonus.
* Fixed insert sending a signal twice during fast replace. ([https://forums.factorio.com/47486 more])
* Fixed crash that would sometimes happen when a player left whilst some other player was in the process of joining. ([https://forums.factorio.com/46516 more])
* Fixed hazard concrete item description. ([https://forums.factorio.com/46154 more])
* Fixed that some of the slider in the new game settings weren't controllable by scrollbar.
* Fixed recipes with long names would extend out of the tooltip GUI. ([https://forums.factorio.com/45125 more])
* Fixed keyboard input would be blocked in tutorial, if console was opened when entering the tutorial. ([https://forums.factorio.com/44602 more])
* Fixed robots could deliver the wrong number of modules during roboport blackouts. ([https://forums.factorio.com/47508 more])
* Fixed that the game would freeze if there was no valid place to drop items on limited size maps. ([https://forums.factorio.com/47640 more])
* Fixed fire wouldn't pollute in some cases. ([https://forums.factorio.com/47621 more])
* Fixed that the delete-blueprint button would show when it wouldn't actually work. ([https://forums.factorio.com/47599 more])
* Fixed an error when resource scaling results in amounts too large to store in a resource entity. ([https://forums.factorio.com/47661 more])
=== Modding ===
* Fixed generator power output was always based on heat capacity and default temperature of water. ([https://forums.factorio.com/45652 more])
* Fixed logistic and construction radius visualization sprites would ignore tint. ([https://forums.factorio.com/47689 more])
=== Scripting ===
* Fixed setting <code>technology::researched</code> wouldn't research all levels of a formula based technology. ([https://forums.factorio.com/45857 more])
* Fixed it was possible to add gui element with same to the same parent name more than once. ([https://forums.factorio.com/45371 more])
* Fixed the custom camera widget wouldn't render the correct entities when switching the surface it was rendering for. ([https://forums.factorio.com/47639 more])
* Fixed <code>LuaTrain::schedule</code> would allow an invalid current schedule record. ([https://forums.factorio.com/47691 more])
* Added <code>LuaEntityPrototype::mining_speed</code>, mining_power, energy_usage, max_energy_usage, normal_resource_amount, infinite_depletion_resource_amount, attack_parameters read.
* Added <code>LuaLampControlBehavior::color</code> read.
* Added <code>LuaRailSignalControlBehavior::red_signal</code>, orange_signal, green_signal, close_signal, read_signal, circuit_condition read/write.
* Added <code>LuaEntityPrototype::mineable_properties</code> fluid_amount, required_fluid, mining_trigger, effectivity, consumption, friction_force, braking_force, tank_driving, rotation_speed, turret_rotation_speed, guns, speed, speed_multiplier_when_out_of_energy, max_payload_size, energy_per_move, energy_per_tick, max_energy, min_to_charge, max_to_charge properties, and building_grid_bit_shift.
* Added <code>LuaBurner::fuel_category</code> read.
* Added LuaBurnerPrototype.
* Added <code>LuaControl::mine_entity()</code>.
* Added <code>LuaEntity::text</code> read/write.
* Added read/write support for flying text color through <code>LuaEntity::color</code>.
* Added <code>LuaTrain::get_fluid_count()</code>, get_fluid_contents(), remove_fluid(), insert_fluid(), and clear_fluids_inside().
* Added <code>LuaGameScript::check_prototype_translations()</code> - a way to check if all expected prototypes have valid translations.
* Changed <code>LuaEntityPrototype::mineable_properties</code> "miningtime" -> "mining_time" and "miningparticle" -> "mining_particle".

== 0.15.10 ==
Date: 10. 05. 2017
=== Changes ===
* Added rail block debug visualization.
* Increased maximum wire distance of all circuit connectable entities from 7.5 to 9.
* Steam is now internally a separate fluid from hot water.
* Coal liquefaction recipe now requires steam instead of water.
* Terrain, shadow and smoke sprites are sorted into separate sprite atlases in attempt to optimize GPU memory access during rendering.
=== Graphics ===
* Added burner mining drill in high resolution and replaced the normal resolution version.
=== Bugfixes ===
* Fixed speed-module-3 recipe typo. ([https://forums.factorio.com/46820 more])
* Fixed downgrading underground belts by fast replace would not work for even if output piece was close enough. ([https://forums.factorio.com/46595 more])
* Fixed that robots trying to repair each other wouldn't work correctly. ([https://forums.factorio.com/46628 more])
* More understandable description current level of technologies that have multiple levels merged into one slot in the technology gui.
* Fixed crash that would happen when loading old modded saves in vanilla Factorio. ([https://forums.factorio.com/46642 more])
* Fixed that it wasn't possible to fast-transfer blueprints to other players. ([https://forums.factorio.com/46178 more])
* Fixed that hitting rocks with vehicles made no sound. ([https://forums.factorio.com/45888 more])
* Fixed blueprint preview icons scaling and size to be consistent across all places they're shown. ([https://forums.factorio.com/45021 more])
* Fixed that you couldn't delete blueprints from your trash slots. ([https://forums.factorio.com/46903 more])
* Fixed that storage tanks used 4 directions although visually only showed 2 so they would conflict in blueprints. ([https://forums.factorio.com/46900 more])
* Fixed crash when loading blueprint storage while also migrating save files. ([https://forums.factorio.com/46910 more])
* Fixed a useless error when locale isn't correct for a scenario. ([https://forums.factorio.com/46909 more])
* Fixed possible desync related to inserter circuit network stack size control.
* Fixed that multiple passengers in a train could result in erratic behavior when trying to drive. ([https://forums.factorio.com/35810 more])
* Fixed that manually inserting the satellite into the silo when auto-launch is enabled wouldn't launch the rocket. ([https://forums.factorio.com/46610 more])
* Fixed crash when killing yourself with your own weapon. ([https://forums.factorio.com/46984 more])
* Fixed F12 might freeze or crash the game. ([https://forums.factorio.com/46790 more])
* Fixed circuit network controlled rail signal sometimes not going red when building rails. ([https://forums.factorio.com/43839 more])
* Fixed crash when starting tutorial at the same tick as autosave starts. ([https://forums.factorio.com/45701 more])
* Fixed that it wasn't possible to scroll the active blueprint in a blueprint book if the scroll bar was visible. ([https://forums.factorio.com/45898 more])
* Fixed crash when exiting some modded games. ([https://forums.factorio.com/47037 more])
* Fixed that Factorio wouldn't keep file permissions when saving a map. ([https://forums.factorio.com/46442 more])
* Fixed that the blueprint library wouldn't remember the player filter after opening a book. ([https://forums.factorio.com/45932 more])
* Fixed that player names in the blueprint library weren't sorted. ([https://forums.factorio.com/45920 more])
* Fixed the blueprint book tooltips would flicker when your inventory changed. ([https://forums.factorio.com/47064 more])
* Fixed desync when catching up.
* Fixed desync when adding/removing blueprints to blueprint books in some cases. ([https://forums.factorio.com/46719 more])
* Fixed some crashes related to loading invalid combinator parameters. ([https://forums.factorio.com/46500 more])
=== Modding ===
* The game will now detect when joining a multiplayer game if any mods you're using are broken such that joining the game could result in desynching.
* Fixed that exiting the mod settings GUI without changing anything would incorrectly think you changed settings in some cases. ([https://forums.factorio.com/46478 more])
* Fixed crash when loading mods control.lua produces an error. ([https://forums.factorio.com/46009 more])
* Added favourite server icon to utility sprites. ([https://forums.factorio.com/46059 more])
* Added a global table "mods" - a mapping of mod name to mod version available during the prototype loading stage.
=== Scripting ===
* Fixed some missing Lua docs and added information about the settings stage to the data life cycle. ([https://forums.factorio.com/44918 more])
* Fixed crash when trying to create stickers on entities that don't support them. ([https://forums.factorio.com/46334 more])
* Fixed that <code>LuaGuiElement::surface_index</code> was using 0-based indexing. ([https://forums.factorio.com/46502 more])
* Fixed that <code>LuaEntity::graphics_variation</code> was using 0-based indexing. ([https://forums.factorio.com/46762 more])
* Fixed that <code>LuaItemStack::active_index</code> was using 0-based indexing. ([https://forums.factorio.com/46963 more])
* Fixed rendering of layered icons in custom GUI. ([https://forums.factorio.com/45926 more])
* Added "item" and "tags" to the robot built entity/tile events.
* Added <code>LuaEquipment::burner</code> read.
* Added <code>LuaEntityPrototype::crafting_categories</code> read.
* Added support for setting 'tags' and 'custom_description' when making items through Lua.
* Added <code>LuaBurner::burnt_result_inventory</code> read.
* Added LuaInserterControlBehavior stack size read/write.
* Added LuaTrainStopControlBehavior enable/disable conditions.
* Added LuaTransportBeltControlBehavior enable_disable, read_contents, read_contents_mode read/write.
* Added <code>LuaTrain::id</code> read.
* Added <code>LuaEntityPrototype::supply_area_distance</code> read.
* Added <code>LuaEntityPrototype::max_wire_distance</code> read.
* Added <code>LuaEntityPrototype::max_circuit_wire_distance</code> read.

== 0.15.9 ==
Date: 05. 05. 2017
=== Bugfixes ===
* Fixed crash when opening the train GUI while in the train.

== 0.15.8 ==
Date: 05. 05. 2017
=== Changes ===
* New Supply challenge map.
* Circuit network-based inserter stack size overrides now take effect immediately instead of waiting until the inserter has moved something.
=== Bugfixes ===
* Show 0.7% in the uranium processing recipe instead of 0.0 for uranium 235. This generally works for any recipe that gives less than 1 of anything.
* Don't draw player names on the map that is not in range of player or radar on the zoomed in map.
* Fix some ores with negative values in Tight spot level 04. ([https://forums.factorio.com/45656 more])
* Fixed inserters couldn't insert fuel into locomotives. ([https://forums.factorio.com/46467 more])
* Fixed random inaccessible map area in Beta campaign level 04. ([https://forums.factorio.com/46393 more])
* Fixed various inserter GUI bugs. ([https://forums.factorio.com/45337 more])
* Fixed train station tutorial relied on specific train schedule state. ([https://forums.factorio.com/45821 more])
=== Balancing ===
* Changed iron gear wheel price of fast and underground belt from 20->40 and 40->80 to even out the bigger length.
* Fix that biters would sometimes stop and go to sleep during an attack. ([https://forums.factorio.com/45320 more])

== 0.15.7 ==
Date: 05. 05. 2017
=== Balancing ===
* Changed production science pack recipe to require assembling machine 1 instead of pumpjack.
* Changed science pack 3 to require electric mining drill instead of assembling machine 1.
* Changed crafting times:
** Oil refinery 20->10
** Pumpjack 10->5
** Chemical plant 10->5
** Lab 5->3
** Roboport 15->10
* Reduced the mining time of the storage tank from 3 seconds to 1.5 seconds.
* Increased the mining time of the reactor from 0.5 seconds to 1.5 seconds.
* Increased the underground belt length (basic, fast, express) from 5,5,5 to 5,7,9.
=== Changes ===
* When a connection is refused the username is included in the log message. ([https://forums.factorio.com/46036 more])
* Copying entity settings from a disconnected entity will no longer disconnect circuit wires. ([https://forums.factorio.com/45816 more])
* Trains in manual mode now have twice the penalty and trains in manual mode without a player in them have 2.5 times the penalty.
* Reactors produce used up fuel cell when it is completely consumed instead of at start. ([https://forums.factorio.com/46123 more])
* Reverted flamethrower turret liquid consumption change from 0.15.5. Instead of 30/s it will use 3/s.
* Flamethrower turret no longer shoots in its prepare state. ([https://forums.factorio.com/46160 more])
* /color command defaults alpha (the 4th parameter) to 255 (instead of 0) if not specified. ([https://forums.factorio.com/46338 more])
* Reduced default requester chest paste multiplier for nuclear reactor recipe to 1 and for centrifuge recipe to 2. ([https://forums.factorio.com/45878 more])
* Inserters will no longer take fuel from locomotives and instead will take the burnt result items if the locomotive fuel uses that system.
=== Bugfixes ===
* Fixed that clicking locomotive from zoomed in map view would change color (and show fuel) for some other locomotive on the train ([https://forums.factorio.com/46137 more])
* Fixed that construction bots could repair vehicles from very far. ([https://forums.factorio.com/45517 more])
* Fixed that rocket silo or other GUIs would obscure finished-game dialog. ([https://forums.factorio.com/46157 more])
* Fixed that boiler could output a different fluid than its input. ([https://forums.factorio.com/46023 more])
* Fixed that the inserter would sometimes report bad values to the circuit network. ([https://forums.factorio.com/45598 more])
* Fixed pump recipe description having wrong pumping speed. ([https://forums.factorio.com/45863 more])
* Fixed wrong error message when loaded headless save file doesn't exist ([https://forums.factorio.com/45058 more])
* Fixed the "Input action fragment is missing" crash that would sometimes happen due to packet loss. ([https://forums.factorio.com/45604 more])
* Fixed crash when resizing the game window while having an assembling machine level 1 GUI open. ([https://forums.factorio.com/46069 more])
* Fixed alternative zoom controls would do nothing in map editor. ([https://forums.factorio.com/46136 more])
* Fixed some cargo wagon spritesheets were offset by 1 frame. ([https://forums.factorio.com/44930 more])
* Fixed that it was hard/not possible to select the character corpse over some entities. ([https://forums.factorio.com/45764 more])
* Fixed that the blueprint book GUI would scroll to the top after every click. ([https://forums.factorio.com/46184 more])
* Fixed crash when trying to disconnect non circuit connectible entities using <code>Lua::Entity</code>::disconnect_neighbour. ([https://forums.factorio.com/46111 more])
* Fixed that calling <code>Lua::Entity</code>::disconnect_neighbour would sometimes disconnect more wires than it should.
* Fixed mod settings corruption when removing mods that contained mod settings. Note: this will reset all mod settings. ([https://forums.factorio.com/46207 more])
* Fixed inconsistent selection of resource patches on the map. ([https://forums.factorio.com/44596 more])
* Fixed GUI sizing when resetting mod settings. ([https://forums.factorio.com/46150 more])
* Fixed that the blueprint book GUI would scroll to the top after every click. ([https://forums.factorio.com/46184 more])
* Fixed that dropping a blueprint onto a book icon in the library GUI would drop it in the top level instead. ([https://forums.factorio.com/46112 more])
* Fixed that the blueprint library would sometimes stop opening books. ([https://forums.factorio.com/46004 more])
* Fixed GUI scaling problems with the assembling machine GUI. ([https://forums.factorio.com/46046 more])
* Fixed desync related to the on_selected_entity_changed event. ([https://forums.factorio.com/46025 more])
* Fixed that the atomic bomb shooting speed cooldown didn't work. ([https://forums.factorio.com/46217 more])
* Fixed the constant combinator GUI when the constant combinator name was larger than the rest of the GUI. ([https://forums.factorio.com/44227 more])
* Fixed that the reactor didn't show fuel in the description. ([https://forums.factorio.com/46266 more])
* Fixed making blueprints of requester chests with "set requests" would copy the current requests into the blueprint. ([https://forums.factorio.com/46038 more])
* Fixed that deleting saves with the delete key key wouldn't maintain focus on the saves list. ([https://forums.factorio.com/45234 more])
* Fixed crash when mining rails while having the "show rail paths" debug option enabled. ([https://forums.factorio.com/45836 more])
* Fixed infinite loop when migrating entities from an unrelated type to a roboport type. ([https://forums.factorio.com/44351 more])
* Fixed that the technology multiplier didn't apply on infinite research. ([https://forums.factorio.com/45079 more])
* Fixed filtering server list for games with mods. ([https://forums.factorio.com/46264 more])
* Fixed mod version checking for automatic mod download. ([https://forums.factorio.com/46321 more])
* Fixed flamethrower turret would not shoot last single shot worth of liquid. ([https://forums.factorio.com/46311 more])
* Fixed crash when exiting server list ([https://forums.factorio.com/46293 more])
* Fixed "Right mouse button to open" in opened armor. ([https://forums.factorio.com/46317 more])
* Fixed that the blueprint library wouldn't use scroll bars for shared blueprint books. ([https://forums.factorio.com/45464 more])
* Fixed that resource patches in unexplored areas could be examined on the map.
* Fixed rail ghosts could not be placed over ghosts of enemy force. ([https://forums.factorio.com/46335 more])
* Fixed the sulfuric acid fluid icon. ([https://forums.factorio.com/46371 more])
* Fixed that /config set password wouldn't work. ([https://forums.factorio.com/44573 more])
=== Modding ===
* Icons are now required to have correct size (which can be overridden by icon_size property). ([https://forums.factorio.com/45700 more])
* 32x32px for entity, fluid, item, item-group, recipe, technology, virtual-signal
* 128x128px for achievement, tutorial
* If icon path references base mod, technology icon is expected to be 128x128px and item-group icon 64x64px.
* In near future, we may remove default sizes and require icon_size to be always specified.
* It is no longer possible to teleport any rolling stock or train stop. ([https://forums.factorio.com/45264 more])
* Added the string mod setting prototype property "auto_trim" defaulting to false.
=== Scripting ===
* Fixed LuaChunkIterator could become invalid and crash the game if used. ([https://forums.factorio.com/46366 more])
* Added <code>LuaPlayer::mod_settings</code> read - the runtime player mod settings for the given player.
* Added <code>LuaEntity::temperature</code> read/write - the temperature of entities that use the heat energy source type as well as reactors and heat pipes.
* Added <code>LuaEntity::get_burnt_result_inventory</code>.

== 0.15.6 ==
Date: 02. 05. 2017
=== Changes ===
* Increased roboport construction range to 55 (110x110 area) to make roboports able to build each other without interconnecting their logistic areas, and not break when there are obstacles like trees or rocks.
=== Bugfixes ===
* Fixed centrifuge glowing for one frame each time inserter drops something. ([https://forums.factorio.com/45824 more])
* Fixed biters expansion was biased towards northern part of the map. ([https://forums.factorio.com/45607 more])
* Fixed blueprint preview splitter not bending nearby belts correctly. ([https://forums.factorio.com/45578 more])
* Fixed items on ground were not cleared in tightspot campaign. ([https://forums.factorio.com/45666 more])
* Fixed that mining drills wouldn't pull in enough acid to continue mining. ([https://forums.factorio.com/45707 more])
* Fixed that you could complete some advanced signal tutorial stages by blocking trains. ([https://forums.factorio.com/45659 more])
* Fixed that nuclear fuel reprocessing was used to calculate raw ingredient requirements. ([https://forums.factorio.com/45507 more])
* Fixed that you could input invalid value to PvP config. ([https://forums.factorio.com/45713 more])
* Fixed crash when changing force of turret ghost. ([https://forums.factorio.com/45723 more])
* Fixed inserters would grab items off belts and try to drop them onto rails after the train left. ([https://forums.factorio.com/45693 more])
* Fixed inserters would rest with their hand above the center of a splitter. ([https://forums.factorio.com/45742 more])
* Fixed desync caused by heat pipes. ([https://forums.factorio.com/45754 more])
* Fixed crash when trying to edit mod settings after joining a paused multiplayer game. ([https://forums.factorio.com/45625 more])
* Fixed removed decoratives were migrated as big-ship-wreck-grass instead of being deleted from map. ([https://forums.factorio.com/45807 more])
* Fixed input underground belt fast replace would also replace output piece even if input changed direction. ([https://forums.factorio.com/45847 more])
* Fixed combinators continuing to output signals when parameters are cleared or when disconnecting feedback wire. ([https://forums.factorio.com/45633 more])
* Fixed programmable speaker continuing to make sounds without a wire connected. ([https://forums.factorio.com/45556 more])
* Fixed that it wasn't possible to scroll with the mouse wheel in the mod settings GUI. ([https://forums.factorio.com/45883 more])
* Fixed updater would fail if Factorio was in folder with name containing non-English characters. ([https://forums.factorio.com/45301 more])

== 0.15.5 ==
Date: 30. 04. 2017
=== Bugfixes ===
* Fixed crash when setting character trash slots through script while having the character GUI opened. ([https://forums.factorio.com/45585 more])
* Fixed crash on joining a multiplayer game if the "use different mod settings per save" was disabled. ([https://forums.factorio.com/45615 more])
* Fixed blueprint with roboports wouldn't draw roboport connections. ([https://forums.factorio.com/45573 more])
* Fixed crash when building rails in specific setups while trains are reserving signals on the rails being changed. ([https://forums.factorio.com/45627 more])
* Fixed when changing graphical variation of a tree from script or in map editor. ([https://forums.factorio.com/45630 more])
* Fixed flamethrower turret was using 10x less fluid than it should.
* Fixed opening item GUI wasn't rebindable ([https://forums.factorio.com/45501 more])
* Fixed burner inserters would try to fuel themselves with fuel they couldn't use. ([https://forums.factorio.com/45596 more])
* Fixed crash when deleting chunks in some instances. ([https://forums.factorio.com/45647 more])
* Fixed one direction of hazard concrete had no walking sounds. ([https://forums.factorio.com/45648 more])
* Fixed rare crash when getting killed by the locomotive you had opened. ([https://forums.factorio.com/45610 more])
* Fixed that right clicking the map view buttons would change the option but not update the button. ([https://forums.factorio.com/44611 more])
* Fixed the generate-map settings wouldn't be saved when switching to the mod-settings through the generate map GUI. ([https://forums.factorio.com/45081 more])
* Fixed crash when interacting with the map view buttons in some cases. ([https://forums.factorio.com/44719 more])
* Fixed crash when mousing over entities in some rare cases. ([https://forums.factorio.com/44873 more])
* Fixed crash when trying to mine tiles from the zoomed-to-world view. ([https://forums.factorio.com/44884 more])
* Fixed crash when editing speaker parameters in the map editor. ([https://forums.factorio.com/45676 more])
* Fixed that train stops wouldn't show the correct name when changed remotely. ([https://forums.factorio.com/44793 more])
* Fixed crashes related to electric pole/accumulator removal when migrating saves from 0.14 into 0.15. ([https://forums.factorio.com/45657 more])
* Fixed rail signals built by robots would frequently lead to the signals not connecting properly. ([https://forums.factorio.com/45382 more])
* Fixed GUI layout problems in the rocket silo GUI when adding/removing productivity modules. ([https://forums.factorio.com/45523 more])
* Fixed items on belt flickering when occupying same position. ([https://forums.factorio.com/45490 more])
=== Scripting ===
* Fixed module inventory insert() didn't work for assembling machines. ([https://forums.factorio.com/45678 more])

== 0.15.4 ==
Date: 29. 04. 2017
=== Changes ===
* Added /permissions reset to reset all permissions to default.
* Steam and water content of fluid wagons are now shown separately in locomotive tooltip.
* Removed the "minimum chunks between new bases" map generation setting because it wasn't doing anything.
* Re-added custom /color support through /color r g b a.
* PvP: Added a biter easing option to prevent excessively large bases close to team starting areas.
=== Bugfixes ===
* Fixed crash when building rails while a train is currently reserving some of the signals. ([https://forums.factorio.com/45145 more])
* Fixed that you could set the inserter stack size over the researched maximum by sending negative numbers with the circuit network. ([https://forums.factorio.com/44890 more])
* Fixed combinators continuing to output signals after disconnecting the input. ([https://forums.factorio.com/45094 more])
* Fixed blueprint would reference force it was created on and crash in rendering if that force no longer existed. ([https://forums.factorio.com/45356 more])
* Fixed that names of books stored in the blueprint library wouldn't be preserved after save and load. ([https://forums.factorio.com/44957 more])
* Fixed supply scenario would sometimes show the next level button in error. ([https://forums.factorio.com/45451 more])
* Fixed the rocket silo wouldn't copy the "auto-launch" option in blueprints.
* Fixed Sulfuric Acid recipe using 10 times less water. ([https://forums.factorio.com/45347 more])
* Fixed that dropping blueprints into a book inside the library would sometimes drop the wrong blueprint. ([https://forums.factorio.com/45323 more])
* Fixed crash when changing mod settings runtime while in a multiplayer game. ([https://forums.factorio.com/45395 more])
* Fixed that opening the blueprint library after calling game.remove_offline_players() would crash the game. ([https://forums.factorio.com/44806 more])
* Fixed that <code>--start-server</code> wouldn't find the save file when given just a name without the .zip suffix. ([https://forums.factorio.com/44551 more])
* Fixed that it was possible to export a blueprint book into another blueprint book. ([https://forums.factorio.com/45315 more])
* Fixed that it was possible to have the same blueprint multiple times in the library. ([https://forums.factorio.com/45315 more])
* Fixed that it was possible to grab a blueprint from the library whilst also holding a deconstruction planner in hand. ([https://forums.factorio.com/45315 more])
* Fixed desync when moving mouse over areas outside of radar range in zoomed-to-world view. ([https://forums.factorio.com/45455 more])
* Fixed crash when leaving the technology price multiplier blank. ([https://forums.factorio.com/45269 more])
* Fixed crash when removing modded rails during save migration. ([https://forums.factorio.com/45436 more])
* Fixed lab without power would be still rendered as active. ([https://forums.factorio.com/45372 more])
* Fixed several instances of the "last user" field not getting updated. ([https://forums.factorio.com/45485 more])
* Fixed rocket silo would not increment its "products finished" count when finishing rocket. ([https://forums.factorio.com/45381 more])
* Fixed landmines would last forever when friendly fire was disabled. ([https://forums.factorio.com/45379 more])
* Fixed possible crash when closing Factorio during loading. ([https://forums.factorio.com/45573 more])
=== Modding ===
* Blueprints/books/deconstruction item prototypes with the "hidden" flag will no longer show up in the blueprint library. ([https://forums.factorio.com/45474 more])
* Added missing lua docs index section for settings and fixed some wording. ([https://forums.factorio.com/45380 more])
=== Scripting ===
* Fixed assigning invalid index to <code>LuaEntity::graphics_variation</code> would cause crash. ([https://forums.factorio.com/45420 more])
* Fixed setting <code>LuaItemStack::blueprint_icons</code> didn't work correctly. ([https://forums.factorio.com/45428 more])
* Fixed teleporting entity with rectangular bounding box would reset bounding box to north orientation and cause desync. ([https://forums.factorio.com/45256 more])
* Added <code>LuaEntity::products_finished</code> for crafting machines.

== 0.15.3 ==
Date: 27. 04. 2017
=== Changes ===
* Wave defense: Units won't spawn if there are more than 500 already on the map.
* Wave defense: Added a 'Unit bounty bonus' upgrade.
* Removed the ability to set /color using RGB values.
* Wave defense: Added Uranium to the map.
* "Disable all mods" option in mod load error dialog doesn't disable base mod anymore.
* Changed stack-split so "splitting" a stack of 1 still transfers the 1 item. ([https://forums.factorio.com/45149 more])
* Change submachine stack size to 5. ([https://forums.factorio.com/45210 more])
* Blueprints, blueprint books and deconstruction planners can be destroyed by clicking the trash can icon in their GUIs. Clearing a blueprint is still possible via the Shift+Right Click shortcut.
=== Bugfixes ===
* Fixed the fluid usage description for the steam engine would flicker when holding the steam engine in the cursor. ([https://forums.factorio.com/44911 more])
* Fixed that assembling machines would think the fluid barreling/unbarreling recipes could be used to calculate base ingredients for recipes. ([https://forums.factorio.com/44861 more])
* Fixed performance problems when opening the blueprint library GUI when the map has a large number of players. ([https://forums.factorio.com/44925 more])
* Fixed crash related to connection attempts from players with mods with mod settings. ([https://forums.factorio.com/44966 more])
* Fixed getting "No map setting instance" error when loading faulty mod instead of actual error. ([https://forums.factorio.com/44982 more])
* Fixed entering tutorial would remove scenario control script from current game. ([https://forums.factorio.com/44986 more])
* Fixed crashes related to saves with migrated circuit network signals. ([https://forums.factorio.com/44877 more])
* Fixed numeric inputs would block all keys instead of just numbers. ([https://forums.factorio.com/44971 more])
* Fixed ore field amount stuck to cursor when in technology view. ([https://forums.factorio.com/44641 more])
* Fixed crashes related to migrated saves with circuit network signals. ([https://forums.factorio.com/44877 more])([https://forums.factorio.com/45025 more])
* Fixed that train station tutorial would not progress if you removed the train wait condition. ([https://forums.factorio.com/45047 more])
* Fixed crash when changing mod setting prototype types. ([https://forums.factorio.com/45054 more])
* Fixed the refinery flame would freeze when using the coal liquefaction recipe and the machine didn't have any coal. ([https://forums.factorio.com/45050 more])
* Fixed fluids would be counted incorrectly for production stats when a pumpjack was placed on an oil well with a modded extremely high yield. ([https://forums.factorio.com/45075 more])
* Fixed the trains GUI wouldn't scale correctly. ([https://forums.factorio.com/41228 more])
* Fixed you could select entities in the zoomed-to-world view outside radar coverage. ([https://forums.factorio.com/44578 more])
* Fixed prompt about disabled base mod would not show up. ([https://forums.factorio.com/45051 more])
* Fixed crash when train was destroyed while hovering over it in map view. ([https://forums.factorio.com/45085 more])
* Fixed that the team production starting lobby had some uranium ore. ([https://forums.factorio.com/44613 more])
* Fixed hovering over very large resource patch in map view would crash the game. ([https://forums.factorio.com/45097 more])
* Fixed the "don't mine resources if mining starts with non-resources" logic. ([https://forums.factorio.com/44548 more])
* Fixed crash when the preview picture can't be saved for a save file. ([https://forums.factorio.com/45118 more])
* Fixed crash when trying to filter opened other players quick bars. ([https://forums.factorio.com/45147 more])
* Fixed crash when setting resource minimal yield above the normal yield. ([https://forums.factorio.com/45112 more])
* Fixed the tab complete logic for the /mute-programmable-speaker command. ([https://forums.factorio.com/44902 more])
* Fixed that you could only build blueprints in the zoom-to-world by click and drag.
* Fixed script error in basic train tutorial. ([https://forums.factorio.com/45184 more])
* Removed redundant recipe unlock in trash slot technology. ([https://forums.factorio.com/45209 more])
* Fixed inserter stack size override sometimes being lost when importing a blueprint.
* Fixed crash that would occasionally happen after deleting a book from the blueprint library. ([https://forums.factorio.com/44687 more])
* Fixed fluid could flow into the heat exchangers output fluidbox. ([https://forums.factorio.com/44992 more])
* Fixed that inserters would try to put stuff into the rocket silo result inventory. ([https://forums.factorio.com/45213 more])
* Fixed some invalid map exchange strings would crash the game. ([https://forums.factorio.com/45258 more])
* Fixed train stop would not output content fluid wagons to circuit network. ([https://forums.factorio.com/44786 more])
* Fixed locomotive tooltip would not show contents of fluid wagons. ([https://forums.factorio.com/44786 more])
=== Modding ===
* Prototype names are not allowed to contain the '.' character.
=== Scripting ===
* Fixed typo in defines.shooting.shooting_selected (was "shooting_seleted"). ([https://forums.factorio.com/44965 more])
* Fixed type in defines.control_behavior.type.train_stop (was "train-stop"). ([https://forums.factorio.com/44965 more])
* Fixed the custom camera widget was using 0 based indexing for the surface_index parameter. ([https://forums.factorio.com/45189 more])
* Added missing control behavior types to defines (wall, mining_drill, programmable_speaker). ([https://forums.factorio.com/44939 more])
* Added <code>LuaTrain::fluid_wagons</code> read.

== 0.15.2 ==
Date: 25. 04. 2017
=== Changes ===
* Reduced wave defense biter power increase as more players join to reduce pathfinding performance drain. ([https://forums.factorio.com/44717 more])
* Tweaked the biter and uranium ore settings of the 'Rail world' preset.
* Changed mining drill fluidbox to allow fluid to flow to pipes without the use of pumps.
* Changed the "sync mods with save" button to support disabling mods a save file wasn't using.
* Computers with 2GB or more video memory and 8GB or more RAM will default graphics quality to high.
* Selecting high sprite quality in graphics options will show warning if computer doesn't have enough video memory.
=== Bugfixes ===
* Fixed tightspot campaign debt calculation. ([https://forums.factorio.com/44592 more])
* Fixed basic train tutorial rail setting offset. ([https://forums.factorio.com/44623 more])
* Fixed story script copying of assembling machines without recipes. ([https://forums.factorio.com/44612 more])
* Fixed crash when cycling through empty blueprint book. ([https://forums.factorio.com/44532 more])
* Fixed crash when the wrong fuel type was put into a burner equipment. ([https://forums.factorio.com/44600 more])
* Fixed <code>LuaFluidBox::get_capacity()</code> didn't work when the fluidbox was empty. ([https://forums.factorio.com/44658 more])
* Fixed <code>LuaFluidBox::get_capacity()</code> used 0-based indexing. ([https://forums.factorio.com/44653 more])
* Fixed blueprints with circuit wires would crash in some instances.
* Fixed the map would render black if the game was resized immediately after loading a large save file.
* Fixed that the technology cost multiplier allowed a value of 0.
* Fixed crash when circuit connector sprites aren't defined for a given entity. ([https://forums.factorio.com/44640 more])
* Fixed crash when inactive mining drills are disconnected from the circuit network. ([https://forums.factorio.com/44628 more])
* Fixed that the programmable speaker wouldn't save settings correctly when exported as a string in blueprints. ([https://forums.factorio.com/44701 more])
* Fixed crash when the base mod is disabled and no other mod defines map-settings. ([https://forums.factorio.com/44672 more])
* Fixed fluids consumed in the mining drill for mining resources didn't get counted in fluid production statistics. ([https://forums.factorio.com/44745 more])
* Fixed crash after display reset when browse multiplayer GUI was opened. ([https://forums.factorio.com/44704 more])
* Fixed browse games GUI sorting. ([https://forums.factorio.com/44519 more])
* Fixed wave defense GUI error. ([https://forums.factorio.com/44696 more])
* Fixed transport belt walking sound being controlled by the wrong volume slider. ([https://forums.factorio.com/44714 more])
* Fixed exiting tutorial would mute game sounds. ([https://forums.factorio.com/44524 more])
* Fixed crash when hovering over train with invalid path. ([https://forums.factorio.com/44787 more])
* The "Kovarex enrichment process" is no longer usable with productivity modules. ([https://forums.factorio.com/44635 more])
* Fixed alternative zoom would cause crash when bound to keyboard instead of mouse. ([https://forums.factorio.com/44571 more])
* Fixed that train stop would output circuit network signals with train contents regardless of it's parameters.
* Fixed possible desync related to train stops connected to circuit network.
* Fixed the exchange string wouldn't get cleared when clicking the reset button in the generate map GUI. ([https://forums.factorio.com/44774 more])
* Fixed crash when executing commands ban/unban/bans in a single player game. ([https://forums.factorio.com/44783 more])
* Fixed that opening another player's blueprint book though the /open command would crash the game. ([https://forums.factorio.com/44669 more])
* Fixed possible desync related to constant combinator filters.
* Fixed tooltip delay option didn't work. ([https://forums.factorio.com/44756 more])
* Fixed that disconnecting of electric poles hid some of the electric network visualizations on the map. ([https://forums.factorio.com/44721 more])
* Fixed crash when closing window on splash screen. ([https://forums.factorio.com/44757 more])
* Fixed that steam wouldn't show up as steam in fluid wagons. ([https://forums.factorio.com/44637 more])
* Fixed inactivity wait condition didn't work properly with fluid wagon. ([https://forums.factorio.com/44657 more])
* Fixed name of train field in on_train_created event. ([https://forums.factorio.com/44838 more])
* Fixed the technology list scrollbar position reset after clicking any technology.
* Fixed that LuaFluidBox would ignore the temperature field when setting a new fluid. ([https://forums.factorio.com/44842 more])
* Fixed crash when using recipes in furnaces that don't produce the exact amount of output items as the furnace output slots. ([https://forums.factorio.com/44707 more])
* Fixed crash when loading some older save files in 0.15 related to modded recipes. ([https://forums.factorio.com/44852 more])
* Fixed crash due to "Construction robot is in invalid state". ([https://forums.factorio.com/44817 more])
* Fixed game hang when connecting train in a loop ([https://forums.factorio.com/44666 more])

== 0.15.1 ==
Date: 24. 04. 2017
=== Changes ===
* Reduced noise effect on zoom-to-world view.
=== Bugfixes ===
* Fixed update error.
* Fixed Steam config loading error.
* Fixed headless not starting without server-settings.json ([https://forums.factorio.com/44537 more])
* Fixed the "reset" button in the generate map GUI wouldn't reset settings to the actual default values. ([https://forums.factorio.com/44527 more])
* Fixed that right clicking icon in the tag edit gui crashed the game. ([https://forums.factorio.com/44541 more])

== 0.15.0 ==
Date: 24. 04. 2017
=== Major Features ===
* Research overhaul. 4 new science packs: Military, Production, High-tech and space.
** Space science packs are generating by launching a rocket.
** Added infinite researches.
* Nuclear power.
* Blueprint library: Allows for keeping players blueprints between individual game saves and allows sharing blueprints in multiplayer games.
* Added infinite mining productivity research, each tier increases mining productivity by 2%.
* Added wagon for transporting fluids.
** One side of pump can connect to the fluid wagon, the other side has to be connected to something else.
* Mini tutorials. Small missions that explain some of the game mechanics. The current content is a testing sample and it only covers trains.
** Features:
* Map Interaction improvements:
** Selectable map overlays: logistics networks, pollution, electric network, turret range, etc.
** Train stations and trains can be opened by clicking them while in the map view.
** Zoom to the world view from the map. It only shows parts of the map covered by radar or other players though.
** Custom map markers can be added by the players.
* When dying in multiplayer you leave behind a body with your items that slowly degrades.
* Fuel type now affects vehicle acceleration and top speed.
* Added coal liquefaction oil processing recipe.
* Added Pipette Tool. Picks up items from your inventory used to build the currently selected entity.
** For resources it will select the fastest available resource extractor.
* New scenarios: PvP and Wave defense.

=== Minor Features ===
* Added map-settings command line option when creating map, it can be used to specify a file with map settings to be used instead of the defaults.
* Added preset command line option when creating map.
* Fast in game interactions like fast inserting into/from entity and copy paste can be done by dragging instead of having to click one at a time.
* Build-by-moving for electric poles now accounts for covering all unpowered entities on the way.
* Fast replacing input piece of underground belt will also fast replace output piece if possible.
* Added support for setting player color from the /color command using Lua syntax: {r=...g=...,b=...,a=...}
* Added warning for situation when robots don't have storage place to put items in the logistics network.
* Pumps show their direction in the detailed view.
* Belts and pipes show correct connections when building a blueprint.
* Technologies show the required science packs below the icons in the technology GUI list.
* Technologies are sorted by the science packs needed.
* Added /screenshot command - takes a screenshot of your current game screen.
* Added support for equipment grids in the map editor.
* The build rotation of each blueprint is remembered independently of the general item build rotation.
* Infinite resource minimal yield is calculated using the initial resource amount and the prototype minimum yield.
* Added optional filters to the deconstruction planner.
* Copying from assembling machines to filter inserters will set the filters to the ingredients of the assembling machine recipe.
* Combat robots and construction robots are maintained between sessions in multiplayer and when changing surfaces.
* Added reverse-rotate.
* Offshore pump and generator show pumping speed/fluid usage.
* Alternative select with blueprints (shift + select) skips the blueprint setup GUI.
* Mining rails is disabled if mining starts with trains or gates.
* Toggle fullscreen using Alt + Enter.
* Added "f"/"force" option to the /players command
* Added Logistic networks GUI containing a list of all networks and contents with search (opened by the L key).
* Added /open command - opens another players inventory if you're an admin.
* Added /alerts command - configures alerts for your player.
* Added /mute-programmable-speaker command - disables global sounds created by the Programmable Speaker entity.
* Added /seed command - prints the map seed.
* Added fluids to the production GUI.
* Added kill statistics GUI.
* Added enable/disable all mods button to the mod manager GUI.
* Added automatic barreling support for all fluids.
* Cargo wagons can have settings copied from any distance like Locomotives.
* Added the ability to auto-launch the rocket.
* Train stops can be colored like trains.
* Fish can be collected by robots.
* Extended map generator settings to include an advanced section.
* Added map generator presets.
* Show fog-of-war and radar radius when holding radar in cursor.
* Seed for map creation on the headless server can be specified via map-gen-settings.json
* Damaged items merge into one stack, the health of the stack will be the average of the items.
* Added server whitelist support -- see the /whitelist console command.
* Added /banlist command to operate on the banlist, in addition to the pre-existing /ban and /unban commands.
* Added "favourite" feature in public games list: Keep your favourite servers at the top of the list.
* Added /permissions command for managing permissions in a multiplayer game.
* Added ability to change individual inserter stack size bonuses through GUI or the circuit network.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Server console will print JOIN and LEAVE messages for players joining or leaving.
* Server console messages that aren't a part of the main log can be logged separately by running the server with the <code>--console-log</code> option.
* Translatable energy units and SI prefixes (eg. "100 ГВт").
* Furnaces and assembling machines show the amount of products finished.
=== Graphics ===
* Added high graphics quality option. In this settings the following list of things will have double resolution:
** Car, Trains, Rails, Rail signals, Train stop, Transport belts, Underground belts, Splitters, Pipes, Steam engine, Assembling machines, Oil refinery, Chemical plant,
** Mining drill, Furnaces, Resources
* New ore graphics that makes the ore patches look less tiled.
* Tweaked the GUI graphics.
* Decreased the size of the recipe icons on assembling machine by 23%.
=== Balancing ===
* Increased the rate at which resources grow with distance from the center by 50%.
* Crude oil balancing: Halved the resource amount on the map
** Increased the minimum yield from 10% to 20%
** Halved the rate of depletion.
** Doubled the starting yield.
** Fixed that the mechanics of increasing richness with distance from start wasn't working for crude oil.
* Increased module inventory size of Chemical plant and oil refinery from 2 to 3.
* Increased logistic slot/trash slot count from 5 per level to 6 per level.
* Removed processing unit from the modular armor and portable solar panel recipe.
* Increased the pump pumping speed 4 times.
* Reduced the plastic bar recipe requirement of petroleum gas 30 -> 20
* Reduced the electric engine recipe requirement of lubricant 20 -> 15
* Reduced the electric furnace recipe requirement of steel 15 -> 10
* Reduced the steel furnace recipe requirement of steel 8 -> 6
* Reduced the pumpjack recipe requirement of steel 10 -> 5
* Reduced crafting time:
** Engine unit + electric engine unit: 20 -> 10
** Pumpjack 10 -> 8
** Advanced circuit 8 -> 6
** Processing unit 15 -> 10
** Cracking recipes 5 -> 3
* Increased stack size of stone wall pipe and belts 50 -> 100
* Increased the maximum power production of steam engine from 510kW to 900kW
* Doubled the heat capacity of water from 0.1kJ per degree per liter to 0.2kJ.
* Increased the substation supply area (16X16 to 18X18) and wire reach (16 to 18).
** Combat Balancing:
* Player regains health at a much higher rate, but only after being out of combat for 10 seconds.
* Discharge defense equipment pushes back, stuns and damages nearby enemies when activated by the remote.
* Decreased the size of Discharge defense equipment from 3x3 to 2x2.
* Greatly increased the damage of Personal Laser Defense Equipment.
* Flamethrower gun has a minimum range of 3.
* The flames created on ground from the flamethrower significantly increase in duration and damage when more fuel is added to them by firing at the same spot.
* Increased fire resistance of biter bases.
* Increased the health of player non-combat buildings.
* Increased player health from 100 to 250.
* Increased collected amount and effectiveness of Fish.
* Increased the damage, range and health of biters worms.
* Decreased health and resistance of Behemoth biters.
* Doubled the stack size of all ammos.
* Tweaked the cost and crafting time of some ammos.
* Increased the damage of most player ammos. Greatly increased the damage and fire rate of Rockets and Cannon Shells.
* Increased the collision box of Cannon Shells.
* Increased Tank health and resistances.
* Added research for Tank Cannon Shells damage and shooting speed.
* Tweaked research bonuses and added more end-game research for military upgrades.
* Greatly increased the damage of Mines. They also stun nearby enemies when they explode.
* Added uranium rounds magazine and uranium cannon shells.
* Added flamethrower to the tank.
* Other minor changes.
=== Optimisations ===
* Improved performance of mining drills in general and significantly improved performance when mining drills get backed up.
* Improved performance when tiles are changed due to migration/mod removal.
* Significantly improved GUI performance for inventories that required scroll bars.
* Improved GUI performance in general.
* Improved performance of radars scanning chunks.
* Improved map generation speed and generation algorithm.
* Improved game load performance when a large amount of mod data exists in the save.
* Optimized graph rendering in production statistics window.
* Improved regenerate entity performance.
* Improved network map transfer performance.
* Improved train performance when building/mining rail related entities.
* Optimized memory requirements for storing tiles under concrete.
=== Circuit Network ===
* Significantly improved circuit network performance. Up to 25 times less CPU usage and 10% less memory usage.
* Added the Programmable Speaker: it shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
* Train Stop can output the contents of the stopped train's cargo.
* Train Stop can be disabled using the circuit network. Trains will skip disabled Train Stops, allowing simple train control.
* Mining Drills can be turned on and off using the circuit network. They can also output the remaining expected resources.
* Pumpjacks can be turned on and off using the circuit network. They can also output the current oil mining rate.
* Added Modulo, Power, Left Bit Shift, Right Bit Shift, Bitwise AND, Bitwise OR and Bitwise XOR to the Arithmetic Combinator.
* Added >=, <=, != to the Decider Combinator and Circuit Conditions.
=== Changes ===
* Configuration has been reset.
* Boilers are more powerful and bigger and have dedicated output for the steam.
** Default boilers output steam at the fixed temperature 165.
* Removed support of 32 bit systems.
* Removed alien artifacts and alien science packs from the game completely.
* Changed bounding box of burner mining drills and pumpjack, so it is possible to walk in between them.
* Disabled loading of saves before 0.12.0 version (You can use 0.12 to load older saves and re-save them).
* Changed "small pump" to "pump". Small pumps in old saves will be migrated but they will be misaligned and disconnected from pipes.
* Train station adds 2000 tiles penalty when path finding, so trains try to avoid stations not related to their path.
* The map seed is used to generate unique maps instead of just shifting the starting position.
* The "decorative" entity type has been deprecated and replaced with the prototype type "optimized-decorative".
* Multiplied all fluid amounts by 10.
* All default map editor actions are now on left click.
* Change fluidbox height and base level of boiler, steam engine and pump to improve fluid flow.
* When the active train stop is removed trains will immediately leave the station if they're waiting at the station.
* Changed the default comparison type for train conditions to "or".
* Fast replacing splitters maintains the splitter contents on the new splitter instead of returning it to the player.
* Research started/changed notifications are only shown when in multiplayer.
* Crafting is now paused when the results can't be given to the player instead of spilling them on the ground.
* Changed evolution from global to per force.
* Disabled mining of vehicles other players are driving.
* Decreased biter sounds volumes
* Laser turret projectiles move much faster
* Roboport construction area changed from 50 to 51 to allow roboports build/deconstruct each other even when there is a 1 tile gap between their logistic areas.
* Restart button now uses map generation settings from currently loaded save.
* New rocket silo GUI and visibility button for freeplay and sandbox scenarios.
* Unified internal name of the 'flame-thrower' to 'flamethrower'.
* Manual ghost building will mark trees/rocks for deconstruction similar to alt-building blueprints.
* Trains are now always visible on the map, not only on chunks observed by radars or players.
* Renamed "armor-making-2" to "heavy-armor".
* Renamed "armor-making-3" to "power-armor".
* Renamed "diesel-locomotive" to "locomotive".
* Increased blueprint book size to hold 1000 blueprints
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.
* Added combinator working, wire hold and wire place sounds.
* Single player can be continued when you die.
=== Modding ===
* Fast cropping of sprite boundaries - it's no longer necessary to delete crop-cache.dat when existing sprites are modified.
* Utility sprites are now defined fully in the core mod prototypes.
* Added support for burner type generator-equipment.
* Added "simple-entity-with-force" and "simple-entity-with-owner" entity types.
* Boiler has now dynamically specified energy source (as inserter and similar).
* Added support for mod settings: startup, runtime, and runtime-per-user.
* Added commandline option <code>--check-unused-prototype-data</code>
* Added a "nothing" technology modifier type with an "effect_key" property for script-based-effect research.
* Redundant technology prerequisites are logged when verbose logging is enabled.
* Changed technology prototype icon_size to default to 32 instead of 64.
* In any instance an icon isn't 32x32 the icon_size property must be set to the actual size of the (square) icon.
* Added the ability to have "friend" forces. Friend forces are given unrestricted access to buildings and won't be attacked.
* Changed container entities to not scale info icons by default + added the optional prototype property "scale_info_icons" to enable scaling.
* Added property "turret_base_has_direction" to turret entity types. Set it to true if you want to use turn_range property in turret attack_parameters.
** This property has to be true for any fluid-turret, because of pipe connections.
* Added support for different recipe and technology complexity definitions.
* Added "item-with-tags" item type that can store any basic arbitrary Lua data.
* Lamps, roboports, walls, rail signals, and accumulators now accept any signal type (item, fluid, virtual).
* "animation_speed" property of animation definitions has to be greater than 0.
* Renamed smoke-with-trigger "action_frequency" property to "action_cooldown".
=== Scripting ===
* Added "by_script" to on_research_finished.
* Added "cause" to on_entity_died - the entity that did the killing if available.
* Added "recipe" to on_player_crafted_item.
* Added "rocket_silo" to the rocket launched event.
* Added 4th custom gui root position "goal", which is used in the objectives.
* Added column_alignments settings in table style.
* Added LuaBurner - readable off entities and equipment - the burner energy source for the entity.
* Added <code>LuaCircuitNetwork::network_id</code> read.
* Added <code>LuaConstantCombinatorControlBehavior::signals_count</code> read + set_signal and get_signal.
* Added <code>LuaControl::shooting_state</code>, repair_state, picking_state read/write.
* Added LuaCustomChartTag + LuaForce API to add/find them.
* Added LuaDecorativePrototype.
* Added <code>LuaEntity::connect_rolling_stock</code> and disconnect_rolling_stock methods.
* Added <code>LuaEntity::get_logistic_point()</code>.
* Added <code>LuaEntity::graphics_variation</code> read/write for simple entities and trees.
* Added <code>LuaEntity::shooting_target</code> read/write for turrets.
* Added <code>LuaEntity::stickers</code> read. The stickers attached to a given entity.
* Added <code>LuaEntityPrototype::crafting_speed</code> read.
* Added <code>LuaEntityPrototype::drawing_box</code>, sticker_box, flags, remains_when_mined, additional_pastable_entities, allow_copy_paste, shooting_cursor_size, created_smoke, created_effect, map_color, friendly_map_color, enemy_map_color, build_base_evolution_requirement read.
* Added <code>LuaEntityPrototype::get_inventory_size()</code>.
* Added <code>LuaEntityPrototype::ingredient_count</code> read.
* Added <code>LuaEntityPrototype::module_inventory_size</code> read.
* Added <code>LuaEquipmentGrid::get_contents</code>, shield, and max_shield.
* Added <code>LuaFluidBox::owner</code> read + get_capacity and get_connections methods.
* Added <code>LuaForce::evolution_factor</code>.
* Added <code>LuaForce::is_chunk_visible()</code>.
* Added <code>LuaForce::set_friend</code>/get_friend.
* Added <code>LuaGui::children</code> read.
* Added LuaGuiElement drop-down type.
* Added LuaGuiElement type "camera".
* Added LuaGuiElement type "choose-elem-button".
* Added <code>LuaGuiElement::children</code> read.
* Added <code>LuaGuiElement::clear</code> to remove all the contents of the element.
* Added <code>LuaGuiElement::single_line</code> and want_ellipsis for the CustomLabel type.
* Added <code>LuaInventory::entity_owner</code>, player_owner, and equipment_owner read.
* Added LuaItemPrototype fuel_category, burnt_result, fuel_acceleration_multiplier, fuel_top_speed_multiplier read.
* Added <code>LuaLogisticNetwork::provider_points</code>, empty_provider_points, requester_points, full_or_satisfied_requester_points, and storage_points read.
* Added LuaLogisticPoint - read access to logistic data about provider, storage, and requester points.
* Added <code>LuaPlayer::add_alert</code>, remove_alert, and get_alerts.
* Added <code>LuaPlayer::mute_alert</code>, unmute_alert, is_alert_muted, enable_alert, disable_alert, is_alert_enabled.
* Added <code>LuaPlayer::opened</code> write.
* Added <code>LuaPlayer::opened_gui_type</code> read.
* Added LuaRandomGenerator.
* Added <code>LuaSurface::destroy_decoratives</code> and <code>LuaSurface::create_decoratives</code>.
* Added <code>LuaSurface::find_logistic_networks_by_construction_area</code>(..).
* Added <code>LuaSurface::get_trains()</code> and <code>LuaForce::get_trains()</code>.
* Added <code>LuaSurface::regenerate_decorative()</code>.
* Added <code>LuaTrain::has_path</code>, path_end_rail, and path_end_stop read + recalculate_path().
* Added <code>LuaTransportLine::operator</code>[] and operator#.
* Added Mod gui script for easy consistent styling of mod buttons and frames within the game.
* Added mouse info to the gui clicked event.
* Added on_biter_base_built - fires when biters build bases during migration.
* Added on_entity_renamed - fires when an entity is renamed either by the player or through script.
* Added on_gui_selection_state_changed - fires when an item in a drop-down gui element is selected.
* Added on_market_item_purchased - fires when a player purchases something from a market entity.
* Added on_player_changed_force - fires when a players force is changed.
* Added on_player_dropped_item - fires when a player drops an item that results in an item-on-ground entity.
* Added on_player_mined_entity and on_robot_mined_entity events.
* Added on_runtime_mod_setting_changed event - fires when a player changes runtime mod settings.
* Added on_selected_entity_changed - fires when the selected entity for a player changes.
* Added on_surface_deleted, on_pre_surface_deleted, and on_surface_created events.
* Added on_train_created event.
* Added optional "surface" to <code>LuaForce::chart_all()</code>.
* Added optional fields "durability" and "ammo" when using SimpleItemStack definitions.
* Added optional parameter "return_item_request_proxy" to <code>LuaEntity::revive</code>. If true and revive creates item request proxy, the proxy will be returned as the third value.
* Added player_index to the entity settings pasted events.
* Added remote interface functions for the rocket silo gui: add_tracked_item, remove_tracked_item, get_tracked_items, update_gui
* Added remote interface to freeplay and sandbox scripts.
* Added support for full copying LuaItemStack in most places that take the SimpleItemStack type.
* Added support for LuaFlowStatistics read on electric poles.
* Added support for specifying the "max_range" of a projectile when created through create_entity.
* Added support for turret orientation read/write through <code>LuaEntity::orientation</code>.
* Added the ability for mods to register commands.
* Added the ability to read item_requests from item request proxy entities as well as ghosts.
* Added the ability to read reach distances off the player or character entity.
* Changed less_then to less_than in lua GUI progress bar style specification. ([https://forums.factorio.com/33196 more])
* Changed <code>LuaEntity::item_requests</code> to match the docs format.
* Changed <code>LuaEntity::passenger</code> to work with both character entities and players.
* Changed <code>LuaEntityPrototype::underground_belt_distance</code> to <code>LuaEntityPrototype::max_underground_distance</code> and changed it to work on both underground pipes and underground belts.
* Changed <code>LuaForce::clear_chart()</code> to take an optional surface to clear the chart for.
* Changed <code>LuaSurface::create_entity</code>{name="item-on-ground", stack=...} to accept the same format for item stacks as the rest of the Lua API.
* Changed the player built event to include the item name used to do the building if possible and include the tags from the "item-with-tags" item if possible.
* Changed <code>LuaPlayer::clean_cursor</code> to return true if the cursor is now empty.
* Expanded LuaStyle read/write property support.
* Fixed <code>LuaSurface::spill_item_stack</code> didn't interpret "enable_looted" parameter properly. ([https://forums.factorio.com/38717 more])
* <code>LuaForce::reset()</code> now resets everything about the force to the default state.
* Mod events are now fired by the mod dependency order instead of the mod name starting with the scenario script.
* Moved game.get_event_handler and game.raise_event to "script".
* Removed Lua.coroutine due to potential exploits.
* Removed <code>LuaGameScript::evolution_factor</code>.
* Removed <code>LuaGameScript::save</code>/load.
* Removed <code>LuaPlayer::build_from_cursor</code> + <code>LuaPlayer::rotate_for_build</code> as they aren't replay/MP safe.
* Removed <code>LuaSurface::get_tileproperties</code>.
* Removed <code>LuaForce::item_resource_statistics</code> and <code>LuaForce::fluid_resource_statistics</code> - they've been merged into the production versions.
* The goal and left gui element has default direction vertical.
* Utility sprites can be used in the sprite button.
=== Bugfixes ===
* Fixed that setting <code>LuaForce::ai_controllable</code> to false wouldn't prevent pollution-based unit group formation. ([https://forums.factorio.com/35650 more])
* Fixed graphics settings UI scale would change just by opening the GUI. ([https://forums.factorio.com/35588 more])
* Fixed UAC prompt would cause error and application termination during sprite loading on Windows. ([https://forums.factorio.com/35157 more])
* Fixed map generation could in some instances not correctly generate entities.
* Fixed crash when regenerating entities that are disabled by map generator settings ([https://forums.factorio.com/31872 more])
* Attempt to fix an occasional crash when DNS lookup fails ([https://forums.factorio.com/37426 more])
* Fixed crash when ammo was consumed fully by script during shooting. ([https://forums.factorio.com/38701 more])
* The Equipment Grid GUI is now scaled with the rest of the UI. ([https://forums.factorio.com/38979 more])
* Fixed possible crash caused by improper primary display detection. ([https://forums.factorio.com/39167 more])
* Fixed occasional broadcast related crashes on OSX ([https://forums.factorio.com/39250 more])
* Fixed building train vehicle in a way, that it connects on both sides. ([https://forums.factorio.com/37645 more])
* Fixed entities with efficiency modules wouldn't consume the correct amount of energy in some cases. ([https://forums.factorio.com/38884 more])
* Fixed problems when clicking connect button in server list too fast ([https://forums.factorio.com/38240 more])
* Fixed crash when removing large-tiles from a tile prototype definition. ([https://forums.factorio.com/39586 more])
* Fixed crash when mod created exoskeleton equipment with zero energy consumption. ([https://forums.factorio.com/39631 more])
* Fixed electric pole would draw wires to invisible ghost of enemy force. ([https://forums.factorio.com/38641 more])
* Fixed crash when refreshing in the browse mods GUI in some instances. ([https://forums.factorio.com/39032 more])
* Fixed crash when clicking the same tick the map is loaded. ([https://forums.factorio.com/39713 more])
* Fixed <code>LuaGameScript::get_event_handler</code> not working. ([https://forums.factorio.com/39959 more])
* Fixed desync when demoting every player on a server. ([https://forums.factorio.com/40062 more])
* Fixed desync caused by incorrect sorting of items with inventories (blueprint books) in player's inventory. ([https://forums.factorio.com/41159 more])
* Fixed crash when respawning player who had any requests in personal logistic slots and was transfered to a force without logistic slots technology researched while waiting for respawn. ([https://forums.factorio.com/41171 more])
* Fixed <code>LuaSurface::create_entity</code>{fast_replace=true} would end up deleting items in some instances. ([https://forums.factorio.com/41328 more])
* Fixed extremely slow deleting of selection in text fields. ([https://forums.factorio.com/41638 more])
* Fixed save corruption when saving while character is in vehicle with equipment grid and roboport equipment while destructor bots are deployed.
* Fixed rail integrity error when train crashes into itself. ([https://forums.factorio.com/38046 more])
* Fixed virtual signals wouldn't be sorted correctly by subgroup. ([https://forums.factorio.com/42558 more])
* Fixed typing in the save-replay GUI could move your player around. ([https://forums.factorio.com/39858 more])
* Fixed that manually created unit groups wouldn't be automatically removed when all their members died. ([https://forums.factorio.com/42903 more])
* Fixed crash when trying to make an entity ghost of an invalid entity through script. ([https://forums.factorio.com/43467 more])
* Fixed rail signals not reconnect after removing rails in some setups. ([https://forums.factorio.com/41005 more])
* Fixed trains switched to manual mode wouldn't trigger inserters when they coasted to a stop. ([https://forums.factorio.com/43160 more])
* Fixed lot of entities on the same tile might cause stack overflow crash when saving the map. ([https://forums.factorio.com/43610 more])
* Underground belt connects only to underground belt of the same force.
* Fixed personal roboport ended search for nearby ghosts prematurely if a ghost found couldn't be built due to missing item. ([https://forums.factorio.com/44179 more])
* Fixed desync related to teleporting any entity with emissions-per-tick defined in the prototype. ([https://forums.factorio.com/44344 more])
* Fixed explicitly placed crafting orders were sometimes used to satisfy dependency of other crafting orders.

{{VersionNav}}

Map generator

2020-02-17T21:57:27Z

Justarandomgeek: /* Starting area */ typo fix

{{Languages}}
[[File:Default_123456789.png|thumb|right|An example how the world generator might create a new map: Default settings with map seed 123456789]]
World generation is the procedure by which the in game landscape is generated. In short: a number of settings, editable at the start of a new world, define what that world will look like. This can dramatically alter gameplay — a new player is advised to start with the default settings before deciding to change their world.
__TOC__{{Clear}}
== Map generation presets ==
[[File:MapGeneratorOverview.png|thumb|right|400px|Overview of the map generation screen]]
A preset may be chosen in the top left dropdown instead of manually configuring the generation.
=== Default ===
Normal settings. The recommended way to play Factorio.

All sliders are set to the center position. Map height and width is unlimited, peaceful mode is disabled.

All other settings are set to their defaults:
{| class="wikitable"
|-
! Enemy expansion !! Default !! Evolution !! Default
|-
| Enabled || Yes || Enabled || Yes
|-
| Maximum expansion distance || 7 || Time factor || 40
|-
| Minimum group size || 5 || Destroy factor || 200
|-
| Maximum group size || 20 || Pollution factor || 9
|-
| Minimum cooldown (Minutes) || 4
|-
| Maximum cooldown (Minutes) || 60
|-
|}

{| class="wikitable"
|-
! Pollution !! Default !! Recipes/Technology !! Default
|-
| Enabled || Yes || Recipe difficulty || Normal
|-
| Absorption modifier || 100% || Technology difficulty || Normal
|-
| Attack cost modifier || 100% || Technology price multiplier || 1
|-
| Minimum damage to trees || 60 || Research queue availability || After the game is finished
|-
| Absorbed per damaged tree || 10 ||
|-
| Diffusion ratio || 2% ||
|-
|}

=== Rich resources ===
Resources patches have a larger richness, so you don't have to expand far.

Difference from default: Resources have 200% richness instead of 100%.

=== Marathon ===
Recipes and technologies are more expensive.

Difference from default: Expensive recipes and technology, technology price multiplier 4.

=== Death world ===
Biters are more dangerous and evolve faster.

Difference from default: 200% enemy base frequency and 200% enemy base size, 75% starting area size, enemy evolution time factor is set to 200, pollution factor is set to 12. The pollution absorption modifier is set to 50% instead of 100%, same goes for the attack cost modifier.

=== Death world marathon ===
Recipes and technologies are expensive and biters are dangerous and plentiful. Only select this if you are a Factorio veteran.

Combines "Marathon" and "Death world" with some additional changes: Enemy evolution time factor is set to 150, pollution factor is set to 10. Attack cost modifier is set to 80% instead of 100% (50% for death world).

=== Rail world ===
Resource patches are large and spread far apart, to encourage train systems. Biters won't create any new bases or re-expand into cleared territory.

Difference from default: All resources are set to 33% frequency and 300% size. Water is set to 200% scale and 150% coverage. The evolution time factor is set to 20 from 40 and enemy expansion is disabled.

=== Ribbon world ===
The map height is limited to only 128 tiles, which introduces a range of challenges and interesting situations.

Difference from default: Map height is limited to 128. All resources are set to 300% frequency, 50% size and 200% richness. Water is set to 25% coverage and size. Starting area size is increased to 300%.

=== Island ===
A large island in an endless ocean.

Difference from default: Terrain map type is set to island.

== Manual configuration ==
It is possible experiment with different settings by opening the map preview, changing the settings and observing their effects. This makes it possible to directly observe what exactly particular settings modify in the world, beyond the textual descriptions provided on this page.

The seed is the starting value for the random number generator that Factorio uses for generating the world based on the generation settings. This means that even with the same generation settings, the world can look very different depending on the seed.

All resources and terrain features can be disabled by unchecking the checkbox in front of them.

=== Resources ===
Frequency determines the number of resource patches in a given area. It does not affect resource patch size or richness. A setting of 200% frequency that means roughly double the patches can be found in a given area.

The size setting adjusts the size of the resource patches. Setting the slider to 200% means the surface area of the patch is doubled.

Richness defines the yield of every ore tile and every oil field. If richness is set to 200%, each ore tile and oil field contains about double the amount of ore/oil. Outside of this, resource patch richness increases by distance.

=== Terrain ===
Setting the map type to island generates a single island around the spawn point and endless ocean beyond that. The normal map type generates endless terrain.

Water scale changes how much space there is between lakes. The smaller the scale, the swampier the terrain. Higher scale leads to bigger oceans separated by bigger landmasses. Water coverage influences the overall amount of water. Reducing it generates small lakes, increasing it generates large oceans.

The settings for trees behave in the same way. Higher scale increases the distance between forests while lower scale reduces it. High tree coverage allows to completely cover the world in trees, and low coverage nearly removes them from the world.

Cliff frequency influences how many cliff lines there are in the world. Higher frequency means more cliffs, lower frequency reduces their number. The continuity setting changes how long and unbroken the cliff lines are. Low continuity leads to very short lines, high continuity to long, nearly unbroken lines of cliffs.

The moisture settings control the distribution of grass versus desert. Higher bias generates more grass, lower bias generates more desert. Higher scale increases the size of the grass/desert areas, low scale leads to small grass and desert patches.

The terrain type setting controls the distribution of red desert versus sand. Higher bias generates more red desert, lower bias generates more sand. Higher scale increases the size of the red desert/sand areas, low scale leads to small red desert and sand patches.

=== Enemy ===
[[File:MapGeneratorEnemy.png|thumb|right|400px|The enemy tab]]
Frequency determines the number of enemy bases in a given area. It does not affect enemy base size. A setting of 200% frequency that means roughly double the enemy bases can be found in a given area.

The size setting adjusts the size of enemy bases. Setting the slider to 200% means the surface area covered by the enemy bases is doubled.

When peaceful mode is turned on, the [[enemies]] don't begin fights, only responding if the player hits them. Additionally, when a map is in peaceful mode, the enemies will not [[Enemies#Expansions|expand]].

The starting area is the an almost circular radius around the spawn point that does not contain enemy bases. Increasing its size pushes the bases further out, decreasing its size generates enemy bases closer to the spawn point. The size setting does not have any other effects.

[[Enemies#Expansions|Enemy expansion]] can be enabled/disabled and further adjusted using the below settings.

{| class="wikitable"
|-
! Enemy expansion setting !! Description
|-
| Maximum expansion distance || The maximum distance enemies will look to expand from other enemy bases.
|-
| Minimum group size || The minimum size of an enemy expansion party modified by the current evolution level.
|-
| Maximum group size || The maximum size of an enemy expansion party modified by the current evolution level.
|-
| Minimum cooldown (Minutes) || The minimum time between enemy expansions being sent out.
|-
| Maximum cooldown (Minutes) || The maximum time between enemy expansions being sent out.
|-
|}

[[Enemies#Evolution|Evolution]] can be enabled/disabled and further adjusted using the below settings.

{| class="wikitable"
|-
! Evolution setting !! Description
|-
| Time factor || Controls how fast evolution increases over time.
|-
| Destroy factor || Controls how fast evolution increases due to destroying enemy spawners.
|-
| Pollution factor || Controls how fast evolution increases due to producing pollution.
|-
|}

=== Advanced ===

The [[Replay system|replay]] can record all the actions that the player(s) perform during the game, so that they can later be played back as essentially a timelapse of the save file.

The map width and height allows to generate maps with finite resources and area. It is possible to limit generation in only direction, alike the [[#Ribbon world|ribbon world]].

The difficulty settings allow to change the [[Crafting#Recipe difficulties|recipe]]/technology difficulty and multiply the [[research|technology cost]]. Currently, setting the technology difficulty does not have an effect in vanilla. Furthermore, it can be controlled when the research queue is available: From the start, after launching a [[rocket silo|rocket]] or never.

[[Pollution]] can be enabled/disabled and further adjusted using the below settings.

{| class="wikitable"
|-
! Pollution setting !! Description
|-
| Absorption modifier || Modifier of how much pollution is absorbed by trees and tiles.
|-
| Attack cost modifier || Modifier of how much pollution is absorbed by enemy attacks.
|-
| Minimum damage to trees || Trees have 4 different stages of the progression towards being destroyed by pollution. Any pollution above this amount starts the process of moving a tree towards a more damaged stage.
|-
| Absorbed per damaged tree || Trees have 4 different stages of the progression towards being destroyed by pollution. This value specifies how much pollution is absorbed when moving to a more damaged stage.
|-
| Diffusion ratio || The amount of pollution diffused into neighboring chunks per second.
|-
|}

=== Map exchange string ===

A map exchange string generally looks like this:

>>>eNp1UTGIE0EU/WMu3F4EUUjhgR4prrDZJTlFJRyZURAR0d7Oz
WYiA5udOLsLnhaX4kptxEaraz3hOgu7wIEoKBxa2UVsLFROBC0U4
p+dnWSNdw/+583/f97/fwbgGLhAADGgAEPqzAXSD/HI8JRZJZD9P
leuVNyGtC0EKu1wV4qwGK3wiPfW3LYfc6NozBFKRv8qMFaOExnlE
WDPtrZoOVGcx3igxgb0cKr8SKQ9c1eL5aOSGIcebCxlNl6H2nisD
dkIC0YAtpIQjOWYOx7IKFEydGOeJCK61fTTO8228OMFt+416hqn9
ivpKn475VGw1uylYSL6oeDKqXtnNc6dnL3RkyJOUsUzZccKuweW7
ave8E5nKAeh6HYBahfQLuotCJB71e3LH+8+osTs5bGc7OWRYdtGr
lhynR2YWrbkTEHHdP9RIKZpgi3yKodNiUlu6CQhD74+3/z1crdF/
jz9/u5a+yYljUvVb3sr2y1MzusVDk3ck8caL+wqYDVHNE99oOTtG
40vlJT1jap27Dy64dUSkKNHkG3eR1c7AXa0lpWpMtLN8NNu8smS9
3R2D3yIVS2+pN0r7bKGk8lITm8wk1icZvHqChTbd6bLvbYddwqtZ
2b4/w+KK8xElgsPX9F9OhP3uTQZAl9wd96e2DorwRT4wTu/vYd/A
dl73Kk=<<<

The map exchange string can be used to share all map generation settings between different players. The player can paste the string (using {{Keybinding|ctrl|V}}) into the map exchange string field and the game will set the generation settings to the settings saved in the string, resulting in a complete copy of the map when generated.

The map exchange string can be retrieved from save files by going into the load game screen, selecting the desired map, clicking the map exchange string button in the upper right corner and copying the string from the window that pops up.

For a technical description of the map exchange string, see [[map exchange string format]].

== Mechanics ==

=== Starting area ===

There is a second internal starting area that is completely separate from the starting area that can be changed in the enemy settings tab. This starting area always has a constant size and affects the spawning of resources, cliffs and water directly at the spawn. The map generation logic makes sure that there is always at least one patch of [[coal]], [[iron ore]], [[copper ore]], and [[stone]] each. Furthermore, there is always a lake in the starting area, even when water is turned off, and there are never any cliffs there. [[Uranium ore]] and [[crude oil]] do not spawn in the starting area. The richness of the ore patches is slightly influenced by the frequency setting.[https://forums.factorio.com/viewtopic.php?p=432592#p432592]

=== Chunks ===

A map is endless by default, though its size can be limited by height and width — see above. Because it is technically endless, the whole map is not generated from the start. Instead, a new [[Map_structure#Chunk|chunk]] of the map is generated only when needed, similar to other procedurally generated world games.

==== Invisible chunks (fog of war) ====

Outside of the visible chunk area, an invisible area of about 3 chunks wide is generated as a preloading mechanism. Enemies may be located inside these invisible chunks and can attack the player from there, while [[artillery turret]]s and [[artillery wagon|wagon]]s may automatically shoot enemy bases in these chunks if they are within their automatic range. Invisible chunks are also generated if pollution is generated heavily; the game generates (invisible) chunks as it needs to spread the pollution into the area.

==== Charting (removing fog of war) ====

As long as a chunk is invisible, the part of the players map stays black. This changes when a chunk is [[Radar#Charting|charted]], which means when it is "touched" by a radar. This can be either the player's internal radar, which is always available and continually charts chunks around the player, or the [[radar]] entity. If a far-away and thus ungenerated chunk is charted, it will be generated, together with the above-mentioned invisible 3 chunk radius of map around it.

==== Maximum map size and used memory ====

The map size is limited to 2,000 x 2,000 kilometers; internally, this is a square 2,000,000 tiles on a side, with an area of 4,000,000,000,000 (4 trillion) square tiles (assuming 1 tile = 1 meter on a side yields 2,000 x 2,000 km = 4 million square km). In real-world terms, this is between the sizes of India and Australia (or about 40% the area of the United States, or over 10 times the area of Germany). It would take around 200 [[Time#Seconds|game-minutes]] (ca 3.3 hours real time) to reach that border from the center when riding a [[locomotive|train]] fueled with [[rocket fuel|rocket]] or [[nuclear fuel]]. This makes the world essentially endless for practical purposes. The generated chunks are fully mapped and stored in the player's RAM, which is the practical limiting factor of exploration.

Because chunks are only generated in and close around the area revealed by radar, it is possible to reach that border without overloading your computer, as the size of the map in computer memory is dependent only on chunks actually generated. If only a narrow stripe of land is explored to far away, this remains manageable.

== History ==

{{History|0.17.44|
* The resource frequency slider in the map generator settings has a smaller influence over the amount of ore in the starting area patches.
}}

{{History|0.17.0|
* Resource generation changed significantly:
** The starting area contains only iron, copper, coal and stone, in very predictable amounts. Uranium and oil are excluded from the starting area.
** Resource generation settings now have a much more dramatic effect. Increased the number of steps for each setting.
** Ore patches are slightly less frequent but richer.
** There will be a more balanced amount of resources within a large enough region.
** Many other small tweaks.
* Biter generation changed significantly:
** Biter richness slider removed, biter placement is only configured by size and frequency settings.
** Biter generation settings now have a much more dramatic effect. Increased the number of steps for each setting.
** Biter bases will increase in size, frequency and number of worms depending on the distance from player spawn.
** Worm size increases depending on the distance from player spawn.
** Small biter bases are now closer to the player spawn.
** At large distances from player spawn, biter base frequency is lower than before but biter bases are larger.
** Other small tweaks.
* Terrain generation changed significantly:
** Water is generated as large lakes instead of swamps.
** Tile generation improved. Tile placement respects biomes better.
** More predictable cliff placement.
** Better controls in the map generator GUI for water, tiles and cliffs.
* New map terrain type selectable: Island. Launch the rocket with only a limited amount of resources available on the map.
}}

{{History|0.16.0|
* Added cliffs.
* New terrains and new terrain generation.
* Trees can now be configured in the generate-map GUI.
* Terrain can be configured in the generate map GUI.
* Biters scale less with distance and there are generally less biters.
* No uranium as a starting resource also no uranium is ever generated near the starting area, you need to go look for it.
}}

{{History|0.15.0|
* Extended map generator settings to include an advanced section.
* Added map generator presets.
* The map seed is used to generate unique maps instead of just shifting the starting position.
}}

{{History|0.13.7|
* Map size is now limited to 2000 km by 2000 km with a black bar rather than crashing when reaching this distance.
}}

{{History|0.13.0|
* Map generator algorithm changed, further resource field now have greater richness.
}}

== See also ==

* [https://forums.factorio.com/viewtopic.php?f=6&t=7924&p=63517#p63517 Some technical info]
* [https://forums.factorio.com/viewtopic.php?f=6&t=8624&p=69156#p69156 Temperature based biome-model] (how trees are placed)

Lab

2020-01-20T20:20:15Z

Justarandomgeek: /* Equation simplification */ unneeded brackets

{{Languages}}
{{:Infobox:Lab}}
[[File:Simplescience.png|thumb|right|Science packs put into the front lab will be passed to labs behind it.]]
'''Labs''' are buildings that perform [[research]] for [[technologies]] by consuming [[science pack]]s. Use of a lab is required to progress in Factorio.

When [[productivity module]]s are used in labs, the productivity bonus is directly calculated and applied each [[Time#Ticks|tick]] so the productivity bar is simply cosmetic. This means that it does not matter that the productivity bar resets when the research is changed, no productivity bonus is lost. [https://forums.factorio.com/26860]

The player can only research one technology at a time, but can use multiple labs for faster results. The speed bonus of labs when [[lab research speed (research)|lab research speed]] is researched and modules are present can be calculated using this formula: <code>research_bonus × module_bonus = speed_bonus</code>; the percentage bonuses have to be converted to decimals (e.g. +140% = 2.4) before the formula is used.

==Production requirements==
Calculating the number of science packs needed per second is straightforward:
* <code>ERS = (1 + B[r] ÷ 100) × (1 + M[r] ÷ 100)</code>
* <code>ACT = T[r] ÷ ERS</code>
* <code>PPS = N ÷ ACT</code>

Where:
*'''''ERS''''' is "effective lab research speed"
*'''''B[r]''''' is the Lab Research Speed bonus as reported by the game, in percent
*'''''M[r]''''' is the sum of all module speed effects (Speed modules - positive; Productivity modules - negative), in percent
*'''''ACT''''' is "adjusted cycle time"
*'''''T[r]''''' is the research cycle time as displayed in the research screen
*'''''PPS''''' is "packs per second"
*'''''N''''' is the number of labs available.

Thus, for a 10-lab setup, researching Nuclear Power (30 second cycle time) with Lab Research Speed 4 (140% bonus) and no module effects, the calculation is:
*<code>ELRS = 1 + (140 ÷ 100) = 2.4</code>
*<code>ACT = 30 ÷ 2.4 = 12.5 s</code>
*<code>PPS = 10 ÷ 12.5 = 0.8</code>

This means 0.8 science packs per second, of each type, would need to be produced to continuously supply the labs.

=== Equation simplification ===
Assuming all labs have the same ''B[r]'' (which they always will unless they are affected by different module configurations), the above calculations can be combined into one equation:

* <code>PPS = N × (1 + B[r] ÷ 100) × (1 + M[r] ÷ 100) ÷ T[r]</code>

Thus for the numerical example:
* <code>PPS = 10 × (1 + 140 ÷ 100) × 1 ÷ 30</code> = <code>(10 ÷ 30) × (1 + 1.4)</code> = <code> (1 ÷ 3) × 2.4</code> = <code> 2.4 ÷ 3</code> = <code>0.8</code> packs per second

== History ==
{{history|0.15.12|
* Lab speed info in the description contains the researched speed bonus as well.}}

{{history|0.12.6|
* The research speed of a lab is now not dependent on its electricity consumption, and can be scripted.}}

{{history|0.12.0|
* Lab research is now continuous; Science packs now have progress bars.}}

{{history|0.9.2|
* Labs are now named after early access backers when built from [[blueprint]]s.}}

{{history|0.7.2|
* Changed the recipe of Lab to require 4 transport belts, down from 5.}}

{{history|0.7.0|
* Added support for modules to labs.}}

{{history|0.6.0|
* New graphics.
* Labs are dedicated to backers (displayed in entity info).}}

{{history|0.2.7|
* Contents of the Lab is now shown in the entity info. }}

{{history|0.1.0|
* Introduced }}

==See also==
* [[Electric system]]
* [[Crafting]]

{{ProductionNav}}
{{C|Producers}}

Lab

2020-01-20T20:12:44Z

Justarandomgeek: /* Equation simplification */ typo fix

{{Languages}}
{{:Infobox:Lab}}
[[File:Simplescience.png|thumb|right|Science packs put into the front lab will be passed to labs behind it.]]
'''Labs''' are buildings that perform [[research]] for [[technologies]] by consuming [[science pack]]s. Use of a lab is required to progress in Factorio.

When [[productivity module]]s are used in labs, the productivity bonus is directly calculated and applied each [[Time#Ticks|tick]] so the productivity bar is simply cosmetic. This means that it does not matter that the productivity bar resets when the research is changed, no productivity bonus is lost. [https://forums.factorio.com/26860]

The player can only research one technology at a time, but can use multiple labs for faster results. The speed bonus of labs when [[lab research speed (research)|lab research speed]] is researched and modules are present can be calculated using this formula: <code>research_bonus × module_bonus = speed_bonus</code>; the percentage bonuses have to be converted to decimals (e.g. +140% = 2.4) before the formula is used.

==Production requirements==
Calculating the number of science packs needed per second is straightforward:
* <code>ERS = (1 + B[r] ÷ 100) × (1 + M[r] ÷ 100)</code>
* <code>ACT = T[r] ÷ ERS</code>
* <code>PPS = N ÷ ACT</code>

Where:
*'''''ERS''''' is "effective lab research speed"
*'''''B[r]''''' is the Lab Research Speed bonus as reported by the game, in percent
*'''''M[r]''''' is the sum of all module speed effects (Speed modules - positive; Productivity modules - negative), in percent
*'''''ACT''''' is "adjusted cycle time"
*'''''T[r]''''' is the research cycle time as displayed in the research screen
*'''''PPS''''' is "packs per second"
*'''''N''''' is the number of labs available.

Thus, for a 10-lab setup, researching Nuclear Power (30 second cycle time) with Lab Research Speed 4 (140% bonus) and no module effects, the calculation is:
*<code>ELRS = 1 + (140 ÷ 100) = 2.4</code>
*<code>ACT = 30 ÷ 2.4 = 12.5 s</code>
*<code>PPS = 10 ÷ 12.5 = 0.8</code>

This means 0.8 science packs per second, of each type, would need to be produced to continuously supply the labs.

=== Equation simplification ===
Assuming all labs have the same ''B[r]'' (which they always will unless they are affected by different module configurations), the above calculations can be combined into one equation:

* <code>PPS = N × (1 + [B[r] ÷ 100]) × (1 + M[r] ÷ 100) ÷ T[r]</code>

Thus for the numerical example:
* <code>PPS = 10 × (1 + [140 ÷ 100]) × 1 ÷ 30</code> = <code>(10 ÷ 30) × (1 + 1.4)</code> = <code> (1 ÷ 3) × 2.4</code> = <code> 2.4 ÷ 3</code> = <code>0.8</code> packs per second

== History ==
{{history|0.15.12|
* Lab speed info in the description contains the researched speed bonus as well.}}

{{history|0.12.6|
* The research speed of a lab is now not dependent on its electricity consumption, and can be scripted.}}

{{history|0.12.0|
* Lab research is now continuous; Science packs now have progress bars.}}

{{history|0.9.2|
* Labs are now named after early access backers when built from [[blueprint]]s.}}

{{history|0.7.2|
* Changed the recipe of Lab to require 4 transport belts, down from 5.}}

{{history|0.7.0|
* Added support for modules to labs.}}

{{history|0.6.0|
* New graphics.
* Labs are dedicated to backers (displayed in entity info).}}

{{history|0.2.7|
* Contents of the Lab is now shown in the entity info. }}

{{history|0.1.0|
* Introduced }}

==See also==
* [[Electric system]]
* [[Crafting]]

{{ProductionNav}}
{{C|Producers}}

Blueprint string format

2019-11-20T16:56:39Z

Justarandomgeek: cargo wagon inventories and cargowagon/loco orientation

{{Languages}} [[Category:Technical]]
This is a technical description of the blueprint string format, used to share blueprints with other users.

A blueprint string is a JSON representation of the blueprint, compressed with zlib deflate using compression level 9 and then encoded using base64 with a version byte in front of the encoded string. The version byte is currently 0 for vanilla 0.15, 0.16 and 0.17.
So to get the JSON representation of a blueprint from a blueprint string, skip the first byte, base64 decode the string, and finally decompress using zlib inflate.

== Json representation of a blueprint/blueprint book ==

The json representation of a blueprint or blueprint book is one large object inside another "wrapping" object, its key inside that object is either blueprint or blueprint-book.

=== Blueprint book object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint-book" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| blueprints
| The actual content of the blueprint book, array of objects containing an "index" key and 0-based value and a "blueprint" key with a [[#Blueprint object]] as the value.
| Array
|-
| active_index
| Index of the currently selected blueprint, 0-based.
| Integer
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Blueprint object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| entities
| The actual content of the blueprint, array of [[#Entity object]]s.
| Array
|-
| tiles
| The tiles included in the blueprint, array of [[#Tile object]]s.
| Array
|-
| icons
| The icons of the blueprint set by the user, array of [[#Icon object]]s.
| Array
|-
| schedules
| The schedules for trains in this blueprint, array of [[#Schedule object]]s.
| Array
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Icon object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| index
| Index of the icon, 1-based.
| Integer
|-
| signal
| The icon that is displayed, [[#SignalID object]].
| Object
|}

=== SignalID object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the signal prototype this signal is set to.
| String
|-
| type
| Type of the signal. Either "item", "fluid" or "virtual".
| String
|}

=== Entity object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_number
| Index of the entity, 1-based.
| Integer
|-
| name
| Prototype name of the entity (e.g. "offshore-pump").
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|-
| direction
| Direction of the entity, uint (optional).
| Integer
|-
| orientation
| Orientation of cargo wagon or locomotive, value 0 to 1 (optional).
| Floating Point
|-
| connections
| Circuit connection, object with keys starting from 1, values are [[#Connection object]]s (optional).
| Object
|-
| control_behaviour
|
| Object
|-
| items
| Item requests by this entity, this is what defines the item-request-proxy when the blueprint is placed, optional. [[#Item request object]]
| Object
|-
| recipe
| Name of the recipe prototype this assembling machine is set to, optional, string.
|String
|-
| bar
| Used by [[Prototype/Container]], optional. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based [[Types/ItemStackIndex]].
| Integer
|-
| inventory
| Cargo wagon inventory configuration, optional. [[#Inventory object]]
| Object
|-
| infinity_settings
| Used by [[Prototype/InfinityContainer]], optional. [[#Infinity settings object]]
| Object
|-
| type
| Type of the underground belt or loader, optional. Either "input" or "output".
| String
|-
| input_priority
| Input priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| output_priority
| Output priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| filter
| Filter of the splitter, optional. Name of the item prototype the filter is set to, string.
| String
|-
| filters
| Filters of the filter inserter or loader, optional. Array of [[#Item filter object]]s.
| Array
|-
| filter_mode
| Filter mode of the filter inserter, optional. Either "whitelist" or "blacklist".
| String
|-
| override_stack_size
| The stack size the inserter is set to, optional. [[Types/uint8]].
| Integer
|-
| drop_position
| The drop position the inserter is set to, optional. [[#Position object]].
| Object
|-
| pickup_position
| The pickup position the inserter is set to, optional. [[#Position object]].
| Object
|-
| request_filters
| Used by [[Prototype/LogisticContainer]], optional. [[#Logistic filter object]].
| Array
|-
| request_from_buffers
| Boolean. Whether this requester chest can request from buffer chests.
| Boolean
|-
| parameters
| Used by [[Programmable speaker]], optional. [[#Speaker parameter object]].
| Object
|-
| alert_parameters
| Used by [[Programmable speaker]], optional. [[#Speaker alert parameter object]]
| Object
|-
| auto_launch
| Used by the rocket silo, optional. Boolean, whether auto launch is enabled.
| Boolean
|-
| variation
| Used by [[Prototype/SimpleEntityWithForce]] or [[Prototype/SimpleEntityWithOwner]], optional. [[Types/GraphicsVariation]]
|
|-
| color
| Color of the [[Prototype/SimpleEntityWithForce]], [[Prototype/SimpleEntityWithOwner]], or train station, optional. [[#Color object]].
| Object
|-
| station
| The name of the train station, optional.
| String
|}

=== Inventory object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| filters
| Array of [[#Item filter object]]s.
| Array
|-
| bar
| The index of the first inaccessible item slot due to limiting with the red "bar". 0-based, optional. [[Types/ItemStackIndex]].
| Integer
|}

=== Schedule object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| schedule
| Array of [[#Schedule Record object]]s.
| Array
|-
| locomotives
| Array of entity numbers of locomotives using this schedule.
| Array
|}

=== Schedule Record object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| station
| The name of the stop for this schedule record.
| String
|-
| wait_conditions
| Array of [[#Wait Condition object]]s.
| Array
|}

=== Wait Condition object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| type
| One of "time", "inactivity", "full", "empty", "item_count", "circuit", "robots_inactive", "fluid_count", "passenger_present", "passenger_not_present".
| String
|-
| compare_type
| Either "and", or "or". Tells how this condition is to be compared with the preceding conditions in the corresponding wait_conditions array.
| String
|-
| ticks
| Number of ticks to wait or of inactivity. Only present when type is "time" or "inactivity". Optional.
| uint
|-
| condition
| CircuitCondition Object, only present when type is "item_count", "circuit" or "fluid_count".
| Object
|}

=== Tile object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Prototype name of the tile (e.g. "concrete")
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|}

=== Position object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| x
| X position within the blueprint, 0 is the center.
| Floating point
|-
| y
| Y position within the blueprint, 0 is the center.
| Floating point
|}

=== Connection object ===
Object containing information about the connections to other entities formed by red or green wires.

{| class="wikitable"
! Key !! Description !! Data type
|-
| 1
| First connection point. The default for everything that doesn't have multiple connection points.[[#Connection point object]]
| Object
|-
| 2
| Second connection point. For example, the "output" part of an arithmetic combinator.[[#Connection point object]]
| Object
|}

=== Connection point object ===
The actual point where a wire is connected to. Contains information about where it is connected to.

{| class="wikitable"
! Key !! Description !! Data type
|-
| red
| An array of [[#Connection data object]] containing all the connections from this point created by red wire.
| Array
|-
| green
| An array of [[#Connection data object]] containing all the connections from this point created by green wire.
| Array
|}

=== Connection data object ===
Information about a single connection between two connection points.

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_id
| ID of the entity this connection is connected with.
| Integer
|-
| circuit_id
| The circuit connector id of the entity this connection is connected to, see [https://lua-api.factorio.com/latest/defines.html#defines.circuit_connector_id defines.circuit_connector_id].
| Integer
|}

=== Item request object ===
1 or more instances of key/value pairs.
Key is the name of the item, string.
Value is the amount of items to be requested, [[Types/ItemCountType]].

=== Item filter object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Infinity settings object ===
{| class="wikitable"
! Key !! Description
|-
| remove_unfiltered_items
| Boolean. Whether the "remove unfiltered items" checkbox is checked.
| Boolean
|-
| filters
| Filters of the infinity container, optional. Array of [[#Infinity filter object]]s.
| Array
|}

=== Infinity filter object ===
{| class="wikitable"
! Key !! Description
|-
| name
| Name of the item prototype the filter is set to, string.
| String
|-
| count
| Number the filter is set to, [[Types/ItemCountType]].
| Integer
|-
| mode
| Mode of the filter. Either "at-least", "at-most", or "exactly".
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Logistic filter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|-
| count
| Number the filter is set to, [[Types/ItemCountType]]. Is 0 for storage chests.
| Integer
|}

=== Speaker parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| playback_volume
| [[Types/double]]. Volume of the speaker.
| Floating point
|-
| playback_globally
| Boolean, whether global playback is enabled.
| Boolean
|-
| allow_polyphony
| Boolean, whether polyphony is allowed.
| Boolean
|}

=== Speaker alert parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| show_alert
| Boolean, whether an alert is shown.
| Boolean
|-
| show_on_map
| Boolean, whether an alert icon is shown on the map.
| Boolean
|-
| icon_signal_id
| The icon that is displayed with the alert, [[#SignalID object]].
| Object
|-
| alert_message
| String, message of the alert.
| String
|}

=== Color object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| r
| red, number from 0 to 1.
| Floating point
|-
| g
| green, number from 0 to 1.
| Floating point
|-
| b
| blue, number from 0 to 1.
| Floating point
|-
| a
| transparency, number from 0 to 1.
| Floating point
|}

Blueprint string format

2019-11-17T17:25:50Z

Justarandomgeek: Wait Conditions

{{Languages}} [[Category:Technical]]
This is a technical description of the blueprint string format, used to share blueprints with other users.

A blueprint string is a JSON representation of the blueprint, compressed with zlib deflate using compression level 9 and then encoded using base64 with a version byte in front of the encoded string. The version byte is currently 0 for vanilla 0.15, 0.16 and 0.17.
So to get the JSON representation of a blueprint from a blueprint string, skip the first byte, base64 decode the string, and finally decompress using zlib inflate.

== Json representation of a blueprint/blueprint book ==

The json representation of a blueprint or blueprint book is one large object inside another "wrapping" object, its key inside that object is either blueprint or blueprint-book.

=== Blueprint book object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint-book" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| blueprints
| The actual content of the blueprint book, array of objects containing an "index" key and 0-based value and a "blueprint" key with a [[#Blueprint object]] as the value.
| Array
|-
| active_index
| Index of the currently selected blueprint, 0-based.
| Integer
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Blueprint object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| entities
| The actual content of the blueprint, array of [[#Entity object]]s.
| Array
|-
| tiles
| The tiles included in the blueprint, array of [[#Tile object]]s.
| Array
|-
| icons
| The icons of the blueprint set by the user, array of [[#Icon object]]s.
| Array
|-
| schedules
| The schedules for trains in this blueprint, array of [[#Schedule object]]s.
| Array
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Icon object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| index
| Index of the icon, 1-based.
| Integer
|-
| signal
| The icon that is displayed, [[#SignalID object]].
| Object
|}

=== SignalID object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the signal prototype this signal is set to.
| String
|-
| type
| Type of the signal. Either "item", "fluid" or "virtual".
| String
|}

=== Entity object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_number
| Index of the entity, 1-based.
| Integer
|-
| name
| Prototype name of the entity (e.g. "offshore-pump").
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|-
| direction
| Direction of the entity, uint (optional).
| Integer
|-
| connections
| Circuit connection, object with keys starting from 1, values are [[#Connection object]]s (optional).
| Object
|-
| control_behaviour
|
| Object
|-
| items
| Item requests by this entity, this is what defines the item-request-proxy when the blueprint is placed, optional. [[#Item request object]]
| Object
|-
| recipe
| Name of the recipe prototype this assembling machine is set to, optional, string.
|String
|-
| bar
| Used by [[Prototype/Container]], optional. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based [[Types/ItemStackIndex]].
| Integer
|-
| infinity_settings
| Used by [[Prototype/InfinityContainer]], optional. [[#Infinity settings object]]
| Object
|-
| type
| Type of the underground belt or loader, optional. Either "input" or "output".
| String
|-
| input_priority
| Input priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| output_priority
| Output priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| filter
| Filter of the splitter, optional. Name of the item prototype the filter is set to, string.
| String
|-
| filters
| Filters of the filter inserter or loader, optional. Array of [[#Item filter object]]s.
| Array
|-
| filter_mode
| Filter mode of the filter inserter, optional. Either "whitelist" or "blacklist".
| String
|-
| override_stack_size
| The stack size the inserter is set to, optional. [[Types/uint8]].
| Integer
|-
| drop_position
| The drop position the inserter is set to, optional. [[#Position object]].
| Object
|-
| pickup_position
| The pickup position the inserter is set to, optional. [[#Position object]].
| Object
|-
| request_filters
| Used by [[Prototype/LogisticContainer]], optional. [[#Logistic filter object]].
| Array
|-
| request_from_buffers
| Boolean. Whether this requester chest can request from buffer chests.
| Boolean
|-
| parameters
| Used by [[Programmable speaker]], optional. [[#Speaker parameter object]].
| Object
|-
| alert_parameters
| Used by [[Programmable speaker]], optional. [[#Speaker alert parameter object]]
| Object
|-
| auto_launch
| Used by the rocket silo, optional. Boolean, whether auto launch is enabled.
| Boolean
|-
| variation
| Used by [[Prototype/SimpleEntityWithForce]] or [[Prototype/SimpleEntityWithOwner]], optional. [[Types/GraphicsVariation]]
|
|-
| color
| Color of the [[Prototype/SimpleEntityWithForce]], [[Prototype/SimpleEntityWithOwner]], or train station, optional. [[#Color object]].
| Object
|-
| station
| The name of the train station, optional.
| String
|}

=== Schedule object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| schedule
| Array of [[#Schedule Record object]]s.
| Array
|-
| locomotives
| Array of entity numbers of locomotives using this schedule.
| Array
|}

=== Schedule Record object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| station
| The name of the stop for this schedule record.
| String
|-
| wait_conditions
| Array of [[#Wait Condition object]]s.
| Array
|}

=== Wait Condition object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| type
| One of "time", "inactivity", "full", "empty", "item_count", "circuit", "robots_inactive", "fluid_count", "passenger_present", "passenger_not_present".
| String
|-
| compare_type
| Either "and", or "or". Tells how this condition is to be compared with the preceding conditions in the corresponding wait_conditions array.
| String
|-
| ticks
| Number of ticks to wait or of inactivity. Only present when type is "time" or "inactivity". Optional.
| uint
|-
| condition
| CircuitCondition Object, only present when type is "item_count", "circuit" or "fluid_count".
| Object
|}

=== Tile object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Prototype name of the tile (e.g. "concrete")
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|}

=== Position object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| x
| X position within the blueprint, 0 is the center.
| Floating point
|-
| y
| Y position within the blueprint, 0 is the center.
| Floating point
|}

=== Connection object ===
Object containing information about the connections to other entities formed by red or green wires.

{| class="wikitable"
! Key !! Description !! Data type
|-
| 1
| First connection point. The default for everything that doesn't have multiple connection points.[[#Connection point object]]
| Object
|-
| 2
| Second connection point. For example, the "output" part of an arithmetic combinator.[[#Connection point object]]
| Object
|}

=== Connection point object ===
The actual point where a wire is connected to. Contains information about where it is connected to.

{| class="wikitable"
! Key !! Description !! Data type
|-
| red
| An array of [[#Connection data object]] containing all the connections from this point created by red wire.
| Array
|-
| green
| An array of [[#Connection data object]] containing all the connections from this point created by green wire.
| Array
|}

=== Connection data object ===
Information about a single connection between two connection points.

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_id
| ID of the entity this connection is connected with.
| Integer
|-
| circuit_id
| The circuit connector id of the entity this connection is connected to, see [https://lua-api.factorio.com/latest/defines.html#defines.circuit_connector_id defines.circuit_connector_id].
| Integer
|}

=== Item request object ===
1 or more instances of key/value pairs.
Key is the name of the item, string.
Value is the amount of items to be requested, [[Types/ItemCountType]].

=== Item filter object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Infinity settings object ===
{| class="wikitable"
! Key !! Description
|-
| remove_unfiltered_items
| Boolean. Whether the "remove unfiltered items" checkbox is checked.
| Boolean
|-
| filters
| Filters of the infinity container, optional. Array of [[#Infinity filter object]]s.
| Array
|}

=== Infinity filter object ===
{| class="wikitable"
! Key !! Description
|-
| name
| Name of the item prototype the filter is set to, string.
| String
|-
| count
| Number the filter is set to, [[Types/ItemCountType]].
| Integer
|-
| mode
| Mode of the filter. Either "at-least", "at-most", or "exactly".
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Logistic filter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|-
| count
| Number the filter is set to, [[Types/ItemCountType]]. Is 0 for storage chests.
| Integer
|}

=== Speaker parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| playback_volume
| [[Types/double]]. Volume of the speaker.
| Floating point
|-
| playback_globally
| Boolean, whether global playback is enabled.
| Boolean
|-
| allow_polyphony
| Boolean, whether polyphony is allowed.
| Boolean
|}

=== Speaker alert parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| show_alert
| Boolean, whether an alert is shown.
| Boolean
|-
| show_on_map
| Boolean, whether an alert icon is shown on the map.
| Boolean
|-
| icon_signal_id
| The icon that is displayed with the alert, [[#SignalID object]].
| Object
|-
| alert_message
| String, message of the alert.
| String
|}

=== Color object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| r
| red, number from 0 to 1.
| Floating point
|-
| g
| green, number from 0 to 1.
| Floating point
|-
| b
| blue, number from 0 to 1.
| Floating point
|-
| a
| transparency, number from 0 to 1.
| Floating point
|}

Blueprint string format

2019-11-17T17:00:48Z

Justarandomgeek: Train schedules

{{Languages}} [[Category:Technical]]
This is a technical description of the blueprint string format, used to share blueprints with other users.

A blueprint string is a JSON representation of the blueprint, compressed with zlib deflate using compression level 9 and then encoded using base64 with a version byte in front of the encoded string. The version byte is currently 0 for vanilla 0.15, 0.16 and 0.17.
So to get the JSON representation of a blueprint from a blueprint string, skip the first byte, base64 decode the string, and finally decompress using zlib inflate.

== Json representation of a blueprint/blueprint book ==

The json representation of a blueprint or blueprint book is one large object inside another "wrapping" object, its key inside that object is either blueprint or blueprint-book.

=== Blueprint book object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint-book" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| blueprints
| The actual content of the blueprint book, array of objects containing an "index" key and 0-based value and a "blueprint" key with a [[#Blueprint object]] as the value.
| Array
|-
| active_index
| Index of the currently selected blueprint, 0-based.
| Integer
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Blueprint object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| entities
| The actual content of the blueprint, array of [[#Entity object]]s.
| Array
|-
| tiles
| The tiles included in the blueprint, array of [[#Tile object]]s.
| Array
|-
| icons
| The icons of the blueprint set by the user, array of [[#Icon object]]s.
| Array
|-
| schedules
| The schedules for trains in this blueprint, array of [[#Schedule object]]s.
| Array
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Icon object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| index
| Index of the icon, 1-based.
| Integer
|-
| signal
| The icon that is displayed, [[#SignalID object]].
| Object
|}

=== SignalID object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the signal prototype this signal is set to.
| String
|-
| type
| Type of the signal. Either "item", "fluid" or "virtual".
| String
|}

=== Entity object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_number
| Index of the entity, 1-based.
| Integer
|-
| name
| Prototype name of the entity (e.g. "offshore-pump").
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|-
| direction
| Direction of the entity, uint (optional).
| Integer
|-
| connections
| Circuit connection, object with keys starting from 1, values are [[#Connection object]]s (optional).
| Object
|-
| control_behaviour
|
| Object
|-
| items
| Item requests by this entity, this is what defines the item-request-proxy when the blueprint is placed, optional. [[#Item request object]]
| Object
|-
| recipe
| Name of the recipe prototype this assembling machine is set to, optional, string.
|String
|-
| bar
| Used by [[Prototype/Container]], optional. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based [[Types/ItemStackIndex]].
| Integer
|-
| infinity_settings
| Used by [[Prototype/InfinityContainer]], optional. [[#Infinity settings object]]
| Object
|-
| type
| Type of the underground belt or loader, optional. Either "input" or "output".
| String
|-
| input_priority
| Input priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| output_priority
| Output priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| filter
| Filter of the splitter, optional. Name of the item prototype the filter is set to, string.
| String
|-
| filters
| Filters of the filter inserter or loader, optional. Array of [[#Item filter object]]s.
| Array
|-
| filter_mode
| Filter mode of the filter inserter, optional. Either "whitelist" or "blacklist".
| String
|-
| override_stack_size
| The stack size the inserter is set to, optional. [[Types/uint8]].
| Integer
|-
| drop_position
| The drop position the inserter is set to, optional. [[#Position object]].
| Object
|-
| pickup_position
| The pickup position the inserter is set to, optional. [[#Position object]].
| Object
|-
| request_filters
| Used by [[Prototype/LogisticContainer]], optional. [[#Logistic filter object]].
| Array
|-
| request_from_buffers
| Boolean. Whether this requester chest can request from buffer chests.
| Boolean
|-
| parameters
| Used by [[Programmable speaker]], optional. [[#Speaker parameter object]].
| Object
|-
| alert_parameters
| Used by [[Programmable speaker]], optional. [[#Speaker alert parameter object]]
| Object
|-
| auto_launch
| Used by the rocket silo, optional. Boolean, whether auto launch is enabled.
| Boolean
|-
| variation
| Used by [[Prototype/SimpleEntityWithForce]] or [[Prototype/SimpleEntityWithOwner]], optional. [[Types/GraphicsVariation]]
|
|-
| color
| Color of the [[Prototype/SimpleEntityWithForce]], [[Prototype/SimpleEntityWithOwner]], or train station, optional. [[#Color object]].
| Object
|-
| station
| The name of the train station, optional.
| String
|}

=== Schedule object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| schedule
| Array of [[#Schedule Entry object]]s.
| Array
|-
| locomotives
| Array of entity numbers of locomotives using this schedule.
| Array
|}

=== Schedule Entry object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| station
| The name of the stop for this schedule entry.
| String
|-
| wait_conditions
| Array of wait conditions.
| Array
|}

=== Tile object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Prototype name of the tile (e.g. "concrete")
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|}

=== Position object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| x
| X position within the blueprint, 0 is the center.
| Floating point
|-
| y
| Y position within the blueprint, 0 is the center.
| Floating point
|}

=== Connection object ===
Object containing information about the connections to other entities formed by red or green wires.

{| class="wikitable"
! Key !! Description !! Data type
|-
| 1
| First connection point. The default for everything that doesn't have multiple connection points.[[#Connection point object]]
| Object
|-
| 2
| Second connection point. For example, the "output" part of an arithmetic combinator.[[#Connection point object]]
| Object
|}

=== Connection point object ===
The actual point where a wire is connected to. Contains information about where it is connected to.

{| class="wikitable"
! Key !! Description !! Data type
|-
| red
| An array of [[#Connection data object]] containing all the connections from this point created by red wire.
| Array
|-
| green
| An array of [[#Connection data object]] containing all the connections from this point created by green wire.
| Array
|}

=== Connection data object ===
Information about a single connection between two connection points.

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_id
| ID of the entity this connection is connected with.
| Integer
|-
| circuit_id
| The circuit connector id of the entity this connection is connected to, see [https://lua-api.factorio.com/latest/defines.html#defines.circuit_connector_id defines.circuit_connector_id].
| Integer
|}

=== Item request object ===
1 or more instances of key/value pairs.
Key is the name of the item, string.
Value is the amount of items to be requested, [[Types/ItemCountType]].

=== Item filter object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Infinity settings object ===
{| class="wikitable"
! Key !! Description
|-
| remove_unfiltered_items
| Boolean. Whether the "remove unfiltered items" checkbox is checked.
| Boolean
|-
| filters
| Filters of the infinity container, optional. Array of [[#Infinity filter object]]s.
| Array
|}

=== Infinity filter object ===
{| class="wikitable"
! Key !! Description
|-
| name
| Name of the item prototype the filter is set to, string.
| String
|-
| count
| Number the filter is set to, [[Types/ItemCountType]].
| Integer
|-
| mode
| Mode of the filter. Either "at-least", "at-most", or "exactly".
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Logistic filter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|-
| count
| Number the filter is set to, [[Types/ItemCountType]]. Is 0 for storage chests.
| Integer
|}

=== Speaker parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| playback_volume
| [[Types/double]]. Volume of the speaker.
| Floating point
|-
| playback_globally
| Boolean, whether global playback is enabled.
| Boolean
|-
| allow_polyphony
| Boolean, whether polyphony is allowed.
| Boolean
|}

=== Speaker alert parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| show_alert
| Boolean, whether an alert is shown.
| Boolean
|-
| show_on_map
| Boolean, whether an alert icon is shown on the map.
| Boolean
|-
| icon_signal_id
| The icon that is displayed with the alert, [[#SignalID object]].
| Object
|-
| alert_message
| String, message of the alert.
| String
|}

=== Color object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| r
| red, number from 0 to 1.
| Floating point
|-
| g
| green, number from 0 to 1.
| Floating point
|-
| b
| blue, number from 0 to 1.
| Floating point
|-
| a
| transparency, number from 0 to 1.
| Floating point
|}

Blueprint string format

2019-11-17T03:50:50Z

Justarandomgeek: /* Entity object */ add filter_mode

{{Languages}} [[Category:Technical]]
This is a technical description of the blueprint string format, used to share blueprints with other users.

A blueprint string is a JSON representation of the blueprint, compressed with zlib deflate using compression level 9 and then encoded using base64 with a version byte in front of the encoded string. The version byte is currently 0 for vanilla 0.15, 0.16 and 0.17.
So to get the JSON representation of a blueprint from a blueprint string, skip the first byte, base64 decode the string, and finally decompress using zlib inflate.

== Json representation of a blueprint/blueprint book ==

The json representation of a blueprint or blueprint book is one large object inside another "wrapping" object, its key inside that object is either blueprint or blueprint-book.

=== Blueprint book object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint-book" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| blueprints
| The actual content of the blueprint book, array of objects containing an "index" key and 0-based value and a "blueprint" key with a [[#Blueprint object]] as the value.
| Array
|-
| active_index
| Index of the currently selected blueprint, 0-based.
| Integer
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Blueprint object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| item
| String, the name of the item that was saved ("blueprint" in vanilla).
| String
|-
| label
| String, the name of the blueprint set by the user.
| String
|-
| label_color
| The color of the label of this blueprint. Optional. [[#Color object]].
| Object
|-
| entities
| The actual content of the blueprint, array of [[#Entity object]]s.
| Array
|-
| tiles
| The tiles included in the blueprint, array of [[#Tile object]]s.
| Array
|-
| icons
| The icons of the blueprint set by the user, array of [[#Icon object]]s.
| Array
|-
| version
| The map version of the map the blueprint was created in.
| Integer (long)
|}

=== Icon object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| index
| Index of the icon, 1-based.
| Integer
|-
| signal
| The icon that is displayed, [[#SignalID object]].
| Object
|}

=== SignalID object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the signal prototype this signal is set to.
| String
|-
| type
| Type of the signal. Either "item", "fluid" or "virtual".
| String
|}

=== Entity object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_number
| Index of the entity, 1-based.
| Integer
|-
| name
| Prototype name of the entity (e.g. "offshore-pump").
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|-
| direction
| Direction of the entity, uint (optional).
| Integer
|-
| connections
| Circuit connection, object with keys starting from 1, values are [[#Connection object]]s (optional).
| Object
|-
| control_behaviour
|
| Object
|-
| items
| Item requests by this entity, this is what defines the item-request-proxy when the blueprint is placed, optional. [[#Item request object]]
| Object
|-
| recipe
| Name of the recipe prototype this assembling machine is set to, optional, string.
|String
|-
| bar
| Used by [[Prototype/Container]], optional. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based [[Types/ItemStackIndex]].
| Integer
|-
| infinity_settings
| Used by [[Prototype/InfinityContainer]], optional. [[#Infinity settings object]]
| Object
|-
| type
| Type of the underground belt or loader, optional. Either "input" or "output".
| String
|-
| input_priority
| Input priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| output_priority
| Output priority of the splitter, optional. Either "right" or "left", "none" is omitted.
| String
|-
| filter
| Filter of the splitter, optional. Name of the item prototype the filter is set to, string.
| String
|-
| filters
| Filters of the filter inserter or loader, optional. Array of [[#Item filter object]]s.
| Array
|-
| filter_mode
| Filter mode of the filter inserter, optional. Either "whitelist" or "blacklist".
| String
|-
| override_stack_size
| The stack size the inserter is set to, optional. [[Types/uint8]].
| Integer
|-
| drop_position
| The drop position the inserter is set to, optional. [[#Position object]].
| Object
|-
| pickup_position
| The pickup position the inserter is set to, optional. [[#Position object]].
| Object
|-
| request_filters
| Used by [[Prototype/LogisticContainer]], optional. [[#Logistic filter object]].
| Array
|-
| request_from_buffers
| Boolean. Whether this requester chest can request from buffer chests.
| Boolean
|-
| parameters
| Used by [[Programmable speaker]], optional. [[#Speaker parameter object]].
| Object
|-
| alert_parameters
| Used by [[Programmable speaker]], optional. [[#Speaker alert parameter object]]
| Object
|-
| auto_launch
| Used by the rocket silo, optional. Boolean, whether auto launch is enabled.
| Boolean
|-
| variation
| Used by [[Prototype/SimpleEntityWithForce]] or [[Prototype/SimpleEntityWithOwner]], optional. [[Types/GraphicsVariation]]
|
|-
| color
| Color of the [[Prototype/SimpleEntityWithForce]], [[Prototype/SimpleEntityWithOwner]], or train station, optional. [[#Color object]].
| Object
|-
| station
| The name of the train station, optional.
| String
|}

=== Tile object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Prototype name of the tile (e.g. "concrete")
| String
|-
| position
| [[#Position object]], position of the entity within the blueprint.
| Object
|}

=== Position object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| x
| X position within the blueprint, 0 is the center.
| Floating point
|-
| y
| Y position within the blueprint, 0 is the center.
| Floating point
|}

=== Connection object ===
Object containing information about the connections to other entities formed by red or green wires.

{| class="wikitable"
! Key !! Description !! Data type
|-
| 1
| First connection point. The default for everything that doesn't have multiple connection points.[[#Connection point object]]
| Object
|-
| 2
| Second connection point. For example, the "output" part of an arithmetic combinator.[[#Connection point object]]
| Object
|}

=== Connection point object ===
The actual point where a wire is connected to. Contains information about where it is connected to.

{| class="wikitable"
! Key !! Description !! Data type
|-
| red
| An array of [[#Connection data object]] containing all the connections from this point created by red wire.
| Array
|-
| green
| An array of [[#Connection data object]] containing all the connections from this point created by green wire.
| Array
|}

=== Connection data object ===
Information about a single connection between two connection points.

{| class="wikitable"
! Key !! Description !! Data type
|-
| entity_id
| ID of the entity this connection is connected with.
| Integer
|-
| circuit_id
| The circuit connector id of the entity this connection is connected to, see [https://lua-api.factorio.com/latest/defines.html#defines.circuit_connector_id defines.circuit_connector_id].
| Integer
|}

=== Item request object ===
1 or more instances of key/value pairs.
Key is the name of the item, string.
Value is the amount of items to be requested, [[Types/ItemCountType]].

=== Item filter object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Infinity settings object ===
{| class="wikitable"
! Key !! Description
|-
| remove_unfiltered_items
| Boolean. Whether the "remove unfiltered items" checkbox is checked.
| Boolean
|-
| filters
| Filters of the infinity container, optional. Array of [[#Infinity filter object]]s.
| Array
|}

=== Infinity filter object ===
{| class="wikitable"
! Key !! Description
|-
| name
| Name of the item prototype the filter is set to, string.
| String
|-
| count
| Number the filter is set to, [[Types/ItemCountType]].
| Integer
|-
| mode
| Mode of the filter. Either "at-least", "at-most", or "exactly".
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|}

=== Logistic filter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| name
| Name of the item prototype this filter is set to.
| String
|-
| index
| Index of the filter, 1-based.
| Integer
|-
| count
| Number the filter is set to, [[Types/ItemCountType]]. Is 0 for storage chests.
| Integer
|}

=== Speaker parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| playback_volume
| [[Types/double]]. Volume of the speaker.
| Floating point
|-
| playback_globally
| Boolean, whether global playback is enabled.
| Boolean
|-
| allow_polyphony
| Boolean, whether polyphony is allowed.
| Boolean
|}

=== Speaker alert parameter object ===
{| class="wikitable"
! Key !! Description !! Data type
|-
| show_alert
| Boolean, whether an alert is shown.
| Boolean
|-
| show_on_map
| Boolean, whether an alert icon is shown on the map.
| Boolean
|-
| icon_signal_id
| The icon that is displayed with the alert, [[#SignalID object]].
| Object
|-
| alert_message
| String, message of the alert.
| String
|}

=== Color object ===

{| class="wikitable"
! Key !! Description !! Data type
|-
| r
| red, number from 0 to 1.
| Floating point
|-
| g
| green, number from 0 to 1.
| Floating point
|-
| b
| blue, number from 0 to 1.
| Floating point
|-
| a
| transparency, number from 0 to 1.
| Floating point
|}

Stack

2019-04-18T00:24:32Z

Justarandomgeek: /* Filtered stacks */

{{Languages}}
A stack is the basic element in Factorio to store items. One space in an inventory can hold one stack.

== Examples of stacks ==

* The [[player]]'s inventory
** Main inventory
** The toolbelt ([[Player#Quickbar|quickbar]])
** Tool, armor, weapon, and ammunition stacks
** Logistic trash slots
** The player's hand (is also a stack)
* [[Vehicle]]s
** [[Car]] (fuel, ammunition, inventory)
** [[Tank]] (fuel, ammunition, inventory)
** [[Railway|Train]] (wagons, engines for fuel)
* [[Chests]]: The archetypal example of stacks outside the player's inventory; a chest is basically just a group of stacks.
* Devices
** [[Furnace]]: Burner stack ([[Stone furnace|stone]] and [[Steel furnace|steel]] furnace only), input and output stack
** [[Assembling machine]]s and [[chemical plant]]s: 1 or more output and 1-6 input stacks, depending on item type being assembled
** [[Lab|Labs]]
** Burner-based: [[Boiler]], [[burner mining drill]], [[burner inserter]]
** [[Roboport]] (filtered for robots and repair packs only)
** [[Gun turret]]
* Special
** [[Inserters]] and [[Robots|worker robots]] (Small, variable-size stacks allow these entities to move items between other stacks. See also the [[Inserter capacity bonus (research)|inserter]] and [[Worker robot cargo size (research)|robot]] stack size bonus research topics.)

== How do stacks work? ==

A stack can store a number of identical items.

The first inserted item determines which item types can be stored. This also indirectly determines how many items can be stored in the stack, as this depends on the item type's maximum stack size.

Only items can be stored within stacks; stacks cannot hold [[Fluid system|liquids]] or other entity types.

=== Stack size ===

The number of items a stack can store. Stack size depends on the item; existing stack sizes and (non-exhaustive) examples include (click to expand):

{| class="wikitable mw-collapsible mw-collapsed"
!style="width: 100px;" |Stack size
!Examples
|-
| 1 || [[Nuclear fuel]], [[artillery shell]], [[satellite]], [[modular armor]], [[blueprint]].
|-
| 5 || [[Locomotive]], all [[Wagon|wagons]].
|-
| 10 || [[Roboport]], [[rocket fuel]], [[artillery turret]], [[atomic bomb]].
|-
| 20 || Some [[equipment modules]], [[pumpjack]]s, [[steel axe]].
|-
| 50 || All ores, [[stone]], [[coal]], all [[Module|modules]], [[electric mining drill]], [[electric furnace]], all [[Assembling machine|assemblers]], all [[chests]], all [[inserters]], [[gun turret]], [[laser turret]], all [[Electric_system#Distribution|power poles]] including [[substation]], both types of [[Robots|worker robots]], [[solid fuel]].
|-
| 100 || [[Iron plate]], [[copper plate]], [[steel plate]], [[processing unit]], [[iron gear wheel]], [[stone brick]], all types of [[concrete]], both isotopes of [[Uranium processing|processed uranium]], [[pipe]] (regular), all [[Belt transport system|belts]], [[stone wall]], [[landfill]].
|-
| 200 || [[Electronic circuit]], [[advanced circuit]], all types of [[Ammunition#Magazines|magazine]], all types of [[tank]] [[Ammunition#Tank shells|cannon shell]], [[copper cable]], both colors of circuit [[Circuit network|wire]], all types of [[science pack]] except space science pack.
|-
| 2,000 || Unique to [[space science pack]], present to allow stacking up to 2 [[Rocket|rockets]]' worth of packs in the [[rocket silo]]'s single output slot.
|}

=== Filtered stacks ===

Stacks can be filtered either by default (in burner-type entities, [[furnace]]s, [[roboport]]s, [[turret]]s, [[lab]]s, and other entities that can only accept one or a few item types in a particular slot), or manually by the player (normally set via the middle mouse button / scroll-wheel click, see [[Keyboard bindings]]). Manual filtering is available for [[cargo wagon]]s, the [[Player#Quickbar|quickbar]], and the player inventory, but not for other types of containers (in particular, [[chests]] of any type).

This can be used to ensure only one item type goes into the inventory space. [[Inserters]] (or [[Robots|bots]], where applicable) will not attempt to insert anything except the allowed item type into filtered slots, and manual insertion of other item types by the player is also not allowed unless and until the filter is cleared.

=== Damaged items ===

Damaged items (i.e, damaged entities now stored as items) stack with other damaged items (of the same type), but not with undamaged items. When items with different amounts of damage are stacked together, the health of the items is averaged.

=== Items with durability ===

Items with durability, such as [[science pack]]s and [[repair packs]], always stack with items of the same type, regardless of how much durability remains. The durability displayed on the stack is the durability of the first item. After that item is removed from the stack, a stack of items with full durabilities remains. This means that when multiple items with durabilities are stacked together, their durabilities are merged, which can result in a lower overall item count while the overall remaining durability stays the same.

== Stack size bonuses ==

Inserters and logistic robots can be boosted with research to hold and transfer more items, see:

* [[Inserter capacity bonus (research)]],
* [[Worker robot cargo size (research)]]

== Stack limitation ==

[[File:Stack limiter.jpg|300px|thumb|frame|A [[wooden chest]] limited to three stacks. Once the third stack is full, inserters will no longer attempt to add items.]]

Optionally, the usable space in [[chests]] and [[Cargo wagon|wagons]] can be decreased below their default values. Typically, this is done to store a small amount of items in an automated process, without consuming the resources that would be required to fill the entire container.

To limit a container, click the red X at the end of the last stack. Then, click on one of the stacks to set the new limit. The unused stacks will be highlighted red (see right).

When full, inserters will no longer add to a limited container. However, the player is still free to manually place items in the unused (red) slots.

== Handling stacks ==

There are some [[keyboard bindings]] to quickly handle movement of stacks between inventories, like moving half of a stack to another stack.

== History ==

In game version 0.10, the number of items which can be stored in a stack changed for most items from powers of 2 to multiples of 10. This change was mainly made because most people find it more intuitive to calculate numbers in a base-10 system.

Example: Before the change, a stack could store 64 iron ore, while after the change it is 50. This created some controversy, as some players preferred the old stack sizes.

User:Justarandomgeek

2018-06-16T16:42:45Z

Justarandomgeek:

Feathernet is the network of the future

= WIP for Circuit Cookbook =
== Filtering/Isolating Signals ==

=== Simple Isolation ===

* A fixed signal can be isolated from a circuit using a no-op arithmetic combinator

TODO: marked up image with arith isolator

=== Simple Isolation ===

* A fixed signal can be removed from a circuit using a no-op EACH arithmetic combinator, combined with the inverse of the signal(s) to be removed

TODO: marked up image with arith filter removing signal

=== Circuit Controlled Filtering ===

* A more advanced filter can be constructed allowing one circuit to select which signals pass through from another.
* This is achieved by splitting the Data circuit into three groups: positive, negative, and "flag-value".
* For positive and negative groups, the high bit of the value is flipped for all signals present in the Control circuit, causing their sign to change, which allows them through the next filter, where they're flipped back.
* For values with only the high bit set, this would result in them becoming 0 and being lost, so they're filtered separately.

TODO: marked up image & blueprint of https://www.reddit.com/r/factorio/comments/8maf3q/help_with_circuit_condition_combinator_design/dzma27d/?context=3

== Timers/Counters ==

=== Resetable Timer/Counter ===

* A Memory cell connected to a pulse source will count those pulses, until it is reset. Connected to a continuous signal, like a constant combinator, this becomes a timer.
TODO: Image of counter, timer configurations - counting belt, timing

=== One-Shot trigger ===

* A Resettable Timer/Counter can be used to trigger a sequence of events, or to delay a signal some amount of time.
* This is done by setting Decider Combinators to output when the timer is equal to various desired values
TODO: image(gif?) of timer triggering various lamps