Protect your modded Minecraft server from VPNs, proxies, alt accounts, and problematic players with real-time IP intelligence and automated moderation.
ProtectCord is a server-side only Forge mod that provides two critical layers of protection:
Automatically blocks suspicious connections using real-time threat intelligence:
Manage player behavior with our automated 3-strike warning system:
✅ Server-Side Only - No client installation required ✅ Lightweight - Minimal performance impact, fully async ✅ Compatible - Works alongside other security mods ✅ Operator Commands - All commands require OP level 2+ ✅ Automated Moderation - Less time managing problematic players ✅ Free API - 32 requests per minute included
1. Get Your Free API Key
2. Install the Mod
protectcord-forge-1.0.5-dev-all.jarmods/ folder3. Configure
config/protectcord.tomlapi-key = "YOUR_API_KEY_HERE"4. Restart & Enjoy
Config file location: config/protectcord.toml
# Your API key from protectcord.com
api-key = "YOUR_API_KEY_HERE"
# IP Check Settings
enable-ip-check = true
block-vpn = true # Block VPN connections
block-proxy = true # Block proxy servers
block-tor = true # Block Tor exit nodes
block-datacenter = false # Block hosting/datacenter IPs
block-bogon = true # Block invalid/bogus IPs
# Risk Level Blocking
enable-risk-level-blocking = false
blocked-risk-level = "HIGH" # Options: LOW, MEDIUM, HIGH, CRITICAL
[geo-blocking]
enabled = false
mode = "blacklist" # "blacklist" or "whitelist"
countries = ["CN", "RU"] # Country codes to block/whitelist
[discord-webhook]
enabled = false
url = "" # Your Discord webhook URL
[discord-webhook.events]
denied = true
accepted = false
whitelisted = true
error = true
[messages]
connection-denied = "§c§lConnection Denied\n§7Reason: {reason}\n§7Risk: {risk}"
api-error = "§c§lConnection Error\n§7Unable to verify your connection."All commands require OP level 2+ (operator/console only)
| Command | Description |
|---|---|
/protectcord reload |
Reload config and warning data |
/protectcord stats |
View API usage and limits |
/protectcord check <player|ip> |
Manually check an IP address |
/protectcord version |
View mod version information |
| Command | Description |
|---|---|
/protectcord whitelist add player <name> |
Whitelist a player |
/protectcord whitelist add uuid <uuid> |
Whitelist a UUID |
/protectcord whitelist add ip <address> |
Whitelist an IP address |
/protectcord whitelist remove <type> <value> |
Remove from whitelist |
/protectcord list |
View all whitelisted entries |
| Command | Description |
|---|---|
/protectcord kick <player> |
Kick player with IP analysis |
/protectcord warn <player> <reason> |
Issue warning (3-strike system) |
/protectcord warnings <player> |
View player's warning history |
/protectcord ban <player> <reason> |
Manually ban a player |
/protectcord unban <player> |
Remove a ban |
Strike 1 - First Warning
/protectcord warn PlayerName Griefing spawn area→ Player receives in-game warning message (1/3)
Strike 2 - Final Warning
/protectcord warn PlayerName Continued griefing→ Player is kicked with final warning (2/3)
Strike 3 - Automatic Ban
/protectcord warn PlayerName Breaking server rules→ Player is permanently banned (3/3)
config/protectcord-warnings.toml/protectcord ban to skip warnings# Warn a player
/protectcord warn Notch Using X-Ray mod
→ "Warned Notch for: Using X-Ray mod (Warning: 1/3)"
# Check their warning history
/protectcord warnings Notch
→ Shows all warnings with timestamps and reasons
# Manually ban without warnings
/protectcord ban Notch Repeated violations
→ "Notch has been banned."
# Unban a player
/protectcord unban Notch
→ "Notch has been unbanned."Get real-time alerts in Discord when players are blocked or warned!
config/protectcord.toml:[discord-webhook]
enabled = true
url = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE"
[discord-webhook.events]
denied = true # Alert when players are blocked
accepted = false # Alert when players connect
whitelisted = true # Alert when whitelisted players join
error = true # Alert on API errors/protectcord reloadCompatible With:
Note: ProtectCord is server-side only and doesn't modify client behavior.
Smart detection automatically allows:
127.0.0.1, ::1192.168.x.x, 10.x.x.x, 172.16-31.x.xQ: Do players need to install this mod? A: No! This is server-side only. Players don't need anything.
Q: Will this work with modpacks? A: Yes! Just add it to your server's mods folder.
Q: What if my VPN-using admin gets blocked?
A: Whitelist them with /protectcord whitelist add player AdminName
Q: Is this free? A: Yes! Free API key includes 32 requests/minute.
Q: Can I customize the kick messages?
A: Yes! Edit the [messages] section in config/protectcord.toml
Q: Does this work in offline mode? A: Yes, but online mode is recommended for better security.
Q: What happens if the API is down? A: Players are allowed to connect by default (fail-open behavior).
Q: Can I see how many people were blocked?
A: Use /protectcord stats to view API usage and statistics.
Q: Will this conflict with my other mods? A: No known conflicts. ProtectCord only checks IPs on login.
Version: 1.0.5-dev
This is a development build with the new warning and moderation system. All features are functional but not yet fully tested in large-scale production environments.
Recommended: Test on a development server before deploying to production.
What's New in v1.0.5-dev:
ProtectCord is also available for:
Download from Modrinth or our website.
Protect your modded server today - Because prevention is better than moderation.
Made with ❤️ for the Minecraft community
