Satisfactory: Add New Game (#5190)

* Added Satisfactory to latest master

* Fixed hard drive from containing the mam + incremented default value for harddrive progression

* Apply cherry pick of 3076259

* Apply cherry pick of 6114a55

* Clarify Point goal behavior (https://github.com/Jarno458/SatisfactoryArchipelagoMod/issues/98)

* Update Setup guide and info page

* Add links to Gifting and Energy Link compatible games. Add info on Hard Drive behavior

* Fix typos

* Update hard drive behavior description

* Hopefully fixed the mam from getting placed behind harddrives

* Add 1 "Bundle: Solid Biofuel" to default starting items (for later chainsaw usage or early power gen)

* Add info/warning about save setup failure bug

* Add notes about dedicated server setup

* Fixes: `TypeError: 'set' object is not subscriptable`

random.choice does not work over set objects, cast to a list to allow 'trap_selection_override'

* progrees i think

* Fixed some bugs

* Progress commmit incase my pc crashes

* progress i think as test passed

* I guess test pass, game still unbeatable tho

* its generating

* Some refactorings

* Fixed generation with different elevator tiers

* Remove debug statement

* Fix this link.

* Implemented abstract base classes + some fixes

* Implemented many many new options

* Yay more stuff

* Fixed renaming of filters

* Added 1.1 stuffs

* Added options groups and presets

* Fixes after variable renmame

* Added recipy groups for easyer hinting

* Implemented random Tier 0

* Updated slot_data

* Latest update for 1.1

* Applied cheaper building costs of assembler and foundry

* Implemented exploration cost in slot_data

* Fixed exposing option type

* Add goal time estimates

* Trap info

* Added support for Universal Tracker
Put more things in the never exclude pool for a more familiar gameplay

* Added iron ore to build hub

* Added Dark Matter Crystals

* Added Single Dark Matter Crystals

* Fixed typo in options preset

* Update setup directions and info

* Options formatting fixes, lower minimum ExplorationCollectableCount, add new Explorer starting inventory items preset

* Fixed incorrect description on the options

* Reduce Portable Miner and Reinforced Iron Plate quantities in "Skip Tutorial Inspired" starting preset

* Fixed options pickling error

* Reworked logic to no longer include Single: items as filler
Reworked logic for more performance
Reworked logic to always put useful equipment in pool

* Fixed Itemlinks
Removed space elevator parts from fillers
Removed more AWESOME shop purchaseables from minimal item pool
Added all equipment to minimal item pool
Removed non fissile and fertile uranium from minimal item pool
Removed portal from minimal item pool
Removed Ionized fuel from minimal item pool
Removed recipes for Hoverpack and Turbo Rifle Ammo from minimal item pool
Lowered the chance for rolling steel on randomized starter recipes

* Fixed hub milestone item leaking to into wrong milestones

* Fixed unlock cost of geothermal generator

* Fixed itemlinks again

* Add troubleshooting note about hoverpacks

* Add starting inventory bundle delivery info

* Added hint generation at generation time
Harddrive locations now go from 1-100 rather then 0-99

* Update __init__.py

Fixed mistake

* Cleaned docs to be better suited to get verified

* Update CODEOWNERS

Added Satisfactory

* Update README.md

Added Satisfactory

* Restructure and expand setup page to instruct both players and hosts

* Add terms entry for Archipelago mod

* Fixed generation of traps

* Added Robb as code owner

* Restore tests to original state

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix additional typos from code review

* Implemented fix for itterating enum flags on python 3.10

* Update en_Satisfactory.md

* Update setup_en.md

* Apply suggestions from code review

Co-authored-by: Scipio Wright <scipiowright@gmail.com>

* more world > multiworld

* Clarify universal tracker behavior

* Fix typos

* Info on smart hinting system

* Move list of additional mods to a page on the mod GitHub

* Restore revamped setup guide that other commits  overwrote
Originally from be26511205, d8bd1aaf04

* Removed bundle of ficsit coupons from the from the item pool
added estimated completion times to space elevator option description

* Apply suggestions from code review

Co-authored-by: Scipio Wright <scipiowright@gmail.com>

* Wording

* Fix typo

* Update with changes from ToBeVerified branch

* Update note about gameplay options

* Update note about gameplay options

* Improved universal tracker handling

* Improved universal tracker + modernized code a bit

* Fixed bugs that where re-introduced

* Added Recipe: Excited Photonic Matter

* Removed python 3.9 workaround

* Fixed

* Apply suggestions from code review

Co-authored-by: Scipio Wright <scipiowright@gmail.com>

* Streamlined handle craftable logic by using itterable rather then tuple
Removed dict.keys as the dict itzelf already enumerates over keys

* Updated option description

* Fixed typing

* More info on goal completion conditions

* More info on goal completion conditions (093fe38b6e)

* Apply suggestions from code review

Co-authored-by: Silvris <58583688+Silvris@users.noreply.github.com>

* Implemented review results

* PEP8 stuff

* More PEP8

* Rename ElevatorTier->ElevatorPhase and related for clarity and consistency.
Untested

* speedups part1

* speedsups on part rules

* Fix formatting

* fix `Elevator Tier #` string literals missed in rename

* Remove unused/duplicate imports + organize imports, `== None` to `is None`

* Fixed after merge

* Updated values + removed TODO

* PEPed up the code

* Small refactorings

* Updated name slot data to phase

* Fix hint creation

* Clarify wording of elevator goal

* Review result

* Fixed minor typo in option

* Update option time estimates

---------

Co-authored-by: Rob B <computerguy440+gh@gmail.com>
Co-authored-by: ProverbialPennance <36955346+ProverbialPennance@users.noreply.github.com>
Co-authored-by: Joe Amenta <airbreather@linux.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Scipio Wright <scipiowright@gmail.com>
Co-authored-by: Silvris <58583688+Silvris@users.noreply.github.com>
Co-authored-by: NewSoupVi <57900059+NewSoupVi@users.noreply.github.com>
This commit is contained in:
Jarno
2025-12-19 14:48:03 +01:00
committed by GitHub
parent 863f161466
commit ebbdd7bfda
14 changed files with 4438 additions and 0 deletions
+208
View File
@@ -0,0 +1,208 @@
# Satisfactory
<!-- Spellchecker config - cspell:ignore FICSIT Nobelisk Zoop -->
## Where is the settings page?
The [player settings page for this game](../player-options)
contains all the options you need to configure and export a config file.
## What does randomization do to this game?
In Satisfactory, the HUB Milestones and MAM Research Nodes are shuffled,
causing technologies to be obtained in a non-standard order.
Hard Drive scanning results also contain Archipelago items,
meaning alternate recipes could now become part of your required progression path.
There are also a few new purchases in the AWESOME Shop.
The materials required for constructing Assemblers and Foundries is altered to increase early game recipe variety.
## What is the goal of Satisfactory?
The player can choose from a number of goals using their YAML settings:
- Complete the selected number of **[Space Elevator](https://satisfactory.wiki.gg/wiki/Space_Elevator) Phases**.
- The goal completes upon submitting your selected Space Elevator Phase. Any other progression you may have access to (HUB, MAM, AWESOME Shop) is not required for goal completion.
- Selecting Phase 5 is equivalent to beating the vanilla game by launching Project Assembly.
- Expect Phase 1 to take ~3 hours to finish, Phase 2 to take ~8 hours, Phase 3 to take ~2 days, Phase 4 to take ~1 week, and Phase 5 to take ~1.5 weeks on default settings.
- Supply items to the [AWESOME Sink](https://satisfactory.wiki.gg/wiki/AWESOME_Sink) **totalling a configurable amount of points** to finish.
- The goal is tracked in the background and completes once the points total is reached.
- Your selected point total can be reviewed in the AWESOME Sink graph.
- Time to finish this goal varies significantly depending on your goal level and Free Sample settings, and can technically be reached by AFKing at any point after you unlock the Sink.
- Supply items to the [AWESOME Sink](https://satisfactory.wiki.gg/wiki/AWESOME_Sink) **maintaining a configurable level of points per minute** to finish.
- The goal is tracked in the background and completes once you have maintained the selected sink points rate for 10 minutes.
- This goal requires establishing a more robust factory since it can't be AFKed like the points total or elevator goals.
- Your selected points rate can be reviewed in the AWESOME Sink graph.
- Time to finish this goal varies significantly depending on your Space Elevator packages in logic and the resource sink point improvement ratios of the recipes you have access to.
- **Explore the world to gather exotic items** and submit them in the HUB.
- The goal completes upon submitting the HUB milestone.
- There is no partial progress system for this goal - combining it with another goal is recommended.
- Time to finish this goal varies significantly depending on your map knowledge, equipment, and movement skills.
You can also configure whether completing your slot requires *any one* goal or *all* goals to be met.
## What Satisfactory items can appear in other players' worlds?
Satisfactory's technologies are removed from the HUB, MAM, and Hard Drives and placed into other players' worlds.
When those technologies are found, they are sent back to Satisfactory
along with, optionally, free samples of those technologies.
Other players' worlds may have Resource Bundles of building materials, equipment, ammunition, or FICSIT Coupons.
They may also contain Traps.
## What is a Free Sample?
A free sample is a package of items in Satisfactory granted in addition to a technology received from another world.
For equipment and component crafting recipes, this is the output product.
For buildings, this is the ingredients for the building.
For example, receiving the [Nobelisk Detonator MAM Node](https://satisfactory.wiki.gg/wiki/Nobelisk_Detonator#Unlocking)
would give you one Nobelisk Detonator and 50 Nobelisk,
receiving the [Jump Pads Milestone](https://satisfactory.wiki.gg/wiki/Milestones#Tier_2)
would give you the ingredients to construct 5 Jump Pads and 5 U-Jelly Landing Pads, etc.
In Satisfactory multiplayer, each Satisfactory player gets a copy of the sample.
Certain recipes and items, like Somersloops, are always excluded from samples.
You can separately configure how many samples to receive for buildings, equipment, and crafting components
in your player settings.
## What is a Resource Bundle?
A Resource Bundle is a package of items received as a check from another world.
All resource bundle type items are named either `Single: <item name>` or `Bundle: <item name>` to distinguish them from component recipes.
They must be collected by constructing an Archipelago Portal.
For example, `Single: Jetpack` would contain a single jetpack, and `Bundle: Biomass` would contain one stack of biomass.
Any Resource Bundle type items added to your starting inventory will be delivered to your player inventory when you initally spawn,
unless they can't fit, in which case they can be collected by building an Archipelago Portal.
## What is a Trap?
Traps are items intended to disrupt the player that replace non-progression filler items.
Satisfactory's traps currently include spawning disruptive creatures or sending inconvenient items to your Archipelago Portal.
The player settings page gives full control over which traps are enabled,
how many traps replace filler items,
as well as some pre-selected groups of themed traps.
A complete list of traps and their effects is intentionally omitted to keep some surprise and mystery.
In the current implementation, the most severe traps could temporarily lock you out of a small area until you have gas/radiation protection.
## What does another world's item look like in Satisfactory?
In Satisfactory, items which need to be sent to other worlds appear in the HUB and MAM as info cards
in a similar manner to the base game's building and recipe unlocks.
Info cards have the Archipelago icon
and are color coded to indicate what Archipelago progression type they are.
Hover over them to read a description, since many Satisfactory UIs (such as the MAM) cut this information off.
![screenshot of HUB with some remote and some local items](https://raw.githubusercontent.com/Jarno458/SatisfactoryArchipelagoMod/main/Docs/localAndRemoteItems.JPG)
Upon successful unlock of the technology, the item will be sent to its home world.
## When the pioneer receives an item, what happens?
When the player receives a technology, it is instantly unlocked and able to be crafted or constructed.
A message will appear in the chat to notify the player,
and if free samples are enabled the player may also receive some items delivered directly to their inventory.
Bundles will instantly be added to the Archipelago Portal network and can be collected at any Archipelago Portal.
## What is EnergyLink?
EnergyLink is an energy storage supported by certain games that is shared across all worlds in a multiworld.
In Satisfactory, if enabled in the player settings, all base-game Power Storage buildings will act as Energy Link interfaces.
They will deposit surplus produced energy and draw energy from the shared storage when needed.
Just like the base game, there is no limit to the discharge/draw rate of one building,
and each Power Storage provides 100 MW of charging throughput.
The shared storage has unlimited capacity, and only a small amount of energy is lost during depositing.
The amount of energy currently in the shared storage is displayed in the Archipelago client
and appears in the Power Storage building UI.
You can find a list of Energy Link compatible games on the
[Archipelago Discord](https://discord.com/channels/731205301247803413/1010929117748809758/1174728119568048130).
## What is the Archipelago Portal?
The Archipelago Portal is a building that serves multiple purposes:
- Collecting received "Resource Bundle"-type items.
- Transfering items within your Satisfactory world to other Portals
- Transfering items between multiple Satisfactory worlds
- Gifting items to other games that support the **Archipelago Gifting** system.
The building requires power to operate.
You can build multiple portals or use faster belts to increase their bandwith.
However, they currently have no filtering capabilities,
so you must deal with this problem when handling their output items.
You can find a list of Gifting compatible games on the
[Archipelago Discord](https://discord.com/channels/731205301247803413/1134306496042258482/1247617772993908891).
## How do Hard Drives work?
All base game Hard Drive contents (alternate recipes) have been moved into the normal Archipelago pool.
Instead, Hard Drives can contain Archipelago items from a dedicated "Hard Drive" pool.
Scanning a drive presents a choice between 2 items from the pool,
and the scan time has been reduced from 10 minutes to 3 seconds.
Unlike the base game, Archipelago hard drive results have no hard progression requirements,
other than access to the MAM itself.
The random contents selection system prefers to pick items earlier in progression,
but keeping unselected Hard Drives in the Hard Drive Library will force later progression items to be presented.
The "Hard Drive Progression Items" option controls how many Hard Drives contain progression items,
the rest are filler or useful.
## Where do I run Archipelago commands?
You can use the game's built-in chat menu.
Check the game's keybinding options to see how to open it.
Run the `/help` command to list all available commands.
Note that Archipelago commands are *not* prefixed with `!` inside of Satisfactory.
Note that multiple base-game bugs affect the chat menu's functionality
and Archipelago can put a lot of info into the chat.
You may wish to launch the Archipelago Text Client and use it to run commands instead of the game's chat.
### Hints
Archipelago's hint system is available within Satisfactory via the `/hint` command.
Most multiworld item names have a prefix to distinguish recipes from bundles.
For example, to hint for the Assembler, run `/hint Building: Assembler`.
Satisfactory's hint system has special behavior for Satisfactory crafting items.
If you hint the unprefixed name of an item with multiple recipes, the system will hint the recipe you are expected to find first in randomizer logic.
For example, hinting `Smart Plating` will return the logically first Smart Plating recipe,
but hinting `Recipe: Smart Plating` or `Recipe: Plastic Smart Plating` will hint that specific recipe for Smart Plating,
which may or may not be in logic.
Exact Archipelago Item names (for hints/starting inventory/etc.) can be found
[on the mod's GitHub](https://github.com/Jarno458/Archipelago/blob/Satisfactory/worlds/satisfactory/Items.py).
## Multiplayer and Dedicated Servers
It is possible to host a Satisfactory Archipelago Slot using the game's built in multiplayer,
allowing other Satisfactory players to join in constructing your factory.
This experience is wonderful - but there are few things not yet properly working for multiplayer:
- Death-links do not kill clients
- Starting inventory for clients is missing
Remember that client players must have the same mods installed as the host player to join,
however, they do not need to configure Archipelago connection settings.
Dedicated server support is only working for Windows at the moment.
## Additional Mods
It is possible to use other Satisfactory mods in tandem with the Archipelago Satisfactory mod.
However, no guarantee is made that they will work correctly,
especially if they affect game progression, recipes, or add unlocks to base-game technologies.
Content added by unaffiliated mods may end up inaccessible based on your chosen slot settings,
for example, its milestones could be in a tier that is after your goal.
You may be able to write patches using [ContentLib](https://ficsit.app/mod/ContentLib)
to adjust other mods to work with your slot settings,
but doing so is out of the scope of this guide.
[The Satisfactory Archipelago mod GitHub](https://github.com/Jarno458/SatisfactoryArchipelagoMod/blob/main/Docs/AdditionalMods.md)
maintains a list of additional mods that have been tested with Archipelago to some extent.
+230
View File
@@ -0,0 +1,230 @@
# Satisfactory Setup Guide
<!-- Spellchecker config - cspell:ignore FICSIT Randomizer Plando -->
## Required Software
- Satisfactory, either
- Steam [Satisfactory (Steam)](https://store.steampowered.com/app/526870/Satisfactory/)
- Epic [Satisfactory (Epic)](https://www.epicgames.com/store/en-US/product/satisfactory/home)
- Satisfactory Mod Manager, either
- Automatically via [smm.ficsit.app](https://smm.ficsit.app/) or
- Manually via [latest stable release on GitHub](https://github.com/satisfactorymodding/SatisfactoryModManager/releases/latest/)
## Overview
This guide walks you through installing the Satisfactory Archipelago mod via the Satisfactory Mod Manager,
configuring an Archipelago slot for Satisfactory,
and playing the game with a Satisfactory client.
### Defining Some Terms
In Archipelago, multiple Satisfactory worlds may be played simultaneously.
Each of these worlds must be hosted by a Satisfactory Host which is connected to the Archipelago Server via the Archipelago mod.
This guide uses the following terms to refer to the software:
- **Archipelago Server** - The central Archipelago server, which connects all games to each other.
- **Archipelago Client** - The desktop application used by many Archipelago games as middleware. Satisfactory does NOT require this software, unless you would like to generate a world locally.
- **Archipelago (Satisfactory) mod** - The Satisfactory mod which implements Archipelago in-game functionality and connectivity.
All Satisfactory hosts and clients must have this mod installed.
- **Satisfactory Host** - The Satisfactory instance which will be used to host the game.
This could be a Satisfactory Client using Singleplayer or host-and-play multiplayer, or it could be a Satisfactory dedicated server.
It must be supplied with the Archipelago Server connection details.
*Any number of Satisfactory Clients may connect to this server.*
- **Satisfactory Client** - The Satisfactory instance (game client) with which additional players can use to connect to the same Satisfactory world.
### What a Playable State Looks Like
- An Archipelago Server
- One running modded Satisfactory Host (game client or dedicated server) per Satisfactory world
- Optionally, additional modded Satisfactory Clients for additional players
### Additional Resources
- Satisfactory Wiki: [Satisfactory Official Wiki](https://satisfactory.wiki.gg/wiki/)
- Satisfactory Modding 'Frequently Asked Questions' page: [Satisfactory Modding Documentation FAQ](https://docs.ficsit.app/satisfactory-modding/latest/faq.html)
- Satisfactory Archipelago Item names (for hints/starting inventory/etc.) can be found [on the mod's github](https://github.com/Jarno458/Archipelago/blob/Satisfactory/worlds/satisfactory/Items.py)
## Preparing to Play Satisfactory Archipelago
### Installing Satisfactory
Purchase and install Satisfactory via one the sources linked [above](#required-software).
Launch the game at least once to ensure that the Mod Manager can detect the game's install location.
Make sure that you are running the correct branch of the game (Release or Experimental) that Archipelago supports.
Learn how to switch branches here:
[Satisfactory Modding Documentation FAQ: Switching Branches](https://docs.ficsit.app/satisfactory-modding/latest/faq.html#_how_do_i_get_the_experimental_or_early_access_branch_of_the_game)
### Installing Satisfactory Mod Manager
The Mod Manager is used to install and manage mods for Satisfactory.
It automatically detects your game install location and automatically handles mod dependencies for you.
Download the Mod Manager here:
[Satisfactory Mod Manager automatic download via ficsit.app](https://smm.ficsit.app/)
Directions for setting and using up the Mod Manager can be found here:
[Satisfactory Modding Documentation FAQ: Installing the Mod Manager](https://docs.ficsit.app/satisfactory-modding/latest/ForUsers/SatisfactoryModManager.html)
### Installing the Archipelago Mod
Once the Mod Manager is installed you can install mods directly in the manager or via the Satisfactory Mod Repository website.
Inside the Mod Manager, search for and install the "Archipelago Randomizer".
Alternatively, visit the mod page: [Archipelago Randomizer mod on ficsit.app](https://ficsit.app/mod/Archipelago).
Once on the mod page, click the "Install" link in the Latest Versions card.
The Mod Manager will install all required dependency mods for you with no additional action required.
As soon as you have the relevant mods installed,
you do not need to launch the game through the Mod Manager -
desktop shortcuts, Steam, Epic. etc. will all launch the game with mods still loaded.
### Installing Additional Mods
You may also wish to install some of the suggested mods mentioned on the
[Archipelago Info page for Satisfactory](/games/Satisfactory/info/en#additional-mods).
If you are playing multiplayer in the same Satisfactory world, all Satisfactory Clients should have the same mods installed.
The Mod Manager's profile import/export feature makes coordinating this easy.
## Connecting to Someone Else's Satisfactory Game
If you are joining someone else's existing Satisfactory game,
your setup process is almost complete.
If your host has sent you a Mod Manager profile containing additional mods,
be sure to install it.
See [Satisfactory Modding Documentation: Profiles](https://docs.ficsit.app/satisfactory-modding/latest/ForUsers/SatisfactoryModManager.html#_profiles) for more information.
To get started playing, connect to the Satisfactory Host using the connection details provided by your host.
([Satisfactory Wiki: Joining a Session](https://satisfactory.wiki.gg/wiki/Multiplayer#Joining_a_session))
See the [Troubleshooting section below](#troubleshooting) if you encounter any issues.
## Hosting Your Own Satisfactory Game
If you're hosting your own Satisfactory game,
you will need to configure an Archipelago world and set up the Satisfactory Host you will be playing on.
### Create a Config (.yaml) File
#### What is a config file and why do I need one?
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.
#### Where do I get a config file?
The Player Settings page on the website
allows you to configure your personal settings and export a config file from them.
Satisfactory player settings page: [Satisfactory Settings Page](/games/Satisfactory/player-settings)
#### Verifying Your Config File
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)
#### Starting Inventory
The Player Settings page provides a few options for controlling what materials you start with
and when certain key technologies are unlocked.
Any Resource Bundle type items added to your starting inventory will be delivered to your player inventory when you initally spawn,
unless they can't fit, in which case they can be collected by building an Archipelago Portal.
Advanced users can use Plando, Weighted Options, and manual yaml editing to further configure the starting inventory.
If you don't wish to use these techniques, consider using Satisfactory's
[Advanced Game Settings (Satisfactory Wiki)](https://satisfactory.wiki.gg/wiki/Advanced_Game_Settings)
to spawn the items you desire.
#### Advanced Configuration
Advanced users can utilize the
[Weighted Options Page](/weighted-options)
and [Plando](/tutorial/Archipelago/plando)
to futher customize their experience.
### Generating and Hosting the Multiworld
Generating a game and hosting an Archipelago server is explained in the [Archipelago Setup Guide](/tutorial/Archipelago/setup/en).
### Creating the Satisfactory World
After you have installed the mods, launch the game via the Mod Manager or via your preferred method.
Once the game has launched, start creating a new game.
Select your starting location and Skip Intro if you wish to skip the tutorial sequence,
then click the "Mod Savegame Settings" button in the bottom right corner of the screen.
Next, enter the connection details in the relevant fields.
- **Server URI**: Archipelago Server URI and port, for example, `archipelago.gg:49236`
- **User Name**: The name you entered as your Player Name when you created your config file. It's also listed in the Name column of your room page.
- **Password**: The password for your Archipelago room, blank if you did not assign or receive one.
Note that the Satisfactory Host/Client does *not* need a copy of your Archipelago config file.
The mod communicates with the Archipelago Server, which already has your config file,
to generate the required content at runtime.
Consider setting the following options in the "Options" > "Gameplay" section, especially because they are per-user and persist across your game saves:
- **Creature Hostility**: `Default` (the game's default). Some of the mod's Traps involve creatures, and having them Passive or Retaliate cheapens the experience.
- **Keep Inventory**: `Keep Everything` or `Keep Equipment` (the game's default). Although dying and dropping items will never lock you out of progression, Free Samples and Bundles means you can easily gain items you can't easily replace.
### Verifying Connection Success
After you have created your new world,
you should see in-game chat messages confirming that you have connected to the Archipelago Server.
You can issue the `/help` command in the game's chat to list available commands, such as `/hint`.
For more information about the commands you can use, see the [Commands Guide](/tutorial/Archipelago/commands/en).
Note that Archipelago commands are not prefixed with `!` inside of Satisfactory.
You may wish to use the Text Client to run commands since Satisfactory's in game chat is not very user friendly.
Check out the HUB to get started!
See the [Troubleshooting section below](#troubleshooting) if you encounter any issues.
### Allowing Other People to Join Your Game
Additional players can join your game using the game's built-in multiplayer functionality.
For more information, see [Satisfactory Wiki: Multiplayer](https://satisfactory.wiki.gg/wiki/Multiplayer).
Have anyone you want to join follow the [Preparing to Play Satisfactory Archipelago](#preparing-to-play-satisfactory-archipelago) section above.
If you're using any additional mods, be sure to export a profile using the Mod Manager for players to import.
[Satisfactory Modding Documentation: Sharing Mod Manager Profiles](https://docs.ficsit.app/satisfactory-modding/latest/ForUsers/SatisfactoryModManager.html#_sharing_profiles)
As mentioned above, it is possible to use a Satisfactory dedicated Server as your Satisfactory Host.
The process for setting up and configuring a dedicated server is out of scope of this guide,
but you can find more information here: [Satisfactory Modding Documentation: Installing Mods on Dedicated Servers](https://docs.ficsit.app/satisfactory-modding/latest/ForUsers/DedicatedServerSetup.html).
It is important to note that the Satisfactory Archipelago mod
is not yet compatible with Linux dedicated servers - only Windows dedicated servers are supported.
### Port Changes
If you are using a public Archipelago Server to host your game,
rooms are automatically put to sleep after a period of inactivity.
The room can be awoken by visiting the room page on the Archipelago website.
This may cause the room's assigned port to change,
requiring you to update your "Mod Savegame Settings" with the new Server URI.
To do this, open your save, go to the pause menu's "Mod Savegame Settings" section,
enter the updated Server URI, then save and reload the game.
## Troubleshooting
- If you are having trouble connecting to the Archipelago Server,
make sure you have entered the correct server address and port.
The server port may have changed if the room went to sleep.
See the [Port Changes section](#port-changes) above for more information.
- If you are having trouble using the Satisfactory Mod Manager, join the [Satisfactory Modding Discord](https://discord.ficsit.app) for support.
- If you encounter a game crash, please report it to us via the [Satisfactory Modding Discord](https://discord.ficsit.app).
Please include the following information:
- What you were doing when the crash occurred.
- If you were a Satisfactory multiplayer host or client, and if you were playing on a dedicated server.
- Use the Mod Manager to generate a debug zip and attach that file.
[Satisfactory Modding Documentation FAQ: Generating a debug zip](https://docs.ficsit.app/satisfactory-modding/latest/faq.html#_where_can_i_find_the_games_log_files)
- Attach your Archipelago config file and spoiler to your report.