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

1. Download IPBlock-1.0.0.jar from Download
2. Place in your server's plugins/ folder
3. 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