Introduction
How AntiRaid's CAPTCHA system works and what it protects against.
AntiRaid's CAPTCHA system presents new members with an image challenge they must solve before they can participate in the server. This filters out basic automated bots while letting real users through.
Important: CAPTCHAs are not a complete defense. Sophisticated bots and determined users can bypass them. Use CAPTCHA as one layer of protection alongside other AntiRaid features like inspectors and lockdown.
How it works
AntiRaid's CAPTCHA is fully integrated with the Luau templating system. Instead of offering a fixed CAPTCHA type, you write a Luau template that generates the challenge. This means you can:
- Configure the difficulty (character count, noise level, visual distortion)
- Add filters to make the image harder for OCR tools to read
- Track per-user attempts and increase difficulty on repeated failures
- Combine CAPTCHA with other verification logic in the same template
The CAPTCHA template runs whenever a new member joins and needs to be verified. The template returns a CAPTCHA configuration, which AntiRaid uses to generate the challenge image.
Getting started
See the Examples page for ready-to-use Luau CAPTCHA templates you can copy and customize.