• ️ Real-Time IP Verification - Every connection checked against threat intelligence database
• Block VPNs & Proxies - Stop ban evaders and alt accounts instantly
• ⚠️ Risk-Based Blocking - AI-powered threat levels from LOW to CRITICAL
• Discord Integration - Real-time alerts when suspicious players are blocked
• ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs
• ⚡ Lightweight & Fast - Async IP checks won't slow down your server
• Free Forever - 32 requests/minute, no hidden costs!

Minecraft Versions: 1.8.8 - 1.21+
Java Version: Java 8+
Server Type: Spigot & CraftBukkit

✅ Perfect for legacy servers (1.8.8 - 1.12.2) and modern Spigot installations



Step 1: Download ProtectCord-Spigot from the resource page
Step 2: Drop the JAR into your server's plugins/ folder
Step 3: Start or restart your server
Step 4: Get a FREE API key from protectcord.com
Step 5: Add your API key to plugins/ProtectCord/config.yml
Step 6: Run /protectcord reload or restart
Step 7: Done! Your server is protected ✅





All commands require the protectcord.admin permission (default: OP)

Main Commands:

• /protectcord reload - Reload configuration and whitelist
• /protectcord stats - View API usage and limits
• /protectcord check <player|ip> - Manually check an IP
• /protectcord list - View all whitelisted entries

Whitelist Commands:

• /protectcord whitelist add player <name> - Whitelist a player
• /protectcord whitelist add uuid <uuid> - Whitelist a UUID
• /protectcord whitelist add ip <address> - Whitelist an IP address
• /protectcord whitelist remove <type> <value> - Remove from whitelist

Command Aliases: /pc, /protect

Permission	Description	Default
protectcord.admin	Access to all commands	OP
protectcord.bypass	Bypass IP checks (future)	false

Detection System

ProtectCord checks every connecting player against our threat intelligence database:

• ✅ VPN Detection - Identifies virtual private networks used to hide real IPs
• ✅ Proxy Detection - Detects HTTP/SOCKS proxies and anonymizers
• ✅ Datacenter IPs - Flags hosting providers (common for bots)
• ✅ Risk Scoring - AI-powered risk assessment from UNKNOWN to CRITICAL
• ✅ Bogon Detection - Blocks invalid/reserved IP ranges

Risk Levels

Level	What It Means	Default Action
UNKNOWN	Not enough data	✅ Allow
LOW	Clean IP address	✅ Allow
MEDIUM	Some suspicious activity	✅ Allow
HIGH	Known malicious activity	❌ Block
CRITICAL	Active threat/attacker	❌ Block

Tip: Customize blocking threshold with blocked-risk-level in your config!

Automatic Bypasses

Smart detection automatically allows:

• Localhost - 127.0.0.1, ::1
• Private networks - 192.168.x.x, 10.x.x.x, 172.16-31.x.x
• Whitelisted players - Configured via commands or config file

Get notified instantly when suspicious players try to connect!

Setup in 30 Seconds

1. Create Discord Webhook

• Server Settings → Integrations → Webhooks → New Webhook
• Copy the webhook URL

2. Add to config:
3. Reload: /protectcord reload

What You'll See

• Connection Denied - Player blocked (includes IP, reason, risk level)
• Connection Accepted - Player allowed (optional)
• Whitelisted Join - Trusted player connected
• API Error - Problem with IP check

Is this free to use?
Yes! Our free API key includes 32 requests per minute which is plenty for most servers.

Will this lag my server?
No! IP checks are 100% asynchronous and won't block the main thread. Most checks complete in under 100ms.

Can I whitelist my staff/friends?
Absolutely! Use /protectcord whitelist add player <name> or whitelist by UUID/IP for permanent bypass.

What if a legitimate player gets blocked?
Whitelist them with /protectcord whitelist add player <name>. You can also adjust blocked-risk-level to be less strict.

Does this work with offline mode?
Yes, but we recommend online mode for better security. The plugin works on both.

What happens if the API is down?
By default, players are allowed to connect if the API is unreachable. This prevents lockouts during maintenance.



Perfect For:

• PvP Servers - Stop ban evaders from using VPNs
• Survival Servers - Prevent alt accounts and griefing
• ️ Hub Servers - Block bots before they can spam
• ⚔️ Competitive Servers - Ensure fair play with IP verification
• ️ Legacy Servers - Full support for Spigot 1.8.8+

Advantages Over Other Anti-VPN Plugins:

• ✅ Real-time threat intelligence - Updated constantly, not outdated databases
• ✅ Risk scoring system - More nuanced than simple block/allow
• ✅ Multi-platform support - One solution for all server types
• ✅ Active development - Regular updates and improvements
• ✅ Great support - Fast response times on Discord
• ✅ Free forever - No hidden costs or paywalls

"API KEY NOT CONFIGURED!" error

1. Get your API key from protectcord.com/dashboard
2. Add it to plugins/ProtectCord/config.yml
3. Run /protectcord reload

Players getting blocked incorrectly

1. Check the reason: /protectcord check <player>
2. Whitelist them: /protectcord whitelist add player <name>
3. Or lower strictness: Change blocked-risk-level to HIGH or CRITICAL

Rate limit exceeded
Free tier: 32 requests/min (approximately 1 player every 2 seconds)

Solutions:

• Use whitelist for regular players to reduce API calls
• Private/local IPs are automatically bypassed (no API call)

• Website: protectcord.com
• API Documentation: api.protectcord.com
• Dashboard: protectcord.com/dashboard
• Discord Support: protectcord.com/discord
• Modrinth: modrinth.com/plugin/protectcord

Need help? Join our Discord server for fast support!



MIT License - Free to use, modify, and distribute