# Shadow Staff - Advanced Hybrid Anti-Cheat
Shadow Staff is a premium, lightweight hybrid anti-cheat solution designed for modern Minecraft servers. Unlike traditional anti-cheats that rely solely on automated kicks, Shadow Staff combines high-accuracy heuristic detection with a powerful, stealth-oriented replay system. This allows staff members to catch cheaters with undeniable video proof while the system handles routine infractions automatically.
## Key Features
### Hybrid Detection Engine
The plugin features a robust suite of checks for combat, movement, and world interactions. Designed with vanilla mechanics in mind, it minimizes false positives by accounting for player latency, movement attributes, and server-side physics.
### Advanced Replay System
When a player exceeds a configurable violation threshold (default: 15 VL), Shadow Staff automatically triggers a background recording.
### Progressive Punishment System
- 6 Kicks: 3 Days Ban
- 7 Kicks: 7 Days Ban
- 8 Kicks: 1 Month Ban
- 9+ Kicks: Permanent Ban
## Commands and Aliases
### Main Admin Command
Primary: /shadow | Alias: /sw
### Replay Management
Primary: /shadowreplay | Alias: /swr
## Technical Specifications
## Support and Permissions
##Plugin Images:
Shadow Staff is a premium, lightweight hybrid anti-cheat solution designed for modern Minecraft servers. Unlike traditional anti-cheats that rely solely on automated kicks, Shadow Staff combines high-accuracy heuristic detection with a powerful, stealth-oriented replay system. This allows staff members to catch cheaters with undeniable video proof while the system handles routine infractions automatically.
## Key Features
### Hybrid Detection Engine
The plugin features a robust suite of checks for combat, movement, and world interactions. Designed with vanilla mechanics in mind, it minimizes false positives by accounting for player latency, movement attributes, and server-side physics.
### Advanced Replay System
When a player exceeds a configurable violation threshold (default: 15 VL), Shadow Staff automatically triggers a background recording.
- Stealth Mode: Recordings are completely invisible to the suspect.
- Visualized Actions: During playback, all block interactions are visualized with distinctive particles and sounds.
- Version Compatibility: Supports multiple replay file versions for long-term evidence storage.
### Progressive Punishment System
- Automatic Kick Tracking: Persists kick counts in a local database (data.yml).
- Scalable Bans: Automated punishments increase based on repeat offenses:
- 6 Kicks: 3 Days Ban
- 7 Kicks: 7 Days Ban
- 8 Kicks: 1 Month Ban
- 9+ Kicks: Permanent Ban
## Commands and Aliases
### Main Admin Command
Primary: /shadow | Alias: /sw
- /shadow gui - Opens the real-time alert and violation panel.
- /shadow alerts - Toggles your personal failure notifications.
- /shadow info <player> - Views detailed violation history for a specific player.
- /shadow reset <player> - Clears all violation levels for a player.
- /shadow record <player> - Manually starts or stops a replay recording.
- /shadow stop [player] - Stealthily stops a specific recording or all active recordings ($staff only).
- /shadow reload - Reloads the plugin configuration.
### Replay Management
Primary: /shadowreplay | Alias: /swr
- /shadowreplay list - Lists all available replay files on the server.
- /shadowreplay load <file> - Loads a specific replay file for viewing.
- /shadowreplay play <file> - Starts playback of a previously loaded replay.
- /shadowreplay stop - Stops the current replay playback and removes the ghost entity.
## Technical Specifications
- Server Support: Paper, Spigot, and forks (1.21+).
- Lightweight Architecture: Asynchronous data handling ensuring zero impact on server TPS.
- Configuration: Fully customizable messages, check weights, and punishment thresholds.
## Support and Permissions
- shadowstaff.alerts: Access to /shadow alerts and Action Bar recording notifications.
- shadowstaff.admin: Full access to administrative commands (/shadow reload, reset).
- shadowstaff.record: Permission to use /shadow record and /shadow stop.
- shadowstaff.replay: Permission to use all /shadowreplay commands.
##Plugin Images:
