Circuit Checker


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.

Utilities
10 months ago
0.17 - 1.1
1.18K
Circuit network
Owner:
north1605
Source:
https://github.com/sVerentsov/Circuit...
Homepage:
N/A
License:
MIT
Created:
3 years ago
Latest Version:
1.1.6 (10 months ago)
Factorio version:
0.17 - 1.1
Downloaded by:
1.18K users

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

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.
  • 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.
  • 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.
  • 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.