From 586f1a42ef5756af9497fa32bf4a43f90996d63d Mon Sep 17 00:00:00 2001
From: PsychoZander <62998704+PsychoZander@users.noreply.github.com>
Date: Wed, 5 Oct 2022 13:34:52 +0100
Subject: [PATCH] Create README.md

---
 game_eggs/factorio/clusterio/README.md | 47 ++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 game_eggs/factorio/clusterio/README.md

diff --git a/game_eggs/factorio/clusterio/README.md b/game_eggs/factorio/clusterio/README.md
new file mode 100644
index 00000000..6552882b
--- /dev/null
+++ b/game_eggs/factorio/clusterio/README.md
@@ -0,0 +1,47 @@
+# Clusterio
+
+## Introduction
+
+Clusterio (https://github.com/clusterio/clusterio) is a clustered Factorio server manager that provides the tooling for implementing cross server interactions in Factorio.
+It was previously best known for implementing cross server transfer and cloud storage of items via teleporter chests.
+But this functionality has been pulled out of Clusterio into its own plugin for Clusterio named [Subspace Storage](https://github.com/clusterio/subspace_storage).
+
+By itself Clusterio doesn't change the gameplay in any way, you could even use Clusterio to manage completely vanilla Factorio servers.
+Plugins do the work of modding in the visible changes into the game, see the [Plugins section](#plugins) for ready-made plugins you can install into a Clusterio cluster.
+
+## Features
+
+- Clustered Factorio server management allowing you manage the running of Factorio servers across a fleet of physical servers from both a web interface and a command line interface.
+
+- User list management for synchronizing in-game admins, whitelisted users, and bans to all the servers in the cluster.
+
+- Integrated support for exporting statistics for the whole cluster to Prometheus via a single metrics endpoint.
+
+- Extensive plugin support for adding your own cross server features to Factorio using Clusterio's communication backbone.
+
+## Setup
+
+Clusterio uses a Master/Slave system setup, with the Master server running the Web UI and controlling which Slaves run which Instances.
+
+The Master server runs a web server that needs to be reachable for cluster management by the user, and by the other nodes to manage them.
+
+The Slave server runs the factorio server, and will need any mods manually importing at this time, including the Factorio mods for the Clustorio Library(https://mods.factorio.com/mod/clusterio_lib) and Subspace Storage(https://mods.factorio.com/mod/subspace_storage).
+
+Both only require a single port each.
+
+Server Mode controls if the server is a master or slave, and each varaible is labeled as required for Master, Slave or All. Please ensure you fill in all required variables.
+
+Set up the master server first, and from there you can generate the Master URL and Master Token required for the slave servers to connect.
+
+Additional configuration options can be found in config-master.json and config-slave.json as relevant.
+
+Changes to the Cluster will only be written out to the database on a graceful stop.
+
+## Server Ports
+
+Clusterio requires a single port
+
+| Port       | default    |
+|------------|------------|
+| Master HTTP| 8081       |
+| Slave Game | 34197      |