From d7e702aa53dcc4ecc2e327cd608eeba989f23d0e Mon Sep 17 00:00:00 2001 From: GeckoEidechse Date: Sun, 26 Dec 2021 00:19:48 +0000 Subject: GitBook: [#2] Cleanup via Gitbook interface --- Basic-Setup.md | 16 --------- Hosting-a-Server.md | 39 ---------------------- SUMMARY.md | 12 +++++++ Troubleshooting.md | 18 ---------- .../hosting-a-server.md | 39 ++++++++++++++++++++++ installing-northstar/basic-setup.md | 16 +++++++++ troubleshooting.md | 18 ++++++++++ 7 files changed, 85 insertions(+), 73 deletions(-) delete mode 100644 Basic-Setup.md delete mode 100644 Hosting-a-Server.md create mode 100644 SUMMARY.md delete mode 100644 Troubleshooting.md create mode 100644 hosting-a-server-with-northstar/hosting-a-server.md create mode 100644 installing-northstar/basic-setup.md create mode 100644 troubleshooting.md diff --git a/Basic-Setup.md b/Basic-Setup.md deleted file mode 100644 index 854815a..0000000 --- a/Basic-Setup.md +++ /dev/null @@ -1,16 +0,0 @@ -First things first: you'll need to download and install Northstar. - -1. Download the latest version from the [releases](https://github.com/R2Northstar/Northstar/releases) page -2. Copy all the files in the newly downloaded zip folder to your Titanfall folder - - **For Steam** - Right click *Titanfall 2* > Open *Properties* > Click *Local Files* > Click *Browse* -- **For Origin** - Click Titanfall 2 in the Library > Click the gear icon > Click *Game Properties* -3. Launch NorthstarLauncher.exe to start Northstar -After launching, you should be greeted with something like this: -![](https://raw.githubusercontent.com/R2Northstar/Northstar/main/wiki/titleagreement.png) - -Should you notice any issues/warnings/errors while running Northstar, check [[the troubleshooting page|Troubleshooting]] - -**Additional Stuff** -Since Northstar doesn't launch directly through Origin, any startup arguments provided in origin won't transfer over, you'll need to add them to the file `ns_startup_args.txt`, which should be in the same folder as you extracted the Northstar files to. - -If Northstar doesn't appear to be installed, or you have issues entering the lobby, try running vanilla files, I can't personally say what VPK mods could cause issues with Northstar at the moment, so it'd probably be easiest just to try running unmodded. \ No newline at end of file diff --git a/Hosting-a-Server.md b/Hosting-a-Server.md deleted file mode 100644 index b38cb49..0000000 --- a/Hosting-a-Server.md +++ /dev/null @@ -1,39 +0,0 @@ -**Hosting a Listen Server** -To host a listen server on Northstar, go to the lobby and press the `Private Match` button to begin a private match. -While this does allow you to host a server, other people won't be able to join it, so you'll need to port forward 2 ports to allow other people to join. -The ports you'll need to forward are 37015-37020 UDP, and 8081 TCP by default, if this works as it should, this should result in your server being displayed on the server browser, and other clients being able to connect to it. -![](https://raw.githubusercontent.com/R2Northstar/Northstar/main/wiki/lobbyprivatematch.png) - -**Hosting a Dedicated Server** -Dedicated servers allow you to host a Northstar server without having to use a full client, making them more lightweight and easier to host for longer periods of time. Dedicated servers are still in development for Northstar, so while they do work, expect some bugs and general jank. -To start a dedicated server on Northstar, launch NorthstarLauncher.exe with the argument `-dedicated`, this can be done manually, but releases also provide the batch file `r2ds.bat`, which will also do this. -When using a dedicated server, arguments are read from `ns_startup_args_dedi.txt`, rather than `ns_startup_args.txt`. - -**Dedicated Server Caveats** -At the moment, dedicated servers still require DirectX 11 to work, which typically requires a physical GPU, though they use almost no GPU processing power while in use, this can be an issue especially on GPU-less setups, so the launch argument `-softwared3d11` can be used to force DirectX to run in software mode. -While this is absolutely not ideal, it's the best solution for truely headless dedicated servers at the moment, and surprisingly hardly uses any CPU time, though it can use roughly up to 1GB of RAM. -Regarding RAM usage, dedicated servers also use significant amounts of RAM at the moment, often requiring 1.5-2GB, though I expect this to lower as development continues. - -**Server Configuration** -Whether you're running a listen or dedicated server, you'll generally want to mess with the configuration at least a bit. While I do think the default configuration settings are pretty ok, being able to change your server's name or password, or increasing your server's tickrate is often something you'll want to do. Server configuration can be modified in the file `R2Northstar/mods/Northstar.CustomServers/mod/cfg/autoexec_ns_server.cfg`, which will be executed on server startup. - -Below are a series of variables and commands you can use for server configuration: -| Name | Description | Default Value | -| ---- | ----------- | ------------- | -| `ns_server_name` | Your server's name on the server browser | `"Unnamed Northstar Server"` | -| `ns_server_desc` | Your server's description on the server browser | `"Default server description"` | -| `ns_server_password` | The password required to join your server, can be bypassed if clients directly connect and you are using insecure auth | `""` | -| `ns_report_server_to_masterserver` | Whether your server should report itself to the masterserver, for use in auth and the serverbrowser | `1` | -| `ns_report_sp_server_to_masterserver` | Whether your server should report itself to the masterserver if started on a singleplayer map, for use in auth and the serverbrowser | `0` | -| `ns_auth_allow_insecure` | Allows clients to join your server without authenticating with the masterserver, currently required to allow clients to connect directly to your IP, rather than through the server browser | `0` | -| `ns_erase_auth_info` | Whether your server should erase authentication information after it is used, this is useful for development but should normally be kept at 1 | `1` | -| `ns_player_auth_port` | The port used for the server's local authentication server, this is the TCP port we forwarded earlier | `8081` | -| `everything_unlocked` | Whether all items, weapons, etc should be unlocked on the server | `1` | -| `ns_should_return_to_lobby` | Whether the server should return to private match lobby after completing a game, if 0, this will go to the next map/mode in the playlist | `1` | -| `ns_should_log_unknown_clientcommands` | Whether unknown clientcommands should be printed in the console, worth disabling if they get on your nerves | `1` | -| `net_chan_limit_mode` | If 0, don't limit the netchannel processing time individual clients are allowed. If 1, kick clients that go over the limit. If 2, log clients that go over the limit in console | `2` | -| `net_chan_limit_msec_per_sec` | The number of milliseconds of server netchan processing time clients can use per second before triggering the response set in net_chan_limit_mode | `30` | -| `base_tickinterval_mp` | The delay between each tick ran on the server, your tickrate will be 1 divided by this value | `0.016666667` | -| `sv_updaterate_mp` | The maximum number of times per second your server will send information to connected players, if a player's cl_updaterate_mp value is lower than this, their rate will be limited to it | `20` | -| `sv_max_snapshots_multiplayer` | The number of snapshots stored locally for use in replays, this should be set to sv_updaterate_mp * 15 | `300` | -| `host_skip_client_dll_crc` | Whether the server should allow clients with modified client.dll files to connect, these are used for visor colour edit mods | `1` | diff --git a/SUMMARY.md b/SUMMARY.md new file mode 100644 index 0000000..9520ce7 --- /dev/null +++ b/SUMMARY.md @@ -0,0 +1,12 @@ +# Table of contents + +* [Welcome to Northstar](README.md) +* [Engine Error](troubleshooting.md) + +## Installing Northstar + +* [Basic-Setup](installing-northstar/basic-setup.md) + +## Hosting a server with Northstar + +* [Hosting-a-Server](hosting-a-server-with-northstar/hosting-a-server.md) diff --git a/Troubleshooting.md b/Troubleshooting.md deleted file mode 100644 index 4c28a4e..0000000 --- a/Troubleshooting.md +++ /dev/null @@ -1,18 +0,0 @@ -# Engine Error - -![Engine Error: File corruption detected. Please repair or re-install the game.](https://user-images.githubusercontent.com/39478251/147338706-74797220-7d7f-4c81-9ba0-d88e29a2a1e2.png) - -Don't panic! This warning seems to be caused by Origin and none of your files are actually corrupted. If you get this warning after launching the game try the following steps, closing the game before and launching it again after: - -1. Restart Origin - Also check task manager that all Origin processes are gone before restarting it - (even if you have the Steam version) -2. Restart your PC -3. Start Northstar with Origin already open -4. Start Northstar with Origin fully closed. -5. Make sure you got the newest version of Northstar -6. Verify game files via Steam/Origin (depending on where you own the game) -7. Check Github issues if anyone else is experiencing this problem. Maybe current release has a bug. -8. Start vanilla game and see if this works -9. If you followed all these steps and even launching the vanilla version of the game doesn't work, your final option is to fully remove the game and reinstall it. - Then check if vanilla works before reinstalling Northstar. diff --git a/hosting-a-server-with-northstar/hosting-a-server.md b/hosting-a-server-with-northstar/hosting-a-server.md new file mode 100644 index 0000000..b38cb49 --- /dev/null +++ b/hosting-a-server-with-northstar/hosting-a-server.md @@ -0,0 +1,39 @@ +**Hosting a Listen Server** +To host a listen server on Northstar, go to the lobby and press the `Private Match` button to begin a private match. +While this does allow you to host a server, other people won't be able to join it, so you'll need to port forward 2 ports to allow other people to join. +The ports you'll need to forward are 37015-37020 UDP, and 8081 TCP by default, if this works as it should, this should result in your server being displayed on the server browser, and other clients being able to connect to it. +![](https://raw.githubusercontent.com/R2Northstar/Northstar/main/wiki/lobbyprivatematch.png) + +**Hosting a Dedicated Server** +Dedicated servers allow you to host a Northstar server without having to use a full client, making them more lightweight and easier to host for longer periods of time. Dedicated servers are still in development for Northstar, so while they do work, expect some bugs and general jank. +To start a dedicated server on Northstar, launch NorthstarLauncher.exe with the argument `-dedicated`, this can be done manually, but releases also provide the batch file `r2ds.bat`, which will also do this. +When using a dedicated server, arguments are read from `ns_startup_args_dedi.txt`, rather than `ns_startup_args.txt`. + +**Dedicated Server Caveats** +At the moment, dedicated servers still require DirectX 11 to work, which typically requires a physical GPU, though they use almost no GPU processing power while in use, this can be an issue especially on GPU-less setups, so the launch argument `-softwared3d11` can be used to force DirectX to run in software mode. +While this is absolutely not ideal, it's the best solution for truely headless dedicated servers at the moment, and surprisingly hardly uses any CPU time, though it can use roughly up to 1GB of RAM. +Regarding RAM usage, dedicated servers also use significant amounts of RAM at the moment, often requiring 1.5-2GB, though I expect this to lower as development continues. + +**Server Configuration** +Whether you're running a listen or dedicated server, you'll generally want to mess with the configuration at least a bit. While I do think the default configuration settings are pretty ok, being able to change your server's name or password, or increasing your server's tickrate is often something you'll want to do. Server configuration can be modified in the file `R2Northstar/mods/Northstar.CustomServers/mod/cfg/autoexec_ns_server.cfg`, which will be executed on server startup. + +Below are a series of variables and commands you can use for server configuration: +| Name | Description | Default Value | +| ---- | ----------- | ------------- | +| `ns_server_name` | Your server's name on the server browser | `"Unnamed Northstar Server"` | +| `ns_server_desc` | Your server's description on the server browser | `"Default server description"` | +| `ns_server_password` | The password required to join your server, can be bypassed if clients directly connect and you are using insecure auth | `""` | +| `ns_report_server_to_masterserver` | Whether your server should report itself to the masterserver, for use in auth and the serverbrowser | `1` | +| `ns_report_sp_server_to_masterserver` | Whether your server should report itself to the masterserver if started on a singleplayer map, for use in auth and the serverbrowser | `0` | +| `ns_auth_allow_insecure` | Allows clients to join your server without authenticating with the masterserver, currently required to allow clients to connect directly to your IP, rather than through the server browser | `0` | +| `ns_erase_auth_info` | Whether your server should erase authentication information after it is used, this is useful for development but should normally be kept at 1 | `1` | +| `ns_player_auth_port` | The port used for the server's local authentication server, this is the TCP port we forwarded earlier | `8081` | +| `everything_unlocked` | Whether all items, weapons, etc should be unlocked on the server | `1` | +| `ns_should_return_to_lobby` | Whether the server should return to private match lobby after completing a game, if 0, this will go to the next map/mode in the playlist | `1` | +| `ns_should_log_unknown_clientcommands` | Whether unknown clientcommands should be printed in the console, worth disabling if they get on your nerves | `1` | +| `net_chan_limit_mode` | If 0, don't limit the netchannel processing time individual clients are allowed. If 1, kick clients that go over the limit. If 2, log clients that go over the limit in console | `2` | +| `net_chan_limit_msec_per_sec` | The number of milliseconds of server netchan processing time clients can use per second before triggering the response set in net_chan_limit_mode | `30` | +| `base_tickinterval_mp` | The delay between each tick ran on the server, your tickrate will be 1 divided by this value | `0.016666667` | +| `sv_updaterate_mp` | The maximum number of times per second your server will send information to connected players, if a player's cl_updaterate_mp value is lower than this, their rate will be limited to it | `20` | +| `sv_max_snapshots_multiplayer` | The number of snapshots stored locally for use in replays, this should be set to sv_updaterate_mp * 15 | `300` | +| `host_skip_client_dll_crc` | Whether the server should allow clients with modified client.dll files to connect, these are used for visor colour edit mods | `1` | diff --git a/installing-northstar/basic-setup.md b/installing-northstar/basic-setup.md new file mode 100644 index 0000000..854815a --- /dev/null +++ b/installing-northstar/basic-setup.md @@ -0,0 +1,16 @@ +First things first: you'll need to download and install Northstar. + +1. Download the latest version from the [releases](https://github.com/R2Northstar/Northstar/releases) page +2. Copy all the files in the newly downloaded zip folder to your Titanfall folder + - **For Steam** - Right click *Titanfall 2* > Open *Properties* > Click *Local Files* > Click *Browse* +- **For Origin** - Click Titanfall 2 in the Library > Click the gear icon > Click *Game Properties* +3. Launch NorthstarLauncher.exe to start Northstar +After launching, you should be greeted with something like this: +![](https://raw.githubusercontent.com/R2Northstar/Northstar/main/wiki/titleagreement.png) + +Should you notice any issues/warnings/errors while running Northstar, check [[the troubleshooting page|Troubleshooting]] + +**Additional Stuff** +Since Northstar doesn't launch directly through Origin, any startup arguments provided in origin won't transfer over, you'll need to add them to the file `ns_startup_args.txt`, which should be in the same folder as you extracted the Northstar files to. + +If Northstar doesn't appear to be installed, or you have issues entering the lobby, try running vanilla files, I can't personally say what VPK mods could cause issues with Northstar at the moment, so it'd probably be easiest just to try running unmodded. \ No newline at end of file diff --git a/troubleshooting.md b/troubleshooting.md new file mode 100644 index 0000000..4c28a4e --- /dev/null +++ b/troubleshooting.md @@ -0,0 +1,18 @@ +# Engine Error + +![Engine Error: File corruption detected. Please repair or re-install the game.](https://user-images.githubusercontent.com/39478251/147338706-74797220-7d7f-4c81-9ba0-d88e29a2a1e2.png) + +Don't panic! This warning seems to be caused by Origin and none of your files are actually corrupted. If you get this warning after launching the game try the following steps, closing the game before and launching it again after: + +1. Restart Origin + Also check task manager that all Origin processes are gone before restarting it + (even if you have the Steam version) +2. Restart your PC +3. Start Northstar with Origin already open +4. Start Northstar with Origin fully closed. +5. Make sure you got the newest version of Northstar +6. Verify game files via Steam/Origin (depending on where you own the game) +7. Check Github issues if anyone else is experiencing this problem. Maybe current release has a bug. +8. Start vanilla game and see if this works +9. If you followed all these steps and even launching the vanilla version of the game doesn't work, your final option is to fully remove the game and reinstall it. + Then check if vanilla works before reinstalling Northstar. -- cgit v1.2.3