CounterStrikeSharp plugin for CS2 Retake servers - Automatic map cleanup

BreakerAndOpenDoor is a CounterStrikeSharp plugin for Counter-Strike 2 Retake servers. It automates map cleanup at the start of each round by opening doors and breaking destructible elements (windows, vents, objects).

Retake servers need predictable map state every round. This plugin enforces a clear policy:

• open doors (never break them)
• break windows, vents, and other breakables
• support random door opening with stable per-round decisions

• Door safety rule: door entities are always open-only targets
• Multi-pass execution: immediate + delayed + extra + late + freeze_end
• Robust fallback: multiple break inputs and vent/window fallback path
• Unknown probing: optional probe mode for map-specific dynamic entities
• Diagnostics: candidate dump command for fast map tuning

• Active stable line: v1.0.1
• If a tag fails in CI, it is replaced by a clean patch release and documented.

1. Download the latest release: breakerandopendoor.zip
2. Extract the archive
3. Copy the addons folder to your server's game/csgo/
4. Restart the map or server

Click the button below to deploy automatically:

Configuration file:

addons/counterstrikesharp/configs/plugins/breakerandopendoor/breakerandopendoor.json

The plugin supports two practical modes:

1. Minimal Production Mode (recommended)

• small config, lower maintenance
• relies on safe built-in defaults
• best for most servers

Default shipped config uses this mode:

{
  "ConfigVersion": 1,
  "EnableOpenDoors": true,
  "DoorOpenChancePercent": 70,
  "EnableBreakWindows": true,
  "EnableBreakVents": true,
  "EnableBreakOtherBreakables": true
}

2. Debug / Map Tuning Mode

• full control over timing, probing and classname lists
• useful when a custom map has stubborn vents/windows

Reference preset:

• docs/config-debug-map-tuning.json

• Pass timing: EnableSecondPassAfterDelay, SecondPassDelaySeconds, AdditionalPassCount, AdditionalPassIntervalSeconds, EnableLateRoundStartPass, LateRoundStartDelaySeconds, EnableFreezeEndPass, FreezeEndPassDelaySeconds
• Fallback control: EnableKillFallbackForVentWindow, EnableRemoveFallbackForVentWindow
• Probe control: ProbeUnknownEntitiesForBreakInput, UnknownProbeMaxPerPass, UnknownProbeClassNameTokens
• Diagnostics: VerboseLogging, DebugDumpMaxLines
• Entity lists: DoorClassNames, BreakableClassNames, ExcludedClassNames

If your server already works, keep only Minimal Production Mode.

• Counter-Strike 2 Dedicated Server
• Metamod:Source
• CounterStrikeSharp (runtime recommended)

Server console command:

css_bod_dump_break_candidates

This command displays candidate entities (index + classname) to help identify stubborn vents/windows on specific maps.

powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1

dotnet build src/BreakerAndOpenDoor/BreakerAndOpenDoor.csproj -c Release

Output:

• artifacts/release/breakerandopendoor/
• artifacts/release/breakerandopendoor.zip

breakerandopendoor/
├── src/
│   └── BreakerAndOpenDoor/      # Plugin source code
│       ├── Core/               # Business logic
│       ├── Config/             # Configuration
│       ├── Adapters/           # Adapters
│       └── Host/               # Entry point
├── addons/
│   └── counterstrikesharp/
│       └── configs/plugins/breakerandopendoor/  # Default config
├── scripts/
│   ├── build-release.ps1       # Build script
│   └── publish-github.ps1      # Publish script
└── .github/workflows/
    ├── ci.yml                  # CI/CD
    └── release.yml             # Automatic release

If someone needs to continue this plugin professionally, use:

• docs/MAINTAINER-HANDOVER.md

Release process summary:

1. Merge tested changes to main
2. Ensure CI passes
3. Create semantic tag (vMAJOR.MINOR.PATCH)
4. Push tag to trigger release workflow

git tag -a v1.0.2 -m "Release v1.0.2"
git push origin v1.0.2

Contributions are welcome! Check out CONTRIBUTING.md for guidelines.

1. Fork the project
2. Create a branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See CHANGELOG.md for version history.

To report a vulnerability, see SECURITY.md.

Distributed under MIT License. See LICENSE for more information.

⭐ Star this repo if you use it on your server!

• v1.0.0: Initial release

Thanks to all contributors!

• Always backup your config before updating
• Test on a local server first

Check that CounterStrikeSharp is properly installed.

Verify the map is in the supported list.

This plugin has minimal performance impact on your server.

Use the default config for most servers.

Enable probe mode for unsupported maps.

• Support for more maps
• Config GUI
• Auto-update feature

• Keep your server updated
• Use strong RCON passwords
• Monitor server logs

Before deploying to production:

1. Test on a local server
2. Verify all doors open correctly
3. Check for console errors

Join our Discord for support and feature requests!

• CS2Retake - Full retake plugin
• CounterStrikeSharp - The framework

• v1.0.0 - Initial release
• v1.0.1 - Bug fixes and improvements

The plugin uses a modular architecture with separate handlers for doors, windows, vents, and other breakables.

See our wiki for detailed configuration options.

The plugin exposes console commands for server administrators. \n## Update 11\nDocumentation update 11 \n### Section 1\nContent for section 1