Documentation
Everything needed to run Ecstacy Anticheat on a production server. From the first restart to the developer API.
Ecstacy is an anticheat for Minecraft servers built around Crystal PvP. It ships as a single plugin jar for Paper, Purpur, Pufferfish, Folia, Spigot and Minestom, scores player behaviour in the Ecstacy cloud rather than on your hardware, and detects combat automation. Crystal Aura, Anchor Macro and Auto Totem. That rule-based anticheats are not built to catch. It is designed to run alongside a movement anticheat, not instead of one.
If you are installing it for the first time, read Introduction, Installation and First steps in that order. About ten minutes, and they cover the settings that matter on day one. If Ecstacy is already running and you are here to change something, Checks overview explains how flags, violation levels, thresholds and punishments fit together, and every per-check page assumes you have read it.
Start here
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.
Everything else
The full corpus below is grouped the same way as the sidebar. The two reference pages, checks.yml and settings.yml, document every key in those files and are the right place to look when you already know what you are after.
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.
Hiding — AntiESP and AntiXray
Configure Ecstacy's hiding checks: entity occlusion against ESP, block obfuscation against Xray, HideStructure for caves and bases, and the freecam pocket.
Configuration
settings.yml Reference
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.yml Reference
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.