Official Factorio Wiki - User contributions [en]

Glossary

2016-05-29T09:59:11Z

JohnnyWing: Added 'scenario' term

{{Languages}}
{{stub}}
Note: some of the pages aren't created yet. Instead the information is gathered together here, and when the page is created it should be moved to that page.
Note2: try to keep links/pages in singular! Not Belts but Belt!
;Assembling machine
: Crafts a new item from [[items#Intermediate products|intermediate products]]. Currently up to 4 types of inserted items can result into one output item. A [[recipe]] tells the assembly which items are used, how long it takes, how much energy is used and what comes out. See [[Crafting network]]
;Assembly
: See Assembling machine and [[Crafting network]]
;[[Basic accumulator]]
: Stores electrical energy. Most commonly used for providing electricity at night when [[Solar Panel|solar panels]] produce none
;Belt
: See [[Transport network|Transport belt]].
;[[Enemies]]
: Enemies are the aliens that attack you and your factory. They come in Biter and Spitter forms, as well as small, medium, large, and gargantuan sizes. They are attracted to pollution sources.
;[[Chests|Chest]]
: Placeable item that is used to store other items.
;[[Entity]]
: Anything that can be manipulated in-game. Nearly everything in factorio is an entity. [[Tile|Tiles]], [[Items]], any device, trees... Even the player is just an entity
;[[Inserter]]
: An automatic robot arm, which transports [[Items]] from a source to a destination.
;[[items#Intermediate products|Intermediate products]]
: Items which can not be placed on planet or be used by player, their only purpose is as raw material for other recipes.
;[[Items|Item]]
: Is a moveable [[Entity|entity]]. Everything on the belts, in chests, in your inventory, transported by [[Logistic robot|Logistic bots]]/[[Locomotive]], inside [[Turret|turrets]], [[Assembling machines|assemblies]], [[Furnace|furnaces]] is an item. A [[Stack|stack]] can contain only one sort of item. Items can also lay on the ground, you can grab them up normally with key F and drop them down with key Z. Every item has a physical dimension (see [[bounding boxes]]), which limits the density the can have on the [[map]]. Items are subcategorized into [[items#Resources|resources]], [[items#Intermediate products|intermediate products]], [[items#Player equipment|equipment]] and [[items#Placeable items|placeable items]].
;[[Lab]]
: A type of assembly machine which produces no output and only accepts science packs as input. Used to research new technologies.
;[[Laser turret]]
: Advanced defensive structure which uses electricity instead of bullets.
; Mines
: Shorthand term for any kind of mining building: Mining drills, electric mining drills, and pumpjacks are all considered mines.
;[[Mining drill]]
: Placeable item to automate mining. See also [[Electric Mining Drill]].
;[[Module]]
: One of three types of item that can be placed in buildings to change the effects of the building.
;[[Pax]]
: Player access station; in addition to the scheduled trains in a train network, one may want to add extra stations and trains for maintenance.
;[[Pollution]]
: Created by burning coal/wood and running mines, [[Pumpjack|pumpjacks]], and assembly machines
;[[items#Resources|Resource]]
: Entities that did not need to be assembled. Iron-ore, copper-ore, coal, stone, water, crude oil, raw wood, alien artifacts, and raw fish are all resources.
;[[Scenario]]
: A map that has been saved via the [[Map editor]]
;Tick
: The smallest measurable amount of time in Factorio. There are 60 ticks per second.
;Time
: Game time is normally identical with real time, one second in the game is one second in reality, but it can be faster or slower. For example, when the calculations for an update takes longer than a tick, the game slows down. Alternatively, a mod can provide ways to let the game run faster.
;Tile
: A piece of map. It is not really known how big it is, but for simplifying things we can assume, that a tile is a quadrate with side of 1 meter (like Minecraft). Please consider that the entities do not have sizes which can be compared to real life; gameplay goes here over reality.
;[[Transport network|Transport belt]]
: A belt is used to transport [[Items|items]] to any point of the [[Map|map]] to satisfy logistic needs. A belt is a little bit wider than two items, so you can transport items in two rows of the belt. The players task is to handle this two sides with the limited elements he has. This is one of the core game elements of factorio.
;[[Trees]]
: Item that produces [[Raw wood|wood]] when mined
;Turret
: Stationary defense weapon. There are gun & laser turrets. With some upgrades turrets get really powerful.

Console

2016-05-29T09:06:47Z

JohnnyWing: Removed stub template. Reworked the intro paragraph.

{{Languages}}
= Console Overview =
The Factorio console is the built in interface for executing Lua commands within Factorio. It works similarly to any command line interface or the JavaScript console for your browser.

You can essentially fire any command here, just as you would from a Lua program - Factorio [[Mods]] are merely Lua commands. Therefore you don't necessarily need "cheats" per-se, as the console allows you full access to the game's internals. You only need a familiarity with the commands and types, as shown in the below examples and the [[Modding]] section.

= Using the console =
== Opening the console ==
With default key bindings, the console is opened with the ''' '/' or '~'''' keys. Like most others, this key binding may be customized within the Options Menu->Keyboard>"Toggle Lua console".

== Inputting commands ==

The console is also the chat window in multiplayer. You need to type '/c' in front of your commands, otherwise it is just a chat message!
The console has an inbuilt history. You can use the "cursor-up"-key to repeat or quickly edit and re-issue previous commands.

The game ignores newlines when pasting "scriptlets" in the console. This means they can be written in a human readable form in an editor and copy/pasted into the console, making understanding and editing a bit easier.

On the other hand, if you want to type ''several commands in one line'' you just need to put ';' (semicolon) between the commands - see examples below.

= Example"cheat" commands =
Information for additional commands may be found in the [[Modding|modding-section]]

== Use it as calculator ==
(see [[#Inputting commands|Inputting Commands]]: you can repeat a prior command with the "cursor up"-key!)
/c game.local_player.print(1234 * 5678)

== Mine faster ==
/c game.local_player.force.manual_mining_speed_modifier=1000

== Craft faster ==
/c game.local_player.force.manual_crafting_speed_modifier=1000

== Zoom beyond normal bounds ==
/c game.local_player.zoom = 0.1

== Use print() instead of game.local_player.print() ==
[http://www.factorioforums.com/forum/viewtopic.php?f=41&t=5638 Use print() instead of game.local_player.print()] (forums)
/c print = function(text) game.local_player.print(text) end

== Check water level in a pipe ==
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6066&p=47758#p47758 Check water level in a pipe] (forums)
Hold cursor over the target pipe and execute:
/c game.local_player.print(game.local_player.selected.get_liquid().amount)

== Inventory Manipulation ==
=== Refill resources (refill oil, iron etc.) ===
While holding the cursor over a resource in-game
/c game.local_player.selected.amount=7500

=== Add 100 iron plates to your inventory ===
/c game.local_player.insert{name="iron-plate", count=100}

== World Manipulation ==
=== Turn off night ===
/c game.always_day=true

=== Add new resource patch ===
This creates a new 5x5 patch of resources, centered on the player character. For resources other than stone, just change "stone" to "iron-ore", "copper-ore", or "coal"

/c local surface = game.local_player.surface;
for y=-2,2 do
for x=-2,2 do
surface.create_entity({name="stone", amount=5000, position={game.local_player.position.x+x, game.local_player.position.y+y}})
end
end

=== Destroy rocks in sandbox-mode ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=5686 Destroy rocks in sandbox-mode (forums)] - you don't have a player here, so you can't destroy anything.
/c for _,entity in pairs(game.local_player.surface.find_entities_filtered{
area={{game.local_player.position.x-32, game.local_player.position.y-32},
{game.local_player.position.x+32, game.local_player.position.y+32}},
name="stone-rock"})
do
entity.destroy()
end
you need to center the rock in your vision range

=== Generate a section of the world and explore it at the same time ===
[http://www.factorioforums.com/forum/viewtopic.php?f=14&t=4761&p=44184#p44184 Generate a section of the world and explore it at the same time] (forums)
/c game.local_player.force.chart(game.local_player.surface,{lefttop = {x = -1024, y = -1024}, rightbottom = {x = 1024, y = 1024}})

Simply change the bounding box to the size you want and it will generate the map and explore it in that area. Keep In mind that command is telling Factorio to generate 64*64 (4096) chunks so it's going to take a while before all the background entity generation (trees, resources, biters) are placed in the world.

== Enemy/Evolution ==
=== Check how far the biters have evolved ===
/c game.local_player.print(game.evolution_factor)

=== Disable evolution & increases pollution evolution ===
[http://www.factorioforums.com/forum/viewtopic.php?f=34&t=10159 Disable evolution, increases pollution evolution instead] (forums)
/c game.mapsettings.enemy_evolution.time_factor = 0.000008 * 0
/c game.mapsettings.enemy_evolution.pollution_factor = 0.00003 * 2

=== Kill all biters on the "enemy" force ===
/c game.forces["enemy"].kill_all_units()

=== Remove all enemies from the map ===
/c local surface = game.local_player.surface
for c in surface.get_chunks() do
for key, entity in pairs(surface.find_entities_filtered({area={{c.x * 32, c.y * 32}, {c.x * 32 + 32, c.y * 32 + 32}}, force= "enemy"})) do
entity.destroy()
end
end

=== Enable peaceful mode ===
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9020 Switching on peaceful mode] (forums)
/c game.peaceful_mode = true
/c game.forces["enemy"].kill_all_units()

== Player Character ==
=== Spawn a player character ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=19447&p=124039#p123991 Custom Scenario: How to spawn a character at a certain point (instead of being in god-mode] (forums)
/c game.local_player.character = game.local_player.surface.create_entity{name="player", position = {0,0}, force = game.forces.player}

=== Change Player color ===
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9028 Player color] (forums)
/c game.local_player.color={g=50,b=200,r=200,a=.9}

== Research ==
=== Enable faster research ===
/c game.local_player.force.laboratory_speed_modifier = 1
1 is normal speed, 2 is double speed 3 is triple etc. I think it goes up to 100.

=== Enabling specific technologies ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6633 Enabling technologies] (forums)
/c game.local_player.force.technologies['electric-energy-distribution-1'].researched=true
/c game.local_player.force.technologies['steel-processing'].researched=true

=== Finish research immediately ===
/c for name,technology in pairs(game.local_player.force.technologies) do technology.researched=technology.enabled end

== Get robot count within network ==
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=9867&p=78209#p78209 Where can I see how many Robots are in my network?] (forums)

Note that these are no longer needed because the roboport now provides accurate robot counts.

=== Count all '''active robots'''===
/c game.local_player.print(game.local_player.force.get_entitycount("logistic-robot"))
/c game.local_player.print(game.local_player.force.get_entitycount("construction-robot"))

=== Count all '''active and inactive robots''' in the network, but misses the ones flying over gaps in coverage ===
/c robots = {};
roboports = {};
logistic = 0;
construction = 0;
recurse = function(r)
id = r.position.x .. "," .. r.position.y;
if (roboports[id] or r.force.name ~= game.player.force.name) then return end;
roboports[id] = true;
logistic = logistic + r.getinventory(1).getitemcount("logistic-robot");
construction = construction + r.getinventory(1).getitemcount("construction-robot");
ids = {};
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="construction-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
construction = construction + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="logistic-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
logistic = logistic + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, roboport in ipairs(game.findentitiesfiltered{area={{r.position.x-48.5, r.position.y-48.5}, {r.position.x+48.5, r.position.y+48.5}}, name="roboport"}) do;
recurse(roboport);
end;
end;
p = game.player.character.position;
roboport = game.findentitiesfiltered{area={{p.x-48.5, p.y-48.5}, {p.x+48.5, p.y+48.5}}, name="roboport"}[1];
if (roboport) then;
recurse(roboport);
game.player.print("Robots in network: Construction:" .. construction .. " Logistic:" .. logistic);
else;
game.player.print("Not in range of a roboport.");
end

= See also =

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=7981 Superspeedrun]
* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=4752 The Console: What is it and How do I use it?]
: Some interesting cheats or useful commands and tips.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6942&p=543H57#p54357 Totaly new player -> setting up a game]:
# Preface all console commands with /c in .11.0+

# Set player to white
game.local_player.color = {g=1,b=1,r=1,a=.9}

# remove old player
game.remove_offline_player("username")

# Technology and Recipe unlocking
game.local_player.force.reset_technologies()
game.local_player.force.reset_recipes()
game.local_player.force.enable_all_technologies() # does not research them (see below)
game.local_player.force.enable_all_recipes()
game.local_player.force.research_all_technologies()
game.local_player.force.technologies["technology-name"].researched = true

# cheating
game.local_player.force.manual_mining_speed_modifier = 200
game.local_player.force.manual_crafting_speed_modifier = 200
game.speed = 2
game.freeze_day_time()
game.always_day = true
game.peaceful_mode = true
game.local_player.insert{name="item-name", count=1}

Console

2016-05-29T08:56:17Z

JohnnyWing: Majorly restructured page into categorized example groups. Minor content updates for readability, simplification, and to remove redundancy. All examples still exist but were re-ordered.

{{Languages}}

{{stub|This article needs to be completely rewritten.}}

The console is the built in interface for lua-commands. It works a bit like any command-line-interface or the java-script-console for your browser.

Basically you can fire here all commands, like from any other lua-program (= [[Modding]]). This means you have full access to all in-game-internals.

In other words: Factorio doesn't need any special cheats, it has a console, which allows you to cheat around any limition, if you know how.

= Using the console =
== Opening the console ==
With default key bindings, the console is opened with the ''' '/' or '~'''' keys. Like most others, this key binding may be customized within the Options Menu->Keyboard>"Toggle Lua console".

== Inputting commands ==

The console is also the chat window in multiplayer. You need to type '/c' in front of your commands, otherwise it is just a chat message!
The console has an inbuilt history. You can use the "cursor-up"-key to repeat or quickly edit and re-issue previous commands.

The game ignores newlines when pasting "scriptlets" in the console. This means they can be written in a human readable form in an editor and copy/pasted into the console, making understanding and editing a bit easier.

On the other hand, if you want to type ''several commands in one line'' you just need to put ';' (semicolon) between the commands - see examples below.

= Example"cheat" commands =
Information for additional commands may be found in the [[Modding|modding-section]]

== Use it as calculator ==
(see [[#Inputting commands|Inputting Commands]]: you can repeat a prior command with the "cursor up"-key!)
/c game.local_player.print(1234 * 5678)

== Mine faster ==
/c game.local_player.force.manual_mining_speed_modifier=1000

== Craft faster ==
/c game.local_player.force.manual_crafting_speed_modifier=1000

== Zoom beyond normal bounds ==
/c game.local_player.zoom = 0.1

== Use print() instead of game.local_player.print() ==
[http://www.factorioforums.com/forum/viewtopic.php?f=41&t=5638 Use print() instead of game.local_player.print()] (forums)
/c print = function(text) game.local_player.print(text) end

== Check water level in a pipe ==
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6066&p=47758#p47758 Check water level in a pipe] (forums)
Hold cursor over the target pipe and execute:
/c game.local_player.print(game.local_player.selected.get_liquid().amount)

== Inventory Manipulation ==
=== Refill resources (refill oil, iron etc.) ===
While holding the cursor over a resource in-game
/c game.local_player.selected.amount=7500

=== Add 100 iron plates to your inventory ===
/c game.local_player.insert{name="iron-plate", count=100}

== World Manipulation ==
=== Turn off night ===
/c game.always_day=true

=== Add new resource patch ===
This creates a new 5x5 patch of resources, centered on the player character. For resources other than stone, just change "stone" to "iron-ore", "copper-ore", or "coal"

/c local surface = game.local_player.surface;
for y=-2,2 do
for x=-2,2 do
surface.create_entity({name="stone", amount=5000, position={game.local_player.position.x+x, game.local_player.position.y+y}})
end
end

=== Destroy rocks in sandbox-mode ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=5686 Destroy rocks in sandbox-mode (forums)] - you don't have a player here, so you can't destroy anything.
/c for _,entity in pairs(game.local_player.surface.find_entities_filtered{
area={{game.local_player.position.x-32, game.local_player.position.y-32},
{game.local_player.position.x+32, game.local_player.position.y+32}},
name="stone-rock"})
do
entity.destroy()
end
you need to center the rock in your vision range

=== Generate a section of the world and explore it at the same time ===
[http://www.factorioforums.com/forum/viewtopic.php?f=14&t=4761&p=44184#p44184 Generate a section of the world and explore it at the same time] (forums)
/c game.local_player.force.chart(game.local_player.surface,{lefttop = {x = -1024, y = -1024}, rightbottom = {x = 1024, y = 1024}})

Simply change the bounding box to the size you want and it will generate the map and explore it in that area. Keep In mind that command is telling Factorio to generate 64*64 (4096) chunks so it's going to take a while before all the background entity generation (trees, resources, biters) are placed in the world.

== Enemy/Evolution ==
=== Check how far the biters have evolved ===
/c game.local_player.print(game.evolution_factor)

=== Disable evolution & increases pollution evolution ===
[http://www.factorioforums.com/forum/viewtopic.php?f=34&t=10159 Disable evolution, increases pollution evolution instead] (forums)
/c game.mapsettings.enemy_evolution.time_factor = 0.000008 * 0
/c game.mapsettings.enemy_evolution.pollution_factor = 0.00003 * 2

=== Kill all biters on the "enemy" force ===
/c game.forces["enemy"].kill_all_units()

=== Remove all enemies from the map ===
/c local surface = game.local_player.surface
for c in surface.get_chunks() do
for key, entity in pairs(surface.find_entities_filtered({area={{c.x * 32, c.y * 32}, {c.x * 32 + 32, c.y * 32 + 32}}, force= "enemy"})) do
entity.destroy()
end
end

=== Enable peaceful mode ===
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9020 Switching on peaceful mode] (forums)
/c game.peaceful_mode = true
/c game.forces["enemy"].kill_all_units()

== Player Character ==
=== Spawn a player character ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=19447&p=124039#p123991 Custom Scenario: How to spawn a character at a certain point (instead of being in god-mode] (forums)
/c game.local_player.character = game.local_player.surface.create_entity{name="player", position = {0,0}, force = game.forces.player}

=== Change Player color ===
[http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9028 Player color] (forums)
/c game.local_player.color={g=50,b=200,r=200,a=.9}

== Research ==
=== Enable faster research ===
/c game.local_player.force.laboratory_speed_modifier = 1
1 is normal speed, 2 is double speed 3 is triple etc. I think it goes up to 100.

=== Enabling specific technologies ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6633 Enabling technologies] (forums)
/c game.local_player.force.technologies['electric-energy-distribution-1'].researched=true
/c game.local_player.force.technologies['steel-processing'].researched=true

=== Finish research immediately ===
/c for name,technology in pairs(game.local_player.force.technologies) do technology.researched=technology.enabled end

== Get robot count within network ==
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=9867&p=78209#p78209 Where can I see how many Robots are in my network?] (forums)

Note that these are no longer needed because the roboport now provides accurate robot counts.

=== Count all '''active robots'''===
/c game.local_player.print(game.local_player.force.get_entitycount("logistic-robot"))
/c game.local_player.print(game.local_player.force.get_entitycount("construction-robot"))

=== Count all '''active and inactive robots''' in the network, but misses the ones flying over gaps in coverage ===
/c robots = {};
roboports = {};
logistic = 0;
construction = 0;
recurse = function(r)
id = r.position.x .. "," .. r.position.y;
if (roboports[id] or r.force.name ~= game.player.force.name) then return end;
roboports[id] = true;
logistic = logistic + r.getinventory(1).getitemcount("logistic-robot");
construction = construction + r.getinventory(1).getitemcount("construction-robot");
ids = {};
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="construction-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
construction = construction + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="logistic-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
logistic = logistic + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, roboport in ipairs(game.findentitiesfiltered{area={{r.position.x-48.5, r.position.y-48.5}, {r.position.x+48.5, r.position.y+48.5}}, name="roboport"}) do;
recurse(roboport);
end;
end;
p = game.player.character.position;
roboport = game.findentitiesfiltered{area={{p.x-48.5, p.y-48.5}, {p.x+48.5, p.y+48.5}}, name="roboport"}[1];
if (roboport) then;
recurse(roboport);
game.player.print("Robots in network: Construction:" .. construction .. " Logistic:" .. logistic);
else;
game.player.print("Not in range of a roboport.");
end

= See also =

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=7981 Superspeedrun]
* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=4752 The Console: What is it and How do I use it?]
: Some interesting cheats or useful commands and tips.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6942&p=543H57#p54357 Totaly new player -> setting up a game]:
# Preface all console commands with /c in .11.0+

# Set player to white
game.local_player.color = {g=1,b=1,r=1,a=.9}

# remove old player
game.remove_offline_player("username")

# Technology and Recipe unlocking
game.local_player.force.reset_technologies()
game.local_player.force.reset_recipes()
game.local_player.force.enable_all_technologies() # does not research them (see below)
game.local_player.force.enable_all_recipes()
game.local_player.force.research_all_technologies()
game.local_player.force.technologies["technology-name"].researched = true

# cheating
game.local_player.force.manual_mining_speed_modifier = 200
game.local_player.force.manual_crafting_speed_modifier = 200
game.speed = 2
game.freeze_day_time()
game.always_day = true
game.peaceful_mode = true
game.local_player.insert{name="item-name", count=1}

Console

2016-05-29T08:08:17Z

JohnnyWing: /* How to open the console? */ - removed redundant message re: '/c' command prefix

{{Languages}}

{{stub|This article needs to be completely rewritten.}}

The console is the built in interface for lua-commands. It works a bit like any command-line-interface or the java-script-console for your browser.

Basically you can fire here all commands, like from any other lua-program (= [[Modding]]). This means you have full access to all in-game-internals.

In other words: Factorio doesn't need any special cheats, it has a console, which allows you to cheat around any limition, if you know how.

== How to open the console? ==

You open the console by default with the key''' '/' or '~''''. This is the chat window in multiplayer. You need to type '/c' in front of your commands, otherwise it is just a chat message!

To change that key go into the keyboard control and change "Toggle Lua console" to a useful key.

=== Editing ===

The console has an inbuilt history. You can use the "cursor-up"-key to edit/repeat the previous commands.

The game ignores newlines when pasting "scriptlets" in the console. This means they can be written in a human readable form in an editor and copy/pasted into the console, making understanding and editing a bit easier.

On the other hand, if you want to type ''several commands in one line'' you just need to put ';' (semicolon) between the commands - see examples down below.

== Useful commands (cheats) ==

The 0.12.x updated added a _ to a the majority of the methods and properties.

* Remove all enemies from the map
/c local surface = game.local_player.surface
for c in surface.get_chunks() do
for key, entity in pairs(surface.find_entities_filtered({area={{c.x * 32, c.y * 32}, {c.x * 32 + 32, c.y * 32 + 32}}, force= "enemy"})) do
entity.destroy()
end
end

* Use it as command-line-calculator (see above: you can repeat command with the "cursor up"-key!)
/c game.local_player.print(1234 * 5678)

* Check how far the biters have evolved
/c game.local_player.print(game.evolution_factor)

* Turn off night
/c game.always_day=true

* Zoom out to place blueprints, that are bigger than your screen.
/c game.local_player.zoom = 0.1

* Kill all biters on the "enemy" force
/c game.forces["enemy"].kill_all_units()

* Add 100 iron plates to your inventory
/c game.local_player.insert{name="iron-plate", count=100}

* Refill resources (refill oil, iron etc.)
While holding the cursor over a resource in-game
/c game.local_player.selected.amount=7500

* Add new resource patch
This creates a new 5x5 patch of resources, centered on the player character. For resources other than stone, just change "stone" to "iron-ore", "copper-ore", or "coal"

/c local surface = game.local_player.surface;
for y=-2,2 do
for x=-2,2 do
surface.create_entity({name="stone", amount=5000, position={game.local_player.position.x+x, game.local_player.position.y+y}})
end
end

* Finish research
/c for name,technology in pairs(game.local_player.force.technologies) do technology.researched=technology.enabled end

* Mine faster
/c game.local_player.force.manual_mining_speed_modifier=1000

* Craft faster
/c game.local_player.force.manual_crafting_speed_modifier=1000

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9020 Switching on peacfulmode]
/c game.peaceful_mode = true
/c game.forces["enemy"].kill_all_units()

* Faster research
/c game.local_player.force.laboratory_speed_modifier = 1
1 is normal speed, 2 is double speed 3 is triple etc. I think it goes up to 100.

* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=5686 Destroy rocks in sandbox-mode] (you don't have a player here, so you can't destroy anything)
/c for _,entity in pairs(game.local_player.surface.find_entities_filtered{
area={{game.local_player.position.x-32, game.local_player.position.y-32},
{game.local_player.position.x+32, game.local_player.position.y+32}},
name="stone-rock"})
do
entity.destroy()
end
you need to center the rock in your vision range

* [http://www.factorioforums.com/forum/viewtopic.php?f=41&t=5638 Use print() instead of game.local_player.print()]
/c print = function(text) game.local_player.print(text) end

* [http://www.factorioforums.com/forum/viewtopic.php?f=14&t=4761&p=44184#p44184 Generate a section of the world and explore it at the same time]
/c game.local_player.force.chart(game.local_player.surface,{lefttop = {x = -1024, y = -1024}, rightbottom = {x = 1024, y = 1024}})

Simply change the bounding box to the size you want and it will generate the map and explore it in that area. Keep In mind that command is telling Factorio to generate 64*64 (4096) chunks so it's going to take a while before all the background entity generation (trees, resources, biters) are placed in the world.

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6066&p=47758#p47758 Check water level in a pipe]
/c game.local_player.print(game.local_player.selected.get_liquid().amount)

* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6633 Enabling technologies]
/c game.local_player.force.technologies['electric-energy-distribution-1'].researched=true
/c game.local_player.force.technologies['steel-processing'].researched=true

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=9028 Player color]
/c game.local_player.color={g=50,b=200,r=200,a=.9}

* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=9867&p=78209#p78209 Where can I see how many Robots are in my network?]
Count all '''active robots'''
/c game.local_player.print(game.local_player.force.get_entitycount("logistic-robot"))
/c game.local_player.print(game.local_player.force.get_entitycount("construction-robot"))

Count all '''active and inactive robots''' in the network, but misses the ones flying over gaps in coverage:
This is no longer needed because the roboport will give accurate counts.
/c robots = {};
roboports = {};
logistic = 0;
construction = 0;
recurse = function(r)
id = r.position.x .. "," .. r.position.y;
if (roboports[id] or r.force.name ~= game.player.force.name) then return end;
roboports[id] = true;
logistic = logistic + r.getinventory(1).getitemcount("logistic-robot");
construction = construction + r.getinventory(1).getitemcount("construction-robot");
ids = {};
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="construction-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
construction = construction + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, robot in ipairs(game.findentitiesfiltered{area={{r.position.x-50, r.position.y-50}, {r.position.x+50, r.position.y+50}}, name="logistic-robot"}) do;
id = robot.position.x .. "," .. robot.position.y;
if ((ids[id] or not robots[id]) and robot.force.name == game.player.force.name) then;
logistic = logistic + 1;
ids[id] = true;
robots[id] = true;
end;
end;
for _, roboport in ipairs(game.findentitiesfiltered{area={{r.position.x-48.5, r.position.y-48.5}, {r.position.x+48.5, r.position.y+48.5}}, name="roboport"}) do;
recurse(roboport);
end;
end;
p = game.player.character.position;
roboport = game.findentitiesfiltered{area={{p.x-48.5, p.y-48.5}, {p.x+48.5, p.y+48.5}}, name="roboport"}[1];
if (roboport) then;
recurse(roboport);
game.player.print("Robots in network: Construction:" .. construction .. " Logistic:" .. logistic);
else;
game.player.print("Not in range of a roboport.");
end

* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=10159 Disable evolution, increases pollution evolution instead]
/c game.mapsettings.enemy_evolution.time_factor = 0.000008 * 0
/c game.mapsettings.enemy_evolution.pollution_factor = 0.00003 * 2

* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=19447&p=124039#p123991 Custom Scenario: How to spawn a character at a certain point (instead of being in god-mode]
/c game.local_player.character = game.local_player.surface.create_entity{name="player", position = {0,0}, force = game.forces.player}

More commands can be looked up in the [[Modding|modding-section]].

== See also ==

* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=7981 Superspeedrun]
* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=4752 The Console: What is it and How do I use it?]
: Some interesting cheats or useful commands and tips.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6942&p=543H57#p54357 Totaly new player -> setting up a game]:
# Preface all console commands with /c in .11.0+

# Set player to white
game.local_player.color = {g=1,b=1,r=1,a=.9}

# remove old player
game.remove_offline_player("username")

# Technology and Recipe unlocking
game.local_player.force.reset_technologies()
game.local_player.force.reset_recipes()
game.local_player.force.enable_all_technologies() # does not research them (see below)
game.local_player.force.enable_all_recipes()
game.local_player.force.research_all_technologies()
game.local_player.force.technologies["technology-name"].researched = true

# cheating
game.local_player.force.manual_mining_speed_modifier = 200
game.local_player.force.manual_crafting_speed_modifier = 200
game.speed = 2
game.freeze_day_time()
game.always_day = true
game.peaceful_mode = true
game.local_player.insert{name="item-name", count=1}

Map editor

2016-05-29T08:02:26Z

JohnnyWing: /* Saving your Scenario */ - added note about how to load saved scenarios

{{Languages}}
'''''This page is heavily a work in progress.'''''

Factorio comes stock-standard with a map editor. You can access it by selecting "Map editor" on your Factorio main menu.

The editor is much like in-game, except there is no player, and you have unlimited resources.

== Loading a Map From a Game ==

See [[Modding#Creating_a_scenario_from_a_saved_game_.28map.29|Modding: Creating a scenario from a saved game]].

== Saving your Scenario ==
Maps created with the map editor are saved as [[Scenarios|Scenarios]] via the in-game escape menu. These scenarios are saved to the [[Application directory|User data directory]]. The scenario may then be played from selecting Play->Custom Scenario from the Main Menu.

== Placing Entities ==
To place an entity (labs, powerlines, transport belts, mining drills, etc...), select "Entities" from your toolbox, select a tool, select what you want to place down, then click somewhere to place that item down.

You have three tools.
=== Cursor ===
Appropriate for most situations. Places one of the selected entity at the current cursors position. Much like the normal in-game mechanics.

'''Tip:''' Pressing "Q" on your keyboard will put the item you're holding away.

=== Spray ===
Good for resource piles and trees. You can select a size, intensity and speed, the larger the size, the more area that the spray places entities, the higher the intensity, the more often entities get placed, the higher the speed, the more rapidly the spray continues spraying while holding down the mouse button.

=== Paintbrush ===
The paintbrush is virtually the same as the spray, only difference is that if you hold down the mouse button, the tool won't continue to place entities. Also good for resource piles and trees. Whether you use spray or paintbrush is personal preference.

== Deleting Entities ==
==== Cursor ====
When using the cursor tool, you can hover over the entity you wish to delete, and press "X" on your keyboard.

==== Spray/Paintbrush ====
When using either the spray or the paintbrush, right click to "unspray" - though, this process can be slow, using the cursor to delete entities is much more efficient.

== Placing Items ==
You can place items for the player to pick up in the editor. To do this, select the "Items" tab. From there, select what you wish to place down, then hover your mouse to where you wish to place the item down and right-click.

To delete items that you've placed, just like when placing entities, press "X" on your keyboard while hovering over the item you want to delete.

== Placing Items Inside Chests (and other entities) ==

Press Q to deselect everything you currently hold in hand. After that left click on an entity to open its inventory. Now you can place items in that inventory. Based on your game settings you might need to use another event, see in the game-options.

== Set up research ==

http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6219

Map editor

2016-05-29T08:00:30Z

JohnnyWing: Added section explaining that saving an edited map results in a 'scenario'

{{Languages}}
'''''This page is heavily a work in progress.'''''

Factorio comes stock-standard with a map editor. You can access it by selecting "Map editor" on your Factorio main menu.

The editor is much like in-game, except there is no player, and you have unlimited resources.

== Loading a Map From a Game ==

See [[Modding#Creating_a_scenario_from_a_saved_game_.28map.29|Modding: Creating a scenario from a saved game]].

== Saving your Scenario ==
Maps created with the map editor are saved as [[Scenarios|Scenarios]] via the in-game escape menu. These scenarios are saved to the [[Application directory|User data directory]].

== Placing Entities ==
To place an entity (labs, powerlines, transport belts, mining drills, etc...), select "Entities" from your toolbox, select a tool, select what you want to place down, then click somewhere to place that item down.

You have three tools.
=== Cursor ===
Appropriate for most situations. Places one of the selected entity at the current cursors position. Much like the normal in-game mechanics.

'''Tip:''' Pressing "Q" on your keyboard will put the item you're holding away.

=== Spray ===
Good for resource piles and trees. You can select a size, intensity and speed, the larger the size, the more area that the spray places entities, the higher the intensity, the more often entities get placed, the higher the speed, the more rapidly the spray continues spraying while holding down the mouse button.

=== Paintbrush ===
The paintbrush is virtually the same as the spray, only difference is that if you hold down the mouse button, the tool won't continue to place entities. Also good for resource piles and trees. Whether you use spray or paintbrush is personal preference.

== Deleting Entities ==
==== Cursor ====
When using the cursor tool, you can hover over the entity you wish to delete, and press "X" on your keyboard.

==== Spray/Paintbrush ====
When using either the spray or the paintbrush, right click to "unspray" - though, this process can be slow, using the cursor to delete entities is much more efficient.

== Placing Items ==
You can place items for the player to pick up in the editor. To do this, select the "Items" tab. From there, select what you wish to place down, then hover your mouse to where you wish to place the item down and right-click.

To delete items that you've placed, just like when placing entities, press "X" on your keyboard while hovering over the item you want to delete.

== Placing Items Inside Chests (and other entities) ==

Press Q to deselect everything you currently hold in hand. After that left click on an entity to open its inventory. Now you can place items in that inventory. Based on your game settings you might need to use another event, see in the game-options.

== Set up research ==

http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6219

Application directory

2016-05-29T07:52:06Z

JohnnyWing: /* User Data directory */ - added player data, reworded config file deletion statement

{{Languages}}
= Overview =
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.
== Application directory ==
The application directory stores
* Factorio executables (./bin)
* Data for vanilla Factorio (./data)
* API documentation

== User Data directory ==
* Save games (as zip files within ./saves)
* User-installed/created [[Mods]] (./mods)
* User-installed/created [[scenarios]] (./scenarios)
* User configuration (./config)
* [[Log File]] (factorio-*.log)
* Player data (player-data.json)

Note: Deleting the configuration file will result in a replacement being generated upon the next Factorio launch.

It is recommended to create backups from this directory before installing a new version.

= Directory locations by OS and installation method =
== Windows ==
=== Installation via Steam ===
Application directory:
C:\Program Files (x86)\Steam\steamapps\common\Factorio
User data directory:
%appdata%\factorio

=== Installation by Zip-package ===
Application directory and User data directory will be the location to which Factorio was unpacked.

:For example, if you unpacked the zip to:
C:\Factorio
:Then your saves can be found in:
C:\Factorio\saves
:and mods in:
C:\Factorio\mods

=== Installation via Installer ===
Application directory:
C:\Users\<username>\AppData\Roaming\Factorio
User data directory:
%appdata%\factorio

== MacOSx ==
The application should be by default installed in the Apps-folder.

Whereas the data is stored under
/users/<replace with your username>/Library/Application Support/factorio

Which is equivalent to
~/Library/Application Support/factorio
You can type in this into the Finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.'
Or you can use in Finder the 'Find a folder' and write '~/Library/Application Support' (See [http://www.factorioforums.com/forum/viewtopic.php?f=49&t=9345 Can't find Mods folder]).

The factorio internal application-data can be found (when you have installed it) in

/Applications/factorio.app/Contents/data

Same directory structure as in Application support.

== Linux ==
Data is stored under
__Game_Install_Directory__

=== Installation via Steam ===
Data is stored under
~/.factorio

=Changing the application directory=

You can create a file <code>config-path.config</code> to configure Factorio to any directory.

'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).

'''Windows''': there is also the [[Install_guide#Installer_or_Zip-Package|ZIP-Package]], that can be installed in any directory.

=== The following discussion applies to version 0.11.13. ===

In order to change the application directory, user must edit the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.

If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.

===Linux===
Update <code>__Game_Install_directory/config-path.cfg</code>

use-system-read-write-data-directories=true

Update <code>__Game_Install_directory/config/config.ini</code>

[path]
read-data=__PATH__executable__/../../data
write-data=.local/share/factorio

You could set the <code>write-data</code> value to '''<code>.factorio</code>''' if you prefer.

Once you have done this, you can remove write permissions to the entire game installation directory '''except''' for <code>config/config.ini</code>, which '''must''' be writable by all people who wish to play the game.

Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.

= See also =
* [[Download and Installation]]
* [[Install Guide]]
* [[Mods]]
* [[Installing Mods]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Application directory

2016-05-29T07:44:26Z

JohnnyWing: Restructured page and added details on the user data and the application directories

{{Languages}}
= Overview =
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.
== Application directory ==
The application directory stores
* Factorio executables (./bin)
* Data for vanilla Factorio (./data)
* API documentation

== User Data directory ==
* Save games (as zip files within ./saves)
* User-installed/created [[Mods]] (./mods)
* User-installed/created [[scenarios]] (./scenarios)
* User configuration (./config)
* [[Log File]] (factorio-*.log)

You can delete for example the configuration-file; it will be generated new with the defaults.

It is recommended to create backups from this directory before installing a new version.

= Directory locations by OS and installation method =
== Windows ==
=== Installation via Steam ===
Application directory:
C:\Program Files (x86)\Steam\steamapps\common\Factorio
User data directory:
%appdata%\factorio

=== Installation by Zip-package ===
Application directory and User data directory will be the location to which Factorio was unpacked.

:For example, if you unpacked the zip to:
C:\Factorio
:Then your saves can be found in:
C:\Factorio\saves
:and mods in:
C:\Factorio\mods

=== Installation via Installer ===
Application directory:
C:\Users\<username>\AppData\Roaming\Factorio
User data directory:
%appdata%\factorio

== MacOSx ==
The application should be by default installed in the Apps-folder.

Whereas the data is stored under
/users/<replace with your username>/Library/Application Support/factorio

Which is equivalent to
~/Library/Application Support/factorio
You can type in this into the Finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.'
Or you can use in Finder the 'Find a folder' and write '~/Library/Application Support' (See [http://www.factorioforums.com/forum/viewtopic.php?f=49&t=9345 Can't find Mods folder]).

The factorio internal application-data can be found (when you have installed it) in

/Applications/factorio.app/Contents/data

Same directory structure as in Application support.

== Linux ==
Data is stored under
__Game_Install_Directory__

=== Installation via Steam ===
Data is stored under
~/.factorio

=Changing the application directory=

You can create a file <code>config-path.config</code> to configure Factorio to any directory.

'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).

'''Windows''': there is also the [[Install_guide#Installer_or_Zip-Package|ZIP-Package]], that can be installed in any directory.

=== The following discussion applies to version 0.11.13. ===

In order to change the application directory, user must edit the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.

If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.

===Linux===
Update <code>__Game_Install_directory/config-path.cfg</code>

use-system-read-write-data-directories=true

Update <code>__Game_Install_directory/config/config.ini</code>

[path]
read-data=__PATH__executable__/../../data
write-data=.local/share/factorio

You could set the <code>write-data</code> value to '''<code>.factorio</code>''' if you prefer.

Once you have done this, you can remove write permissions to the entire game installation directory '''except''' for <code>config/config.ini</code>, which '''must''' be writable by all people who wish to play the game.

Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.

= See also =
* [[Download and Installation]]
* [[Install Guide]]
* [[Mods]]
* [[Installing Mods]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Application directory

2016-05-29T07:33:00Z

JohnnyWing: /* Windows */ - indentation revert from my last edit

{{Languages}}
The application directory stores
* the saves (every save is a zip-file)
* the [[Mods]]
* scenarios
* configuration
* [[Log File]] (since v0.10.0).

The directory structure is self-explaining.

You can delete for example the configuration-file; it will be generated new with the defaults.

It is recommended to create backups from this directory, before you install a new version.

== Windows ==
=== Installation via Steam ===
Application directory:
C:\Program Files (x86)\Steam\steamapps\common\Factorio
User data directory:
%appdata%\factorio

=== Installation by Zip-package ===
Application directory and User data directory will be the location to which Factorio was unpacked.

:For example, if you unpacked the zip to:
C:\Factorio
:Then your saves can be found in:
C:\Factorio\saves
:and mods in:
C:\Factorio\mods

=== Installation via Installer ===
Application directory:
C:\Users\<username>\AppData\Roaming\Factorio
User data directory:
%appdata%\factorio

== MacOSx ==
The application should be by default installed in the Apps-folder.

Whereas the data is stored under
/users/<replace with your username>/Library/Application Support/factorio

Which is equivalent to
~/Library/Application Support/factorio
You can type in this into the Finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.'
Or you can use in Finder the 'Find a folder' and write '~/Library/Application Support' (See [http://www.factorioforums.com/forum/viewtopic.php?f=49&t=9345 Can't find Mods folder]).

The factorio internal application-data can be found (when you have installed it) in

/Applications/factorio.app/Contents/data

Same directory structure as in Application support.

== Linux ==
Data is stored under
__Game_Install_Directory__

=== Installation via Steam ===
Data is stored under
~/.factorio

==Changing the application directory==

You can create a file <code>config-path.config</code> to configure Factorio to any directory.

'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).

'''Windows''': there is also the [[Install_guide#Installer_or_Zip-Package|ZIP-Package]], that can be installed in any directory.

=== The following discussion applies to version 0.11.13. ===

It is possible to change the application directory location for Factorio.

This can be done by editing the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.

If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.

===Linux===
Update <code>__Game_Install_directory/config-path.cfg</code>

use-system-read-write-data-directories=true

Update <code>__Game_Install_directory/config/config.ini</code>

[path]
read-data=__PATH__executable__/../../data
write-data=.local/share/factorio

You could set the <code>write-data</code> value to '''<code>.factorio</code>''' if you prefer.

Once you have done this, you can remove write permissions to the entire game installation directory '''except''' for <code>config/config.ini</code>, which '''must''' be writable by all people who wish to play the game.

Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.

== See also ==

* [[Download and Installation]]
* [[Install Guide]]
* [[Mods]]
* [[Installing Mods]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Application directory

2016-05-29T07:31:05Z

JohnnyWing: /* Windows */ - Added steam path info, formatting, standardized sub-sections

{{Languages}}
The application directory stores
* the saves (every save is a zip-file)
* the [[Mods]]
* scenarios
* configuration
* [[Log File]] (since v0.10.0).

The directory structure is self-explaining.

You can delete for example the configuration-file; it will be generated new with the defaults.

It is recommended to create backups from this directory, before you install a new version.

== Windows ==
=== Installation via Steam ===
:Application directory:
C:\Program Files (x86)\Steam\steamapps\common\Factorio
:User data directory:
%appdata%\factorio

=== Installation by Zip-package ===
:Application directory and User data directory will be the location to which Factorio was unpacked.

::For example, if you unpacked the zip to:
C:\Factorio
::Then your saves can be found in:
C:\Factorio\saves
::and mods in:
C:\Factorio\mods

=== Installation via Installer ===
:Application directory:
C:\Users\<username>\AppData\Roaming\Factorio
:User data directory:
%appdata%\factorio

== MacOSx ==
The application should be by default installed in the Apps-folder.

Whereas the data is stored under
/users/<replace with your username>/Library/Application Support/factorio

Which is equivalent to
~/Library/Application Support/factorio
You can type in this into the Finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.'
Or you can use in Finder the 'Find a folder' and write '~/Library/Application Support' (See [http://www.factorioforums.com/forum/viewtopic.php?f=49&t=9345 Can't find Mods folder]).

The factorio internal application-data can be found (when you have installed it) in

/Applications/factorio.app/Contents/data

Same directory structure as in Application support.

== Linux ==
Data is stored under
__Game_Install_Directory__

=== Installation via Steam ===
Data is stored under
~/.factorio

==Changing the application directory==

You can create a file <code>config-path.config</code> to configure Factorio to any directory.

'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).

'''Windows''': there is also the [[Install_guide#Installer_or_Zip-Package|ZIP-Package]], that can be installed in any directory.

=== The following discussion applies to version 0.11.13. ===

It is possible to change the application directory location for Factorio.

This can be done by editing the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.

If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.

===Linux===
Update <code>__Game_Install_directory/config-path.cfg</code>

use-system-read-write-data-directories=true

Update <code>__Game_Install_directory/config/config.ini</code>

[path]
read-data=__PATH__executable__/../../data
write-data=.local/share/factorio

You could set the <code>write-data</code> value to '''<code>.factorio</code>''' if you prefer.

Once you have done this, you can remove write permissions to the entire game installation directory '''except''' for <code>config/config.ini</code>, which '''must''' be writable by all people who wish to play the game.

Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.

== See also ==

* [[Download and Installation]]
* [[Install Guide]]
* [[Mods]]
* [[Installing Mods]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Modding

2016-05-29T06:15:17Z

JohnnyWing: minor formatting/rewording

{{Languages}}
{{sublinks|Main Page}}
[[File:Fff-18-entity-graph.jpg|400px|thumb|'Diagram of entities' (objects on the map) class inheritance structure generated by doxygen. Taken From Friday Facts #18 http://www.factorio.com/blog/post/fff-18]]

Modding in Factorio allows for more content created by the community.

==Getting started==
A good overview is the [[Mods| list of mods]] or the [http://www.factorioforums.com/forum/index.php Factorio forum].

A good starting point is also the [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board]. The community is always answering to concrete questions. Sometimes within minutes. Or you could try the [[Modding FAQ]] page.

The [http://lua-api.factorio.com/ Official Lua API documentation] is a great reference for understanding the Factorio functions and types in the game.

==Licensing==
All mods require a license since v0.11. If a mod has no license it is assumed to have a Creative Commons [http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)] license.

See also
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
: In this article the devs explain also, that the base-mod (which is part of Factorio) can be used to create new mods, but not used for "outside of Factorio domain".
* http://www.factorio.com/terms-of-service

==Creating a scenario from a saved game (map)==
An often asked question is how to make a scenario (something which can be edited in the map editor) from a map:
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

[[GameClient|More about the client parameters]]

==Creating scenarios with the map editor==
Another first step is also making maps with the ingame editor. That stores the map as a '''scenario''', which is just a directory on disk with some files in it. You can look into those files to get a better understanding as to what they are for, or you can read the following pages:

==Overview==
* [[Modding overview]]
* [[Prototype definitions]]
* [[Data.raw]]
* [[Lua/Events|Lua events]]
* [[Lua objects]]
* [[Script interfaces]]
* [[Lua/Data Lifecycle]]
* [[Migration scripts]]
* [[Modding FAQ]]
* [[Modding Tutorial]]

==Other interesting stuff==
* Tutorial: [http://www.factorioforums.com/forum/viewtopic.php?f=15&t=8613 Create graphics for your mod...], how to generate sprite maps