Skip to content

๐Ÿ’ฃ Automated Counter-Strike 2 multi-server manager with competitive plugins and tournament integration

Notifications You must be signed in to change notification settings

sivert-io/cs2-server-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

CS2 Server Manager

CS2 Server Manager

๐Ÿ’ฃ Automated multi-server management for Counter-Strike 2 โ€” one script from clean install to tournament-ready

Deploy 3โ€“5 dedicated CS2 servers in minutes. Fully preconfigured with essential competitive plugins, auto-updates, and seamless integration with MatchZy Auto Tournament.

License: MIT Docker Bash

๐Ÿ”— GitHub Repository โ€ข MatchZy Auto Tournament โ€ข Enhanced MatchZy Plugin


โœจ Features

๐Ÿ’ฃ Multi-Server Deployment โ€” Spins up 3โ€“5 dedicated CS2 servers automatically
โš™๏ธ Automated Plugin Installer โ€” Installs Metamod, CounterStrikeSharp, MatchZy (enhanced fork), AutoUpdater
๐Ÿ” Auto-Update Support โ€” Game updates + plugin updates handled for you
๐Ÿ“ฆ Full Override System โ€” Your configs inside overrides/ survive ALL updates
๐Ÿ† Tournament Ready โ€” Fully integrates with
โžก๏ธ MatchZy Auto Tournament
๐Ÿ” Docker-Backed MySQL Setup โ€” Automatic MatchZy database provisioning
๐Ÿ–ฅ Interactive Menu โ€” Install, start, stop, update, debug
๐Ÿ›  Advanced Debug Tools โ€” Tmux console attach, log tailing, repair tools


๐Ÿš€ Quick Start

โš ๏ธ Prerequisites

Install required packages:

sudo apt-get update
sudo apt-get install -y lib32gcc-s1 lib32stdc++6 steamcmd tmux curl jq unzip tar rsync

Install Docker Engine (required):

๐Ÿ‘‰ https://docs.docker.com/engine/install/


๐Ÿงฐ Installation

# Clone and enter directory
git clone https://github.com/sivert-io/cs2-server-manager.git
cd cs2-server-manager

# Recommended: Interactive mode
./manage.sh
# โ†’ Choose Option 1
# โ†’ Default: 3 servers
# โ†’ Wait 15โ€“30 minutes for CS2 download (~60GB)

Non-Interactive (automated defaults)

./manage.sh install

Start Servers

./manage.sh start          # Non-interactive
# OR
./manage.sh                # Interactive menu โ†’ Option 3

๐Ÿ”Œ Included Plugins

Automatically installed & configured during setup:

  • Metamod:Source โ€” Core plugin framework

  • CounterStrikeSharp โ€” Modern C# plugin loader

  • MatchZy Enhanced Fork โ€” Tournament automation version

    • Extra events for MatchZy Auto Tournament
    • Real-time player tracking & match lifecycle
  • CS2-AutoUpdater โ€” Automatic game update daemon


๐ŸŽฎ Usage

Interactive Menu

./manage.sh

Main operations:

  • 1 โ€” Install/redeploy servers
  • 2 โ€” Server status
  • 3/4/5 โ€” Start / Stop / Restart all
  • 12 โ€” Update CS2 game files
  • 13 โ€” Update plugins
  • 15 โ€” Repair without re-download
  • 16 โ€” Debug mode (foreground)

Non-Interactive Commands

./manage.sh install
./manage.sh start
./manage.sh stop
./manage.sh status
./manage.sh update-game
./manage.sh update-plugins
./manage.sh repair
./manage.sh help

Direct Server Management

sudo ./scripts/cs2_tmux.sh start
sudo ./scripts/cs2_tmux.sh start 1
sudo ./scripts/cs2_tmux.sh stop
sudo ./scripts/cs2_tmux.sh status
sudo ./scripts/cs2_tmux.sh attach 1
sudo ./scripts/cs2_tmux.sh debug 1
sudo ./scripts/cs2_tmux.sh logs 1 100

โš™๏ธ Configuration

Server Ports

(Increment by 10 per server)

Server Game Port GOTV Port
1 27015 27020
2 27025 27030
3 27035 27040

Default RCON: ntlan2025 (Change via installer or overrides)


Custom Config Overrides

Place configs in overrides/game/csgo/:

overrides/game/csgo/
โ”œโ”€โ”€ cfg/MatchZy/
โ””โ”€โ”€ addons/

โœ” These files persist through all updates โœ” MatchZy configs remain untouched โœ” Plugin configs remain consistent


๐Ÿ—„๏ธ MatchZy Database (Docker)

  • Reads overrides/.../MatchZy/database.json during install
  • Creates a MySQL container with the specified credentials
  • Exposes port defined in your JSON file
  • Automatically rewrites MySqlHost to your machine IP
  • Ensures all server instances connect correctly

Docker must be running before installation.


๐Ÿ› Troubleshooting

Server won't start

sudo ./scripts/cs2_tmux.sh debug 1

Plugins failing / steamclient.so errors

./manage.sh repair

Logs

sudo ./scripts/cs2_tmux.sh logs 1 100

๐Ÿ“‚ File Structure

/home/cs2/
โ”œโ”€โ”€ master-install/
โ”œโ”€โ”€ server-1/
โ”œโ”€โ”€ server-2/
โ””โ”€โ”€ server-3/

cs2-server-manager/
โ”œโ”€โ”€ scripts/
โ”œโ”€โ”€ game_files/
โ”œโ”€โ”€ overrides/
โ””โ”€โ”€ manage.sh

๐Ÿ”— Related Projects


Made with โค๏ธ for the CS2 community
```