# VelocityShield \ud83d\udee1\ufe0f<\/p>\n
A powerful VPN detection plugin for Velocity proxy servers that helps protect your network from unwanted VPN connections.<\/p>\n
\n
\n<\/p>\n
## Features \u2728<\/p>\n
– **Dual VPN Detection**: Uses both proxycheck.io and ip-api.com for reliable VPN detection
\n– **Smart Fallback System**: Automatically switches between services if one fails
\n– **Efficient Caching**: Reduces API requests with configurable cache duration
\n– **Whitelist System**: Easily manage trusted IPs
\n– **Detailed Logging**: Track VPN detection events with timestamps
\n– **Modern Text Formatting**: Beautiful messages using Adventure’s text components
\n– **Permission System**: Control access to commands and bypasses
\n– **Configurable**: Highly customizable through config.yml<\/p>\n
## Installation \ud83d\udce5<\/p>\n
1. Download the latest release from the Releases page
\n2. Place the JAR file in your Velocity server’s `plugins` directory
\n3. Start or restart your Velocity server
\n4. Configure the plugin in `plugins\/velocityshield\/config.yml`<\/p>\n
## Configuration \u2699\ufe0f<\/p>\n
“`yaml
\n# API Configuration
\nproxycheck-api-key: “YOUR_PROXYCHECK_API_KEY”<\/p>\n
# VPN Detection Settings
\nuse-proxycheck-as-primary: true
\nenable-fallback-service: true
\nallow-join-on-api-failure: true<\/p>\n
# Cache Settings
\nenable-cache: true
\ncache-duration: 10
\ncache-time-unit: “SECONDS” # Options: SECONDS, MINUTES, HOURS, DAYS<\/p>\n
# Debug Settings
\nenable-debug: false
\n“`<\/p>\n
## Commands \ud83c\udfae<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/velocityshield` or `\/vshield` | Reload the plugin configuration | `velocityshield.reload` |
\n| `\/vshieldwhitelist` or `\/vshieldwl` | Manage whitelisted IPs | `velocityshield.whitelist` |<\/p>\n
### Whitelist Commands ## Permissions \ud83d\udd11<\/p>\n | Permission | Description | ## API Integration \ud83e\udd1d<\/p>\n VelocityShield uses two VPN detection services:<\/p>\n 1. **proxycheck.io** (Primary) 2. **ip-api.com** (Fallback) ## Performance Optimization \ud83d\ude80<\/p>\n – **Caching**: Reduces API requests by caching results ## Support \ud83d\udcac<\/p>\n – Create an issue for bug reports or feature requests ## Credits<\/p>\n – Velocity – The proxy server —<\/p>\n Made with \u2764\ufe0f by PandaDevv <\/p>\n *This plugin uses bStats*<\/p>\n","protected":false},"excerpt":{"rendered":" Protect your Velocity proxy server from VPN users with advanced detection and caching<\/p>\n","protected":false},"featured_media":165624,"template":"","meta":{"_minecraft_slug":"velocityshield","_minecraft_project_id":"9gh3pg74","_minecraft_author":"jackh54","_minecraft_license":"MIT","_minecraft_downloads":80,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocityshield.zip","_minecraft_size_bytes":2079290,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:11:40.962714Z","_minecraft_date_created":"2025-06-17T07:27:28.003684Z","_minecraft_date_modified":"2026-02-15T07:40:28.587878Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocityshield","_minecraft_icon_attachment_id":165624,"_minecraft_imported_at":"2026-06-09T17:55:10+00:00","_minecraft_import_hash":"de8d545c1e12ddf3009b27bb5bb0fee9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,122,126,90,123,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-165623","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-optimization","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n– `\/vshieldwhitelist add
\n– `\/vshieldwhitelist remove
\n|————|————-|
\n| `velocityshield.reload` | Allows reloading the plugin configuration |
\n| `velocityshield.whitelist` | Allows managing the IP whitelist |
\n| `velocityshield.bypass` | Allows bypassing VPN detection |<\/p>\n
\n – Requires API key
\n – More accurate detection
\n – Higher rate limits with API key<\/p>\n
\n – Free to use
\n – No API key required
\n – Lower rate limits<\/p>\n
\n– **Rate Limiting**: Prevents API service overload
\n– **Async Processing**: Non-blocking VPN checks
\n– **Efficient Cleanup**: Automatic cache maintenance<\/p>\n
\n– Join our Discord server for community support<\/p>\n
\n– proxycheck.io – Primary VPN detection service
\n– ip-api.com – Fallback VPN detection service
\n– Adventure – Text formatting library<\/p>\n