[SwiftlyS2] Retakes

Made by aga

Overview

SwiftlyS2-Retakes is a CS2 retakes game mode for SwiftlyS2.

It handles:

• Round Flow — automatic site selection, freeze time management, and round cleanup
• Automatic Bomb Planting — bomb is planted at freeze end at the selected site
• Instant Plant & Defuse — instant plant support and smart instant defuse logic with molly/enemy checks
• Weapon Allocation — dynamic weapon, armor, and utility distribution based on round type
• Weapon Preferences — persistent menus for players to choose their preferred loadouts
• Grenade Allocation — configurable per-round-type grenade distribution (random, fixed, or damage-based dynamic)
• Map Configurations — custom per-map JSON configs for spawns and smoke scenarios
• Spawn Editor — comprehensive in-game tools for managing spawns and smokes
• Queue System — max player limits, spectator queues, and late joiner handling
• Smoke Scenarios — pre-defined smokes that can be forced or randomly spawned
• AFK Manager — automatically moves inactive players to spectator or kicks them
• Anti Team-Flash — blocks teammates from being blinded by friendly flashes
• Solo Bot System — automatically spawns a bot when only one human is present
• World Breaker — automatically breaks glass and opens doors at round start
• Damage Reports — per-opponent damage summary at the end of each round
• Clutch Announcements — notifies players of 1vX clutch situations
• Native Message Suppression — suppresses redundant game messages for a cleaner chat

Support

Download Shortcuts

Plugin - https://github.com/a2Labs-cc/SwiftlyS2-Retakes/releases/latest Cookies - https://github.com/SwiftlyS2-Plugins/Cookies/releases/latest SwiftlyS2 - https://github.com/swiftly-solution/swiftlys2/releases/latest

Dependencies

Note: Without the Cookies plugin, player preferences will not be saved between sessions — all settings reset on disconnect.

Installation

1. Download or build the plugin.
2. Install the Cookies plugin.
3. Copy the published plugin folder to your server:

   .../game/csgo/addons/swiftlys2/plugins/Retakes/

4. Ensure the resources/ folder is alongside the DLL (maps, translations, gamedata).
5. Start or restart the server.

Player Preferences

The plugin saves player preferences using the Cookies plugin. All preferences persist between sessions and are loaded automatically on connect.

What Gets Saved

Configuration

Weapon Allocation

Round Types

Round Type Selection

RoundType modes:

"Allocation": {
  "RoundType": "sequence",
  "RoundTypeSequence": [
    { "Type": "Pistol",  "Count": 3  },
    { "Type": "HalfBuy", "Count": 2  },
    { "Type": "FullBuy", "Count": 25 }
  ]
}

Weapon Selection

Weapon selection priority (human players):

1. Player's saved preference (from !guns)
2. Configured default loadout (Weapons.Defaults.*)
3. Random weapon from the allowed list

Bots always receive a random weapon from the allowed list.

Allowed Weapon Lists

Configured under Weapons:

Default Loadouts

Used when a player has no saved preference yet. Player selections always override these.

"Weapons": {
  "Defaults": {
    "Pistol": {
      "Primary": { "T": "weapon_glock", "Ct": "weapon_usp_silencer" },
      "Secondary": { "T": null, "Ct": null }
    },
    "HalfBuy": {
      "Primary": { "T": "weapon_galilar", "Ct": "weapon_famas" },
      "Secondary": { "T": "weapon_glock", "Ct": "weapon_usp_silencer" }
    },
    "FullBuy": {
      "Primary": { "T": "weapon_ak47", "Ct": "weapon_m4a1_silencer" },
      "Secondary": { "T": "weapon_glock", "Ct": "weapon_usp_silencer" }
    }
  }
}

AWP Allocation

Only on full-buy rounds. Players must toggle !awp to be eligible.

Scout (SSG08) Allocation

Only on full-buy rounds. Players who receive an AWP are excluded.

Weapon Stripping

Grenade Allocation

Grenades are configured separately from primary weapons, with three distinct allocation modes.

Allocation Modes

Per-Round Grenade Lists

Configured under Grenades.Pistol, Grenades.HalfBuy, and Grenades.FullBuy. Each has a T and Ct sub-object with three fields:

"Grenades": {
  "AllocationType": "dynamic",
  "FullBuy": {
    "T": {
      "RandomChances": { "weapon_smokegrenade": 100, "weapon_flashbang": 70, "weapon_molotov": 45 },
      "Fixed": [ "weapon_smokegrenade", "weapon_flashbang", "weapon_molotov" ],
      "DynamicPool": [ "weapon_smokegrenade", "weapon_flashbang", "weapon_flashbang", "weapon_hegrenade", "weapon_molotov" ]
    },
    "Ct": {
      "RandomChances": { "weapon_smokegrenade": 100, "weapon_flashbang": 70, "weapon_incgrenade": 45 },
      "Fixed": [ "weapon_smokegrenade", "weapon_flashbang", "weapon_incgrenade" ],
      "DynamicPool": [ "weapon_smokegrenade", "weapon_flashbang", "weapon_flashbang", "weapon_hegrenade", "weapon_incgrenade" ]
    }
  }
}

Dynamic Mode Settings

How DynamicTopFraction works:

The DynamicPool is distributed round-robin starting from the highest-damage player. If a player reaches DynamicMaxPerPlayer, they are skipped and the grenade moves to the next eligible player.

Per-Grenade Cap

Applies across all allocation modes.

Default caps (reflecting CS2 inventory limits):

"MaxPerGrenade": {
  "weapon_flashbang":   2,
  "weapon_smokegrenade": 1,
  "weapon_hegrenade":   1,
  "weapon_molotov":     1,
  "weapon_incgrenade":  1,
  "weapon_decoy":       1
}

Grenades not listed here are uncapped.

Player

Quick Weapon Select (!gun)

Type !gun <weapon> to change your weapon preference instantly — no menu needed. Swaps the weapon in-hand immediately.

Accepted formats:

• Entity names: weapon_ak47, weapon_m4a1_silencer
• Short names: ak, ak47, deag, usp, m4a1s, scout, galil, p250, cz, r8, etc.
• Display names: AK-47, M4A1-S, USP-S

Behaviour:

• Validates against the current round type
• Assigns to the correct slot (primary or secondary) automatically
• Reports if the weapon is not allowed this round or is already set

Examples:

!gun ak      → sets AK-47 as your full-buy/half-buy primary
!gun usp     → sets USP-S as your secondary
!gun m4a1s   → sets M4A1-S as your CT primary

Debug

Map Configs

Map configs live in:

plugins/Retakes/resources/maps/*.json

Each file contains the spawn positions used by the retakes allocator. A template is available at resources/templates/template.jsonc.

Building

dotnet build

Credits

• Readme template by criskkky
• Release workflow based on K4ryuu/K4-Guilds-SwiftlyS2
• All spawns based on B3none/cs2-retakes
• Inspired by itsAudioo/CS2BombsiteAnnouncer
• Inspired by yonilerner/cs2-retakes-allocator