IP Ban Plugin

Minecraft 版本： 1.0 1.1 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.3.1 1.3.2 1.4.2 1.4.4 1.4.5 1.4.6 1.4.7 1.5.1 1.5.2 1.6.1 1.6.2 1.6.4 1.7.2 1.7.3 1.7.4 1.7.5 1.7.6 1.7.7 1.7.8 1.7.9 1.7.10 1.8 1.8.1 1.8.2 1.8.3 1.8.4 1.8.5 1.8.6 1.8.7 1.8.8 1.8.9 1.9 1.9.1 1.9.2 1.9.3 1.9.4 1.10 1.10.1 1.10.2 1.11 1.11.1 1.11.2 1.12 1.12.1 1.12.2 1.13 1.13.1 1.13.2 1.14 1.14.1 1.14.2 1.14.3 1.14.4 1.15 1.15.1 1.15.2 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： velocity

标签： management technology utility

IPBanPlugin

A lightweight, high-performance IP ban system for Velocity Proxy servers.

? Features

• Ultra Lightweight: Weighs only ~350KB (no external database drivers required).
• JSON Storage: Simple, human-readable storage in banned_ips.json. No database setup needed.
• High Performance:
  • Instant ban checks (0ms latency) using in-memory caching.
  • Asynchronous file I/O to prevent server lag.
• Full UTF-8 Support: Correctly handles Cyrillic and special characters in ban reasons and messages.
• Instant Kick: Automatically kicks players who are online when their IP is banned.

? Installation

1. Download the latest ipbanplugin-x.x.x.jar from the releases page.
2. Place the jar file into your Velocity plugins/ folder.
3. Restart the proxy.

? Commands & Permissions

⚙️ Configuration

The plugin generates a configuration folder at plugins/ipbanplugin/.

config.yml

Basic configuration settings.

messages.properties

Fully customizable messages with support for color codes (&) and placeholders.
Note: The file is read as UTF-8, so you can use any language.

banned_ips.json

Stores the ban data.

[
  {
    "ip": "127.0.0.1",
    "bannedBy": "Admin",
    "bannedAt": "2026-01-01 12:00:00"
  }
]

? Requirements

• Velocity 3.3.0 or higher
• Java 17 or higher

Github

https://github.com/yunexal/ip-ban-plugin