RaidCircles 1.1.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)

• 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!