Capture The Flag

Works with

About Capture The Flag

Overview

Capture The Flag is a competitive event plugin for Rust servers that transforms team-based gameplay into an intense, objective-driven experience. The plugin features randomly spawned flags that must be captured and extracted to a designated monument-based extraction zone. With full clan integration, real-time progress tracking, and customizable rewards, CTF creates high-stakes moments where every second counts and teamwork determines victory.

When a flag is successfully extracted to the capture zone and held for the required time, the carrying clan claims victory and receives substantial rewards. The dynamic capture mechanic includes contested zone penalties, ally-based capture rate bonuses, and real-time progress UI to keep players engaged throughout the event.

Preview: https://youtu.be/etyPaY0AKP0

Key Features

Flag & Extraction System: Flags spawn at random locations far from extraction zones, requiring teams to transport them across the map while defending against enemies

Monument-Based Extraction Zones: Dynamically created extraction zones at configurable Rust monuments with radius-based detection

Dynamic Capture Mechanics:

Configurable capture time requirements (default: 300 seconds)
Base capture rate with bonuses for team size (up to configurable maximum)
Contested zone detection - capture progress decays when enemies are present
Real-time capture progress tracking and UI display

Clan Integration: Full support for the Clans plugin with clan-based capture completion and win detection

Comprehensive Reward System:

Item-based rewards
Economics plugin integration for currency rewards
ServerRewards points distribution
Multiple reward types can be enabled

Visual & Audio Feedback:

Live tracking map markers for flag and extraction zone locations
Visual sphere indicators for extraction zone boundaries
Real-time capture progress UI with percentage and time remaining
Customizable colored markers with configurable alpha and radius

Gameplay Restrictions: Block specific commands (teleport, home, shop) while flag is being carried to prevent exploit usage

Admin Controls: Commands to start/stop events, retrieve monument offsets, and manage active sessions

Example Configuration

{
  "Gameplay Settings": {
    "Use Clans Plugin": true,
    "Blocked Commands While Carrying Flag": ["home", "tp", "tpr", "clanhome", "outpost", "trade", "shop"],
    "Drop Flag On Disconnect": true,
    "Drop Flag On Death": true
  },
  "Capture Settings": {
    "Capture Check Interval (seconds)": 1.0,
    "Required Capture Time (seconds)": 20.0,
    "Base Capture Rate Per Second": 1.0,
    "Additional Rate Per Extra Team Member": 0.5,
    "Maximum Capture Rate Multiplier": 3.0,
    "Decay Rate When Contested (per second)": 2.0,
    "Show Progress UI": true
  },
  "Flag Settings": {
    "Display Name": "Capture The Flag",
    "Item Shortname": "twitchrivalsflag",
    "Skin ID": 0
  },
  "Extraction Zone Settings": {
    "Zone Radius": 25.0,
    "Show Zone Marker": true,
    "Show Visual Sphere": true
  },
  "Marker Settings": {
    "Update Interval (seconds)": 5.0,
    "Flag Marker": {
      "Alpha": 0.85,
      "Color1": "#00FFFF",
      "Color2": "#0000FF",
      "Radius": 0.4
    },
    "Extraction Zone Marker": {
      "Alpha": 0.75,
      "Color1": "#00FF00",
      "Color2": "#FFFF00",
      "Radius": 0.3
    }
  },
  "Reward Settings": {
    "Enable Rewards": true,
    "Use Items": true,
    "Use Economics": false,
    "Use ServerRewards": false,
    "Item Rewards": [
      {"Shortname": "ammo.rocket.hv", "Amount": 64, "DisplayName": "HV Rockets", "SkinID": 0},
      {"Shortname": "explosive.timed", "Amount": 20, "DisplayName": "Timed Explosives", "SkinID": 0},
      {"Shortname": "explosive.satchel", "Amount": 30, "DisplayName": "Satchel Charges", "SkinID": 0},
      {"Shortname": "rocket.launcher", "Amount": 2, "DisplayName": "Rocket Launchers", "SkinID": 0}
    ],
    "Economics Amount": 5000.0,
    "ServerRewards Points": 1000
  },
  "Announcement Settings": {
    "Message Prefix": "<color=#00FFFF>[CTF]</color>",
    "Messages": {
      "EventStart": "<size=16><b>CAPTURE THE FLAG STARTED</b></size>\n<size=12>Capture the flag and hold the <color=#00FF00>Extraction Zone</color> for 5 minutes!</size>",
      "FlagPickup": "<color=#FFD700>{player}</color> has secured the flag!",
      "FlagDropped": "The flag has been dropped!",
      "CaptureStarted": "<color=#FFD700>{clan}</color> has started extracting the flag!",
      "CaptureInterrupted": "Extraction interrupted! Enemy players detected in the zone!",
      "CaptureContested": "Extraction zone is contested! Progress is decaying!",
      "EventWon": "<size=16><b>{clan} HAS SUCCESSFULLY EXTRACTED THE FLAG!</b></size>\n<size=12>Victory achieved after {duration}!</size>",
      "EventEnded": "The Capture The Flag event has ended.",
      "ZoneLocation": "Extraction Zone Location: <color=#00FF00>{monument}</color>",
      "CommandBlocked": "You cannot use <color=#FF6B6B>/{command}</color> while carrying the flag!",
      "FlagBackpack": "The flag must remain in your <color=#FFD700>backpack slot</color>!",
      "NoPermission": "You don't have permission to use this command.",
      "EventAlreadyRunning": "An event is already running!"
    }
  }
}

Commands

Admin Commands

/ctf start - Launch a new Capture The Flag event with random flag spawn and extraction zone
/ctf stop or /ctf end - Immediately end the active event
/ctf offset - Get the monument offset at your current position (useful for configuration)

Requirements

Clans Plugin (Optional) - Recommended for clan-based gameplay; plugin will say player names instead of clans if not loaded.
Economics Plugin (Optional) - Required only if using economics-based rewards
ServerRewards Plugin (Optional) - Required only if using ServerRewards points

Permissions