Anti-VPN

# Anti-VPN **A SqidgeonStudios Plugin** > Block VPN, proxy, and datacenter connections from your Minecraft server. (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/available/modrinth_vector.svg)](https://modrinth.com/plugin/anti-vpn) (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/available/curseforge_vector.svg)](https://www.curseforge.com/minecraft/bukkit-plugins/anti-vpn/) --- ## Platforms (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/supported/paper_vector.svg)](https://modrinth.com/plugin/anft-vpn/version/1.0.0B) (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/supported/bukkit_vector.svg)](https://modrinth.com/plugin/anti-vpn/version/1.0.0B) (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/supported/spigot_vector.svg)](https://modrinth.com/plugin/anti-vpn/version/1.0.0B) (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/supported/purpur_vector.svg)](https://modrinth.com/plugin/anti-vpn/version/1.0.0B) (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/supported/velocity_vector.svg)](https://modrinth.com/plugin/anti-vpn/version/1.0.0V) --- ## Support (https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/compact/social/discord-plural_vector.svg)](https://discord.gg/J2RRQcjHsM) --- ## Features - **Key-free detection** — powered entirely by free, open-source IP blocklists - **SQLite & MySQL support** — built-in local database or connect to your own external server - **Four combined blocklists** — covering attacks, anonymizers, commercial VPNs, and datacenters - **Auto-updating lists** — downloads fresh data from GitHub on startup and on a configurable schedule - **Local list caching** — all lists saved to disk with dated backups, works offline after first download - **Zero login lag** — CIDR matching runs entirely in-memory, microsecond-fast per connection - **LuckPerms integration** — full permission node support with per-group and per-player bypass - **Fully customisable messages** — every player-facing string lives in `messages.yml` - **In-game management** — add, remove, and inspect IPs and players without touching any files --- # Images ### With a VPN !(https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/anti-vpn/image2.png) !(https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/anti-vpn/image1.png) ### Without a VPN !(https://raw.githubusercontent.com/sqidgeon/cdn1/refs/heads/main/anti-vpn/image3.png) --- ## How Detection Works AntiVPN combines **four free blocklists** into a single in-memory CIDR matcher that checks every connecting IP in milliseconds: | List | Source | Covers | |---|---|---| | `firehol_level1.netset` | (https://github.com/firehol/blocklist-ipsets) | Attacks, malware, bogon ranges | | `firehol_anonymous.netset` | (https://github.com/firehol/blocklist-ipsets) | Tor, open proxies, anonymizers | | `x4bnet_vpn.netset` | (https://github.com/X4BNet/lists_vpn) | ProtonVPN, Mullvad, NordVPN, ExpressVPN & more | | `x4bnet_datacenter.netset` | (https://github.com/X4BNet/lists_vpn) | AWS, OVH, Hetzner, DigitalOcean & more | All lists are downloaded to `plugins/AntiVPN/firehol/` on first start and automatically refreshed. Dated backup copies are kept every time a new download succeeds. An optional **reverse-DNS heuristic** further checks PTR records against known VPN/hosting hostname patterns as a secondary layer. --- ## Database AntiVPN stores blocked IPs, allowed IPs, and bypass players in a real database. **SQLite** (default — zero setup): ```yaml database: type: sqlite ``` Creates `plugins/AntiVPN/antivpn.db` automatically on first start. **MySQL / MariaDB** (external server): ```yaml database: type: mysql mysql: host: your.db.host port: 3306 database: antivpn username: antivpn_user password: "yourpassword" ``` --- ## LuckPerms Permissions AntiVPN integrates with LuckPerms out of the box. If LuckPerms isn't installed it falls back to Bukkit permissions automatically. | Permission | Default | Description | |---|---|---| | `antivpn.admin` | OP | All permissions including bypass | | `antivpn.bypass` | `false` | **Skip all VPN checks at login** | | `antivpn.allow` | OP | Use `/ipallow` | | `antivpn.block` | OP | Use `/ipblock` | | `antivpn.list` | OP | Use `/iplist` | | `antivpn.user` | OP | Use `/ipuser` | | `antivpn.update` | OP | Use `/ipupdate` | Grant bypass to a group via LuckPerms: ``` /lp group vip permission set antivpn.bypass true ``` --- ## Commands ### `/ipblock` — Manage the IP block-list | Subcommand | Description | |---|---| | `/ipblock add <ip>` | Block an IP address | | `/ipblock re