IPBlock - IP Protection Plugin
A powerful PaperMC plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.
Features
| Feature | Description |
|---|---|
| 🌍 Country Filter | Whitelist/Blacklist countries using GeoIP |
| 🛡️ Anti-DDoS | Connection throttling, auto-block spam IPs |
| ⚡ Rate Limiting | Block IPs with excessive connection attempts |
| 📋 Blacklist | Permanent IP blacklist (auto-saved) |
| 📥 Auto-Download | Automatically downloads GeoLite2 database |
| 🔔 Webhooks | Discord & Telegram notifications |
Installation
- Download
IPBlock-1.0.0.jarfrom Download - Place in your server's
plugins/folder - Start server → GeoIP database auto-downloads!
Commands
| Command | Description |
|---|---|
/ipblock reload |
Reload config and services |
/ipblock status |
View plugin status |
/ipblock check <ip> |
Check country of an IP |
/ipblock whitelist add/remove <ip> |
Manage IP whitelist |
/ipblock blacklist add/remove <ip> |
Manage IP blacklist |
/ipblock ddos |
View Anti-DDoS status |
/ipblock webhook |
Configure Discord/Telegram webhooks |
/ipblock update |
Update GeoLite2 database |
Configuration
Basic Setup (config.yml)
# Mode: whitelist (only allow) or blacklist (block)
mode: whitelist
# Countries (ISO 3166-1 alpha-2)
countries:
- VN # Vietnam
# Anti-DDoS
anti-ddos:
enabled: true
max-connections-per-second: 50
max-connections-per-ip: 3
Webhook Setup
# Discord
/ipblock webhook discord https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN
# Telegram
/ipblock webhook telegram YOUR_BOT_TOKEN YOUR_CHAT_ID
# Test & Apply
/ipblock webhook test
/ipblock reload
Country Codes (ISO 3166-1 alpha-2)
Asia
| Code | Country | Code | Country |
|---|---|---|---|
| VN | 🇻🇳 Vietnam | PH | 🇵🇭 Philippines |
| TH | 🇹🇭 Thailand | MY | 🇲🇾 Malaysia |
| SG | 🇸🇬 Singapore | ID | 🇮🇩 Indonesia |
| JP | 🇯🇵 Japan | KR | 🇰🇷 South Korea |
| TW | 🇹🇼 Taiwan | CN | 🇨🇳 China |
| HK | 🇭🇰 Hong Kong | IN | 🇮🇳 India |
Europe
| Code | Country | Code | Country |
|---|---|---|---|
| GB | 🇬🇧 United Kingdom | DE | 🇩🇪 Germany |
| FR | 🇫🇷 France | IT | 🇮🇹 Italy |
| ES | 🇪🇸 Spain | NL | 🇳🇱 Netherlands |
| PL | 🇵🇱 Poland | RU | 🇷🇺 Russia |
| UA | 🇺🇦 Ukraine | SE | 🇸🇪 Sweden |
Americas
| Code | Country | Code | Country |
|---|---|---|---|
| US | 🇺🇸 United States | CA | 🇨🇦 Canada |
| MX | 🇲🇽 Mexico | BR | 🇧🇷 Brazil |
| AR | 🇦🇷 Argentina | CL | 🇨🇱 Chile |
Oceania
| Code | Country | Code | Country |
|---|---|---|---|
| AU | 🇦🇺 Australia | NZ | 🇳🇿 New Zealand |
📖 Full list: ISO 3166-1 alpha-2
Permissions
| Permission | Description |
|---|---|
ipblock.admin |
Access to all commands |
Requirements
- PaperMC 1.20+ (or compatible forks)
- Java 21+
Building
./gradlew shadowJar
Output: build/libs/IPBlock-1.0.0.jar
License
MIT License
