Dead simple player allowlist for Minecraft Velocity proxy.
velocity-allowlist adds no commands to interface with it.
All attempts on joining the proxy are blocked, unless the players UUID is in a text file named allowlist.txt.
Download a release from GitHub, Modrinth or build the plugin from source.
Put the .jar into the plugins/ directory of the proxy.
The file allowlist.txt is read every 10 seconds. So simply drop the UUIDs of friends and family in there.
You can write comments starting the line with # or //.
Player names can't be used. The plugin will accept UUIDs only.
# valid comment
<valid UUID>
// another valid comment
<valid UUID>
You can compile the plugin yourself using the following commands under Linux.
git clone https://github.com/self-crafted/velocity-allowlist.git
cd velocity-allowlist
./gradlew buildThe plugin jar will be located at build/libs/velocity-allowlist-<VERSION>.jar.
Note that for compiling you should use JDK 21, the minimum version for Velocity build 600 (latest at 30th May 2026).
If you've got suggestions, feel free to open an issue.
PRs accepted.
Small note: If editing the README, please conform to the standard-readme specification.
This project is licensed under the MIT license.
