
FabricSQLWhitelister
This is a mod intended to override the whitelist.json by instead using a MySQL database.
How to use
You will need:
- Fabric API
- The latest version of FabricSQLWhitelister
- Fabric Loader version
>=0.12.8(I may backport in the future when I have time to add LTS for 1.16.5 & 1.17.1) - Minecraft 1.18.*
Instructions
- Boot the server up with the mod installed. This may result in a crash, but that is expected.
- Navigate to the
whitelist.tomlthat was generated, and add in your MySQL database logins. - In
server.properties, setwhite-list=to true. - You should be good to go! Reboot your server, and if all is well it'll start successfully.
- Add and remove players via the
/whitelist add <player>and/whitelist remove <player>commands.
Notes
- At present, this overrides the ability for opped players to bypass the whitelist, although I may change this in a future patch.
- I have only tested this with a MariaDB server, but should hopefully work on any other conventional MySQL server.
- If you would like to write your own application to work in conjuction with this mod, it should be known that UUIDs are stored dehyphenated. This is because Mojang's REST api doesn't store the hyphenated player UUIDs, which make it hard to develop other apps to allow integration.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.18, 1.18.1-pre1, 1.18.1-rc1
- 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 fabric-sql-whitelister-1.0.jar — drop this file into the mods folder
- Download size: 2.7 MB
- Download link checked 8 Sept 2026 — working
These come from our own check of the pack file, not from the source page.