Forgeworks Core
Forgeworks Core is the shared utility foundation for Szentigrade's Factorio 2.0 mod ecosystem.
It is an internal library mod: it does not add gameplay content by itself. Instead, it provides reusable data-stage and runtime helpers used by larger mods such as planetary overhauls, total conversions, progression bridges, and industrial recipe systems.
What it provides
Forgeworks Core includes helper modules for:
- prototype creation and validation
- recipe, result, ingredient, and category contracts
- technology and unlock helpers
- deterministic manifest loading
- layered/direct icon assignment
- item, fluid, entity, and stack checks
- runtime event dispatching
- nth-tick and scheduled task registration
- safe GUI element handling
- persistent queue helpers
- storage and migration helpers
- native Space Age space-location helpers
- native Space Age space-connection helpers
- route graph repair, pruning, and validation
- starmap layout helpers
- optional dependency checks without hard dependencies
- strict assertion and validation utilities
Design rules
Forgeworks Core is deliberately conservative:
- no gameplay content
- no generated graphics
- no placeholder prototypes
- no silent dummy fallbacks
- no third-party hard dependencies
- no bundled flib, stdlib, PlanetsLib, or GUI-helper dependency
Other libraries and mods may be used as implementation references by downstream projects, but Forgeworks Core itself remains self-contained.
Intended dependency usage
Converted Szentigrade mods should depend on the minimum Core version they actually need. New conversions should normally start with:
"forgeworks-core >= 0.2.4"
Older converted mods may have lower dependency floors if they do not use newer helpers.
Validated consumer baseline
Forgeworks Core 0.2.4 has been load-tested with the current converted-mod set:
- Stellar Foundry 2.2.8+
- Interstellar Progression Overhaul 1.2.43+
- Planet Crafter: Nauvis Reborn 2.3.1+
- Biter Born 1.6.5+
- Real Industrial Chemistry 0.9.5+
For players
Install Forgeworks Core when another mod lists it as a required dependency. It is not meant to be played on its own.
For modders
Forgeworks Core is built around explicit contracts and loud validation failures. If a recipe references a missing item, a route points to a missing location, or a GUI handler reads an invalid element, the library is designed to expose that bug instead of silently hiding it.