cs2-retakes

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

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

Installation

1. Install CounterStrike Sharp and Metamod:Source
2. Download the plugin from the releases section:

• RetakesPlugin-[version].zip - Includes pre-configured map spawns (recommended for new installations)
• RetakesPlugin-[version]-no-map-configs.zip - Without map configurations (for custom setups)

1. Unzip the archive and upload it to the game server into your addons/counterstrikesharp/ directory.
2. Start the server and wait for the config.json file to be generated in addons/counterstrikesharp/configs/plugins/RetakesPlugin.
3. Complete the configuration file with the parameters of your choice.

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

If you'd like to add your own allocator here, make a PR to add it :+1:

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:

GameSettings

| Config | Description | Default | Min | Max | |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|-------|------| | 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 | | MinimumPlayers | The minimum number of human players needed before a retake will start. Below this the server waits in warmup. 0 (default) disables this behaviour; set it to e.g. 2 to enable it. Values above MaxPlayers are clamped. | 0 | 0 | MaxPlayers | | 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 | | 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 |