Bundled server configs

For the bundled jaPRO game module only

These files configure TaystJK’s bundled jampgame: the jaPRO-based game module in the taystjk mod directory. They depend on its settings and commands, such as jaPRO’s tweak bitmasks, restricts, the gametype command and vote options run through vstr. Another mod’s game module does not implement most of them.

The Docker image copies them into basepath/taystjk/ (Dockerfile). A dedicated server looks for configs only in base and in the directory fs_game selects, because dedicated builds leave fs_forcegame empty (files.cpp). If you set TJK_MOD to another mod, none of these files load, and the server starts from that mod’s own configuration instead; see running another mod.

Native releases do not include them. To use them outside Docker, copy the .cfg files from scripts/docker/ in the source repository into your taystjk/ directory, then launch with +exec server.cfg. Or build a set with the server config generator: its Bundled preset and jaPRO modes come from these files, with your server settings filled in.

What loads at startup

The server only runs server.cfg itself, and that file loads the rest:

server.cfg applies its own settings, then runs exec bans (line 49), exec votes (line 52) and exec default (line 110), and finally loads the map (line 122).

There is no map rotation. Each map load sets nextmap to restart the same map (sv_init.cpp), so when a match ends the current map restarts, and players change maps with callvote map. If you want the server to move on by itself, set g_autoMapCycle 1 in server.cfg; the game then picks the next map for the current gametype from the arena files (g_bot.c).

Server settings and gameplay are kept apart

server.cfg holds everything about running the server, and default.cfg holds only gameplay. Every mode runs default.cfg again when it loads, so loading one never changes your hostname, password, player limit or admin setup.

Four settings belong to the modes and go back to the baseline whenever a mode loads: which votes are allowed (g_allowVote) and the time, frag and capture limits. Put a limit you want in the mode’s file, or let players vote for one.

The baseline also sets restricts to 1550 (default.cfg). On TaystJK and jaPRO clients that hides the lead indicator, disables /do, and holds the third-person camera angle at 0 while racing. Two of its bits are defined but never read, so they do nothing.

server.cfg runs exec default before the first map for a second reason. On shutdown the server saves most of these settings to taystjk_server.cfg and loads them again at the next start (see the server rewriting its config). Without the reset, a restarted server would begin in FFA with the last mode’s weapons and force powers still applied.

Passwords

server.cfg ships three passwords near the top, all empty. Fill them in:

set rconpassword "replace-with-a-long-random-secret"
seta g_fullAdminPass "replace-with-another-secret"
seta g_juniorAdminPass "and-a-third"

An empty value disables that login. jaPRO server setup explains what the two admin logins grant and the other ways to give out admin rights.

Keep rconpassword in server.cfg, on a line that starts with set or seta. When Docker stops the container, the run script sends rcon quit so the server shuts down cleanly (run.sh), and it finds the password only by reading that line of server.cfg (functions.sh). Without it, the script has nothing to send, and Docker kills the server when its stop timeout runs out.

Game modes

Load a mode from the server console or with rcon exec <mode>, or let players vote for it with callvote vstr <mode>. Every mode first runs default.cfg, then applies its own settings, then reloads the map with map_restart 0 (for example). The reload is what makes the change complete: weapons and items on the map, and settings the engine only applies on a map load, change then and not before. It also resets the scores.

A mode that does not choose a gametype plays FFA, because default.cfg switches back to FFA with gametype 0 (default.cfg). In the table, “force limited to jumping and saber skills” means g_forcePowerDisable leaves only levitation and saber offense and defense.

The rabbit modes need a map with a neutral flag, and the one-flag modes also need capture zones; the stock maps have neither. The g_neutralFlag entry describes each variant and what a map must provide.

The three Tribes modes share their settings through tribesbase.cfg (tribes.cfg), so each reloads the map only once. Players need the client-side setup as well; see Tribes.

Pickup add-ons

pickups, nopickups and noboons switch groups of pickups on or off on top of whatever is running:

They set disable_<item> cvars, which the game reads only when it spawns items (g_items.c), so follow one with map_restart, or the restart vote. The baseline in default.cfg already leaves seekers, portable shields, light-side enlightenment and detpack pickups off.

Vote options

votes.cfg defines what players can vote for. Each option is a cvar holding console commands, and callvote vstr <option> runs them if the vote passes (votes.cfg). The baseline allows three kinds of vote: map, vstr and poll (default.cfg). fftffa, merc, saberctf and saberonly allow a few more, such as forcing a player to spectate.

togglefullhp and togglejetpack each flip one starting item with the startingItems command and keep the rest of the mode’s items, so a second vote flips it back. The gametype options switch without reloading the map (g_svcmds.c), while options that change weapons or pickups on the map take effect after a restart vote.

To add an option, put a set line in votes.cfg, for example set mymode "exec mymode".

How voting works, including which votes the server allows and why a vstr vote can name any server cvar, is covered in jaPRO server setup.

Bans

bans.cfg holds two settings:

• g_filterBan 1 blocks the listed addresses; 0 admits only the listed addresses, which makes a private server.
• g_banIPs is the list itself. It ships commented out.

Bans you add with addip or amBan are saved in g_banIPs and survive a restart; see bans for the commands and address ranges.

To keep the list in the file instead, uncomment the g_banIPs line. It then replaces the saved list at every start, so copy any addip bans into it first. Separate the addresses with spaces and end the list with a space: the game ignores a last address with nothing after it (g_svcmds.c).

seta g_banIPs "1.2.3 203.0.113.7 "

Change a file

Override any of these files the same way as server.cfg: copy it from the image into homepath/taystjk/, where it takes priority over the image’s copy and survives image updates. For example, to edit the vote options:

docker compose cp \
  taystjk:/opt/taystjk/basepath/taystjk/votes.cfg \
  ./homepath/taystjk/votes.cfg

A mode’s file is read again every time the mode loads, so an edited mode takes effect the next time it runs. Run rcon exec votes to reload edited vote options, and restart the server after changing server.cfg. On a native server, edit the copies in your taystjk/ directory.

Last changed 26 September 2026 History Edit this page on GitHub