ed0ard/CS2-Bot-Improver · 1.3K Stars · GitHub 趋势

📦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.

⚖️ AGPL-3.0📅 创建于 2026-03-13🔄 更新于 2026-10-29

🔗 GitHub TypeScript

📄 仓库 README

在 GitHub 查看 ↗

来自 GitHub 仓库自述文件 · 版权归原作者所有

# CS2-Bot-Improver [![Latest release](https://img.shields.io/github/v/release/ed0ard/CS2-Bot-Improver?display_name=tag&sort=semver)](https://github.com/ed0ard/CS2-Bot-Improver/releases/latest) [![Release downloads](https://img.shields.io/github/downloads/ed0ard/CS2-Bot-Improver/total)](https://github.com/ed0ard/CS2-Bot-Improver/releases) [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE) ![Platforms: Windows and Linux](https://img.shields.io/badge/platform-Windows%20%7C%20Linux-5c6bc0) **English** · [简体中文](https://github.com/ed0ard/CS2-Bot-Improver/blob/HEAD/docs/README.zh-CN.md) · [Русский](https://github.com/ed0ard/CS2-Bot-Improver/blob/HEAD/docs/README.ru.md) [Features](#features) · [Installation](#installation) · [Commands](#commands) · [Panel Guide](#panel-guide-windows-only) · [FAQ](#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.

Signature status

[![Signature status](https://raw.githubusercontent.com/XBribo/cs2-bot-signatures/main/.github/docs/BotImprover.svg)](https://github.com/XBribo/cs2-bot-signatures)

Your stars⭐ are my motivation to keep updating

Features

Field	Improvements
Aim and combat	More accurate, human-like aim and FOV; 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.7.exe somewhere convenient.

CS2 Bot Improver Panel application icon

Open your CS2 installation folder and navigate to game/csgo.

The game/csgo directory inside a CS2 installation

Copy all remaining files from the extracted package folder into game/csgo.

Copying the Windows package files into game/csgo

Open Panel v1.4.7.exe, select Bot Mode, then click Launch CS2.

Selecting Bot Mode and launching CS2 from the Panel

Linux

Download and extract CS2BotImprover_for_Linux.zip.
Move Commands.txt somewhere convenient.
Open your CS2 installation folder and navigate to game/csgo.

The game/csgo directory inside a CS2 installation

Copy all remaining files from the extracted package folder into game/csgo.

Copying the Linux package files into game/csgo

Add -insecure to your CS2 launch options.

Opening CS2 properties in Steam
Adding -insecure to the 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:

Team Vitality commands in Commands.txt

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.

Rules

Open Settings and click Rules to adjust game rules.

Click Reset All to restore default rules.

Rules

Command browser

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

Searchable command browser in the Panel

FAQ

How to play bot matches with friends?

1. Start a bot match, enter any required commands, and then run `status` in the console. The steamid value shown by the status command

2. Copy the text after `steamid:`, add `connect ` before it (don't forget the space between them) 3. Send the full command to your friends and have them paste it into their consoles.

How to manually change the difficulty level?

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

How to manually switch back to normal online matchmaking mode?

1. Navigate to `game/csgo/backup/Online` in your CS2 installation folder. 2. Copy `gameinfo.gi` into `game/csgo` (Replace the file in the destination). 3. 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?

1. Navigate to `game/csgo/addons/counterstrikesharp/plugins` in your CS2 installation folder. 2. Rename `BotRandomizer` folder to `BotRandomizer_disabled`. 3. 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?

1. Install **WebView2 Runtime** if you are on Windows 10. 2. 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

📈 近 7 天 Star 趋势

每日新增 Star（柱）与累计 Star（线）· 数据来自 GitHub

🏆 排名变化趋势

在各榜单中的排名历史（数字越小越靠前）

📋 历史上榜记录

每次快照的详细数据

日期	榜单	排名	周期新增	总 STAR