Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CS-Jukebox V2

Play your own custom, reactive music kits in Counter-Strike 2 using official Game State Integration.

Demo.mp4
Logo

🚀 Getting Started

Prerequisites & Download

  1. Download the latest compiled package: Download the latest CS-Jukebox V2 release (Windows only)

  2. Extract the .rar archive to a folder on your PC.


📦 Installation & First-Time Setup

  1. Launch CS-Jukebox.exe

  2. The application will prompt you to select your CS2 root directory.

Navigate to:

...\Steam\steamapps\common\Counter-Strike Global Offensive\game
  1. If Counter-Strike 2 is already running, restart the game after setup to initialize the integration.

🛠️ Troubleshooting — Directory Detection

The application automatically checks the Steam installation and all libraries listed in libraryfolders.vdf. If detection fails, manually select the CS2 game folder containing both bin\win64\cs2.exe and csgo\cfg.

Audio playback uses NAudio and does not require Windows Media Player. MP3 and WAV are the recommended formats; AAC, M4A, and WMA availability may depend on Windows Media Foundation codecs.


🎵 Custom Music Kit Approximate Duration Guide

Event / Track Minimum Length Ideal Duration Behavior & Engine Context
Main Menu Loopable Ambient / Seamless Loops continuously while in game lobby or main menu.
Freeze Time 10 sec 10–15 sec Plays during buy phase (15 sec timer).
Round Start 5 sec 5–10 sec Plays at round start; automatically fades out after 5s.
Bomb Planted 30 sec 30 sec Plays on plant (Premier bomb timer is 40 sec total).
10-Sec Warning 10 sec Exactly 10 sec Plays when exactly 10s remain on bomb or round timer.
MVP Anthem 7 sec 7 sec Round MVP anthem. Fades out at 7s when next freeze phase loads.
Round Won / Lost 7 sec 7 sec Fallback round-end audio when you are not the MVP.
Player Death 3 sec 3–5 sec Secondary overlay audio cue played when local player dies.

Configuration Steps

  1. Click Add on the dashboard.
  2. Enter a unique name for your music kit.
  3. Click Browse next to each event trigger and assign audio files.
  4. Click Save.

⚙️ How It Works

CS-Jukebox uses Valve’s official Game State Integration (GSI) system to react to real-time gameplay events such as:

  • Round phases
  • Bomb states
  • Team changes
  • MVP events

The application:

  • Does not inject code
  • Does not modify game memory
  • Does not bypass anti-cheat systems

✅ 100% VAC Safe


❤️ Support the Project

If you enjoy CS-Jukebox V2 and want to support future updates, you can donate here:

PayPal: https://www.paypal.com/paypalme/TYFALY

Support is completely optional, but always appreciated.


👥 Credits

  • Original framework architecture by rakijah (CSGSI)
  • CS2 endpoint migration & updates by TimosCodd
  • Playback loop fixes, UI improvements & V2 distribution by TYFALY

About

Play custom reactive music kits in Counter-Strike 2 using official, 100% VAC-safe Game State Integration (GSI). Fixed V2 release.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages