<\/p>\n
# KauriVPN
\nThe most accurate and lightweight AntiVPN plugin<\/p>\n
*If you’re enjoying the service, please leave a review!*<\/p>\n
*Join our Discord for support!*<\/p>\n
## Web Based Proxy Lookup: isitbad.io
\n<\/center><\/p>\n
—<\/p>\n
## Description
\nThis AntiVPN plugin isn’t like other AntiVPN plugins, which use external databases and services not made by the developer themselves. We use our own in-house API to keep things fast and well integrated. And, it’s **compatible with Velocity, BungeeCord, and Spigot** in the same JAR!<\/p>\n
## Why KauriVPN?
\nWe don’t use any external APIs on our backend, just our homemade special sauce for detecting VPNs, Proxies, and TOR. Not only do we have a **high accuracy** and detection rate, but we also process your queries **fast** in under 2ms! Our API updates its IP tables every 10 minutes, so you don\u2019t have to worry about outdated information allowing bad actors on your server or blocking legitimate connections.<\/p>\n
We have multiple regions for our API, allowing for extremely low network latency for most locations!<\/p>\n
You can test our API with your own VPN here!<\/p>\n
—<\/p>\n
## Plugin Features!
\n– Optional use of MySQL databases to cache query results.
\n– Exemption of individual uuids\/players from VPN checking.
\n– Block players based on prefix so you can exempt Bedrock players.
\n– Ingame player IP lookups, with very extensive detail.
\n– Get alerts when players join on VPNs!<\/p>\n
\n
\n—<\/p>\n
## Plugin Information *(IMPORTANT TO READ)*<\/p>\n
### Compatibility
\n– **BungeeCord Versions**: b1100 and newer have been tested to work
\n– **Bukkit\/Spigot Versions**: 1.7.10 and newer have been tested to work
\n– **Velocity Versions**: 3.0.1 and newer have been tested to work<\/p>\n
### TCPShield
\nIf you are going to be using TCPShield, please ensure you are using their provided “RealIP” plugin. Without this plugin, KauriVPN will see players joining from TCPShield proxies. This means players will always be seen as on a VPN, even if they are not using one.<\/p>\n
### GeyserMC Users
\nBe wary of how you configure GeyserMC for your server. Some configurations of KauriVPN and GeyserMC will result in all Bedrock players being detected as using a proxy. If this is the case for you, please set your player names to use a prefix and configure the `prefixWhitelist` section of KauriVPN with your prefix to prevent detection.<\/p>\n
### Commands ### Other Permissions ### Generated Files<\/p>\n “`yaml ## Dependencies —<\/p>\n ## Free AntiVPN? The most accurate and lightweight AntiVPN. Stop cheaters and malicious players in their tracks!<\/p>\n","protected":false},"featured_media":89758,"template":"","meta":{"_minecraft_slug":"kauri-antivpn","_minecraft_project_id":"5UF9tf3G","_minecraft_author":"funkemunky","_minecraft_license":"Apache-2.0","_minecraft_downloads":1719,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"kauri-antivpn.zip","_minecraft_size_bytes":54658108,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T06:52:26.972879Z","_minecraft_date_created":"2025-02-13T06:56:52.724533Z","_minecraft_date_modified":"2026-05-03T18:56:28.709057Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/kauri-antivpn","_minecraft_icon_attachment_id":89758,"_minecraft_imported_at":"2026-06-05T03:02:07+00:00","_minecraft_import_hash":"30e4e397db40ef140a61720066e76db7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,126,127,128,129,1005,123,92,985,992],"mod_loader":[130,895,131,132,133,134,1006,986,993],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,180,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-89757","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-sponge","mod_category-technology","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-sponge","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/antivpn` – View all commands you can use. – `antivpn.command`
\n– `\/antivpn lookup
\n– `\/antivpn alerts` – Toggle your VPN usage alerts – `antivpn.command.alerts`
\n– `\/antivpn allowlist
\n– `\/antivpn clearcache` – Clear the API response cache if problems occur
\n– `\/antivpn plan` – View your KauriVPN Plan and Queries Info
\n– `\/antivpn reload` – Reload the KauriVPN plugin<\/p>\n
\n– `antivpn.bypass`: Allow a player to bypass the checking\/kicking for proxies.<\/p>\n**config.yml**<\/summary>\n
\n#####################################################
\n# KauriVPN Config #
\n# by Brighten Development #
\n#####################################################
\n# If you find that you run out of your free 20,000 queries, you may purchase a license on https:\/\/funkemunky.cc\/shop
\nlicense: ”
\n# Message only sent with commands disabled below. Supports color codes (‘&’)
\nkickMessage: Proxies are not allowed on our server
\n# Caching results will lower your query usage, but results may be out of date.
\ncachedResults: true
\n# All players with any of the following characters in the beginning of their name will be whitelisted
\n# This is a useful feature for servers that allow players through Geyser and their IPs are not forwarded, causing
\n# players to be removed falsely for use of proxy.
\nprefixWhitelists: []
\n# Configure your database here.
\ndatabase:
\n # Enable to cache queries and save alerts state beyond restarts
\n enabled: false
\n useCredentials: true
\n #Options Mongo and MySQL
\n type: MySQL
\n # The database name you would like to use
\n database: kaurivpn
\n # Can be used if you prefer to authenticate via Mongo URL
\n mongoURL: ”
\n # Your database username
\n username: root
\n # Your database password
\n password: password
\n # The IP of your database goes here
\n ip: localhost
\n # -1 will use default port of databases (MySQL:3306, Mongo:27017). Otherwise, enter alternative ports here.
\n port: -1
\ncommands:
\n # Enable this to override the default kick function of the plugin with your own commands
\n enabled: false
\n # List of commands to run when a player is detected to be using a proxy. Supports color codes (‘&’)
\n execute:
\n – kick %player% VPNs are not allowed on our server!
\n# Enable\/disable the default kicking feature of KauriVPN.
\nkickPlayers: true
\n# Configure all alerting functionality
\nalerts:
\n # You may set to ‘false’ to disable all alerts functionality
\n enabled: true
\n # Message to send to users with alerts enabled
\n # Placeholders: %country% (Country name), %player% (Player name), %reason% (Proxy detection method),
\n # %city% (City name).
\n message: ‘&8[&6KauriVPN&8] &e%player% &7has joined on a VPN\/proxy &8(&f%reason%&8)
\n &7in location &8(&f%city%&7, &f%country%&8)’
\n# Configuration for country gatekeepings
\ncountries:
\n # You must use ISO codes for country configuration: https:\/\/www.iban.com\/country-code
\n # Leave empty to disable this configuration
\n list: []
\n # Set whitelist to true to only allow listed country codes, and false to deny listed country codes.
\n whitelist: true
\n # The commands to be run if the player is not allowed on the server with the above configured conditions
\n # Placeholders: %country% (Country name), %player% (Player name), %code% (Country ISO Code)
\n # Keep this empty with “[]” if you want to use the built-in kicking system.
\n commands: []
\n # The kick message that will be used if commands are configured to use the built-in kicking sytem.
\n # PlaceHolders: %country% (Country name), %player% (Player name), %code% (Country ISO Code)
\n vanillaKickReason: “&cSorry, but our server does not allow connections fromn&f%country%”
\n# This will disable any information being sent to https:\/\/bstats.org. We recommend you keep this enabled as it helps
\n# us understand our users and put effort where it is needed. All information sent goes under their privacy as seen
\n# here: https:\/\/bstats.org\/privacy-policy
\nbstats: true
\n“`<\/p>\n<\/details>\n
\nNone \ud83d\ude42<\/p>\n
\nYes, it’s free! You don’t even have to pay for an external API. Our service offers a generous 20,000 queries per month for free. If you are a server with less than 80 players concurrently, you are highly unlikely to reach this cap and won’t need to upgrade. If you start reaching the cap, you can upgrade your plan on https:\/\/funkemunky.cc\/shop and insert your license into the `config.yml`.<\/p>\n","protected":false},"excerpt":{"rendered":"