AI Agent Bridge


AI chatbot and chat assistant for your Factorio server: ask a question in game chat and the AI answers in chat from your live save. Where things are, production rates, research, what changed since you died. Multiplayer, every team and force, follow-up questions. Bring your own key: Claude, GPT, DeepSeek, Gemini or any LLM on OpenRouter. Runs with a small agent program beside the server.

Utilities
an hour ago
2.0
0
Owner:
bits-orio
Source:
https://github.com/bits-orio/ai-agent-bridge
Homepage:
https://discord.gg/tWz4FT74pH
License:
MIT
Created:
2 hours ago
Latest Version:
1.0.1 (an hour ago)
Factorio version:
2.0
Downloaded by:
0 users

AI Agent Bridge

Ask your server a question in chat. An AI reads your live game and answers you in chat.

Type /ask and a question, the way you would ask a friend on the server. A few seconds later the answer prints in chat, worked out from your save as it is right now. Things you can ask:

  • /ask where am I making repair packs and get a map ping you can click.
  • /ask what is our iron plate rate and get the number, with the icon.
  • /ask how much iron did we make since I died
  • /ask what is Team Ace researching
  • /ask which team has launched more rockets

Ask a follow-up and it remembers what was just said. Anyone on the server can join in. Nothing is scanned or exported ahead of time: the AI looks up only what your question needs, when you ask it.

Status

First release. Tested on 2.0 dedicated servers, vanilla and with Multi-Team Support, with and without Space Age.

Quick start

  1. Install this mod on the server and on every client.
  2. Turn on RCON on the server: a port and a password, in your launch settings or in your hosting panel.
  3. Run the agent program beside the server. It is a small download from GitHub, needs to know where the mod's event log is and how to reach RCON, and takes your own model key. The walkthrough: https://github.com/bits-orio/ai-agent-bridge/blob/main/QUICKSTART.md
  4. Type /ask what is my iron plate rate in chat.

Features

  • Ask in plain words; answers come back in chat with item icons and map pings.
  • Follow-ups share a session; /ask #iron names one others can join, /ask new starts fresh.
  • Every player can ask about every team or force on the server.
  • On a Multi-Team Support server, team-only chat gets team-only answers, and teams are called by their names.
  • Knows what happened: deaths, research, rockets and chat since the save began.
  • Other mods can add their own lookups, so the AI learns about them without any change here.
  • Your own key, any model: Claude, GPT, DeepSeek, Gemini or anything else OpenRouter lists. Every answer shows what it cost, and there are caps per player, per server and per day.

How it works

This mod is the game side. It takes the questions, publishes the lookups the AI may run, draws the answers and keeps a small event log. The thinking happens in the agent program you run next to the server; it talks to the mod over RCON and to the model with your key. The protocol between them is open, so anyone can write a different agent, in any language, and the mod will not know the difference.

Compatibility

Factorio 2.0, Space Age or not. Works on a plain vanilla server. Needs RCON on the server and the agent program running beside it.

Works with

  • Multi-Team Support: private answers in team chat, teams by name, and each team's own clock so "how am I doing compared to them" compares fairly.
  • Open Discord Bridge: both use RCON on the same server, neither needs the other.

Part of the MTS family: Multi-Team Support, Open Discord Bridge.

Links

Development

Developed with AI coding assistants alongside human review and in-game testing. Issues and pull requests are welcome on GitHub.

License: MIT