This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

FactoIRC is a bidirectional IRC bridge between Factorio and IRC. It comes as a plugin for the irc3 python module.

It can join one or more channels and forward messages back and forth between IRC and Factorio.

Some IRC commands are also provided :

  • !rcon: Execute an RCON command and return the result.
  • !players: Get the list of the currently online players.

FactoIRC uses the RCON protocol introduced in Factorio 0.13 to forward messages from IRC to Factorio.

As a result, FactoIRC will not work with Factorio 0.12 and earlier versions.

Forwarding Factorio chat messages to IRC requires access to the Factorio server output which can be done with two methods depending on your setup.

Installation

You’ll need to have Python 3.5 (or later) which can be obtained through your distribution’s package manager or downloaded from https://www.python.org/ (for Windows users).

On Windows, make sure to check the “Add Python 3.x to PATH” checkbox when installing.

Once Python is installed, FactoIRC can be installed using

$ pip3 install factoirc

Configuration

Configuration is done using the config.ini file. A config.example.ini file is provided as an example.

Depending on your setup, you will have to use either the stdin or the systemd method.

Method 1: stdin

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

You will need to connect the Factorio server output to the FactoIRC bot.

This can be achieved using a command such as:

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

Alternatively, you might want to separate execution of Factorio and the bot using an intermediate log file:

$ factorio ... > log.txt
$ irc3 config.ini < log.txt

Warning: do NOT use the factorio-current.log file created by Factorio, as it does not contain the chat log.

factorio-init users

factorio-init stores the server output in a file named server.out, which you can use as input:

$ irc3 config.ini < /opt/factorio/server.out

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.

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

You can then start FactoIRC:

$ irc3 config.ini

Debugging

irc3 can be started with the -v flag to show more log messages (including those generated by FactoIRC).

IRC raw traffic can be shown with -r.

Try irc3 -h for the full list of options.

Release History

Release History

0.5

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
factoirc-0.5-py3-none-any.whl (9.3 kB) Copy SHA256 Checksum SHA256 3.5 Wheel Jul 23, 2016
factoirc-0.5.tar.gz (8.0 kB) Copy SHA256 Checksum SHA256 Source Jul 23, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting