🌐 Anti VPN

#Anti VPN

Anti VPN looks up the address of every player that connects and denies the ones that come from a vpn, a proxy or a datacenter. The lookup happens before the player is fully connected, so a denied player never reaches the world. Open it from Editor > Modules > Anti VPN.

Local and private addresses are never looked up, which is what a test server on the same machine needs.

#Api Url

With this option, you can change the service the addresses are checked against. It has to contain %ip%, which is replaced with the address that is connecting, and it has to answer with the same proxy and hosting fields the default service does. The editor refuses a url without the placeholder.

#Block Proxies

With this option, you can choose whether addresses the service flags as a vpn or a proxy are denied.

#Block Hosting

With this option, you can choose whether addresses owned by a datacenter or a hosting provider are denied. It is off by default, since some mobile carriers and school networks answer from ranges that are flagged this way.

#Kick On Lookup Failure

With this option, you can choose what happens when the service cannot be reached, answers with an error, or takes longer than the timeout. Off lets the player in, on denies them. The failure is written to the console either way.

#Cache Minutes

With this option, you can change how long a result is kept before the same address is looked up again. A higher value spares the service on a busy lobby, at the cost of reacting later when an address changes owner.

#Timeout Millis

With this option, you can change how long to wait for the service before giving up. A player whose address is not cached yet waits for this before being let in, so a high value slows the join down when the service is having a bad day.

#Whitelisted Addresses

With this option, you can list the addresses that are never checked. Entries have to be the full address, ranges are not matched.

#Notify Admins

With this option, you can choose whether administrators with phoenixlobby.alert.antivpn are told, with the name and the address, when someone is denied.

#Feature State

With this option, you can turn Anti VPN off completely without clearing the rest of the settings.

enabled: true
api-url: http://ip-api.com/json/%ip%?fields=status,message,proxy,hosting
block-proxies: true
block-hosting: false
kick-on-lookup-failure: false
cache-minutes: 60
timeout-millis: 3000
notify-admins: true
whitelisted-addresses: []