factoirc 0.6

Method 1: file (recommended)

This method reads the Factorio chat from a console log.

[factoirc]
method = file
file = console.log

The console log can be generated using –console-log in Factorio 0.15:

$ factorio --rcon-port=27015 --rcon-password=password --start-server=save.zip --console-log=console.log

For Factorio < 0.15, you can redirect the Factorio output to a file to achieve the same behavior (doesn’t work on Windows):

$ factorio --rcon-port=27015 --rcon-password=password --start-server=save.zip > console.log

factorio-init users can also use the server.out file as input. Note that the systemd service for factorio-init does not save the output into the journal, so you can’t use the systemd method with it.

Warning: do not use the factorio-current.log file created by Factorio. It does not contain the chat log.

Method 2: systemd journal

This method applies only if your Factorio server runs under systemd (only for Linux machines) and its output is stored in the journal.

In this case, FactoIRC can directly read the log from the journal.

You’ll need the following options in your configuration file:

[factoirc]
method = systemd
unit = factorio.service

For this method to work, the python-systemd module is required and can be installed via pip:

$ pip3 install python-systemd

Method 3: stdin

This method reads the Factorio chat log from the standard input stream, it also supports reading from a file via shell redirection.

[factoirc]
method = stdin

You will need to connect the Factorio chat log output to the FactoIRC bot:

$ factorio --rcon-port=27015 --rcon-password=password --start-server=save.zip | irc3 config.ini

Forwarding customization

You can customize the forwarding of messages for the different game and irc actions, see config.example.ini for more information.