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 📥
- Download the latest release from the Releases page
- Place the JAR file in your Velocity server's
pluginsdirectory - Start or restart your Velocity server
- 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:
proxycheck.io (Primary)
- Requires API key
- More accurate detection
- Higher rate limits with API key
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
