Daffy's Mods
← All buildsBots

CS:GO Bots

Smarter bots for a private, offline CS:GO LAN server (the legacy 1.38.8.1 build). This is a Valve server plugin that sits on top of the stock CS:GO bots and gives them what they lack: a team plan every round, their own skill levels, hearing, grenades, team-chat callouts and fair matchmaking.

  • Updated Oct 28, 2026
  • 2 pictures
  • 11 updates
CS:GO Bots, first picture

I built it for a home server where kids and grown-ups play together against bots, so the bots go from “easier than Valve’s Easy” to properly sharp, and every behaviour has its own off switch.

Status: Work in progress: it runs on my home LAN server and the bots play full matches with and against real players; it gets tuned after every playtest, and the newest defender setup (2-2-1 from hand-placed spots) has not been through a real match yet. · Visibility: public · Last updated: 2026-10-28

No game files are included: no maps, models, sounds, Valve binaries or anything else from CS:GO. You need your own legal copy of the game. The plugin is made for offline LAN servers only: the server runs with sv_lan 1 and never talks to Steam or Valve.

Screenshots

Bots on the T side of Dust II, one climbing a wall on the way to a bombsite T side on Dust II: the bomb carrier’s teammates take their route; one climbs a wall on the way.

A bot coming through the B tunnels on Dust II, seen from the CT side CT side on Dust II: a bot pushes up the B tunnel stairs.

Contents

Bot features

Everything below is in the plugin today and on by default. Items marked (tuning) work but are still being adjusted after playtests; (partial) means it works with a known gap. Every item can be switched off on a running server (see Configuration), which brings back the earlier behaviour for side-by-side comparison.

The team-play features run in the classic modes (casual, competitive and Wingman) on bomb and hostage maps. The bot director and the elo ratings work in every mode.

Skill levels and personality

Aim and shooting

Hearing and awareness

Movement and footwork

Peeking and angles

Attacking (T side)

Defending (CT side)

Utility (grenades)

Buying and economy

Team play

Callouts and team chat

Matchmaking and difficulty

Map knowledge

Party and server rules

These live in plugin/bots_party.cpp and overlay/csgo/cfg/bots.cfg, and suit a home server where everyone plays in one game:

Safety and testing

Requirements

Install

These steps come from the scripts in this repo. They have only been run on my own server PC, never on a fresh one.

  1. Get the code:

    git clone https://github.com/DaffyDabz/csgo-family-bots.git csgo-bots
    cd csgo-bots
  2. Build and test the plugin. Either run plugin/build.sh as root (it uses a builder image called bots/csgo-gc-builder; any Ubuntu image with g++-multilib works), or build directly:

    cd plugin
    g++ -m32 -O2 -std=c++17 -o test_pick test_pick.cpp bots_party.cpp bots_brain.cpp -lpthread && ./test_pick
    g++ -m32 -O2 -std=c++17 -shared -fPIC -fvisibility=hidden -static-libstdc++ -static-libgcc -Wall \
        -o ../overlay/csgo/addons/bots_party.so bots_party.cpp bots_brain.cpp -lpthread
    cd ..
  3. Build gbe_fork and csgo_gc from their repos and put their files where .gitignore lists them: overlay/bin/steamclient.so (gbe_fork), overlay/srcds_linux and overlay/csgo_gc/csgo_gc.so (csgo_gc).

  4. (Optional) edit bots/roster.txt and regenerate the bot files: python3 bots/make_botprofile.py --elo none.

  5. Put the game files in place. The defaults are /srv/csgo/server-bin (depot 740), /srv/csgo/game (the game install) and /srv/csgo/ds-manifest (the depot 731 manifest, used to symlink the 32 GB of content instead of copying it). To use other folders, export CSGO_SERVER_BIN, CSGO_CLIENT and CSGO_MANIFEST_DIR in the root shell you use for the next two steps (docker-compose.yml reads CSGO_CLIENT too).

  6. As root, copy the server files to /opt/csgo and build the server tree:

    bash deploy.sh --assemble
  7. Start it: /opt/csgo/csgo-ctl.sh start. The server listens on UDP 27025 (RCON on TCP 27025). Allow UDP 27025 through the server PC’s firewall for the LAN.

  8. Maps without a .nav file need one generated once in the server console (sv_cheats 1, nav_generate, then sv_cheats 0). Keep the .nav in overlay/csgo/maps/ and assemble again so make_mapinfo.py can find points for that map.

Only the plugin and the generators are “the bots”; the container scripts are how my server runs them. You can also drop bots_party.so, bots_party.vdf and the files in overlay/csgo/addons/ into any legacy CS:GO Linux server of the same build.

Run

Rank bot_elo Rank bot_elo Rank bot_elo
Silver I 362 Gold Nova I 1103 Master Guardian Elite 1844
Silver II 485 Gold Nova II 1226 Distinguished Master Guardian 1968
Silver III 609 Gold Nova III 1350 Legendary Eagle 2091
Silver IV 732 Gold Nova Master 1474 Legendary Eagle Master 2215
Silver Elite 856 Master Guardian I 1597 Supreme Master First Class 2338
Silver Elite Master 979 Master Guardian II 1721 Global Elite 2462

Placing bot spots

