{"id":86251,"date":"2026-06-05T01:17:08","date_gmt":"2026-06-04T22:17:08","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/"},"modified":"2026-06-05T01:17:08","modified_gmt":"2026-06-04T22:17:08","slug":"ip-block","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/","title":{"rendered":"IP-Block"},"content":{"rendered":"

# IPBlock – IP Protection Plugin<\/p>\n

A powerful PaperMC plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.<\/p>\n

## Features<\/p>\n

| Feature | Description |
\n|———|————-|
\n| \ud83c\udf0d **Country Filter** | Whitelist\/Blacklist countries using GeoIP |
\n| \ud83d\udee1\ufe0f **Anti-DDoS** | Connection throttling, auto-block spam IPs |
\n| \u26a1 **Rate Limiting** | Block IPs with excessive connection attempts |
\n| \ud83d\udccb **Blacklist** | Permanent IP blacklist (auto-saved) |
\n| \ud83d\udce5 **Auto-Download** | Automatically downloads GeoLite2 database |
\n| \ud83d\udd14 **Webhooks** | Discord & Telegram notifications |<\/p>\n

## Installation<\/p>\n

1. Download `IPBlock-1.0.0.jar` from [Download](#download)
\n2. Place in your server’s `plugins\/` folder
\n3. Start server \u2192 GeoIP database auto-downloads!<\/p>\n

## Commands<\/p>\n

| Command | Description |
\n|———|————-|
\n| `\/ipblock reload` | Reload config and services |
\n| `\/ipblock status` | View plugin status |
\n| `\/ipblock check ` | Check country of an IP |
\n| `\/ipblock whitelist add\/remove ` | Manage IP whitelist |
\n| `\/ipblock blacklist add\/remove ` | Manage IP blacklist |
\n| `\/ipblock ddos` | View Anti-DDoS status |
\n| `\/ipblock webhook` | Configure Discord\/Telegram webhooks |
\n| `\/ipblock update` | Update GeoLite2 database |<\/p>\n

## Configuration<\/p>\n

### Basic Setup (config.yml)
\n“`yaml
\n# Mode: whitelist (only allow) or blacklist (block)
\nmode: whitelist<\/p>\n

# Countries (ISO 3166-1 alpha-2)
\ncountries:
\n – VN # Vietnam<\/p>\n

# Anti-DDoS
\nanti-ddos:
\n enabled: true
\n max-connections-per-second: 50
\n max-connections-per-ip: 3
\n“`<\/p>\n

### Webhook Setup
\n“`bash
\n# Discord
\n\/ipblock webhook discord https:\/\/discord.com\/api\/webhooks\/YOUR_ID\/YOUR_TOKEN<\/p>\n

# Telegram
\n\/ipblock webhook telegram YOUR_BOT_TOKEN YOUR_CHAT_ID<\/p>\n

# Test & Apply
\n\/ipblock webhook test
\n\/ipblock reload
\n“`<\/p>\n

## Country Codes (ISO 3166-1 alpha-2)<\/p>\n

### Asia
\n| Code | Country | Code | Country |
\n|——|———|——|———|
\n| VN | \ud83c\uddfb\ud83c\uddf3 Vietnam | PH | \ud83c\uddf5\ud83c\udded Philippines |
\n| TH | \ud83c\uddf9\ud83c\udded Thailand | MY | \ud83c\uddf2\ud83c\uddfe Malaysia |
\n| SG | \ud83c\uddf8\ud83c\uddec Singapore | ID | \ud83c\uddee\ud83c\udde9 Indonesia |
\n| JP | \ud83c\uddef\ud83c\uddf5 Japan | KR | \ud83c\uddf0\ud83c\uddf7 South Korea |
\n| TW | \ud83c\uddf9\ud83c\uddfc Taiwan | CN | \ud83c\udde8\ud83c\uddf3 China |
\n| HK | \ud83c\udded\ud83c\uddf0 Hong Kong | IN | \ud83c\uddee\ud83c\uddf3 India |<\/p>\n

### Europe
\n| Code | Country | Code | Country |
\n|——|———|——|———|
\n| GB | \ud83c\uddec\ud83c\udde7 United Kingdom | DE | \ud83c\udde9\ud83c\uddea Germany |
\n| FR | \ud83c\uddeb\ud83c\uddf7 France | IT | \ud83c\uddee\ud83c\uddf9 Italy |
\n| ES | \ud83c\uddea\ud83c\uddf8 Spain | NL | \ud83c\uddf3\ud83c\uddf1 Netherlands |
\n| PL | \ud83c\uddf5\ud83c\uddf1 Poland | RU | \ud83c\uddf7\ud83c\uddfa Russia |
\n| UA | \ud83c\uddfa\ud83c\udde6 Ukraine | SE | \ud83c\uddf8\ud83c\uddea Sweden |<\/p>\n

### Americas
\n| Code | Country | Code | Country |
\n|——|———|——|———|
\n| US | \ud83c\uddfa\ud83c\uddf8 United States | CA | \ud83c\udde8\ud83c\udde6 Canada |
\n| MX | \ud83c\uddf2\ud83c\uddfd Mexico | BR | \ud83c\udde7\ud83c\uddf7 Brazil |
\n| AR | \ud83c\udde6\ud83c\uddf7 Argentina | CL | \ud83c\udde8\ud83c\uddf1 Chile |<\/p>\n

### Oceania
\n| Code | Country | Code | Country |
\n|——|———|——|———|
\n| AU | \ud83c\udde6\ud83c\uddfa Australia | NZ | \ud83c\uddf3\ud83c\uddff New Zealand |<\/p>\n

> \ud83d\udcd6 Full list: ISO 3166-1 alpha-2<\/p>\n

## Permissions<\/p>\n

| Permission | Description |
\n|————|————-|
\n| `ipblock.admin` | Access to all commands |<\/p>\n

## Requirements<\/p>\n

– PaperMC 1.20+ (or compatible forks)
\n– Java 21+<\/p>\n

## Building<\/p>\n

“`bash
\n.\/gradlew shadowJar
\n“`<\/p>\n

Output: `build\/libs\/IPBlock-1.0.0.jar`<\/p>\n

## License<\/p>\n

MIT License<\/p>\n","protected":false},"excerpt":{"rendered":"

A powerful plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.<\/p>\n","protected":false},"featured_media":86252,"template":"","meta":{"_minecraft_slug":"ip-block","_minecraft_project_id":"WuW7dneU","_minecraft_author":"chiraitori","_minecraft_license":"MIT","_minecraft_downloads":122,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ip-block.zip","_minecraft_size_bytes":2251260,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:10:21.534752Z","_minecraft_date_created":"2026-01-13T21:10:47.973512Z","_minecraft_date_modified":"2025-12-23T07:50:41.661796Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ip-block","_minecraft_icon_attachment_id":86252,"_minecraft_imported_at":"2026-06-04T22:17:09+00:00","_minecraft_import_hash":"f32cd909056b48e73a563d8ad190b2e6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-86251","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nIP-Block - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"IP-Block - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A powerful plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/\",\"name\":\"IP-Block - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp\",\"datePublished\":\"2026-06-04T22:17:08+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ip-block\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"IP-Block\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"IP-Block - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/","og_locale":"en_US","og_type":"article","og_title":"IP-Block - Minecraft","og_description":"A powerful plugin to protect your Minecraft server from unwanted connections based on country, with built-in Anti-DDoS protection.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/","name":"IP-Block - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp","datePublished":"2026-06-04T22:17:08+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ip-block-icon-b43fd378beb4b5c84bfadf64e0136fe2b271310b_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ip-block\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"IP-Block"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/86251","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/86252"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=86251"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=86251"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=86251"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=86251"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}