SentinelAC

SentinelAC - AI-Powered Minecraft Anticheat
An advanced anticheat plugin for Paper/Spigot 1.20+ with AI-driven detection, replay system, ghost mode, and comprehensive GUI management.

Features
AI/ML Detection System

• Self-learning neural network that improves over time
• Player behavior fingerprinting and anomaly detection
• Confidence scoring with auto-adjusting thresholds
• Continuous learning from confirmed cheaters

22 Detection Checks
Combat (6):

• KillAura - Automated combat assistance
• Aimbot - Aim assistance software
• Reach - Extended attack range
• AutoClicker - Automated clicking
• Velocity - Reduced knockback
• Criticals - Fake critical hits

Movement (6):

• Speed - Movement speed hacks
• Flight - Unauthorized flying
• NoFall - Fall damage bypass
• Step - Instant block stepping
• Jesus - Walking on water/lava
• Phase - Moving through blocks

World (5):

• Scaffold - Automated block bridging
• FastBreak - Breaking blocks too fast
• FastPlace - Placing blocks too fast
• Nuker - Mass block breaking
• Xray - Xray probability scoring

Player (5):

• Timer - Game tick manipulation
• BadPackets - Invalid packet data
• Inventory - ChestStealer, AutoArmor
• Baritone - Pathfinding bot detection
• Blink - Lag switch detection

Replay System - Beta

• Record suspicious players in real-time
• Playback recordings with speed control
• Auto-record flagged players
• Save/load replay files
• Ghost entity visualization

Ghost Mode

• Invisible spectating of suspects
• Real-time HUD with player stats
• Auto-follow target
• Integrated with replay recording
• Full staff invisibility

Complete GUI System

• Main Menu - Central dashboard
• Checks - Toggle all 22 checks
• Players - View online players with stats
• Player Info - Detailed player analysis
• Alerts - Configure notification preferences
• Settings - General configuration
• Punishments - Escalation settings
• Replays - Manage recordings
• Ghost Mode - Select spectate target
• AI Engine - ML statistics and config

Additional Features

• Trust Score System - Players earn trust over time
• Discord Webhooks - Real-time alerts
• Escalating Punishments - warn → kick → tempban → ban
• Database Support - SQLite or MySQL
• Performance Optimized - Async checks, auto-throttling

Installation

1. Download the latest release
2. Place in your plugins folder
3. Restart your server
4. Use /sentinel to open the admin GUI

Commands
Command Permission Description
/sentinel sentinel.admin Open admin GUI
Permissions
Permission Description
sentinel.admin Access to admin panel
sentinel.alerts Receive violation alerts
sentinel.bypass Bypass all checks

--------------------------------------------------------------------------------------------------
ClientSide Mod
## About

The **SentinelAC Client** is a companion Fabric mod that works alongside the SentinelAC server plugin to provide enhanced cheat detection. It enables server-side verification of client integrity and instant detection of hack clients.

```
┌──────────────────────────────────────────────────────────────┐
│ │
│ INSTANT DETECTION │
│ Detects hack clients within seconds of joining │
│ │
│ DEEP SCANNING │
│ Finds cheats even with hidden GUI │
│ │
│ SECURE COMMUNICATION │
│ Encrypted channel with server plugin │
│ │
└──────────────────────────────────────────────────────────────┘
```

---

## Features

### Deep Scanner

Detects hack clients even when their GUI is hidden:

| Detection Method | Description |
|-----------------|-------------|
| **Class Scanning** | Searches for hack client class signatures |
| **Mod Analysis** | Identifies blacklisted mods |
| **Keybind Detection** | Finds suspicious keybindings |
| **Thread Monitoring** | Detects hack client threads |
| **Reflection Scan** | Finds active hack instances |
| **Mixin Detection** | Identifies suspicious modifications |

### Screenshot Capture

- Server-requested POV screenshots
- Compressed transmission
- Chunk-based sending
- AI analysis on server

### Input Verification

- Mouse movement tracking
- Click pattern analysis
- Rotation verification
- Aimbot detection support

### Mod Scanner

Detects known hack clients:

```
✗ Wurst ✗ Meteor ✗ Impact
✗ Aristois ✗ Future ✗ LiquidBounce
✗ Sigma ✗ Inertia ✗ And more...
```

### Process Scanner

Identifies external cheat software running on the system.

---

## Installation

### Requirements

- Minecraft **1.20.4** or **1.21.x**
- [Fabric Loader]( https://fabricmc.net/) **0.15.0+**
- [Fabric API]( https://modrinth.com/mod/fabric-api)

### Steps

```
1. Install Fabric Loader for your Minecraft version
2. Download Fabric API and place in /mods/
3. Download sentinel-client.jar and place in /mods/
4. Launch Minecraft
5. Join a server with SentinelAC plugin installed
```

---

## How It Works

```
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Client │────│ Server │────│ Action │
│ Joins │ │ Handshake │ │ Taken │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
▼ ▼ ▼
Deep Scan Verify Mods Ban/Kick if
Initiated & Results Hacks Found
│ │ │
▼ ▼ ▼
Results Sent AI Analysis Alert Staff
to Server Screenshot Log Event
```

### Connection Flow

1. **Join Server** → Client connects to SentinelAC server
2. **Handshake** → Client sends mod list to server
3. **Verification** → Server checks for blacklisted mods
4. **Deep Scan** → Client performs instant deep scan
5. **Results** → Scan results sent to server
6. **Action** → Server bans/kicks if hacks detected

---

## ️ Detection Capabilities

### Instant Detection (< 3 seconds)

| Hack Client | Detection Rate |
|-------------|----------------|
| Wurst | 100% |
| Meteor | 100% |
| Impact | 100% |
| LiquidBounce | 100% |
| Aristois | 100% |
| Future | 100% |

### Continuous Monitoring

- Periodic rescans every 30 seconds
- Input pattern analysis
- Screenshot requests from server
- Process monitoring

# without this mod you cant test its capabilities
- you can find it in the folder
- only available for version 1.21.8 for now
- next update will push more versions of it