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 `) — 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 ` 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.