ed0ard/CS2-Bot-Improver

CS2-Bot-Improver is a plugin for Counter-Strike 2 that improves bots' aim, movement, nade throwing, personalities, strategies, etc. Aims to enhance your experience when playing against bots offline or with friends. It can be installed on both clients and servers.

1,157

488 commits

updated Sep 23, 2026

See the code

README

CS2-Bot-Improver

English · 简体中文 · Русский

Features · Installation · Commands · Panel Guide · FAQ

CS2-Bot-Improver enhances Counter-Strike 2 bots for offline matches and private games with friends. It improves their aim, movement, nade throwing, personalities, strategies, and can be installed on either a client or a dedicated server.

Your stars⭐ are my motivation to keep updating

Features

Field	Improvements
Aim and combat	More accurate, human-like aim; spraying, flicking, smoke spamming, and anti-flash
Grenades	Situational Smoke, Flashbang, HE grenade, and Molotov throwing
Movement	Better movement and fixes for most bot-stuck situations
Strategy	Smarter, more organized bots with improved awareness and decision-making
Economy	Expanded weapon purchases and overhauled economy management
Personalities	Pro and random player names, with pro characteristics based on HLTV stats
Customization	Per-bot knives, gloves, weapon skins, stickers, charms, agents, music kits, avatars, and profiles
Game experience	Bot names without prefixes, bot-friendly rules, and extra console commands for fun

Installation

Download the package for your operating system from the latest release.

Windows

Download and extract CS2BotImprover.zip.

[!NOTE] Running a dedicated server that is not only for bot matches?
On Windows, please download CS2BotImprover_rules_unchanged.zip to preserve the standard game rules.

Move Panel v1.4.4.exe somewhere convenient.
Open your CS2 installation folder and navigate to game/csgo.
Copy all remaining files from the extracted package folder into game/csgo.
Open Panel v1.4.4.exe, select Bot Mode, then click Launch CS2.

Linux

Download and extract CS2BotImprover_for_Linux.zip.
Move Commands.txt somewhere convenient.
Open your CS2 installation folder and navigate to game/csgo.
Copy all remaining files from the extracted package folder into game/csgo.
Add -insecure to your CS2 launch options.

Commands

Aim

Command	Description
`bot_aim mixed`	Select aiming spots dynamically based on situations. (Default)
`bot_aim head`	Prioritize aiming at the head.
`bot_aim body`	Prioritize aiming at the torso.
`bot_aim`	Show the current aim mode.

Nades

Command	Description
`bot_nades off`	Disable bot nade usage.
`bot_nades less`	Use the same decision logic as normal mode with lower count limits.
`bot_nades normal`	Use count limits close to those of human players. (Default)
`bot_nades more`	Use the same decision logic as normal mode with higher count limits.
`bot_nades max`	Bots have minimal limitations and think less before throwing nades.
`bot_nades`	Show the current nade mode.

Skins

Command	Description
`br_reroll`	Reroll every bot's skins on their next spawn.

Buying

Enter a weapon name in the game console to give every bot this weapon from the next round.
Enter bot_buy to restore normal purchase behavior.

Show supported weapon names

elite     p250      fn57      deagle    cz75a     r8
bizon     p90       mp5sd     mp9       mp7       mac10     ump45
mag7      sawedoff  nova      xm1014
famas     galilar   m4a1      m4a1s     ak47      aug       sg556
ssg08     awp       scar20    g3sg1
negev     m249

Pro teams

Copy a block of team commands from Commands.txt and paste it into the game console. You can also add your own teams using the same format.

For example, the following block in Commands.txt adds Team Vitality to the CT side:

Knives

Point at the ground and press \ on your keyboard to generate all kinds of knives there.

Flying Scoutsman

After a match begins, use the command scouts_on or scouts_off to enable or disable Flying Scoutsman mode.

Panel Guide (Windows Only)

Status lights

Indicator	Meaning
🟢 Green	No issues detected. Click the green light near Directory to open it.
🟡 Yellow	Restart CS2 to apply changes.
🔴 Red	Files missing. Click the red light to view the list of missing files.

Green, yellow, and red Panel status indicators

