Hivemind is a server-side event-logging and export framework for Factorio 2.0+. It safely captures in-game events (like enemy attack decisions and chat messages) and exposes them via silent in-game commands, RCON, or the Lua remote interface—without impacting your 60 UPS game loop.

How do I install Hivemind?

1. Download the latest ZIP from GitHub or the Mod Portal.
2. Unzip it into your server’s mods/ folder.
3. Have each client also install the same ZIP into their local mods/ folder.
4. Restart the server; enable “Hivemind” in the Mods menu.

Which events are tracked?

• Attack events (on_unit_group_finished_gathering)
• Chat messages (on_console_chat)
• (Architecture is extensible—future versions may add research, pollution, or custom event hooks.)

How do I retrieve logged data?

In-game commands (admin only)

• /hm_get_events [<tick>]
• /hm_drop_events
• /hm_list_listeners
• /hm_reload_listeners

Lua remote interface

remote.call("hivemind", "get_attack_events_after", <tick>)
remote.call("hivemind", "get_chat_messages_after", <tick>)
remote.call("hivemind", "get_storage_snapshot", <tick>)
remote.call("hivemind", "clear_attack_events")

How do I configure retention and logging?

• Open Mod Settings in-game.
• Adjust:
• Attack event retention ticks (default: 36000)
• Chat message retention ticks (default: 36000)
• Enable verbose logging (on/off)

Can I use Hivemind on a public server?

Yes! Hivemind is designed for both local and publicly hosted dedicated servers. Just ensure all connecting clients have the same mod version installed.

Is Hivemind stable for production use?

🚧 Active Development & Preview 🚧
Hivemind is a technical preview under heavy development. APIs, settings, and internal behaviors may change. Use at your own risk, and please report any issues.

What’s on the roadmap?

• AI Agent Integration: Automatically trigger custom AI agents to analyze events or issue commands.
• Chat Service Bridges: Out-of-the-box support for Discord, Slack, etc., forwarding in-game chat to external channels (and vice versa).
• Additional Event Types: Research completions, pollution spikes, fluid system events, and more.
• Web Dashboard: Live visualization of event streams and metrics.

How can I contribute or get support?

• GitHub: https://github.com/tylerstraub/Factorio_Hivemind-MOD
• Issues & Discussions: Open an issue or join the Discussions tab.

Where can I learn more?

• Full developer documentation and technical guides live in the docs/ folder of the repo.
• See SAFETY.md for details on deterministic registration and multiplayer compatibility.
• Check RCON.md for profiling and remote-command best practices.