Download File

# 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` ```yaml 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](https://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](https://protectcord.com/discord) - 🐛 **Bug Reports:** Submit an issue in our discord! - 📖 **Documentation:** [api.protectcord.com](https://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*