About RaidCircles
RaidCircles creates instant, clean raid indicators by placing a configurable radius circle on the map when a raid-related entity is destroyed. No spam, no heavy processing just fast, reliable raid feedback with full control through config.
Features
Smart Raid Detection (Killshot Only)
- Triggers only when an entity is actually destroyed (not every hit)
- Tracks building pieces via buildingblock (walls, floors, roofs, stairs, etc.)
- Optionally tracks selected deployables/defenses (turrets, SAM sites, barricades, etc.)
Weapon / Explosive Filtering (Config-Driven)
Enable exactly what should create a marker, for example:
- Rockets (basic / HV / incendiary)
- Timed Explosive (C4)
- Satchel Charges(Additional types can be added easily if you want to expand later.)
Customizable Map Circle Marker
- Adjustable radius
- Adjustable duration
- Adjustable color (RGBA)
- Adjustable alpha/opacity
- Automatically removes itself after the configured time
Anti-Spam Cooldown (Area-Based)
- Grid-based cooldown system reduces marker spam during heavy raids
- Prevents overlapping circles in the same area within the cooldown window
- Keeps the map readable while staying responsive
Admin Tools (Permission Controlled)
- Remove all active raid circles instantly with a command
- Command name is configurable in the config file
Performance Focused
- Lightweight event hook usage
- Early-exit checks to reduce overhead
- Safe null handling and low allocations
- Cleans up markers on plugin unload/reload
Configuration Sample
{
"Weapons": {
"rocket_basic": true,
"rocket_hv": true,
"rocket_fire": true,
"explosive_timed": true,
"explosive_satchel": true
},
"Entities": {
"buildingblock": true,
"door": true,
"wall_external_high": true,
"autoturret": true,
"flameturret": true,
"sam_site": true,
"ladderhatch": true,
"barricade_wood": true,
"barricade_metal": true
},
"BuildingGrades": {
"twig": true,
"wood": true,
"stone": true,
"metal": true,
"armored": true
},
"CircleRadius": 1.2,
"CircleAlpha": 0.7,
"CircleColor": [
1,
0.4,
0.1,
1
],
"CircleDuration": 120,
"CircleCooldown": 60,
"RemoveCirclesCommand": "removecircles"
}
Permissions
raidcircles.removecircles — Allows use of the marker removal command
Commands
/removecircles — Removes all active raid markers (requires permission)
(Command name can be changed in config.)
