SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedTechnology & automation

Circuit Checker

by north1605 · for Factorio

This mod helps in troubleshooting your circuit networks. Adds shortcut (Alt-C by default) to find possible circuit flaws in selected area. Finds unmatched inputs, unused outputs, missed wire connections.

1.5KDownloads
2 yr agoLast updated
MITLicense
1.1Latest game version

About Circuit Checker

From Factorio Mod Portal

This mod helps in troubleshooting your circuit networks. Adds shortcut (Alt-C by default) to find possible circuit flaws in selected area. Finds unmatched inputs, unused outputs, missed wire connections.

Circuit Checker

This mod helps in troubleshooting your circuit networks. Adds shortcut (Alt-C by default) to find possible flaws in circuit. Finds unmatched inputs, unused outputs, missed wire connections.

Demo

Demo

Supported error messages

  • Input is required but not found in connected networks (E)
  • No input/output wires on combinator (E)
  • Input not set (E) – shows that some condition is left blank
  • Output not set (E) – shows that output signal is left blank (in accumulator settings, for example)
  • Output unused (W)
  • "Use colors" is enabled in lamp but no color output is found in connected networks (I)

Additional features

  • Checks generic item/fluid input. For example, if inserter with "Set filter" option is connected only to storage tank, an error will be raised, since inserter requires item as input, but storage tank produces only fluid output.
"Any item example
  • Checks train station output. If some input requires item from train station with "Read train contents" output, but this station has only trains with fluid wagons, an error will be raised.
Train contains example
  • Checks train circuit conditions. If train uses some signal in condition to leave station, but there is no such signal on train station, an error will be raised.
Train condition example
  • Shows enabled circuit modes in alt-mode
  • Mod compatibility – this mod uses "Control behavior" attributes of entities, not entitites themselves. Therefore, mods that make use of curcuit network must be compatible. If you find a mod that does not work, please report via mod discussion or issues on Github.

Known Issues

  • Stations from LTN are not processed correctly
  • Each/Everything processing does not take into account which exact signals can be outputs

Feedback

I would be glad to see any feedback on the mod. Is there an error raised in your network while network is correct? Is there a missed error? Which features would you like to see? I am checking mod discussion and issues on Github.

TODO

  • Bug fixes
  • Enhanced mod support

Contribution

If you would like to help with the development of the mod or adding a translation, you can fork the repo and open PR. In file test-blueprint-book.txt you can find blueprint string for circuit networks that I use as unit tests. In these blueprints belts mark expected result: red belt means the entity must raise error, yellow – warning, no belt – info, blue belt – nothing.

If you want to add compatibility with another mod, take a look at the consts.lua file. It has lists of special entities, that override default checker behavior:

  • ENTITIES_ALLOW_NO_OUTPUTS – do not raise an error if an entity has no outputs configured. Used for HUD Combinator from Circuit Hud V2 mod – this entity uses the same control behaviour as constant combinator, but unlike constant combinator do not need outputs to be set
  • ENTITIES_ALLOW_NO_INPUTS – same, but for inputs
  • ENTITIES_MATCH_ALL_OUTPUT – entities that use all the outputs. So, the warning "Unused output" will never be raised in entities connected to this one. For example, HUD Combinator: it shows passed signals in HUD.
  • ENTITIES_MATCH_ALL_INPUT – same, but for inputs
  • ENTITIES_IGNORE_IF_NO_WIRES – Ignore this entity if it is not connected to circuit network. Used for Nixie tubes.

Highlights

From source data

Game versions

Built for Factorio 1.1.

Footprint

Rated a light load on a server.

License

Published under MIT.

Circuit Checker on Nxeon

From our catalogue
One-click install
Supported on Nxeon Factorio servers. We download it from Factorio Mod Portal, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Factorio — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.1.7, released 2024-07-08

Run Circuit Checker on a Factorio server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Factorio Mod Portal as “Mods”

Technology & automation

Machines, power, logistics and automation.

Runs on your server

From source side support

Factorio Mod Portal lists Circuit Checker as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Compatibility

Game
Factorio
Runs on
Serverrequired on the server
Game versions
1.1

Verified at the source

  • ✓Factorio Mod PortalOfficial listing, checked 2026-10-08Open ↗
  • ✓Authornorth1605, as published on Factorio Mod Portal
  • ✓LicenseMITFree

Circuit Checker, answered

Generated from the mod’s own source data.

Do my players need to install Circuit Checker?

Factorio Mod Portal lists Circuit Checker as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Is it free?

Yes. Circuit Checker is free to download from Factorio Mod Portal. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Circuit Checker on a Factorio server.

Deploy in about a minute from $2.99 a month, then add Circuit Checker in one click.