Skip to content

OmniBot

Jump to bottom
Claude edited this page Apr 15, 2026 · 1 revision

OmniBot

Jaymod has native support for OmniBot -- an AI bot framework providing bot players for Enemy Territory servers. No special Jaymod configuration is needed beyond enabling it and pointing it at the bot files.

Requirements

  • OmniBot 0.81 or compatible
  • OmniBot ET game library (et_omnibot.dll on Windows, et_omnibot.so on Linux)
  • Waypoint files for your maps

Enabling bots

Add to your server config:

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

Bots will join automatically when a map loads, provided waypoints are available for that map.

Directory layout

Place the OmniBot files under your jaymod folder:

etlegacy/jaymod/
  omni-bot/
    omni-bot.cfg
    et_omnibot.dll  (Windows)
    et_omnibot.so   (Linux)
    nav/            (waypoint files)
    scripts/
    user/
      omni-bot.cfg  (user overrides)

Library search path

Jaymod searches for the OmniBot library in this order:

Linux

  1. Directory from the omnibot_path cvar
  2. fs_homepath/omni-bot
  3. fs_basepath/omni-bot
  4. $HOME/omni-bot
  5. System dynamic loader path

Note: On Linux, relative paths require . to be in PATH.

Windows

  1. Directory from the omnibot_path cvar
  2. fs_homepath/omni-bot
  3. fs_basepath/omni-bot
  4. Program Files/Omni-bot
  5. System DLL search path

Controlling bots in-game

Issue from the server console:

bot addbot [class]    (class: soldier, medic, engineer, lt, covertops)
bot kick [name]
bot minbots [n]
bot maxbots [n]

Cvar reference

Cvar Default Description
g_OmniBotEnable 0 Enable OmniBot integration
g_OmniBotPath (empty) Path to the omni-bot directory
g_OmniBotFlags 0 OmniBot behaviour flags (see OmniBot docs)
g_OmniBotPlaying - Number of active bots (read-only)

Troubleshooting

Bots do not join: Check that g_OmniBotPath points to a directory containing the OmniBot library and that waypoints exist for the current map.

Library not found: On Linux, ensure the .so file is executable and the path is correct. Try setting an absolute path in g_OmniBotPath.

Bots crash on connect: This was a known ABI issue when the game module was compiled with GCC instead of MSVC. Jaymod 2.2.0+ includes the ABI fix -- make sure you are using the latest release.

Clone this wiki locally