Version 2.0
19 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)
OnEntityDeath hook (default) — Triggers only when an entity is actually destroyed, not on every hit. More reliable than kill-shot math and eliminates edge cases where destruction wasn't being caught.
Legacy OnEntityTakeDamage mode — Can be re-enabled with "UseOnEntityDeath": false if you prefer the original kill-shot approach.
Weapon prefab fallback — Checks both info.WeaponPrefab and info.Weapon when identifying the raiding tool, protecting against occasional Facepunch changes to how weapon data is populated.
Tracks building pieces via buildingblock (walls, floors, roofs, stairs, etc.)
Optionally tracks selected deployables/defenses (turrets, SAM sites, barricades, window bars, wall frames, floor grills, etc.)
Weapon / Explosive Filtering (Config-Driven)
Enable exactly what should create a marker, for example:
Enable exactly what should create a marker:
Rockets (basic / HV / fire / incendiary)
Timed Explosive (C4)
Satchel Charges
Grenade Launcher (HE)
MLRS Rockets
Customizable Map Circle Marker
Adjustable radius
Adjustable duration
Adjustable primary color (RGBA)
Adjustable outline/secondary color (RGBA) via color2
Adjustable alpha/opacity
Color values are safely clamped between 0–1
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 {grid} placeholder)
Optional sound effect notification — set any valid Rust sound effect path in config
Admin Tools (Permission Controlled)
Remove all active raid circles instantly with a chat or console command
Command names are configurable in the config file
Bypass permission — Grant raidcircles.bypass to players whose raids should not trigger markers or notifications (useful for admins, event accounts, etc.)
Performance Focused
Lightweight event hook usage
Early-exit checks to reduce overhead
Safe null handling and low allocations
Periodic memory cleanup — Automatically purges expired cooldown entries to prevent memory growth on busy servers
Cleans up markers on plugin unload/reload
Config versioning with automatic migration — no manual edits needed on upgrade
Configuration Sample
{
"ConfigVersion": "2.0.0",
"UseOnEntityDeath": true,
"Weapons": {
"rocket_basic": true,
"rocket_hv": true,
"rocket_fire": true,
"rocket_incendiary": true,
"explosive_timed": true,
"explosive_satchel": true,
"ammo_grenadelauncher_he": true,
"mlrs": 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,
"window_bars": true,
"wall_frame": true,
"floor_grill": 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],
"CircleOutlineColor": [1.0, 0.2, 0.0, 0.4],
"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,
"RaidSoundEffect": "",
"GridMethod": "MapHelper",
"RemoveCirclesCommand": "removecircles",
"CooldownCleanupInterval": 300.0
}
Permissions
raidcircles.removecircles — Allows use of the marker removal command
raidcircles.bypass —Raids by this player won't trigger markers or notifications
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!