diff options
| -rw-r--r-- | docs/SUMMARY.md | 7 | ||||
| -rw-r--r-- | docs/hosting-a-server-with-northstar/guides/README.md | 2 | ||||
| -rw-r--r-- | docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md | 151 | ||||
| -rw-r--r-- | docs/modding-and-development/development/northstarmasterserver/README.md | 11 | ||||
| -rw-r--r-- | docs/modding-and-development/development/repositories/README.md | 3 | ||||
| -rw-r--r-- | docs/modding-and-development/development/repositories/northstarlauncher.md (renamed from docs/modding-and-development/development/northstarlauncher.md) | 0 | ||||
| -rw-r--r-- | docs/modding-and-development/development/repositories/northstarmasterserver/README.md | 11 | ||||
| -rw-r--r-- | docs/modding-and-development/development/repositories/northstarmasterserver/deploy.md (renamed from docs/modding-and-development/development/northstarmasterserver/deploy.md) | 0 |
8 files changed, 98 insertions, 87 deletions
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 7abe472..9bec459 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -36,9 +36,10 @@ * [Modding](modding/README.md) * [Development](modding-and-development/development/README.md) - * [NorthstarLauncher](modding-and-development/development/northstarlauncher.md) - * [NorthstarMasterServer](modding-and-development/development/northstarmasterserver/README.md) - * [Deploy](modding-and-development/development/northstarmasterserver/deploy.md) + * [Repositories](modding-and-development/development/repositories/README.md) + * [NorthstarLauncher](modding-and-development/development/repositories/northstarlauncher.md) + * [NorthstarMasterServer](modding-and-development/development/repositories/northstarmasterserver/README.md) + * [Deploy](modding-and-development/development/repositories/northstarmasterserver/deploy.md) * [Testing](modding-and-development/testing.md) ## Other diff --git a/docs/hosting-a-server-with-northstar/guides/README.md b/docs/hosting-a-server-with-northstar/guides/README.md index 5827861..b6dd286 100644 --- a/docs/hosting-a-server-with-northstar/guides/README.md +++ b/docs/hosting-a-server-with-northstar/guides/README.md @@ -6,7 +6,7 @@ description: Guides to setting up a server {% hint style="info" %} Note that these guides might not fully reflect best practices and can be outdated. However they should be helpful in setting up a server for the first time.\ -If you're planning to get serious about hosting your own server, please check out the ["Hosting a Dedicated Server" section](dedicated-server/). +If you're planning to get serious about hosting your own server, please check out the ["Hosting a Dedicated Server" section](../dedicated-server/). {% endhint %} {% embed url="https://www.youtube.com/watch?v=EZ3w2Nl9SZo" %} diff --git a/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md b/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md index ebd61b2..8d5cf62 100644 --- a/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md +++ b/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md @@ -1,88 +1,95 @@ --- -description: pg9182 has provided a complete docker image to run on Linux servers. This provides some server management tools and offers better performance. No physical GPU is needed. His github page can be found [here](https://github.com/pg9182/northstar-dedicated) This page is to provide basic instructions, more information and config options are found at pg9182's github. +description: >- + pg9182 has provided a complete docker image to run on Linux servers. This + provides some server management tools and offers better performance. No + physical GPU is needed. His github page can be found [ --- +# Docker Install + The aim of this guide is to show the steps to build a docker-compose container that starts on boot and to show basic configuration -## <a name="Prerequisites">Prerequisites</a> +### Prerequisites -| Requirement | Description -| ------------------| ---------------------------------------------------------| -| Kernel | Linux 5.3+, but 4.9+ should work | -| CPU | x86_64, at least 3 cores minimum | -| RAM | 2GB (Typically peaks at 1.6GB) | -| Disk | 5GB | -| Network | Recommended at least 7-20Mbps up | -| Docker | Have Docker and Docker-compose installed on the machine | +| Requirement | Description | +| ----------- | ------------------------------------------------------- | +| Kernel | Linux 5.3+, but 4.9+ should work | +| CPU | x86\_64, at least 3 cores minimum | +| RAM | 2GB (Typically peaks at 1.6GB) | +| Disk | 5GB | +| Network | Recommended at least 7-20Mbps up | +| Docker | Have Docker and Docker-compose installed on the machine | +### Installation -## <a name="Installation">Installation</a> +#### Prep Titanfall Server files -### Prep Titanfall Server files -You will need to copy over your Titanfall installation folder and place it on the Linux machine. Most of these files are for SP and therefore we can delete from the installation folder and prune the file size down to ~5GB. +You will need to copy over your Titanfall installation folder and place it on the Linux machine. Most of these files are for SP and therefore we can delete from the installation folder and prune the file size down to \~5GB. -Easiest way to do this is copy the entire Titanfall2 folder to your desktop and delete the [following files](https://github.com/pg9182/northstar-dedicated#reducing-the-size-). +Easiest way to do this is copy the entire Titanfall2 folder to your desktop and delete the [following files](https://github.com/pg9182/northstar-dedicated#reducing-the-size-). -### Copy Titanfall Folder over to the Linux Machine +#### Copy Titanfall Folder over to the Linux Machine -1. Access the files on your Linux machine using tools like [Filezilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/eng/download.php) +1. Access the files on your Linux machine using tools like [Filezilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/eng/download.php) 2. Navigate to `/mnt/Titanfall` (create directory if does not exist) -3. Copy the newly pruned Titanfall folder to the server. +3. Copy the newly pruned Titanfall folder to the server.  -### Copy mods to /mnt/mods -If you have configured some mods,these can be placed at '/mnt/mods` like below - - -### Create docker-compose file -We are going to be using Docker-Compose to set up our container, this gives us much more flexibility and allows us to make changes to the start up args much cleaner. - ``` - mkdir Titanfall - nano docker-compose.yml - ``` - - Example docker-compose.yml - - ```yaml - version: '3' - services: - northstar1: - image: ghcr.io/pg9182/northstar-dedicated:1-tf2.0.11.0 - pull_policy: always - environment: - - NS_PORT=37015 - - NS_PORT_AUTH=8081 - - 'NS_SERVER_NAME=[Region]Enter Server Name here' - - 'NS_SERVER_DESC=Enter your description here' - - | - NS_EXTRA_ARGUMENTS= - +setplaylist aitdm - +mp_gamemode aitdm - +map mp_angel_city - +ns_private_match_countdown_length 0 - +ns_should_return_to_lobby 0 - +net_compresspackets_minsize 64 - +net_compresspackets 1 - +spewlog_enable 0 - +sv_maxrate 127000 - volumes: - - /mnt/Titanfall:/mnt/Titanfall:ro - - /mnt/mods:/mnt/mods:ro - ports: - - '37015:37015/udp' - - '8081:8081/tcp' - restart: always - ``` - A list of all the CONVARs are [here](../../basic-listen-server#server-configuration) - - ## <a name="Starting">Starting</a> - -### Run the following command - - To run this container type - ``` - docker-compose up - ``` - - +#### Copy mods to /mnt/mods + +If you have configured some mods,these can be placed at '/mnt/mods\` like below  + +#### Create docker-compose file + +We are going to be using Docker-Compose to set up our container, this gives us much more flexibility and allows us to make changes to the start up args much cleaner. + +``` +mkdir Titanfall +nano docker-compose.yml +``` + +Example docker-compose.yml + +```yaml +version: '3' +services: + northstar1: + image: ghcr.io/pg9182/northstar-dedicated:1-tf2.0.11.0 + pull_policy: always + environment: + - NS_PORT=37015 + - NS_PORT_AUTH=8081 + - 'NS_SERVER_NAME=[Region]Enter Server Name here' + - 'NS_SERVER_DESC=Enter your description here' + - | + NS_EXTRA_ARGUMENTS= + +setplaylist aitdm + +mp_gamemode aitdm + +map mp_angel_city + +ns_private_match_countdown_length 0 + +ns_should_return_to_lobby 0 + +net_compresspackets_minsize 64 + +net_compresspackets 1 + +spewlog_enable 0 + +sv_maxrate 127000 + volumes: + - /mnt/Titanfall:/mnt/Titanfall:ro + - /mnt/mods:/mnt/mods:ro + ports: + - '37015:37015/udp' + - '8081:8081/tcp' + restart: always +``` + +A list of all the CONVARs are [here](../../basic-listen-server/#server-configuration) + +### Starting + +#### Run the following command + +To run this container type + +``` +docker-compose up +``` diff --git a/docs/modding-and-development/development/northstarmasterserver/README.md b/docs/modding-and-development/development/northstarmasterserver/README.md deleted file mode 100644 index 85ab24e..0000000 --- a/docs/modding-and-development/development/northstarmasterserver/README.md +++ /dev/null @@ -1,11 +0,0 @@ -# Hosting a Master Server - -## Introduction - -The master server is responsible for centralizing game servers created by players, it also verifies that connecting players own an Origin account with Titanfall 2. - -There's no need to host your own master server to play games with other people, you can use [direct connect](../../../installing-northstar/using-northstar/direct-connect.md) or just setup a [normal server](../../../hosting-a-server-with-northstar/basic-listen-server.md) that announces itself to `northstar.tf`. This tutorial is aimed for those who want to contribute improvements to the code or test their own changes to the project. - -## Contents - -* [Deploy](deploy.md) diff --git a/docs/modding-and-development/development/repositories/README.md b/docs/modding-and-development/development/repositories/README.md new file mode 100644 index 0000000..d459d3b --- /dev/null +++ b/docs/modding-and-development/development/repositories/README.md @@ -0,0 +1,3 @@ +# Repositories + +The Northstar codebase stretches over multiple repositories, with different repos containing code for different aspects of Northstar. Check sub-pages for a description of some of them. diff --git a/docs/modding-and-development/development/northstarlauncher.md b/docs/modding-and-development/development/repositories/northstarlauncher.md index 89aeca4..89aeca4 100644 --- a/docs/modding-and-development/development/northstarlauncher.md +++ b/docs/modding-and-development/development/repositories/northstarlauncher.md diff --git a/docs/modding-and-development/development/repositories/northstarmasterserver/README.md b/docs/modding-and-development/development/repositories/northstarmasterserver/README.md new file mode 100644 index 0000000..2b5ac8a --- /dev/null +++ b/docs/modding-and-development/development/repositories/northstarmasterserver/README.md @@ -0,0 +1,11 @@ +# NorthstarMasterServer + +## Introduction + +The master server is responsible for centralizing game servers created by players, it also verifies that connecting players own an Origin account with Titanfall 2. + +There's no need to host your own master server to play games with other people, you can use [direct connect](../../../../installing-northstar/using-northstar/direct-connect.md) or just setup a [normal server](../../../../hosting-a-server-with-northstar/basic-listen-server.md) that announces itself to `northstar.tf`. This tutorial is aimed for those who want to contribute improvements to the code or test their own changes to the project. + +## Contents + +* [Deploy](deploy.md) diff --git a/docs/modding-and-development/development/northstarmasterserver/deploy.md b/docs/modding-and-development/development/repositories/northstarmasterserver/deploy.md index e1d5985..e1d5985 100644 --- a/docs/modding-and-development/development/northstarmasterserver/deploy.md +++ b/docs/modding-and-development/development/repositories/northstarmasterserver/deploy.md |