2021-05-10 20:42:11 +00:00
|
|
|
# Factorio Randomizer Setup Guide
|
|
|
|
|
|
|
|
|
|
## Required Software
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
##### Players
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
- Factorio: [Factorio Official Website](https://factorio.com)
|
|
|
|
|
- Needed by Players and Hosts
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
##### Server Hosts
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
- Factorio: [Factorio Official Website](https://factorio.com)
|
|
|
|
|
- Needed by Players and Hosts
|
|
|
|
|
- Archipelago: [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases)
|
|
|
|
|
- Needed by Hosts
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
## Create a Config (.yaml) File
|
|
|
|
|
|
|
|
|
|
### What is a config file and why do I need one?
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
Your config file contains a set of configuration options which provide the generator with information about how it
|
|
|
|
|
should generate your game. Each player of a multiworld will provide their own config file. This setup allows each player
|
|
|
|
|
to enjoy an experience customized for their taste, and different players in the same multiworld can all have different
|
|
|
|
|
options.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
### Where do I get a config file?
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
The Player Settings page on the website allows you to configure your personal settings and export a config file from
|
|
|
|
|
them. Factorio player settings page: [Factorio Settings Page](/games/Factorio/player-settings)
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
### Verifying your config file
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
If you would like to validate your config file to make sure it works, you may do so on the YAML Validator page. YAML
|
|
|
|
|
Validator page: [Yaml Validation Page](/mysterycheck)
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
## Connecting to Someone Else's Factorio Game
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
Connecting to someone else's game is the simplest way to play Factorio with Archipelago. It allows multiple people to
|
|
|
|
|
play in a single world, all contributing to the completion of the seed.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
1. Acquire the Archipelago mod for this seed. It should be named `AP_*.zip`, where `*` is the seed number.
|
|
|
|
|
2. Copy the mod file into your Factorio `mods` folder, which by default is located at:
|
2021-12-31 19:12:22 +00:00
|
|
|
`C:\Users\<YourUserName>\AppData\Roaming\Factorio\mods`
|
2021-12-01 01:00:05 +00:00
|
|
|
3. Get the server address from the person hosting the game you are joining.
|
2021-10-26 01:32:58 +00:00
|
|
|
4. Launch Factorio
|
|
|
|
|
5. Click on "Multiplayer" in the main menu
|
|
|
|
|
6. Click on "Connect to address"
|
|
|
|
|
7. Enter the address into this box
|
|
|
|
|
8. Click "Connect"
|
|
|
|
|
|
|
|
|
|
## Prepare to Host Your Own Factorio Game
|
|
|
|
|
|
|
|
|
|
### Defining Some Terms
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
In Archipelago, multiple Factorio worlds may be played simultaneously. Each of these worlds must be hosted by a Factorio
|
|
|
|
|
server, which is connected to the Archipelago Server via middleware.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
This guide uses the following terms to refer to the software:
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
- **Factorio Client** - The Factorio instance which will be used to play the game.
|
2021-12-31 19:12:22 +00:00
|
|
|
- **Factorio Server** - The Factorio instance which will be used to host the Factorio world. Any number of Factorio
|
|
|
|
|
Clients may connect to this server.
|
2021-10-26 01:32:58 +00:00
|
|
|
- **Archipelago Client** - The middleware software used to connect the Factorio Server to the Archipelago Server.
|
|
|
|
|
- **Archipelago Server** - The central Archipelago server, which connects all games to each other.
|
|
|
|
|
|
|
|
|
|
### What a Playable State Looks Like
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
- An Archipelago Server
|
|
|
|
|
- The generated Factorio Mod, created as a result of running `ArchipelagoGenerate.exe`
|
|
|
|
|
- One running instance of `ArchipelagoFactorioClient.exe` (the Archipelago Client) per Factorio world
|
|
|
|
|
- A running modded Factorio Server, which should have been started by the Archipelago Client automatically
|
|
|
|
|
- A running modded Factorio Client
|
2021-05-10 20:42:11 +00:00
|
|
|
|
|
|
|
|
### Dedicated Server Setup
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
To play Factorio with Archipelago, a dedicated server setup is required. This dedicated Factorio Server must be
|
|
|
|
|
installed separately from your main Factorio Client installation. The recommended way to install two instances of
|
|
|
|
|
Factorio on your computer is to download the Factorio installer file directly from
|
|
|
|
|
factorio.com: [Factorio Official Website Download Page](https://factorio.com/download).
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
#### If you purchased Factorio on Steam, GOG, etc.
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
You can register your copy of Factorio on factorio.com: [Factorio Official Website](https://factorio.com/). You will be
|
|
|
|
|
required to create an account, if you have not done so already. As part of that process, you will be able to enter your
|
|
|
|
|
Factorio product code. This will allow you to download the game directly from their website.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
#### Download the Standalone Version
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
It is recommended to download the standalone version of Factorio for use as a dedicated server. Doing so prevents any
|
|
|
|
|
potential conflicts with your currently-installed version of Factorio. Download the file by clicking on the button
|
2022-06-27 01:52:24 +00:00
|
|
|
appropriate to your operating system, and extract the folder to a convenient location. The best place to do this for
|
|
|
|
|
Archipelago is to place the extracted game folder into the `Archipelago` directory and rename it to just be "Factorio".
|
|
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
|
2022-05-11 18:05:53 +00:00
|
|
|
|
2021-12-01 01:00:05 +00:00
|
|
|
|
2021-12-31 19:12:22 +00:00
|
|
|
Next, you should launch your Factorio Server by running `factorio.exe`, which is located at: `bin/x64/factorio.exe`. You
|
|
|
|
|
will be asked to log in to your Factorio account using the same credentials you used on Factorio's website. After you
|
|
|
|
|
have logged in, you may close the game.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
#### Configure your Archipelago Installation
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2022-06-27 01:52:24 +00:00
|
|
|
If you did not place the Factorio standalone in your Archipelago installation, you must modify your `host.yaml` file
|
|
|
|
|
inside your Archipelago installation directory so that it points to your standalone Factorio executable. Here is an
|
|
|
|
|
example of the appropriate setup, note the double `\\` are required:
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2021-07-31 14:02:38 +00:00
|
|
|
```yaml
|
|
|
|
|
factorio_options:
|
2022-06-27 01:52:24 +00:00
|
|
|
executable: C:\\path\\to\\factorio\\bin\\x64\\factorio"
|
2021-07-31 14:02:38 +00:00
|
|
|
```
|
2021-10-16 17:40:27 +00:00
|
|
|
|
2021-12-01 01:00:05 +00:00
|
|
|
This allows you to host your own Factorio game.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
2021-12-01 01:00:05 +00:00
|
|
|
## Hosting Your Own Factorio Game
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
1. Obtain the Factorio mod for this Archipelago seed. It should be named `AP_*.zip`, where `*` is the seed number.
|
|
|
|
|
2. Install the mod into your Factorio Server by copying the zip file into the `mods` folder.
|
|
|
|
|
3. Install the mod into your Factorio Client by copying the zip file into the `mods` folder, which is likely located
|
2021-12-31 19:12:22 +00:00
|
|
|
at `C:\Users\YourName\AppData\Roaming\Factorio\mods`.
|
2021-10-26 01:32:58 +00:00
|
|
|
4. Obtain the Archipelago Server address from the website's host room, or from the server host.
|
2022-10-21 00:28:38 +00:00
|
|
|
5. Run your Archipelago Client, which is named `ArchipelagoFactorioClient.exe`. This was installed along with
|
2021-12-31 19:12:22 +00:00
|
|
|
Archipelago if you chose to include it during the installation process.
|
2021-10-26 01:32:58 +00:00
|
|
|
6. Enter `/connect [server-address]` into the input box at the bottom of the Archipelago Client and press "Enter"
|
2021-12-01 01:00:05 +00:00
|
|
|
|
2022-05-11 18:05:53 +00:00
|
|
|
|
2021-12-01 01:00:05 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
7. Launch your Factorio Client
|
|
|
|
|
8. Click on "Multiplayer" in the main menu
|
|
|
|
|
9. Click on "Connect to address"
|
|
|
|
|
10. Enter `localhost` into the server address box
|
|
|
|
|
11. Click "Connect"
|
|
|
|
|
|
2021-12-31 19:12:22 +00:00
|
|
|
For additional client features, issue the `/help` command in the Archipelago Client. Once connected to the AP server,
|
|
|
|
|
you can also issue the `!help` command to learn about additional commands like `!hint`.
|
2021-11-23 07:25:34 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
## Allowing Other People to Join Your Game
|
2021-12-31 19:12:22 +00:00
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
1. Ensure your Archipelago Client is running.
|
|
|
|
|
2. Ensure port `34197` is forwarded to the computer running the Archipelago Client.
|
2021-12-20 02:21:16 +00:00
|
|
|
3. Obtain your IP address by visiting whatismyip.com: [WhatIsMyIP Website](https://whatismyip.com/).
|
2021-10-26 01:32:58 +00:00
|
|
|
4. Provide your IP address to anyone you want to join your game, and have them follow the steps for
|
2021-12-31 19:12:22 +00:00
|
|
|
"Connecting to Someone Else's Factorio Game" above.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
|
|
|
|
## Troubleshooting
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
In case any problems should occur, the Archipelago Client will create a file `FactorioClient.txt` in the `/logs`. The
|
|
|
|
|
contents of this file may help you troubleshoot an issue on your own and is vital for requesting help from other people
|
|
|
|
|
in Archipelago.
|
2021-10-26 01:32:58 +00:00
|
|
|
|
2022-06-27 01:52:24 +00:00
|
|
|
## Commands in game
|
|
|
|
|
|
|
|
|
|
Once you have connected to the server successfully using the Archipelago Factorio Client you should see a message
|
|
|
|
|
stating you can get help using Archipelago commands by typing `!help`. Commands cannot currently be sent from within
|
|
|
|
|
the Factorio session, but you can send them from the Archipelago Factorio Client. For more information about the commands
|
|
|
|
|
you can use see the [commands guide](/tutorial/Archipelago/commands/en).
|
|
|
|
|
|
2021-10-26 01:32:58 +00:00
|
|
|
## Additional Resources
|
2021-12-31 19:12:22 +00:00
|
|
|
|
|
|
|
|
- Alternate Tutorial by
|
|
|
|
|
Umenen: [Factorio (Steam) Archipelago Setup Guide for Windows](https://docs.google.com/document/d/1yZPAaXB-QcetD8FJsmsFrenAHO5V6Y2ctMAyIoT9jS4)
|
2021-12-20 02:21:16 +00:00
|
|
|
- Factorio Speedrun Guide: [Factorio Speedrun Guide by Nefrums](https://www.youtube.com/watch?v=ExLrmK1c7tA)
|
|
|
|
|
- Factorio Wiki: [Factorio Official Wiki](https://wiki.factorio.com/)
|