Defenders use spots you place yourself, one map at a time.

  1. Turn on the developer console in your game client (con_enable 1) and join the server.

  2. Stand where a defender should hold, aim where it should look, and crouch if it should hold crouched.

  3. Type one of these in the console (the client passes commands it does not know to the server):

    Command What it does
    bot_asitespot<N> save spot N on A here (the same N again moves it)
    bot_bsitespot<N> save spot N on B
    bot_midspot<N> save mid spot N
    bot_deleteasitespot<N>, bot_deletebsitespot<N>, bot_deletemidspot<N> remove spot N
    bot_spots count this map’s spots

    The number can also be a separate word (bot_asitespot 3). The server answers in chat, for example “A spot 1 saved (1 on A)”.

  4. Spots are saved in csgo/addons/bots_spots/<map>.txt, one line per spot: <A|B|MID> <n> <x> <y> <z> <pitch> <yaw> <crouch>.

Tip: for an empty server while placing, add director 0 to bots_test.txt and kick the bots (/opt/csgo/csgo-ctl.sh cmd "bot_kick"). Delete director 0 afterwards, or no bots will join.

Configuration

File What it holds
overlay/csgo/cfg/bots.cfg the server settings, used in every mode (bots, teams, logging, sv_lan 1)
overlay/csgo/cfg/gamemode_*_server.cfg per-mode extras (bot_quota 0 so the director adds the bots, 30 s warmup in ranked modes)
overlay/csgo/gamemodes_server.txt, mapcycle.txt the mg_bots map group
bots/roster.txt the bots: name, weapon template, starting elo, specialist
csgo/addons/bots_test.txt (on the server) switches and overrides, one name value per line, no comments; re-read live
csgo/addons/bots_spots/<map>.txt hand-placed spots
csgo/addons/bots_maps/<map>.txt generated map points (rebuilt on every assemble)
csgo/addons/bots_elo.json the live elo of every person and bot
csgo/addons/bots_brain.log, bots_party.log the bot brain’s and the plugin’s logs

Environment variables: CSGO_SERVER_BIN, CSGO_CLIENT, CSGO_MANIFEST_DIR (game files), START_MAP, EXTRA_ARGS (server start), CSGO_PORT (for rcon.py). The RCON password is generated on first start into /opt/csgo/rcon_password and never stored in the repo.

The main switches for bots_test.txt (all on, 1, by default unless noted; write name 0 to turn one off):

Switch Turns off
brain_steer team-play steering (plans, holds, rotations); the log keeps running
brain_shoot, brain_gold the shooting dials; the extra Gold-level aim
brain_hear, brain_fire, brain_deathinfo hearing; reacting to being shot; death info
brain_peek, brain_clear, brain_ctface pre-aim and jiggle peeks; corner clearing; defenders facing their entrance
brain_walk, brain_stopshot, brain_safe, brain_move, brain_crouch quiet walk; stop to shoot; safer routes; move-stop-shoot fights; chosen crouching
brain_hand, brain_ctq, brain_ctset, brain_ct the 2-2-1 setup from hand spots; the generated CT setups
brain_ctpush, brain_react, brain_rotate, brain_retake planned pushes; holders fighting and calling pushes; rotation timing; retake rules
brain_plan, brain_callroute, brain_follow, brain_c4fair, brain_post T plan calls; routes matching the call; following the bomb; fair bomb carrier; post-plant
brain_util, brain_nade grenade buying and throwing; the teammate check
brain_dials, brain_kidbuy, brain_riflefirst per-bot dial offsets; beginner buys; rifle first
brain_cover (off by default) hiding at the nearest covered spot
director the bot director (director 0 = no bots are added)
bot_elo <elo>, target <elo> (overrides) the bots’ level; the target elo when no human is on
rate_bots 1 (test) rate bot-only matches too

Most switches have finer sub-switches and test values; they are listed in the comment block at the top of each part in plugin/bots_brain.cpp.

How it works

plugin/ is a Valve server plugin (ISERVERPLUGINCALLBACKS002) for the 32-bit Linux server. It needs no Source SDK: the few engine interfaces it uses are called through their vtables.

If the memory layout ever does not match, steering switches itself off for that map and the stock bots play.

Project layout

Path What
plugin/bots_party.cpp the plugin object, party rules, roster, director, elo, log reader
plugin/bots_brain.cpp the bot brain (round plans, steering, dials, shooting, hearing, utility, …)
plugin/bots_logic.h pure decision rules shared with the unit tests
plugin/test_pick.cpp unit tests (run before every build)
bots/make_botprofile.py roster.txt -> botprofile.db, bots_roster.txt, bots_dials.txt
bots/make_mapinfo.py map points from .nav + .bsp (test_mapinfo.py = its tests)
overlay/ server configs and generated bot files copied over the server install
Dockerfile, docker-compose.yml, entrypoint.sh, assemble.sh, deploy.sh, csgo-ctl.sh the server container
rcon.py, udptcp.py small RCON client; UDP-over-TCP hop for a client on the same PC as a WSL server
tools/botrank.py the 18 CS:GO ranks to bot elo; reads and writes the bot_elo line

Development

Coming soon

Keep this list current: when an item ships, move it to Recent changes with the date, then add what is next.

Recent changes

Credits and license

The plugin, scripts and configs here are by DaffyDabz, released under the MIT License. Valve’s game and its stock bot AI are not covered.

More builds

BotsToontown Classic with BotsToontown Online as it played at its September 2013 shutdown, on your own PC, with a town full of bot toons that play like real players.Updated Oct 4, 20266 picturesBotsClub Penguin BotsBot penguins for a private Waddle Forever Club Penguin server.Updated Oct 28, 20263 picturesGames & modsCustom Toontown ServerMy own take on Toontown Online, built on Open Toontown (the open-source Toontown client and server).Updated Oct 28, 20266 pictures