Skip to content

[Feat] Raid System #38

Description

@derrickmehaffy

Summary

Implement a structured raid system that allows factions to initiate raids against enemy factions with clear objectives, cooldowns, notifications, and rewards.

Features

Raid Initiation

  • /f raid start <faction> — Initiate a raid against an enemy faction
  • Raid cost deducted from treasury (TransactionType.RAID_COST already exists)
  • Must have enemy relation with target faction
  • 24-hour cooldown between raids on the same faction

Raid Objectives

  • Configurable objectives per server (admin-defined):
    • Core block destruction (if applicable)
    • Flag capture mechanics
    • Territory control (hold X chunks for Y minutes)
    • Kill count threshold
  • Raids have a time limit (configurable, e.g., 1 hour)

Raid Notifications

  • Alert all online members of both factions when a raid begins
  • Periodic status updates during raid
  • Raid completion notification with results

Victory & Rewards

  • Victory rewards deposited to treasury (TransactionType.SPOILS)
  • Configurable reward types: currency, power bonus, temporary claim access
  • Defeat penalties: power loss, temporary debuffs (configurable)

Commands

  • /f raid start <faction> — Start a raid
  • /f raid status — View active raid
  • /f raid end — End raid early (leader only)

GUI

  • Raids page in Modules section (currently shows "Coming Soon" placeholder)
  • Active raid dashboard
  • Raid history

Existing Infrastructure

  • TransactionType.RAID_COST — Already defined for raid fees
  • TransactionType.SPOILS — Already defined for victory rewards
  • GUI placeholder in FactionModulesPage

Origin

Roadmap Phase E.3.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    Status
    To triage

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions