Sharing
Running a server
The arena server is a folder you download, unzip and start. Players find it in the game's server list and join.
Download: blackautumn.divinevtt.com/download/server
What it needs
- A 64-bit Linux machine. A small rented server (VPS) is enough.
- About 1.5 GB of disk for the folder, and 1 GB of memory for each server run from it.
- One open UDP port for each server, 7777 unless you choose another. At home, forward it on the router.
Starting it
Unzip, go into the folder, and run:
chmod +x run.sh BlackAutumnServer.x86_64
./run.sh --data ./data --mode brawl -- -auth noneIt is running when a line starting with READY appears. Type stop and press Enter to end it, or press Ctrl+C.
What comes before the -- is for run.sh, what comes after goes to the game.
before the -- | |
|---|---|
--data ./data | the folder the server keeps its settings and logs in |
--port 7778 | the UDP port (7777 when left out) |
--mode brawl | the arena. Keep it in every line |
after the -- | |
|---|---|
-auth none | anyone may come in. Keep it for a public server |
-rules duel | the mode played (below) |
-map ford | the map it starts on (below) |
-listname "Samo's arena" | its name in the game's server list |
-maxplayers 8 | how many play at once, 16 at most |
-tick 50 | network ticks a second. The official servers run 50 |
-matchmins 15 | how long a free for all or duel match lasts (10 when left out) |
-horde 80 | a siege's most peasants alive at once (120 when left out) |
-mods a,b | the mods switched on (below) |
A skirmish server for 10 on port 7780:
./run.sh --data ./skirmish-data --port 7780 --mode brawl -- -auth none -tick 50 -rules skirmish -maxplayers 10 -listname "Samo's skirmish"Modes
-rules | |
|---|---|
ffa | Free for all: everybody against everybody. Played when -rules is left out |
duel | Free for all without bows and crossbows |
skirmish | Red against Blue in rounds. The dead watch until the next round. First to 5 rounds |
gunfight | Two sides in rounds with the same rifle, pistol, knife and armour for everybody. Pistols only in the first round of each half, ends swapped after 7 rounds, first to 8. Never on the ring: it goes to ford |
siege | Everybody together holds Šášov castle against a horde of peasants: the outer gate, the inner gate, the keep. Always on sasov |
Maps
-map | |
|---|---|
ring | A round arena with a wooden fence |
ford | A river with a bridge, a ford and stepping stones, a mill on one bank |
farm | A farmstead's yard: house, barn, sheds, fences, stacks and carts |
quarry | Rock ledges, outcrops and cut stone |
yard | A castle's outer yard inside its walls, towers and gate |
sasov | Šášov castle and the land round it, for -rules siege |
-map is the map the server starts on. At the end of a match the players vote for the next one, and the server starts again on it by itself. Everybody joins again on their own.
Mods on a server
Put each mod's folder into Mods/ beside BlackAutumnServer.x86_64, the same folder the game reads them from, and name them when starting:
./run.sh --data ./data --mode brawl -- -auth none -mods mymod-mods a,bswitches on the mods named, with what they need.-rules <mod id>.<name>plays a mod's siege.-map <mod id>.<name>plays a mod's arena map.
A player joining needs the same mods with the same files. The game offers to switch to the server's mods and to get the missing ones from the Workshop (Online). A dedicated server reads no sounds.
More than one server
Each needs its own port and its own data folder. They can share the one unzipped folder.
./run.sh --data ./ffa-data --port 7777 --mode brawl -- -auth none -rules ffa
./run.sh --data ./duel-data --port 7778 --mode brawl -- -auth none -rules duelKeeping it running
Started by hand, a server ends when its terminal closes. screen or tmux keeps it going. On a machine that should bring it back after a restart or a crash, make it a systemd service. With the folder unzipped to /opt/blackautumn-arena and a user of its own:
sudo useradd --system --home /srv/blackautumn-arena --shell /usr/sbin/nologin blackautumn
sudo mkdir -p /srv/blackautumn-arena
sudo chown -R blackautumn:blackautumn /srv/blackautumn-arena /opt/blackautumn-arena
sudo ufw allow 7777/udp/etc/systemd/system/blackautumn-arena.service:
[Unit]
Description=Black Autumn 1438 arena
After=network-online.target
Wants=network-online.target
[Service]
User=blackautumn
Group=blackautumn
WorkingDirectory=/opt/blackautumn-arena
Environment=BA_DATA=/srv/blackautumn-arena
ExecStart=/opt/blackautumn-arena/run.sh --mode brawl --port 7777 -- -auth none -tick 50 -maxplayers 16 -listname "My arena"
Restart=on-failure
RestartPreventExitStatus=2
RestartSec=5
TimeoutStopSec=30
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now blackautumn-arena
journalctl -u blackautumn-arena -fThe server ends with code 3 when it wants to be started again (a restart, the map voted for) and systemd starts it. Code 0 is a stop: it stays down until systemctl start. Code 2 is a bad command line or server.json: fix it, then start it.
The data folder
server.json | the settings, written with their defaults on the first start. The command line wins over it |
whitelist.json | who may come in and their roles, read again within 5 seconds of a change |
bans.json | bans, written by ban and unban |
commands/ | a file name.cmd put here is run within about 2 seconds, a command a line. The answers land in commands/done/name.out |
logs/ | unity.log (the last run's is unity.prev.log), server-<date>.log, admin-audit-<date>.log |
The console
Commands are typed into the server's terminal, dropped into commands/ as a .cmd file, or typed by a player with a role in the game's own console (F10). help lists what you may use. A player is named by a name or its start, or by a number such as #3 from players.
status, players, perf | what is running, who is in, how the server is doing |
say <text>, msg <player> <text> | to everybody, to one |
kick <player> [reason] | sent away |
ban <player> [hours] [reason], unban <player> | kept out |
whitelist add <name> [steam id] [roles] | on the list, with a role: player, helper, gm, admin |
grant <player> <roles> | roles changed |
stop [seconds] [message] | the players are told, then it ends |
restart [seconds] [message] | the same, and it starts again |
Whoever can write into commands/ is an admin of the server. Keep the folder to the server's own user.
Updating
- Download the new zip.
restart 60 Update, back in a minute.in the console, or stop the service.- Unzip over the old folder. The data folder stays as it is. Mods in
Mods/stay too if you unzip over it; a folder swapped whole needs them copied back. - Start it.
How players join
Multiplayer > Join in the game: the server is in the list by itself. If it is not, Direct join takes its address and port, such as 203.0.113.5:7777.
When something is wrong
- No
READYline. The lines before it say why. Most often the port is taken by another server: give it another--port. - Nobody can join. The UDP port is closed (the firewall, the router, the host's own firewall page), or the game and the server are different versions.
- Not in the list. It appears a little after
READY. A siege takes about a minute longer: it builds the valley first. - It keeps coming back up and going down.
journalctl -u blackautumn-arenaandlogs/unity.login the data folder say what it ends on.
Modding