Documentation
Everything needed to install, configure, benchmark, and operate Ecstacy Anticheat on production Minecraft servers. From first restart to the developer API.
Start Here
Essential guides recommended for new deployments and day-one setup.
I am installing it
Requirements, PacketEvents, the licensed jar, outbound firewall rules and how to verify the first startup.
It is running and nothing flags
How to confirm detections are live, what a normal first day looks like, and the order to diagnose it in.
I want to change a setting
Precision tiers, thresholds, alerts, punishment commands, mitigation and the heuristic layer. And which to leave alone.
Something is wrong
The plugin will not connect, players are kicked on join, nothing is flagging, or classes fail to load.
What can staff do in game
Every /ecstacy subcommand, which one to reach for in each situation, and how to read a flag alert.
I am writing a plugin
Maven and Gradle coordinates, the entry point, the player repository and the event bus, with a complete worked example.
Explore By Category
The complete documentation corpus grouped by system module. Looking for syntax? Check the checks.yml and settings.yml references.
Getting Started
Introduction
What Ecstacy AntiCheat detects, how the plugin and the cloud split the work, and what you need before installing it on a Paper, Purpur, Folia or Spigot server.
Installation
Install the Ecstacy AntiCheat plugin on your Minecraft server: requirements, PacketEvents, the licensed jar download, firewall rules and first startup.
First Steps
What to configure right after installing Ecstacy AntiCheat: server name, staff alerts, punishment commands, and how to confirm detections are actually running.
Usage
Commands
Every /ecstacy subcommand: checks, player, violations, alerts, cloud, logs, reputation, exempt, replay, spectate, suspicious, doctor, profiler and reload.
In-Game Panels
The Ecstacy AntiCheat GUIs: main menu, checks editor, player info, reputation, violations and the review queue. Plus alert format, themes and sounds.
Permissions
Every Ecstacy AntiCheat permission node, its default, and why ecstacy.exempt.* is never granted automatically. Including to operators.
Client Area
What you can do in the Ecstacy dashboard: live server and player stats, flag logs, licence UUID slots, allowed IPs, API key, jar downloads and plan billing.
Checks
Checks Overview
How Ecstacy checks flag players: check families, precision tiers, violation levels, fail.max thresholds, staff alerts, punishments and the heuristic layer.
Crystal Aura
Configure the Crystal Aura check: precision, violation threshold, staff alerts, punishment commands, packet mitigation and the optional heuristic layer.
Anchor Macro
Configure the Anchor Macro check: precision tiers, violation threshold, alerts, punishment commands and packet mitigation for respawn-anchor macros.
Auto Totem
Configure the Auto Totem check: precision, the fail.max 40 threshold, alert volume, punishment commands and mitigation for automated totem swaps.
Configuration
Settings
Every core key in Ecstacy's settings.yml: server name, debug, language, AI readout, cloud connection, database, logging, updates and dashboard GUI limits.
Integrations
Configure Ecstacy's client and third-party integrations: client-brand blacklist, Lunar, Badlion and Feather mod control, Discord webhooks and the spoofer.
Enforcement
Configure Ecstacy's enforcement settings: reputation, the cross-server known-cheaters blacklist, ban waves, the auto-ban schedule and replay recording.
Checks Configuration
The complete checks.yml key reference for Ecstacy AntiCheat: every key with its type and default, covering flags, alerts, thresholds and boolean toggles.
Developer
Developer API
Add the Ecstacy AntiCheat API to your plugin: Maven and Gradle coordinates, the EcstacyApiAccessor entry point, and the Server, Repository and Events APIs.
Events
The Ecstacy AntiCheat event catalogue: FlagEvent, PunishEvent, BanWaveEvent, CloudEvent and MitigateEvent, with fields, priorities and cancellation semantics.
HTTP API
Query Ecstacy AntiCheat data over HTTP: API key authentication, licence and server scoped endpoints, player reputation, violations and logs, and rate limits.
Help
FAQ
Common questions from Minecraft server owners about Ecstacy AntiCheat: performance, offline behaviour, false positives, Folia and Bedrock, licence and data.
Troubleshooting
Fix the common Ecstacy AntiCheat problems: the plugin will not connect, players are kicked on join, nothing is flagging, or classes fail to load.