Topaz - A simple FOSS Anti-VPN plugin for Velocity
Inspired by egg82's/Laarryy's Anti-VPN plugin.
Installation guide:
You need:
- Velocity 3.2.0+
- Java 17+
- Email address
- A custom plan from ProxyCheck.io (required only if you will be making more than 100/1000 requests a day)
- Download the plugin from the releases tab.
- Install the plugin on your Velocity proxy.
- Start the proxy.
- In the config file and enter your API key. (This step is not required but is really recommended!)
- Restart the proxy.
And you're good to go! :)
FAQ:
Q: Can I change the clear cache interval? A: Yeah! Just keep in mind that the interval there is in seconds, not minutes or hours. ;)
Q: My players are getting kicked with an error message! What do I do? A: Check your logs! It is possible that you just ran out of queries for today!
Q: What are the permissions that Topaz checks for?
A: topaz.bypass for bypassing the IP proxy check.
Q: What permission plugin do you recommend? A: LuckPerms never failed me. :)
Support is offered on my Discord server.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7.2, 1.7.3, 1.7.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 — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as Topaz-2.2-SNAPSHOT.jar — drop this file into the mods folder
- Download size: 9 KB
- Download link checked 1 Sept 2026 — working
These come from our own check of the pack file, not from the source page.