aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCyn <70904206+itscynxx@users.noreply.github.com>2024-01-08 13:08:27 -0600
committerGitHub <noreply@github.com>2024-01-08 20:08:27 +0100
commit083bbae1158b7afa66f53ccff73a2905dbca1244 (patch)
treefa24b003b31231e9d6ca514ba9b78f882ae6da16
parent96939f91339d48ddd580a2768f2b66046727e49d (diff)
downloadNorthstarWiki-083bbae1158b7afa66f53ccff73a2905dbca1244.tar.gz
NorthstarWiki-083bbae1158b7afa66f53ccff73a2905dbca1244.zip
Add page documenting banlist functionality (#275)
Adds docs of how `ban`, `unban` and the `banlist.txt` work
-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`).