McAntiVPN
McAntiVPN is a plugin that protects your server against players using a VPN.
It uses the Proxy & VPN detection API: IPHub.info.
⚠️ To use it, you must create an account on the website and get an API key.
- The free plan allows 1000 requests/day.
- The plugin avoids multiple requests on the same IP, so this limit should be enough.
🔗 Contribute
➡️ GitHub Repository: TwitmundDev/McAntiVPN
🐞 Report an Issue
➡️ Issues: Issues · TwitmundDev/McAntiVPN
⚠️ Important
Do not touch the savedIps.json file!
Any modification will delete your data.
I will not be responsible for any data loss.
⚙️ Configuration
The plugin has a config.yml file so you can customize it.
You can use the & character to add colors in your messages.
Available options:
- KickMessage: The message shown when a player is kicked for using a VPN.
- CommandPermission: Permission required to use the
/showiplistcommand. - PermissionNotify: Permission needed to receive a notification when a player tries to connect with a VPN.
- DontHavePermissionMessage: Message shown if a player does not have permission.
- PlayerWithVPNTriedToConnect: Notification message when a player with a VPN tries to connect.
- API_KEY: Your IPHub API key (get it from their website).
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.4
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — see the MC Java Mods guides for the full walkthrough.
Verified by MCModsHub
- Ships as mcAntiVPN-1.21.4.jar — drop this file into the mods folder
- Download size: 10 KB
- Download link checked 21 Aug 2026 — working
These come from our own check of the pack file, not from the source page.