Matchmaking & Bot Mode Toggle

Select your desired mode, then click Launch CS2.

Online Mode and Bot Mode selector in the Panel

Settings

Click the icon in the top-right corner to open Settings.

Command browser

Click Commands, left-click a block to copy it automatically, right-click blocks to copy them consecutively, or type keywords to search.

FAQ

How to play bot matches with friends?

Start a bot match, enter any required commands, and then run status in the console.
Copy the text after steamid:, add connect before it (don't forget the space between them)
Send the full command to your friends and have them paste it into their consoles.

How to manually change the difficulty level?

Navigate to game/csgo/overrides in your CS2 installation folder.
Open Low for easy difficulty, Medium for mixed difficulty based on HLTV stats (default), or High for extreme difficulty.
Copy the selected botprofile.vpk into game/csgo/overrides before launching the game.

How to manually switch back to normal online matchmaking mode?

Navigate to game/csgo/backup/Online in your CS2 installation folder.
Copy gameinfo.gi into game/csgo (Replace the file in the destination).
Remove -insecure from your launch options.

To play with bots again, copy gameinfo.gi from game/csgo/backup/WithBots into game/csgo, and restore the launch option.

How to manually disable bot weapon skins, agents, music kits, knives, and gloves?

Navigate to game/csgo/addons/counterstrikesharp/plugins in your CS2 installation folder.
Rename BotRandomizer folder to BotRandomizer_disabled.
Open addons/counterstrikesharp/configs/core.json and set FollowCS2ServerGuidelines to true.

How to manually disable bot Steam profiles?

Navigate to game/csgo/addons in your CS2 installation folder and rename BotHider folder to BotHider_disabled.

How to use the plugin normally on Workshop maps?

Add -disable_workshop_command_filtering to your launch options.

Panel not working properly?

Install WebView2 Runtime if you are on Windows 10.
Try right-clicking and selecting Run as administrator.

How to surf normally?

Run sv_standable_normal 0.7 in the game console.

What are the supported-use and responsibility boundaries?

[!WARNING] This project is intended for offline bot matches, self-hosted private games with friends, and private dedicated servers used for bot play. BotRandomizer applies cosmetics only to bots; it does not grant, falsify, or alter the Steam inventory, skins, or profile of a human player. This boundary is designed to follow Valve's CS2 community-server and GSLT rules.

The project is not intended or supported for Valve official matchmaking, FACEIT, or other third-party public community servers.

The AGPL-3.0 license does not grant access to third-party services or authorize violations of their rules. To the maximum extent permitted by applicable law, anyone who uses or deploys the project outside the scope described above, modifies it to evade security controls, or otherwise violates third-party terms assumes all resulting risks and responsibilities, including GSLT or server sanctions, FACEIT or community-server bans, VAC or game bans. The maintainers and contributors disclaim liability for those consequences.

Credits

License

GNU Affero General Public License v3.0, except Panel/, which is PolyForm Strict 1.0.0

Contributors

407 commits

29 commits

23 commits

17 commits

Similar repos

NeuTroNBZh/CS2-Retake-Suite

Overview of the CS2 Retake Suite — compatible CounterStrikeSharp plugins by NeuTroNBZh

forest0xia/dota2bot-OpenHyperAI

A beta Dota2 Bot Script aims to provide better bot game experience

293

adamqqqplay/dota2ai

Ranked Matchmaking AI: An improved Dota2 AI based on Valve's default AI. Has more than 3 million…

346

mod-playerbots/mod-playerbots

AzerothCore Playerbots Module

1,110

ryndrb/dota2bot

DotA 2 Bot Script: Tinkering ABo(u)t

VGLALALA/UltraAimer

YOLOv10 Low-Latency Dual-Mode FPS Game Aimbot

Miabeyefendi/SteamEdge

Farm Steam trading cards, boost playtime hours, unlock achievements and sell on the Community…

S3N4T0R-0X0/BEAR-C2

BEAR-C2 is an adversary simulation and emulation framework built around real-world TTPs inspired by…

678

Languages

72.5%

TypeScript

22.9%

CSS

4.6%