<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.factorio.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=TheElephants</id>
	<title>Official Factorio Wiki - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.factorio.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=TheElephants"/>
	<link rel="alternate" type="text/html" href="https://wiki.factorio.com/Special:Contributions/TheElephants"/>
	<updated>2026-11-18T18:40:03Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://wiki.factorio.com/index.php?title=Debug_mode&amp;diff=221252</id>
		<title>Debug mode</title>
		<link rel="alternate" type="text/html" href="https://wiki.factorio.com/index.php?title=Debug_mode&amp;diff=221252"/>
		<updated>2026-11-15T12:56:43Z</updated>

		<summary type="html">&lt;p&gt;TheElephants: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Languages}}&lt;br /&gt;
[[File:debug_during_play.png|thumb|250px|right|Debug mode, with some of its features enabled.]]The &#039;&#039;debug mode&#039;&#039; is used mainly by developers and modders to analyze the running state of the game. It can be enabled to show detailed information about the game world. The default key to enable debug mode is {{keybinding|F5}}.&lt;br /&gt;
&lt;br /&gt;
For example, one can:&lt;br /&gt;
* See the path the [[Enemies#Biters|biters]] are coming from and where they plan to target,&lt;br /&gt;
* See the position / coordinates of the cursor,&lt;br /&gt;
* See a grid-overlay for the [[map structure|tile]]s and [[Map_structure#Chunk|chunks]],&lt;br /&gt;
* See additional non-game related information, such as Updates Per Second and FPS.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Note:&#039;&#039;&#039; In addition to this internal debugging tool there are also third-party debugging tools contributed by the community available on the [https://forums.factorio.com/viewforum.php?f=135 Factorio sub-forum for mod development tools].&lt;br /&gt;
&lt;br /&gt;
== Activate the debug mode ==&lt;br /&gt;
&lt;br /&gt;
There are 2 debug-levels:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Always&#039;&#039;&#039; - This is the default mode, if no mode is active. Keep very few things active here.&lt;br /&gt;
* &#039;&#039;&#039;Debug&#039;&#039;&#039; - Toggled by pressing {{keybinding|F5}}. Allows to toggle the debug overlays.&lt;br /&gt;
&lt;br /&gt;
== Configuring the debug mode ==&lt;br /&gt;
&lt;br /&gt;
To configure the 2 modes, press {{keybinding|F4}}. This opens up a menu with many options. You can move this menu with the mouse, if it hides some interesting underlying thing. You can switch between 2 folders, which reflects the option for that debug-mode (&amp;quot;always&amp;quot;, &amp;quot;debug&amp;quot;). The options are the same for each mode. Each mode can be configured to the user&#039;s liking, the different modes are only for convenience. A search function ({{Keybinding|ctrl|F}}) is available.&lt;br /&gt;
&lt;br /&gt;
== List of debug-options and their function ==&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! Option !! Description&lt;br /&gt;
|-&lt;br /&gt;
| show-fps || Will show the current frames-per-second and updates per second, short &amp;lt;abbr title=&amp;quot;Frames Per Second&amp;quot;&amp;gt;FPS&amp;lt;/abbr&amp;gt; and &amp;lt;abbr title=&amp;quot;Updates Per Second&amp;quot;&amp;gt;UPS&amp;lt;/abbr&amp;gt;. Should be normally about 60.&lt;br /&gt;
|-&lt;br /&gt;
| show-clock || Shows a real time clock.&lt;br /&gt;
|-&lt;br /&gt;
| show-detailed-info ||&lt;br /&gt;
* Shows the cursor position in [[Map_structure#Tile|tiles]] (and subdivisions of that).&lt;br /&gt;
* Current resolution and zoom.&lt;br /&gt;
* How many objects are on the screen (painted by the graphic card).&lt;br /&gt;
* How many entities, chunks and paths are in the game and used.&lt;br /&gt;
|-&lt;br /&gt;
| show-time-usage ||&lt;br /&gt;
* Internal statistics about how long some calculations take, in milliseconds per [[Time#Ticks|tick]].&lt;br /&gt;
* Time is shown as average/min/max of the last 100 ticks, interval can be changed with /perf-avg-frames.&lt;br /&gt;
* Minimum values exclude zeroes (e.g. from ticks where no mod hooks were run).&lt;br /&gt;
* Overall calculation delays (some are parallel) must be under 16.6 ms to maintain normal framerate at 1x speed with 60 ticks per second.&lt;br /&gt;
* The Top section of metrics cover the wider game engines activities. The middle Update section relates to running the simulation for a tick. The bottom Map Generator section relates to the map generation activity. For more details, refer to [[Tutorial:Diagnosing_performance_issues#Decrypting_the_%22time_usage%22_screen|Tutorial:Diagnosing performance issues]].&lt;br /&gt;
|-&lt;br /&gt;
| show-entity-time-usage ||&lt;br /&gt;
|-&lt;br /&gt;
| show-gpu-time-usage ||&lt;br /&gt;
|-&lt;br /&gt;
| show-sprite-counts || The counts of each sprite rendered on screen.&lt;br /&gt;
|-&lt;br /&gt;
| show-lua-object-statistics || Statistics related to the Lua garbarge collector. Update time (avg/min/max), created objects (avg/min/max [total]), destroyed objects (avg/min/max [total]).&lt;br /&gt;
|-&lt;br /&gt;
| show-heat-buffer-info ||&lt;br /&gt;
|-&lt;br /&gt;
| show-multiplayer-waiting-icon || When in a multiplayer game: if the game is currently waiting for the server to process.&lt;br /&gt;
|-&lt;br /&gt;
| show-multiplayer-statistics || The latency information when in multiplayer.&lt;br /&gt;
|-&lt;br /&gt;
| show-multiplayer-selection-rectangles || Allows to view selection rectangles of other players in multiplayer.&lt;br /&gt;
|-&lt;br /&gt;
| show-debug-info-in-tooltips || Shows additional information in the tooltips of entities, items, recipes, tiles etc. &lt;br /&gt;
|-&lt;br /&gt;
| show-resistances-in-tooltips-always || Show entity resitances in all entity tooltips instead of just tooltips of enemy entities and entities with [https://lua-api.factorio.com/latest/prototypes/EntityWithHealthPrototype.html#hide_resistances hide_resistances] set to false.&lt;br /&gt;
|-&lt;br /&gt;
| hide-mod-guis || Hides GUIs added by mods. &lt;br /&gt;
|-&lt;br /&gt;
| show-tile-grid || Shows the borders of the [[Map_structure#Tile|tiles]] and [[Map_structure#Chunk|chunks]].&lt;br /&gt;
|-&lt;br /&gt;
| show-blueprint-grid ||&lt;br /&gt;
|-&lt;br /&gt;
| show-collision-rectangles || Shows the collision boxes of each entity (red).&lt;br /&gt;
|-&lt;br /&gt;
| show-selection-rectangles || Shows a blue box over each entity, if you hover over it, it will be selected.&lt;br /&gt;
|-&lt;br /&gt;
| show-render-rectangles || Shows a pink box over each entity, if that is on your screen, the entity will be rendered.&lt;br /&gt;
|-&lt;br /&gt;
| show-sticker-boxes ||&lt;br /&gt;
|-&lt;br /&gt;
| show-entity-positions ||&lt;br /&gt;
|-&lt;br /&gt;
| show-entity-velocities ||&lt;br /&gt;
|-&lt;br /&gt;
| show-selected-entity-advanced-tiles || Shows on which advanced tiles (2×2 tiles) the entity is registered.&lt;br /&gt;
|-&lt;br /&gt;
| show-selected-input-transport-belts || Shows which entities input into the selected transport line.&lt;br /&gt;
|-&lt;br /&gt;
| show-paths || The calculated paths for the biters in different colors.&lt;br /&gt;
|-&lt;br /&gt;
| show-path-requests ||&lt;br /&gt;
|-&lt;br /&gt;
| show-next-waypoint-bb || Shows waypoints for biters (in green), nearly the same info as the next.&lt;br /&gt;
|-&lt;br /&gt;
| show-target || Shows the current target of the biters (red).&lt;br /&gt;
|-&lt;br /&gt;
| show-unit-group-info || Biter groups, which belong together (circles and lines belonging together)&lt;br /&gt;
|-&lt;br /&gt;
| show-unit-behavior-info ||&lt;br /&gt;
|-&lt;br /&gt;
| show-pathfinder-fringe ||&lt;br /&gt;
|-&lt;br /&gt;
| show-path-cache || The source-positions of a path and about the length (?)&lt;br /&gt;
|-&lt;br /&gt;
| show-path-cache-paths ||&lt;br /&gt;
|-&lt;br /&gt;
| show-rail-paths || Which path a train will follow.&lt;br /&gt;
|-&lt;br /&gt;
| show-rolling-stock-count || Shows inserter positions&lt;br /&gt;
|-&lt;br /&gt;
| show-rail-connections || Shows rail connections.&lt;br /&gt;
|-&lt;br /&gt;
| show-rail-joints ||&lt;br /&gt;
|-&lt;br /&gt;
| show-rail-segment-collision-boxes ||&lt;br /&gt;
|-&lt;br /&gt;
| show-train-stop-point || When a train slows down it shows the calculated point where it should halt&lt;br /&gt;
|-&lt;br /&gt;
| show-train-braking-distance || The distance a train will take to stop at its current speed&lt;br /&gt;
|-&lt;br /&gt;
| show-train-signals ||&lt;br /&gt;
|-&lt;br /&gt;
| show-train-repathing || Display a flying &amp;quot;repathed&amp;quot; text over a train whenever it repaths.&lt;br /&gt;
|-&lt;br /&gt;
| show-network-connected-entities || Displays the network-id of the electric network that a pole is connected to&lt;br /&gt;
|-&lt;br /&gt;
| show-circuit-network-numbers || Shows the number (and color) of circuit networks&lt;br /&gt;
|-&lt;br /&gt;
| show-energy-sources-networks || Which network-id an entity is connected to.&lt;br /&gt;
|-&lt;br /&gt;
| show-active-state || Inserters, fish, turrets are turned to passive, if not used; Red = inactive, Purple = inactive when enemies aren&#039;t around (turrets etc), Green = inactive when player isn&#039;t around (fish). Passive entities consume less CPU power.&lt;br /&gt;
|-&lt;br /&gt;
| show-wakeup-lists || When an entity is sleeping in another entity it shows which entities it&#039;s sleeping in.&lt;br /&gt;
|-&lt;br /&gt;
| show-transport-lines ||&lt;br /&gt;
|-&lt;br /&gt;
| show-transport-line-gaps ||&lt;br /&gt;
|-&lt;br /&gt;
| show-pollution-values || Shows the numeric pollution amount on each chunk.&lt;br /&gt;
|-&lt;br /&gt;
| show-active-entities-on-chunk-counts ||&lt;br /&gt;
Shows counts of active entities per chunk. They are divided into two categories:&lt;br /&gt;
* Blue = active when a player is around (e.g. fish)&lt;br /&gt;
* Green = active when enemies are around (e.g. turrets)&lt;br /&gt;
|-&lt;br /&gt;
| show-active-chunks || Shows in the map view, which chunks are &amp;quot;on&amp;quot;, unmarked chunks are not calculated.&lt;br /&gt;
|-&lt;br /&gt;
| show-polluted-chunks || Shows which chunks have pollution.&lt;br /&gt;
|-&lt;br /&gt;
| hide-chart-tags || Hides map tags.&lt;br /&gt;
|-&lt;br /&gt;
| show-enemy-expansion-candidate-chunks || Where is space left to spread the brood? Goes from red (nearly no space) to green (space to expand).&lt;br /&gt;
|-&lt;br /&gt;
| show-enemy-expansion-candidate-chunk-values || Which chunks the enemies will try to expand into.&lt;br /&gt;
|-&lt;br /&gt;
| show-bad-attack-chunks ||&lt;br /&gt;
|-&lt;br /&gt;
| show-tile-variations || Shows, which tile-variation (1, 2 or 4 tile sized) is painted for which area of the map. Quite confusing, zoom in to see the meaning.&lt;br /&gt;
|-&lt;br /&gt;
| show-raw-tile-transitions || Turns connected textures for land and water off, so the distinction can easily be made.&lt;br /&gt;
|-&lt;br /&gt;
| show-fluid-box-fluid-info || How much fluid is in a pipe/storage tank, shows flow of liquid in pipes.&lt;br /&gt;
|-&lt;br /&gt;
| show-environment-sound-info || Displays which sound of which entity is played and how loud.&lt;br /&gt;
|-&lt;br /&gt;
| show-environment-sound-area ||&lt;br /&gt;
|-&lt;br /&gt;
| show-selected-entity-audible-range ||&lt;br /&gt;
|-&lt;br /&gt;
| show-recently-played-sound-info ||&lt;br /&gt;
|-&lt;br /&gt;
| show-logistic-robot-targets || &lt;br /&gt;
Shows a straight line path starting at the current position of each logistic robot, to it&#039;s immediate target, and the paths between its immediate target and each subsequent target. &lt;br /&gt;
* The colour of each line signifies how many targets the bot must take before taking that path. &lt;br /&gt;
* For example, each red line points from the bot&#039;s current position to it&#039;s immediate target, the green line shows the path from the immediate target to the subsequent target, etc. &lt;br /&gt;
* The colour of each path in sequential order is red, green, blue, cyan, yellow, pink, white, black, then it repeats from red.&lt;br /&gt;
* The number next to each bot is the number of targets it must visit before it will finish its job.&lt;br /&gt;
* Roboports do not count as targets for recharging or docking, but do count as targets for logistic requests e.g. stocking repair packs.&lt;br /&gt;
|-&lt;br /&gt;
| show-spidertron-movement ||&lt;br /&gt;
|-&lt;br /&gt;
| show-player-robots ||&lt;br /&gt;
|-&lt;br /&gt;
| show-fire-info ||&lt;br /&gt;
|-&lt;br /&gt;
| show-sticker-info ||&lt;br /&gt;
|-&lt;br /&gt;
| show-decorative-names ||&lt;br /&gt;
|-&lt;br /&gt;
| show-decorative-collision-rectangles ||&lt;br /&gt;
|-&lt;br /&gt;
| allow-increased-zoom ||&lt;br /&gt;
|-&lt;br /&gt;
| show-chunk-components ||&lt;br /&gt;
|-&lt;br /&gt;
| show-train-no-path-details || Chat shows extra info on pathfinder for no-pathing trains. [https://forums.factorio.com/viewtopic.php?p=567834#p567834]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{C|Main}}&lt;/div&gt;</summary>
		<author><name>TheElephants</name></author>
	</entry>
</feed>