ProtectCord is an advanced Discord security bot designed to protect your server from malicious users, bots, and threats. It provides comprehensive verification systems, real-time threat detection, and powerful API integrations.
🔐 Verification System
Advanced CAPTCHA verification with bot detection and automated role assignment.
🌐 Threat Detection
Real-time VPN, proxy, and Tor detection with 99.9% accuracy using global threat intelligence.
🌍 Regional Blocking
Country-based access controls and geographical restrictions for enhanced security.
📊 Analytics Dashboard
Comprehensive security insights with detailed logs and threat analysis.
🔑 Powerful API
RESTful API for custom integrations and automated security workflows.
⚡ High Performance
Built for scale with sub-second response times and 99.9% uptime.
🚀 Getting Started
Get ProtectCord running on your Discord server in under 5 minutes with these simple steps:
📋 Prerequisites:
Discord server with Administrator permissions
Bot permissions: Administrator (or specific permissions listed below)
Channel where ProtectCord can send verification messages
Step 1: Invite ProtectCord
Click the invite link and select your Discord server:
Use the /setup command to configure your security settings:
Discord Command
/setup
Step 3: Configure Settings
The setup wizard will guide you through:
Selecting verification channel and role
Configuring security features (VPN/Proxy/Tor blocking)
Setting up welcome messages
Enabling regional restrictions
✅ Success! Your server is now protected by ProtectCord. Users will need to complete verification before accessing your server.
⚙️ Detailed Setup Guide
Required Permissions
ProtectCord requires the following permissions to function properly:
Permission
Required
Purpose
Manage Roles
✅ Yes
Assign verified role to users
Manage Channels
✅ Yes
Set up verification channels
Send Messages
✅ Yes
Send verification prompts and messages
Embed Links
✅ Yes
Display rich verification messages
Use Slash Commands
✅ Yes
Bot command functionality
Kick Members
⚠️ Optional
Auto-kick blocked users
Ban Members
⚠️ Optional
Auto-ban repeat offenders
Verification Flow
Understanding how ProtectCord verifies users:
User joins server - New member joins your Discord server
Verification prompt - ProtectCord sends verification message in designated channel
IP analysis - User's IP is checked against threat databases
CAPTCHA challenge - User completes verification on secure web portal
Security checks - Additional checks based on your settings
Role assignment - Verified users receive the designated role
Configuration Options
/setup
Interactive setup wizard with the following options:
Setting
Description
Default
Verification Channel
Channel where verification messages are sent
Required
Verified Role
Role assigned to verified users
Required
Welcome Channel
Channel for welcome messages (optional)
None
VPN Blocking
Block VPN connections
Enabled
Proxy Blocking
Block proxy connections
Enabled
Tor Blocking
Block Tor connections
Enabled
Anti-Alt Protection
Prevent same IP from joining multiple servers
Disabled
Regional Blocking
Block specific countries
Disabled
🛡️ Security Features
Verification System
🤖 Bot Detection
Advanced algorithms detect and block automated bot accounts using behavioral analysis and pattern recognition.
🧩 CAPTCHA Challenges
Human verification through secure CAPTCHA challenges with multiple difficulty levels and accessibility options.
⚡ Real-time Processing
Sub-second verification processing with instant role assignment and security feedback.
Threat Detection
🌐 VPN Detection
99.9% accurate VPN detection using global threat intelligence and machine learning algorithms.
🔒 Proxy Blocking
Comprehensive proxy detection including HTTP, SOCKS, and transparent proxies with real-time updates.
🧅 Tor Detection
Complete Tor network detection with exit node tracking and relay identification.
🏢 Datacenter Filtering
Block connections from known datacenter IPs and hosting providers to prevent abuse.
🔄 Real-time Updates
Threat database updated every 60 seconds with new indicators and emerging threats.
🎯 Custom Rules
Create custom security rules and whitelists for your specific use case and requirements.
Regional Blocking
Control access based on geographical location:
Country Blocking: Block or allow specific countries
Continent Filtering: Regional restrictions by continent
Custom Exceptions: Whitelist specific IPs or users
Compliance Mode: GDPR and regional compliance tools
⚠️ Important: Regional blocking should be used carefully to avoid excluding legitimate users. Consider your community's global nature before enabling strict geographical restrictions.
🤖 Bot Commands
Complete reference for all ProtectCord commands. All commands require appropriate permissions.
Setup & Configuration
/setup
Description: Launch the interactive setup wizard to configure ProtectCord
Permissions: Administrator
Parameters: None (interactive wizard)
Example Usage
/setup
/refresh
Description: Refresh the verification message and update security settings
Permissions: Administrator
Example Usage
/refresh
Security & Management
/verify [user]
Description: Manually verify a user and assign the verified role
Permissions: Administrator
Parameter
Type
Required
Description
user
User
Yes
The user to manually verify
Example Usage
/verify @username
/lookup [user_id]
Description: Look up user verification history and security information
Permissions: Administrator
Parameter
Type
Required
Description
user_id
String
Yes
Discord user ID to lookup
Example Usage
/lookup 123456789012345678
/checkip [ip_address]
Description: Check an IP address for threats and security information
Permissions: Administrator
Parameter
Type
Required
Description
ip_address
String
Yes
IPv4 address to analyze
Example Usage
/checkip 1.1.1.1
IP Management
/ipmanage
Description: Manage IP whitelist and blacklist (Administrator only)
Player Connects - A player attempts to join your server
IP Captured - Player's IP address is extracted from the connection
Background Check - IP is checked against ProtectCord API (fully async)
Threat Analysis - API returns VPN/Proxy/Datacenter status and risk score
Decision Made - Plugin decides to allow or block based on your config
Action Taken - Player either joins successfully or sees custom kick message
Webhook Alert - Optional Discord notification is sent
Network Setup (Proxy Servers)
💡 Best Practice: For BungeeCord or Velocity networks, install ProtectCord only on the proxy, not on backend servers. This provides network-wide protection and reduces API usage.
Proxy setup checklist:
✅ Install ProtectCord on BungeeCord/Velocity proxy only
✅ Configure backend servers: online-mode=false
✅ Enable IP forwarding on proxy and backend servers
✅ Configure your API key on the proxy
Java Code Example
Integrate ProtectCord API into your own Minecraft plugin:
JAVA (Spigot/Paper)
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.AsyncPlayerPreLoginEvent;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;
public class ProtectCordExample implements Listener {
private final String API_KEY = "your_api_key_here";
@EventHandler
public void onPlayerLogin(AsyncPlayerPreLoginEvent event) {
String ip = event.getAddress().getHostAddress();
try {
URL url = new URL("https://api.protectcord.com/checkip/" + ip + "?key=" + API_KEY);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
if (conn.getResponseCode() == 200) {
// Parse JSON response
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
String response = reader.readLine();
JSONObject json = new JSONObject(response);
boolean isVPN = json.getBoolean("vpn");
boolean isProxy = json.getBoolean("proxy");
String risk = json.getString("risk");
if (isVPN || isProxy || risk.equals("HIGH") || risk.equals("CRITICAL")) {
event.disallow(
AsyncPlayerPreLoginEvent.Result.KICK_OTHER,
"§c§lConnection Blocked\n\n" +
"§7Your IP has been flagged as suspicious.\n" +
"§7Please disable your VPN/Proxy and try again."
);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
⚠️ Important Notes:
All IP checks are fully async to prevent server lag
Localhost and private IPs are automatically bypassed
Whitelisted players bypass all security checks
API calls typically complete in under 100ms
🔗 Webhooks
Receive real-time notifications about security events in your Discord server.
Setting Up Webhooks
Create a webhook URL in your Discord channel settings or use any HTTPS endpoint
Select which events you want to receive notifications for
Save your settings and test the webhook connection
💡 Dashboard Configuration: Webhooks are now configured through the user-friendly dashboard interface.
Visit /dashboard/guild/YOUR_GUILD_ID/webhooks to set up webhooks for your server.
🔒 Privacy Protection: User IP addresses are never included in webhook payloads
for privacy and security reasons. Only country codes and security flags are provided.