factorio-draftsman is a python module for creating Blueprint strings for the game Factorio.

The Draftsman logo created by an example script. PyPI Version Documentation Status Code Coverage Code Style: Black


Draftsman aims to provide a ‘one-stop shop’ solution to the problem of manipulating blueprint strings. It allows the user to import, modify, create, add, remove, and export blueprints and their contents in dynamic and flexible ways. It’s API is designed to be clear and self-documenting, from its imports to its errors.

In addition to the standard features you would expect, Draftsman also has a number of quality-of-life features, including:

  • Unique entity IDs, as well as dynamic association between entities.

  • Querying blueprint contents by area, name, type, as well as other criteria.

  • The grouping of entities to reuse for aid in structure and design.

  • Verbose warnings for modifications on import normally ignored by Factorio.

Draftsman is also unique in that it emulates the Factorio data lifecycle directly, extracting all data that the module uses directly from Wube’s public repository. This ensures a direct continuity between Factorio’s data and Draftsman, which makes the module much easier to maintain over specific Factorio versions, as well as over time. By emulating the data-lifecycle in this manner, Draftsman is also the first package of this type to allow mod support built-in.

Draftsman is cross-platform, and guaranteed to work on the latest versions of Python 2 and 3. Draftsman is also guaranteed to work with versions of Factorio 1.0 and up. Prior to that most functionality should still work, but your mileage may vary.


Indices and tables