# IPBanPlugin<\/p>\n
A lightweight, high-performance IP ban system for Velocity Proxy servers.<\/p>\n
## \ud83d\ude80 Features<\/p>\n
– **Ultra Lightweight**: Weighs only ~350KB (no external database drivers required).
\n– **JSON Storage**: Simple, human-readable storage in `banned_ips.json`. No database setup needed.
\n– **High Performance**:
\n – Instant ban checks (0ms latency) using in-memory caching.
\n – Asynchronous file I\/O to prevent server lag.
\n– **Full UTF-8 Support**: Correctly handles Cyrillic and special characters in ban reasons and messages.
\n– **Instant Kick**: Automatically kicks players who are online when their IP is banned.<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest `ipbanplugin-x.x.x.jar` from the releases page.
\n2. Place the jar file into your Velocity `plugins\/` folder.
\n3. Restart the proxy.<\/p>\n
## \ud83d\udee0 Commands & Permissions<\/p>\n
| Command | Usage | Description | Permission | ## \u2699\ufe0f Configuration<\/p>\n The plugin generates a configuration folder at `plugins\/ipbanplugin\/`.<\/p>\n ### `config.yml` ### `messages.properties` ### `banned_ips.json` ## \ud83d\udccb Requirements<\/p>\n – Velocity 3.3.0 or higher ## Github Velocity plugin that manages banned IP addresses<\/p>\n","protected":false},"featured_media":86250,"template":"","meta":{"_minecraft_slug":"ip-ban-plugin","_minecraft_project_id":"K9wTOnq4","_minecraft_author":"Nestor_Churin","_minecraft_license":"MIT","_minecraft_downloads":159,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ip-ban-plugin.zip","_minecraft_size_bytes":905479,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:18:34.053805Z","_minecraft_date_created":"2025-07-11T04:54:38.430194Z","_minecraft_date_modified":"2026-01-01T12:52:36.343864Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ip-ban-plugin","_minecraft_icon_attachment_id":86250,"_minecraft_imported_at":"2026-06-04T22:16:44+00:00","_minecraft_import_hash":"346211c761937e084a3cdb9caaf38f0b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[850,851,339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,852,853,854,855,856,857,858,859,166,10,11,12,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-86249","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-0","minecraft_version-1-1","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","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","minecraft_version-1-3-1","minecraft_version-1-3-2","minecraft_version-1-4-2","minecraft_version-1-4-4","minecraft_version-1-4-5","minecraft_version-1-4-6","minecraft_version-1-4-7","minecraft_version-1-5-1","minecraft_version-1-5-2","minecraft_version-1-6-1","minecraft_version-1-6-2","minecraft_version-1-6-4","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n|———|——-|————-|————|
\n| `\/ipban` | `\/ipban` | Lists all banned IPs. | `ipbanplugin.ban` |
\n| `\/ipban` | `\/ipban
\n| `\/unbanip` | `\/unbanip
\nBasic configuration settings.<\/p>\n
\nFully customizable messages with support for color codes (`&`) and placeholders.
\n*Note: The file is read as UTF-8, so you can use any language.*<\/p>\n
\nStores the ban data.
\n“`json
\n[
\n {
\n “ip”: “127.0.0.1”,
\n “bannedBy”: “Admin”,
\n “bannedAt”: “2026-01-01 12:00:00”
\n }
\n]
\n“`<\/p>\n
\n– Java 17 or higher<\/p>\n
\nhttps:\/\/github.com\/yunexal\/ip-ban-plugin<\/p>\n","protected":false},"excerpt":{"rendered":"