General README Improvements

Updated some info and cleaned up verbiage in some places.
This commit is contained in:
Red-Thirten 2022-04-26 12:31:18 -07:00 committed by GitHub
parent 05be24d2b0
commit c1f57dfd74
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,10 +1,7 @@
# Satisfactory # Satisfactory
***Updating your Egg?**: Ensure any existing servers have the latest Startup Command, new Startup Variables are set, **and you reinstall server!*** ***Updating your Egg?**: Ensure any existing servers have the latest Startup Command, new Startup Variables are set, **and you reinstall server!***
___ ___
### Authors / Contributors
## Authors / Contributors
<!-- prettier-ignore-start --> <!-- prettier-ignore-start -->
<!-- markdownlint-disable --> <!-- markdownlint-disable -->
<table> <table>
@ -62,40 +59,33 @@ ___
<!-- prettier-ignore-end --> <!-- prettier-ignore-end -->
___ ___
### Game Description ### Game Description
From Coffee Stain's [Website](https://www.satisfactorygame.com/): From Coffee Stain's [Website](https://www.satisfactorygame.com/):
> Satisfactory is a first-person open-world factory building game with a dash of exploration and combat. Play alone or with friends, explore an alien planet, create multi-story factories, and enter conveyor belt heaven! > Satisfactory is a first-person open-world factory building game with a dash of exploration and combat. Play alone or with friends, explore an alien planet, create multi-story factories, and enter conveyor belt heaven!
___ ___
### Egg Capabilities ### Egg Capabilities
- Configuration of the Server Query, Beacon, and Game ports. - Configuration of the Server Query, Beacon, and Game ports.
- Configurable to automatically check for server updates on start via SteamCMD. Forcing validation is also configurable. - Configurable to automatically check for server updates on start via SteamCMD. Forcing validation is also configurable.
- *[Experimental]* Max player configuration. - *[Experimental]* Max player configuration.
- Autosave amount and interval configuration. - Autosave amount and interval configuration.
- Disable crash reporting if desired. - Disable crash reporting if desired.
- Disable seasonal events if desired.
- ...and other advanced networking and server branch configurable settings. - ...and other advanced networking and server branch configurable settings.
___ ___
### Server Ports ### Server Ports
- Default server ports are listed below, but all three ports can be changed freely (\*some exceptions apply below).
- Default server ports are listed below, but all three ports can be changed freely. - All three ports must be unique; they cannot currently be shared on one port (this may change in the future).
- It is recommended to distance ports of other running Satisfactory servers in Pterodactyl by **increments of 100** (it is currently unknown what the minimum increment is, but an increment of +1 caused cross-server talk in testing). Also, your internal ports **must match** your external ports on your network (ie. you can't have an external port of 7778 forwarded to your 7777 internal port; they must match).
- **Note:** The Primary/Default/Game Port for your server in Pterodactyl will be Satisfactory's `-Port=????` game port, even though clients will **connect with the Query port**. - **Note:** The Primary/Default/Game Port for your server in Pterodactyl will be Satisfactory's `-Port=????` game port, even though clients will **connect with the Query port**.
- It is recommended to distance ports of other running Satisfactory servers in Pterodactyl by **increments of 100** (it is currently unknown what the minimum increment is, but an increment of +1 caused cross-server talk in testing). Also, your internal ports **must match** your external ports on your network (ie. you can't have an external port of 7778 forwarded to your 7777 internal port; they must match).
- ***All three ports are required to be open/allocated for normal server behavior!*** - ***All three ports are required to be open/allocated for normal server behavior!***
| Port | Default (UDP) | | Port | Default (UDP) |
|---------|---------| |---------|---------|
| **Game (Primary Port in Pterodactyl)** | 7777 | | **Game (Primary Port in Pterodactyl)** | 7777 |
| Beacon | 15000 | | Beacon | 15000 |
| Server Query | 15777 | | Server Query (Port clients connect with) | 15777 |
___ ___
### Installation/System Requirements ### Installation/System Requirements
| | Bare Minimum | Recommended | | | Bare Minimum | Recommended |
@ -108,54 +98,40 @@ ___
| Game Ownership | Not required to start. | Required to fully "initialize" (see [Server Initialization](#server-initialization) below) | | Game Ownership | Not required to start. | Required to fully "initialize" (see [Server Initialization](#server-initialization) below) |
___ ___
### Server Initialization ### Server Initialization
For a server to be fully "initialized", a client who owns the game must log into the server to "claim" it and create an administrator password. Then, a new session can be created via the "Create Game" tab in-game, or an existing save file can be uploaded (see [Save Files](#save-files) below). For a server to be fully "initialized", a client who owns the game must log into the server to "claim" it and create an administrator password. Then, a new session can be created via the "Create Game" tab in-game, or an existing save file can be uploaded (see [Save Files](#save-files) below).
Misc. settings listed below can be configured by an admin client via the game's "Server Settings" tab, and are currently **not** set via the Egg: Misc. settings listed below can be configured by an admin client via the game's "Server Settings" tab, and are currently **not** set via the Egg:
- Server Password - Server Password
- Admin Password - Admin Password
- Auto-Save on Player Disconnect - Auto-Save on Player Disconnect
- Pause When No Players Online - Pause When No Players Online
- ...and possibly more as the client's UI is developed further for more configuration options. - ...and possibly more as the client's UI is developed further for more configuration options.
___ ___
### Save Files ### Save Files
An existing save file (including single-player saves) can currently be uploaded to the server via two different methods: An existing save file (including single-player saves) can currently be uploaded to the server via two different methods:
- "Manage Saves" tab via a client in-game (Recommended) - "Manage Saves" tab via an admin client in-game (Recommended)
- Manually via the File Manager or SFTP - Manually via the File Manager or SFTP
Save files are located in this directory: Save files are located in this directory:
```md ```md
/home/container/.config/Epic/FactoryGame/Saved/SaveGames/server /home/container/.config/Epic/FactoryGame/Saved/SaveGames/server
``` ```
*Note: A manually uploaded save will only load if it is (a.) loaded manually via the "Manage Saves" tab in-game, (b.) it is the only save file present, or (c.) its existing session name (not its file name) matches the existing save's session name *and* has the most recent time stamp.* *Note: A manually uploaded save will only load if it is (a.) loaded manually via the "Manage Saves" tab in-game, (b.) it is the only save file present, or (c.) its existing session name (not its file name) matches the existing save's session name *and* has the most recent time stamp.*
***Warning:*** Stopping the server **does not** currently save your game! Ensure it is saved before stopping the server. ***Warning:*** Stopping the server **does not** currently save your game! Ensure it is saved before stopping the server.
If you have forgotten your administrator password or would generally like to reset your server as if it were new, you can delete the following file: If you have forgotten your administrator password or would generally like to reset your server as if it were new, you can delete the following file:
```md ```md
/home/container/.config/Epic/FactoryGame/Saved/SaveGames/ServerSettings.<your_server_query_port> /home/container/.config/Epic/FactoryGame/Saved/SaveGames/ServerSettings.<your_server_query_port>
``` ```
___ ___
### Console Commands ### Console Commands
As of v0.5.1.10, the console tab in the client server manager is the only way to execute commands. Entering commands via Pterodactyl do nothing.
As of v0.5.1.2, the console tab in the client server manager is the only way to execute commands. Entering commands via Pterodactyl do nothing.
[List of known commands can be found via the Wiki.](https://satisfactory.fandom.com/wiki/Dedicated_servers#Console_commands) [List of known commands can be found via the Wiki.](https://satisfactory.fandom.com/wiki/Dedicated_servers#Console_commands)
___ ___
### Known Errors/Warnings
### Errors/Warnings
The following errors or warnings you see in the console can safely be ignored: The following errors or warnings you see in the console can safely be ignored:
```log ```log
@ -163,29 +139,24 @@ steamclient.so: cannot open shared object file: No such file or directory
[S_API] SteamAPI_Init(): Loaded '/home/container/.steam/sdk64/steamclient.so' OK. (First tried local 'steamclient.so') [S_API] SteamAPI_Init(): Loaded '/home/container/.steam/sdk64/steamclient.so' OK. (First tried local 'steamclient.so')
LogSteamShared: Warning: Steam Dedicated Server API failed to initialize. LogSteamShared: Warning: Steam Dedicated Server API failed to initialize.
``` ```
↑ The local file of 'steamclient.so' was attempted to be loaded, but could not because it is not present, causing the warning message. However, the backup `/home/container/.steam/sdk64/steamclient.so` is loaded successfully (this is the correct behavior according to the [Wiki](https://satisfactory.fandom.com/wiki/Dedicated_servers#SteamAPI_Init.28.29:_Sys_LoadModule_filed_to_load:_.2Fpath.2Fto.2F.steam.2Fsdk64.2Fsteamclient.so)).
The local file of 'steamclient.so' was attempted to be loaded, but could not because it is not present, causing the warning message. However, the backup `/home/container/.steam/sdk64/steamclient.so` is loaded successfully (this is the correct behavior according to the [Wiki](https://satisfactory.fandom.com/wiki/Dedicated_servers#SteamAPI_Init.28.29:_Sys_LoadModule_filed_to_load:_.2Fpath.2Fto.2F.steam.2Fsdk64.2Fsteamclient.so)).
```log ```log
Warning: failed to init SDL thread priority manager: SDL not found Warning: failed to init SDL thread priority manager: SDL not found
``` ```
This is a common error with Steam related software on Linux, but can safely be ignored. This is a common error with Steam related software on Linux, but can safely be ignored.
```log ```log
...Error: Couldn't find file for package... ...Error: Couldn't find file for package...
``` ```
```log ```log
...Error: Navmesh bounds are too large!... ...Error: Navmesh bounds are too large!...
``` ```
```log ```log
...Warning: NiagaraSystem... ...Warning: NiagaraSystem...
``` ```
```log ```log
LogStreaming: Warning: Failed to read file '../../../FactoryGame/Saved/SaveGames/GameAnalytics.sav' error. LogStreaming: Warning: Failed to read file '../../../FactoryGame/Saved/SaveGames/GameAnalytics.sav' error.
``` ```
↑ These seem to be common error messages with the current experimental version of the game.
These seem to be common error messages with the current experimental version of the game.