EP-Captcha

# EPCaptcha

EPCaptcha is an open-source anti-AFK farming protection plugin developed by Ender Plugins.

It detects suspicious farming behavior by combining multiple signals instead of relying on a simple inactivity timer. EPCaptcha can analyze sustained block breaking, camera movement, robotic breaking
patterns, and confined AFK loops. When suspicious activity is detected, the player must complete a configurable inventory captcha.

## Features

- Multi-signal AFK farming detection
- Sustained block-breaking analysis
- Camera movement and stillness detection
- Robotic block-breaking rhythm detection
- Configurable inventory captcha
- Teleport, kick, both, or unlimited timeout actions
- Optional AFK relocation to a configured spawn point
- Per-player client locale support
- English language enabled by default
- Built-in Turkish translation
- Easily extendable YAML language system
- MiniMessage and legacy color-code support
- Lightweight and fully configurable
- No NMS or version-specific internals

## Compatibility

- Minecraft 1.16.5–26.2
- CraftBukkit
- Spigot
- Paper
- Purpur
- Pufferfish
- Folia
- Compatible Bukkit/Paper forks
- ViaVersion and ViaBackwards
- Geyser and Floodgate

The captcha uses a standard inventory interface, allowing Java and Geyser-connected Bedrock players to complete verification without installing a client-side mod.

## Commands

- `/epcaptcha reload` — Reload configuration and language files
- `/epcaptcha setspawn` — Set the AFK relocation spawn
- `/epcaptcha test` — Open a test captcha
- `/epcaptcha info [player]` — View detection and client information

Aliases: `/epc`, `/captcha`

## Permissions

- `epcaptcha.admin` — Access administrative commands
- `epcaptcha.bypass` — Bypass all EPCaptcha detection

## Languages

EPCaptcha includes English and Turkish language files. English is used by default.

Additional languages can be added by copying an existing file inside `plugins/EPCaptcha/lang/`, translating its values, and selecting it in `config.yml`. Missing translations automatically fall back to
English.

## Installation

1. Download the EPCaptcha JAR.
2. Place it inside your server's `plugins` directory.
3. Restart the server.
4. Edit `plugins/EPCaptcha/config.yml`.
5. Run `/epcaptcha reload` after making changes.