HeliEvent

Project details

Project: HeliEvent
Dev language: C# (Oxide/uMod)
Plugin language: en
Author: @RustFlash

HeliEvent spins up a timed server event that spawns multiple Patrol Helicopters and lets player-owned SAM Sites target them (opt‑in via permission). It includes a broadcasted countdown, live Top‑5 rankings by clan (optional via ClansReborn), and safe cleanup when the event stops.

• Burst helicopter event: Spawns a configurable number of Patrol Helicopters and tracks them during the event.
• Countdown & broadcasts: 10m → 5m → 3m → 60s → 30s → 10s → 3‑2‑1 messages before start.
• Player SAM integration: Player SAM Sites can target event helicopters if the owner has the helievent.use permission. Optional global activation outside events.
• Clan leaderboard (optional): If ClansReborn is enabled, counts heli kills per clan and broadcasts a Top‑5 periodically and at the end.
• Debug & test: One‑shot test mode (spawns all helis instantly) and a console debug readout for quick checks.
• Safe teardown: Stops timers, destroys remaining event helis, and unregisters SAM targets when appropriate.

• /startheliEvent – starts the 10‑minute countdown, then the event.
• /stopheliEvent – stops event/countdown and destroys all event helis.
• /forcestophelievent – immediate destroy of all event helis and stop.
• /heliEventstatus – shows event status and counts.
• /testhelievent – starts the event immediately with all helicopters spawned.

• startheliEvent – same as chat start (with countdown).
• stopheliEvent – same as chat stop.
• forcestophelievent – same as chat force stop.
• testhelievent – same as chat test start.
• helievent.debug – prints server‑side diagnostics for SAM and heli counts.

• helievent.admin – required to use the admin/start/stop/test commands.
• helievent.use – allows a player-owned SAM Site to target event helicopters.

Note: Monument (OwnerID = 0) SAMs are ignored. Defender‑mode SAMs are ignored.

{
  "HelicopterCount": 10,                // Total helis to spawn for the event
  "ModifyHeliBehavior": true,           // During event: disable danger zones & monument crash (safer flow)
  "UseClansReborn": false,              // Enable clan kill tracking via ClansReborn
  "EventDurationMinutes": 30,           // Auto-stop after this duration
  "Top5UpdateIntervalSeconds": 150,     // Broadcast interval for Top‑5
  "SamsitesActivate": false             // If true, player SAMs may target helis even outside events (permission-gated)
}

• When ModifyHeliBehavior is true, the plugin temporarily sets:
  • PatrolHelicopterAI.use_danger_zones = false
  • PatrolHelicopterAI.monument_crash = false
    and restores defaults when the event ends.
• SamsitesActivate = true keeps SAM targeting active outside events; set to false to limit targeting to the event window.

The plugin ships with default English broadcast messages for countdown, start/end, and Top‑5 announcements. Customize them via the standard Oxide lang system.

• ClansReborn (optional): When UseClansReborn = true, heli kill credit is attributed by clan tag and included in Top‑5 broadcasts.

• Event helicopters spawn around random map positions at ~100m altitude.
• If not all helicopters spawn, the plugin logs a warning (possible server limits).
• Damage from SamSite → PatrolHelicopter is scaled by 2.5x to keep events dynamic.
• Use /heliEventstatus to monitor: state, spawned vs. active helis, and SAM target count.

load, run, enjoy 💛