WebsiteCaptcha - Secure Your Minecraft Server with CAPTCHA Verification
WebsiteCaptcha is a Minecraft plugin that enhances server security by requiring players to verify themselves via a web-based CAPTCHA before accessing the main game world. The plugin integrates with an SQLite database for persistent verification and offers extensive customization to fit your server’s needs.
⚠ Disclaimer
WebsiteCaptcha is an experimental plugin and may contain bugs or glitches. It is a proof-of-concept and could exhibit instabilities under high player loads or certain server configurations. The embedded web server, SQLite database, and timeout mechanics may lead to unexpected behavior.
Use this plugin at your own risk, and test it in a controlled environment before deploying it on a live server. Contributions to improve stability and fix bugs are highly encouraged!
Features
✅
CAPTCHA Verification – Players must complete a Google reCAPTCHA challenge via a web link.
✅
Limbo System – Unverified players are placed in a restricted void world with limited actions.
✅
XP Bar Countdown – Displays the remaining verification time, smoothly decreasing.
✅
Configurable Settings – Customize timeout duration, game mode, flight, blindness, and inventory visibility via config.yml.
✅
Kick Delay – Displays a configurable message for 5 seconds before kicking on timeout.
✅
Version Detection – Logs player Minecraft versions (1.8 to 1.21.4) using ProtocolLib.
✅
Persistent Storage – Stores verification data in an SQLite database (verification.db).
✅
Custom Website Editor – Want to animate the page, add custom JavaScript, or build your dream interface? You can!
Edit the default site at plugins/WebsiteCaptcha/website, or add your own custom pages in website/custom.
How It Works
1️⃣
Player Joins – The plugin logs the player’s IP, name, and version, then checks their verification status.
2️⃣
Verification Check – If unverified or expired, the player is sent to Limbo.
3️⃣
CAPTCHA Prompt – A clickable chat message provides a link to the CAPTCHA page.
4️⃣
Timeout Mechanism – An XP bar counts down; if it reaches zero, the player is kicked after a short delay.
5️⃣
Success – Upon CAPTCHA completion, the player is teleported to the main world with restored settings.
Installation
✅ Requirements
- Minecraft Server – Supports Paper/Bukkit/Spigot (1.20 - 1.21.4).
- ProtocolLib – Required for Limbo system and version detection.
Quick Setup
1️⃣ Download the latest .jar from the Releases
2️⃣ Place it in your /plugins/ folder
3️⃣ Install ProtocolLib
4️⃣ Start the server to generate the configuration files
5️⃣ Set a free port in the Web.port section of config.yml
6️⃣ Add your Google reCAPTCHA site key and secret key in config.yml
7️⃣ Visit the
Documentation Page for full setup and customization tips
Credits & Support
Developer: No_onenowhoiam
Discord: apgamingboy (For support and inquiries)
Issue Reporting: Report bugs and issues on GitHub