aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/SUMMARY.md1
-rw-r--r--docs/hosting-a-server-with-northstar/server-settings/banlist.md31
2 files changed, 32 insertions, 0 deletions
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index e285b77..0492653 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -44,6 +44,7 @@
* [ConVars](hosting-a-server-with-northstar/server-settings/convars.md)
* [Playlistvars](hosting-a-server-with-northstar/server-settings/playlistvar.md)
* [Name in the files](hosting-a-server-with-northstar/server-settings/file-names.md)
+ * [Banlist](hosting-a-server-with-northstar/server-settings/banlist.md)
* [Troubleshooting](hosting-a-server-with-northstar/troubleshooting.md)
## Modding and Development
diff --git a/docs/hosting-a-server-with-northstar/server-settings/banlist.md b/docs/hosting-a-server-with-northstar/server-settings/banlist.md
new file mode 100644
index 0000000..441b69c
--- /dev/null
+++ b/docs/hosting-a-server-with-northstar/server-settings/banlist.md
@@ -0,0 +1,31 @@
+# Banlist
+
+The `banlist.txt` file found at `R2Northstar\banlist.txt` is a list of players that you have either banned or unbanned from your server.
+
+The UIDs can be formatted as shown below:
+```
+1111111111
+
+4444444444
+```
+
+This file also supports the use of comments with the `#` symbol:
+
+```
+# This is a comment
+1111111111
+
+4444444444 # Banned for being uncool
+```
+
+## Banning
+
+When banning a player in game using the `ban` command in console, their UID will be added to the list in `banlist.txt`.
+
+The `ban` command is used alongside the name of the player you want to ban (e.g. `ban realPlayerFr`), or with their UID (e.g. `ban 1111111111`). The console will auto-complete the name for you, given you have typed something close to a valid name of a player in the game.
+
+## Unbanning
+
+When unbanning a player in game using the `unban` command in console, their UID will be commented out in the file, as well as a comment next to their UID displaying the unban date.
+
+The `unban` command is used alongisde the UID of the player you want to unban (e.g. `unban 1111111111`).