Recipe & VPS deploy

Need a VPS? 24Racks is cheap and runs this project fine. More on picking one in Hosting.

There are three ways in. Pick one.

1. txAdmin recipe - easiest for a fresh server.
2. DEPLOY_VPS.bat - for a Windows VPS you want to update with one double-click.
3. Manual - see Installation.

txAdmin recipe

In the txAdmin setup wizard pick Remote URL Template and paste:

https://raw.githubusercontent.com/Arcainex/bs19/main/recipe.yaml

What the recipe does, in order:

1. Asks txAdmin for a database connection (connect_database).
2. Downloads the framework, the map and server.cfg from GitHub.
3. Downloads the latest oxmysql release into resources/.
4. Writes your license key, the database connection string, the endpoints and sv_maxclients into server.cfg.
5. Adds your txAdmin account as an admin principal at the bottom of server.cfg.

On the database step use your MariaDB host, port 3306 and a user that can create a database. The download is around 700 MB, give it a few minutes. When it’s done hit Save & Run Server and turn OneSync On in Settings > FXServer.

The tables are created on the first boot by bs_core, don’t import any SQL.

DEPLOY_VPS.bat

If you were given the VPS deploy script, run it on the VPS. Run it once to install, run it again later to update. What it does:

• Asks for the server data folder (default C:\FXServer\beyondsurvival).
• Installs Git if it’s missing (winget, or the official installer on Windows Server).
• Clones the repo, or on later runs resets server.cfg and does a git pull --ff-only.
• Installs MariaDB with winget if it can’t find MariaDB or MySQL.
• Creates a beyondsurvival database and a beyondsurvival user with a random password, the same way txAdmin does it. It tries root without a password first and asks only if that fails.
• Saves the connection string in .dbconfig (excluded from git) so later runs never ask again.
• Writes db.cfg with the mysql_connection_string line.

After the first run, in txAdmin pick Existing Server Data, point it at the folder, select server.cfg, and set OneSync On. To update: run the bat again and restart the server.

db.cfg

server.cfg has an exec db.cfg line near the top. db.cfg holds one line:

set mysql_connection_string "mysql://USER:PASSWORD@localhost/beyondsurvival?charset=utf8mb4"

It’s in .gitignore, so git pull never touches it and never conflicts on your password. If you set the server up by hand you can do the same thing: put the line in db.cfg yourself and keep the placeholder line in server.cfg. The exec comes after the placeholder, so the real one wins.

Caution

Never commit or send anyone db.cfg, .dbconfig or server.private.cfg. They have your database password and license key in them.