Xdo Console A Eau
Requesting access for service: WVU Services. Manage your Login account.
This wiki is about 0.17, the current experimental version of Factorio.
Information about 0.16, the current stable version of Factorio, can be found on stable.wiki.factorio.com.
- 1Overview
- 5Basic example scripts
- 6Inventory manipulation scripts
- 7World manipulation scripts
- 8Enemy/evolution scripts
- 9Player character scripts
- 10Research scripts
- 11Command line parameters
- 12Modding tools
Overview
The Console is Factorio's command-line interface.
The in-game console is used for:
- Chatting with other players
- Running commands / scripts / cheats
- Occasional status updates
There are three types of commands:
- Normal - Display information about the game and customize your experience.
- Multiplayer - Message filtering, banning users, etc.
- Scripting/Cheating - Run small Lua scripts (but they disable achievements for the save game)
Using the console
The console display can be toggled with the / (slash) or ~ (tilde) keys.
You can customize the keys via Options Menu → Keyboard → Toggle Lua console.When the console is open, you'll see a blinking cursor at the bottom of the screen; type your message or command and hit Return to send it (this will also close the console).Documentation about message and command prefixes can be found further down this page.
The console supports rich text tags. These tags are useful for sharing blueprints, marking map locations in chat or adding icons to map markers and train stations. Ctrl+alt clicking the map or ground will automatically insert a gps tag and post it into the console. Shift clicking most things with the console open will insert a tag for that thing into chat.
When console is closed, only the most recent messages/commands will be displayed, but they will gradually fade away (opening the console will immediately re-display all recent messages).Note that by default, all executed commands are made visible to all users. You can set the fade out time via Options Menu → Other Settings → Message Delay.
If you want to immediately hide the console, open the console and then press Escape key (or press Return without entering any message/command).This not only closes the console, but it also hides all the recent messages/commands.The console can be cleared with the /clear command.
Note that the console can also accept raw Lua code as well as game commands.
Console history
The console has an inbuilt history; it's a bit like a text editor where only one line of text is displayed at a time.
Use the ↑ and ↓ keys to scroll through the console history.
Use the ← and → keys to cursor through the currently displayed message or command, which you can edit (delete, insert, etc.) and resend (by pressing Return).
The Tab key will auto-complete commands and player ids.
Normal commands
Command | Example | Description | Admin only |
---|---|---|---|
/alerts <enable/disable/mute/unmute> <alert> | /alerts disable turret_fire | Enables, disables, mutes, or unmutes the given alert type. Available alerts: entity_destroyed, entity_under_attack, not_enough_construction_robots, no_material_for_construction, not_enough_repair packs, turret_fire, custom, no_storage, train_out_of_fuel, fluid_mixing. | No |
/clear | /clear | Clears the console. | No |
/color <color> | /color 20 255 255 100 | Changes your color. Can either be one of the pre-defined colors or RGBA value in the format of “# # # #”. Available colors: default, red, green, blue, orange, yellow, pink, purple, white, black, gray, brown, cyan, acid. | No |
/evolution | /evolution | Prints info about the alien evolution factor. | No |
/help [command] | /help | Prints a list of available commands, the optional argument can specify the command that should be described. | No |
/h [command] | /h | Same as /help. | No |
/mute-programmable-speaker <mute/unmute> <local/everyone> | /mute-programmable-speaker mute local | Mutes or unmutes the global sounds created by the Programmable Speaker. Use “local” to mute just the local client. Admins can use “everyone” to mute the sounds for everyone on the server. | No |
/perf-avg-frames <number> | /perf-avg-frames 100 | Number of ticks/updates used to average performance counters. Default is 100. Value of 5-10 is recommended for fast convergence, but numbers will jitter more rapidly. | No |
/permissions | /permissions | Opens the permissions GUI. | Yes |
/screenshot [x resolution] [y resolution] [zoom] | /screenshot | Takes a screenshot with the GUI hidden, centered on the player. It is saved in the 'script-output' subfolder of your User data directory. Resolution is optional and defaults to the current window size. Zoom is optional and defaults to 1. | No |
/seed | /seed | Prints the starting map seed. | No |
/time | /time | Prints info about how old the map is. | No |
/toggle-action-logging | /toggle-action-logging | Toggles logging all input actions performed by the game. This value isn’t persisted between game restarts and only affects your local game in multiplayer sessions. | Yes |
/toggle-heavy-mode | /toggle-heavy-mode | Used to investigate desyncs. Will slow down the game and make multiplayer unplayable. | Yes |
/toggle-rockets-sent-gui | /toggle-rockets-sent-gui | Toggles if the rockets sent button is shown in the upper left corner of the screen. | No |
/unlock-shortcut-bar | /unlock-shortcut-bar | Unlocks all shortcut bar items. | No |
/version | /version | Prints the current game version. | No |
Multiplayer commands
Command | Example | Description | Admin only |
---|---|---|---|
<message> | Hello team! | Console input that does not start with / is shown as a chat message to your team. | No |
/admin | /admin | Opens the player management GUI. | Yes |
/admins | /admins | Prints a list of game admins. | No |
/ban <player> <reason> | /ban xTROLLx Throwing grenades in base | Bans the specified player. | Yes |
/banlist <add/remove/get/clear> <player> | /banlist get | Adds or removes a player from the banlist. Same as /ban or /unban. | No |
/config <get/set> <option> <value> | /config set password hunter2 | Gets or sets various multiplayer game settings. Available configs are: afk-auto-kick, allow-commands, allow-debug-settings, autosave-interval, autosave-only-on-server, ignore-player-limit-for-returning-players, max-players, max-upload-speed, only-admins-can-pause, password, require-user-verification, visibility-lan, visibility-public. | Yes |
/delete-blueprint-library <player> | /delete-blueprint-library everybody confirm | Deletes the blueprint library storage for the given offline player from the save file. Enter “everybody confirm” to delete the storage of all offline players. | Yes |
/demote <player> | /demote AzureDiamond | Demotes the player from admin. | Yes |
/ignore <player> | /ignore Cthon98 | Prevents the chat from showing messages from this player. Admin messages are still shown. | No |
/ignores | /ignores | Prints a list of ignored players. | No |
/kick <player> <reason> | /kick xTROLLx Throwing grenades in base | Kicks the specified player. | Yes |
/mute <player> | /mute Cthon98 | Prevents the player from saying anything in chat. | Yes |
/mutes | /mutes | All players that are muted (can’t talk in chat). | No |
/open <player> | /open AzureDiamond | Opens another player’s inventory. | Yes |
/o <player> | /o AzureDiamond | Same as /open. | Yes |
/players [online/o/count/c] | /players | Prints a list of players in the game. (parameter online/o, it prints only players that are online, count/c prints only count) | No |
/promote <player> | /promote AzureDiamond | Promotes the player to admin. | Yes |
/purge <player> | /purge Cthon98 | Clears all the messages from this player from the chat log. | Yes |
/reply <message> | /reply oh, really? | Replies to the last player that whispered to you. | No |
/r <message> | /r oh, really? | Same as /reply. | No |
/server-save | /server-save | Saves the game on the server in a multiplayer game. | Yes |
/shout <message> | /shout Hello world! | Sends a message to all players including other forces. | No |
/s <message> | /s Hello world! | Same as /shout. | No |
/swap-players <player> [player] | /swap-players AzureDiamond | Swaps your character with the given player’s character, or if two players are given swaps the two player characters. | Yes |
/unban <player> | /unban xTROLLx | Unbans the specified player. | Yes |
/unignore <player> | /unignore Cthon98 | Allows the chat to show messages from this player. | No |
/unmute <player> | /unmute Cthon98 | Allows the player to talk in chat again. | Yes |
/whisper <player> <message> | /whisper AzureDiamond thats what I see | Sends a message to the specified player. | No |
/w <player> <message> | /w AzureDiamond thats what I see | Same as /whisper. | No |
/whitelist <add/remove/get/clear> [player] | /whitelist get | Adds or removes a player from the whitelist, where only whitelisted players can join the game. Enter nothing for “player” when using “get” to print a list of all whitelisted players. An empty whitelist disables the whitelist functionality allowing anyone to join. | No |
Scripting and cheat commands
Command | Description |
---|---|
/cheat <all> | Researches all technologies and enables cheat mode. Using the all option also gives the player some additional items. |
/command <command> | Executes a Lua command. |
/c <command> | Executes a Lua command. |
/editor | Toggles the map editor. |
/measured-command <command> | Executes a Lua command and measures time it took. |
/silent-command <command> | Executes a Lua command without printing it to the console. |
This is a very powerful feature, which also allows cheating, and as such achievements will be permanently disabled for the save as soon as you use a script command.
Basic example scripts
Use it as calculator
Zoom beyond normal bounds
Note that zooming too far out can cause performance hits. Be careful.
Mine faster
Craft faster
Unlock and research all technologies
Undo this with the command in the next section.
Unresearch all technologies
This does not reset manually applied bonuses
Reset your force
Good boys trailer song full. This resets all data for your force, including kill and production statistics, technologies, bonuses and charting status.
Always show rail block visualization
Permanently show the rail block visualization instead of only when holding a rail signal. Disable by replacing true with false.
Inventory manipulation scripts
Cheat mode
Allows for infinite free crafting. Disable by replacing true with false.
Refill resources (refill oil, iron etc.)
While holding the cursor over a resource tile in-game
Alternatively you can refill all resources in the map with the following command. Change ore.amount to the desired value.
Add items to the player's inventory
Replace iron-plate with the internal name of the item desired.
For instance, here's a stack of the god-mode energy system interface:
Add a powerful armor with equipment and some tools for construction:
World manipulation scripts
Reveal the map around the player
Reveals the map around the player, similar to a radar.
or from start position
Change 150 to the desired radius, higher values take longer.
Hide revealed map
Hides all revealed chunks, inverted map revealing.
Delete chunks
If much of the map is revealed, it increases the size of the save file. The following command cancels the generation of all chunks that are currently queued for generation and removes chunks outside a 32 chunks radius around 0,0. Note that this will remove player entities if there are any on these chunks.
Turn off night
Enables eternal day.
Change game speed
0.5 is half speed, 1 is default, 2 is double speed, etc. Minimum is 0.01. This can be used for a lot of things like when you know you will have to wait for long periods of time for something to complete. Increasing will decrease performance, be careful.
Expensive (marathon) or normal mode
To change from normal to expensive mode preset (this changes the research cost and intermediate product cost):
To change back to normal:
Freeze time
Stops the advancement of the time if you replace 'BOOL' with 'true' or unfreezes it if you replace it with 'false'.
Remove all pollution
Completely turn off pollution
Add a lot of pollution
Where speakers are, by who
Disable friendly fire for your force
Add new resource patch
This creates a new 11×11 patch of resources, centered on the player character, where the ground is not water.The patch it creates is perfectly square but it randomizes the amount similar to natural generation, with fewer ore at the edges and more ore in the center.The default numbers result in a patch with 2500-3000 ore.
If you want a larger patch, change 'local size = 5' to a larger number.A larger patch will have exponentially more ore.Entering a number above 30 is not recommended.
If you want a richer patch, change 'local density = 10' to a larger number.Entering a very large number shouldn't hurt anything but you probably don't need to go above 100.
To choose which resource is spawned, change 'stone' near the bottom to 'iron-ore', 'copper-ore', 'coal', or 'uranium-ore'.
Remove resources around the player
Removes all resource patches from the ground in a 50 x 50 area around the player.
Add new oil patch
Xdo Console A Eau Du
This creates 9 crude oil patches in a 3×3 square.
or randomly without any collision:
Create 10 fishes
This creates 10 fishes around of player. The player must be on the water edge.
Count entities
Counts all entities whose name includes the string in local entity.
Emptying all pipes, underground pipes and pumps
Useful when pipes contain a fluid you dont want.
Turn off cliff generation
Sets size to 'none'. Only effective on chunks that are generated after using this command. Use #Remove all cliffs to delete existing cliffs.
Remove all cliffs
Removes all cliffs existing cliffs from the world. Use #Turn off cliff generation to turn off cliff generation in new chunks.
Delete all decoratives
Delete the decoratives that can be found in the world.
Change map generation settings
This allows to change the map generation settings for new chunks; it does not alter already generated chunks. Deleted chunks are affected by the setting change because they are newly generated when they get explored again.
To change resource generation settings, replace 'iron-ore' with the resource that should be changed and replace 'very-high' with the desired MapGenSize in the following command. Replace 'iron-ore' with 'enemy-base' to change the enemy base generation settings.
To change water generation settings, replace 'very-high' with the desired MapGenSize in the following command.
Enemy/evolution scripts
Set evolution factor
Ranges from 0 (new game) to 1.
Disable time-based evolution & increases pollution-based evolution
The '2' at the end of the last command will double the default pollution factor. You can substitute another number to increase (or decrease) the pollution factor further.
Kill all biters on the 'enemy' force
Note that this will kill only mobile units, spawners will not be killed.
Kill all enemies
This will kill all biters, bases and worms. Anything that is an enemy will be completely destroyed. This only affects enemies in the explored world, so any unexplored parts of the map which still need to be generated will still have enemies. You can prevent biters being on newly generated chunks if desired.
Kill all nearby enemies
This will kill all biters, bases and worms in a configurable radius. The default, 250 tiles, is about two zoomed-out screen widths on full HD. After destruction, it shows how many objects were destroyed.
Enable/Disable peaceful mode
Enabling peaceful mode prevents biter attacks until provoked. Substitute true for false to disable. Already existing biters are not affected by this command so attacks could continue for a while after activating peaceful mode.
Enable/Disable biter expansion
Biter expansion allows biters to create new nests, it is enabled by default. Substitute true for false to disable.
Prevent biters being on newly generated chunks
On newly generated chunks no biters will be present, however all current biters will remain unaffected. Equivalent of setting the Enemy Base Size to None under the Terrain settings during map generation but achieved mid game by changing map generation settings.
Player character scripts
Commands concerning the player directly.
Get player position
Prints coordinates of your current position.
Teleport player
Moves the player to the specified location. You should be able to teleport to a specific player if you obtain their coordinates via them executing the previous command and giving them to you.
To teleport to the world's origin, use 0,0.
Enable god mode
God mode removes your player character allowing you to fly over obstacles and take no damage.
Disassociate your controls from the player:
Then, hover the mouse over the useless player and destroy it by typing:
To undo, spawn a player character. This will spawn a new player at the spawn point of the world, and connect your controls to it.
Enable long reach
Enables long reach, which allows the player to build and interact with entities at a greater distance. The default reach is 10.
Research scripts
Enable Research Queue
Enable the research queue for the players current team. Can be done after the game has started if it was forgotten during the map's setup.
Enable faster research
1 is normal speed, 2 is double speed 3 is triple etc.
Research specific technologies
The internal technology names can be found in the infoboxes on their respective pages.
Unresearch specific technologies
The internal technology names can be found in the infoboxes on their respective pages.
Enabling specific recipes
The internal recipe/item names can be found in the infoboxes on their respective pages.
Enable all recipes
Command line parameters
As of Game Version 0.17.5
Command line parameters can be used to set settings in the command line before the game launches, this is useful mainly for advanced users or server hosts.
General options: | |
-h, --help | display help |
--version | show version information |
-v, --verbose | enable verbose logging |
-c, --config PATH | config file to use |
--no-log-rotation | don't rotate log file |
--mod-directory PATH | Mod directory to use |
--check-unused-prototype-data | Print a warning for all prototype values that were not accessed |
--executable-path PATH | Override autodetected __PATH__executable. Usually not needed except on very weird systems. |
Running options: | |
-s, --map2scenario arg | map to scenario conversion |
-m, --scenario2map arg | scenario to map conversion |
--apply-update arg | immediately apply update package |
--create FILE | create a new map |
--map-gen-settings FILE | Map generation settings for use with --create, --start-server-load-scenario or --generate-map-preview. See data/map-gen-settings.example.json |
--map-gen-seed SEED | Map generation seed for use with --create, --start-server-load-scenario or --generate-map-preview. Will override seed specified in map gen settings |
--map-settings FILE | Map settings for use with --create or --start-server-load-scenario. See data/base/prototypes/map-settings.lua |
--preset arg | Name of the map generation preset to be used. |
--enable-runtime-autoplace-modification | Allows changing autoplace specifications runtime in non-multiplayer non-replay enabled games for debug purposes. |
--generate-map-preview PNGFILE | Generate preview images of the map |
--generate-tile-properties-csv CSVFILE | Generate tile properties into a CSV file; can be used with --generate-map-preview |
--map-preview-size SCALE | Size (in pixels) of map preview (default: 1024) |
--map-preview-scale SCALE | Scale (meters per pixel) of map preview (default: 1) |
--map-preview-offset X,Y | Offset of the center of the map, in meters (default: 0,0) |
--noise-outputs TAG,TAG.. | Indicate which variables of noise program to output |
--slope-shading SHADEAMOUNT | Apply elevation shading to map preview |
--slope-shade-property SHADEPROP | Property to apply slope shading to (default: elevation) |
--report-quantities PROTOTYPE,.. | When generating map preview, report approximate quantities of the named entity prototypes |
--threads THREADCOUNT | Number of threads to use when generating map previews |
--disable-migration-window | Disables the gui that is shown when opening a save with migrated content |
--start-server FILE | start a multiplayer server |
--start-server-load-scenario [MOD/]NAME | start a multiplayer server and load the specified scenario. The scenario is looked for inside the given mod. If no mod is given, it is looked for in the top-level scenarios directory. |
--start-server-load-latest | start a multiplayer server and load the latest available save |
--until-tick TICK | run a save until given map tick |
--benchmark FILE | load save and run benchmark |
--benchmark-ticks N | number of ticks for benchmarking. Default is 1000 (default: 1000) |
--benchmark-verbose FILE | comma seperated list of timings to ouput each tick. 'all', 'timestamp' as well as all other values seen in the debug view are allowed here. An empty string disabled verbose benchmarking. (default: ) |
--output-perf-stats FILE | path of file to which performance statistics measurements should be saved. Special tags {api}, {hw}, {time} and {tag} will be replaced. |
--mp-connect ADDRESS | start factorio and connect to address |
--load-game FILE | start Factorio and load a game in singleplayer |
--benchmark-graphics FILE | load save and run it with graphics for benchmark-ticks number of ticks as normal game would |
--benchmark-frame FILE | load save and benchmark graphics rendering of single frame (prepare + render) without updating the game |
--force-opengl | use OpenGL for rendering |
--force-d3d | use Direct3D for rendering |
--debug-graphics | enables debugging layer for graphics API. If DirectX is used DirectX SDK needs to be installed for this to work. |
--fullscreen | start game in windowed mode (saved to configuration) |
--max-texture-size N | maximal size of texture that the game can use (saved to configuration). Should be power of two greater than 2048 |
--graphics-quality arg | accepted values: normal, low, very-low |
--video-memory-usage arg | accepted values: all, high, medium, low |
--force-graphics-preset arg | accepted values: very-low, low, mac-with-low-ram, medium-with-low-vram, medium, high, very-high, extreme |
--gfx-safe-mode | resets some graphics settings to values that should work on most configurations |
--low-vram | sprites that are not put into sprite atlases won't be allocated as texture objects |
--shader arg | enable/disable shader postprocessing (saved to configuration) |
--disable-audio | Disable audio. Mainly for faster startup during development. |
--window-size arg | Desired window resolution. For example '1680x1050'. Or 'maximized' |
--single-thread-loading | Disables loading of sprites in multiple threads. |
Server options: | |
--port N | network port to use |
--bind ADDRESS[:PORT] | IP address (and optionally port) to bind to |
--rcon-port N | Port to use for RCON |
--rcon-password PASSWORD | Password for RCON |
--server-settings FILE | Path to file with server settings. See data/server-settings.example.json |
--use-server-whitelist | If the whitelist should be used. |
--server-whitelist FILE | Path to file with server whitelist. |
--server-banlist FILE | Path to file with server banlist. |
--server-adminlist FILE | Path to file with server adminlist. |
--console-log FILE | Path to file where a copy of the server's log will be stored |
--server-id FILE | Path where server ID will be stored or read from |
Multiplayer
Will start a Headless (Dedicated) server, with no GUI.
ADDRESS is the IP:port of the remote host. Port is optional.Examples:
As above, port can be specified by placing the port number after a colon in the address.
Converts a save game to a User Scenario, allows saved game state to be loaded into map editor.Assuming that save game name is 'foo.zip', executing './factorio --map2scenario s1' will result in Factorio loading, opening the save file, and saving the scenario into the scenario folder.
Modding tools
A list of the internal names of most things in the vanilla game can also be found on data.raw.
Print to console which tile are you have under the player position
Write all researched technologies to file
Write all enabled recipes to file
See also
- http://lua-api.factorio.com/latest/ - Factorio API reference for latest version