IP-Block
0.1A powerful plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.
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
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta