1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

VPNGuard 1.0.5

VPNGuard will prevent players from joining your server behind any type of anonymizer.

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!

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. I have more than one server can I use the API key on more than one server at a time?
A. Yes you can use a single API key on as many servers as you wish, that you own.

Q. Why can't this be completely free for unlimited requests?
A. It costs money to maintain and upkeep such a service. You are not paying for the plugin but are paying for the service to use the API if you choose to do so.

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:

Q. Right after I installed the plugin it says "Monthly Limit Reached" but this is the first time im running it what do I do?
A. You most likely are on shared hosting and chances are someone already has used up the 500 Free Monthly Request Limit for the IP Address. You would need to either test the plugin locally on your computer, on a different server or purchase a API Key.

Q. I just installed the plugin I need help configuring command section in the config.
A. Configuring the plugin commands is super simple! Take a look at the config file: it is pretty straight forward, the command section is a list of commands to run when a user joins with a VPN. %p represents the player name connecting and gets replaced automatically.
- kick %p You seem to be using a VPN or Proxy
The above command to run would kick the player trying to connect with a VPN with the message "You seem to be using a VPN or Proxy". Or you could specify more than one command by adding another line like:

- kick %p You seem to be using a VPN or Proxy
- say %p is a naughty crafter.
Which would both kick the player trying to connect to the server and broadcast "playerName is a naughty crafter"

Q. I found a IP from a VPN organization not blocked what do I do?
A. Shoot me a PM and I will look into this for you.

Q. My question is not listed here
A. Shoot me a PM with your Question!