You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Improve install docs: Linux clarity, Windows from-source instructions
- Fix typo in AV warning ("wee build")
- Add pointer from AV warning to the new "Running from source" notes
- Add "Running from source" (run.bat) notes to Windows zip and Steam sections
- Rewrite Linux install steps to match macOS in explicitness: specific
commands, venv steps, no ambiguous build_main.py mention
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+12-6Lines changed: 12 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ We have had players successfully build post-endgame bases with it in a reasonabl
7
7
8
8
The mod tries to support multiplayer but game limitations mean that your experience will be laggy and kind of terrible. We cannot do anything about this. We also have limited ability to do anything about bugs, because that would require two mod developers playing at the same time.
9
9
10
-
On Windows our launcher is currently flagged as a virus. We are working on fixing this but there is not much we can do. You may need to add your Factorio folder as an exception in Windows Defender. It moves the mouse and does a bunch of things that look like a virus to antiviruses as part of interacting with the game. If you run the launcher from source this is not a problem. Please note that wee build the launcher from source in a GitHub Actions runner, so we are confident that our build is clean.
10
+
On Windows our launcher is currently flagged as a virus. We are working on fixing this but there is not much we can do. You may need to add your Factorio folder as an exception in Windows Defender. It moves the mouse and does a bunch of things that look like a virus to antiviruses as part of interacting with the game. Please note that we build the launcher from source in a GitHub Actions runner, so we are confident that our build is clean. If your antivirus will not allow an exception, see the **Running from source** note in the Windows install sections below.
11
11
12
12
Finally, we do not yet support Space Age. If you bought Space Age, you need to disable quality, elevated rails, and Space Age in the launcher's mod menu.
13
13
@@ -71,6 +71,8 @@ To install a mod release, follow the instructions below, depending on the versio
71
71
1. The game is ready to play from the launcher when the main menu appears.
72
72
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
73
73
74
+
**Running from source:** If your antivirus blocks the launcher, you can run it directly from Python instead. Install [git](https://git-scm.com), then run `git clone --recurse-submodules https://github.com/Factorio-Access/Factorio-Access-Launcher` and place the cloned folder where you would have placed `launcher.exe`. Double-click `run.bat` to set up and start the launcher. On subsequent runs, double-click `run.bat` again.
75
+
74
76
## Windows Steam version or regular Windows version: Mod release install
75
77
76
78
1. Download the latest launcher from here: https://github.com/factorio-access/factorio-access-launcher/releases
@@ -88,14 +90,18 @@ To install a mod release, follow the instructions below, depending on the versio
88
90
1. The game is ready to play from the launcher when the main menu appears.
89
91
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
90
92
93
+
**Running from source:** If your antivirus blocks the launcher, you can run it directly from Python instead. Install [git](https://git-scm.com), then run `git clone --recurse-submodules https://github.com/Factorio-Access/Factorio-Access-Launcher` and place the cloned folder where you would have placed `launcher.exe` (in `%AppData%/Factorio`). Double-click `run.bat` to set up and start the launcher. On subsequent runs, double-click `run.bat` again. You will still need to configure Steam launch options, but point them at `run.bat` instead of `launcher.exe`.
94
+
91
95
## Linux Version: Mod install and running via Python scripts
92
96
93
-
1. Install speechd and python 3 through your distribution. Note that Instructions vary by distribution.
94
-
1. Use Git or GitHub CLI to get the launcher from the [Factorio-Access-Launcher repository](https://github.com/Factorio-Access/Factorio-Access-Launcher).
95
-
1. CD into the folder.
96
-
1. If you want to use a virtual python environment, or an executable, run build_main.py. If not, run pip to install requirements.txt by: `pip install -r requirements.txt`
97
-
1. Run the executable or main.py
97
+
1. Install git, Python 3, and the speech daemon through your distribution. For example on Debian or Ubuntu: `sudo apt install git python3 python3-pip speech-dispatcher`
98
+
1. Clone the launcher repository with its submodules: `git clone --recurse-submodules https://github.com/Factorio-Access/Factorio-Access-Launcher`
99
+
1. Go into the newly created folder: `cd Factorio-Access-Launcher`
100
+
1. Create a virtual environment: `python3 -m venv venv`
101
+
1. Install the required packages: `./venv/bin/pip install -r requirements.txt`
102
+
1. Run the launcher: `./venv/bin/python main.py`
98
103
1. If it complains it can't find your Factorio installation then add the path to the Factorio executable as an argument when launching.
104
+
1. Any time you want to run the launcher again, go to the same folder and run: `./venv/bin/python main.py`
99
105
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
100
106
101
107
## MacOS: Mod install and running via Python scripts
0 commit comments