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*