kraigher/cs2-retakes

CS2 implementation of retakes. Based on the version for CS:GO by Splewis.

CS2 Retakes

CS2 implementation of retakes written in C# for CounterStrikeSharp. Based on the version for CS:GO by Splewis.

Share the love

If you appreciate the project then please take the time to star the repository 🙏

Features / Roadmap

• Bombsite selection
• Per map configurations
• Ability to add spawns
• Spawn system
• Temporary weapon allocation (hard coded)
• Temporary grenade allocation (hard coded)
• Equipment allocation
• Queue manager (Queue system)
• Team manager (with team switch calculations)
• Retakes config file
• Add translations
• Improve bombsite announcement
• Queue priority for VIPs
• Add autoplant
• Add a command to view the spawns for the current bombsite
• Add a command to delete the nearest spawn
• Implement better spawn management system
• Add a release zip file without spawns too

Installation

• Download the zip file from the latest release, and extract the contents into your counterstrikesharp/plugins directory.
• Download the shared plugin zip file and put it into your counterstrikesharp/shared directory.

Recommendations

I also recommend installing these plugins for an improved player experience

• Instadefuse: https://github.com/B3none/cs2-instadefuse
• Clutch Announce: https://github.com/B3none/cs2-clutch-announce
• Instaplant (if not using autoplant): https://github.com/B3none/cs2-instaplant

Allocators

Although this plugin comes with it's own weapon allocation system, I would recommend using one of the following plugins for a better experience:

• Yoni's Allocator: https://github.com/yonilerner/cs2-retakes-allocator
• NokkviReyr's Allocator: https://github.com/nokkvireyr/kps-allocator
• Ravid's Allocator: https://github.com/Ravid-A/cs2-retakes-weapon-allocator

Configuration

When the plugin is first loaded it will create a retakes_config.json file in the plugin directory. This file contains all of the configuration options for the plugin:

Config	Description	Default	Min	Max
Version	The retakes config version. This is used to automatically migrate the retakes config file for you. ignore this value.	IGNORE	IGNORE	IGNORE
MaxPlayers	The maximum number of players allowed in the game at any time. (If you want to increase the max capability you need to add more spawns)	9	2	10
TerroristRatio	The percentage of the total players that should be Terrorists.	0.45	0	1
RoundsToScramble	The number of rounds won in a row before the teams are scrambled.	5	-1	99999
IsScrambleEnabled	Whether to scramble the teams once the RoundsToScramble value is met.	true	false	true
EnableFallbackAllocation	Whether to enable the fallback weapon allocation. You should set this value to false if you're using a standalone weapon allocator.	true	false	true
EnableBombsiteAnnouncementVoices	Whether to play the bombsite announcement voices. The volume for these values is client sided snd_toolvolume.	true	false	true
EnableBombsiteAnnouncementCenter	Whether to display the bombsite in the center announcement box.	true	false	true
ShouldBreakBreakables	Whether to break all breakable props on round start (People are noticing rare crashes when this is enabled).	false	false	true
ShouldOpenDoors	Whether to open doors on round start (People are noticing rare crashes when this is enabled).	false	false	true
IsAutoPlantEnabled	Whether to enable auto bomb planting at the start of the round or not.	true	false	true
ShouldForceEvenTeamsWhenPlayerCountIsMultipleOf10	Whether to force even teams when the active players is a multiple of 10 or not. (this means you will get 5v5 @ 10 players / 10v10 @ 20 players)	true	false	true

Commands

Command	Arguments	Description	Permissions
!showspawns	<A / B>	Show the spawns for the specified bombsite.	@css/root
!addspawn	<CT / T> <Y / N (can be planter)>	Adds a retakes spawn point for the bombsite spawns currently shown.	@css/root
!removespawn		Removes the nearest spawn point for the bombsite currently shown.	@css/root
!nearestspawn		Teleports the player to the nearest spawn.	@css/root
!hidespawns		Exits the spawn editing mode.	@css/root
!scramble		Scrambles the teams next round.	@css/admin
!voices		Toggles whether or not to hear the bombsite voice announcements.
css_debugqueues		SERVER ONLY Shows the current queue state in the server console.

Stay up to date

Subscribe to release notifications and stay up to date with the latest features and patches:

Credits

This was inspired by the CS:GO Retakes project written by splewis.