VPNGuard 3.1

Prevents users from joining your Bukkit/Spigot server behind any type of anonymizer

  1. bash
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16


    VPNGuard will prevent players from joining your server behind any type of anonymizer (whether it be a VPN or a Proxy). This will effectively help reduce spammers/bots and Miscellaneous individuals from joining your server by kicking them if they have an IP address which belongs to a hosting organization.

    VPNGuard uses a privately managed blocking list which is updated almost daily to Combat new threats.

    I also coded a lightweight BungeeCord Version: https://www.spigotmc.org/resources/vpnguardbungee.31915/


    /vpnguard notify (Enable or Disable in-game notifications when a player tries to join with a VPN)
    /vpnguard report (Generates a report with the list of players who have attempted to join your server with a VPN)
    /vpnguard clearcache (Deletes all locally saved cache files)
    /vpnguard clearip <ip> (Deletes the locally saved cache file for the specified IP address)
    /vpnguard country (Allows you toggle between blacklist or whitelist, add, remove, view or clear a country to your country list)
    /vpnguard subnet (Allows you subnet ban or unban a IP address range)
    /vpnguard whitelist (Allows you to add, remove view or clear a ISP/Organization to your global whitelist)
    /vpnguard lookup <player or ip> (Allows you to search any IP address or Online Player in-game to view details)
    /vpnguard about (Information about the plugin)


    vpnguard.permission.bypass (Allows user or user group with this permission to bypass all checks)
    vpnguard.command.vpnguard (Allows you to use /vpnguard) (Default:True)
    vpnguard.command.notify (Allows you to use /vpnguard notify) (Default:OP)
    vpnguard.command.report (Allows you to use /vpnguard report)
    vpnguard.command.clearcache (Allows you to use /vpnguard clearcache) (Default:OP)
    vpnguard.command.clearip (Allows you to use /vpnguard clearip) (Default:OP)
    vpnguard.command.country (Allows you to use /vpnguard country) (Default:OP)
    vpnguard.command.subnet (Allows you to use /vpnguard subnet) (Default:OP)
    vpnguard.command.whitelist (Allows you to use /vpnguard whitelist (Default:OP)
    vpnguard.command.lookup (Allows you to use /vpnguard lookup) (Default:OP)
    vpnguard.command.about (Allows you to use /vpnguard about) (Default:True)


    View Example config.yml by clicking here.
    • Variables for "commands" section
      • %p to represent the player connecting
      • %ip to grab the connecting player's IP Address
    • Variables for "country-deny-message"
      • %p to represent the player connecting
      • %countryname to get the connecting players country name

    Report Generation

    The following is a preview of a report generated by VPNGuard using the command /vpnguard report this feature is present in VPNGuard v3.0 and above.


    Frequently Asked Questions

    Q. How many players can the plugin look information up for?

    A. At the time of writing this the backend API provider has a 500 monthly request limit. Which means if you enable api-cache within config.yml you can get 500 monthly unique players and lookup information regarding them with no problem! Just to clarify once more, the plugin is free, however the API Backend this plugin uses is not. I do not manage the API service, so please don't penalize the plugin for you not being able to use it for free.

    Q. What happens when the API monthly limit is reached?
    A. The API server will no longer provide information regarding additional/new users who attempt to join your server, from there those users would be either allowed to join your server without any sort of checking or they would be kicked, this is based on the value specified in the config.yml under bypass-check.

    Q. I have a server and more than 500 new users join per month is it possible I can get more monthly requests?
    A. Yes you can you would need to purchase an API key, at the time of writing this its only $5/mo

    Q. Where can I view details/purchase the API that is being used?
    A. You can visit the homepage by the API provider located at: https://vpnblocker.net

    Terms of Use

    Please do not redistribute or reupload this plugin, I work hard on it and provide updates and all I ask is for credit in return. Just link whoever is interested in downloading my plugin to this resource post.

    You may only decompile this plugin to audit the source code, you may not decompile this plugin for purposes of redistribution/reselling or copying source code.

    Please don't leave errors or questions on the review section as conversations are not possible (limit of one reply), rather reply to the forums post!

    If you don't understand what this plugin is for PLEASE don't give it a bad rating :( If you need help post in the forums! Please read the FAQ above before downloading and leaving a review for the plugin. I will gladly consider any suggestions and feedback to my plugin.

Recent Updates

  1. VPNGuard 3.1
  2. VPNGuard 3.0
  3. VPNGuard 2.9

Recent Reviews

  1. zDaniel__
    Version: 3.1
    EASY BYPASS: Connect with a VPN to a whitelisted country.
    So if someone does not log in from the whitelisted country (for example Africa) without a VPN, they cannot access the server.
    1. bash
      Author's Response
      Even if you have country whitelist enabled, connecting with a VPN from a whitelisted country should not work either.
  2. Bunny_Magic
    Version: 3.1
    This plugin does not work. People can still join on VPN. Even if I banned them they can still join on VPN.
    1. bash
      Author's Response
      If a VPN is not detected you need to contact the API provider and they can look into this for you.
  3. Spegot
    Version: 3.1
    One question: does this plugin protect from NordVPN? No other plugin I have found has been able to do this task; I'm wondering if VPNGuard can.
    1. bash
      Author's Response
      Thank you :) And yes it should
  4. virgili0
    Version: 3.1
    Nice. Keep up the good work .
    1. bash
      Author's Response
      Thank you :)
  5. instaafterfx
    Version: 3.1
    Great plugin, does what it says. Needs an urgent update to 1.14.4 though. Other than that, nice job,
    1. bash
      Author's Response
      Thank you :) Please try it on 1.14.4 and let us know if it works.
  6. AustinFRG
    Version: 3.1
    Great plugin, I would love it even more if you could update it to 1.14.4! :)

    It does exactly what it says it does, there are a few VPNs that it doesn't detect, but almost all of them are blocked. I love it! As I said, it would be great if it wasn't 1.7-1.12, and instead, it was 1.7-1.14, but it's an awesome plugin other than that!
    1. bash
      Author's Response
      Thank you :)
  7. KeplerLabs
    Version: 3.1
    Works great on 1.12.2, blocked VPN users every time and i can allow trusted players who uses VPN to play on my server with the whitelist permission.

    Free plan is just fine for now and will upgrade when i'll need to.
    1. bash
      Author's Response
      Thank you :)
  8. A248
    Version: 3.1
    VPNGuard is an excellent plugin, still working and functional. Its configuration options allow for smooth customization without being bloated with unnecessary features.

    Some other reviews complained about the API provider; however, that's not in any way the responsibility of VPNGuard or bash, the author of the plugin. If you are running out of requests on the free package, turn up your api-cache-time in the config.yml OR just get an API key for $5/mo for unlimited requests.
    1. bash
      Author's Response
      Thank you :)
  9. Irishcheetah
    Version: 3.1
    BUYERS BEWARE! The plugin itself is handy and does a good job when it works correctly with the $5 option. If you have a decent size server, i wouldn't suggest this plugin. Once you go over the check limit it will shut down your server. Highly annoying and wrong, give me an error in console or chat or something don't shut down the server...

    For some months now the paid version doesn't work. Either the guy or girl died or doesn't care to fix it. My code doesn't auto update, saying it expired even though i bought the $5 package again. Did it twice and failed to update. I emailed the person whoever runs it, but no reply or fix.

    Was a 4.5/5 star plugin but it's not that anymore. Don't waste your money!
    1. bash
      Author's Response
      There is no check limit if you have a API key. If you dont provide an API key and use up provided 500 requests , it shuts down the server otherwise the API provider would blacklist your servers IP address.

      If your having issues with the API service itself you need to contact the API provider .
  10. Darkweasam
    Version: 3.1
    A well made plugin! You have to pay 5$ to get unlimited protections which for many big servers are almost FREE. This amount of money is really worth it if you want your server to have full protection against VPN users.
    Dev, dont worry about the kids who cry for paying 5$ for a gem like this, there is always those people who doesnt want to spend a penny on anything.
    1. bash
      Author's Response
      Thank you :)