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


    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.
    DeadMaster, NavyDev, Tyrelis and 11 others like this.

Recent Updates

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

Recent Reviews

  1. ExeoAge
    Version: 3.1
    does not work for me it will kick them then they can rejoin with a vpn or proxy please fix this
  2. BrunoAvixdubSB
    Version: 3.1
    No recommended the plugin need pay API for work plugin .
    1. bash
      Author's Response
      Again this was listed in the FAQ section above.

      Had you read the plugin description before downloading and using the plugin you would've known this. And you could had saved your and my time writing/replying to this review.

      The best things in life aren't free. If you quickly used up the provided 500 API requests /month perhaps stop being cheap and buy an API Key?
  3. MelaniumAS
    Version: 3.1
    No es tan recomendable , hasta las 50 normal .. luego ya no sirve
    No lo recomiendo
    1. bash
      Author's Response
      I'm going to assume by 50 you meant 500 in which case yes, the backend API this plugin uses has a 500 monthly request limit, you need to purchase the API service to get more.

      This was listed in the FAQ section above.

      I'm sorry if your not able to comprehend that this is not a plugin limitation rather a API one.
  4. Tyrelis
    Version: 3.1
    This is a good Anti-VPN. I bought the 10 dollar api and it was well worth it. I no longer have to worry about players trying to avoid bans. Keep up the good work!
    1. bash
      Author's Response
      Thank you :)
  5. oneaddictions
    Version: 3.1
    Good Anti-VPN, I changed my review because there is 1.7 support thanks for epic plugin!
    1. bash
      Author's Response
      Thank you :)
  6. HypeeDraggy
    Version: 3.1
    Incredible! Beautiful, i've been searching this for a long time!

    Thank you, do you accept donations?

    For future GOODS!
    1. bash
      Author's Response
      Thank you ;)
  7. JorgeProGames
    Version: 3.1
    The best VPN blocker plugin out there, works prefect and if your server is not big, you dont need to purchase an API, thanks for making awesome plugins! :)
    1. bash
      Author's Response
      Thank you ;)
  8. armyman25
    Version: 3.1
    This plugin limits you to 500 unique players, making it not as useful as other plugins. The real reason I am giving this plugin a 1 star, however, is that the plugin is impossible to uninstall. The plugin will continue to regenerate itself over and over. Good luck trying to get rid of it. I'm not sure how this isn't in violation of Spirit's ToS, but I'll be sure to report this plugin to Spigot if this issue isn't addressed immediately.
    1. bash
      Author's Response
      I'm sad to say your review is completely false, the plugin does not "regenerate itself". I'm not even sure how that would be possible. Simply stop server. remove the Jar file and start your server again.

      On top of that I welcome individuals to decompile my plugin to audit the source code as I have no malicious intent.

      Had you contacted me before forming conclusions on your own I could had helped you perform a very basic task on how to remove Spigot Plugins, which everyone except you seems to know how to do.

      I do not appreciate the vilification your spreading regarding me in this public manner.
  9. Voqz
    Version: 3.1
    Going to try this plugin out tonight in replace for a poorly coded VPN / Proxy blocker, Ill update my review if its bad, If not.... Fantastic Plugin :)
    - Voqz
    1. bash
      Author's Response
      Thank you ;)
  10. Bradh233
    Version: 3.1
    Not sure how to actually "allow" a specific IP thats being blocked by the premium VPN guard thing we pay for.
    1. bash
      Author's Response
      Thank's for the review :) You use /vpnguard whitelist to whitelist the org name. Or you can simply whitelist the user with the bypass permission node.