About Things
From Factorio Mod PortalThings provides advanced entity management capabilities to other Factorio mods. (This mod makes no gameplay changes. WARNING: disabling Things while other mods are using it may break your save!)
Quick Links
Description
Things is a utility mod intended for use by other mod developers. It does not make gameplay changes.
Things provides advanced entity management services to other Factorio mods in the form of a high-level abstraction called a Thing.
Mod authors register custom entities in mod-data to have their lifecycles managed as Things. Once created, Things are manipulated via a documented remote interface, and provide additional custom events for mods to react to.
Here are some things Things can do:
Features
Extended Lifecycle
As opposed to Factorio entities, a Thing retains its identity and data throughout a vastly extended lifecycle:
Things have unique identifiers to help your mod track them, as well as lifecycle events that trigger when these states change. Unlikeunit_numbers, Thing IDs persist through the entire lifecycle.- If a
Thingis built as a ghost, the eventual revived entity is the sameThingas the ghost. - If a
Thingis killed, the ghost left behind is the sameThing. - If a
Thingis destroyed as a result of an undo or redo action, undoing or redoing that action later will restore the sameThingthat was originally present. - If a
Thingis modified in a context where Factorio allows undo, the undo will properly undo the modifications made to theThing.
Parent-Child Relationships
- A
Thingmay register a series of childThings to be created and managed alongside it. - Children can be configured to compute and maintain their position and orientation relative to their parents, with full support for in-world and in-blueprint rotation and flipping, where applicable.
- Children and parents receive special events for each other's lifecycle state, making it easy to guarantee that the children come and go with the parent in a correct manner.
- Child/parent relationships are preserved across blueprint and undo operations.
Comprehensive Support for Blueprinting
Things carry arbitrary custom serializable data (aTagsstructure) which can be set via API and monitored with change events.- When a
Thingis lifted into a blueprint, this data is carried along into the blueprint. - When a blueprint is applied, all of the
Things resulting from the blueprint application will have the same data as the correspondingThings inside the blueprint. - This includes all cases involving
Things in the blueprint overlapping pre-existingThings in the world.
Entity Graphs
Things may be connected to otherThings by directed or undirected graph edges.- Distinct named graphs can co-exist, each having its own set of edges.
- Connections are preserved in blueprinting, undo, and overlapping.
- Graph edges can store custom edge data (a
Tagsstructure) which is serialized with blueprints.
Synthetic Custom Events
- Through metadata, Things can be instructed to fire custom events of your choice allowing you to respond to Thing lifecycle events.
Non-polling implementation
- Things operates internally using various event and script triggering schemes, avoiding
on_tick. - This means it will not impact performance outside of monitored construction and lifecycle events.
- This also means Things (and by extension the
Things you make with it) fully works while the game is paused in the editor.
Credits
- protocol\_1903 and boskid for technical knowledge relating to subtick events.
- hgschmie and Telkine2018 for a helpful string hash representation of entities.
- TalShar and Tekbox for technical contributions relating to circuit script triggers.
- boskid, protocol\_1903, and PennyJim for technical knowledge relating to virtual rotation of entities.
- Bilka for fixing a Factorio bug that negatively impacted Things.
- Kryzeth for being brave enough to use Things while it was still in Alpha.
Thanks also to the following indirect contributors:
- justarandomgeek (for FMTK, as well answering a number of my weird questions in modding discord)
- thesixthroc (for helping me find and fix bugs in bplib, the intellectual precursor to this library)
Contributing
Please use the GitHub repository for questions, bug reports, or pull requests.
Highlights
From source dataGame versions
Built for Factorio 2.1.
Footprint
Rated a light load on a server.
License
Published under MIT.
Things 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
- 0.6.7, released 2026-10-22
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 0.6.7 | 2026-10-22 | 2.1 | n/a |
| 0.6.6 | 2026-10-18 | 2.1 | n/a |
| 0.6.5 | 2026-10-04 | 2.1 | n/a |
| 0.6.4 | 2026-09-25 | 2.1 | n/a |
| 0.6.3 | 2026-09-20 | 2.1 | n/a |
| 0.6.2 | 2026-09-19 | 2.1 | n/a |
Run Things 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 catalogGameplay & overhauls
New mechanics, content and overhauls that change how the game plays.
Runs on your server
From source side supportFactorio Mod Portal lists Things 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
- 2.1
Verified at the source
- ✓Factorio Mod PortalOfficial listing, checked 2026-10-23Open ↗
- ✓AuthorThe_LORD_thy_GOD, as published on Factorio Mod Portal
- ✓LicenseMITFree
