Protectcord 1.0.1
Protectcord is an anti VPN/Proxy plugin it uses an advanced API to check if an IPv4/IPv6 is a vpn
ProtectCord - Advanced IP Protection
Spigot Edition
Protect your Minecraft server from VPNs, proxies, bots, and malicious connections with real-time IP intelligence.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Key Features
🛡️ 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!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎮 Compatibility
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📥 Installation
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 ✅
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Configuration
# ProtectCord Configuration
# Location: plugins/ProtectCord/config.yml
# Your ProtectCord API key
api-key: "YOUR_API_KEY_HERE"
# What to block
enable-ip-check: true
block-vpn: true # Block VPN connections
block-proxy: true # Block proxy servers
block-datacenter: false # Block datacenter IPs (hosting providers)
block-bogon: true # Block invalid/bogus IPs
# Risk threshold - how strict should blocking be?
# Options: LOW, MEDIUM, HIGH, CRITICAL
blocked-risk-level: "HIGH"
# Discord webhooks (optional)
discord-webhook:
enabled: false
url: ""
events:
denied: true # Alert when players are blocked
accepted: false # Alert when players connect
whitelisted: true # Alert when whitelisted players join
error: true # Alert on API errors
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 Commands
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 - Manually check an IP
/protectcord list - View all whitelisted entries
Whitelist Commands:
/protectcord whitelist add player - Whitelist a player
/protectcord whitelist add uuid - Whitelist a UUID
/protectcord whitelist add ip - Whitelist an IP address
/protectcord whitelist remove - Remove from whitelist
Command Aliases: /pc, /protect
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔐 Permissions
| Permission | Description | Default |
| protectcord.admin | Access to all commands | OP |
| protectcord.bypass | Bypass IP checks (future) | false |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡️ How It Works
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📢 Discord Webhook Integration
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:
discord-webhook:
enabled: true
url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE"
events:
denied: true # Get alerts when players are blocked
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❓ FAQ
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 or whitelist by UUID/IP for permanent bypass.
What if a legitimate player gets blocked?
Whitelist them with /protectcord whitelist add player . 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.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Why Choose ProtectCord?
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 Troubleshooting
"API KEY NOT CONFIGURED!" error
[LIST=1]Get your API key from protectcord.com/dashboardAdd it to plugins/ProtectCord/config.ymlRun /protectcord reload
[/LIST]
Players getting blocked incorrectly
[LIST=1]Check the reason: /protectcord check Whitelist them: /protectcord whitelist add player Or lower strictness: Change blocked-risk-level to HIGH or CRITICAL
[/LIST]
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)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🌐 Links & Support
🌍 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!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📜 License
MIT License - Free to use, modify, and distribute
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Protect your server today with ProtectCord!
Because prevention is better than moderation.
Made with ❤️ for the Minecraft community
