warning

Draftsman warnings. Used to enforce “Factorio-correctness”, or the belief that operations in Draftsman that are unorthodox or ignored on import to Factorio should be mentioned to the user.

exception BarWarning

Raised when the inventory bar is set on an entity which does not have bar control, or when the bar amount exceeds the inventory size of the entity and thus would have no effect.

exception ConnectionDistanceWarning

Raised when an attempted wire connection is too distant to be properly resolved in-game.

exception ConnectionSideWarning

Raised when an attempted wire connection is made to an invalid side of the Entity.

exception DirectionWarning

Raised when the direction does not match the rotation type, e.g. setting a 4-way rotatable Entity’s direction to Direction.NORTHWEST (an 8-way directional value).

exception DraftsmanWarning

Root warning class for Draftsman. Useful if you want to easily ignore all warnings issued from the module without getting rid of warnings entirely; simply filter this class. This is a subclass of UserWarning, and all other Draftsman warnings are subclasses of this.

exception EquipmentGridWarning

Raised when attempting to configure the equipment grid of the entity into an invalid state, or when attempting to set the equipment grid of an entity that doesn’t have one to begin with.

exception FuelCapacityWarning

Raised if the amount of fuel requested to this entity exceeds it’s internal fuel storage buffer.

exception FuelLimitationWarning

Raised when a fuel item is requested to an entity that cannot burn it, such as requesting uranium fuel cells to a boiler.

exception GridAlignmentWarning

Raised when an Entity is placed on odd coordinates when it’s type restricts it’s placement to the rail grid (even coordinates).

exception HiddenEntityWarning

Raised when an Entity that is marked as hidden is placed within a blueprint, since these entities cannot usually be placed with a blueprint.

exception IndexWarning

Raised when the index of some element is out of expected range, though not to the point of failing import into Factorio.

exception ItemCapacityWarning

Raised when the volume of item requests exeeds the number of inventory slots of the entity, such as requesting 10,000 iron plate to a "wooden-chest".

exception ItemLimitationWarning

Raised when an item request does not match the particular entities valid item-types, such as incorrect ingredients for an AssemblingMachine with a recipe, or a Lab with non-science pack inputs.

exception MalformedSignalWarning

Raised when a signal is erroneously given the incorrect type, such as setting the virtual signal signal-A to have a type of “item” when it should be “virtual” instead.

exception ModuleCapacityWarning

Raised when the number of modules in an Entity with module slots exceeds the total module capacity.

exception ModuleLimitationWarning

Raised when the modules inside of an Entity conflict, either with the Entity’s type or it’s recipe.

exception ModuleNotAllowedWarning

Raised when attempting to add a module to an entity that does not support the effect it gives, such as requesting productivity modules to a beacon.

exception NoEffectWarning

Raised when an action is performed who’s operation would not have any noticable change, making it’s execution needless. For example, setting a mapping in an upgrade planner to upgrade “transport-belt” to “transport-belt” is possible, but is prohibited in Factorio’s GUI and is functionally useless.

exception OverlappingObjectsWarning

Raised when the CollisionSet of a SpatialLike object overlaps the CollisionSet of another object, and that their collision_mask s intersect. In layman’s terms, if two or more tiles or entities are placed on top of each other such that they would not be able to be placed in-game, this warning is raised.

exception PureVirtualDisallowedWarning

Raised when a signal slot is set to a pure virtual signal in a situation where it is disallowed, such as an entry in a constant combinator.

exception RecipeLimitationWarning

Raised when a recipe is set in a machine that does not support it, such as setting an assembling machine to produce plastic.

exception RedundantOperationWarning

Raised when an action is performed who’s operation would not have any noticable change, making it’s execution needless. For example, setting a mapping in an upgrade planner to upgrade “transport-belt” to “transport-belt” is possible, but performs no upgrade operation when used.

exception SignalConfigurationWarning

Raised when a particular ordering of signals in a combinator lies outside of the available configurations permitted in-game, such as setting both the first and second signal of an arithmetic combinator to “signal-each”.

exception TemperatureRangeWarning

Raised when the temperature of a heat interface is outside of the range [0, 1000].

exception TooManyConnectionsWarning

Raised when a power connection is attempted between an power-pole that already has 5 or more connections.

exception UnknownElementWarning

Raised when Draftsman detects a entity/item/signal/tile or any other Factorio construct that it cannot resolve under it’s current data configuration. This is usually either because the identifier was mistyped, or because the element in question belongs to a mod that Draftsman has not been updated to recognize.

This warning acts a superclass to a number of more specific versions, so you can catch/filter this warning and all child classes will follow suit.

exception UnknownEntityWarning

Raised when an entity is specified who is not recognized by the current Factorio environment.

exception UnknownFluidWarning

Raised if an unrecognized fluid is specified in an InfinityPipe.

exception UnknownInstrumentWarning

Raised if an unrecognized instrument is selected in a programmable speaker.

exception UnknownItemWarning

Raised if an unrecognized item is specified.

exception UnknownKeywordWarning

Raised when a keyword is passed to an Entity/Tile constructor that is not known by Draftsman, likely indicating a mismatched or extra field.

exception UnknownModuleWarning

Raised if attempting to populate an entity’s modules with a name that Draftsman doesn’t recognize.

exception UnknownNoteWarning

Raised if an unrecognized note for the current instrument is selected in a programmable speaker.

exception UnknownRecipeWarning

Raised if an assembling machine/chemical plant/oil refinery/etc. is given a recipe that Draftsman does not recognize.

exception UnknownSignalWarning

Raised if an unrecognized signal is specified.

exception UnknownTileWarning

Raised when an unrecognized tile is specified.

exception UpgradeProhibitedWarning

Raised when a upgrade from one entity to another in a UpgradePlanner is prohibited due to the properties of one or both of the upgrade targets.

exception ValueWarning

Generic warning, similar to ValueError. Raised when a input value is incorrect, but won’t cause the blueprint to fail import.

exception VolumeRangeWarning

Raised when the volume of a programmable speaker is outside of the range [0.0, 1.0]