exotic-space-industries-remembrance

ESIR-first repo-local development surface for Exotic Space Industries: Remembrance. Use when Codex should work faster inside this workspace by relying on checked-in manifests, the ESIR wrapper command, Factorio QC delegation, Mod Portal scouting, save catalog resolution, Lua/runtime/prototype helper routing, Meshy/Blender asset pipeline routing, Factorio asset export, item icon prep, recipe icon style audits, art/browser session handoff, cache diffing, packaging, or ESIR-specific runtime/prototype maps.

Use when Codex should create, inspect, or render Blender procedural animations for non-human assets, ESIR machines, crystals, gates, orbitals, props, Meshy GLBs, animation spritesheets, or Factorio-ready transparent frame sheets.

Use when Codex should orchestrate a full ESIR asset pipeline from Meshy prompts or existing models through Blender static/procedural rendering, Factorio-style shadows, staged Factorio export, previews, QA, manifests, and reproducible asset dossiers.

Use when Codex should stage Meshy/Blender spritesheets, animated sheets, shadow sheets, or source icon art as Factorio/ESIR-ready asset drafts with previews, manifests, and Lua prototype snippets without wiring them into the mod.

Use when ESIR item art needs to be turned into a transparent Factorio item icon strip, especially when source art has a baked light checkerboard or white background and must end up as a `128/64/32` mipmapped item icon under `exotic-space-industries-remembrance/graphics/items/`.

Prefer the shared `ei_lib` helper surface in `exotic-space-industries-remembrance/lib/lib.lua` before creating new Lua local functions. Use when Codex edits ESIR runtime, data-stage, prototype, migration, or support Lua files and might add utility helpers, table or string helpers, recipe or technology mutation helpers, notification helpers, color or formatting helpers, wrappers around `data.raw`, prototype `custom_tooltip_fields`, or runtime `LuaEntity.custom_status` combat readouts such as DPS/status rows for weapons, turrets, or vehicles. For runtime queue, delayed-bucket, telemetry-gate, counter, or status-snapshot plumbing, prefer `exotic-space-industries-remembrance/lib/runtime-scheduler.lua` instead. Inspect `ei_lib` first when the helper is general utility; if it almost fits, extend or harden the shared function instead of inventing a one-off local helper.

Use when Codex should render or wire ESIR Factorio train and rolling-stock body sprites, especially elevated-rail sloped train sprites, rolling_stock_template.blend, susanne_0.0.1.zip precedent, Spritter spritesheet packing, normal/sloped frame contracts, or prototype RotatedSprite metadata for locomotives, cargo wagons, fluid wagons, or train bodies.

Use when Codex needs to import, audit, replace, or choose Factorio's bundled `data/core/lualib` helpers in ESIR or other Factorio mod Lua, especially `require("__core__.lualib.meld")`, `util`, `mod-gui`, `resource-autoplace`, `collision-mask-util`, `math2d`, `math3d`, `event_handler`, `sound-util`, `circuit-connector-sprites`, `story`, `silo-script`, `space-finish-script`, `production-score`, or `kill-score`. Use before reimplementing helper behavior that Factorio core already ships, before changing existing core lualib imports, and when deciding between core lualib helpers, ESIR `ei_lib`, direct prototype mutation, or local Lua helpers.

Use before applying generic Lua advice to Factorio mod code. Checks Factorio's Lua 5.2.1 sandbox, staged startup/runtime lifecycle, storage rules, require behavior, deterministic library changes, LuaObject validity, data.raw versus prototypes, and ESIR-specific helper/scheduler expectations.

Docs-first workflow for official Factorio Lua API questions. Use when Codex needs the authoritative runtime, prototype, auxiliary, or wiki scripting docs for Factorio modding, including classes, methods, attributes, events, concepts, defines, prototypes, types, migrations, storage, data lifecycle, script interfaces, localisation, console, command-line flags, or data.raw guidance.

Use when Codex needs to import, audit, replace, or choose Factorio vanilla prototype helper modules from `data/base`, `data/space-age`, `data/quality`, or `data/elevated-rails` in ESIR or other Factorio mod Lua. Covers `__base__.prototypes.*`, `__space-age__.prototypes.*`, `__quality__/prototypes/recycling`, `__elevated-rails__` prototype helpers, canonical sounds, hit effects, item effects, asteroid spawn definitions, planet map-gen, recycling generation, tile helpers, graphics table precedent, require forms, and when to prefer vanilla helpers, core lualib, ESIR `ei_lib`, or direct prototype mutation.

Use when Codex should turn Meshy-generated models or existing Blender-compatible 3D assets into Factorio/ESIR-ready transparent sprite frames, directional spritesheets, preview renders, or Blender inspection workflows using Meshy MCP, Blender MCP, and deterministic background Blender rendering.

Use when adding, refactoring, auditing, or testing ESIR runtime code that receives Factorio research completion events, handles on_research_finished or on_scripted_research_burst, reacts to scripted research floods, updates force-derived research caches, buffs, milestones, notifications, damage/status refreshes, or plans QC around the scripted research burst UPS saver.

Use when Codex should work with Meshy.ai API or MCP workflows for text-to-3D, image-to-3D, multi-image-to-3D, remesh, retexture, rigging, animation, animation-library lookup, 2D image generation, balance checks, downloads, manual site asset handoff, or ESIR asset prototyping with safe environment-based credentials.

Use when editing or auditing ESIR Lua annotations for LuaLS/EmmyLua editor fidelity, including Factorio runtime events, data-stage prototype types, module export tables, storage/state shapes, option tables, scheduler payloads, GUI handlers, and whole-module or whole-codebase typing sweeps.

Create, review, and standardize ESIR runtime GUI code. Use when Codex adds or refactors Factorio runtime GUI panels in `exotic-space-industries-remembrance/scripts/control`, chooses between `player.gui.relative`, `player.gui.screen`, `mod_gui`, or `player.gui.left`, audits GUI anchors, root names, `tags.parent_gui` routing, stale-root teardown, entity revalidation, close/update lifecycle, or brings older ESIR GUI modules into the house style.

Ingest the local recipe-icons-improvement-for-esir companion mod, audit ESIR recipe icon and visibility drift, and generate non-mutating batch review reports plus patch-ready planning data for icon, sorting, hiding, and signal cleanup work.

Inspect ESIR declared dependencies and cross-mod touchpoints through a checked-in dependency catalog plus optional local installed-mod enrichment. Use when Codex needs to answer which mods ESIR depends on, where those mods are touched at runtime or data stage, which remote interfaces are involved, which planet/content integrations exist, or whether a locally installed external mod is present without treating machine-local state as checked-in truth.