aboutsummaryrefslogtreecommitdiff
path: root/docs/whirl/configuration.md
blob: a96ca4bbaaa138b3c535aec0c991c9c7ae5e55ee (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
---
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
#### Enable
Manually enable the Whirl Shell.

#### 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.