Skip to content

Installation

Jump to bottom
Claude edited this page Apr 15, 2026 · 2 revisions

Installation

Jaymod runs entirely on the server. Players connect with a standard ET Legacy client — no mod installation is required on the client side.

Requirements

Platform Minimum
Linux x86 32-bit, GLIBC 2.3.2+, Pentium III 600 MHz
Windows 98/ME/2000/XP, Pentium III 600 MHz, DirectX 8.1+
ET version 2.60b (ET Legacy recommended)

Step 1 — Download

Download the latest release from the Releases page.

The release archive (jaymod-2.2.x.tar.gz) contains:

jaymod-2.2.x/
  jaymod-2.2.x.pk3      ← mod assets
  jaymod.cfg            ← example server config
  omni-bot/             ← OmniBot config and waypoints
  game/
    qagame_mp_x86.dll   ← Windows game module
    qagame_mp_x86.so    ← Linux game module

Step 2 — Create the server directory layout

Create a dedicated user account for the server (recommended on Linux):

useradd -m etserver

Set up the directory structure:

etlegacy/
  etmain/
  jaymod/
    jaymod/mapscripts/   ← optional extended mapscripts
    jaymod/mapconfigs/   ← optional per-map configs
  log/

Step 3 — Install the mod files

Copy the contents of the release archive into the jaymod/ folder:

etlegacy/jaymod/
  jaymod-2.2.x.pk3
  jaymod.cfg
  omni-bot/
  game/
    qagame_mp_x86.dll   (Windows)
    qagame_mp_x86.so    (Linux)

Remove any stale etconfig.cfg files that may override your settings:

rm -f etmain/etconfig.cfg jaymod/etconfig.cfg
rm -f ~/.etwolf/etmain/etconfig.cfg ~/.etwolf/jaymod/etconfig.cfg

Step 4 — Configure the server

Edit jaymod.cfg. See Configuration & Cvars for the full reference. A minimal starting config:

// jaymod.cfg
set sv_hostname     "My Jaymod Server"
set g_motd          "Welcome to my server!"
set g_friendlyFire  1
set g_announceHP    1
set g_dynamiteTimer 1

// Admin system
set g_admin         1

// XP Save
set g_xpSave        1
set g_xpSaveTimeout "1h"

// Map rotation
set d1 "map supplydepot"
set d2 "map goldrush"
set d3 "map battery"
vstr d1

Step 5 — Start the server

Linux

./etlded +set fs_game jaymod +exec jaymod.cfg

Windows

etlded.exe +set fs_game jaymod +exec jaymod.cfg

Use a startup script (e.g. serverctl) to manage start/stop/restart — see Server Operation.

Step 6 — Grant yourself admin access

Connect to the server, then from the server console:

!useredit <yourname> level 100

This gives your account the highest admin level. See Admin System for the full privilege model.

Step 7 — OmniBot (optional)

To enable AI bots add to your config:

set g_OmniBotEnable 1
set g_OmniBotPath   "jaymod/omni-bot"

Bots join automatically when the map loads. See OmniBot for details.

Upgrading from a previous version

  1. Shut down the server
  2. Back up user.db, level.db, map.db and your configs
  3. Replace qagame_mp_x86.so / .dll and the .pk3 with the new versions
  4. Remove etconfig.cfg files
  5. Start the server

Note: If upgrading from pre-2.1.0, g_xpSave changed from a filename to a 0/1 toggle, and g_censor changed from a word-list to a 0/1 toggle (words now in censor.db). Use the convert_shrub Perl script to migrate shrubbot.cfg to the new database format.

Clone this wiki locally