🌌 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
- Vulcan Action: Vulcan detects a violation and executes a Kick (configured in
config.yml). - Tracking: SpaceVulcan listens to this event and records a Strike.
- 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"
