🌌 SpaceVulcan

Advanced Punishment System for Vulcan Anti-Cheat

SpaceVulcan transforms how your server handles cheaters. Instead of instantly banning players for a single violation, SpaceVulcan works alongside Vulcan's kick system to create a Tiered Strike System.

⚠️ Requirements

• Vulcan Anti-Cheat (Premium Resource)
• Java 17 or newer
• Purpur/Paper 1.16 - 1.21+

---

⚡ The Problem

Standard anti-cheats often punish players immediately. If you configure Vulcan to only Kick players, they can simply reconnect and continue cheating. If you configure it to Ban, players might get falsely banned due to lag.

✅ The Solution

SpaceVulcan bridges the gap. It tracks how many times Vulcan has punished (e.g., Kicked) a player.

• 1 Kick? Just a warning/disconnect.
• Constant Kicks? SpaceVulcan detects the pattern and executes a Ban.

🔥 Key Features

• Multi-Tier Punishments: Create progressive rules.
  • Example: 4 Kicks in 5 minutes = 1 hour Ban.
• Time Windows (Decay): Strikes expire automatically. A player who lags once won't be banned.
• Highly Optimized: Designed for high-load servers. Zero impact on performance.
• Smart Session Management: Option to clear strikes when a player leaves the server.
• Full Control: Customize thresholds, commands, and messages via config.yml.

⚙️ How it Works

1. Vulcan Action: Vulcan detects a violation and executes a Kick (configured in config.yml).
2. Tracking: SpaceVulcan listens to this event and records a Strike.
3. Escalation: If the player reconnects and continues to get Kicked, accumulating strikes above your Threshold, SpaceVulcan executes a Ban.

Configuration Example (config.yml):

rules:
  # Rule 1: Short ban for repeated kicks
  light_ban:
    threshold: 4            # 4 Vulcan punishments (Kicks)
    window_seconds: 300     # within 5 minutes
    command: "tempban {player} 1h Suspicious activity"

  # Rule 2: Long ban for aggressive cheating
  heavy_ban:
    threshold: 12           # 12 Vulcan punishments
    window_seconds: 1200    # within 20 minutes
    command: "tempban {player} 7d Cheating detected"