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.