Version 1.1.0
12 downloads
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
Notification cooldown prevents chat spam during heavy raids by only announcing once per grid within the cooldown window.
Raid Start Chat Notification
Sends a notification when a raid “starts” in an area (first valid destruction after cooldown).
Includes the Rust map grid (e.g. `E3`) using `MapHelper.PositionToString(...)`.
Fully configurable message (supports placeholders).
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": false,
"wood": true,
"stone": true,
"metal": true,
"armored": true
},
"CircleRadius": 1.2,
"CircleAlpha": 0.7,
"CircleColor": [
1.0,
0.4,
0.1,
1.0
],
"CircleDuration": 120.0,
"CircleCooldown": 60.0,
"SmallGridBucketSize": 10.0,
"NotifyOnRaidStart": true,
"RaidStartNotifyCooldown": 180.0,
"RaidStartMessage": "<color=orange>Raid started</color> at <color=#ffd479>{grid}</color>!",
"NotifyToAllPlayers": true,
"NotifyToAdminsOnly": false,
"LogToConsole": false,
"GridMethod": "MapHelper",
"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.)
If you need support, please join to our discord server!