AdvancedCaptcha is a powerful anti-bot solution for Minecraft servers. It supports both
button-based and
math captchas, a full
freeze system, colored messages, and deep customization. Designed to protect your server without annoying your players.
⚙️ Configuration
All settings are in plugins/AdvancedCaptcha/config.yml. Key options:
# AdvancedCaptcha Configuration
# This file controls the behavior of the AdvancedCaptcha plugin.
# All settings are organized into sections for clarity.
# General settings for the plugin
general:
# Default language for messages (e.g., 'en', 'ru', 'ua')
default-language: en
# Supported languages for player locale detection
supported-languages:
- en
- ru
- ua
# Logging level (INFO, DEBUG, WARN)
log-level: INFO
# Captcha settings
captcha:
# Type of captcha to use (BUTTON, MATH, RANDOM)
type: RANDOM
# Cooldown for re-verification in milliseconds (default: 6 hours = 21600000 ms)
cooldown: 21600000
# Minimum number of buttons in captcha (min: 2)
button-count-min: 4
# Maximum number of buttons in captcha (max: 10)
button-count-max: 7
# Maximum number of attempts to pass captcha
max-attempts: 2
# Timeout for captcha completion in seconds
timeout: 300
# Commands allowed during captcha verification
allowed-commands:
- /login
- /register
# Colors used for buttons (supported: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE)
button-colors:
- BLUE
- GREEN
- RED
- YELLOW
- WHITE
- BLACK
- GRAY
- LIGHT_PURPLE
# Sound and particle effects
success-sound: ENTITY_PLAYER_LEVELUP
fail-sound: ENTITY_VILLAGER_NO
success-particle: VILLAGER_HAPPY
fail-particle: SMOKE_NORMAL
# Anti-macro threshold in milliseconds (minimum time to click to avoid macro detection)
anti-macro-threshold: 200
# Freeze settings to restrict player actions during captcha
freeze:
# Enable or disable freezing player actions
enabled: true
# Slowness effect level (1-6, higher values make player slower)
slowness-level: 6
# Settings specific to the mathematical captcha
math-captcha:
# Allowed mathematical operations (PLUS, MINUS, MULTIPLY)
allowed-operations:
- PLUS
- MINUS
- MULTIPLY
# Minimum value for numbers in math expressions
number-range-min: 1
# Maximum value for numbers in math expressions
number-range-max: 20
Tips: • Set captcha.type to BUTTON, MATH or RANDOM
• Use captcha.freeze to prevent movement or chat before verification
• Add allowed commands to captcha.allowed-commands (e.g., /login)
Localization
Localization files are located in plugins/AdvancedCaptcha/messages/. Available:
• messages_en.yml – English
• messages_ru.yml – Русский
• messages_ua.yml – Українська
To add a new language:
Create a new file (e.g. messages_de.yml)
Translate all messages
Add the language code to supported-languages in config.yml
How It Works
On join, players must pass a captcha before interacting:
✅
Button Captcha: Click the correct colored button
✅
Math Captcha: Solve a simple math problem
✅ Freeze System: Prevents movement, chatting, or interaction
Restrictions:
Players can’t move (freeze)
Blocked from chat (except allowed commands)
No interaction with items, blocks, or entities
Success: Player is unfrozen, receives a success message and sound
Failure: Player is kicked after max-attempts or timeout
Protect your server from bots the smart way — with AdvancedCaptcha!