Fixed remoteMap stuff

Neural Dole v2

.gitignore

@@ -0,0 +1,70 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+dist/
+
+node_modules/*
+!node_modules/_app
+
+Factorio*
+/factorio
+/instances
+/sharedMods
+/database
+database/items.db
+config.json
+package-lock.json
+secret-api-token.txt
+mod_cache.json
+static/pictures/spritesheet.js
+static/pictures/spritesheet.png
+static/external
+saves
+
+# weird pattern to ignore sharedPlugins except not ignore some core modules
+!sharedPlugins/
+sharedPlugins/*
+!sharedPlugins/inventoryImports/
+!sharedPlugins/UPSdisplay/
+!sharedPlugins/remoteMap/
+!sharedPlugins/remoteCommands/
+!sharedPlugins/researchSync/
+!sharedPlugins/globalChat/
+!sharedPlugins/clusterioMod/
+!sharedPlugins/serverManager/
+sharedPlugins/serverManager/database/*
+sharedPlugins/serverManager/config.json
+sharedPlugins/serverManager/secret-api-token.txt
+!sharedPlugins/scenario_loader/
+sharedPlugins/scenario_loader/scenarios
+!sharedPlugins/statisticsExporter/
+
+# File used for marking plugins as disabled
+sharedPlugins/*/DISABLED
+
+\.cache-require-paths\.json
+
+\.vs/
+
+bin/

.snyk

@@ -0,0 +1,45 @@
+# Snyk (https://snyk.io) policy file, patches or ignores known vulnerabilities.
+version: v1.13.3
+ignore: {}
+# patches apply the minimum changes required to fix a vulnerability
+patch:
+  'npm:lodash:20180130':
+    - html5-validator > caporal > cli-table2 > lodash:
+        patched: '2018-07-03T06:07:55.532Z'
+  'npm:hawk:20160119':
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > request > hawk:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:http-signature:20150122':
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > request > http-signature:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:mime:20170907':
+    - node-factorio-api > documentation > highlight.js > gear-lib > mime:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > mime:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > request > form-data > mime:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:minimatch:20160620':
+    - node-factorio-api > documentation > highlight.js > gear > liftoff > findup-sync > glob > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > gear > liftoff > findup-sync > glob > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > glob > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > jslint > glob > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > jshint > cli > glob > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > jshint > minimatch:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:request:20160119':
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > request:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:tunnel-agent:20170305':
+    - node-factorio-api > documentation > highlight.js > gear-lib > less > request > tunnel-agent:
+        patched: '2019-02-25T06:48:21.845Z'
+  'npm:uglify-js:20151024':
+    - node-factorio-api > documentation > highlight.js > gear-lib > handlebars > uglify-js:
+        patched: '2019-02-25T06:48:21.845Z'
+    - node-factorio-api > documentation > highlight.js > gear-lib > uglify-js:
+        patched: '2019-02-25T06:48:21.845Z'

.travis.yml

@@ -0,0 +1,10 @@
+language: node_js
+node_js:
+  - "9"
+before_install:
+  - sudo apt-get -qq update
+  - sudo apt-get install -y curl git tar
+  - curl -o factorio.tar.gz -L https://www.factorio.com/get-download/latest/headless/linux64
+  - tar -xvf factorio.tar.gz
+script:
+  - npm run cover

.vs/ProjectSettings.json

@@ -0,0 +1,3 @@
+{
+  "CurrentProjectSetting": null
+}

.vs/VSWorkspaceState.json

@@ -0,0 +1,8 @@
+{
+  "ExpandedNodes": [
+    "",
+    "\\sharedPlugins"
+  ],
+  "SelectedNode": "\\.gitignore",
+  "PreviewInSolutionExplorer": false
+}

Dockerfile

@@ -0,0 +1,21 @@
+FROM node:9.11.2
+RUN apt-get update && apt install git curl tar -y
+RUN mkdir factorioClusterio
+
+RUN git clone -b master https://github.com/Danielv123/factorioClusterio.git && cd factorioClusterio && npm install
+RUN cd factorioClusterio && curl -o factorio.tar.gz -L https://www.factorio.com/get-download/latest/headless/linux64 && tar -xf factorio.tar.gz
+
+WORKDIR factorioClusterio
+RUN mkdir instances sharedMods
+RUN cp config.json.dist config.json
+
+RUN node client.js download
+
+LABEL maintainer "Sir3lit@gmail.com"
+
+EXPOSE 8080 34167
+VOLUME /factorioClusterio/instances
+VOLUME /factorioClusterio/sharedMods
+VOLUME /factorioClusterio/sharedPlugins
+
+CMD RCONPORT="$RCONPORT" FACTORIOPORT="$FACTORIOPORT" MODE="$MODE" node $MODE\.js start $INSTANCE

LICENSE.md

@@ -0,0 +1,26 @@
+This product uses the MIT License
+
+Copyright (c) 2016 Daniel Vestøl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The icons for angels modded items located in /static/pictures/ are licensed
+by https://mods.factorio.com/user/Arch666Angel under CC BY-NC-ND 4.0
+https://creativecommons.org/licenses/by-nc-nd/4.0/
+

README.md

@@ -1,18 +1,288 @@
-# Plugin page layout screenshots
+<img src="./logo.svg" width="100%" align="right">
 
-These screenshots render the real `PluginsPage`, `PluginVersions`, and `SiteLayout` components with synthetic controller/host responses.
+<br/>
-They are layout evidence, not a live cluster installation or restart test.
+<br/>
-The fixture has two machines, a pending awf_oarc update and web load error, an Auto Restart plugin without a host entrypoint, a Global Chat update, and an up-to-date Research Sync plugin.
+<br/>
 
-Before: `61f2b0117263516b592bba0b397e887065de5c4d`.
+# factorioClusterio
-After: `8229db75`.
-Mobile viewport: 390 x 844 CSS pixels.
-Desktop viewport: 1440 x 900 CSS pixels.
-Both use Edge through Playwright, device scale factor 1, dark theme, the same data and default sorting.
 
-The screenshots are kept on a separate evidence branch so they are not part of the code PR's diff.
+Discord for development/support/play: https://discord.gg/5XuDkje
 
