Velocity IP Ban Plugin

Created by Yunexal Labs - A simple and efficient IP banning plugin for Velocity proxy servers

📋 Overview

Velocity IP Ban Plugin is a lightweight yet powerful solution for managing IP bans on Velocity proxy servers. The plugin provides instant IP blocking, automatic online player kicking, and support for multiple IP management - all without unnecessary complexity.

✨ Features

• 🚫 Instant IP Blocking - Blocks banned IP addresses before players can connect to any backend server
• 👥 Multiple IP Support - Ban or unban multiple IP addresses with a single command
• ⚡ Online Player Kicking - Automatically kicks players when their IP gets banned while they're online
• 📊 Statistics Integration - Built-in bStats integration for usage analytics
• 🎨 Colored Messages - Beautiful colored console output and player messages
• 💾 SQLite Database - Lightweight, serverless database storage
• 🔧 Simple Configuration - Minimal setup required
• 🌐 No Dependencies - Works out of the box with just Velocity

🚀 Installation

1. Download the latest velocity-ip-ban-1.0.0.jar from releases
2. Place the JAR file in your Velocity server's plugins folder
3. Restart your Velocity server
4. The plugin will automatically create configuration files on first run

📖 Commands

/ipban - Ban IP Addresses

Permission: velocityipban.ban
Aliases: /banip

Usage Examples:

# Show list of all banned IPs
/ipban

# Ban a single IP address
/ipban 192.168.1.100

# Ban multiple IP addresses at once
/ipban 192.168.1.100 10.0.0.50 172.16.0.10

# Mix valid and invalid IPs (invalid ones will be skipped with warnings)
/ipban 192.168.1.100 invalid.ip 10.0.0.50

/unbanip - Unban IP Addresses

Permission: velocityipban.unban
Aliases: /unban-ip

Usage Examples:

# Unban a single IP address
/unbanip 192.168.1.100

# Unban multiple IP addresses at once
/unbanip 192.168.1.100 10.0.0.50 172.16.0.10

⚙️ Configuration

config.yml

# Velocity IP Ban Plugin Configuration
# Created by Yunexal Labs
# 
# A simple and efficient IP banning system for Velocity proxy servers

# Database settings
database:
  type: "sqlite"
  sqlite:
    file: "banned_ips.db"

# Debug mode
debug: false

messages.properties

All plugin messages are customizable through the messages.properties file:

# Ban messages
ban.message=&cYour IP has been parked by Yunexal Autonomous Security. Appeal is not possible. Skill issue?
ban.kick_online=&cYour IP has been banned while you were online. Reconnection is not possible.
ban.success=&aSuccessfully banned IP: &f{ip}
ban.success_multiple=&aSuccessfully banned &f{count} &aIPs: &f{ips}
ban.already=&cIP {ip} is already banned
ban.some_already=&eWarning: Some IPs were already banned: &f{already_banned}

# Unban messages  
unban.success=&aSuccessfully unbanned IP: &f{ip}
unban.success_multiple=&aSuccessfully unbanned &f{count} &aIPs: &f{ips}
unban.not_banned=&cIP {ip} is not banned
unban.some_not_banned=&eWarning: Some IPs were not banned: &f{not_banned}

# List messages
list.header=&6=== Banned IPs ===
list.entry=&7{ip} &8- &fbanned by &f{banned_by}
list.empty=&7No IPs are currently banned

# Error messages
error.invalid_ip=&cInvalid IP address format: &f{ip}
error.no_permission=&cYou don't have permission to use this command
error.database=&cDatabase error occurred. Check console for details.

# Usage messages
usage.ipban=&cUsage: &f/ipban &7[show list] &f| &f/ipban <ip1> [ip2] [ip3] ...
usage.unbanip=&cUsage: &f/unbanip <ip1> [ip2] [ip3] ...

🔒 Permissions

Permission	Description	Default
velocityipban.ban	Allows using /ipban command	op
velocityipban.unban	Allows using /unbanip command	op

🗃️ Database Schema

The plugin uses a simple SQLite database with the following structure:

CREATE TABLE banned_ips (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    ip_address TEXT NOT NULL UNIQUE,
    banned_by TEXT NOT NULL,
    banned_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

📊 How It Works

1. Connection Blocking: When a player tries to connect, the plugin checks their IP against the database during the PreLoginEvent
2. Multiple IP Management: Commands support space-separated IP addresses for bulk operations
3. Online Player Kicking: When an IP is banned, all online players with that IP are immediately disconnected
4. Validation: All IP addresses are validated before processing, with detailed error messages for invalid formats
5. Async Operations: All database operations are performed asynchronously to prevent server lag

🎯 Performance

• Lightweight: ~14MB JAR file with all dependencies included
• Fast: Async database operations prevent server blocking
• Efficient: Uses connection pooling with HikariCP
• Scalable: SQLite database handles thousands of banned IPs efficiently

Made with ❤️ by Yunexal Labs