# ZxSecurity V1 | v1.20.1

Advanced anti-cheat plugin for Minecraft Paper 1.20.1 servers.

## Features

### 13 Detection Systems

1. **Nuker/FastBreak** - Detects breaking too many blocks too fast
2. **FastPlace/Scaffold** - Detects impossible block placements
3. **AutoClicker** - Detects clicks above configured CPS
4. **KillAura/Aimbot** - Detects abnormal hit rotations and multi-target hits
5. **Reach Hacks** - Detects players hitting beyond normal reach distance
6. **Speed Hacks** - Detects running faster than allowed
7. **Fly/Glide** - Detects illegal vertical movement
8. **NoFall** - Detects avoided fall damage
9. **Timer** - Detects unnatural tick speed
10. **Inventory Hacks** - Detects opening/using items too fast
11. **Packet Flood** - Detects abnormal packet spam and crash attempts
12. **Anti-Bot** - Rate limits rapid join attempts
13. **Anti-Exploit** - Blocks BookBan, SignLag, and NBT exploits

### Configurable Punishments

- **NONE** - Just log the violation
- **WARN** - Notify staff members
- **KICK** - Disconnect player with message
- **TEMPBAN** - Temporary ban with configurable duration
- **PERMABAN** - Permanent ban
- **ROLLBACK** - Restore destroyed blocks

### Commands

- `/zxsec reload` - Reload configuration
- `/zxsec alerts` - Toggle staff alerts
- `/zxsec inspect <player>` - Freeze/inspect a suspicious player
- `/zxsec rollback <player>` - Roll back recent block changes
- `/zxsec ban <player>` - Manually ban through ZxSecurity
- `/zxsec info <player>` - Show violation level & detection history
- `/zxsec spectate <player>` - Spectate a player in vanish mode
- `/zxsec gui` - Open GUI panel for checks, punishments, toggles
- `/zxsec status` - Show TPS, enabled checks, and performance

### Permissions

- `zxsecurity.admin` - Access to all commands
- `zxsecurity.alert` - Receive alerts in chat
- `zxsecurity.bypass` - Bypass all detections
- `zxsecurity.inspect` - Use inspect/rollback/spectate commands

## Installation

1. Download or build the plugin JAR
2. Place it in your server's `plugins` folder
3. Restart your server
4. Configure settings in `plugins/ZxSecurity/config.yml`
5. Reload with `/zxsec reload`

## Configuration

All detection checks can be individually enabled/disabled and configured in `config.yml`:

- Adjust sensitivity thresholds
- Configure punishment types per check
- Set violation decay rates
- Customize alert messages
- Enable/disable specific checks

## Staff Alerts

Staff members with `zxsecurity.alert` permission will receive real-time alerts:

- `§6[ZxSec Alert] §c%player% exceeded reach threshold (4.8 blocks)`
- `§6[ZxSec Alert] §c%player% broke 120 blocks in 3s (Nuker?)`
- `§6[ZxSec Alert] §c%player% clicking 25 CPS (AutoClicker?)`

## GUI System

Use `/zxsec gui` to open an interactive management panel:

- View and toggle enabled checks
- Inspect online players
- View violation statistics
- Quick access to common actions

## Support

For issues, suggestions, or contributions, please join discord and create ticket
dc link: https://discord.gg/ZnuwBpJJaq