miskaa's antiVPN

fixed it

miskaa's antivpn is a lightweight paper & velcoity plugin that helps your server fight against bad actors it's especially useful for small servers, like school servers without a whitelist or offline servers.

features

• vpn & proxy detection
• country whitelist/blacklist
• runtime commands
• customizable kick messages (supports minecraft color codes: &c, &a, etc.)

why use it?

running a public minecraft server can attract bots or "bad actors".
they can grief, crash, or just cause trouble. some may also use vpns or proxies to bypass bans

miskaa's antivpn helps by blocking vpn/proxy users and letting you manage allowed countries notes:

• the country filter can sometimes be unreliable, so it's recommended to keep it off unless needed
• if somebody tries going into another account 3 different times from the same ip, gets ip banned. basically: bad actor tries connecting to 3 different accounts from the same ip -> ip ban

commands

• /antivpn help → shows help
• /antivpn toggle → disable/enable plugin
• /antivpn togglecountryfilter → disable/enable the country filter
• /antivpn whitelistcountry <code> → whitelist a country
• /antivpn blacklistcountry <code> → blacklist a country
• /antivpn countrymessage <message> → set the kick message for blocked countries
• /antivpn vpnmessage <message> → set the kick message for vpn/proxy users
• /antivpn ipbanmessage <message> → set the kick message for ip bans
• /antivpn iplookup <ipaddr> → lookup a ip address

tip: all message commands support minecraft color codes (&c, &a, etc.)

setup

1. make sure your server is running on paper or velocity or whatever version is supported
2. put the plugin jar into the /plugins folder
3. start your server
4. (optional) edit /plugins/antivpn/config.yml to customize settings