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

1. Player Connects → IP is captured during login
2. Background Check → IP is checked against ProtectCord API (async)
3. Decision Made → Allow or block based on VPN/Proxy/Risk level
4. Action Taken → Player joins or sees custom kick message
5. 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

1. Download ProtectCord-Spigot-1.0.0.jar
2. Drop into your server's plugins/ folder
3. Start or restart your server
4. Get a free API key from protectcord.com
5. Add your API key to plugins/ProtectCord/config.yml
6. Run /protectcord reload or restart again
7. 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