VelocityShield 🛡️

A powerful VPN detection plugin for Velocity proxy servers that helps protect your network from unwanted VPN connections.

Features ✨

• Dual VPN Detection: Uses both proxycheck.io and ip-api.com for reliable VPN detection
• Smart Fallback System: Automatically switches between services if one fails
• Efficient Caching: Reduces API requests with configurable cache duration
• Whitelist System: Easily manage trusted IPs
• Detailed Logging: Track VPN detection events with timestamps
• Modern Text Formatting: Beautiful messages using Adventure's text components
• Permission System: Control access to commands and bypasses
• Configurable: Highly customizable through config.yml

Installation 📥

1. Download the latest release from the Releases page
2. Place the JAR file in your Velocity server's plugins directory
3. Start or restart your Velocity server
4. Configure the plugin in plugins/velocityshield/config.yml

Configuration ⚙️

# API Configuration
proxycheck-api-key: "YOUR_PROXYCHECK_API_KEY"

# VPN Detection Settings
use-proxycheck-as-primary: true
enable-fallback-service: true
allow-join-on-api-failure: true

# Cache Settings
enable-cache: true
cache-duration: 10
cache-time-unit: "SECONDS"  # Options: SECONDS, MINUTES, HOURS, DAYS

# Debug Settings
enable-debug: false

Commands 🎮

Command	Description	Permission
/velocityshield or /vshield	Reload the plugin configuration	velocityshield.reload
/vshieldwhitelist or /vshieldwl	Manage whitelisted IPs	velocityshield.whitelist

Whitelist Commands

• /vshieldwhitelist add <ip> - Add an IP to the whitelist
• /vshieldwhitelist remove <ip> - Remove an IP from the whitelist

Permissions 🔑

Permission	Description
velocityshield.reload	Allows reloading the plugin configuration
velocityshield.whitelist	Allows managing the IP whitelist
velocityshield.bypass	Allows bypassing VPN detection

API Integration 🤝

VelocityShield uses two VPN detection services:

1. proxycheck.io (Primary)

   • Requires API key
   • More accurate detection
   • Higher rate limits with API key

2. ip-api.com (Fallback)

   • Free to use
   • No API key required
   • Lower rate limits

Performance Optimization 🚀

• Caching: Reduces API requests by caching results
• Rate Limiting: Prevents API service overload
• Async Processing: Non-blocking VPN checks
• Efficient Cleanup: Automatic cache maintenance

Support 💬

• Create an issue for bug reports or feature requests
• Join our Discord server for community support

Credits

• Velocity - The proxy server
• proxycheck.io - Primary VPN detection service
• ip-api.com - Fallback VPN detection service
• Adventure - Text formatting library

---

Made with ❤️ by PandaDevv

This plugin uses bStats