NeonCore | Captcha ADDON

NeonCore — Captcha Addon
A powerful, self-hosted human verification system for Discord — plug-and-play addon for NeonCore.

Installation

Drop
Code:
```
captcha.py
```
into your
Code:
```
/configurations
```
folder
Open the file and fill in the
Code:
```
─── CONFIG ───
```
section at the top
Run
Code:
```
!captcha-setup
```
in any channel — done. No restart needed.

Configuration

All settings are at the top of the file — no external config, no database, no setup wizard.

Code:

# ── VERIFY CHANNEL ──────────────────────────────────
VERIFY_CHANNEL_ID = 123456789012345678   # Channel where the embed is posted

# ── ROLES ────────────────────────────────────────────
ROLES_TO_GIVE    = [111111111, 222222222]  # Roles to assign on success
ROLES_TO_REMOVE  = [333333333]            # Roles to strip on success

# ── DIFFICULTY ──────────────────────────────────────
MAX_ATTEMPTS     = 3     # Max wrong attempts before fail
TIMEOUT_SECONDS  = 120   # Seconds to complete the captcha
CAPTCHA_LENGTH   = 6     # Number of characters in the code

# ── PUNISHMENT ──────────────────────────────────────
KICK_ON_FAIL     = True  # Kick if the user fails
KICK_ON_TIMEOUT  = True  # Kick if the user times out

# ── VISUAL ──────────────────────────────────────────
EMBED_COLOR      = 0x5865F2
BANNER_URL       = 'https://i.imgur.com/yourimage.png'  # Top banner image
THUMBNAIL_URL    = ''                                   # Small icon

# ── ADMIN ACCESS ─────────────────────────────────────
ADMIN_ROLE_IDS   = [444444444]   # Roles allowed to run admin commands
ADMIN_USER_IDS   = [555555555]   # Users allowed to run admin commands

Features

Custom Image Captcha — generated in real time with noise, distortion and random character colors. No external API needed.
Multiple Roles — give and remove as many roles as you want on a successful verification.
Custom Banner & Thumbnail — add your server's banner or logo to the verification embed.
Fully Configurable Text — customize the embed title, description and footer.
Persistent Buttons — the Verify button survives bot restarts automatically.
Auto-Post on Startup — the addon posts or refreshes the verification message by itself when the bot starts.
Event Logging — every pass, fail and timeout is logged to your chosen channel.
Timeout System — users have a configurable time limit, with optional kick on expiry.
Admin Commands — restricted to your chosen roles/users, no slash commands needed.
Full Debug Logging — detailed console output on startup so you know exactly what is happening.

Admin Commands

Code:
```
!captcha-setup
```
— Post or refresh the verify embed in the configured channel
Code:
```
!captcha-reset @user
```
— Clear an active captcha session for a user
Code:
```
!captcha-sessions
```
— View all currently active captcha sessions

How It Works

The bot posts an embed with a Verify Me button in your verification channel.
A user clicks the button — an ephemeral message with a custom distorted image appears only to them.
They click Enter Code, type what they see, and submit.
If correct → roles are assigned/removed, welcome message shown.
If wrong → a new image is generated, attempts counter decreases.
If they run out of attempts or time → optional kick.

Need Help?
Having trouble with the installation? Found a bug? Got a question?
Don't post in the reviews — join our Discord and open a ticket.
We'll get back to you as fast as possible.

Support the Project
I spend countless hours developing and maintaining these premium addons for free.
If you enjoy my work and want to support future updates, consider buying me a coffee!

Part of the NeonCore ecosystem — modular, clean, and production-ready.

NeonCore | Captcha ADDON v1.0

Overview Dependencies History