━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overview
Atra is a powerful, prediction-based anti-cheat plugin designed to protect your Minecraft server from cheaters. Built with modern detection algorithms and extensive configuration options, Atra provides comprehensive protection while minimizing false positives.
Key Features:
- 18 Advanced Checks - Combat, Movement, Packet, and Misc detection
- Prediction-Based Detection - Server-side movement replication
- ⚡ Lag Compensation - Automatic ping and TPS compensation
- VL System - Violation Level tracking with auto-decay
- Real-Time Alerts - Staff notification system with spam protection
- ️ Full API - Custom events for developers
- Multi-Version Support - Works on 1.8 through 1.21.4
- Auto-Update Checker - Automatic update notifications
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
Combat Checks (6)
- Reach - Detects extended reach with ping compensation and ray-tracing
- KillAura - Rotation analysis, multi-target detection, impossible rotations
- AutoClicker - CPS tracking, click pattern analysis, standard deviation
- Velocity - Multi-tick knockback tracking, expected vs actual velocity
- Criticals - Fall distance validation, liquid detection, ground checking
- AimAssist - GCD pattern detection, rotation consistency analysis
Movement Checks (6)
- Fly - Gravity simulation, air time tracking, Y-velocity analysis
- Speed - Server-side movement replication, friction simulation
- NoClip - Collision detection, ray-casting, automatic setback
- Step - Height validation, jump distinction, block checking
- Jesus - Water walking detection with flight exclusion
- Elytra - Hover detection, velocity pattern analysis
Packet Checks (4)
- Timer - Packet rate measurement, burst detection
- BadPackets - Invalid pitch, NaN/Infinite value detection
- PingSpoofer - Reported vs actual ping comparison
- InvalidMotion - Motion value validation, impossible speeds
Misc Checks (4)
- Scaffold - Fast block placement, rotation analysis
- FastBreak - Block break timing validation
- Inventory - Inventory manipulation detection
- AutoTool - Tool switching pattern analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Configuration
Atra is highly configurable with multiple configuration files:
config.yml - Main configuration
Code (Text):
debug: false
update-checker:
enabled: true
notify-admins: true
violations:
decay-rate: 1
decay-interval: 2
punishments:
setback-threshold: 20
kick-threshold: 50
ban-threshold: 100
ban-duration-days: 7
ping-compensation:
enabled: true
max-compensation: 300
checks.yml - Individual check configuration
Code (Text):
combat:
reach:
enabled: true
max-violations: 50
max-reach-survival: 3.0
tolerance: 0.25
ping-compensation: true
messages.yml - Customizable messages
punishments.yml - Punishment thresholds per check
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
Code (Text):
/atra - Display command help
/atra reload - Reload configuration files
/atra alerts - Toggle alert notifications
/atra version - View version information
/atra debug - Performance analysis and statistics
/atra info <player> - View player information and violations
/atra reset <player> [check] - Reset player violations
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
Code (Text):
atra.bypass - Bypass all checks
atra.alerts - Receive alert notifications
atra.info - View player information
atra.reset - Reset player violations
atra.reload - Reload configuration
atra.version - View version information
atra.debug - Access debug information
atra.admin - Full administrative access
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation
Requirements:
- Minecraft Server 1.8 - 1.21.4 (Paper/Spigot)
- Java 21 or higher
- ProtocolLib 5.1.0+ (Required for packet checks)
Installation Steps:
- Download ProtocolLib from here
- Download Atra AntiCheat
- Place both JAR files in your plugins folder
- Restart your server
- Configure config.yml to your preferences
- Reload with /atra reload
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Developer API
Atra provides a comprehensive API for developers:
Maven Dependency:
Code (XML):
<dependency>
<groupId>dev.draxel
</groupId>
<artifactId>atra
</artifactId>
<version>1.0.0
</version>
<scope>provided
</scope>
</dependency>
Example Usage:
Code (Java):
// Get player data
PlayerData data
= AtraAPI.
getPlayerData
(player
)
;
// Listen to events
@EventHandler
public
void onFlag
(FlagEvent event
)
{
Player player
= event.
getPlayer
(
)
;
Check check
= event.
getCheck
(
)
;
String info
= event.
getInformation
(
)
;
// Custom logic
event.
setCancelled
(
true
)
;
}
// Reset violations
AtraAPI.
resetViolations
(player,
"reach"
)
;
AtraAPI.
resetAllViolations
(player
)
;
Custom Events:
- FlagEvent - Called when a player is flagged
- ViolationEvent - Called when violation level increases
- PunishEvent - Called when a punishment is executed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VL System
Atra uses a sophisticated Violation Level (VL) system:
- Small suspicious activity: +1-5 VL
- Medium suspicious activity: +5-10 VL
- High suspicious activity: +10-50 VL
- VL Decay: -1 VL every 2 seconds during legitimate gameplay
Punishment Thresholds:
- 20 VL: Setback (teleport to last safe location)
- 50 VL: Kick from server
- 100 VL: Temporary ban (7 days default)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
️ False Positive Prevention
Atra includes multiple systems to minimize false positives:
- Ping Compensation - Automatic tolerance adjustment based on player ping
- TPS Monitoring - Relaxed checks when server TPS drops below 19.6
- Grace Period - New players get more lenient checks for first 5-10 minutes
- Bypass Permission - Admins can bypass all checks
- Multi-Tick Analysis - Checks analyze multiple ticks before flagging
- Statistical Methods - Uses standard deviation and variance analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Performance
Atra is designed to be lightweight and efficient:
- ✅ Asynchronous packet processing
- ✅ Optimized data structures
- ✅ Minimal memory footprint
- ✅ Thread-safe operations
- ✅ No impact on server TPS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Auto-Update System
Atra includes an automatic update checker:
- Checks for updates on startup
- Automatic check every 6 hours
- Notifies admins when they join if update is available
- Direct link to download page
- Can be disabled in config
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Compatibility
Supported Versions:
- ✅ Minecraft 1.8.x - 1.21.4
- ✅ Spigot, Paper, Purpur
- ✅ ViaVersion, ViaBackwards, ViaRewind
- ✅ Geyser (Bedrock support)
Required Dependencies:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Support
Need help? We're here for you!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⭐ Reviews
If you enjoy Atra, please leave a review! Your feedback helps us improve and helps others find this resource.
Thank you for choosing Atra AntiCheat!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
© 2024 Draxel. All rights reserved.