ModsJava
VelocityShield
Java mod listed for Minecraft 1.7–1.21. Downloads from the MC Java Mods app on Android.
⬇ Download on ModrinthVelocityShield 🛡️
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
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7.2, 1.7.3, 1.7.4
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
File checked by MCModsHub
- Ships as VelocityShield.jar — drop this file into the mods folder
- Download size: 1.1 MB
- Download link checked 10 Nov 2026 — working
These come from our own check of the pack file, not from the source page.