-To reproduce, put `main.tsx`, `index.html`, `serve.mjs`, `capture.mjs` and `check.mjs` in `temp/plugin-layout/` of a Clusterio checkout.
+### Ways to support me/the project:
-Run `pnpm install --no-frozen-lockfile`, `npm install --prefix temp/plugin-layout --no-package-lock --no-save playwright`, and `node temp/plugin-layout/serve.mjs` from the repository root.
+
-With Microsoft Edge installed, run `node temp/plugin-layout/capture.mjs before` at the baseline or `node temp/plugin-layout/capture.mjs after` at the fixed commit.
+* Contribute with code/documentation. Always nice to move the project forward
-Run `node temp/plugin-layout/check.mjs` at the fixed commit for viewport bounds, search, sorting, navigation, account menu and checklist checks.
+
+* Support me monetarily on [patreon](https://www.patreon.com/danielv123) or paypal: danielv@live.no
+
+### Table of contents
+
+* [Introduction & methodology](#introduction)
+
+* [Ubuntu setup](#ubuntu-setup)
+
+* [Windows setup](#windows-setup)
+
+* [Optional plugins](#Plugins)
+
+* [Common problems](#Common-problems)
+
+* [Command cheatsheet](#cheatsheet)
+
+## Introduction
+
+Features:
+
+- Entities to send/recieve items
+
+- Cross dimensional storage
+
+- Sending of liquids
+
+- Sending of circuit network signals
+
+- Inventory combinator to display item levels in the cluster (and epoch time)
+
+- Reporting of graphs and UPS on master interface (Also has extensive Prometheus reporting)
+
+Optional extras (see [Plugins](#Plugins))
+
+- Have your inventory synchronize across servers
+
+- Teleport trans from the border of one world to te next
+
+- Show in-game chat in discord
+
+
+Connection diagram:
+
+![http://i.imgur.com/7FdVfgB.png](http://i.imgur.com/7FdVfgB.png)
+
+There can be any number of clients connected to each slave, and any number of slaves connected to a master but there can only be one master server in each cluster.
+
+**How does it work?**
+
+Traditional factorio mods have always been limited by the games deterministic design. This gives us a very bug free and predictable game, but doesn't allow us cool stuff such as internet communication.
+Clusterio exploits one of the games logging features, game.write_file and RCON to communicate between servers. Sending an item from one server to another takes this path:
+
+1. server1: Chest has stuff in it, write the contents to a file and delete them from the game world
+
+2. client.js on server1: File has stuff in it, parse and send to the master for storage
+
+3. master: server1 gave us stuff, store it in the storage and write some statistics
+
+4. server2: get-chest is empty, write a request to file
+
+5. client.js on server2: Request file has stuff in it, parse and send a request to master for more items of that type
+
+6. master: server2 asked for stuff, check if we have enough and how much demand there is, then send however much is appropriate back
+
+7. client.js on server2: We were allowed to import x of item y, run command /c remote.call("clusterio", "importMany", "{'copper-plate':120}")
+
+This process works the same for both items and liquids, independent on what mods are used. Yes, modded items are fully supported.
+
+Clusterio can also do a few other neat things, such as giving you access to epoch time, syncing player inventories between servers, keeping track of playtime (playerManager plugin), teleporting trains between servers (trainTeleports) and exporting tons of factorio related statistics to Prometheus for graphing in grafana.
+
+## Ubuntu setup
+
+NodeJS does not support EOL ubuntu releases. Make sure you are on the most recent LTS release or newer.
+
+Master and all slaves:
+
+    sudo curl -sL https://deb.nodesource.com/setup_9.x | sudo -E bash -
+    sudo apt install -y nodejs python-dev git wget curl tar build-essential
+    sudo npm install pm2 -g
+    git clone https://github.com/Danielv123/factorioClusterio.git
+    cd factorioClusterio
+    curl -o factorio.tar.gz -L https://www.factorio.com/get-download/latest/headless/linux64
+    tar -xf factorio.tar.gz
+    npm install
+    cp config.json.dist config.json
+    node ./lib/npmPostinstall.js
+
+
+downloads and installs nodejs, pm2, git and clusterio. To specify a version, change "latest" in the link to a version number like 0.14.21.
+
+Now you need to edit the `config.json` file. If you skip this step nothing will work.
+Pretty much all the blank fields should be filled in, except on the master where a few can be omitted.
+
+* You get the `masterAuthToken` from `secret-api-token.txt` in the master install dir after running the master twice.
+
+* You get your factorio matchmaking token from factorio.com
+
+* The `masterAuthSecret` should never be touched unless you want to invalidate everyones authentication tokens
+
+**Master**
+
+    pm2 start master.js --name master
+
+OR
+
+    node master.js
+
+**Server Host**
+
+To download the mod for all its non vanilla features and items, (optional, but very recommended)
+
+    node client.js manage shared mods add clusterio
+
+To create a new instance (its own save, set of mods and config files)
+
+    node client.js start [instancename]
+
+To launch an instance with pm2
+
+    pm2 start --name [instancename] client.js -- start [instancename]
+
+use `nano config.json` to change settings.
+
+**Ubuntu with Docker**
+
+Clusterio has *very* limited support for using docker.
+
+    sudo docker build -t clusterio --no-cache --force-rm factorioClusterio
+
+	sudo docker run --name master -e MODE=master -p 1234:8080 -d -it --restart=unless-stopped danielvestol/clusterio
+
+	sudo docker run --name slave -e MODE=client -e INSTANCE=world1 -v /srv/clusterio/instances:/factorioClusterio/instances -p 1235:34167 -it --restart=unless-stopped danielvestol/clusterio
+
+The -v flag is used to specify the instance directory. Your instances (save files etc) will be stored there.
+
+## Windows setup
+
+Clusterio is built up of multiple parts. Here is a quick guide:
+
+Master = master.js
+
+Server host (Slave) = client.js + factorio server
+
+Game Client = The people connecting to the server
+
+**Requirements**
+
+download and install nodeJS 8 or 9 from http://nodejs.org
+
+download and install git from https://git-scm.com/
+
+reboot when you are done, then proceed to the next steps. *reboots matter*
+
+**Master**
+
+1. download and run https://puu.sh/toFHl/01eebbb333.bat
+
+2. Copy config.json.dist to config.json
+
+3. Follow the instructions in the bat file
+3. Some of the instructions are outdated. If you get stuck somewhere, look at the Ubuntu section.
+
+4. Run `node client.js manage shared mods add clusterio`
+
+5. type `node master.js` to start the server
+
+**Server Host**
+
+1. download and run https://puu.sh/toFHl/01eebbb333.bat
+
+2. Copy config.json.dist to config.json
+
+3. Follow the instructions given.
+
+3.5 Some of the instructions are outdated. If you get stuck somewhere, look at the Ubuntu section.
+
+4. Type `node client.js start [instancename]` to create a new instance.
+
+To connect to a master server running on a remote machine, open config.json with your favourite text editor (notepad++). You can also set it up to use the official server browser.
+
+Change `masterIP `to something like `31.152.123.14` (provided by master server owner)
+
+Change `masterPort` to something like `8080` (provided by master server owner)
+
+Change `masterAuthToken` to the value found in `secret-api-token.txt` on the master server
+
+Repeat step 4 for more servers on one machine. You should be able to find its port by looking at the slave section on master:8080 (the web interface)
+
+**GameClient**
+
+Fancy game client that does the following steps automatically, but is really old so be warned: [clusterioClient](https://github.com/Danielv123/factorioClusterioClient)
+
+1. Download the same version of the mod as the slave is running from [the mod portal](https://mods.factorio.com/mods/Danielv123/clusterio) or [github](https://github.com/Danielv123/factorioClusterioMod
+
+2. Drop it into ./factorio/mods
+
+3. Run factorio and connect to slave as a normal MP game. You will find the port number to connect to at http://[masterAddress]:8080
+
+## Plugins
+Here are the known Clusterio plugins in the wild:
+1. [Player Manager](https://github.com/Danielv123/playerManager) - Adds player management to the Web UI and shared inventory handling (beta)
+2. [DiscordChat](https://github.com/jakedraddy/ClusterioDiscordChat) - Logs in-game chat/joins/leave messages on all instances to a Discord webhook.
+3. [TrainTeleports](https://github.com/Godmave/clusterioTrainTeleports) - Allows you to teleport cargotrains between servers.
+
+## Common problems
+
+### Cannot find module: `/../../config`
+
+Copy your config.json.dist to config.json and configure it.
+
+### EACCESS [...] LISTEN 443
+
+Some systems don't let non root processes listen to ports below 1000. Either run with `sudo` or change config.json to use higher port numbers.
+
+### InitializationError: First argument must be an abstract-leveldown compliant store
+
+do:
+
+    npm install linvodb3@3.25.1
+
+if that does not suffice do
+
+    npm install levelup@1.3.9
+
+If it still doesn't work, come over to our support discord linked at the top of this readme.
+
+### Portforwarding doesn't work on the master server when running under WSL
+
+If you follow the ubuntu guide on WSL (Windows Subsystem for Linux, Bash on Ubuntu on Windows specifically), you will find that the website works on localhost and on your local ip, but not on the global ip. This is also true when you correctly port-forwarded the correct ports. Even when routing this server through nginx in WSL, the issue persists. Then, on a hunch, I tried to run nginx from windows itself and found that this DID work. It came to me that the only usage difference between the 2 versions of nginx is that I got a Windows Firewall popup.
+
+TLDR: the tested fix is:
+
+- open your windows firewall and go to advanced settings
+
+- click on inbound rules and click on new rule...
+
+- select port and click next >
+
+- select TCP and select specific local ports and type in the ports that you want to open (comma separated) and click next > 3 times
+
+- give the rule a name (like 'web server' or something), give it a description (optionally) and click finish
+
+### Other fixes for other potential problems:
+
+Sometimes the install fails. Try `node ./lib/npmPostinstall.js` to complete it.
+
+
+## Cheatsheet
+
+**To create a new instance/start it**
+
+    node client.js start [instanceName]
+
+**Other instance management tools:**
+```
+node client.js delete [instanceName]
+node client.js list
+```
+**To update clusterio to the latest version:**
+
+1. Download the latest zip version of factorio for your platform manually from factorio.com. Place it in the project root folder and call it "factorio" (folder name is specified in config.json)
+
+2. Grab the latest version of the repo
+
+```
+git pull
+
+npm install
+```
+
+3. Download the latest version of the factorioClusterioMod from its github repo
+```
+node client.js manage shared mods add clusterio
+```

capture.mjs

@@ -1,14 +0,0 @@
-import { chromium } from "playwright";
-const browser = await chromium.launch({ channel: "msedge", headless: true });
-const page = await browser.newPage();
-page.on("pageerror", error => console.error(error));
-for (const [label, width, height] of [["desktop", 1440, 900], ["mobile", 390, 844]]) {
-	await page.setViewportSize({ width, height });
-	await page.goto("http://127.0.0.1:5173/plugins");
-	await page.getByRole("button", { name: "Update to 0.3.1", exact: true }).waitFor();
-	await page.evaluate(() => document.fonts.ready);
-	await page.screenshot({ path: `temp/plugin-layout/${process.argv[2]}-${label}.png` });
-	console.log(label, await page.evaluate(() => ({ width: innerWidth, scrollWidth: document.documentElement.scrollWidth,
-		rowHeights: [...document.querySelectorAll(".ant-table-tbody > tr")].map(row => row.getBoundingClientRect().height) })));
-}
-await browser.close();

check.mjs

@@ -1,57 +0,0 @@
-import assert from "node:assert/strict";
-import { chromium } from "playwright";
-const browser = await chromium.launch({ channel: "msedge", headless: true });
-const page = await browser.newPage();
-const errors = [];
-page.on("pageerror", error => errors.push(error.message));
-for (const width of [320, 390, 575, 767, 768, 1024, 1440]) {
-	await page.setViewportSize({ width, height: 900 });
-	await page.goto("http://127.0.0.1:5173/plugins");
-	await page.getByRole("button", { name: "Update to 0.3.1", exact: true }).waitFor();
-	const dimensions = await page.evaluate(() => ({
-		width: innerWidth, scrollWidth: document.documentElement.scrollWidth,
-		columns: document.querySelectorAll("thead th").length,
-		brand: document.querySelector(".site-layout-brand").getBoundingClientRect().height,
-		overflow: [...document.querySelectorAll(".plugin-mobile-details, .plugin-mobile-details .ant-btn")]
-			.filter(element => element.scrollWidth > element.clientWidth + 1).length,
-	}));
-	assert.equal(dimensions.scrollWidth, width);
-	assert.equal(dimensions.columns, width < 768 ? 1 : 3);
-	assert.equal(dimensions.overflow, 0);
-	assert.ok(dimensions.brand < 50);
-	console.log("Layout", width, dimensions);
-}
-for (const width of [390, 1440]) {
-	await page.setViewportSize({ width, height: 900 });
-	await page.goto("http://127.0.0.1:5173/plugins");
-	const update = page.getByRole("button", { name: "Update to 2.1.0", exact: true }).filter({ hasNot: page.locator("[disabled]") });
-	await page.locator(".ant-table-row").filter({ hasText: "Global Chat" }).getByRole("button").click();
-	await page.getByRole("dialog", { name: "Update Global Chat 2.1.0" }).waitFor();
-	assert.equal(new URL(page.url()).pathname, "/plugins");
-	await page.getByRole("button", { name: "Cancel", exact: true }).click();
-	await page.getByRole("button", { name: "Restart pending (2)" }).click();
-	await page.getByRole("dialog", { name: "Restart machines with a pending restart" }).waitFor();
-	await page.getByRole("button", { name: "Cancel", exact: true }).click();
-	await page.getByRole("button", { name: "Account menu for Cooldude2606" }).click();
-	await page.getByRole("menuitem", { name: "Cooldude2606" }).waitFor();
-	await page.keyboard.press("Escape");
-	await page.locator(".page-header-title").click();
-	await page.locator(".ant-table-filter-trigger").click();
-	await page.getByPlaceholder("Search plugins").fill("Global");
-	assert.equal(await page.locator(".ant-table-row").count(), 1);
-	await page.getByPlaceholder("Search plugins").press("Enter");
-	await page.reload();
-	await page.getByRole("link", { name: "Global Chat", exact: true }).waitFor();
-	assert.equal(await page.locator(".ant-table-row").count(), 1);
-	await page.getByRole("link", { name: "Global Chat", exact: true }).click();
-	await page.getByText("Plugin navigation target").waitFor();
-	await page.goto("http://127.0.0.1:5173/plugins");
-	await page.getByRole("columnheader", { name: /Name/ }).click();
-	await page.waitForFunction(() => document.querySelector(".ant-table-row")?.textContent.startsWith("Research Sync"));
-	assert.match(await page.locator(".ant-table-row").first().innerText(), /Research Sync/);
-	await page.locator(".ant-table-row").first().click();
-	await page.getByText("Plugin navigation target").waitFor();
-	console.log("Interactions passed", width);
-}
-assert.deepEqual(errors, []);
-await browser.close();

client.js

@@ -0,0 +1,799 @@
+const fs = require('fs-extra');
+const https = require('follow-redirects').https;
+const needle = require("needle");
+const child_process = require('child_process');
+const path = require('path');
+const syncRequest = require('sync-request');
+const request = require("request");
+const ncp = require('ncp').ncp;
+const Rcon = require('rcon-client').Rcon;
+const hashFiles = require('hash-files');
+const _ = require('underscore');
+const deepmerge = require("deepmerge");
+const getMac = require('getmac').getMac;
+const rmdirSync = require('rmdir-sync');
+const ioClient = require("socket.io-client");
+
+// internal libraries
+const objectOps = require("./lib/objectOps.js");
+const fileOps = require("_app/fileOps");
+const stringUtils = require("./lib/stringUtils.js");
+const configManager = require("./lib/manager/configManager.js");
+
+// argument parsing
+const args = require('minimist')(process.argv.slice(2));
+
+// require config.json
+var config = require(args.config || './config');
+var global = {};
+
+if (!fs.existsSync(config.instanceDirectory)) {
+	fs.mkdirSync(config.instanceDirectory);
+}
+if (!fs.existsSync("./sharedPlugins/")) {
+	fs.mkdirSync("sharedPlugins");
+}
+if (!fs.existsSync("./sharedMods/")) {
+	fs.mkdirSync("sharedMods");
+}
+const instance = process.argv[3];
+const instancedirectory = config.instanceDirectory + '/' + instance;
+const command = process.argv[2];
+
+// Set the process title, shows up as the title of the CMD window on windows
+// and as the process name in ps/top on linux.
+process.title = "clusterioClient "+instance;
+
+// add better stack traces on promise rejection
+process.on('unhandledRejection', r => console.log(r));
+
+// make sure we have the master access token (can't write to master without it since clusterio 2.0)
+if(!config.masterAuthToken || typeof config.masterAuthToken !== "string"){
+	console.error("ERROR invalid config!");
+	console.error("Master server now needs an access token for write operations. As clusterio slaves depends \
+	upon this, please add your token to config.json in the field named masterAuthToken. \
+	You can retrieve your auth token from the master in secret-api-token.txt after running it once.");
+}
+const needleOptionsWithTokenAuthHeader = {
+	headers: {
+		'x-access-token': config.masterAuthToken
+	},
+};
+
+var instanceInfo = {};
+var commandBuffer=[];
+// messageInterface Management
+setInterval(function(){
+	let command=commandBuffer.shift();
+	if(command){
+		messageInterfaceInternal(command[0], command[1], command[2], command[3]);
+	}
+},config.msBetweenCommands || 50);
+
+// function to handle sending commands into the game
+async function messageInterfaceInternal(command, callback, resolve, reject) {
+	// try to save us if you send a buffer instead of string
+	if(typeof command == "object") {
+		command = command.toString('utf8');
+	}
+	
+	if(false && process.platform == "linux" && typeof command == "string" && serverprocess) {
+		/*
+			to send to stdin, use:
+			serverprocess.stdin.write("/c command;\n")
+		*/
+		serverprocess.stdin.write(command+"\n");
+		if(typeof callback == "function"){
+			callback();
+		}
+		resolve();
+	} else if(typeof command == "string" && client && client.send && typeof client.send == "function") {
+		try {
+			let str = await client.send(command+"\n");
+			if(typeof callback == "function") callback(str)
+			resolve(str)
+		} catch (err) {
+			console.log("RCON failed, server might be paused or shutting down");
+			// console.log(err);
+			// reject(err);
+			if(typeof callback == "function"){
+				callback();
+			}
+			reject(err)
+		}
+	}
+}
+function messageInterface(command, callback) {
+	return new Promise((resolve,reject) => {
+		commandBuffer.push([command,callback, resolve, reject]);
+	});
+}
+
+
+// handle commandline parameters
+if (!command || command == "help" || command == "--help") {
+	console.error("Usage: ");
+	console.error("node client.js start [instance name]");
+	console.error("node client.js list");
+	console.error("node client.js delete [instance]");
+	console.error("To download the latest version of the Clusterio lua mod, do");
+	console.error("node client.js manage shared mods download clusterio");
+	console.error("To download a clusterio plugin, do");
+	console.error("node client.js manage shared plugins install https://github.com/Danielv123/playerManager");
+	console.error("For more management options, do");
+	console.error("node client.js manage");
+	process.exit(1);
+} else if (command == "list") {
+	let instanceNames = fileOps.getDirectoriesSync(config.instanceDirectory);
+	instanceNames.unshift("Name:");
+	let longestInstanceName = 0;
+	// determine longest instance name
+	instanceNames.forEach(function(instance){
+		if(instance.length > longestInstanceName) longestInstanceName = instance.length;
+	});
+	let displayLines = [];
+	// push name coloumn to array
+	instanceNames.forEach(function(instance){
+		while(instance.length < longestInstanceName+1){
+			instance += " ";
+		}
+		displayLines.push("| "+ instance + "|");
+	});
+	// create port colloumn
+	let factorioPorts = [];
+	instanceNames.forEach(function(instance){
+		let factorioPort;
+		
+		if(instance.includes("Name:")){
+			factorioPort = "Port:"
+		} else {
+			factorioPort = require(path.resolve(config.instanceDirectory, instance, 'config')).factorioPort;
+		}
+		factorioPorts.push(factorioPort);
+	});
+	factorioPorts.forEach((port, index) => {
+		let longestPort = 0;
+		factorioPorts.forEach((port, index) => {
+			if(port.toString().length > longestPort) longestPort = port.toString().length;
+		});
+		while(port.toString().length < longestPort){
+			port += " ";
+		}
+		factorioPorts[index] = port;
+	});
+	instanceNames.forEach(function(instance, index){
+		displayLines[index] += " " + factorioPorts[index] + " |";
+	});
+	
+	displayLines.forEach(line => console.log(line));
+	process.exit(0);
+} else if (command == "manage"){
+	// console.log("Launching mod manager");
+	//const fullUsage = 'node client.js manage [instance, "shared"] ["mods", "config"] ...';
+	function usage(instance, tool, action){
+		if(tool && tool == "mods"){
+			console.log('node client.js manage '+instance+' '+tool+' ["list", "search", "add", "remove", "update"]');
+		} else if(tool && tool == "config") {
+			console.log('node client.js manage '+instance+' '+tool+' ["list", "edit"]');
+		} else if(tool && tool == "plugins") {
+			console.log(`node client.js manage ${instance} ${tool} ["list", "add", "remove"]`);
+		} else {
+			console.log('node client.js manage '+(instance || '[instance, "shared"]') +' '+ (tool || '["mods", "config", "plugins"]') + ' ...');
+		}
+	}
+	const tool = process.argv[4] || "";
+	const action = process.argv[5] || "";
+	if(instance){
+		if(tool == "mods"){
+			(async function(){try{
+				// do require down here to reduce master load time
+				const modManager = require("./lib/manager/modManager.js")(config);
+				
+				// allow managing mods
+				if(action == "list"){
+					console.log(await modManager.listMods(instance));
+				} else if(action == "search"){
+					console.log(await modManager.findMods(process.argv[6]));
+				} else if(action == "add" || action == "download"){
+					await modManager.addMod(process.argv[6], instance);
+				} else if(action == "remove" || action == "rm" || action == "delete"){
+					await modManager.removeMod(process.argv[6], instance);
+				} else if(action == "update"){
+					await modManager.updateAllMods();
+				} else {
+					usage(instance, tool);
+				}
+				process.exit(0);
+			}catch(e){
+				console.log("Got error from modManager:")
+				console.log(e);
+			}})();
+		} else if(tool == "config"){
+			// allow managing the config
+			if(action == "list" || action == "show" || action == "display"){
+				configManager.displayConfig(instance);
+			} else if(action == "edit"){
+				let newConfigValue = "";
+				process.argv.forEach((arg, i)=>{
+					if(i >= 8){
+						newConfigValue += " "+arg;
+					} else if(i >= 7){
+						newConfigValue += arg;
+					}
+				});
+				configManager.editConfig(instance, process.argv[6], newConfigValue);
+			} else {
+				usage(instance, tool);
+			}
+		} else if(tool == "plugins"){
+			(async function(){try{
+				const pluginManager = require("./lib/manager/pluginManager.js")(config);
+				if(action == "list"){
+					await pluginManager.listPlugins();
+				} else if(action == "add" || action == "install" || action == "download"){
+					let status = await pluginManager.addPlugin(process.argv[6]);
+				} else if(action == "remove" || action == "uninstall" || action == "delete"){
+					let status = await pluginManager.removePlugin(process.argv[6]);
+					if(status && status.msg) console.log(status.msg);
+				} else if(action == "enable"){
+					let status = await pluginManager.enablePlugin(process.argv[6]);
+					if(status && status.msg) console.log(status.msg);
+				} else if(action == "disable"){
+					let status = await pluginManager.disablePlugin(process.argv[6]);
+					if(status && status.msg) console.log(status.msg);
+				}
+				process.exit(0);
+			}catch(e){
+				console.error(e);
+				process.exit(1);
+			}})();
+		} else {
+			usage(instance);
+		}
+	} else {
+		console.log('Usage:');
+		usage(instance);
+	}
+	// process.exit(0);
+} else if (command == "delete") {
+	if (!process.argv[3]) {
+		console.error("Usage: node client.js delete [instance]");
+		process.exit(1);
+	} else if (typeof process.argv[3] == "string" && fs.existsSync(config.instanceDirectory+"/" + process.argv[3]) && process.argv[3] != "/" && process.argv[3] != "") {
+		fileOps.deleteFolderRecursiveSync(path.resolve(config.instanceDirectory, process.argv[3])); // TODO: Check if this can cause i-craft users to format their server by using wrong paths
+		console.log("Deleted instance " + process.argv[3]);
+		process.exit(0);
+	} else {
+		console.error("Instance not found: " + process.argv[3]);
+		process.exit(0);
+	}
+} else if (command == "download") {
+	console.log("Downloading mods...");
+	// get JSON data about releases
+	let res = syncRequest('GET', 'https://api.github.com/repos/Danielv123/factorioClusterioMod/releases', {"headers":{"User-Agent":"Fuck you for requiring user agents!"}});
+	let url = JSON.parse(res.getBody())[0].assets[0].browser_download_url;
+	let name = JSON.parse(res.getBody())[0].assets[0].name;
+	if(url) {
+		console.log(url);
+		let file = fs.createWriteStream("sharedMods/"+name);
+		https.get(url, function(response) {
+			response.on('end', function () {
+				console.log("Downloaded "+name);
+				process.exit(0);
+			});
+			response.pipe(file);
+		}).end();
+	}
+} else if (command == "start" && instance === undefined) {
+	console.error("ERROR: No instanceName provided!");
+	console.error("Usage: node client.js start [instanceName]");
+	process.exit(0);
+} else if (command == "start" && typeof instance == "string" && instance != "/" && !fs.existsSync(instancedirectory)) {
+	// if instance does not exist, create it
+	console.log("Creating instance...");
+	fs.mkdirSync(instancedirectory);
+	fs.mkdirSync(instancedirectory + "/script-output/");
+	fs.mkdirSync(instancedirectory + "/saves/");
+	fs.writeFileSync(instancedirectory + "/script-output/output.txt", "");
+	fs.writeFileSync(instancedirectory + "/script-output/orders.txt", "");
+	fs.writeFileSync(instancedirectory + "/script-output/txbuffer.txt", "");
+	fs.mkdirSync(instancedirectory + "/mods/");
+	fs.mkdirSync(instancedirectory + "/instanceMods/");
+    fs.mkdirSync(instancedirectory + "/scenarios/");
+    ncp("./lib/scenarios", path.resolve(instancedirectory, "scenarios"), err => {
+        if (err) console.error(err)
+    });
+
+	// fs.symlinkSync('../../../sharedMods', instancedirectory + "/mods", 'junction') // This is broken because it can only take a file as first argument, not a folder
+	fs.writeFileSync(instancedirectory + `/config.ini`, `[path]\r\n
+read-data=${ path.resolve(config.factorioDirectory, "data") }\r\n
+write-data=${ path.resolve(config.instanceDirectory, instance) }\r\n
+	`);
+
+	// this line is probably not needed anymore but Im not gonna remove it
+	fs.copySync('sharedMods', path.join(instancedirectory, "mods"));
+	let instconf = {
+		"factorioPort": args.port || process.env.FACTORIOPORT || Math.floor(Math.random() * 65535),
+		"clientPort": args["rcon-port"] || process.env.RCONPORT || Math.floor(Math.random() * 65535),
+		"__comment_clientPassword": "This is the rcon password. Its also used for making an instanceID. Make sure its unique and not blank.",
+		"clientPassword": args["rcon-password"] || Math.random().toString(36).replace(/[^a-z]+/g, '').substr(0, 8),
+	}
+	console.log("Clusterio | Created instance with settings:")
+	console.log(instconf);
+
+	// create instance config
+	fs.writeFileSync(instancedirectory + "/config.json", JSON.stringify(instconf, null, 4));
+
+	let name = "Clusterio instance: " + instance;
+	if (config.username) {
+		name = config.username + "'s clusterio " + instance;
+	}
+	let serversettings = {
+		"name": name,
+		"description": config.description,
+		"tags": ["clusterio"],
+		"max_players": "20",
+		"visibility": config.visibility,
+		"username": config.username,
+		"token": config.token,
+		"game_password": config.game_password,
+		"verify_user_identity": config.verify_user_identity,
+		"admins": [config.username],
+		"allow_commands": config.allow_commands,
+		"autosave_interval": 10,
+		"autosave_slots": 5,
+		"afk_autokick_interval": 0,
+		"auto_pause": config.auto_pause,
+	};
+	fs.writeFileSync(instancedirectory + "/server-settings.json", JSON.stringify(serversettings, null, 4));
+    console.log("Server settings: "+JSON.stringify(serversettings, null, 4));
+    console.log("Creating save .....");
+    let factorio = child_process.spawn(
+        './' + config.factorioDirectory + '/bin/x64/factorio', [
+            '-c', instancedirectory + '/config.ini',
+            // '--create', instancedirectory + '/saves/save.zip',
+            '--start-server-load-scenario', 'Hotpatch',
+            '--server-settings', instancedirectory + '/server-settings.json',
+            '--rcon-port', Number(process.env.RCONPORT) || instconf.clientPort,
+            '--rcon-password', instconf.clientPassword,
+        ], {
+            'stdio': ['pipe', 'pipe', 'pipe']
+        }
+    );
+    factorio.stdout.on("data", data => {
+        data = data.toString("utf8").replace(/(\r\n\t|\n|\r\t)/gm,"");
+        console.log(data);
+        if(data.includes("Starting RCON interface")){
+            let client = new Rcon();
+            client.connect({
+                host: 'localhost',
+                port: Number(process.env.RCONPORT) || instconf.clientPort,
+                password: instconf.clientPassword,
+                timeout: 5000
+            });
+            client.onDidAuthenticate(() => {
+                console.log('Clusterio | RCON Authenticated!');
+            });
+            client.onDidConnect(() => {
+                console.log('Clusterio | RCON Connected, starting save');
+                client.send("/c game.server_save('hotpachSave')");
+            });
+        }
+        if(data.includes("Saving finished")){
+            console.log("Map saved as hotpachSave.zip, exiting...");
+            console.log("Instance created!")
+            process.exit(0);
+        }
+		if(data.includes("Downloading from auth server failed")){
+			console.error("Instance creation failed, unable to establish auth server connection.");
+			console.error("Deleting broken instance...");
+			
+			fileOps.deleteFolderRecursiveSync(path.resolve(config.instanceDirectory, process.argv[3]));
+			
+			process.exit(0);
+		}
+    });
+} else if (command == "start" && typeof instance == "string" && instance != "/" && fs.existsSync(instancedirectory)){(async () => {
+	// Exit if no instance specified (it should be, just a safeguard);
+	if(instancedirectory != config.instanceDirectory+"/undefined"){
+		var instanceconfig = require(path.resolve(instancedirectory,'config'));
+		instanceconfig.unique = stringUtils.hashCode(instanceconfig.clientPassword);
+		if(process.env.FACTORIOPORT){
+			instanceconfig.factorioPort = process.env.FACTORIOPORT;
+		}
+		if(process.env.RCONPORT){
+			instanceconfig.rconPort = process.env.RCONPORT;
+		}
+	} else {
+		process.exit(1);
+	}
+	console.log("Deleting .tmp.zip files");
+	let savefiles = fs.readdirSync(path.join(instancedirectory,"saves"));
+	for(i = 0; i < savefiles.length; i++){
+		if(savefiles[i].substr(savefiles[i].length - 8, 8) == ".tmp.zip") {
+			fs.unlinkSync(path.resolve(instancedirectory, "saves", savefiles[i]));
+		}
+	}
+	console.log("Clusterio | Rotating old logs...");
+	// clean old log file to avoid crash
+	try{
+		let logPath = path.join(instancedirectory,'factorio-current.log');
+		let stat = await fs.stat(logPath);
+		console.log(stat)
+		console.log(stat.isFile())
+		if(stat.isFile()){
+			let logFilename = `factorio-${Math.floor(Date.parse(stat.mtime)/1000)}.log`;
+			await fs.rename(logPath, path.join(instancedirectory, logFilename));
+			console.log(`Log rotated as ${logFilename}`);
+		}
+	}catch(e){}
+	// Math.floor(Date.now()/1000)
+	// (new Date).toGMTString()
+	
+	// move mods from ./sharedMods to the instances mod directory
+	try{fs.mkdirSync(path.join(instancedirectory, "instanceMods"));}catch(e){}
+	try{rmdirSync(path.join(instancedirectory, "mods"));}catch(e){}
+	try {
+		// mods directory that will be emptied (deleted) when closing the server to facilitate seperation of instanceMods and sharedMods
+		fs.mkdirSync(path.join(instancedirectory, "mods"));
+	} catch(e){}
+	console.log("Clusterio | Moving shared mods from sharedMods/ to instance/mods...");
+	fs.copySync('sharedMods', path.join(instancedirectory, "mods"));
+	console.log("Clusterio | Moving instance specific mods from instance/instanceMods to instance/mods...");
+	fs.copySync(path.join(instancedirectory, "instanceMods"), path.join(instancedirectory, "mods"));
+	
+	// Set paths for factorio so it reads and writes from the correct place even if the instance is imported from somewhere else
+	fs.writeFileSync(instancedirectory + `/config.ini`, `[path]\r\n
+read-data=${ path.resolve(config.factorioDirectory, "data") }\r\n
+write-data=${ path.resolve(config.instanceDirectory, instance) }\r\n
+	`);
+	
+	// Spawn factorio server
+	//var serverprocess = child_process.exec(commandline);
+	fileOps.getNewestFile(instancedirectory + "/saves/", fs.readdirSync(instancedirectory + "/saves/"),function(err, latestSave) {
+		if(err) {
+			console.error("ERROR!");
+			console.error("Your savefile seems to be missing. This might because you created an instance without having factorio\
+ installed and configured properly. Try installing factorio and adding your savefile to instances/[instancename]/saves/\n");
+			throw err;
+		}
+		// implicit global
+		serverprocess = child_process.spawn(
+			'./' + config.factorioDirectory + '/bin/x64/factorio', [
+				'-c', instancedirectory + '/config.ini',
+				'--start-server', latestSave.file,
+				'--rcon-port', args["rcon-port"] || Number(process.env.RCONPORT) || instanceconfig.clientPort,
+				'--rcon-password', args["rcon-password"] || instanceconfig.clientPassword,
+				'--server-settings', instancedirectory + '/server-settings.json',
+				'--port', args.port || Number(process.env.FACTORIOPORT) || instanceconfig.factorioPort
+			], {
+				'stdio': ['pipe', 'pipe', 'pipe']
+			}
+		);
+
+		serverprocess.on('close', code => {
+			console.log(`child process exited with code ${code}`);
+			process.exit();
+		});
+		serverprocess.stdout.on("data", data => {
+			// log("Stdout: " + data);
+			if(data.toString('utf8').includes("Couldn't parse RCON data: Maximum payload size exceeded")){
+				console.error("ERROR: RCON CONNECTION BROKE DUE TO TOO LARGE PACKET!");
+				console.error("Attempting reconnect...");
+				client.disconnect();
+				client.connect();
+			}
+			// we have to do this to make logs visible on linux and in powershell. Causes log duplication for people with CMD.
+			console.log('Fact: ' + data.toString("utf8").replace("\n", ""));
+		});
+		serverprocess.stderr.on('data', (chunk) => {
+			console.log('ERR: ' + chunk);
+		});
+
+		// connect to the server with rcon
+		if(true || process.platform != "linux"){
+			// IP, port, password
+			client = new Rcon();
+			
+			// check the logfile to see if the RCON interface is running as there is no way to continue without it
+			// we read the log every 2 seconds and stop looping when we start connecting to factorio
+			function checkRcon() {
+				fs.readFile(instancedirectory+"/factorio-current.log", function (err, data) {
+					// if (err) console.error(err);
+					if(data && data.indexOf('Starting RCON interface') > 0){
+						client.connect({
+							host: 'localhost',
+							port: args["rcon-port"] || Number(process.env.RCONPORT) || instanceconfig.clientPort,
+							password: args["rcon-password"] || instanceconfig.clientPassword,
+							timeout: 5000
+						});
+					} else {
+						setTimeout(function(){
+							checkRcon();
+						},5000);
+					}
+				});
+			}
+			setTimeout(checkRcon, 5000);
+		
+			client.onDidAuthenticate(() => {
+				console.log('Clusterio | RCON Authenticated!');
+				instanceManagement(instanceconfig); // start using rcons
+			});
+			client.onDidConnect(() => {
+				console.log('Clusterio | RCON Connected!');
+				// getID();
+			});
+			client.onDidDisconnect(() => {
+				console.log('Clusterio | RCON Disconnected!');
+				// process.exit(0); // exit because RCON disconnecting is undefined behaviour and we rather just wanna restart now
+			});
+			process.on('SIGINT', function () {
+				console.log("Caught interrupt signal, disconnecting RCON");
+				client.disconnect().then(()=>{
+					console.log("Rcon disconnected, Sending ^C");
+					// We don't actually do this on windows, because ctrl+c in windows CMD sends it to all subprocesses as well. Doing it twice will abort factorios save.
+					if(process.platform == "linux"){
+						serverprocess.kill("SIGINT");
+					}
+				});
+			});
+		} else if(process.platform == "linux"){
+			// don't open an RCON connection and just use stdio instead, does not work on windows.
+			instanceManagement(instanceconfig);
+			process.on('SIGINT', function () {
+				console.log("Caught interrupt signal, sending ^C");
+				serverprocess.kill("SIGINT");
+			});
+		}
+
+		// set some globals
+		confirmedOrders = [];
+		lastSignalCheck = Date.now();
+	});
+})()} else {
+	console.error("Invalid arguments, quitting.");
+	process.exit(1);
+}
+
+// ensure instancemanagement only ever runs once
+_.once(instanceManagement);
+async function instanceManagement(instanceconfig) {
+    console.log("Started instanceManagement();");
+
+    /* Open websocket connection to master */
+	var socket = ioClient("http://"+config.masterIP+":"+config.masterPort);
+	socket.on("hello", data => {
+		console.log("SOCKET | registering slave!");
+		socket.emit("registerSlave", {
+			instanceID: instanceconfig.unique,
+		});
+	});
+	setInterval(B=> socket.emit("heartbeat"), 10000);
+
+	// load plugins and execute onLoad event
+	const pluginManager = require("./lib/manager/pluginManager.js")(config);
+	let pluginsToLoad = await pluginManager.getPlugins();
+	let plugins = [];
+	
+	for(let i = 0; i < pluginsToLoad.length; i++){
+		let pluginLoadStarted = Date.now();
+		let log = function(message) {
+			console.log("Clusterio | "+ pluginsToLoad[i].name + " | " + message);
+		}
+		let combinedConfig = deepmerge(instanceconfig,config,{clone:true});
+		let pluginConfig = pluginsToLoad[i];
+		
+		if(!global.subscribedFiles) {
+			global.subscribedFiles = {};
+		}
+		if(pluginConfig.binary == "nodePackage" && pluginConfig.enabled){
+			// require plugin class and execute it
+			let pluginClass = require(path.resolve(pluginConfig.pluginPath, "index.js"));
+			plugins[i] = new pluginClass(combinedConfig, async function(data, callback){
+				if(data && data.toString('utf8')[0] != "/") {
+					log(data.toString('utf8'));
+					return true;
+				} else if (data && data.toString('utf8')[0] == "/"){
+					return messageInterface(data.toString('utf8'), callback);
+				}
+			}, { // extra functions to pass in object. Should have done it like this from the start, but won't break backwards compat.
+				socket, // socket.io connection to master (and ES6 destructuring, yay)
+			});
+			if(plugins[i].factorioOutput && typeof plugins[i].factorioOutput === "function"){
+				// when factorio logs a line, send it to the plugin. This includes things like autosaves, chat, errors etc
+				serverprocess.stdout.on("data", data => plugins[i].factorioOutput(data.toString()));
+			}
+			if(pluginConfig.scriptOutputFileSubscription && typeof pluginConfig.scriptOutputFileSubscription == "string"){
+				if(global.subscribedFiles[pluginConfig.scriptOutputFileSubscription]) {
+					// please choose a unique file to subscribe to. If you need plugins to share this interface, set up a direct communication
+					// between those plugins instead.
+					throw "FATAL ERROR IN " + pluginConfig.name + " FILE ALREADY SUBSCRIBED " + pluginConfig.scriptOutputFileSubscription;
+				}
+				
+				if (!fs.existsSync(instancedirectory + "/script-output/" + pluginConfig.scriptOutputFileSubscription)) {
+					// Do something
+					fs.writeFileSync(instancedirectory + "/script-output/" + pluginConfig.scriptOutputFileSubscription, "");
+				}
+				global.subscribedFiles[pluginConfig.scriptOutputFileSubscription] = true;
+				console.log("Clusterio | Registered file subscription on "+instancedirectory + "/script-output/" + pluginConfig.scriptOutputFileSubscription);
+				
+				fs.watch(instancedirectory + "/script-output/" + pluginConfig.scriptOutputFileSubscription, fileChangeHandler);
+				// run once in case a plugin wrote out information before the plugin loaded fully
+				// delay, so the socket got enough time to connect
+				setTimeout(()=> {
+                    fileChangeHandler(false, pluginConfig.scriptOutputFileSubscription);
+                }, 500);
+				// send file contents to plugin for processing
+				function fileChangeHandler(eventType, filename) {
+					if(filename != null){
+						setTimeout(
+							()=>{
+								// get array of lines in file
+								let stuff = fs.readFileSync(instancedirectory + "/script-output/" + filename, "utf8").split("\n");
+
+								// if you found anything, reset the file
+								if (stuff[0]) {
+									fs.writeFileSync(instancedirectory + "/script-output/" + filename, "");
+								}
+								for(let o = 0; o < stuff.length; o++) {
+									if(stuff[o] && !stuff[o].includes('\u0000\u0000')) {
+										try{
+											plugins[i].scriptOutput(stuff[o]);
+										}catch(e){
+											throw new Error(`Plugin ${pluginConfig.name} has a fileOutputSubscription but plugin.scriptOutput is not a function`)
+										}
+									}
+								}
+							},
+							pluginConfig.fileReadDelay || 0
+						);
+					}
+				}
+			}
+			console.log(`Clusterio | Loaded plugin ${pluginsToLoad[i].name} in ${Date.now() - pluginLoadStarted}ms`);
+		} else {
+			// this plugin doesn't have a client portion. Maybe it runs on the master only?
+		}
+	}
+
+	// world IDs ------------------------------------------------------------------
+	hashMods(instance, function(modHashes){
+		setInterval(getID, 10000);
+		getID();
+		function getID() {
+			messageInterface("/silent-command rcon.print(#game.connected_players)", function(playerCount) {
+				var payload = {
+					time: Date.now(),
+					rconPort: instanceconfig.clientPort,
+					rconPassword: instanceconfig.clientPassword,
+					serverPort: instanceconfig.factorioPort,
+					unique: instanceconfig.unique,
+					publicIP: config.publicIP, // IP of the server should be global for all instances, so we pull that straight from the config
+					mods:modHashes,
+					instanceName: instance,
+				}
+				if(playerCount){
+					payload.playerCount = playerCount.replace(/(\r\n\t|\n|\r\t)/gm, "");
+				} else {
+					payload.playerCount = 0;
+				}
+				
+				function callback(err, mac) {
+					if (err) {
+						mac = "unknown";
+						console.log("##### getMac crashed, but we don't really give a shit because we are probably closing down #####");
+					}
+					global.mac = mac;
+					payload.mac = mac;
+					// console.log("Registered our presence with master "+config.masterIP+" at " + payload.time);
+					needle.post(config.masterIP + ":" + config.masterPort + '/api/getID', payload, needleOptionsWithTokenAuthHeader, function (err, response, body) {
+						if (err && err.code != "ECONNRESET"){
+                            console.error("We got problems, something went wrong when contacting master"+config.masterIP+" at " + payload.time);
+							console.error(err);
+						} else if (response && response.body) {
+							// In the future we might be interested in whether or not we actually manage to send it, but honestly I don't care.
+							if(response.body !== "ok") {
+                                console.log("Got no \"ok\" while registering our precense with master "+config.masterIP+" at " + payload.time);
+                                console.log(response.body);
+                            }
+						}
+					});
+				}
+				if(global.mac){
+					callback(undefined, global.mac);
+				} else {
+					getMac(callback);
+				}
+			});
+		}
+	});
+	// Mod uploading and management -----------------------------------------------
+	// get mod names and hashes
+	// string: instance, function: callback
+	
+	setTimeout(function(){hashMods(instance, uploadMods)}, 5000);
+	function uploadMods(modHashes) {
+		// [{modName:string,hash:string}, ... ]
+		for(let i=0;i<modHashes.length;i++){
+			let payload = {
+				modName: modHashes[i].modName,
+				hash: modHashes[i].hash,
+			}
+			needle.post(config.masterIP + ":" + config.masterPort + '/api/checkMod', payload, needleOptionsWithTokenAuthHeader, function (err, response, body) {
+				if(err) console.error("Unable to contact master server /api/checkMod! Please check your config.json.");
+				if(response && body && body == "found") {
+					console.log("master has mod "+modHashes[i].modName);
+				} else if (response && body && typeof body == "string") {
+					let mod = response.body;
+					if(config.uploadModsToMaster){
+						console.log("Sending mod: " + mod);
+						// Send mods master says it wants
+						// response.body is a string which is a modName.zip
+						var req = request.post({url: "http://"+config.masterIP + ":" + config.masterPort + '/api/uploadMod',
+							headers: {
+								"x-access-token": config.masterAuthToken,
+							},
+						}, function (err, resp, body) {
+							if (err) {
+								console.error(new Error("Unable to contact master server /api/uploadMod! Please check your config.json."));
+							} else {
+								console.log('URL: ' + body);
+							}
+						});
+						var form = req.form();
+						form.append('file', fs.createReadStream(config.instanceDirectory+"/"+instance+"/mods/"+mod));
+					} else {
+						console.log("Not sending mod: " + mod + " to master because config.uploadModsToMaster is not enabled")
+					}
+				}
+			});
+		}
+	}
+} // END OF INSTANCE START ---------------------------------------------------------------------
+
+// string, function
+// returns [{modName:string,hash:string}, ... ]
+function hashMods(instanceName, callback) {
+	if(!callback) {
+		throw new Error("ERROR in function hashMods NO CALLBACK");
+	}
+	function callback2(hash, modName){
+		hashedMods[hashedMods.length] = {
+			modName: modName,
+			hash: hash,
+		}
+		// check if this callback has ran once for each mod
+		if(hashedMods.length == instanceMods.length) {
+			callback(hashedMods);
+		}
+		//console.log(modname);
+	}
+	let hashedMods = [];
+	/*let mods = fs.readdirSync("./sharedMods/")*/
+	let instanceMods = fs.readdirSync(config.instanceDirectory+"/"+instanceName+"/mods/");
+	if(instanceMods.length == 0){
+		callback({}); // there are no mods installed, return an empty object
+	}
+	for(let o=0;o<instanceMods.length;o++) {
+		if(path.extname(instanceMods[o]) != ".zip") {
+			instanceMods.splice(instanceMods.indexOf(instanceMods[o]), 1); // remove element from array, we can't hash unzipped mods
+		}
+	}
+	for(let i=0; i<instanceMods.length; i++){
+		let path = config.instanceDirectory+"/"+instanceName+"/mods/"+instanceMods[i];
+		let name = instanceMods[i];
+		let options = {
+			files:path,
+		}
+		// options {files:[array of paths]}
+		hashFiles(options, function(error, hash) {
+			// hash will be a string if no error occurred
+			if(!error){
+				callback2(hash, name);
+			} else {
+				throw error;
+			}
+		});
+	}
+}

cluster_rcon.js

@@ -0,0 +1,33 @@
+const needle = require("needle");
+const config = require("./config.json");
+
+const masterIP = `${config.masterIP}:${config.masterPort}`;
+const token = config.masterAuthToken
+let commandArray = process.argv;
+commandArray.shift();
+commandArray.shift();
+const needleOptionsWithTokenAuthHeader = {
+	headers: {
+		'x-access-token': token,
+	},
+};
+
+let command = commandArray.join(" ");
+let killBiters = `/silent-command local surface=game.surfaces[1] for key, entity in pairs(surface.find_entities_filtered({force="enemy"})) do entity.destroy() end`;
+
+(async ()=>{
+	needle.post(masterIP+"/api/runCommand", {
+		broadcast:true,
+		command,
+	}, needleOptionsWithTokenAuthHeader, (err, resp) => {
+		console.log(resp.body)
+	});
+	// setInterval(()=>{
+		// needle.post(masterIP+"/api/runCommand", {
+		// broadcast:true,
+		// command: killBiters,
+	// }, needleOptionsWithTokenAuthHeader, (err, resp) => {
+		// console.log(resp.body)
+	// });
+	// }, 1000*60*5);
+})();

config.json.dist

@@ -0,0 +1,63 @@
+{
+	"__comment": "Where factorio folder. Should be in the same folder as this config file.",
+	"factorioDirectory": "./factorio",
+	"instanceDirectory": "./instances",
+	"databaseDirectory": "./database",
+	
+	"__comment1": "IP players should connect to to join your servers, should be portforwarded and stuff",
+	"publicIP": "localhost",
+	
+	"__comment2": "IP the master web server runs at, can be ignored on the master system",
+	"masterIP": "localhost",
+	
+	"__commentMasterPort": "HTTP port for the master to listen to",
+	"masterPort": 8080,
+	
+	"__commentsslPort": "HTTPS port for the master to listen to. Set to 0 or an empty string to not listen for HTTPS.",
+	"sslPort": 443,
+	"sslCert": "database/certificates/cert.crt",
+	"sslPrivKey": "database/certificates/cert.key",
+	
+	"__commentMasterAuthToken": "Authentication token to connect to the master server. Find it in secret-api-token.txt on the master.",
+	"masterAuthToken": "",
+	
+	"__commentAuthSecret": "This is a long random string used for generating authentication tokens. Do not share. Regenerates when secret-api-token.txt is deleted.",
+	"masterAuthSecret": "",
+	
+	"__comment3": "Your factorio.com username for factorio MP services, also username will be admin on new instances",
+	"username": "",
+	"__comment4": "Token from your factorio.com profile page. Required for MP and mod manager services.",
+	"token": "",
+	"__comment7": "Used for communication with the mod portal, not needed if you manage mods by hand",
+	"factorio_version": "0.16.41",
+	
+	"__comment5": "General user settings",
+	"verify_user_identity": true,
+	"auto_pause": false,
+	"allow_commands": "admins-only",
+	"game_password": "",
+	"description": "This server runs Clusterio",
+	"visibility": {
+		"public": true,
+		"lan": true
+	},
+	"__comment6": "Statistic gathering statistics, may affect server performance (master memory usage especially)",
+	"itemStats": {
+		"maxEntries":60,
+		"entriesPerSecond": 0.01666666667
+	},
+	"logItemTransfers": false,
+	"__comment6.5": "When the master is undersupplied, we have 3 different modes to 'fairly' distribute items. First to ask gets all, dole division using weird formula or experimental neural net tries to make stuff as fair as possible. Feel free to play around.",
+	"disableFairItemDistribution": false,
+	"useNeuralNetDoleDivider": false,
+	"uploadModsToMaster": true,
+	"msBetweenCommands": 10,
+	"allowRemoteCommandExecution": true,
+	"enableCrossServerShout": true,
+	"mirrorAllChat": false,
+	"__comment7": "Autosave interval for items in the master storage in milliseconds. Defaults to one minute when set to 0 or not set.",
+	"autosaveInterval": 600000,
+	"disablePrometheusPushgateway": false,
+	"__comment8": "This setting only affects the master. It makes every import for things that arent 'electricity' return a maximum of 0. Effectively disables teleport chests.",
+	"disableImportsOfEverythingExceptElectricity": false
+}

documentation.yml

@@ -0,0 +1,10 @@
+toc:
+ - name: Master Server API
+ - clusterioMaster
+ - name: Type declarations
+ - itemStack
+ - name: Internal modules
+   description: |
+     Here are some helper functions for navigation.
+ - modManager
+ - getFactorioLocale

index.html

@@ -1,2 +0,0 @@
-<!doctype html>
-<html><head><meta name="viewport" content="width=device-width, initial-scale=1"><title>Plugin layout fixture</title></head><body><div id="root"></div><script>window.webRoot = "/";</script><script type="module" src="/temp/plugin-layout/main.tsx"></script></body></html>

lib/authenticate.js

@@ -0,0 +1,28 @@
+const jwt = require('jsonwebtoken');
+
+// const config = require("./../config");
+
+module.exports = function(config){
+	return {
+		middleware: function (req, res, next) {
+			var token = req.headers['x-access-token'];
+			if(!token) return res.status(401).send({ auth: false, message: 'No token provided.', endpoint: req.route.path});
+			
+			jwt.verify(token, config.masterAuthSecret, function(err, decoded) {
+				if(err) return res.status(500).send({ auth: false, message: 'Failed to authenticate token.', endpoint: req.route.path});
+				next();
+			});
+		},
+		check: async function(token){
+			return new Promise((resolve, reject) => {
+				jwt.verify(token, config.masterAuthSecret, function(err, decoded) {
+					if(err){
+						resolve({ok:false, msg:err})
+					} else {
+						resolve({ok:true, msg:"Successfully authenticated"});
+					}
+				});
+			});
+		}
+	}
+};

lib/dole_nn_base.js

@@ -0,0 +1,118 @@
+//Sigmoids...
+
+function sigmoid0(x)
+{
+	return x/(1+Math.abs(x));
+}
+function sigmoid1(x)
+{
+	if (x>=0.0) {
+		return 1.0
+	} else {
+		return 0.0
+	}
+}
+function sigmoid2(x)
+{
+	if (x>=0.0){
+		return x
+	} else {
+		return 0.0
+	}
+}
+function sigmoid3(x)
+{
+	return x;
+}
+
+//DOSE - Doses items for item X slave Y
+//Numreq - number of items that are requested for item X for slave Y
+//Instore - number of items for item X in master gauge (currently)
+//store_last_tick - Number of items for item X in master gauge at time of last tick
+//dole - Current dole for item X
+//carry - carry for item X slave Y
+//prev_req - Numreq for previous request for item X slave Y
+//* doleinfo_last - Object with 2 values for last "tick period": numreq - total number or requests for item, numslave - number of slaves requesting that item
+
+//Returns: Array of 3 elements
+//0.Number of items to give in that dose
+//1.New dole for item X
+//2.New carry for item X slave Y
+function Dose(numreq,instore,store_last_tick,dole,carry,prev_req,numreq_total_adj)
+{
+	numreq=Number(numreq);
+	instore=Number(instore);
+	var instore_adj=instore;
+	if (instore_adj==0) instore_adj=0.1;
+	
+	var b=Math.trunc(prev_req/instore_adj*numreq);
+	var inp1=[numreq,instore_adj,store_last_tick/numreq,dole,carry];//0..4
+	var inp2=[prev_req/numreq,numreq/numreq_total_adj,store_last_tick/numreq_total_adj,prev_req/instore_adj,b];//5..9
+	var inputs=inp1.concat(inp2);
+	var internal=[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0];
+	var outputs=[0,0,0];
+	//NN: Please don't touch :), code is generated
+	
+outputs[0]=inputs[2]*3.101320028;
+outputs[0]=outputs[0]+inputs[7]*0.5471593142;
+outputs[0]=outputs[0]+inputs[3]*2.691268921;
+outputs[0]=outputs[0]+outputs[1]*-1.64255929;
+outputs[0]=outputs[0]+inputs[6]*0.7746122479;
+outputs[0]=sigmoid0(outputs[0]);
+outputs[1]=inputs[2]*-0.9946503043;
+outputs[1]=outputs[1]+inputs[1]*0.2128598392;
+outputs[1]=sigmoid0(outputs[1]);
+outputs[2]=sigmoid2(outputs[2]);
+
+	outputs[0]=Number(outputs[0]);
+	if (outputs[0]<0) outputs[0]=0;
+	outputs[0]=outputs[0]*numreq;
+	var res1=Math.round(outputs[0]);
+	if (res1>numreq) res1=numreq;
+	if (res1>instore) res1=instore;
+	if (res1<0) res1=0;
+	carry=sigmoid0(outputs[2]);
+	return [res1,sigmoid0(outputs[1]),carry];
+}
+
+//TICK - Updates values for item X, should be called once for each item for each round of all slaves requesting that item
+//Instore - number of items for item X in master gauge (currently)
+//dole - Current dole for item X
+//store_last_tick - Number of items for item X in master gauge at time of last tick (not this one)
+//* doleinfo_last - Object with 2 values for last "tick period": numreq - total number or requests for item, numslave - number of slaves requesting that item
+//* doleinfo_new - Object with 2 values for new "tick period": numreq - total number or requests for item, numslave - number of slaves requesting that item
+
+
+//Returns: Array of 2 elements
+//0.New dole for item X
+//1.Guessed percentage average of items supplied in last 10 ticks
+function Tick(instore,dole,store_last_tick,numreq_total_adj)
+{
+	var instore_adj=instore;
+	if (instore_adj==0) instore_adj=0.1;
+	var inputs=[instore,dole,store_last_tick/instore_adj,store_last_tick/numreq_total_adj];
+	var internal=[0,0,0,0,0];
+	var outputs=[0,0];
+	//NN: Please don't touch :), code is generated
+	
+internal[2]=sigmoid0(internal[2]);
+outputs[0]=internal[2]*0.4049594998;
+outputs[0]=outputs[0]+1.0*-5.026565075;
+outputs[0]=outputs[0]+inputs[0]*0.9100194573;
+outputs[0]=outputs[0]+inputs[1]*-1.063795686;
+outputs[0]=sigmoid1(outputs[0]);
+outputs[1]=outputs[0]*1.049500823;
+outputs[1]=outputs[1]*inputs[0]*3.437163115;
+outputs[1]=sigmoid0(outputs[1]);
+
+
+
+	avg=outputs[1];
+	if (numreq_total_adj<0.11) avg=1;//When no item's are requested, result is 0.1 ; In that case there is no deficit, so return 1 = 100% demand fulfilled
+	if (avg>1) avg=1;
+	if (avg<0) avg=0;
+	
+	return [sigmoid0(outputs[0]),avg];
+}
+
+module.exports = {Dose,Tick}

lib/generateSSLcert.js

@@ -0,0 +1,49 @@
+var forge = require("node-forge");
+forge.options.usePureJavaScript = true;
+var fs = require("fs");
+var mkdirp = require("mkdirp");
+
+var pki = forge.pki;
+var rsa = forge.pki.rsa;
+var startTime, endTime;
+
+
+
+module.exports = function({
+	bits = 2048,
+	certificatePath = "database/certificate",
+	doLogging = false,
+} = {}){
+	function log(t){
+		if(doLogging) console.log("lib/generateSSLcert.js | "+t);
+	}
+	log("Generating SSL certificate with "+bits+" bits at "+certificatePath);
+
+	startTime = Date.now();
+	var keypair = rsa.generateKeyPair({bits: bits, e: 0x10001});
+	endTime = Date.now();
+	log("Generated 2048bit keypair in: "+(endTime-startTime)+" ms");
+
+	startTime = Date.now();
+	var cert = pki.createCertificate();
+	cert.publicKey = keypair.publicKey;
+	cert.serialNumber = "01";
+
+	cert.validity.notBefore = new Date();
+	cert.validity.notAfter = new Date(Date.now()+(1000*60*60*24*365)); // valid for one year
+
+	// self-sign certificate
+	cert.sign(keypair.privateKey);
+
+	// Convert certificate to pem type and write it to a file
+	if(certificatePath[certificatePath.length-1] != "/") certificatePath += "/";
+	if(!fs.existsSync(certificatePath)) {
+		mkdirp.sync(certificatePath);
+		console.log("Created directory: "+certificatePath);
+	}
+	fs.writeFileSync(certificatePath+ "cert.key", pki.privateKeyToPem(keypair.privateKey));
+	fs.writeFileSync(certificatePath+ "cert.crt", pki.certificateToPem(cert));
+
+	endTime = Date.now();
+	log("Generated certificate in: "+(endTime-startTime)+" ms");
+}

lib/generateSSLcert.spec.js

@@ -0,0 +1,25 @@
+var assert = require("assert");
+var fs = require("fs");
+
+var fileOps = require("_app/fileOps");
+var generateSSLcert = require("./generateSSLcert.js")
+
+describe("generateSSLcert.js(options)", ()=>{
+	it("Creates a folder with a .crt and .key file in it", ()=>{
+		let certPath = "lib/certTestPlsDelete";
+		assert(!fs.existsSync(certPath)); // if it already exsits, the test might pass because of leftover data (which is bad)
+		
+		generateSSLcert({
+			// bits:512, // supported, but I just use the default of 2048 for this test
+			certificatePath:certPath,
+			doLogging: false,
+		});
+		
+		assert(fs.existsSync(certPath));
+		assert(fs.existsSync(certPath+"/cert.key")); // private key
+		assert(fs.existsSync(certPath+"/cert.crt")); // certificate file
+		
+		// remove certificates and data from the test
+		fileOps.deleteFolderRecursiveSync(certPath);
+	}).timeout(10000);
+});

lib/getFactorioLocale.js

@@ -0,0 +1,53 @@
+/**
+Module for grabbing factorio locale from a local factorio install
+@module getFactorioLocale
+*/
+
+const fs = require("fs");
+const ini = require("ini");
+
+const cache = {};
+
+/**
+Gets raw factorio locale from the .ini file.
+Not available outside of module through exports.
+
+@memberof getFactorioLocale
+@inner
+@param {string} factorioDirectory
+@param {string} languageCode
+@param {function} callback
+*/
+function getLocale(factorioDirectory, languageCode, callback){
+	var localeFile = factorioDirectory + '/data/base/locale/' + languageCode + '/base.cfg';
+	fs.readFile(localeFile, "utf8", (err, rawLocale) => {
+		callback(err, rawLocale);
+	});
+}
+
+/**
+Gets factorios locale as an object, does not respect mods.
+
+@param {string} factorioDirectory
+@param {string} languageCode
+@param {function} callback
+*/
+module.exports.asObject = function getLocaleAsObject(factorioDirectory, languageCode, callback){
+	if(typeof factorioDirectory != "string" || typeof languageCode != "string" || typeof callback != "function"){
+		throw new Error("Error: wrong parameters provided");
+	}
+	
+	if(!cache[languageCode]){
+		getLocale(factorioDirectory, languageCode, (err, rawLocale) => {
+			if(err){
+				callback(err);
+			} else {
+				let processedLocale = ini.parse(rawLocale);
+				cache[languageCode] = processedLocale;
+				callback(undefined, processedLocale);
+			}
+		});
+	} else {
+		callback(undefined, cache[languageCode]);
+	}
+}

lib/getFactorioLocale.spec.js

@@ -0,0 +1,74 @@
+const assert = require("assert");
+const getFactorioLocale = require("./getFactorioLocale");
+
+describe("getFactorioLocale.js", () => {
+	describe("asObject()", () => {
+		it("requires 2 strings and a function as parameters", () => {
+			let validate = (err) => {
+				return err == "Error: wrong parameters provided"
+			}
+			let message = "getFactorioLocale is responding incorrectly to invalid arguments"
+			let callback = (err,object) => true;
+			
+			assert.throws(() => getFactorioLocale.asObject(), validate, message);
+			assert.throws(() => getFactorioLocale.asObject("hello", "I forgot my callback"), validate, message);
+			assert.throws(() => getFactorioLocale.asObject(undefined, undefined, callback), validate, message);
+			
+			// the proper way to do it
+			assert.doesNotThrow(() => getFactorioLocale.asObject("factorio_0.15.27", "en", callback), validate, message);
+		});
+		it("returns a nested object with base game locale information", (done) => {
+			getFactorioLocale.asObject("factorio", "en", callback);
+			
+			function callback(err, object){
+				assert.equal(typeof object, "object");
+				assert.equal(object["entity-name"]["fish"], "Fish");
+				assert.equal(object["entity-name"]["small-lamp"], "Lamp");
+				Object.keys(object).forEach(key => {
+					// first level of the nested object is always an object
+					assert.equal(typeof object[key], "object");
+					
+					Object.keys(object[key]).forEach(key2 => {
+						// second level of the nested object is always a string, nearly always truthy
+						if(key2 != "so-long-and-thanks-for-all-the-fish"){
+							assert.ok(object[key][key2]);
+							assert.equal(typeof object[key][key2], "string");
+						}
+					});
+				});
+				done();
+			}
+		});
+		it("has some duplicate keys", (done) => {
+			getFactorioLocale.asObject("factorio", "en", callback);
+			
+			function callback(err, object){
+				let arrayOfKeys = [];
+				// collect all keys in a single array
+				Object.keys(object).forEach(key => {
+					arrayOfKeys.push(key);
+					Object.keys(object[key]).forEach(key2 => {
+						arrayOfKeys.push(key2);
+					});
+				});
+				
+				// check for duplicates
+				let duplicateKeys = [];
+				let i = 0;
+				arrayOfKeys.forEach(key => {
+					let o = 0;
+					arrayOfKeys.forEach(key2 => {
+						if(i != o && key == key2){
+							duplicateKeys.push(key);
+						}
+						o++
+					});
+					i++;
+				});
+				// we got 704 but this is a very unexact number
+				assert(duplicateKeys.length > 10)
+				done();
+			}
+		});
+	});
+});

lib/getInstances.js

@@ -0,0 +1,17 @@
+const fileOps = require("_app/fileOps");
+// const config = require("./../config");
+
+module.exports = function(config) {
+	return {
+		sync: function(){
+			let instances;
+			try {
+				instances = fileOps.getDirectoriesSync(config.instanceDirectory);
+			} catch (e) {
+				// there are no instances created yet, probably missing the folder
+				instances = [];
+			}
+			return instances;
+		},
+	}
+}

lib/manager/configManager.js

@@ -0,0 +1,69 @@
+/**
+Provides tools for managing both masters and slaves config files.
+@module configManager
+*/
+// require modules
+const asTable = require("as-table").configure({delimiter: ' | '});
+const fs = require("fs");
+
+// internal requires
+var config = require("./../../config");
+const objectOps = require("./../objectOps.js");
+/**
+console.log()s each entry in the config
+
+@param {string} instance Either undefined, "shared" or the instance to show the config for.
+*/
+module.exports.displayConfig = function(instance){
+	console.log(asTable(this.getConfig(instance)));
+}
+module.exports.getConfig = async function(instance){
+	if(!instance || instance == "shared"){
+		let configArray = [];
+		Object.keys(config).forEach(key=>{
+			if(key != "__comment"){
+				if(typeof config[key] == "object"){
+					configArray.push({entry: key, value: JSON.stringify(config[key])});
+				} else configArray.push({entry: key, value: config[key]});
+			}
+		});
+		return configArray;
+	}
+}
+module.exports.editConfig = function(instance, entry, newValue){
+	if(!instance || instance == "shared"){
+		if(config[entry] && newValue){
+			if(objectOps.isJSON(newValue)){
+				config[entry] = JSON.parse(newValue);
+				console.log("Changed config entry "+entry+" from "+JSON.stringify(config[entry])+" to "+JSON.stringify(newValue));
+				// console.log("new config file:");
+				// console.log(JSON.stringify(config, null, "	"))
+				fs.writeFileSync("config.json", JSON.stringify(config, null, 4));
+				return {
+					ok:true,
+					msg:`Changed config entry ${entry} from Object to ${JSON.stringify(newValue)}`,
+				}
+			} else {
+				config[entry] = newValue;
+				console.log("Changed config entry "+entry+" from "+config[entry]+" to '"+newValue+"'");
+				// console.log("new config file:");
+				// console.log(JSON.stringify(config, null, "	"))
+				fs.writeFileSync("config.json", JSON.stringify(config, null, 4));
+				return {
+					ok:true,
+					msg:`Changed config entry ${entry} from ***** to '${newValue}'`,
+				};
+			}
+		} else {
+			return {
+				ok:false,
+				msg:`No such config parameter`,
+			}
+		}
+	} else {
+		return {
+			ok:false,
+			msg:`Editing config for single instances is not yet supported`,
+		}
+	}
+};

lib/manager/instanceManager.js

@@ -0,0 +1,2 @@
+const fs = require("fs-extra");
+const needle = require("needle");

lib/manager/modManager.js

@@ -0,0 +1,278 @@
+/**
+Provides tools to manage mods in a clusterio install
+@module modManager
+*/
+
+const rightpad = require("right-pad");
+const asTable = require("as-table").configure({delimiter: ' | '});
+const moment = require("moment");
+const syncRequest = require("sync-request");
+const fs = require("fs-extra");
+const https = require('follow-redirects').https;
+const factorioAPI = require("node-factorio-api");
+const sLog = require("single-line-log").stdout;
+const query = require('cli-interact').getYesNo;
+
+const fileOps = require("_app/fileOps");
+// const config = require("./../../config");
+
+
+function ellipse(str, max){
+   return str.length > (max - 3) ? str.substring(0,max-3) + '...' : str;
+}
+// https://stackoverflow.com/questions/15900485/correct-way-to-convert-size-in-bytes-to-kb-mb-gb-in-javascript
+function formatBytes(a,b){if(0==a)return"0 Bytes";var c=1024,d=b||2,e=["Bytes","KB","MB","GB","TB","PB","EB","ZB","YB"],f=Math.floor(Math.log(a)/Math.log(c));return parseFloat((a/Math.pow(c,f)).toFixed(d))+" "+e[f]};
+
+
+module.exports = function(config){
+	if(!config) config = require("./../../config");
+	const instances = require("./../getInstances.js")(config).sync();
+	return {
+		/**
+		Lists mods for an instance as a table. Warning, handles printing internally.
+		@param {string} instance - Name of the instance or "shared"
+
+		@example
+		var modManager = require("modManager")(config);
+		modManager.listMods("testInstance");
+		// console.logs table of mods installed on instance
+		modManager.listMods("shared");
+		// console.logs mods located in /sharedMods as a nice table
+		*/
+		listMods: function(instance){
+			return new Promise((resolve, reject) => {
+				if(instance && instances.includes(instance)){
+					factorioAPI.init(false, config.instanceDirectory+'/'+instance+'/instanceMods', config.instanceDirectory+'/'+instance+'/saves', config.factorio_version);
+					factorioAPI.authenticate({
+						username: config.username,
+						token: config.token,
+						require_ownership: false
+					}).then(token => {
+						console.log("* Currently installed:");
+						factorioAPI.readModZips().then(list => {
+							console.log(asTable(list.map(mod => {
+								return {
+									name:(mod.title || mod.name),
+									version:mod.version,
+									date:mod.date,
+									factorio_ver:mod.factorio_version,
+									author:mod.author,
+								}
+							})));
+						});
+						// Had issues earlier due to bug in node-factorio-api, see https://github.com/Danacus/node-factorio-api/issues/2
+						// bug is resolved, thanks to @Danacus and @brotherpot
+						factorioAPI.getModsFromSaves().then(list => {
+							console.log("* Mods used in save:");
+							console.log(asTable(list[0].mods))
+						});
+					}).catch(reason => {
+						console.log("Failed to authenticate to factorio.com! Please check your connection and the username+token used for authentication in config.json");
+						resolve();
+					});
+				} else {
+					// list shared mods in /sharedMods/
+					factorioAPI.init(false, 'sharedMods/', '', config.factorio_version);
+					factorioAPI.authenticate({
+						username: config.username,
+						token: config.token,
+						require_ownership: false
+					}).then(() => {
+						console.log("\r\n")
+						console.log("* Mods shared by all instances:")
+						factorioAPI.getInstalledMods().then(mods => {
+							console.log(asTable(mods));
+							resolve();
+						});
+					}).catch(e => {
+						reject(new Error(e));
+					});
+				}
+				
+				// get JSON data about GH releases
+				/*let res = syncRequest('GET', 'https://api.github.com/repos/Danielv123/factorioClusterioMod/releases', {"headers":{"User-Agent":"Fuck you for requiring user agents!"}});
+				let url = JSON.parse(res.getBody())[0].assets[0].browser_download_url;
+				let name = JSON.parse(res.getBody())[0].assets[0].name;
+				console.log(JSON.parse(res.getBody()))
+				*/
+			});
+		},
+		/**
+		Searches mods.factorio.com for mods matching a search term and prints
+		the results to console as a neat looking table
+
+		@param {string} searchTerm What to search for
+		*/
+		findMods: function(searchTerm){
+			return new Promise((resolve, reject) => {
+				factorioAPI.init(false);
+				factorioAPI.authenticate({
+					username: config.username,
+					token: config.token,
+					require_ownership: false
+				}).then(token => {
+					factorioAPI.searchMods(searchTerm).then(mods => {
+						let result = asTable(mods.reverse().map(mod => {
+							return {
+								title:ellipse(mod.title, 50),
+								name:ellipse(mod.name, 30),
+								downloads:mod.downloads_count,
+								updated: moment(mod.updated_at).format("DD.MM.YY"),
+								latest_version: mod.latest_release.version,
+								owner:mod.owner,
+								//license: mod.license_name,
+							}
+						}));
+						resolve(result);
+						// console.log(result);
+					});
+				}).catch(e => {
+					if(e.contains("Insufficient information")) console.log("We are missing some parameters required for logging in! Make sure your factorio username and token are specified in config.json.");
+					reject(new Error(e));
+				});
+			});
+		},
+		addMod: function(term, instance){
+			return new Promise((resolve, reject) => {
+				if(instance == "shared"){ // modDirectory has to end in /
+					var modDirectory = "sharedMods/";
+				} else {
+				var modDirectory = config.instanceDirectory+"/"+instance+"/instanceMods/";
+				}
+				if(term && term.length > 0){
+					if(term.includes("mods.factorio.com/mods/")){ // https://mods.factorio.com/mods/Danielv123/ChooChoo
+						// treat it as a link download
+						factorioAPI.init(false, modDirectory, "", config.factorio_version);
+						factorioAPI.authenticate({
+							username: config.username,
+							token: config.token,
+							require_ownership: false
+						}).then(() => {
+							factorioAPI.searchMods(term.split("/")[term.split("/").length-1]).then(body => {
+								console.log("Im gonna download: "+body[0].name + " in version: " + body[0].latest_release.version);
+								factorioAPI.downloadMod( {name: body[0].name, version: body[0].latest_release.version}).then(()=>{
+									console.log("Mod downloaded");
+									resolve();
+								});
+							});
+						});
+					} else if(term.includes("github.com")){ // https://github.com/Danielv123/factorioClusterioMod
+						// treat it as a github releases download
+						let apiURL = "https://api.github.com/repos/" + term.split("/")[3] + "/" + term.split("/")[4] + "/releases"; // https://api.github.com/repos/Danielv123/factorioClusterioMod/releases
+						
+						let res = syncRequest('GET', apiURL, {"headers":{"User-Agent":"Fuck you for requiring user agents!"}});
+						let url = JSON.parse(res.getBody())[0].assets[0].browser_download_url;
+						let name = JSON.parse(res.getBody())[0].assets[0].name;
+						if(url) {
+							console.log("Downloading " + url);
+							let file = fs.createWriteStream(modDirectory + name);
+							let bytesDownloaded = 0;
+							let downloadStartTime = Date.now();
+							https.get(url, function(response) {
+								let bytesToDownload = response.headers['content-length'];
+								response.pipe(file);
+								response.on("data", chunk => {
+									bytesDownloaded += chunk.length;
+									let downloadTimeElapsed = Date.now() - downloadStartTime;
+									let bytesPerSecond = bytesDownloaded / (downloadTimeElapsed/1000);
+									let timeToComplete = Math.floor((bytesToDownload - bytesDownloaded)/bytesPerSecond);
+									sLog("Downloading "+name+" "+(bytesDownloaded/bytesToDownload*100).toPrecision(3)+"% ("+formatBytes(bytesDownloaded)+" / "+formatBytes(bytesToDownload)+")\r\n"+
+									"about "+timeToComplete+" seconds remaining ("+formatBytes(bytesPerSecond)+"/s)");
+								}).on("end", x => {
+									sLog.clear();
+									console.log(" Downloaded in "+moment.utc(moment.duration(Date.now()-downloadStartTime).as('milliseconds')).format('mm:ss')); // because sLog.clear() doesn't seem to do the job of ending the line properly
+									resolve();
+								});
+							});
+						}
+					} else {
+						// treat it as a search and download the top result
+						factorioAPI.init(false, modDirectory, "", config.factorio_version);
+						factorioAPI.authenticate({
+							username: config.username,
+							token: config.token,
+							require_ownership: false
+						}).then(() => {
+							factorioAPI.searchMods(term).then(body => {
+								console.log(body)
+								console.log("Im gonna download: "+body[0].name + " in version: " + body[0].latest_release.version);
+								factorioAPI.downloadMod( {name: body[0].name, version: body[0].latest_release.version}).then(()=>{
+									console.log("Mod downloaded");
+									resolve();
+								});
+							});
+						});
+					}
+				} else {
+					reject(new Error("Invalid search term"));
+				}
+			});
+		},
+		removeMod: function removeMod(term, instance, force = false){
+			return new Promise((resolve, reject) => {
+				if(instance == "shared"){ // modDirectory has to end in /
+					var modDirectory = "sharedMods/";
+				} else {
+				var modDirectory = config.instanceDirectory+"/"+instance+"/instanceMods/";
+				}
+				if(term && typeof term == "string" && term.length > 0){
+					let mods = fs.readdirSync(modDirectory);
+					let modsMatchingFilter = mods.filter(mod => mod.toLowerCase().includes(term.toLowerCase()));
+					if(modsMatchingFilter.length < 1){
+						console.log("No mods found matching search");
+					} else if(modsMatchingFilter.length == 1){
+						console.log("Deleting "+modsMatchingFilter[0]);
+						fs.unlinkSync(modDirectory+modsMatchingFilter[0]);
+						console.log("Deleted.");
+					} else if(modsMatchingFilter.length > 1){
+						console.log("Found multiple mods");
+						modsMatchingFilter.forEach(mod => console.log(mod));
+						if(query("Delete all mods matching filter?")){
+							let modsToDelete = modsMatchingFilter.length;
+							for(let i = 0; i < modsToDelete; i++){
+								fs.unlinkSync(modDirectory+modsMatchingFilter[i]);
+								console.log("Deleted "+modsMatchingFilter[i]);
+							}
+						} else console.log("Did not delete mods.")
+					}
+					resolve();
+				} else {
+					reject(new Error("Invalid search term"));
+				}
+			});
+		},
+
+		// 'https://api.github.com/repos/Danielv123/factorioClusterioMod/releases'
+		/**
+		Download mod from github repo by looking for the first binary download in
+		the latest release, saving it to /sharedMods
+
+		@param {string} url a github repo  URL, for example https://api.github.com/repos/Danielv123/factorioClusterioMod/releases. Must link to /releases
+		*/
+		downloadFromGitURL: function(url){
+			console.log("Downloading mod from "+url);
+			// get JSON data about releases
+			let res = syncRequest('GET', url, {"headers":{"User-Agent":"Please don't require setting a user agent"}});
+			let downloadUrl = JSON.parse(res.getBody())[0].assets[0].browser_download_url;
+			let name = JSON.parse(res.getBody())[0].assets[0].name;
+			console.log(JSON.parse(res.getBody()))
+			if(downloadUrl) {
+				console.log(downloadUrl);
+				let file = fs.createWriteStream("sharedMods/"+name);
+				https.get(downloadUrl, function(response) {
+					response.pipe(file);
+					console.log("Downloaded "+name);
+				});
+			}
+		},
+	}
+}
+/*
+module.exports.findUpdates = function(){
+	console.log("Downloading mods...");
+	// get JSON data about releases
+	let res = syncRequest('GET', 'https://api.github.com/repos/Danielv123/factorioClusterioMod/releases', {"headers":{"User-Agent":"Fuck you for requiring user agents!"}});
+	let url = JSON.parse(res.getBody())[0].assets[0].browser_download_url;
+	let name = JSON.parse(res.getBody())[0].assets[0].name;
+	console.log(JSON.parse(res.getBody()))
+}*/

lib/manager/pluginManager.js

@@ -0,0 +1,116 @@
+const fs = require("fs-extra");
+const path = require("path");
+const git = require("simple-git")("./sharedPlugins");
+
+
+module.exports = function(config){
+	if(!config) config = require("./../../config");
+	
+	return {
+		listPlugins: async function(){
+			let plugins = await this.getPlugins();
+			plugins.forEach(plug => {
+				console.log(`${plug.name}`.padEnd(22).substr(0,22)+` - ${plug.description}`.substr(0,80-22));
+			});
+		},
+		getPlugins: async function(){
+			let directories = await fs.readdir("./sharedPlugins");
+			let returnArray = [];
+			for(let i in directories){
+				let dir = directories[i];
+				let pluginContents = await fs.readdir(path.join("./sharedPlugins", dir));
+				// console.log(pluginContents)
+				if(pluginContents.includes("config.js") || pluginContents.includes("config.json")){
+					try{
+						var pluginConfig = require(path.join("./../../sharedPlugins", dir, "config"));
+						pluginConfig.pluginPath = path.join("./sharedPlugins", dir);
+					}catch(e){
+						console.log(e)
+					}	
+					
+					// check if plugin is enabled
+					try{
+						await fs.stat(path.join(pluginConfig.pluginPath, "DISABLED"))
+						pluginConfig.enabled = false;
+					}catch(e){
+						pluginConfig.enabled = true;
+					}
+					returnArray.push(pluginConfig);
+				}
+			}
+			return returnArray;
+		},
+		addPlugin: function(path){
+			return new Promise((resolve, reject) => {
+				if(path.includes("git")){ // we are decently sure this is a git repo
+					git.clone(path, data => resolve(data))
+				}
+			});
+		},
+		removePlugin: async function(name){
+			let plugins = await this.getPlugins();
+			for(let i in plugins){
+				let plug = plugins[i];
+				if(plug.name.includes(name)){
+					// console.log(`Removing plugin ${plug.name}`);
+					await fs.remove(plug.pluginPath);
+					return {
+						ok:true,
+						msg:`Deleted plugin ${plug.name}`
+					}
+				}
+			}
+			return {
+				ok:false,
+				msg:`Plugin matching "${name}" not found`,
+			}
+		},
+		enablePlugin: async function(name, instance){
+			let plugins = await this.getPlugins();
+			let plugin = plugins[findInArray("name", name, plugins)[0]];
+			if(plugin){
+				let files = await fs.readdir(plugin.pluginPath);
+				if(files.includes("DISABLED")){
+					await fs.unlink(path.join(plugin.pluginPath, "DISABLED"));
+					return {
+						ok:true,
+						msg:`Globally enabled plugin ${name}`,
+					}
+				} else {
+					return {
+						ok:true,
+						msg:`Plugin ${name} already enabled`,
+					}
+				}
+			} else {
+				return {
+					ok:false,
+					msg:`Found no excact match for plugin ${name}`,
+				}
+			}
+		},
+		disablePlugin: async function(name, instance){
+			let plugins = await this.getPlugins();
+			let plugin = plugins[findInArray("name", name, plugins)[0]];
+			if(plugin){
+				await fs.writeFile(path.join(plugin.pluginPath, "DISABLED"), "");
+				return {
+					ok:true,
+					msg:`Plugin ${name} is now disabled on this host`,
+				}
+			} else {
+				return {
+					ok:false,
+					msg:`Found no excact match for plugin ${name}`,
+				}
+			}
+		}
+	}
+}
+function findInArray(key, value, array){
+	let indexes = [];
+	for(let i in array){
+		if(array[i][key] && array[i][key] === value) indexes.push(i);
+	}
+	return indexes;
+}

lib/npmPostinstall.js

@@ -0,0 +1,136 @@
+var mkdirp = require("mkdirp");
+var http = require('http');
+var https = require('https');
+var fs = require('fs');
+
+var modManager = require("./manager/modManager.js");
+
+// modManager.addMod("clusterio", "shared");
+
+function makeDirectory(path){
+	return new Promise((resolve, reject) => {
+		mkdirp(path, function(err){
+			if(err){
+				console.error("Unable to mkdirp "+path);
+				console.error(err);
+				resolve(false);
+			} else {
+				console.log("mkdirp "+path);
+				resolve(true);
+			}
+		});
+	});
+}
+function download(url, file, callback){
+	return new Promise((resolve, reject) => {
+		let pathArray = file.split("/");
+		pathArray.pop(); // remove filename from the end
+		if(pathArray.length >= 1){
+			// this might be an invalid path!
+			fs.stat(pathArray.join("/"), (err, stat) => {
+				if(err){
+					makeDirectory(pathArray.join("/")).then(()=>{
+						doDownload(url, file, callback);
+					});
+				} else {
+					doDownload(url, file, callback);
+				}
+			});
+		} else {
+			doDownload(url, file, callback);
+		}
+		function doDownload(url, file, callback){
+			var writeStream = fs.createWriteStream(file);
+			let protocol = http;
+			if(url.split(":")[0] == "https") protocol = https;
+			var request = protocol.get(url, function(response) {
+				response.pipe(writeStream);
+				response.on("end", () => {
+					if(callback && typeof callback == "function") callback(file);
+					console.log("Downloaded "+file+" from "+url);
+					resolve();
+				});
+			});
+		}
+	});
+}
+
+var directories = [
+	"database/linvodb",
+	"sharedMods",
+	"instances",
+];
+let downloadList = [
+	// {
+		// url: "http://fbpviewer.trakos.pl/images/spritesheet.json",
+		// file: "static/pictures/spritesheet.js",
+		// callback: function(file){
+			// fs.writeFileSync("static/pictures/spritesheet.js", "export default\n"+fs.readFileSync("static/pictures/spritesheet.js"));
+		// },
+	// },
+	// {
+		// url: "http://fbpviewer.trakos.pl/images/spritesheet.png",
+		// file: "static/pictures/spritesheet.png",
+	// },
+	{
+		url: "https://code.jquery.com/jquery.js",
+		file: "static/external/jquery.js",
+	},
+	{
+		url: "https://code.jquery.com/ui/1.12.1/jquery-ui.js",
+		file: "static/external/jquery-ui.js",
+	},
+	{
+		url: "https://cdnjs.cloudflare.com/ajax/libs/canvasjs/1.7.0/canvasjs.js",
+		file: "static/external/canvasjs.js",
+	},
+	{
+		url: "https://momentjs.com/downloads/moment.min.js",
+		file: "static/external/moment.min.js",
+	},
+	{
+		url: "https://craig.global.ssl.fastly.net/js/mousetrap/mousetrap.min.js",
+		file: "static/external/mousetrap.min.js",
+	},
+	{
+		url: "https://fonts.googleapis.com/css?family=Roboto",
+		file: "static/external/css/Roboto.css",
+	},
+	{
+		url: "https://cdnjs.cloudflare.com/ajax/libs/socket.io/2.0.4/socket.io.js",
+		file: "static/external/socket.io.js",
+	},
+]
+
+// initiate folder creations and downloads
+processMkdirRecursive(processDownloadRecursive);
+function processMkdirRecursive(callback){
+	let item = directories.shift();
+	makeDirectory(item).then(()=>{
+		if(directories.length == 0){
+			if(callback) callback();
+		} else {
+			processMkdirRecursive(callback);
+		}
+	});
+}
+function processDownloadRecursive(callback){
+	let item = downloadList.shift();
+	download(item.url, item.file, item.callback).then(()=>{
+		if(downloadList.length == 0){
+			if(callback) callback();
+		} else {
+			processDownloadRecursive(callback);
+		}
+	});
+}
+
+// generate SSL certificates if they are missing
+if(!fs.existsSync("database/certificates") || !fs.existsSync("database/certificates/cert.crt") || !fs.existsSync("database/certificates/cert.key")){
+	var generateSSLcert = require("./generateSSLcert.js");
+	
+	generateSSLcert({
+		certificatePath: "database/certificates",
+		doLogging: true,
+	});
+}

lib/objectOps.js

@@ -0,0 +1,44 @@
+/**
+Helper functions related to objects
+@module objectOps
+*/
+
+/**
+Deep clones an object, is actually just JSON.parse(JSON.stringify()) but looks cleaner.
+@param {object} obj to clone
+@returns {object}
+
+@example
+a = {"thingy":"with a value"};
+b = a;
+a == b; // true
+c = objectOps.deepclone(a);
+a == c; // false
+*/
+module.exports.deepclone = function(obj){
+	return JSON.parse(JSON.stringify(obj));
+}
+/**
+Checks if a string is valid JSON using try/catch. If passed an object it will always return true.
+@param {string} string to verify
+@returns {boolean}
+
+@example
+objectOps.isJSON("99 bottles of beer"); // false
+objectOps.isJSON("99"); // true
+objectOps.isJSON({"thingy":"that is an object"}); // true
+objectOps.isJSON(JSON.stringify({"thingy":"that is an object"})); // true
+*/
+module.exports.isJSON = function(string){
+	let stringIsJson = false;
+	let x
+	try {
+		x = JSON.parse(string);
+	} catch (e){
+		return false;
+	}
+	if(typeof x == "object" || typeof string == "object"){
+		stringIsJson = true;
+	}
+	return stringIsJson;
+}

lib/objectOps.spec.js

@@ -0,0 +1,40 @@
+var assert = require('assert');
+var objectOps = require('./objectOps');
+
+describe("objectOps.js", function(){
+	/*describe("objectOps.clone()", function(){
+		it("clones javascript objects", function(){
+			var object1 = {hello:"world", cat:{legs:4, name:"Kitty", colors:["brown", "yellow", "purple"]}};
+			var object2 = {};
+			object2 = objectOps.clone(object1);
+			
+			assert.equal(object2.cat.name, object1.cat.name)
+			assert.equal(object1.hello, object2.hello)
+		});	
+		it("does not deep clone objects", function(){
+			var obj1 = {hello:"world", cat:{legs:4, name:"Kitty", colors:["brown", "yellow", "purple"]}};
+			var obj2 = {};
+			obj2 = objectOps.clone(obj1);
+			
+			obj1.cat.colors = "black";
+			assert.equal(obj1.cat.colors, "black");
+			assert.notEqual(obj2.cat.colors[1], "yellow");
+		});
+	});*/
+	describe("objectOps.deepclone()", function(){
+		it("deep clones javascript objects", function(){
+			var obj1 = {hello:"world", cat:{legs:4, name:"Kitty", colors:["brown", "yellow", "purple"]}};
+			var obj2 = {};
+			obj2 = objectOps.deepclone(obj1);
+			
+			obj1.cat.colors = "black";
+			assert.equal(obj1.cat.colors, "black");
+			assert.equal(obj2.cat.colors[1], "yellow");
+		});
+		it("throws on non JSON parameters", function(){
+			assert.throws(function(){
+				let y = objectOps.deepclone(objectOps.deepclone);
+			});
+		});
+	});
+});

lib/scenarios/Hotpatch/control.lua

@@ -0,0 +1,153 @@
+--[[
+
+Copyright 2018 Chrisgbk
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+]]
+-- MIT License, https://opensource.org/licenses/MIT
+
+-- Hotpatchable control.lua for scenarios
+-- Supports multiple simultaneously loaded softmods
+-- This is a WIP
+-- Version 1.1 alpha
+-- probably some performance improvements to be made
+
+_ENV.debug_settings = {
+    level = 'info',
+    log_to_console_only = false,
+    log_to_RCON = false,
+    log_on_tick = false,
+}
+
+local hotpatch_tools = require 'hotpatch.mod-tools'
+require 'hotpatch.remote-interface'
+require 'hotpatch.commands'
+require 'hotpatch.gui'
+
+-- mod code goes here
+
+-- This is the Factorio Freeplay scenario
+-- This code, and the freeplay locale files in the zip file, is the property of Wube
+-- As this is part of the base mod, the developers have given permission for modders to use/adapt the assets therein, for modding Factorio
+-- Any other use would require licensing/permission from Wube
+-- If you don't want to run this, either comment this out before creating your scenario, OR uninstall freeplay at runtime
+hotpatch_tools.static_mod('freeplay', '1.0.0', [===[
+local util = require("util")
+local silo_script = require("silo-script")
+
+local created_items = function()
+  return
+  {
+    ["iron-plate"] = 8,
+    ["wood"] = 1,
+    ["pistol"] = 1,
+    ["firearm-magazine"] = 10,
+    ["burner-mining-drill"] = 1,
+    ["stone-furnace"] = 1
+  }
+end
+
+local respawn_items = function()
+  return
+  {
+    ["pistol"] = 1,
+    ["firearm-magazine"] = 10
+  }
+end
+
+for k,v in pairs(silo_script.get_events()) do
+  script.on_event(k, v)
+end
+
+script.on_event(defines.events.on_player_created, function(event)
+  local player = game.players[event.player_index]
+  util.insert_safe(player, global.created_items)
+
+  local r = global.chart_distance or 200
+  player.force.chart(player.surface, {{player.position.x - r, player.position.y - r}, {player.position.x + r, player.position.y + r}})
+
+  if not global.skip_intro then
+    if game.is_multiplayer() then
+      player.print({"msg-intro"})
+    else
+      game.show_message_dialog{text = {"msg-intro"}}
+    end
+  end
+
+  silo_script.on_event(event)
+end)
+
+script.on_event(defines.events.on_player_respawned, function(event)
+  local player = game.players[event.player_index]
+  util.insert_safe(player, global.respawn_items)
+  silo_script.on_event(event)
+end)
+
+script.on_configuration_changed(function(event)
+  global.created_items = global.created_items or created_items()
+  global.respawn_items = global.respawn_items or respawn_items()
+  silo_script.on_configuration_changed(event)
+end)
+
+script.on_load(function()
+  silo_script.on_load()
+end)
+
+script.on_init(function()
+  global.created_items = created_items()
+  global.respawn_items = respawn_items()
+  silo_script.on_init()
+end)
+
+silo_script.add_remote_interface()
+silo_script.add_commands()
+
+remote.add_interface("freeplay",
+{
+  get_created_items = function()
+    return global.created_items
+  end,
+  set_created_items = function(map)
+    global.created_items = map
+  end,
+  get_respawn_items = function()
+    return global.respawn_items
+  end,
+  set_respawn_items = function(map)
+    global.respawn_items = map
+  end,
+  set_skip_intro = function(bool)
+    global.skip_intro = bool
+  end,
+  set_chart_distance = function(value)
+    global.chart_distance = tonumber(value)
+  end
+})
+]===])
+
+-- Multi-file test
+--[[
+local files = {}
+
+files['testfolder.anothertest.test'] = [===[
+    script.on_event(defines.events.on_player_changed_position, function(e) game.print('position changed') end)
+]===]
+
+files['testfolder.test'] = [===[
+    require 'anothertest.test'
+]===]
+
+files['test'] = [===[
+    require 'testfolder.test'
+]===]
+
+hotpatch_tools.static_mod('require-test', '1.0.0', [===[
+    require 'test'
+]===], files)
+--]]
+
+-- end of mod code

lib/scenarios/Hotpatch/hotpatch/commands.lua

@@ -0,0 +1,135 @@
+local hotpatch_tools = require 'hotpatch.mod-tools'
+hotpatch_tools.static_mod('hotpatch-commands', '1.0.1', [===[
+--[[
+
+Copyright 2018 Chrisgbk
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+]]
+-- MIT License, https://opensource.org/licenses/MIT
+
+local hotpatch_tools = require 'hotpatch.mod-tools'
+
+--load private API
+-- mod installation/uninstallation support functions
+-- These take a mod NAME as a first argument
+local install_mod = hotpatch_tools.install_mod
+local find_installed_mod = hotpatch_tools.find_installed_mod
+local install_mod_file = hotpatch_tools.install_mod_file
+local uninstall_mod = hotpatch_tools.uninstall_mod
+
+-- mod interaction functions
+-- These take a LOADED INDEX as a first argument, except load_mod, which takes an INSTALLED INDEX
+local load_mod = hotpatch_tools.load_mod
+local find_loaded_mod = hotpatch_tools.find_loaded_mod
+local run_mod = hotpatch_tools.run_mod
+local reset_mod = hotpatch_tools.reset_mod
+local reset_mod_events = hotpatch_tools.reset_mod_events
+local register_mod_events = hotpatch_tools.register_mod_events
+local unload_mod = hotpatch_tools.unload_mod
+
+-- internal callbacks when a mod registers events
+local register_event = hotpatch_tools.register_event
+local register_nth_tick = hotpatch_tools.register_nth_tick
+local register_on_tick = hotpatch_tools.register_on_tick
+
+-- mod bootstrap functions
+-- These take a LOADED INDEX as a first argument
+local mod_on_init = hotpatch_tools.mod_on_init
+local mod_on_load = hotpatch_tools.mod_on_load
+local mod_on_configuration_changed = hotpatch_tools.mod_on_configuration_changed
+
+local static_mods = hotpatch_tools.static_mods
+local console = hotpatch_tools.console
+local debug_log = hotpatch_tools.debug_log
+local loaded_mods = hotpatch_tools.loaded_mods
+local installed_mods = hotpatch_tools.installed_mods
+
+local help_commands = {
+    help = '/hotpatch help\nYou got this far, you probably know all you need to know',
+    list = '/hotpatch list [type]\nLists \'installed\', \'loaded\' or \'running\' mods',
+}
+
+local sub_commands
+sub_commands = {
+    help = function(player_index, param)
+        local caller = (player_index and game.players[player_index]) or console
+        if (not param) or (param == '') then
+            caller.print('Usage: /hotpatch [command] [parameters]')
+            caller.print('Available commands:')
+            for k, _ in pairs(sub_commands) do caller.print(k) end
+            caller.print('Use /hotpatch help [command] for help on a particular command')
+        else
+            local text = help_commands[param]
+            if text then
+                caller.print(text)
+            end
+        end
+    end,
+    list = function(player_index, param)
+        local caller = (player_index and game.players[player_index]) or console
+        if not param or (param == '') then
+            caller.print('Installed mods:')
+            for k, v in pairs(installed_mods) do
+                caller.print(table.concat{'[', k, '] ', v.name, ' ', v.version})
+            end
+            caller.print('Loaded/Running mods:')
+            for k, v in pairs(loaded_mods) do
+                caller.print(table.concat{'[', k, '] ', v.name, ' ', v.version, ' ', (v.loaded and 'loaded') or 'not loaded', ' ', (v.running and 'running') or 'not running'})
+            end
+        else
+
+        end
+    end,
+}
+
+local admin_commands = {
+    reinstall = function(player_index, param)
+        local caller = (player_index and game.players[player_index]) or console
+        local mod
+        local installed_index
+        local loaded_index
+        for i = 1, #static_mods do
+            mod = static_mods[i]
+            if mod.name:match('^hotpatch%-.*$') then
+                loaded_index = find_loaded_mod(mod.name)
+                if loaded_index then
+                    unload_mod(loaded_index)
+                end
+                install_mod(mod.name, mod.version, mod.code, mod.files)
+                installed_index = find_installed_mod(mod.name)
+                load_mod(installed_index)
+                loaded_index = find_loaded_mod(mod.name)
+                run_mod(loaded_index)
+                mod_on_init(loaded_index)
+            end
+        end
+    end,
+}
+
+_ENV.commands.add_command('hotpatch', 'Commands for hotpatch. Run /hotpatch help for details.', function(e)
+    local caller = (e.player_index and game.players[e.player_index]) or console
+    if (not e.parameter) or (e.parameter == '') then
+        sub_commands['help'](e.player_index)
+        return
+    end
+    local sub_command, rest = e.parameter:match('(.-)%s(.*)')
+    if not sub_command then
+        sub_command = e.parameter
+    end
+
+    local f = sub_commands[sub_command]
+    if f then f(e.player_index, rest) end
+    if caller.admin then
+        f = admin_commands[sub_command]
+        if f then f(e.player_index, rest) end
+    end
+end)
+
+--]===])
+
+return true

lib/scenarios/Hotpatch/hotpatch/gui.lua

@@ -0,0 +1,377 @@
+local hotpatch_tools = require 'hotpatch.mod-tools'
+hotpatch_tools.static_mod('hotpatch-gui', '1.0.4', [===[
+--[[
+
+Copyright 2018 Chrisgbk
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+]]
+-- MIT License, https://opensource.org/licenses/MIT
+
+local hotpatch_tools = require 'hotpatch.mod-tools'
+local mod_gui = require 'mod-gui'
+
+--load private API
+-- mod installation/uninstallation support functions
+-- These take a mod NAME as a first argument
+local install_mod = hotpatch_tools.install_mod
+local find_installed_mod = hotpatch_tools.find_installed_mod
+local install_mod_file = hotpatch_tools.install_mod_file
+local uninstall_mod = hotpatch_tools.uninstall_mod
+
+-- mod interaction functions
+-- These take a LOADED INDEX as a first argument, except load_mod, which takes an INSTALLED INDEX
+local load_mod = hotpatch_tools.load_mod
+local find_loaded_mod = hotpatch_tools.find_loaded_mod
+local run_mod = hotpatch_tools.run_mod
+local reset_mod = hotpatch_tools.reset_mod
+local reset_mod_events = hotpatch_tools.reset_mod_events
+local register_mod_events = hotpatch_tools.register_mod_events
+local unload_mod = hotpatch_tools.unload_mod
+
+-- internal callbacks when a mod registers events
+local register_event = hotpatch_tools.register_event
+local register_nth_tick = hotpatch_tools.register_nth_tick
+local register_on_tick = hotpatch_tools.register_on_tick
+
+-- mod bootstrap functions
+-- These take a LOADED INDEX as a first argument
+local mod_on_init = hotpatch_tools.mod_on_init
+local mod_on_load = hotpatch_tools.mod_on_load
+local mod_on_configuration_changed = hotpatch_tools.mod_on_configuration_changed
+
+local static_mods = hotpatch_tools.static_mods
+local console = hotpatch_tools.console
+local debug_log = hotpatch_tools.debug_log
+local loaded_mods = hotpatch_tools.loaded_mods
+local installed_mods = hotpatch_tools.installed_mods
+
+script.on_event(defines.events.on_player_joined_game, function(e)
+    local player = game.players[e.player_index]
+    local top = mod_gui.get_button_flow(player)
+    local left = mod_gui.get_frame_flow(player)
+    local center = player.gui.center
+
+    local button = top['hotpatch-button']
+    if button then
+        button.destroy()
+    end
+    local menu = left['hotpatch-menu']
+    if menu then
+        menu.destroy()
+    end
+
+    local IDE = center['hotpatch-IDE']
+    if IDE then
+        IDE.destroy()
+    end
+
+    local main = center['hotpatch-main']
+    if main then
+        main.destroy()
+    end
+
+    button = top.add{type = 'sprite-button', name = 'hotpatch-button', sprite='utility/heat_exchange_indication', tooltip = 'Hotpatch', style = mod_gui.button_style}
+end)
+
+local on_gui_click_handlers
+local on_gui_selection_state_changed_handlers
+
+on_gui_click_handlers = {
+    ['hotpatch-button'] = function(e)
+        --on_gui_click_handlers['hotpatch-menu.IDE'](e)
+        --do return end
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local menu = left['hotpatch-menu']
+        if not menu then
+            menu = left.add{type = 'frame', name = 'hotpatch-menu', direction = 'vertical'}
+            menu.add{type = 'button', name = 'hotpatch-menu.IDE', caption = 'Mod IDE', tooltip = 'Open debugging GUI'}
+            menu.add{type = 'button', name = 'hotpatch-menu.console', caption = 'Mod Console', tooltip = 'Open debugging console'}
+            menu.visible = true
+            return
+        end
+        menu.visible = not menu.visible
+    end,
+    ['hotpatch-menu'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local menu = left['hotpatch-menu']
+        menu.visible = not menu.visible
+
+        on_gui_click_handlers[e.element.name](e)
+    end,
+    ['hotpatch-menu.IDE'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local IDE = center['hotpatch-IDE']
+        if not IDE then
+            IDE = center.add{type = 'frame', name = 'hotpatch-IDE', direction = 'vertical', caption = 'Hotpatch IDE', style = mod_gui.frame_style}
+            local top_flow = IDE.add{type = 'flow', name = 'hotpatch-IDE-top', direction = 'horizontal'}
+            top_flow.add{type = 'label', name = 'hotpatch-IDE-mod-label', caption = 'Mod: '}
+            local IDE_dropdown = top_flow.add{type = 'drop-down', name = 'hotpatch-IDE-mod-selector'}
+            top_flow.add{type = 'label', name = 'hotpatch-IDE-mod-version', caption = 'Version: No mod selected'}
+            local IDE_table = IDE.add{type = 'table', name = 'hotpatch-IDE-table', column_count = 2}
+            local files = IDE_table.add{type = 'scroll-pane', name = 'hotpatch-IDE-files', direction='vertical'}
+            files.style.height = 600
+            files.vertical_scroll_policy = 'always'
+            files = files.add{type = 'table', name = 'hotpatch-IDE-files-table', column_count = 1}
+            local code = IDE_table.add{type = 'text-box', name = 'hotpatch-IDE-code'}
+            code.word_wrap = true
+            files.style.width = 400
+            files.style.cell_padding = 0
+            files.style.top_padding = 0
+            files.style.bottom_padding = 0
+            code.style.width = 600
+            code.style.height = 600
+            IDE.visible = false
+        end
+
+        local IDE_dropdown = IDE['hotpatch-IDE-top']['hotpatch-IDE-mod-selector']
+        IDE_dropdown.clear_items()
+        for _, v in ipairs(installed_mods) do
+            IDE_dropdown.add_item(v.name)
+        end
+
+        IDE.visible = not IDE.visible
+        if IDE.visible then
+            player.opened = IDE
+        else
+            player.opened = nil
+        end
+    end,
+    ['hotpatch-menu.console'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local hotpatch_console = center['hotpatch-console']
+        if not hotpatch_console then
+            hotpatch_console = center.add{type = 'frame', name = 'hotpatch-console', direction = 'vertical', caption = 'Hotpatch Console'}
+            local top_flow = hotpatch_console.add{type = 'flow', name = 'hotpatch-console-top', direction = 'horizontal'}
+            top_flow.add{type = 'label', name = 'hotpatch-console-mod-label', caption = 'Mod: '}
+            local console_dropdown = top_flow.add{type = 'drop-down', name = 'hotpatch-console-mod-selector'}
+            top_flow.add{type = 'label', name = 'hotpatch-console-mod-version', caption = 'Version: No mod selected'}
+            local bottom_flow = hotpatch_console.add{type = 'flow', name = 'hotpatch-console-bottom', direction = 'vertical'}
+            local output = bottom_flow.add{type = 'text-box', name = 'hotpatch-console-output'}
+            local bottom_input_flow = bottom_flow.add{type = 'flow', name = 'hotpatch-console-bottom-input', direction = 'horizontal'}
+            local input = bottom_input_flow.add{type = 'textfield', name = 'hotpatch-console-input'}
+            bottom_input_flow.add{type = 'button', name = 'hotpatch-console-run', caption = 'Run', tooltip = 'Run Lua Code'}
+            output.style.width = 800
+            output.style.height = 600
+            input.style.width = 600
+			hotpatch_console.visible = false
+        end
+
+        local console_dropdown = hotpatch_console['hotpatch-console-top']['hotpatch-console-mod-selector']
+        console_dropdown.clear_items()
+        for _, v in ipairs(loaded_mods) do
+            console_dropdown.add_item(v.name)
+        end
+
+        hotpatch_console.visible = not hotpatch_console.visible
+        if hotpatch_console.visible then
+            player.opened = hotpatch_console
+        else
+            player.opened = nil
+        end
+    end,
+    ['hotpatch-console-run'] = function(e)
+        local player = game.players[e.player_index]
+
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local hotpatch_console = center['hotpatch-console']
+        local output = hotpatch_console['hotpatch-console-bottom']['hotpatch-console-output']
+        local input = hotpatch_console['hotpatch-console-bottom']['hotpatch-console-bottom-input']['hotpatch-console-input']
+        local console_dropdown = hotpatch_console['hotpatch-console-top']['hotpatch-console-mod-selector']
+
+        if not player.admin then
+            output.text = table.concat{output.text, '\n', 'Only admins!'}
+            return
+        end
+
+        if not (console_dropdown.selected_index > 0) then
+            output.text = table.concat{output.text, '\n', 'Select a mod!'}
+            return
+        end
+
+        local mod_name = console_dropdown.items[console_dropdown.selected_index]
+        local loaded_index = find_loaded_mod(mod_name)
+        local env = loaded_mods[loaded_index].env
+        local old_print = env.print
+        local old_log = env.log
+
+
+
+
+
+        env.print = function(...)
+            --local count = select('#', ...)
+            local t = table.pack(...)
+            for k, v in pairs(t) do
+                t[k] = tostring(v)
+            end
+            local text = table.concat(t, '\t')
+            output.text = table.concat{output.text, '\n', text}
+        end
+
+        env.log = function(text)
+            output.text = table.concat{output.text, '\n', text}
+        end
+
+        local success
+        local code, err = load(input.text, input.text, 't', env)
+        if code then
+            success, err = pcall(code)
+            if not success then
+                output.text = table.concat{output.text, '\n', err}
+            end
+        else
+            output.text = table.concat{output.text, '\n', err}
+        end
+
+        env.print = old_print
+        env.log = old_log
+    end,
+    ['hotpatch-IDE-file'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local element = e.element
+        local previous
+        for _, v in pairs(center['hotpatch-IDE']['hotpatch-IDE-table']['hotpatch-IDE-files']['hotpatch-IDE-files-table'].children) do
+            if table.compare(v.style.font_color or {}, {r=1.0, g=1.0, b=0.0, a=1.0}) then
+                previous = v
+                break
+            end
+        end
+        if previous then
+            previous.style.font_color = {r=1.0, g=1.0, b=1.0, a=1.0}
+        end
+        element.style.font_color = {r=1.0, g=1.0, b=0.0, a=1.0}
+        local file = element.name:match('.-%.(.*)')
+        local selected = center['hotpatch-IDE']['hotpatch-IDE-top']['hotpatch-IDE-mod-selector']
+        local mod_name = selected.items[selected.selected_index]
+        local code = center['hotpatch-IDE']['hotpatch-IDE-table']['hotpatch-IDE-code']
+        local index = find_installed_mod(mod_name)
+        if index then
+            local mod = installed_mods[index]
+            if file == 'control' then
+                code.text = mod.code
+            else
+                code.text = mod.files[file]
+            end
+        end
+    end,
+}
+
+script.on_event(defines.events.on_gui_click, function(e)
+    local element = e.element
+    if element.valid then
+        local name = element.name:match('([^%.]*)%.?.-')
+        local handler = on_gui_click_handlers[name]
+        if handler then handler(e) end
+    end
+end)
+
+on_gui_selection_state_changed_handlers = {
+    ['hotpatch-console-mod-selector'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local element = e.element
+        local name = element.items[element.selected_index]
+        if name then
+            local index = find_loaded_mod(name)
+            if index then
+                local mod = loaded_mods[index]
+                local version_label = center['hotpatch-console']['hotpatch-console-top']['hotpatch-console-mod-version']
+                version_label.caption = 'Version: ' .. mod.version
+                local hotpatch_console = center['hotpatch-console']
+                local output = hotpatch_console['hotpatch-console-bottom']['hotpatch-console-output']
+                output.text = ''
+            end
+        end
+    end,
+    ['hotpatch-IDE-mod-selector'] = function(e)
+        local player = game.players[e.player_index]
+        local top = mod_gui.get_button_flow(player)
+        local left = mod_gui.get_frame_flow(player)
+        local center = player.gui.center
+
+        local element = e.element
+
+        local name = element.items[element.selected_index]
+        if name then
+            local index = find_installed_mod(name)
+            if index then
+                local mod = installed_mods[index]
+                local version_label = center['hotpatch-IDE']['hotpatch-IDE-top']['hotpatch-IDE-mod-version']
+                version_label.caption = 'Version: ' .. mod.version
+                local list = center['hotpatch-IDE']['hotpatch-IDE-table']['hotpatch-IDE-files']['hotpatch-IDE-files-table']
+                list.clear()
+                local file = list.add{type = 'label', style = 'hoverable_bold_label', caption = 'control', name = 'hotpatch-IDE-file.control'}
+                file.style.bottom_padding = 0
+                file.style.top_padding = 0
+                for k, _ in pairs(mod.files) do
+                    file = list.add{type = 'label', style = 'hoverable_bold_label', caption = k, name = 'hotpatch-IDE-file.' .. k}
+                    file.style.bottom_padding = 0
+                    file.style.top_padding = 0
+                end
+                local code = center['hotpatch-IDE']['hotpatch-IDE-table']['hotpatch-IDE-code']
+                code.text = ''
+            end
+        end
+    end,
+}
+
+script.on_event(defines.events.on_gui_selection_state_changed, function(e)
+    local element = e.element
+    local handler = on_gui_selection_state_changed_handlers[element.name]
+    if handler then handler(e) end
+end)
+
+script.on_event(defines.events.on_gui_closed, function(e)
+    local player = game.players[e.player_index]
+    local element = e.element
+    if e.gui_type == defines.gui_type.custom then
+        if element and element.valid then
+            if element.name == 'hotpatch-IDE' then
+                if element.visible then
+                    player.play_sound{path = "utility/gui_click"}
+                end
+                element.visible = false
+            elseif element.name == 'hotpatch-console' then
+                if element.visible then
+                    player.play_sound{path = "utility/gui_click"}
+                end
+                element.visible = false
+            end
+        end
+    end
+end)
+
+--]===])
+
+return true

lib/scenarios/Hotpatch/hotpatch/remote-interface.lua

@@ -0,0 +1,322 @@
+local hotpatch_tools = require 'hotpatch.mod-tools'
+hotpatch_tools.static_mod('hotpatch-remote-interface', '1.0.2', [===[
+--[[
+
+Copyright 2018 Chrisgbk
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+]]
+-- MIT License, https://opensource.org/licenses/MIT
+
+local hotpatch_tools = require 'hotpatch.mod-tools'
+
+--load private API
+-- mod installation/uninstallation support functions
+-- These take a mod NAME as a first argument
+local install_mod = hotpatch_tools.install_mod
+local find_installed_mod = hotpatch_tools.find_installed_mod
+local install_mod_file = hotpatch_tools.install_mod_file
+local uninstall_mod = hotpatch_tools.uninstall_mod
+
+-- mod interaction functions
+-- These take a LOADED INDEX as a first argument, except load_mod, which takes an INSTALLED INDEX
+local load_mod = hotpatch_tools.load_mod
+local find_loaded_mod = hotpatch_tools.find_loaded_mod
+local run_mod = hotpatch_tools.run_mod
+local reset_mod = hotpatch_tools.reset_mod
+local reset_mod_events = hotpatch_tools.reset_mod_events
+local register_mod_events = hotpatch_tools.register_mod_events
+local unload_mod = hotpatch_tools.unload_mod
+
+-- internal callbacks when a mod registers events
+local register_event = hotpatch_tools.register_event
+local register_nth_tick = hotpatch_tools.register_nth_tick
+local register_on_tick = hotpatch_tools.register_on_tick
+
+-- mod bootstrap functions
+-- These take a LOADED INDEX as a first argument
+local mod_on_init = hotpatch_tools.mod_on_init
+local mod_on_load = hotpatch_tools.mod_on_load
+local mod_on_configuration_changed = hotpatch_tools.mod_on_configuration_changed
+
+local static_mods = hotpatch_tools.static_mods
+local console = hotpatch_tools.console
+local debug_log = hotpatch_tools.debug_log
+local loaded_mods = hotpatch_tools.loaded_mods
+local installed_mods = hotpatch_tools.installed_mods
+
+local remote_interface = {}
+
+--IMPORTANT: WHEN COPY PASTING CODE TO CONSOLE THE CODE MUST HAVE SINGLE LINE COMMENTS REMOVED
+-- FACTORIO CONSOLE STRIPS LINEFEEDS WHICH MAKES ALL THE CODE BECOME COMMENTED OUT
+--TODO: gate these behind admin permissions; if (game.player and game.player.admin) should work for console commands?
+
+debug_log({'hotpatch-info.remote-installing'})
+
+remote_interface['install'] = function(mod_name, mod_version, mod_code, mod_files, only_install)
+    -- this installs a new mod and runs on_init, then registers events
+    -- Note that mods may expect that certain events haven't been called yet when their on_init is ran
+    -- This may prevent them from functioning properly, without manually calling the events they expect
+    -- examples: on_player_created
+    local caller = game.player or console
+    if caller.admin then
+		if mod_files then
+			for k,_ in pairs(mod_files) do
+				if k == 'control' then
+					caller.print('ERROR: control.lua loaded twice for mod ' .. mod_name)
+					return
+				end
+			end
+		end
+        local installed_index = find_installed_mod(mod_name)
+        local loaded_index = find_loaded_mod(mod_name)
+        if installed_index then
+            local old_version = installed_mods[installed_index].version
+            if old_version then
+                debug_log({'hotpatch-warning.already-exists', mod_name, old_version})
+                debug_log({'hotpatch-warning.reinstalling', mod_name, old_version})
+            end
+            if loaded_index then
+                unload_mod(loaded_index)
+            end
+        end
+
+        install_mod(mod_name, mod_version, mod_code, mod_files)
+        if not only_install then
+            installed_index = find_installed_mod(mod_name)
+            if installed_index then
+                if not load_mod(installed_index) then
+                    caller.print('compilation failed for mod ' .. mod_name)
+                    return
+                end
+                loaded_index = find_loaded_mod(mod_name)
+                if loaded_index then
+                    if not run_mod(loaded_index) then
+                        caller.print('execution failed for mod ' .. mod_name)
+						unload_mod(loaded_index)
+                        return
+                    end
+                    if not mod_on_init(loaded_index) then
+                        caller.print('on_init failed for mod ' .. mod_name)
+						unload_mod(loaded_index)
+                        return
+                    end
+                    -- TODO: notify all mods
+                    -- TODO: determine vanilla behaviour and replicate it
+                    if not mod_on_configuration_changed(loaded_index, {mod_changes = {mod_name={new_version=mod_version}}}) then
+                        caller.print('on_configuration_changed failed for mod ' .. mod_name)
+						unload_mod(loaded_index)
+                        return
+                    end
+                else
+                end
+            else
+            end
+        end
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote_interface['run'] = function(mod_name)
+    -- this runs on_init, then registers events
+    -- Note that mods may expect that certain events haven't been called yet when their on_init is ran
+    -- This may prevent them from functioning properly, without manually calling the events they expect
+    -- examples: on_player_created
+    local caller = game.player or console
+    if caller.admin then
+        local installed_index = find_installed_mod(mod_name)
+        local loaded_index = find_loaded_mod(mod_name)
+		local mod
+        local version
+        if installed_index and not loaded_index then
+            if not load_mod(installed_index) then
+                caller.print('compilation failed for mod ' .. mod_name)
+                return
+            end
+            loaded_index = find_loaded_mod(mod_name)
+        else
+            if loaded_index then
+                mod = loaded_mods[loaded_index]
+                version = mod.version
+                debug_log({'hotpatch-warning.already-loaded', mod_name, version})
+                debug_log({'hotpatch-warning.reinitializing', mod_name, version})
+            end
+        end
+
+        if loaded_index then
+            if not run_mod(loaded_index) then
+                caller.print('execution failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+            if not mod_on_init(loaded_index) then
+                caller.print('on_init failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+            -- TODO: notify all mods
+            -- TODO: determine vanilla behaviour and replicate it
+            if not mod_on_configuration_changed(loaded_index, {mod_changes = {mod_name={new_version=version}}}) then
+                caller.print('on_configuration_changed failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+        end
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote_interface['update'] = function(mod_name, mod_version, mod_code, mod_files)
+    -- this updates an existing mod
+    -- the current mods events are de-registered, the new code is installed, on_load is triggered, and then events are registered
+    -- finally, the mod is informed of the update, so it can run migrations from the previous version
+    -- TODO: validation
+    local caller = game.player or console
+    if caller.admin then
+		if mod_files then
+			for k,_ in pairs(mod_files) do
+				if k == 'control' then
+					caller.print('ERROR: control.lua loaded twice for mod ' .. mod_name)
+					return
+				end
+			end
+		end
+        local installed_index = find_installed_mod(mod_name)
+		if installed_index then
+			;
+		end
+        local loaded_index = find_loaded_mod(mod_name)
+        local old_version
+        if loaded_index then
+            old_version = loaded_mods[loaded_index].version
+            unload_mod(loaded_index)
+        end
+        install_mod(mod_name, mod_version, mod_code, mod_files)
+        installed_index = find_installed_mod(mod_name)
+        if not load_mod(installed_index) then
+            caller.print('compilation failed for mod ' .. mod_name)
+            return
+        end
+        loaded_index = find_loaded_mod(mod_name)
+        if not run_mod(loaded_index) then
+            caller.print('execution failed for mod ' .. mod_name)
+			unload_mod(loaded_index)
+            return
+        end
+        if old_version then
+            if not mod_on_load(loaded_index) then
+                caller.print('on_load failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+            -- The mod must do any migrations here
+            -- TODO: notify all mods
+            if not mod_on_configuration_changed(loaded_index, {mod_changes = {mod_name={old_version=old_version, new_version=mod_version}}}) then
+                caller.print('on_configuration_changed failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+        else
+            -- first time install
+            if not mod_on_init(loaded_index) then
+                caller.print('on_init failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+            -- TODO: notify all mods
+            if not mod_on_configuration_changed(loaded_index, {mod_changes = {mod_name={new_version=mod_version}}}) then
+                caller.print('on_configuration_changed failed for mod ' .. mod_name)
+				unload_mod(loaded_index)
+                return
+            end
+        end
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote_interface['install_mod_file'] = function(mod_name, mod_file, mod_file_code)
+    local caller = game.player or console
+    if caller.admin then
+        install_mod_file(mod_name, mod_file, mod_file_code)
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote_interface['exec'] = function(mod_name, exec_code)
+    local caller = game.player or console
+    if caller.admin then
+		local loaded_index = find_loaded_mod(mod_name)
+		local env = loaded_mods[loaded_index].env
+		
+		local success
+		local code, err = load(exec_code, exec_code, 't', env)
+		if code then
+			success, err = pcall(code)
+			if not success then
+				debug_log(err)
+			end
+		else
+			debug_log(err)
+		end
+	else
+		caller.print('You must be an admin to run this command.')
+    end
+end
+
+--TODO: most of this function
+remote_interface['clean'] = function(mod_name)
+    -- Removes ALL mod data and reinitializes
+    -- doesn't remove things a mod may add like surfaces, etc
+    local caller = game.player or console
+    if caller.admin then
+        --mod_reset(mod_name)
+        --run_mod(mod_name)
+        --mod_on_init(mod_name)
+		local loaded_index = find_loaded_mod(mod_name)
+		local mod = loaded_mods[loaded_index]
+        local version = mod.version
+        mod_on_configuration_changed(loaded_index, {mod_changes = {mod_name={new_version=version}}})
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote_interface['uninstall'] = function(mod_name)
+    -- Uninstalls a mod
+    local caller = game.player or console
+    if caller.admin then
+        uninstall_mod(mod_name)
+    else
+        caller.print('You must be an admin to run this command.')
+    end
+end
+
+remote.add_interface('hotpatch', remote_interface)
+
+debug_log({'hotpatch-info.complete', {'hotpatch-info.remote-installing'}})
+
+--]===])
+
+--[[
+
+remote.call('hotpatch, 'install', 'test', '1.0.0', [===[
+script.on_event(defines.events.on_player_changed_position, function(e)
+    game.print('changed position')
+end
+]===]
+
+local updated_code = ....
+remote.call('hotpatch', 'update', 'test', '1.0.1', updated_code)
+
+
+]]
+
+return true

lib/scenarios/Hotpatch/locale/af/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Hierdie is Factorio vryspel. Jou taak is om 'n vuurpyl in die buitenste ruimte in te stuur. Doen dit deur die bou van 'n Vuurpyl Silo en van daar af 'n vuurpyl te lanseer met a satelliet aan boord. Jy sal baie gevorderde tegnologiëe moet navors om die Vuurpyl Silo te ontsluit. Begin klein, werk jou pad op met outomatisering en moenie vergeet om jouself te beskerm teen die inboorlinge nie.
+
+

lib/scenarios/Hotpatch/locale/ar/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=.نييلصألا ناكسلا نم كسفن ةيامح ىسنت الو ةياهنلا ىلإ لصتل كتقيرطب لمعأو ،رفصلا نم أدبتس .خيراوصلا عماوص حتف لجأ نم ةمدقتم ايجولونكت نع ثحبلل جاتحت فوس .ةيعانصلا رامقألاب خيراوصلا قالطإو خيراوصلا عماوص ءانب قيرط نع كلذب مايقلا عيطتست .ءاضفلل اخوراص قلطت نا يه كتمهم .Factorio ـل رحلا بعللا وه اذه
+
+

lib/scenarios/Hotpatch/locale/be/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Гэта рэжым свабоднай гульні Factorio. Вашая мэта - запусціць ракету ў космас. Дзеля гэтага вам трэба пабудаваць ракетную шахту і саму ракету з спадарожнікам. Вы мусіце даследваць перадавыя тэхналогіі, каб навучыцца будаваць ракетную шахту. Пачынайце з малога, працуйце над аўтаматызацыяй вытворчасці, даследуйце новыя тэхналогіі і не забывайцеся на абарону ад "тутэйшых"!
+
+

lib/scenarios/Hotpatch/locale/bg/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Това е режимът на свободна игра. Задачата ви е да изстреляте ракета в космоса. За това ще е нужно да построите ракетна шахта и изстреляте ракетата със спътник. Ще трябва да проучите развити технологии, които ще отключат ракетната шахта. Започнете с малко и постепенно автоматизирайте процеса, като не забравяте да се защитавате от местните форми на живот.
+
+

lib/scenarios/Hotpatch/locale/ca/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Aquest és el mode lliure del Factorio. La vostra tasca és construir un coet i enviar-lo a l'espai. Ho haureu de fer construint un centre de coets espacials i llençant un coet amb un satèl·lit. Necessitareu investigar tecnologies avançades per poder-ho fer. Aneu pas a pas, avanceu cap a l'automatització i no oblideu protegir-vos dels natius.
+
+

lib/scenarios/Hotpatch/locale/cs/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Toto je volná hra Factorio. Tvým úkolem je vypustit raketu do vesmíru. Postav raketové silo a vypusť raketu se satelitem. Pro odemknutí raketového sila budeš muset vyzkoumat pokročilé technologie. Začni v malém, postupuj s automatizací a nezapomeň se chránit před domorodci.
+
+

lib/scenarios/Hotpatch/locale/da/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Det her er Factorio fri leg. Din opgave er at affyre en raket for at udforske rummet. For at gøre det skal du bygge en raket silo og affyre en raket med en satellit i. Du bliver nød til at udforske avancerede teknologier for at at kunne bygge en raket silo. Start småt, og arbejd din vej op med hjælp af automatisering, glem ikke at beskytte dig fra de indfødte.
+
+

lib/scenarios/Hotpatch/locale/de/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Dies ist das freie Spiel von Factorio. Deine Aufgabe ist es, eine Rakete in den Weltraum zu starten. Dazu musst Du ein Raketensilo bauen und eine Rakete mit einem Satelliten starten. Du wirst erweiterte Technologien erforschen müssen, um das Raketensilo freizuschalten. Fange klein an, arbeite Dich durch Automatisierung hoch und vergiss nicht, Dich vor den Einheimischen zu schützen.
+
+

lib/scenarios/Hotpatch/locale/el/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Αυτό είναι το ελεύθερο παιχνίδι του Factorio. Ο στόχος σου είναι να εκτοξεύσεις έναν πύραυλο στο διάστημα. Αυτό το κάνεις κατασκευάζοντας ένα σιλό πυραύλου και εκτοξεύοντας έναν πυραύλο με δορυφόρο. Θα πρέπει να ερευνήσεις προηγμένες τεχνολογίες για να ξεκλειδώσεις το σιλό πυραύλου. Ξεκινάς περιορισμένος, δούλεψε με αυτοματισμούς για την άνοδο σου και μην ξεχνάς να προστατέψεις τον εαυτό σου από τους ντόπιους.
+
+

lib/scenarios/Hotpatch/locale/en/freeplay.cfg

@@ -0,0 +1,2 @@
+msg-intro=This is the Factorio freeplay. Your task is to launch a rocket into space. Do this by constructing a Rocket Silo and launching a rocket with a satellite. You will need to research advanced technologies in order to unlock the Rocket Silo. Start small, work your way up with automation and don't forget to protect yourself from the natives.
+

lib/scenarios/Hotpatch/locale/en/hotpatch.cfg

@@ -0,0 +1,81 @@
+[hotpatch]
+log=@__1__:__2__] __3__
+log-mod=@__1__:__2__][__4__] __3__
+severe=SEVERE ERROR: __1__
+error=ERROR: __1__
+warning=WARNING: __1__
+info=INFO: __1__
+verbose=INFO: __1__
+trace=TRACE: __1__
+
+[hotpatch-info]
+logging-enabled=Logging enabled
+metatable-installed=_ENV metatable installed
+complete=__1__ Complete!
+on-init=initializing...
+on-load=loading...
+on-configuration-changed=mod configuration changed...
+installing-included-mods=installing included mods...
+loading-installed-mods=loading installed mods...
+loading-libs=loading Factorio.data.core.lualib...
+loading-library=loading library: __1__
+uninstalling=Uninstalling mod...
+installing=Installing version __1__...
+installing-file=Installing file __1__...
+script-shim=setting up mod script shim...
+setting-env=setting up mod _ENV...
+loading=loading...
+unloading=unloading...
+running=running...
+must-be-admin=You must be an admin to run this command
+remote-installing=installing remote interface
+
+[hotpatch-trace]
+nil-var-access=_ENV nil variable access: __1__
+nil-var-assignment=_ENV variable assignment: __1__
+event-registering=registering events...
+on-tick-event-registered=registered on_tick event...
+on-event-registered=registered event __1__...
+on-nth-tick-event-registered=registered nth_tick event __1__...
+event-running=running event __1__...
+nth-tick-event-running=running nth_event __1__...
+mod-on-init=running on_init...
+mod-on-load=running on_load...
+mod-on-configuration-changed=running on_configuration_changed...
+adding-event=adding event __1__
+adding-nth-tick-event=adding nth_tick event __1__
+caching-event=caching event: __1__...
+caching-nth-tick-event=caching nth_tick event: __1__...
+event-processing=processing event __1__...
+nth-tick-event-processing=processing nth_tick event __1__...
+nth-tick-handler-added=added nth_tick handler: __1__
+nth-tick-handler-removed=removed nth_tick handler: __1__
+on-tick-handler-added=added on_tick handler
+on-tick-handler-removed=removed on_tick handler
+on-event-handler-added=added event handler: __1__
+on-event-handler-removed=removed event handler: __1__
+cached-load-require=loading cached require'd file: __1__...
+load-require=loading require'd file: __1__...
+load-core-lib=loading from Factorio.data.core.lualib: __1__...
+
+[hotpatch-warning]
+contains-comments=mod code contains comments!
+contains-comments-no-lf=mod contains comments and no linefeed!
+contains-comments-console=comments from console will comment out the entire code!
+reset-events-not-running=tried to reset events for mod that isn't running!
+remote-interface-exists=remote interface __1__ already exists, removing...
+command-exists=command __1__ already exists, removing...
+already-exists=mod already exists: __1__ __2__
+reinstalling=reinstalling mod in-place: __1__ __2__
+already-loaded=mod already loaded: __1__ __2__
+reinitializing=reinitializing: __1__ __2__
+
+[hotpatch-error]
+invalid-API-access=Invalid API access: __1__
+not-installed=mod not installed, cannot install file for mod that does not exist
+compilation-failed=compilation failed for mod
+execution-failed=execution failed for mod
+path-not-found=path '__1__' not found
+on-init-failed=on_init failed
+on-load-failed=on_load failed
+on-configuration-changed-failed=on_configuration_changed failed

lib/scenarios/Hotpatch/locale/eo/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Tio estas la Factorio Libera Ludado. Via tasko estas ĵeti raketon en spacon. Fari tiun per konstruanta Raketo Silo kaj ĵeti raketon kun satelito. Vi bezonos esplori altnivelaj teknologioj por malŝlosi la Raketo Silo. Start malgranda, labori vian vojon supren per aŭtomatigo kaj ne forgesu protekti vin mem de la indiĝenoj.
+
+

lib/scenarios/Hotpatch/locale/es-ES/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Este es el modo de juego libre de Factorio. Tu tarea es la de lanzar un cohete al espacio. Logra esto construyendo un Silo de Cohetes y lanzando un cohete con un satélite. Necesitarás investigar tecnologías avanzadas para poder desbloquear el Silo de Cohetes. Comienza poco a poco, trabaja en tu sistema de automatización y no te olvides de protegerte de los nativos.
+
+

lib/scenarios/Hotpatch/locale/et/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=See on Factorio vabamäng. Sinu eesmärgiks on saata rakett avakosmosesse. Seda saad teha ehitades Raketi Silotorni ja lennutades Raketti koos satelliidiga. Selleks pead õppima selgeks keerukad tehnoloogiaharud, et Raketi Silotorni lahti lukustada. Alusta väikselt ning liigu edasi automatiseerimise abil ja ära unusta ennast kaitsta kohalike eluvormide eest.
+
+

lib/scenarios/Hotpatch/locale/fi/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Tämä on Factorion vapaapelimuoto. Tavoitteesi on lähettää satelliitti ulkoavaruuteen rakentamalla rakettisiilo ja laukaisemalla raketti. Rakettisiilon voit rakentaa vasta, kun olet kehittänyt siihen tarvittavat huipputeknologiat. Aloita pienestä ja automatisoi kaikki tarvittava, äläkä unohda suojella itseäsi alkuasukkailta.
+
+

lib/scenarios/Hotpatch/locale/fr/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Il s'agit du mode de jeu libre de Factorio. Votre tâche consiste à lancer une fusée dans l'espace. Ceci en construisant un silo à fusée, et en lançant un satellite avec la fusée. Vous aurez besoin de rechercher des technologies de pointe afin de débloquer le silo. Commencez petit, évoluez en automatisant et n'oubliez pas de vous protéger contre les autochtones.
+
+

lib/scenarios/Hotpatch/locale/he/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=.םיימוקמה םירוציה ינפמ םכמצע לע ןגהל וחכשת לאו ,יטמוטוא ןוכימ תועצמאב םכלש הישעתה תא וביחרה ,ןטקב וליחתה .ןקתמה תיינב תא רשפאל ידכ תומדקתמ תויגולונכט רוקחל םכילע היהי .ןייוול ליכמה ליט ותועצמאב רגשלו םיליט רוגיש ןקתמ תונבל םכילע .ללחל ליט רגשל איה םכתמישמ .ויִרֹוטְקַפ לש ישפוחה שיחרתה והז
+
+

lib/scenarios/Hotpatch/locale/hu/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Ez a Factorio szabad játék módja. A feladatod az, hogy kilőj egy rakétát az űr felderítésére. Ehhez egy Rakétasilót kell építened, melyből aztán egy műholddal felszerelt rakétát kell kilőnöd. A Rakétasiló kifejlesztéséhez különféle technológiákat kell fejlesztened. Kezdj kicsiben és küzdd fel magad az automatizálásban. Ne felejts el védekezni a honos fajok ellen.
+
+

lib/scenarios/Hotpatch/locale/it/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Questa è la modalità libera di Factorio. Il tuo obiettivo è quello di lanciare il razzo nello spazio. Completalo costruendo un Silo per Razzi e lanciando il razzo con il satellite. Avrai bisogno di ricercare tecnologie avanzate per riuscire a sbloccare il Silo per Razzi. Inizia in piccolo, espandi con l'automazione e non dimenticare di proteggerti dai nativi.
+
+

lib/scenarios/Hotpatch/locale/ja/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=これは、Factorioのフリープレイです。ロケットサイロを建造し、衛星を載せたロケットを宇宙へ打ち上げるのがあなたの任務です。ロケットサイロをアンロックするためには高度な技術研究をする必要があります。小規模に始め、自動化しつつ進み、原住生物から身を守ることも忘れないでください。
+
+

lib/scenarios/Hotpatch/locale/ko/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Factorio 자유플레이입니다. 당신의 목표는 우주로 로켓을 발사하는 것입니다. 로켓 격납고를 건설하고 인공위성을 탑재한 로켓을 발사하여 이 목표를 달성하세요. 로켓 격납고의 잠금을 해제하기 위해 고급 기술들을 연구할 필요가 있습니다. 작은 것부터 시작해 자동화로 차근차근 발전하고, 토착 생물로부터 자신을 보호하는 것도 잊지 마세요.
+
+

lib/scenarios/Hotpatch/locale/lt/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Tai Factorio laisvas žaidimas. Jūsų užduotis - paleisti raketą į kosmosą. Tam reikia pastatyti Raketos šachtą ir paleisti raketą su palydovu. Reikės atrasti pažangias technologijas kad atrakintumėte Raketos šachtą. Pradėkite palengva, tobulinkite automatiką ir neužmirškite apsisaugoti nuo vietinių.
+
+

lib/scenarios/Hotpatch/locale/lv/freeplay.cfg

@@ -0,0 +1,2 @@
+msg-intro=Šis ir Factorio brīvais režīms. Tavs uzdevums ir palaist raķeti kosmosā. Lai to izdarītu, tev vajadzēs uzbūvēt palaišanas platformu un palaist raķeti ar satelītu. Tev būs jāizpēta sarežģītas tehnoloģijas, lai atbloķētu palaišanas platformu. Sāc no mazumiņa, strādā un neaizmirsti pasargāt sevi no šīs planētas iemītniekiem...
+

lib/scenarios/Hotpatch/locale/nl/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Dit is Factorio vrij spel. Je taak is om een raket te lanceren in de ruimte. Bouw hiervoor een raket-silo en lanceer een raket met een satelliet. Je zult geavanceerde technologieën moeten onderzoeken om de raket-silo vrij te spelen. Begin op kleine schaal, breidt uit en automatiseer je fabriek en vergeet niet jezelf te beschermen tegen de inheemse bewoners.
+
+

lib/scenarios/Hotpatch/locale/no/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Dette er Factorio frispilling. Din oppgave er å sende en rakett til verdensrommet. Bygg en rakettsilo og send opp en rakett med en satellitt. Du blir nødt til å utforske avanserte teknologier for å få tilgang til rakettsiloen. Begynn i det små, jobb deg oppover med hjelp av automatisering, men ikke glem å beskytte deg mot de innfødte.
+
+

lib/scenarios/Hotpatch/locale/pl/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=To jest swobodna rozgrywka Factorio. Twoim zadaniem jest wysłanie rakiety w kosmos. Skonstruuj silos rakietowy i wystrzel z niego rakietę z satelitą. Żeby odblokować silos rakietowy będziesz musiał odkryć zaawansowane technologie. Rozpocznij od podstaw, rozwijaj się wykorzystując automatyzację i nie zapomnij o obronie przed rodzimymi mieszkańcami planety.
+
+

lib/scenarios/Hotpatch/locale/pt-BR/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Este é o modo livre do Factorio. Sua missão é lançar um foguete no espaço. Para fazer isso construa um centro de lançamento de foguetes e lance o foguete com um satélite. Você vai precisar pesquisar tecnologias avançadas para conseguir desbloquear um Centro de lançamento. Comece do começo, continue na automação e não se esqueça de se proteger dos nativos.
+
+

lib/scenarios/Hotpatch/locale/pt-PT/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Este é o jogo livre Factorio. A tua tarefa é lançar um foguetão para explorar o espaço. Faça isto, construindo um Silo de Foguetão e lançar um foguetão com um satélite. Tu vais precisar de pesquisar tecnologias avançadas para poderes desbloquear o Silo de Foguetão. Começa simples, trabalha e evolui com a automação e não te esqueças de proteger-te dos nativos.
+
+

lib/scenarios/Hotpatch/locale/ro/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Acesta este modul Factorio freeplay. Sarcina ta este de a lansa o rachetă în spațiu. Fă acest lucru prin construirea unui siloz de rachete și lansarea unei rachete cu satelit. Va trebui să cercetezi tehnologiile avansate pentru a debloca silozul de rachete. Începe încet, avansează cu automatizarea și nu uita să te protejezi de inamici.
+
+

lib/scenarios/Hotpatch/locale/ru/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Это режим свободной игры Factorio. Ваша задача запустить спутник в космос. Для его запуска потребуется создать ракету и ракетную шахту. Начните с малого, работайте над автоматизацией производства, исследуйте новые технологии и не забывайте о защите от местных форм жизни.
+
+

lib/scenarios/Hotpatch/locale/sk/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Toto je voľná hra Factorio. Tvojou úlohou je vypustiť raketu do vesmíru. Postav raketové silo a vypusti raketu so satelitom. Pre odomknutie raketového sila budeš musieť vyskúmať pokročilé technológie. Začni v malom, postupuj s automatizáciou a nezabnudni sa chrániť pred domácimi.
+
+

lib/scenarios/Hotpatch/locale/sl/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=To je Factorio freeplay. Vaša naloga je poslati raketo v vesolje. To storite tako, da zgradite silos za raketo in jo skupaj s satelitom izstrelite v vesolje. Raziskati bo potrebno napredne tehnologije, da bi lahko odklenili Raketni silos. Začnete z majhnim, nato nadgradite vse s pomočjo avtomatizacije in ne pozabite, zaščitite se pred domorodci.
+
+

lib/scenarios/Hotpatch/locale/sr/freeplay.cfg

@@ -0,0 +1,2 @@
+msg-intro=Ово је Factorio freeplay. Твој задатак је да лансираш ракету са сателитом у свемир. Уради ово грађом ракетног силоса. Треба да истражиш пуно напредних технологија да би откључао ракетни силос. Почни мало, а онда напредуј са аутоматизацијом и не заборави да се заштитиш од ванземаљаца.
+

lib/scenarios/Hotpatch/locale/sv-SE/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Det här är Factorio frispel. Ditt uppdrag är att avfyra en raket ut i rymden. Gör det genom att tillverka en raket silo och avfyra en raket med en satellit. Du kommer att behöva forska fram avancerade teknologier för att kunna låsa upp raket silon. Börja smått, jobba dig uppåt med hjälp av automatisering och glöm inte att försvara dig själv mot infödingarna.
+
+

lib/scenarios/Hotpatch/locale/th/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=นี้คือโหมดอิสระของ Factorio ภารกิจของคุณคือส่งจรวดสู่อวกาศ ซึ่งทำได้โดยการสร้างไซโลจรวดและส่งจรวดขึ้นไปพร้อมกับดาวเทียม คุณต้องวิจัยค้นคว้าเทคโนโลยีขั้นสูงเพื่อปลดล็อคไซโลจรวด เริ่มจากเล็กๆไปเรื่อยๆด้วยระบบอัตโนมัติและอย่าลืมป้องกันตัวเองจากคนพื้นเมืองด้วย
+
+

lib/scenarios/Hotpatch/locale/tr/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Bu Factorio'nun serbest oynanışı. Görevin roketleri uzaya yollamak. Bunu Roket Silosu yaparak ve uyduyla roket yollayarak yapacaksın. Roket Silo'sunu açmak için gelişmiş teknolojileri sırayla açmalısın. Yavaş başla, otomatikleş ve yerlilerden kendini korumayı untuma.
+
+

lib/scenarios/Hotpatch/locale/uk/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Це один з типів гри в Factorio - "Вільна гра". Ваше завдання - запустити ракету у космічний простір. Зробіть це, побудувавши ракетну шахту та запустивши ракету зі супутником. Вам потрібно дослідити передові технології, щоб мати змогу побудувати ракетну шахту. Починайте з малого, розвивайтеся за допомогою автоматизації, але не забувайте і про оборону!
+
+

lib/scenarios/Hotpatch/locale/vi/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=Đầy là chế độ freeplay của Factorio. Nhiệm cụ của bạn là phóng một chiếc tên lửa lên vũ trụ. Hãy xây dựng một bệ phóng tên lửa để phóng một chiếc tên lửa kèm theo vệ tinh. Bạn sẽ cần phải nghiên cứu nhiều công nghệ tiên tiến để có thể xây dựng bệ phóng tên lửa. Bắt đầu từ quy mô nhỏ, phát triển dần dần bằng tự động hóa, và đừng quên bảo vệ bản thân mình khỏi những sinh vật sinh sống ở đây.
+
+

lib/scenarios/Hotpatch/locale/zh-CN/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=欢迎来到异星工厂标准模式，你的目标是要把火箭发射到太空。为此你需要研发一系列高等科技，解锁并修建火箭发射井，直到把携带有卫星的火箭发射出去。从小作坊生产起步，逐渐建立起属于自己的自动化大工厂吧！同时，别忘了防范异星虫子的骚扰 ...
+
+

lib/scenarios/Hotpatch/locale/zh-TW/freeplay.cfg

@@ -0,0 +1,3 @@
+msg-intro=這是異星工廠的自由模式。你的任務是發射火箭，探索外太空。請建造一個火箭發射井，並發射攜帶著衛星的火箭。你會需要研究大量的進階科技以解鎖火箭發射井。從頭開始，靠著自動化科技的協助向目標邁進時，也別忘記從外星住民手的中保護你自己啊！
+
+

lib/stringUtils.js

@@ -0,0 +1,14 @@
+function hashCode(string){
+	if(typeof string !== "string") throw "ERROR stringUtils: Not a string";
+	var hash = 0;
+	if (string.length == 0) return hash;
+	for (let i = 0; i < string.length; i++) {
+		char = string.charCodeAt(i);
+		hash = ((hash << 5) - hash) + char;
+		hash = hash & hash; // Convert to 32bit integer
+	}
+	return hash;
+}
+module.exports = {
+	hashCode: hashCode,
+}

lib/stringUtils.spec.js

@@ -0,0 +1,48 @@
+const assert = require("assert");
+const stringUtils = require("./stringUtils");
+
+describe("stringUtils.js", function(){
+	describe("hashCode", function(){
+		it("Produces a 32bit signed int hash from a string", function(){
+			let x = stringUtils.hashCode("whatever");
+			let y = stringUtils.hashCode(" a much longer string to prove this works for long strings as well and also special characters &!¤(#)¤");
+			
+			assert(typeof x == "number", "hashCode should be returning a 32 bit signed int");
+			assert(x.toString() == "1934383586");
+			assert(y.toString() == "1648886132");
+		});
+		let permutations = 1000;
+		it("Rarely produces same hash for different strings ("+permutations+" hashes with collision check)", function(){
+			let keyHashPairs = [];
+			for(let i = 0; i < permutations; i++){
+				let string = Math.random().toString();
+				keyHashPairs.push({
+					key:string,
+					hash:stringUtils.hashCode(string),
+				});
+			}
+			
+			for(let i = 0; i < permutations; i++){
+				for(let o = 0; o < permutations; o++){
+					assert(i == o || keyHashPairs[o].key != keyHashPairs[i].key, "Woha, Math.random() generated 2 equal numbers???");
+					assert(i == o || keyHashPairs[o].hash != keyHashPairs[i].hash, "Hash collision, as long at it doesn't happen again its fine.");
+				}
+			}
+		});
+		it("Returns 0 for 0 length strings", function(){
+			let x = stringUtils.hashCode("");
+			assert.deepEqual(x, 0);
+		});
+		it("Throws when supplied with anything other than a string", function(){
+			assert.throws(function(){
+				stringUtils.hashCode([]);
+			}, "ERROR: Not a string")
+			assert.throws(function(){
+				stringUtils.hashCode({});
+			}, "ERROR: Not a string")
+			assert.throws(function(){
+				stringUtils.hashCode(0);
+			}, "ERROR: Not a string")
+		});
+	});
+});

lib/typedef.js

@@ -0,0 +1,11 @@
+/**
+An item with a count specified
+
+@typedef {object} itemStack
+@property {string} name The name of the item in the stack
+@property {(number|string)} count The amount of items in the stack
+
+@example
+itemStack = {name:"iron-plate", count:"12"}
+itemStack = {name:"copper-plate", count:972}
+*/

logo.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg width="100%" height="100%" viewBox="0 0 154 24" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:1.41421;"><path d="M105.009,19.309l-3.12,0l-1.68,-1.68l0,-10.293l2.64,-2.64c2.029,0 7.281,0 9.996,0l1.68,1.68l0,6.2l-0.96,0.96l-7.596,-0.003l0,4.816l-0.96,0.953l0,0.007Zm6.876,0l-3.12,0l0,-3.944l0.96,-0.96l4.8,0l0,2.212l-2.64,2.692Zm-63.405,0l-9.917,0l-1.68,-1.68l0,-10.293l2.64,-2.64l3.118,0l0.002,9.827l2.718,0l0.002,-8.867l0.96,-0.96l3.117,0l1.68,1.68l0,10.293l-2.64,2.64Zm-15.652,0l-9.918,0l-1.68,-1.68l0,-10.293l2.64,-2.64l3.118,0l0.002,9.827l8.478,0.009l0,2.137l-2.64,2.64Zm-15.712,0l-9.996,0l-1.68,-1.68l0,-10.293l2.64,-2.64c2.029,0 7.281,0 9.996,0l1.68,1.68c0,1.028 0,2.147 0,2.147l-0.96,0.942l0,0.018l-7.596,0l0,5.04l8.556,0l0,2.146l-2.64,2.64Zm47.185,0l-9.997,0l-1.68,-1.68l0,-2.142l0.96,-0.96l7.597,-0.002l0,-0.993l-8.557,0l0,-6.196l1.68,-1.68l0,0l0.96,-0.96c2.029,0 7.282,0 9.997,0l1.68,1.68c0,1.028 0,2.147 0,2.147l-0.96,0.96l-7.597,0.002l0,0.957l8.557,0l0,6.227l-0.96,0.96l0,0l-1.68,1.68Zm12.444,0l-3.12,0l-1.68,-1.68l0,-6.216l0.96,-0.96l6.48,0l0,6.216l-2.64,2.64Zm19.325,0l-9.996,0l-1.68,-1.68l0,-10.293l2.64,-2.64c2.029,0 7.281,0 9.996,0l1.68,1.68c0,1.028 0,2.147 0,2.147l-1.086,0.96l-7.47,0l0,0.959l5.841,0l0,2.13l-0.96,0.96l-4.881,0l0,0.991l8.556,0l0,2.146l-2.64,2.64Zm20.065,-7.896l0.96,-0.96l6.481,0l0,5.953l-2.64,2.903l-3.121,0l-1.68,-1.943l0,-5.953Zm21.411,7.896l-2.872,0l0,-1.178c-1.382,-0.123 -2.749,-0.431 -4.028,-0.977l-0.056,-0.024l-1.307,0.804l-2.03,-1.25l1.277,-0.786c-0.81,-0.666 -1.487,-1.522 -1.761,-2.534l-1.749,0l0,-1.768l0.96,-0.96l1.141,0c0.332,-0.616 0.809,-1.156 1.35,-1.61l-1.198,-0.78l0.94,-0.93l2.03,-1.25l1.227,0.755c0.949,-0.424 2.033,-0.741 3.204,-0.922l0,-0.248l0.013,0l0.947,-0.96l2.872,0l0,1.116c1.505,0.156 2.889,0.535 4.059,1.079l1.332,-0.82l2.03,1.25l-1.12,1.059c0.701,0.671 1.181,1.437 1.377,2.261l1.976,0l0,1.768l-0.96,0.962l-0.002,-0.002l-1.327,0c-0.228,0.624 -0.547,1.236 -1.053,1.681l1.109,0.679l-0.968,0.978l-0.015,-0.004l-2.007,1.236l-1.411,-0.868c-0.958,0.432 -1.978,0.728 -3.02,0.908l0,0.375l-0.96,0.93l0,0.03Zm-15.17,-7.656l-6.001,0l0,5.624l1.55,1.792l2.901,0l1.55,-1.792l0,-5.624Zm-44.191,0l-6,0l0,5.877l1.54,1.539l2.921,0l1.539,-1.539l0,-5.877Zm35.14,3.952l-4.32,0l0,3.464l2.778,0l1.542,-1.59l0,-1.874Zm-96.308,-9.709l-9.798,0l-1.539,1.54l0,10.094l1.539,1.539l9.798,0l1.539,-1.539l0,-1.807l-8.556,0l0,-6.48l8.556,0l0,-1.807l-1.539,-1.54Zm8.771,0l-2.778,0l-1.54,1.54l0,10.094l1.54,1.539l9.719,0l1.539,-1.539l0,-1.799l-8.478,-0.008l-0.002,-9.827Zm15.653,0l-2.779,0l-1.539,1.54l0,10.094l1.539,1.539l9.719,0l1.539,-1.539l0,-10.094l-1.539,-1.54l-2.778,0l-0.003,9.827l-4.157,0l-0.002,-9.827Zm54.53,0l-9.798,0l-1.539,1.54l0,10.094l1.539,1.539l9.798,0l1.539,-1.539l0,-1.807l-8.556,0l0,-2.431l5.841,0l0,-1.65l-5.841,0l0,-2.399l8.556,0l0,-1.807l-1.539,-1.54Zm-31.77,0l-9.797,0l-0.82,0.82l-0.72,0.72l0,5.856l8.557,0l0,2.432l-8.557,0.003l0,1.803l1.54,1.539l9.797,0l1.54,-1.539l0,-5.888l-8.557,0l0,-2.396l8.557,-0.003l0,-1.807l-1.54,-1.54Zm47.585,0l-9.798,0l-1.539,1.54l0,10.094l1.539,1.539l2.781,0l0,-5.777l8.556,0.004l0,-5.86l-1.539,-1.54Zm28.324,7.453c0.327,-0.363 0.421,-0.95 0.212,-1.53c-0.459,-1.279 -2.339,-2.021 -4.278,-2.122c-0.058,0 -0.058,0 -0.115,0c-2.792,0.201 -3.386,1.31 -3.433,1.781c-0.151,1.505 1.994,2.74 4.45,2.74c1.269,0 2.7,-0.357 3.164,-0.869Zm-31.101,-1.707l0,-2.398l-4.24,0.002l0,2.396l4.24,0Zm-3.04,-2.157l0,0.957l2.8,0l0,-0.958l-2.8,0.001Zm-24.048,0.012l-13.471,0l0,-2.161l2.64,-2.64l10.111,0l1.68,1.68c0,1.034 0,2.161 0,2.161l-0.96,0.96Zm40.606,-0.048l-6.392,0l0,-2.113l2.64,-2.64l4.801,-0.005l0,3.798l-1.049,0.96Zm-42.386,-3.553l-9.912,0l-1.539,1.54l0,1.821l12.991,0l0,-1.821l-1.54,-1.54Zm37.774,0l-1.54,1.54l0,1.773l6.001,0l0,-3.318c-1.487,0.002 -2.974,0.003 -4.461,0.005Z" style="fill:#141414;"/><path d="M73.625,19.309l3.12,0l-3.12,0Zm47.201,-0.24l-2.901,0l-1.55,-1.792l0,-5.624l6.001,0l0,5.624l-1.55,1.792Zm-44.18,0l-2.921,0l-1.54,-1.539l0,-5.877l6,0l0,5.877l-1.539,1.539Zm60.66,0l-2.392,0l0,-1.157l-0.288,-0.026c-1.392,-0.131 -2.761,-0.465 -4.055,-1.026l-1.288,0.792l-1.572,-0.968l1.175,-0.724l0.005,-0.076l-0.25,-0.205c-0.598,-0.5 -1.12,-1.098 -1.438,-1.808c-0.159,-0.355 -0.249,-0.743 -0.25,-0.747l-1.693,0l0,-1.288l1.676,0l0.056,-0.226c0.27,-1.047 1.011,-1.878 1.84,-2.574l-0.005,-0.072l-1.116,-0.688l1.572,-0.968l1.208,0.743l0.228,-0.1c1.335,-0.574 2.76,-0.86 4.195,-0.988l0,-1.072l2.392,0l0,1.092l0.284,0.03c1.394,0.155 2.76,0.518 4.031,1.105l1.316,-0.81l1.572,0.968l-1.259,0.776l0.236,0.276c0.559,0.497 1.039,1.085 1.324,1.77c0.148,0.356 0.225,0.734 0.226,0.738l1.924,0l0,1.288l-1.941,0l-0.059,0.219c-0.367,1.3 -1.768,2.53 -1.768,2.53l1.317,0.811l-1.572,0.968l-1.394,-0.858lLine truncated

main.tsx

@@ -1,63 +0,0 @@
-import React from "react";
-import { createRoot } from "react-dom/client";
-import { BrowserRouter } from "react-router-dom";
-import { ConfigProvider, theme } from "antd";
-import { PluginDetails } from "@clusterio/lib";
-import SiteLayout from "../../packages/web_ui/src/components/SiteLayout.tsx";
-import PluginsPage from "../../packages/web_ui/src/components/PluginsPage.tsx";
-import ControlContext from "../../packages/web_ui/src/components/ControlContext.tsx";
-import "../../packages/web_ui/src/style.css";
-
-const specs = [
-	["awf_oarc", "awf_oarc", "0.2.16", "0.3.1"],
-	["auto_restart", "ExpGaming - Auto Restart", "7.0.5", "7.0.5"],
-	["global_chat", "Global Chat", "2.0.0", "2.1.0"],
-	["research_sync", "Research Sync", "2.1.0", "2.1.0"],
-];
-const plugins = specs.map(([name, title, version, latest]) => new PluginDetails(
-	name, title, version, "loaded", undefined, `@fixture/${name}`,
-	name === "awf_oarc" ? latest : version, `@fixture/${name}`,
-));
-const hostPlugins = plugins.map(plugin => plugin.name === "auto_restart"
-	? new PluginDetails(plugin.name, plugin.title, plugin.version, "noEntrypoint", undefined,
-		plugin.npmPackage, plugin.version, plugin.dependencyName) : plugin);
-const store = entries => {
-	const snapshot = [new Map(entries), true, null];
-	return { subscribe: () => () => {}, getSnapshot: () => snapshot };
-};
-const meta = plugins.map(p => ({ name: p.name, version: p.version, npmPackage: p.npmPackage,
-	enabled: true, web: p.name === "awf_oarc" ? { error: "Fixture: web module could not load" } : {} }));
-const originalFetch = window.fetch;
-window.fetch = (url, ...rest) => String(url).endsWith("api/plugins")
-	? Promise.resolve(new Response(JSON.stringify(meta))) : originalFetch(url, ...rest);
-const permissions = ["core.plugin.list", "core.plugin.search", "core.plugin.update", "core.plugin.install",
-	"core.controller.restart", "core.host.restart"];
-const control = {
-	accountName: "Cooldude2606", accountRoles: [{ permissions }],
-	onAccountUpdate() {}, offAccountUpdate() {}, connector: {},
-	plugins: new Map(),
-	pluginInfos: new Map(specs.map(([name, title]) => [name, { name, title }])),
-	hosts: store([[1, { id: 1, name: "Host 1", connected: true }]]),
-	systems: store([["controller", { plugins, canRestart: true }], [1, { plugins: hostPlugins, canRestart: true }]]),
-	instances: store([]), users: store([]),
-	pages: [
-		...["Controller", "Hosts", "Instances", "Users"].map(title => ({ path: `/${title.toLowerCase()}`,
-			sidebarName: title, content: <div>{title}</div> })),
-		{ path: "/plugins", sidebarName: "Plugins", content: <PluginsPage /> },
-		{ path: "/plugins/:name/view", content: <div>Plugin navigation target</div> },
-	],
-	async send(request) {
-		if (request.constructor.name === "PluginLatestVersionsRequest") {
-			return { versions: Object.fromEntries(specs.map(([name, , , latest]) => [`@fixture/${name}`, latest])) };
-		}
-		throw new Error(`Unexpected fixture request: ${request.constructor.name}`);
-	},
-	async sendTo(address, request) {
-		if (request.constructor.name === "PluginListRequest") { return address === "controller" ? plugins : hostPlugins; }
-		throw new Error(`Unexpected fixture request: ${request.constructor.name}`);
-	},
-};
-window.fixtureControl = control;
-createRoot(document.getElementById("root")).render(<ConfigProvider theme={{ algorithm: theme.darkAlgorithm }}>
-	<ControlContext.Provider value={control}><BrowserRouter><SiteLayout /></BrowserRouter></ControlContext.Provider>
-</ConfigProvider>);

master.spec.js

@@ -0,0 +1,173 @@
+var app = require('./master.js'),
+  assert = require('assert'),
+  request = require('supertest');
+const validateHTML = require('html5-validator');
+var parallel = require('mocha.parallel');
+
+
+describe('Master server endpoint testing', function() {
+	describe('#GET /api/getFactorioLocale', function() { 
+		it('should get the basegame factorio locale', function(done) { 
+			request(app).get('/api/getFactorioLocale').end(function(err, res) {
+				assert.equal(res.statusCode, 200);
+				
+				let object = res.body;
+				
+				// test that it is actual factorio locale, copied from getFactorioLocale.spec.js
+				assert.equal(typeof object, "object");
+				assert.equal(object["entity-name"]["fish"], "Fish");
+				assert.equal(object["entity-name"]["small-lamp"], "Lamp");
+				Object.keys(object).forEach(key => {
+					// first level of the nested object is always an object
+					assert.equal(typeof object[key], "object");
+					
+					Object.keys(object[key]).forEach(key2 => {
+						// second level of the nested object is always a string, nearly always truthy
+						if(key2 != "so-long-and-thanks-for-all-the-fish"){
+							assert.ok(object[key][key2]);
+							assert.equal(typeof object[key][key2], "string");
+						}
+					});
+				});
+				done();
+			});
+		});
+	});
+	// describe("#GET /api/")
+	parallel("#GET static website data", function() {
+		this.timeout(6000);
+		it("sends some HTML when accessing /", function(done){
+			this.timeout(6000);
+			request(app).get("/").end(function(err,res){
+				assert.equal(res.statusCode, 200);
+				validateHTML(res.text).then(result => {
+					assert(result.messages.length === 1, "there are HTML errors on the page, please fix: "+JSON.stringify(result.messages));
+					done();
+				});
+			});
+		});
+		it("sends some HTML when accessing /nodes",function(done){
+			this.timeout(6000);
+			request(app).get("/nodes").end(function(err,res){
+				assert.equal(res.statusCode, 200);
+				validateHTML(res.text).then(result => {
+					assert(result.messages.length === 1, "there are HTML errors on the page, please fix: "+JSON.stringify(result.messages));
+					done();
+				});
+			});
+		});
+		it("sends some HTML when accessing /settings",function(done){
+			this.timeout(6000);
+			request(app).get("/settings").end(function(err,res){
+				assert.equal(res.statusCode, 200);
+				validateHTML(res.text).then(result => {
+					assert(result.messages.length === 1, "there are HTML errors on the page, please fix: "+JSON.stringify(result.messages));
+					done();
+				});
+			});
+		});
+		it("sends some HTML when accessing /nodeDetails",function(done){
+			this.timeout(6000);
+			request(app).get("/nodeDetails").end(function(err,res){
+				assert.equal(res.statusCode, 200);
+				validateHTML(res.text).then(result => {
+					assert(result.messages.length === 1, "there are HTML errors on the page, please fix: "+JSON.stringify(result.messages));
+					done();
+				});
+			});
+		});
+	});
+	let persistentMaster = request(app);
+	describe("#POST /api/place", function(){
+		it("adds an itemStack to the masters inventory", function(done){
+			persistentMaster.post("/api/place")
+			.send({
+				name:"steel-plate",
+				count:20,
+				instanceName:"unitTest"
+			})
+			.end(function(err,res){
+				assert(!err)
+				assert.equal(res.text, "success", "something went wrong with the request")
+				done();
+			});
+		});
+	});
+	describe("#GET /api/inventory", function(){
+		it("returns the masters current inventory", function(done){
+			persistentMaster.get("/api/inventory").end(function(err,res){
+				assert.equal(res.statusCode, 200);
+				let inventory = JSON.parse(res.text);
+				assert.equal(typeof inventory, "object", "Inventory should be an object");
+				assert(inventory.length >= 1, "There should be at least 1 entry in the inventory");
+				
+				let contains20SteelPlate = false;
+				inventory.forEach(itemStack => {
+					if(itemStack.name == "steel-plate" && itemStack.count >= 20) contains20SteelPlate = true;
+				});
+				assert(contains20SteelPlate, "Please ensure there are at least 20 steel plate in the inventory")
+				done();
+			});
+		});
+	});
+	parallel("#POST /api/remove", function(){
+		it("returns an itemStack of how many items were removed", function(done){
+			persistentMaster.post("/api/remove")
+			.send({
+				name:"steel-plate",
+				count:10
+			})
+			.end(function(err,res){
+				assert(!err);
+				assert.equal(res.body.count, 10, "Something is wrong with the response, maybe the format changed slightly or you didn't have enough steel?");
+				
+				done();
+			});
+		});
+		it("returns an empty itemStack if you try to request addItem or removeItem", function(done){
+			let casesRan = 0;
+			persistentMaster.post("/api/remove")
+			.send({
+				name:"addItem",
+				count:10
+			})
+			.end(function(err,res){
+				assert(!err);
+				assert.equal(res.text, '{"name":"addItem","count":0}', "When there are none of the item, you should get 0 back. addItem and removeItem should always return 0");
+				
+				isDone();
+			});
+			
+			persistentMaster.post("/api/remove")
+			.send({
+				name:"removeItem",
+				count:10
+			})
+			.end(function(err,res){
+				assert(!err);
+				assert.equal(res.text, '{"name":"removeItem","count":0}', "When there are none of the item, you should get 0 back. addItem and removeItem should always return 0");
+				
+				isDone();
+			});
+			
+			function isDone(){
+				if(++casesRan == 2) done();
+			}
+		});
+		it("returns an empty itemStack if you don't have any of the item you request", function(done){
+			persistentMaster.post("/api/remove")
+			.send({
+				name:"imaginaryItem",
+				count:999999
+			})
+			.end(function(err,res){
+				assert(!err);//{"name":"imaginaryItem","count":0}
+				assert.equal(res.body.name, "imaginaryItem", "Make sure body.name is the item we asked for");
+				assert.equal(res.body.count, 0, "Count should be 0 since we are asking for something that does not exist anywhere");
+				assert.equal(Object.keys(res.body).length, 2, "name and count should be the only keys on this object");
+				
+				done();
+			});
+		});
+	});
+});

node_modules/_app/clusterTools/checkHotpatchInstallation.js

@@ -0,0 +1,9 @@
+module.exports = async function checkHotpatchInstallation(messageInterface){
+	let yn = await messageInterface("/silent-command if remote.interfaces['hotpatch'] then rcon.print('true') else rcon.print('false') end");
+	yn = yn.replace(/(\r\n\t|\n|\r\t)/gm, "");
+	if(yn == "true"){
+		return true;
+	} else if(yn == "false"){
+		return false;
+	}
+}

node_modules/_app/clusterTools/getCommand.js

@@ -0,0 +1,16 @@
+const fs = require("fs-extra");
+
+const getLua = require("./getLua.js");
+
+let commandCache;
+module.exports = async function getCommand(file, COMPRESS = true){
+	commandCache = commandCache || {};
+	if(!commandCache[file]){
+		commandCache[file] = await getLua(file);
+		return commandCache[file];
+	} else if(typeof commandCache[file] == "string"){
+		return commandCache[file];
+	} else {
+		throw new Error("Command not found");
+	}
+}

node_modules/_app/clusterTools/getInstanceName.js

@@ -0,0 +1,40 @@
+const needle = require("needle");
+
+module.exports = function(config){
+	const instances = [];
+	
+	if(config){
+		return function getInstanceName(instanceID){
+			return new Promise((resolve, reject) => {
+				let instance = instances[instanceID];
+				if(!instance){
+					needle.get(config.masterIP+":"+config.masterPort+ '/api/slaves', (err, response) => {
+						if(err || response.statusCode != 200) {
+							console.log("Unable to get JSON master/api/slaves, master might be unaccessible");
+						} else if (response && response.body) {	
+							if(Buffer.isBuffer(response.body)) {console.log(response.body.toString("utf-8")); reject(new Error())}
+								try {
+									for (let index in response.body)
+										instances[index] = response.body[index].instanceName;
+								} catch (e){
+									console.log(e);
+									return null;
+								}
+							instance = instances[instanceID] 							
+							if (!instance) instance = instanceID;  //somehow the master doesn't know the instance	
+							resolve(instance);
+						}
+					});
+				} else {
+					resolve(instance);
+				}
+			});
+		}
+	} else {
+		return async function thisAintGonnaWork(){
+			let err = new Error("getInstanceName from _app/clusterTools needs to be called with {config} to work");
+			console.log(err);
+			throw err;
+		}
+	}
+}

node_modules/_app/clusterTools/getLua.js

@@ -0,0 +1,40 @@
+const fs = require("fs-extra");
+
+module.exports = function getLua(filePath, COMPRESS_LUA = true){
+	return new Promise((resolve, reject) => {
+		fs.readFile(filePath, "utf8", (err, contents) => {
+			if(err){
+				reject(err);
+			} else {
+				// split content into lines
+				contents = contents.split(/\r?\n/);
+
+				// join those lines after making them safe again
+				contents = contents.reduce((acc, val) => {
+					val = val.replace(/\\/g ,'\\\\');
+					// remove leading and trailing spaces
+					val = val.trim();
+					// escape single quotes
+					val = val.replace(/'/g ,'\\\'');
+
+					// remove single line comments
+					let singleLineCommentPosition = val.indexOf("--");
+					let multiLineCommentPosition = val.indexOf("--[[");
+
+					if(multiLineCommentPosition === -1 && singleLineCommentPosition !== -1) {
+						val = val.substr(0, singleLineCommentPosition);
+					}
+
+					return acc + val + '\\n';
+				}, ""); // need the "" or it will not process the first row, potentially leaving a single line comment in that disables the whole code
+
+				// console.log(contents);
+
+				// this takes about 46 ms to minify train_stop_tracking.lua in my tests on an i3 6100u
+				if(COMPRESS_LUA) contents = require("luamin").minify(contents);
+				
+				resolve(contents);
+			}
+		});
+	});
+}

node_modules/_app/clusterTools/index.js

@@ -0,0 +1,41 @@
+/**
+
+Functions frequently needed from different places in the cluster. Ex:
+  * Loading Lua scripts
+  * Checking if hotpatch is installed
+  * Getting an instance's displayname from their ID
+
+*/
+
+module.exports = ({config} = {}) => ({
+	/**
+		async function to get Lua from a file, remove comments, minify and return.
+		
+		arg1 is the file path
+		arg2 is whether or not to compress the Lua. Makes debugging harder, but reduces bandwidth when many players are online. Recommended for polling commands. Defaults to true.
+		Promise resolves with a string of Lua.
+	*/
+	getLua: require("./getLua.js"),
+	/**
+		async function to check whether hotpatch is installed in a server.
+		
+		First argument is the servers async messageInterface for rcon return values
+		Promise resolves with boolean.
+	*/
+	checkHotpatchInstallation: require("./checkHotpatchInstallation.js"),
+	/**
+		async function to get an instances displayname from their instanceID
+		
+		arg1 is the instanceID
+		Promise resolves with a string, either the displayName or instanceID if not found.
+	*/
+	getInstanceName: require("./getInstanceName.js")(config),
+	/**
+		async function same as getLua, but using an in memory cache to lower FS operations.
+		
+		arg1 is the file path
+		arg2 is whether or not to compress, default true
+		Promise resolves with a string of Lua.
+	*/
+	getCommand: require("./getCommand.js"),
+})

node_modules/_app/factorioServer/index.js

@@ -0,0 +1,168 @@
+/**
+
+class factorioServer
+
+This class has the responsiblity of :
+
+* spawning a factorio server
+* Handling input via stdin or RCON
+
+
+*/
+
+const fs = require("fs");
+const child_process = require("child_process");
+const path = require("path");
+
+const mkdirp = require("mkdirp");
+const appRootPath = require("app-root-path");
+
+const fileOps = require("_app/fileOps");
+
+module.exports = class factorioServer {
+	constructor({
+		factorioDirectory = "factorio",
+		instanceDirectory = "instances/data",
+		instanceName = "Default server name",
+		factorioPort = Math.floor(Math.random() * 65535),
+		serversettings = {},
+		onProgress = function(type, a, b, c){
+			if(type == "progress") console.log("Progress: ",a," of ",b," unit: ",c);
+			if(type == "log") console.log(a);
+		},
+	} = {}){
+		this.factorioDirectory = factorioDirectory;
+		this.instanceDirectory = instanceDirectory;
+		this.instanceName = instanceName;
+		this.factorioPort = factorioPort;
+		this.serversettings = Object.assign({
+			"name": "Clusterio instance: " + this.instanceName,
+			"description": "Public factorio server running clusterio",
+			"tags": ["clusterio"],
+			"max_players": "20",
+			"visibility": "public",
+			"username": "",
+			"token": "",
+			"game_password": "",
+			"verify_user_identity": true,
+			"admins": ["Danielv123"],
+			"allow_commands": true,
+			"autosave_interval": 10,
+			"autosave_slots": 5,
+			"afk_autokick_interval": 0,
+			"auto_pause": false,
+		}, serversettings);
+		this.onProgress = (type, a, b, c) => {
+			if(typeof onProgress == "function") onProgress(type, a, b, c);
+		};
+	}
+	async initialize(){
+		if(!await this.isValidInstance()){
+			await this.createInstance();
+		}
+		return true;
+	}
+	async createInstance(path = this.instanceDirectory){
+		if(await this.isValidInstance(path)){
+			throw new Error("Instance already exists!");
+		}
+		
+		// create folders
+		let folders = [
+			"/script-output/",
+			"/saves/",
+			"/mods/",
+			"/instanceMods/",
+		];
+		mkdirp.sync(path);
+		folders.forEach(folder => mkdirp.sync(path + folder));
+		
+		// create files
+		let files = [
+			{name: "/script-output/output.txt", content: ""},
+			{name: "/script-output/orders.txt", content: ""},
+			{name: "/script-output/txbuffer.txt", content: ""},
+			{name: "/config.ini", content: "[path]\r\n\ read-data=__PATH__executable__/../../data\r\n\ write-data=__PATH__executable__/../../../" + this.instanceDirectory + "\r\n\ "},
+			{name: "/config.json", content: JSON.stringify({
+				factorioPort: this.factorioPort,
+				clientPassword: Math.random().toString(36).replace(/[^a-z]+/g, '').substr(0, 8),
+			}, null, 4)},
+			{name: "/server-settings.json", content: JSON.stringify(this.serversettings, null, 4)},
+		];
+		files.forEach(file => {
+			fs.writeFile(path + file.name, file.content, doneWritingHandler);
+			// console.log("Created: ",path+file.name);
+		});
+		
+		let filesToWrite = files.length;
+		function doneWritingHandler(){
+			if(!--filesToWrite){
+				return path;
+			}
+		}
+	}
+	async deleteInstance(path = this.instanceDirectory){
+		if(await this.isValidInstance(path)){
+			await fileOps.deleteFolderRecursive(path);
+			return true;
+		} else {
+			return false;
+		}
+	}
+	isValidInstance(path = this.instanceDirectory){
+		return new Promise((resolve, reject) => {
+			fs.stat(path, (err, stat) => {
+				if(err){
+					// console.log(err)
+					resolve(false);
+				} else {
+					// the instance folder exists, do some more checks
+					fs.readdir(path, (err, files) => {
+						if(files && Array.isArray(files)){
+							let foldersThatShouldBeThere = [
+								"script-output",
+								"saves",
+								"mods",
+								"instanceMods",
+							];
+							let instanceValidity = true;
+							foldersThatShouldBeThere.forEach(folder => {
+								if(!files.includes(folder)){
+									instanceValidity = false;
+								}
+							});
+							resolve(instanceValidity);
+						}
+					});
+				}
+			});
+		});
+	}
+	createMap(name = "map.zip"){
+		return new Promise((resolve, reject) => {
+			this.isValidInstance().then(isValid => {
+				if(!isValid){
+					return createInstance();
+				}
+			}).then(()=>{
+				this.onProgress("log", "Starting map creation");
+				// console.log(this.factorioDirectory + '/bin/x64/factorio')
+				let proc = child_process.spawn(
+					path.join(this.factorioDirectory, 'bin', 'x64', 'factorio'), [
+						'-c', path.join(this.instanceDirectory,'config.ini'),
+						'--create', path.join(this.instanceDirectory, 'saves',name),
+						'--server-settings', path.join(this.instanceDirectory, 'server-settings.json'),
+					],{
+						cwd:process.cwd(),
+					}
+				);
+				// console.log(proc.stdout.toString("utf8"));
+				proc.stdout.on("data", data => this.onProgress("log", data.toString("utf8")));
+				proc.on("close", code => {
+					this.onProgress("log", "Map created! "+code);
+					resolve();
+				});
+			});
+		});
+	}
+}

node_modules/_app/factorioServer/index.spec.js

@@ -0,0 +1,114 @@
+const assert = require("assert");
+const fs = require("fs");
+const path = require("path");
+
+const appRootPath = require("app-root-path");
+const parallel = require("mocha.parallel");
+const mkdirp = require("mkdirp");
+
+const factorioServer = require("./index.js");
+
+describe("class factorioServer/index.js", ()=>{
+	it("is a class (or at least a function)", ()=>{
+		assert.equal(typeof factorioServer, "function");
+	});
+	describe(".deleteInstance(instanceName)", ()=>{
+		it("deletes an instance, defaulting to the classes instanceDirectory", async () => {
+			let server = new factorioServer({
+				instanceDirectory: path.resolve(__dirname, "_testData_deleteInstance"),
+				instanceName: "Unit testing instance",
+			});
+			await server.initialize();
+			await server.deleteInstance();
+			assert.equal(await server.isValidInstance(), false);
+			return true;
+		});
+	});
+	describe(".isValidInstance(instanceName)", ()=>{
+		it("tells us whether an instance exists or not", async () => {
+			let server = new factorioServer({
+				instanceDirectory: path.join(__dirname, "_testData_isValidInstance"),
+				instanceName: "Unit testing instance",
+			});
+			await server.deleteInstance();
+			let status = await server.isValidInstance();
+			assert.equal(status, false);
+			let x = await server.initialize(); // creates our instance
+			let status2 = await server.isValidInstance();
+			assert.equal(status2, true);
+			
+			await server.deleteInstance(); // clean up folder
+			return true;
+		});
+		it("does not get tricked by an empty folder", async () => {
+			let server = new factorioServer({
+				instanceDirectory: path.join(__dirname, "_testData_isValidInstance_2"),
+				instanceName: "Unit testing instance",
+			});
+			assert.equal(await server.isValidInstance(), false);
+			
+			mkdirp.sync(path.join(__dirname, "_testData_isValidInstance_2")); // create empty folder simulating instance
+			assert.equal(await server.isValidInstance(), false);
+			
+			await server.initialize(); // create a proper instance
+			assert.equal(await server.isValidInstance(), true);
+			
+			await server.deleteInstance(); // delete the instance and ensure we see that it is in fact deleted
+			assert.equal(await server.isValidInstance(), false);
+			
+			return true;
+		}).timeout(5000);
+	});
+	describe(".initialize()", ()=>{
+		it("creates an instance", done => {
+			let server = new factorioServer({
+				instanceDirectory: path.resolve(__dirname, "_testData_initialize"),
+				instanceName: "Unit testing instance",
+			});
+			server.initialize().then(()=>{
+				return server.deleteInstance();
+			}).then(() => {
+				done();
+			}).catch(e => console.log(e));
+		});
+	});
+	describe(".createMap(mapName.zip)", ()=>{
+		it("creates a map file as instanceDirectory/saves/map.zip", async function(){
+			this.timeout(20000); // these test often takes a lot of time in the map creation step (4500 ms on i3 dev system)
+			let relativePath = __dirname.replace(appRootPath, "").substr(1);
+			let server = new factorioServer({
+				instanceDirectory: path.join(relativePath, "_testData_createMap"),
+				instanceName: "Unit testing instance",
+				onProgress: false,
+			});
+			await server.initialize();
+			let maps = fs.readdirSync(path.join(relativePath, "_testData_createMap", "saves"));
+			assert.equal(maps.length, 0);
+			await server.createMap();
+			let maps2 = fs.readdirSync(path.join(relativePath, "_testData_createMap", "saves"));
+			assert(maps2.includes("map.zip"));
+			
+			await server.deleteInstance();
+			return true;
+		});
+		it("supports custom filenames", async function(){
+			this.timeout(20000);
+			let relativePath = __dirname.replace(appRootPath, "").substr(1);
+			let server = new factorioServer({
+				instanceDirectory: path.join(relativePath, "_testData_createMap_2"),
+				instanceName: "Unit testing instance",
+				onProgress: false,
+			});
+			await server.initialize();
+			
+			let maps = fs.readdirSync(path.join(relativePath, "_testData_createMap_2", "saves"));
+			assert.equal(maps.length, 0);
+			await server.createMap("mapWithCustomName.zip");
+			let maps2 = fs.readdirSync(path.join(relativePath, "_testData_createMap_2", "saves"));
+			assert(maps2.includes("mapWithCustomName.zip"));
+			
+			await server.deleteInstance();
+			return true;
+		});
+	});
+});

node_modules/_app/fileOps/fileOps.js

@@ -0,0 +1,120 @@
+const fs = require("fs");
+const path = require("path");
+
+// gets newest file in a directory
+// dir is directory
+// files is array of filenames
+// callback(err, filename string);
+var getNewestFile = function(dir, files, callback) {
+	if (!callback) throw new Error("Missing callback");
+	if (!files || (files && files.length === 0)) {
+		callback(new Error("No files"));
+		return;
+	}
+	// we are appending the file name to the directory, without the
+	// "/" we would get paths like /folderfile.txt instead of /folder/file.txt
+	if(dir[dir.length-1] != "/"){
+		dir += "/";
+	}
+	var newest = { file: files[0] };
+	var checked = 0;
+	fs.stat(dir + newest.file, function(err, stats) {
+		if(err) {
+			callback(err);
+		} else {
+			newest.mtime = stats.mtime;
+			for (var i = 0; i < files.length; i++) {
+				var file = files[i];
+				(function(file) {
+					fs.stat(file, function(err, stats) {
+						++checked;
+						if (stats.mtime.getTime() > newest.mtime.getTime()) {
+							newest = { file : file, mtime : stats.mtime };
+						}
+						if (checked == files.length) {
+							callback(undefined,newest);
+						}
+					});
+				})(dir + file);
+			}
+		}
+	});
+}
+
+// get names of all directories in directory
+var getDirectoriesSync = function(srcpath) {
+	return fs.readdirSync(srcpath).filter(function (file) {
+		return fs.statSync(path.join(srcpath, file)).isDirectory();
+	});
+}
+// get names of all files in a directory
+var getFileNamesSync = function(srcpath) {
+	return fs.readdirSync(srcpath).filter(function (file) {
+		return !fs.statSync(path.join(srcpath, file)).isDirectory();
+	});
+}
+// does what it says on the tin
+var deleteFolderRecursiveSync = function(path) {
+	if (fs.existsSync(path)) {
+		fs.readdirSync(path).forEach(function (file, index) {
+			var curPath = path + "/" + file;
+			if (fs.lstatSync(curPath).isDirectory()) { // recurse
+				deleteFolderRecursiveSync(curPath);
+			} else { // delete file
+				fs.unlinkSync(curPath);
+			}
+		});
+		fs.rmdirSync(path);
+		return true;
+	} else {
+		return false;
+	}
+};
+var deleteFolderRecursive = function(path){
+	return new Promise((resolve, reject) => {
+		fs.readdir(path, (err, files) => {
+			if(err){
+				reject(err);
+			} else {
+				let thingsToDelete = files.length;
+				files.forEach(file => {
+					let curPath = path + "/" + file;
+					fs.stat(curPath, (err, stat) => {
+						if(!err){
+							if(stat.isDirectory()){
+								// recurse
+								deleteFolderRecursive(curPath).then(() => {
+									whenFilesDeleted();
+								}).catch(e => console.log(e));
+							} else {
+								fs.unlink(curPath, () => {
+									// console.log("Deleted "+curPath);
+									whenFilesDeleted();
+								});
+							}
+						} else {
+							resolve(false);
+						}
+					});
+				});
+				whenFilesDeleted();
+				function whenFilesDeleted(){
+					if(!thingsToDelete--){// var-- instead of --var because we are calling the function once too much and need the delay
+						fs.rmdir(path, () => {
+							resolve();
+							// console.log("Deleted "+path);
+						});
+					}
+				}
+			}
+		});
+	});
+}
+
+module.exports = {
+	getNewestFile,
+	getDirectoriesSync,
+	deleteFolderRecursiveSync,
+	deleteFolderRecursive,
+	getFileNamesSync,
+}

node_modules/_app/fileOps/fileOps.spec.js

@@ -0,0 +1,135 @@
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+
+const fileOps = require('./fileOps');
+
+// create folders for testing
+function setupTestingEnv(){
+	if (!fs.existsSync(path.resolve(__dirname, "database"))){
+		fs.mkdirSync(path.resolve(__dirname, "database"));
+	}
+	if (!fs.existsSync(path.resolve(__dirname, "test"))){
+		fs.mkdirSync(path.resolve(__dirname, "test"));
+	}
+	if (!fs.existsSync(path.resolve(__dirname, "test/folder"))){
+		fs.mkdirSync(path.resolve(__dirname, "test/folder"));
+	}
+	if (!fs.existsSync(path.resolve(__dirname, "test/another folder"))){
+		fs.mkdirSync(path.resolve(__dirname, "test/another folder"));
+	}
+	if (!fs.existsSync(path.resolve(__dirname, "test/file.txt"))){
+		fs.writeFileSync(path.resolve(__dirname, "test/file.txt"), "contents");
+	}
+	if (!fs.existsSync(path.resolve(__dirname, "test/another file.txt"))){
+		fs.writeFileSync(path.resolve(__dirname, "test/another file.txt"), "more contents");
+	}
+	// we need this xfile to test a branch in fileOps.getNewestFile()s propagation
+	if (!fs.existsSync(path.resolve(__dirname, "test/xfile.txt"))){
+		fs.writeFileSync(path.resolve(__dirname, "test/xfile.txt"), "contents");
+	}
+}
+setupTestingEnv();
+setupTestingEnv(); // run twice to get branch coverage
+describe("fileOps.js", function(){
+	describe("fileOps.getDirectoriesSync()", function(){
+		it("gets an array of directory names from a path", function(){
+			let directories = fileOps.getDirectoriesSync(path.resolve(__dirname, "test"));
+			
+			// because there are no arrays for some reason
+			assert(typeof directories == "object");
+			
+			// they are sorted alphabetically because thats the way it is
+			assert(directories[0] == "another folder" && directories[1] == "folder");
+		});
+		it("does not return any filenames", function(){
+			let directories = fileOps.getDirectoriesSync(path.resolve(__dirname, "test"));
+			
+			// this is a function to return directories, not files. So yeah.
+			assert(!directories.includes("file.txt") && !directories.includes("another file.txt"));
+		});
+		it("throws when lacking first argument", function(){
+			assert.throws(function(){
+				let files = fileOps.getDirectoriesSync();
+			}, Error);
+		});
+	});
+	describe("fileOps.getFileNamesSync(path)", function(){
+		it("gets names of files in directory", function(){
+			let files = fileOps.getFileNamesSync(path.resolve(__dirname, "test"));
+			assert(files.length > 0);
+			assert(files.includes("file.txt") && files.includes("another file.txt"));
+		});
+		it("throws when lacking first argument", function(){
+			assert.throws(function(){
+				let files = fileOps.getFileNamesSync();
+			}, Error);
+		});
+	});
+	describe("fileOps.getNewestFile()", function(){
+		it("gets the newest file in a directory async", function(done){
+			fileOps.getNewestFile(path.resolve(__dirname, "test/"), fileOps.getFileNamesSync(path.resolve(__dirname, "test")), function(err, newest){
+				assert(newest && typeof newest.file == "string");
+				done();
+			});
+		});
+		it("throws if callback is missing", function(){
+			assert.throws(function(){
+				fileOps.getNewestFile("test", fileOps.getFileNamesSync(path.resolve(__dirname, "test")));
+			}, Error);
+		});
+		it("executes callback(err) if no files are provided", function(done){
+			fileOps.getNewestFile(path.resolve(__dirname, "test"), [], function(err, newest){
+				assert(err && typeof err == "object");
+				done();
+			});
+		});
+		it("executes callback(err) if launched without a directory", function(done){
+			fileOps.getNewestFile("", fileOps.getFileNamesSync(path.resolve(__dirname, "test")), function(err, newest){
+				assert(err);
+				done();
+			});
+		});
+		it("executes callback(err) when you do stupid shit", function(done){
+			fileOps.getNewestFile({thisWontWork: "but not crash either"}, {lolz:"yeah..."}, function(err, newest){
+				assert(err);
+				// ENOENT: no such file or directory, stat 'C:\**\factorioClusterio\lib\test\undefined'
+				done();
+			});
+		});
+	});
+	describe("fileOps.deleteFolderRecursiveSync(path)", function(){
+		it("deletes a folder and all files and folders in it", function(){
+			let x = fileOps.deleteFolderRecursiveSync(path.resolve(__dirname, "test"));
+			assert.throws(function(){
+				fs.statSync(path.resolve(__dirname, "test"));
+			}, Error);
+			assert(x);
+			// give it some extra time because its sometimes very slow
+		}).timeout(5000);
+		it("returns false if you give it an invalid path", function(){
+			let x = fileOps.deleteFolderRecursiveSync("This isn't a real path");
+			assert(!x);
+		});
+	});
+	describe("fileOps.deleteFolderRecursive(path)", function(){
+		it("deletes a folder and all files and folders in it, just like sync version", async function(){
+			setupTestingEnv();
+			assert(fs.statSync(path.resolve(__dirname, "test")));
+			let x = await fileOps.deleteFolderRecursive(path.resolve(__dirname, "test"));
+			assert.throws(function(){
+				fs.statSync(path.resolve(__dirname, "test"));
+			}, Error);
+			assert(x === undefined, "Promise version of this function does not have a return value upon success");
+			return true;
+		}).timeout(5000);
+		it("throws like a promise does if you give it an invalid path", async function(){
+			let x = await fileOps.deleteFolderRecursive("Look this path is fake!")
+			.catch(e => {
+				assert(e);
+				assert.equal(e.code, "ENOENT");
+				return true;
+			});
+		});
+	});
+});