aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFuwn <[email protected]>2021-05-09 22:47:43 -0700
committerFuwn <[email protected]>2021-05-09 22:47:43 -0700
commit3e6d8a82798d6ad990e06e4d032772e19907d77d (patch)
treeacc98d236fc6fa672836cc4adb1bf5bb7a184314
parentci(mergify): add mergify to repository (diff)
downloadsite-3e6d8a82798d6ad990e06e4d032772e19907d77d.tar.xz
site-3e6d8a82798d6ad990e06e4d032772e19907d77d.zip
feat(docs): whirl/configuration documentation
-rw-r--r--docs/whirl/configuration.md49
-rw-r--r--sidebars.js30
2 files changed, 67 insertions, 12 deletions
diff --git a/docs/whirl/configuration.md b/docs/whirl/configuration.md
new file mode 100644
index 0000000..4349866
--- /dev/null
+++ b/docs/whirl/configuration.md
@@ -0,0 +1,49 @@
+---
+title: Configuration
+---
+
+## Whirlsplash
+### WorldsMaster Username
+The server operator's username.
+
+This should NOT be changed under normal circumstances.
+
+### Log Level
+The level of logging which the serve should emit.
+
+By default, **errors**, **warnings**, and **info** (1) logs are emitted, however, you can change
+this value to enable **debug** (2) and **trace** (3) logging.
+
+Under normal circumstances, this value should only be changed when instructed to or if you are
+experiencing any undefined/ unexpected behaviours and you would like to try self-debugging.
+
+### IP
+**This configuration option may become deprecated in the near:
+[issue](https://github.com/Whirlsplash/whirl/issues/18).**
+
+The Internet Protocol address of the host's machine.
+
+When connecting to a local server (client and host both originate from the same machine), a value of
+`0.0.0.0` or `127.0.0.1` is fine, however, if you are hosting a server publicly as service, this
+should be changed to the host's IP address.
+
+## Prompt PS1
+Similar to a PS1 as seen in *nix-based operating systems, the Prompt String/ Statement One is the
+prompt string which will appear if you have the Whirl Shell enabled.
+
+## Distributor
+### WorldsMaster Greeting
+The first message or "greeting" which is sent to a user once connected to a WorldServer.
+
+### Port
+The port which the Distributor may be accessed from.
+
+This should NOT be changed under any
+circumstances.
+
+## Hub
+### Port
+The port which the Hub may be accessed from.
+
+This should NOT be changed under any
+circumstances.
diff --git a/sidebars.js b/sidebars.js
index de68779..e3718bd 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -22,10 +22,17 @@ module.exports = {
},
{
type: 'category',
+ label: 'Whirl',
+ items: [
+ 'whirl/configuration',
+ ],
+ },
+ {
+ type: 'category',
label: 'GammaDocs',
items: [
- 'gammadocs/roomserver/userserver-configuration-options'
- ]
+ 'gammadocs/roomserver/userserver-configuration-options',
+ ],
},
{
type: 'category',
@@ -35,8 +42,8 @@ module.exports = {
'worldserver-protocol/packet-information',
'worldserver-protocol/network-constants',
'worldserver-protocol/roomserver',
- 'worldserver-protocol/userserver'
- ]
+ 'worldserver-protocol/userserver',
+ ],
},
{
type: 'category',
@@ -53,13 +60,12 @@ module.exports = {
'worlds-jar/net-worlds/network/objid',
'worlds-jar/net-worlds/network/serveroutputstream',
'worlds-jar/net-worlds/network/netconst',
- 'worlds-jar/net-worlds/network/netpacket'
- ]
- }
- ]
- }
-
- ]
- }
+ 'worlds-jar/net-worlds/network/netpacket',
+ ],
+ },
+ ],
+ },
+ ],
+ },
],
};