RaidCircles 2.0

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!