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

Things

by The_LORD_thy_GOD · for Factorio

Things 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!)

3.9KDownloads
30d agoLast updated
MITLicense
2.1Latest game version

About Things

From Factorio Mod Portal

Things 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. Unlike unit_numbers, Thing IDs persist through the entire lifecycle.
  • If a Thing is built as a ghost, the eventual revived entity is the same Thing as the ghost.
  • If a Thing is killed, the ghost left behind is the same Thing.
  • If a Thing is destroyed as a result of an undo or redo action, undoing or redoing that action later will restore the same Thing that was originally present.
  • If a Thing is modified in a context where Factorio allows undo, the undo will properly undo the modifications made to the Thing.

Parent-Child Relationships

  • A Thing may register a series of child Things 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 (a Tags structure) which can be set via API and monitored with change events.
  • When a Thing is 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 corresponding Things inside the blueprint.
  • This includes all cases involving Things in the blueprint overlapping pre-existing Things in the world.

Entity Graphs

  • Things may be connected to other Things 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 Tags structure) 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 data

Game 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

BuildReleasedGame versionsLoaders
0.6.72026-10-222.1n/a
0.6.62026-10-182.1n/a
0.6.52026-10-042.1n/a
0.6.42026-09-252.1n/a
0.6.32026-09-202.1n/a
0.6.22026-09-192.1n/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 catalog
Listed on Factorio Mod Portal as “Mods”

Gameplay & overhauls

New mechanics, content and overhauls that change how the game plays.

Runs on your server

From source side support

Factorio 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

Things, answered

Generated from the mod’s own source data.

Do my players need to install Things?

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

Is it free?

Yes. Things 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 Things on a Factorio server.

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