ROF_AntiVPN

ROF_AntiVPN is a configurable anti-VPN plugin designed to help Minecraft server owners detect and block suspicious connections. It supports Paper/Spigot, BungeeCord, and Velocity, with configurable detection rules, API fallback, IP caching, whitelists, customizable punishments, detailed logging, and Discord webhook notifications.
Whether you're running a single Minecraft server or a multi-server network, ROF_AntiVPN gives you control over how suspicious connections are handled.

✨ Features

• VPN, Proxy & Tor Detection — Check player IP addresses for VPN, proxy, and Tor usage.
  
  
• Multiple API Providers — Use ProxyCheck.io as the primary provider and IPQuery as a fallback.
  
  
• API Failure Handling — Choose whether players are allowed or denied when IP checks fail.
  
  
• IP Caching — Cache previous results to reduce repeated API requests and improve efficiency.
  
  
• Risk-Based Detection — Configure the risk threshold used to determine whether a connection should be blocked.
  
  
• IP Whitelist — Allow trusted IP addresses to bypass detection.
  
  
• Country Whitelist — Exempt connections from selected countries.
  
  
• Custom Punishments — Kick suspicious players or execute a configurable console command.
  
  
• Discord Webhooks — Send notifications to Discord when configured events occur.
  
  
• Detailed Logging — Log activity to the console, player-facing messages where applicable, and daily log files.
  
  
• Customizable Messages — Edit the messages shown by the plugin.
  
  
• Multi-Platform Support — Support for Paper/Spigot, BungeeCord, and Velocity deployments.

️ Supported Platforms
Platform Support
Paper / Spigot Supported
BungeeCord Supported
Velocity Supported
Check the release notes for the exact Minecraft and proxy versions tested with your chosen build.

Installation

1. Download the appropriate ROF_AntiVPN release for your platform.
   
   
2. Install it on your Paper/Spigot server or supported proxy.
   
   
3. Start the server once to generate the configuration files.
   
   
4. Open plugins/ROF_AntiVPN/config.yml if that is the configuration path used by your build.
   
   
5. Configure your API provider, detection settings, whitelists, messages, and punishment options.
   
   
6. Restart the server or proxy to apply the configuration.

Tip: For proxy networks, configure the plugin on the appropriate proxy when you want it to check players' actual connecting IP addresses. Make sure your network's IP forwarding and proxy configuration are set up correctly.

⚙️ API Configuration
ROF_AntiVPN supports multiple IP-checking providers:

• ProxyCheck.io — Primary provider; an API key can be configured to access the service's applicable limits and features.
  
  
• IPQuery — Fallback provider that can be used without an API key.

You can configure the fallback behavior when providers fail. For example, api-fail-action can be set to allow or deny, depending on how strict you want your server to be.

Provider availability, quotas, and detection accuracy depend on the external services you use.

️ Commands
Command Description
/rofvpn Main plugin command
/vpn Alias for /rofvpn
Permissions
Permission Description
rofvpn.admin Administrative access
rofvpn.check Permission for supported checking commands
rofvpn.bypass Bypass anti-VPN checks
rofvpn.alert Receive anti-VPN alerts
Privacy Notice
ROF_AntiVPN may send player IP addresses to configured third-party IP-checking providers to evaluate VPN, proxy, or Tor usage. Review the privacy policies and terms of those services, and inform your players as appropriate for your server.

Links

• Source Code: https://github.com/RageOfFire/ROF_AntiVPN
  
  
• Report Bugs / Request Features: https://github.com/RageOfFire/ROF_AntiVPN/issues

❤️ Support Development
If ROF_AntiVPN helps protect your server, consider leaving a review, reporting bugs, and sharing suggestions for future improvements.

Thank you for using ROF_AntiVPN!