# HexAntiCheat

**Developed by HexLorddev (Dinethnethsara)**

HexAntiCheat is a modern, high-performance Minecraft anti-cheat targeting 1.8.8 through 1.21+. It features a multi-layered detection engine, advanced packet analysis via PacketEvents, behavioral heuristics, and a real-time notification system with in-game, Discord, and a built-in web dashboard.

## Features

### ️ Advanced Detection System
- **23 Active Checks** across Movement, Combat, Player, and World categories
- Movement simulation and envelope validation across versions
- PacketEvents-based low-level packet inspection
- Ghost client detection (Vape, Entropy, Dream, Drip)

### Comprehensive Check Coverage

**Movement Checks:**
- Speed, Fly, NoFall, Jesus (Water Walking), Phase, Step

**Combat Checks:**
- Reach, AutoClicker, Aim Assistance, KillAura, Anti-Velocity, Criticals

**Player Checks:**
- BadPackets, Timer, Blink, Brand Analysis, FastUse, Inventory

**World Checks:**
- Nuker, Scaffold, Xray Detection

### Real-Time Notifications
- In-game staff alerts with click-to-teleport
- Discord webhook integration
- Live web dashboard with Server-Sent Events
- Evidence collection and export

### ️ Database & Storage
- Multi-backend support: SQLite, MySQL, PostgreSQL
- HikariCP connection pooling
- Violation history and player profiling
- Evidence logging with packet replay

### Integrations
- PlaceholderAPI support
- ViaVersion/Geyser compatibility
- Citizens NPC exemptions
- Floodgate Bedrock player detection

## Building

Requirements:
- Java 17+
- Maven 3.9+

```bash
mvn clean package -DskipTests
```

The shaded jar will be at `target/HexAntiCheat-1.0.0.jar`.

## Installation

1. Place the jar in `plugins/`
2. Start the server to generate configs
3. Configure `plugins/HexAntiCheat/config.yml`
4. Grant staff permissions `hexac.admin` and `hexac.alerts`

## Commands

- `/hexac alerts` - Toggle in-game alerts
- `/hexac profile <player>` - View player violation profile
- `/hexac spectate <player>` - Spectate suspicious player
- `/hexac freeze <player>` - Freeze player for investigation
- `/hexac reload` - Reload configuration

## Configuration

### Automated Punishments
```yaml
punishments:
enabled: true
rules:
- check: reach
vl: 20
action: ban 30d Reach Detection
- check: killaura
vl: 15
action: tempban 7d KillAura
```

### Discord Integration
```yaml
notifications:
discord:
enabled: true
webhook_url: "YOUR_WEBHOOK_URL"
```

### Web Dashboard
Access at `http://<host>:9753/` for live violation monitoring.

## Developer API

```java
// Listen for violations
@EventHandler
public void onViolation(HexViolationEvent event) {
Player player = event.getPlayer();
String check = event.getCheck();
int vl = event.getVl();
double confidence = event.getConfidence();
}

// Access player data
PlayerData data = HexAPI.getData(player.getUniqueId());

// Register custom checks
HexAPI.registerCheckFactory(new MyCustomCheckFactory());
```

## Ghost Client Detection

HexAntiCheat employs sophisticated detection methods for popular ghost clients:

- **Brand Analysis**: Detects modified client signatures
- **Behavioral Patterns**: Identifies inhuman consistency
- **Statistical Analysis**: Flags impossible timing patterns
- **Aim Tracking**: Monitors mouse movement for automation

## Performance

- **TPS Impact**: <0.1 with 100+ players
- **Memory Usage**: <100MB with 500+ players
- **Async Processing**: All checks run off main thread
- **Smart Sampling**: Reduces load during high player counts

## Support

For support, configuration help, or custom development:
- **Developer**: HexLorddev (Dinethnethsara)
- **Discord**: Contact through Minecraft communities
- **Issues**: Report bugs and feature requests

---

## License

**© 2024 HexLorddev (Dinethnethsara). All rights reserved.**

This software is proprietary. Use, distribution, or modification requires explicit permission from the author.