Modding
Discord Wishlist on Steam

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 none

It 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 ./datathe folder the server keeps its settings and logs in
--port 7778the UDP port (7777 when left out)
--mode brawlthe arena. Keep it in every line
after the --
-auth noneanyone may come in. Keep it for a public server
-rules duelthe mode played (below)
-map fordthe map it starts on (below)
-listname "Samo's arena"its name in the game's server list
-maxplayers 8how many play at once, 16 at most
-tick 50network ticks a second. The official servers run 50
-matchmins 15how long a free for all or duel match lasts (10 when left out)
-horde 80a siege's most peasants alive at once (120 when left out)
-mods a,bthe 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
ffaFree for all: everybody against everybody. Played when -rules is left out
duelFree for all without bows and crossbows
skirmishRed against Blue in rounds. The dead watch until the next round. First to 5 rounds
gunfightTwo 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
siegeEverybody together holds Šášov castle against a horde of peasants: the outer gate, the inner gate, the keep. Always on sasov

Maps

-map
ringA round arena with a wooden fence
fordA river with a bridge, a ford and stepping stones, a mill on one bank
farmA farmstead's yard: house, barn, sheds, fences, stacks and carts
quarryRock ledges, outcrops and cut stone
yardA 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,b switches 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 duel

Keeping 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.target
sudo systemctl daemon-reload
sudo systemctl enable --now blackautumn-arena
journalctl -u blackautumn-arena -f

The 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.jsonthe settings, written with their defaults on the first start. The command line wins over it
whitelist.jsonwho may come in and their roles, read again within 5 seconds of a change
bans.jsonbans, 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, perfwhat 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

  1. Download the new zip.
  2. restart 60 Update, back in a minute. in the console, or stop the service.
  3. 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.
  4. 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 READY line. 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-arena and logs/unity.log in the data folder say what it ends on.