Protectcord

# ProtectCord — Advanced IP Protection & Moderation **Block VPNs, proxies, bots, and malicious connections with real-time IP intelligence. Built-in moderation, AutoMod chat filtering, alt detection, and MySQL multi-server sync — all in one lightweight plugin.** ProtectCord connects every joining player against a live threat intelligence database before they ever reach your server. Combined with a full moderation suite, it's the only tool you need to keep your server clean and your community safe. ## ✨ Milestones - **2,300+** downloads on Modrinth - **100,000+** ProtectCord API requests served - **46** unique Minecraft servers running ProtectCord concurrently - **203** concurrent protected players - **1,000+** unique Discord users verified - **3,000+** unique API requests per day - **555** Discord Guilds using @ProtectCord#0253 - Watching over **100,000+** Discord users **bStats:** https://bstats.org/plugin/bukkit/Protectcord/24623 --- ## ✨ Key Features ### IP Protection - 🛡️ **Real-Time IP Verification** — Every connection checked against live threat intelligence - 🚫 **VPN, Proxy & Tor Blocking** — Stop ban evaders and alt accounts instantly - 🏢 **Datacenter IP Detection** — Flag and block hosting provider IPs used for bots - ⚠️ **Risk-Based Blocking** — Configurable threat levels: UNKNOWN → LOW → MEDIUM → HIGH → CRITICAL - 🌍 **Geo-Blocking** — Block or whitelist entire countries using ISO codes - 👥 **Accounts-Per-IP Limiting** — Cap simultaneous connections from a single IP - ✅ **Smart Whitelist System** — Bypass protection by player name, UUID, or IP ### Moderation Suite - ⚡ **Progressive Warning System** — Configurable auto-escalation from warn → kick → ban - ⏱️ **Temp Bans & Temp Mutes** — Time-limited punishments with human-readable durations (`1h`, `7d`, `30d`) - 🔇 **Mute System** — Persistent mutes with reasons, issuer tracking, and auto-expiry - 🔍 **Alt Account Detection** — Find alts by shared IP (`/pc alts <player>`) — names only, never raw IPs - 📋 **Warning History** — Full timestamped warning logs for any player, online or offline - 🧹 **Clear & Remove Warnings** — Remove individual warnings by index or clear all at once - 🗄️ **Audit Log** — Automatic log of all moderation actions - 💾 **Offline Player Support** — Warn, ban, mute, or check players who aren't online ### AutoMod (Chat Filtering) - 🔗 **Anti-Link** — Block URLs with domain whitelist support - 📢 **Anti-Advertising** — Block server IPs and Discord invites - 💬 **Anti-Spam** — Rate limiting with configurable message window and duplicate detection - 🤬 **Anti-Swear** — Custom word blacklist with regex support and per-word exceptions - 🔠 **Anti-Caps** — Configurable caps threshold by percentage - 🌊 **Anti-Flood** — Block repeated character flooding - 🔣 **Anti-Unicode/Zalgo** — Block invisible text and character abuse - ⚙️ **Per-Rule Actions** — Each rule independently set to: `BLOCK`, `WARN`, `KICK`, `MUTE`, or `TEMPMUTE` ### Storage & Multi-Server - 🗃️ **YAML Flatfile Storage** — Zero setup, works out of the box - 🐬 **MySQL Storage** — Full MySQL backend with HikariCP connection pooling - 🌐 **Multi-Server Sync** — Share one MySQL database across your entire network; bans and mutes are enforced on every server - 🔄 **Live Migration** — Migrate between YAML and MySQL at any time with `/pc migrate` - 🧹 **Data Purge** — Clean up old warnings, bans, mutes, IP logs, audit entries, and inactive players with `/pc purge` ### Staff Tools - 📣 **In-Game Staff Alerts** — Real-time notifications for kicks, bans, warns, mutes, automod actions, and more - 🎭 **IP Masking** — Show staff masked IPs (`192.168.1.*`) until they earn the `protectcord.ip.full` permission - 📝 **Player Reports** — Players submit reports with `/report`; staff are notified in-game and via Discord - 📊 **API Stats** — Check usage, rate limits, and API health with `/pc stats` - 🔎 **Manual IP Check** — `/pc check <player|ip>` for on-demand threat analysis ### Platform & Integration - 🌐 **6-Platform Support** — Paper, Spigot, Folia, BungeeCord, Velocity, and Forge - 📢 **Discord Webhooks** — Rich embeds with country flag, city, VPN/proxy/tor/risk fields, per-event control, rate limiting, and retry logic - 📣 **Moderation Alert Webhooks** — Separate webhook channel for ban/warn/mute/kick staff events - ⚡ **100% Async** — All IP checks are non-blocking; no main-thread impact --- ## 🎮 Supported Platforms | Platform | Versions | Notes | |----------|----------|-------| | **Paper** | 1.13 – 1.21+ | Recommended for standalone servers | | **Spigot** | 1.8.8 – 1.21+ | Full legacy support | | **Folia** | 1.19+ | Multithreaded scheduler support | | **Velocity** | 3.0+ | Recommended for proxy networks | | **BungeeCord** | 1.8.8 – 1.21+ | Waterfall compatible | | **Forge** | 1.20.1+ | Server-side only; checks at post-login | > **Network tip:** Install only on your proxy (Velocity/BungeeCord) to protect all backend servers with a single API key. --- ## 📥