Anti Auto Click - FireAntiMacro v1.0

FireAntiMacro – Advanced Click Pattern Analyzer​

DISCORD​

WHAT IS IT?​

How it works​

FireAntiMacro detects players using auto-clickers or macros without affecting anyone on your server. It monitors click patterns and sends clear alerts to your staff, allowing you to make decisions confidently. The plugin is lightweight, won’t impact server performance, and works on any modern Minecraft server. With it, your team can keep gameplay fair and easily spot suspicious behavior.

Performance​

• Lightweight and optimized.
• Minimal per-click overhead; safe for large servers.
• Only runs essential calculations; no background loops unless strictly necessary.
• Clean memory management, no leaks, no static abuse.

Configuration​

• Simple, obvious, and safe defaults.
• Configurable options include: score thresholds, score decay, minimum sample size, TPS sensitivity, lag tolerance, alert cooldown, debug mode, and bypass permissions.
• All messages and alerts are fully configurable.

Recommended for​

• Survival servers
• PvP servers
• Roleplay or CityBuild servers
• Any server where staff want accurate, non-intrusive detection of artificial clicking

Compatibility​

• Works with Spigot, Paper, Purpur, and similar forks
• Designed for modern Minecraft versions
• Staff-oriented only: alerts are sent in chat to online ops or players with permission
• No bans, kicks, or gameplay interference
  
  

CONFIG:​

# ═══════════════════════════════════════════════════════════
# FireAntiMacro - Configuration
# ═══════════════════════════════════════════════════════════
#
# Click Pattern Analyzer
# Philosophy: Inform, don't punish
#
# This plugin does NOT ban, kick, or cancel actions.
# It only provides statistical analysis to staff.
#
# ═══════════════════════════════════════════════════════════

# ───────────────────────────────────────────────────────────
# DETECTION SETTINGS
# ───────────────────────────────────────────────────────────

detection:
# Minimum number of clicks before analysis begins
# Higher = more reliable, slower detection
# Lower = faster detection, more false positives
# RECOMMENDED: 30-50
minimum-sample-size: 30

# Coefficient of Variation (CV) threshold
# CV measures consistency of click intervals
# Lower CV = more consistent = more suspicious
#
# Human clicks: CV typically 0.15-0.30
# Macros: CV typically 0.00-0.10
#
# RECOMMENDED: 0.08-0.12
cv-threshold: 0.10

# Maximum suspicion score before alert
# Score builds up with consistent patterns
# RECOMMENDED: 80-100
max-score: 100.0

# Score increase when suspicious pattern detected
# RECOMMENDED: 2.0-5.0
score-increase: 3.0

# Score decay when normal pattern detected
# RECOMMENDED: 0.5-2.0
score-decay: 1.0

# Minimum server TPS for analysis
# Below this TPS, analysis is paused (lag protection)
# RECOMMENDED: 17.0-19.0
minimum-tps: 18.0

# ───────────────────────────────────────────────────────────
# ALERT SETTINGS
# ───────────────────────────────────────────────────────────

alert:
# Alert prefix
prefix: '§c§l[FireAntiMacro]'

# Cooldown between alerts for same player (seconds)
# Prevents alert spam
# RECOMMENDED: 180-600 (3-10 minutes)
cooldown-seconds: 300

# Log alerts to console
console-log: true

# ───────────────────────────────────────────────────────────
# DEBUG MODE
# ───────────────────────────────────────────────────────────

debug:
# Enable debug logging
# Shows detailed statistics in console
# WARNING: Can be spammy with many players
enabled: false

# ═══════════════════════════════════════════════════════════
# UNDERSTANDING THE DETECTION
# ═══════════════════════════════════════════════════════════
#
# The plugin analyzes click timing consistency using
# statistical methods, not gameplay context.
#
# Key concepts:
#
# 1. INTERVAL: Time between consecutive clicks (milliseconds)
# Example: Click at 1000ms, click at 1105ms → interval = 105ms
#
# 2. AVERAGE INTERVAL: Mean of all intervals
# Human: Varies (90-120ms typical)
# Macro: Very stable (usually 100ms exactly)
#
# 3. STANDARD DEVIATION: How much intervals vary
# Human: High variation (15-30ms typical)
# Macro: Very low variation (0-5ms)
#
# 4. COEFFICIENT OF VARIATION (CV): Deviation / Average
# This normalizes the measurement
# Human: 0.15-0.30
# Macro: 0.00-0.10
#
# 5. SCORE: Progressive suspicion tracker
# Builds up with consistent patterns
# Decays with normal patterns
# Alert triggers at max score
#
# ═══════════════════════════════════════════════════════════
# TUNING GUIDE
# ═══════════════════════════════════════════════════════════
#
# More sensitive (more alerts, more false positives):
# - Decrease cv-threshold to 0.08
# - Decrease max-score to 80
# - Increase score-increase to 5.0
#
# Less sensitive (fewer alerts, safer):
# - Increase cv-threshold to 0.12
# - Increase max-score to 120
# - Decrease score-increase to 2.0
#
# Remember: This tool supports staff, it doesn't replace them.
# False positives are acceptable if staff reviews each alert.
#
# ═══════════════════════════════════════════════════════════

Click to expand...