Commands, the isolated headless-server test setup, and the architecture
that spans the mod, MCP server and /ask helper: UDP request flow and
chunking, deferred replies, multiplayer determinism, the read-only
contract, Lua-to-JSON quirks and the token-budget conventions.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Pass the /ask question to claude on stdin so it can't be parsed as a CLI option.
- Block run_lua in multiplayer unless an admin enables the new
"Allow Lua queries in multiplayer" map setting.
- Ignore UDP packets that don't come from the game's port, in both the
MCP server and the ask helper.
- Build the screenshot path from our own name instead of the game's reply,
and restrict screenshot names in the mod.
- Validate ask packets, cap question length and limit concurrent claude runs.
- Replace hard-coded home paths in the README and systemd unit.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A Factorio 2.x mod plus MCP server that lets Claude answer questions about
a running game over Lua UDP, without RCON, so it works in singleplayer.
- Read-only tools: overview, problems, entities, production, power, trends,
research, recipes, ratio calculator, belt tracer, screenshots, Lua queries
- In-game highlights with clickable [gps] links
- /ask chat command answered by a local helper running claude -p, with a
per-player model setting and a systemd user service
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
faabandClaude Opus 5.5