Satellite Event 1.0.0

A dynamic random event where satellites crash down across the map, drawing players into PvP hotspots for loot. A patrol helicopter escorts the crash site, a map marker warns everyone where it's happening, and each satellite spawns with bonus loot crates once it lands — giving players a real reason to fight over the wreckage.

Features:

• Random satellite crash events triggered on a configurable timer
• Spawns multiple satellites per event (min/max configurable) with staggered drop timing
• Smart location picker — avoids water, checks NavMesh, keeps events away from players and excluded monuments (safe zones, bandit camp, compound, etc. by default)
• Escorting patrol helicopter that approaches, circles the crash site, then flies off and despawns
• Map marker showing the event radius, with a configurable duration
• Toast + chat broadcast announcements so players know an event has started
• Configurable bonus loot table added to satellite crates (scrap, metal, HQM, gears by default — fully editable)
• Optional event hour restrictions (run only during set server hours)
• Minimum online player requirement before an event can trigger

Chat Command: /satevent <status|start|stop|toggle|reload>

• status – shows active event count
• start – force-starts an event (admin)
• stop – stops all active events (admin)
• toggle – enables/disables the automatic event timer (admin)
• reload – reloads the config on the fly (admin)

Permission: satelliteevent.admin

Config

{
  "Event Settings": {
    "Enabled": true,
    "Event Interval (seconds)": 10800.0,
    "Min Players Online": 5,
    "Start Hour (0-23, -1 = disabled)": -1,
    "End Hour (0-23, -1 = disabled)": -1
  },
  "Satellite Settings": {
    "Min Satellites": 2,
    "Max Satellites": 4,
    "Spread Distance (meters)": 10.0,
    "Delay Between Satellites (seconds)": 1.5
  },
  "Location Settings": {
    "Excluded Monument Names": [
      "safezone",
      "banditcamp",
      "compound",
      "safezone",
      "banditcamp",
      "compound",
      "safezone",
      "banditcamp",
      "compound"
    ],
    "Min Distance From Players": 100.0,
    "Max Distance From Players": 2000.0,
    "Require NavMesh": true,
    "NavMesh Check Radius": 10.0
  },
  "Announcement Settings": {
    "Broadcast Event Start": true,
    "Event Start Sound": "assets/bundled/prefabs/deepsea/deepsea_wipealarm.prefab",
    "Show Map Marker": true,
    "Map Marker Duration (seconds)": 300.0
  },
  "Crate Bonus Loot (added to satellite crash crates)": [
    {
      "Short Prefab Name": "scrap",
      "Min Amount": 20,
      "Max Amount": 60,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "metal.fragments",
      "Min Amount": 50,
      "Max Amount": 150,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "hq.metal.ore",
      "Min Amount": 10,
      "Max Amount": 30,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 75.0
    },
    {
      "Short Prefab Name": "gears",
      "Min Amount": 1,
      "Max Amount": 3,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 50.0
    },
    {
      "Short Prefab Name": "scrap",
      "Min Amount": 20,
      "Max Amount": 60,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "metal.fragments",
      "Min Amount": 50,
      "Max Amount": 150,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "hq.metal.ore",
      "Min Amount": 10,
      "Max Amount": 30,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 75.0
    },
    {
      "Short Prefab Name": "gears",
      "Min Amount": 1,
      "Max Amount": 3,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 50.0
    },
    {
      "Short Prefab Name": "scrap",
      "Min Amount": 20,
      "Max Amount": 60,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "metal.fragments",
      "Min Amount": 50,
      "Max Amount": 150,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 100.0
    },
    {
      "Short Prefab Name": "hq.metal.ore",
      "Min Amount": 10,
      "Max Amount": 30,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 75.0
    },
    {
      "Short Prefab Name": "gears",
      "Min Amount": 1,
      "Max Amount": 3,
      "Skin ID": 0,
      "Spawn Chance (0-100)": 50.0
    }
  ],
  "Patrol Helicopter Settings": {
    "Enable Patrol Helicopter": true,
    "Spawn Distance (meters from crash site)": 1500.0,
    "Orbit Radius (meters)": 80.0,
    "Orbit Height (meters)": 60.0,
    "Orbit Speed (degrees per second)": 20.0,
    "Time Spent Circling (seconds)": 300.0
  }
}