Skip to content

Commit 0eae5c2

Browse files
LevFendiclaude
andcommitted
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>
1 parent 3690897 commit 0eae5c2

1 file changed

Lines changed: 12 additions & 6 deletions

File tree

‎README.md‎

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ We have had players successfully build post-endgame bases with it in a reasonabl
77

88
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.
99

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.
1111

1212
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.
1313

@@ -71,6 +71,8 @@ To install a mod release, follow the instructions below, depending on the versio
7171
1. The game is ready to play from the launcher when the main menu appears.
7272
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
7373

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+
7476
## Windows Steam version or regular Windows version: Mod release install
7577

7678
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
8890
1. The game is ready to play from the launcher when the main menu appears.
8991
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
9092

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+
9195
## Linux Version: Mod install and running via Python scripts
9296

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`
98103
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`
99105
1. If you bought Space Age, go into the launcher's mod menu and disable elevated rails, quality, and Space Age.
100106

101107
## MacOS: Mod install and running via Python scripts

0 commit comments

Comments
 (0)