aboutsummarylogtreecommitdiffstats
path: root/README.md
blob: 291055161aba9a4b9e7a8eef835a125e3b7e7c3a (plain)
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
# Dominions Headless Server

## Installing

Install this package (`dominions-server`) using your AUR package manager of choice, or `makepkg`.

### Application

```bash
dominions install
```

You will need to enter your Steam user ID, password, and Dominions license key when prompted. SteamCMD may ask you to authenticate through Steam Guard.

### Network

Choose a port number between 1024 and 65535 and make sure you don't have anything else running on that port. Specify this number when configuring games.

If your computer is behind a router you will need to make sure the port is forwarded. It is also helpful to configure a static IP address so the routing stays consistent. Consult your router documentation for instructions.

## Usage

Most of the game configuration is accomplished through the `dominions` program. Run it without arguments for detailed usage instructions.

The actual game server is set up as a systemd service and can be started, stopped, enabled, or disabled via systemctl like any other service.

### Configuration

```bash
dominions config mygame
```

Edit the file as desired and save. The `mapfile` should reference a file either in the current directory or in *your* `~/dominions/maps` directory. Once you have a game configured:

1. `sudo systemctl start dominions-server` starts the server in pretender upload mode.
1. If `uploadmaxp` or `uploadtime` are set in your configuration, you're done: the game will start automatically when the appropriate limit is reached.
1. Once everyone has uploaded their pretenders, `dominions ready` sets the game start flag. You can `dominions ready mygame` to specify a game to host regardless of what was last configured.
1. Restart the server using `sudo systemctl restart dominions-server` to begin the game.

You may also want to `sudo systemctl enable dominions-server` in order to start the server automatically after reboots.

Note that only one game may be served at a time. If you configure or ready a new game, you will be asked if you want to host it instead of the current game. Any existing configuration will be preserved.

### Deleting Games

`dominions delete mygame` removes the properties file and save directory. Maps are not removed.