ProtectCord - BungeeCord Edition
Platform Information
Compatible with: BungeeCord & Waterfall (1.8.8 - 1.21+) Java Version: Java 8+ Server Type: Proxy plugin
What This Plugin Does
ProtectCord for BungeeCord provides network-wide IP protection by checking every connecting player against our threat intelligence database at the proxy level. This means ALL players are verified before they can reach any of your backend servers.
Key Features
✅ Network-Wide Protection - One installation protects your entire server network ✅ First Line of Defense - Blocks malicious players before they reach backend servers ✅ VPN/Proxy Detection - Automatically blocks VPN and proxy connections ✅ Risk Assessment - AI-powered threat scoring from UNKNOWN to CRITICAL ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs ✅ Discord Alerts - Real-time webhook notifications when players are blocked ✅ Centralized Config - Single configuration for all backend servers
How It Works
- Player Connects to Proxy → IP is captured at BungeeCord login
- Background Check → IP is checked against ProtectCord API (async)
- Decision Made → Allow or block based on VPN/Proxy/Risk level
- Action Taken → Player continues to backend or sees custom kick message
- Notification → Optional Discord webhook alert
Automatic Bypasses
The plugin intelligently bypasses checking for:
- 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)
Why Use BungeeCord Edition?
Perfect For:
- 🌐 Server Networks - Protect multiple backend servers with one installation
- 🛡️ Centralized Security - Single point of IP verification for your entire network
- 💰 API Efficiency - Check each player once at proxy, not on every backend server
- 🔄 Waterfall Compatible - Works on both BungeeCord and Waterfall proxies
When to Choose BungeeCord Edition:
- Running a multi-server network with BungeeCord/Waterfall
- Want to protect all backend servers with one plugin installation
- Need centralized IP protection for your network
- Want to save API calls (check once at proxy vs. on every backend server)
Network Architecture:
Player → BungeeCord (ProtectCord checks here) → Backend Servers (protected)
Important: When using BungeeCord edition, you typically only install it on the proxy, not on backend servers. This provides network-wide protection and reduces API usage.
Configuration
Located at: plugins/ProtectCord/config.yml
api-key: "YOUR_API_KEY_HERE"
# Block settings
enable-ip-check: true
block-vpn: true
block-proxy: true
block-datacenter: false
block-bogon: true
blocked-risk-level: "HIGH"
# Discord webhooks (optional)
discord-webhook:
enabled: false
url: ""
events:
denied: true
accepted: false
whitelisted: true
error: true
Commands
Command | Description |
---|---|
/protectcord reload |
Reload configuration |
/protectcord stats |
View API usage stats |
/protectcord check <player|ip> |
Manually check an IP |
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <ip> |
Whitelist an IP |
/protectcord list |
View all whitelisted entries |
Aliases: /pc
, /protect
Permissions
Permission | Description | Default |
---|---|---|
protectcord.admin |
Access to all commands | OP |
Installation
- Download
ProtectCord-BungeeCord-1.0.0.jar
- Drop into your proxy's
plugins/
folder (not backend servers) - Start or restart your proxy
- Get a free API key from protectcord.com
- Add your API key to
plugins/ProtectCord/config.yml
- Run
/protectcord reload
or restart proxy - Done! Your entire network is protected ✅
Performance
- Async Processing - IP checks run in background threads
- No Proxy Lag - Main thread is never blocked
- Fast Responses - Most API calls complete in <100ms
- Network Efficient - Check once at proxy instead of on every backend server
- Minimal Overhead - Lightweight footprint on proxy resources
Network Setup Best Practices
Recommended Setup:
- ✅ Install ProtectCord only on BungeeCord proxy
- ✅ Configure
server.properties
on backend servers:online-mode=false
- ✅ Configure BungeeCord:
ip_forward=true
- ✅ Enable IP forwarding on backend servers (modern versions handle this automatically)
Why Install Only on Proxy?
- API Efficiency - Players checked once at proxy, not per-backend-server
- Network Protection - Blocks threats before they reach any backend server
- Easier Management - Single config for entire network
- Cost Effective - Reduces API calls significantly
Support
- 💬 Discord: protectcord.com/discord
- 🐛 Bug Reports: Submit an issue in our discord!
- 📖 Documentation: api.protectcord.com
Changelog
Version 1.0.0 (Initial Release)
- ✅ Real-time IP verification via ProtectCord API
- ✅ VPN, Proxy, and Datacenter detection
- ✅ Risk-based blocking system (UNKNOWN to CRITICAL)
- ✅ Player/UUID/IP whitelist system
- ✅ Discord webhook integration
- ✅ Configurable kick messages
- ✅ API usage statistics command
- ✅ Auto-update checker
- ✅ bStats integration
- ✅ Network-wide protection for BungeeCord/Waterfall
- ✅ Support for BungeeCord 1.8.8 - 1.21+
ProtectCord BungeeCord Edition - Network-wide protection for your entire server network
Made with ❤️ for the Minecraft community
ProtectCord - Velocity Edition
Platform Information
Compatible with: Velocity 3.0+ (1.8.8 - 1.21+) Java Version: Java 17+ Server Type: Proxy plugin
What This Plugin Does
ProtectCord for Velocity provides network-wide IP protection by checking every connecting player against our threat intelligence database at the proxy level. Built with Velocity's modern API for maximum performance and reliability.
Key Features
✅ Network-Wide Protection - One installation protects your entire server network ✅ First Line of Defense - Blocks malicious players before they reach backend servers ✅ VPN/Proxy Detection - Automatically blocks VPN and proxy connections ✅ Risk Assessment - AI-powered threat scoring from UNKNOWN to CRITICAL ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs ✅ Discord Alerts - Real-time webhook notifications when players are blocked ✅ Modern API - Built with Velocity's high-performance plugin architecture
How It Works
- Player Connects to Proxy → IP is captured at Velocity login
- Background Check → IP is checked against ProtectCord API (fully async)
- Decision Made → Allow or block based on VPN/Proxy/Risk level
- Action Taken → Player continues to backend or sees custom kick message
- Notification → Optional Discord webhook alert
Automatic Bypasses
The plugin intelligently bypasses checking for:
- 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)
Why Use Velocity Edition?
Perfect For:
- 🚀 Modern Networks - Built for Velocity's high-performance architecture
- 🌐 Server Networks - Protect multiple backend servers with one installation
- 🛡️ Centralized Security - Single point of IP verification for your entire network
- 💰 API Efficiency - Check each player once at proxy, not on every backend server
When to Choose Velocity Edition:
- Running a modern multi-server network with Velocity
- Want best performance with Velocity's optimizations
- Need centralized IP protection for your network
- Have Java 17+ available
- Prefer Velocity over BungeeCord for better performance
Network Architecture:
Player → Velocity (ProtectCord checks here) → Backend Servers (protected)
Important: When using Velocity edition, you typically only install it on the proxy, not on backend servers. This provides network-wide protection and reduces API usage.
Configuration
Located at: plugins/protectcord/config.toml
api-key = "YOUR_API_KEY_HERE"
# Block settings
enable-ip-check = true
block-vpn = true
block-proxy = true
block-datacenter = false
block-bogon = true
blocked-risk-level = "HIGH"
# Discord webhooks (optional)
[discord-webhook]
enabled = false
url = ""
[discord-webhook.events]
denied = true
accepted = false
whitelisted = true
error = true
Note: Velocity uses TOML format instead of YAML
Commands
Command | Description |
---|---|
/protectcord reload |
Reload configuration |
/protectcord stats |
View API usage stats |
/protectcord check <player|ip> |
Manually check an IP |
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <ip> |
Whitelist an IP |
/protectcord list |
View all whitelisted entries |
Aliases: /pc
, /protect
Permissions
Permission | Description | Default |
---|---|---|
protectcord.admin |
Access to all commands | OP |
Installation
- Download
ProtectCord-Velocity-1.0.0.jar
- Drop into your proxy's
plugins/
folder (not backend servers) - Start or restart your proxy
- Get a free API key from protectcord.com
- Add your API key to
plugins/protectcord/config.toml
- Run
/protectcord reload
or restart proxy - Done! Your entire network is protected ✅
Performance
- Fully Async - Uses Velocity's async event system
- Zero Proxy Lag - Never blocks the main thread
- Ultra Fast - Most API calls complete in <100ms
- Velocity-Optimized - Leverages Velocity's performance improvements
- Network Efficient - Check once at proxy instead of on every backend server
- Minimal Overhead - Lightweight footprint on proxy resources
Network Setup Best Practices
Recommended Setup:
- ✅ Install ProtectCord only on Velocity proxy
- ✅ Configure
server.properties
on backend servers:online-mode=false
- ✅ Configure Velocity:
player-info-forwarding-mode = "modern"
(orbungeeguard
) - ✅ Install Velocity forwarding support on backend servers (Paper/Spigot plugins)
Why Install Only on Proxy?
- API Efficiency - Players checked once at proxy, not per-backend-server
- Network Protection - Blocks threats before they reach any backend server
- Easier Management - Single config for entire network
- Cost Effective - Reduces API calls significantly
Velocity-Specific Features
This edition leverages Velocity's modern architecture:
- ✅ Uses Velocity's async event API
- ✅ Supports modern player info forwarding
- ✅ Compatible with Velocity 3.0+ features
- ✅ Thread-safe implementation
- ✅ Optimized for Velocity's netty-based networking
Support
- 💬 Discord: protectcord.com/discord
- 🐛 Bug Reports: Submit an issue in our discord!
- 📖 Documentation: api.protectcord.com
Changelog
Version 1.0.0 (Initial Release)
- ✅ Real-time IP verification via ProtectCord API
- ✅ VPN, Proxy, and Datacenter detection
- ✅ Risk-based blocking system (UNKNOWN to CRITICAL)
- ✅ Player/UUID/IP whitelist system
- ✅ Discord webhook integration
- ✅ Configurable kick messages
- ✅ API usage statistics command
- ✅ Auto-update checker
- ✅ bStats integration
- ✅ Network-wide protection for Velocity proxies
- ✅ Support for Velocity 3.0+ (1.8.8 - 1.21+)
- ✅ Modern async event handling
- ✅ TOML configuration format
ProtectCord Velocity Edition - Modern, high-performance protection for Velocity networks
Made with ❤️ for the Minecraft community
ProtectCord - Folia Edition
Platform Information
Compatible with: Folia 1.19+ Java Version: Java 17+ Server Type: Bukkit-based server plugin (Paper fork with regionalized multithreading)
What This Plugin Does
ProtectCord for Folia provides real-time IP protection for your Minecraft server by checking every connecting player against our threat intelligence database. Specially designed to work with Folia's unique regionalized multithreading system.
Key Features
✅ Folia-Compatible - Built specifically for Folia's threading model ✅ Region-Safe - All IP checks are fully async and won't block region threads ✅ VPN/Proxy Detection - Automatically blocks VPN and proxy connections ✅ Risk Assessment - AI-powered threat scoring from UNKNOWN to CRITICAL ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs ✅ Discord Alerts - Real-time webhook notifications when players are blocked ✅ High Performance - Optimized for Folia's multi-region architecture
How It Works
- Player Connects → IP is captured during async login event
- Background Check → IP is checked against ProtectCord API (region-safe async)
- Decision Made → Allow or block based on VPN/Proxy/Risk level
- Action Taken → Player joins or sees custom kick message
- Notification → Optional Discord webhook alert
Automatic Bypasses
The plugin intelligently bypasses checking for:
- 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)
Why Use Folia Edition?
Perfect For:
- 🚀 High-Performance Servers - Optimized for Folia's regionalized multithreading
- 🌍 Large Worlds - Works seamlessly with Folia's multi-region system
- ⚡ Maximum TPS - Won't interfere with Folia's performance improvements
- 🎮 Survival Servers - Ideal for large survival/SMP servers on Folia
When to Choose Folia Edition:
- Running Folia 1.19+ (Paper fork)
- Using regionalized multithreading for performance
- Need thread-safe IP protection
- Have Java 17+ available
What Makes It Special:
Unlike traditional plugins, Folia Edition is designed from the ground up to respect Folia's threading model:
- ✅ No region thread blocking
- ✅ All API calls are fully async
- ✅ Thread-safe whitelist management
- ✅ Compatible with Folia's unique scheduler
Configuration
Located at: plugins/ProtectCord/config.yml
api-key: "YOUR_API_KEY_HERE"
# Block settings
enable-ip-check: true
block-vpn: true
block-proxy: true
block-datacenter: false
block-bogon: true
blocked-risk-level: "HIGH"
# Discord webhooks (optional)
discord-webhook:
enabled: false
url: ""
events:
denied: true
accepted: false
whitelisted: true
error: true
Commands
Command | Description |
---|---|
/protectcord reload |
Reload configuration |
/protectcord stats |
View API usage stats |
/protectcord check <player|ip> |
Manually check an IP |
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <ip> |
Whitelist an IP |
/protectcord list |
View all whitelisted entries |
Aliases: /pc
, /protect
Permissions
Permission | Description | Default |
---|---|---|
protectcord.admin |
Access to all commands | OP |
Installation
- Download
ProtectCord-Folia-1.0.0.jar
- Drop into your server's
plugins/
folder - Start or restart your server
- Get a free API key from protectcord.com
- Add your API key to
plugins/ProtectCord/config.yml
- Run
/protectcord reload
or restart again - Done! Your server is protected ✅
Performance
- Region-Safe - Never blocks region threads
- Fully Async - All IP checks run in background
- Zero TPS Impact - Works with Folia's threading model
- Ultra Fast - Most API calls complete in <100ms
- Folia-Optimized - Designed for regionalized multithreading
Folia-Specific Notes
This edition has been specifically adapted for Folia's architecture:
- ✅ Uses Folia-compatible async task scheduler
- ✅ No synchronous operations on region threads
- ✅ Thread-safe configuration and whitelist management
- ✅ Compatible with multi-region world splitting
- ✅ Tested on Folia 1.19+ builds
Support
- 💬 Discord: protectcord.com/discord
- 🐛 Bug Reports: Submit an issue in our discord!
- 📖 Documentation: api.protectcord.com
Changelog
Version 1.0.0 (Initial Release)
- ✅ Real-time IP verification via ProtectCord API
- ✅ VPN, Proxy, and Datacenter detection
- ✅ Risk-based blocking system (UNKNOWN to CRITICAL)
- ✅ Player/UUID/IP whitelist system
- ✅ Discord webhook integration
- ✅ Configurable kick messages
- ✅ API usage statistics command
- ✅ Auto-update checker
- ✅ bStats integration
- ✅ Full Folia compatibility (1.19+)
- ✅ Region-safe async operations
- ✅ Thread-safe implementation
ProtectCord Folia Edition - High-performance protection for regionalized multithreaded servers
Made with ❤️ for the Minecraft community
ProtectCord - Paper Edition
Platform Information
Compatible with: Paper 1.13 - 1.21+ (including PaperSpigot) Java Version: Java 17+ Server Type: Bukkit-based server plugin (Paper fork)
What This Plugin Does
ProtectCord for Paper provides real-time IP protection for your Minecraft server by checking every connecting player against our threat intelligence database. Optimized for Paper's async event system and modern API.
Key Features
✅ Paper-Optimized - Uses Paper's async login events for best performance ✅ VPN/Proxy Detection - Automatically blocks VPN and proxy connections ✅ Risk Assessment - AI-powered threat scoring from UNKNOWN to CRITICAL ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs ✅ Discord Alerts - Real-time webhook notifications when players are blocked ✅ Lightning Fast - Fully async, leverages Paper's performance improvements ✅ Modern API - Built for Paper 1.13+ with latest features
How It Works
- Player Connects → IP is captured during Paper's async login event
- Background Check → IP is checked against ProtectCord API (fully async)
- Decision Made → Allow or block based on VPN/Proxy/Risk level
- Action Taken → Player joins or sees custom kick message
- Notification → Optional Discord webhook alert
Automatic Bypasses
The plugin intelligently bypasses checking for:
- 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)
Why Use Paper Edition?
Perfect For:
- ⚡ Modern Servers - Optimized for Paper 1.13+
- 🚀 Performance - Leverages Paper's async improvements
- 🔧 Latest Features - Uses modern Paper API capabilities
- 🎮 All Server Types - Survival, PvP, Skyblock, Minigames, etc.
When to Choose Paper Edition:
- Running Paper 1.13 or newer
- Want best performance with Paper's optimizations
- Have Java 17+ available
- Using modern Minecraft versions
Configuration
Located at: plugins/ProtectCord/config.yml
api-key: "YOUR_API_KEY_HERE"
# Block settings
enable-ip-check: true
block-vpn: true
block-proxy: true
block-datacenter: false
block-bogon: true
blocked-risk-level: "HIGH"
# Discord webhooks (optional)
discord-webhook:
enabled: false
url: ""
events:
denied: true
accepted: false
whitelisted: true
error: true
Commands
Command | Description |
---|---|
/protectcord reload |
Reload configuration |
/protectcord stats |
View API usage stats |
/protectcord check <player|ip> |
Manually check an IP |
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <ip> |
Whitelist an IP |
/protectcord list |
View all whitelisted entries |
Aliases: /pc
, /protect
Permissions
Permission | Description | Default |
---|---|---|
protectcord.admin |
Access to all commands | OP |
Installation
- Download
ProtectCord-Paper-1.0.0.jar
- Drop into your server's
plugins/
folder - Start or restart your server
- Get a free API key from protectcord.com
- Add your API key to
plugins/ProtectCord/config.yml
- Run
/protectcord reload
or restart again - Done! Your server is protected ✅
Performance
- Fully Async - Uses Paper's async login events
- Zero Server Lag - Never blocks the main thread
- Ultra Fast - Most API calls complete in <100ms
- Paper-Optimized - Leverages Paper's performance improvements
- Minimal Overhead - Lightweight footprint on server resources
Support
- 💬 Discord: protectcord.com/discord
- 🐛 Bug Reports: Submit an issue in our discord!
- 📖 Documentation: api.protectcord.com
Changelog
Version 1.0.0 (Initial Release)
- ✅ Real-time IP verification via ProtectCord API
- ✅ VPN, Proxy, and Datacenter detection
- ✅ Risk-based blocking system (UNKNOWN to CRITICAL)
- ✅ Player/UUID/IP whitelist system
- ✅ Discord webhook integration
- ✅ Configurable kick messages
- ✅ API usage statistics command
- ✅ Auto-update checker
- ✅ bStats integration
- ✅ Optimized for Paper 1.13 - 1.21+
- ✅ Uses Paper's async login events
ProtectCord Paper Edition - Optimized protection for modern Paper servers
Made with ❤️ for the Minecraft community
ProtectCord - Spigot Edition
Platform Information
Compatible with: Spigot 1.8.8 - 1.21+ (including CraftBukkit) Java Version: Java 8+ Server Type: Bukkit-based server plugin
What This Plugin Does
ProtectCord for Spigot provides real-time IP protection for your Minecraft server by checking every connecting player against our threat intelligence database.
Key Features
✅ Broad Version Support - Works on legacy versions (1.8.8+) all the way to modern Minecraft ✅ VPN/Proxy Detection - Automatically blocks VPN and proxy connections ✅ Risk Assessment - AI-powered threat scoring from UNKNOWN to CRITICAL ✅ Smart Whitelist - Bypass protection for trusted players, UUIDs, or IPs ✅ Discord Alerts - Real-time webhook notifications when players are blocked ✅ Lightweight - Async processing won't slow down your server ✅ Configurable - Customize what gets blocked and how strict the filtering is
How It Works
- Player Connects → IP is captured during login
- Background Check → IP is checked against ProtectCord API (async)
- Decision Made → Allow or block based on VPN/Proxy/Risk level
- Action Taken → Player joins or sees custom kick message
- Notification → Optional Discord webhook alert
Automatic Bypasses
The plugin intelligently bypasses checking for:
- 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)
Why Use Spigot Edition?
Perfect For:
- 🕹️ Legacy Servers - Full support for 1.8.8 through 1.12.2
- 📦 Vanilla Spigot - Works on pure Spigot without any forks
- 🔄 Maximum Compatibility - Lightweight implementation for all Java 8+ servers
- 🎮 All Server Types - Survival, PvP, Skyblock, Minigames, etc.
When to Choose Spigot Edition:
- Running Spigot 1.8.8 - 1.12.2 (legacy versions)
- Using vanilla Spigot without Paper optimizations
- Need Java 8 compatibility
- Want proven stability on classic Spigot builds
Configuration
Located at: plugins/ProtectCord/config.yml
api-key: "YOUR_API_KEY_HERE"
# Block settings
enable-ip-check: true
block-vpn: true
block-proxy: true
block-datacenter: false
block-bogon: true
blocked-risk-level: "HIGH"
# Discord webhooks (optional)
discord-webhook:
enabled: false
url: ""
events:
denied: true
accepted: false
whitelisted: true
error: true
Commands
Command | Description |
---|---|
/protectcord reload |
Reload configuration |
/protectcord stats |
View API usage stats |
/protectcord check <player|ip> |
Manually check an IP |
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <ip> |
Whitelist an IP |
/protectcord list |
View all whitelisted entries |
Aliases: /pc
, /protect
Permissions
Permission | Description | Default |
---|---|---|
protectcord.admin |
Access to all commands | OP |
Installation
- Download
ProtectCord-Spigot-1.0.0.jar
- Drop into your server's
plugins/
folder - Start or restart your server
- Get a free API key from protectcord.com
- Add your API key to
plugins/ProtectCord/config.yml
- Run
/protectcord reload
or restart again - Done! Your server is protected ✅
Performance
- Async Processing - IP checks run in background threads
- No Server Lag - Main thread is never blocked
- Fast Responses - Most API calls complete in <100ms
- Minimal Overhead - Lightweight footprint on server resources
Support
- 💬 Discord: protectcord.com/discord
- 🐛 Bug Reports: Submit an issue in our discord!
- 📖 Documentation: api.protectcord.com
Changelog
Version 1.0.0 (Initial Release)
- ✅ Real-time IP verification via ProtectCord API
- ✅ VPN, Proxy, and Datacenter detection
- ✅ Risk-based blocking system (UNKNOWN to CRITICAL)
- ✅ Player/UUID/IP whitelist system
- ✅ Discord webhook integration
- ✅ Configurable kick messages
- ✅ API usage statistics command
- ✅ Auto-update checker
- ✅ bStats integration
- ✅ Support for Spigot 1.8.8 - 1.21+
ProtectCord Spigot Edition - Protect your legacy and modern Spigot servers
Made with ❤️ for the Minecraft community