VelocityShield

VelocityShield 🛡️

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

License

Java

Velocity

Features ✨

- Configurable: Uses both proxycheck.io and ip-api.com for reliable VPN detection - Configurable: Automatically switches between services if one fails - Configurable: Reduces API requests with configurable cache duration - Configurable: Easily manage trusted IPs - Configurable: Track VPN detection events with timestamps - Configurable: Beautiful messages using Adventure's text components - Configurable: 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 ⚙️

```yaml

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 🚀

- Efficient Cleanup: Reduces API requests by caching results - Efficient Cleanup: Prevents API service overload - Efficient Cleanup: 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*