Skip to content

whitelisted

A mod that connects to an auth server to determine whether or not to allow a given player to connect.

Fabric
Loaders
Fabric
Downloads on Modrinth
137
Followers on Modrinth
2
versions
5
Updated
August 2, 2026Aug 2
Published
in 2025

At a glance

Runs on Fabric
For Minecraft 1.21.8–1.21.9, 26.1–26.2
Server only — players don't need to install it
Latest version — 1.1.1-beta.1+26.1-26.2 from August 2, 2026
License Apache-2.0 — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.21.8–1.21.9, 26.1–26.2

whitelisted

The Minecraft side of a self-service allow-listing service.

For the auth server, please see this repository.

What this does

This mod is part of a self-service onboarding service. It adds an extra layer of authorization when players log in to a Minecraft server, by asking an auth server whether a given player is allowed to join or not.

Essentially, this is a glue mod to the auth server, which does user auth with MSA* and displays a document prior to adding a player to the allow list.

The original goal for this project is to enforce players to read a code-of-conduct document before playing.
While newer Minecraft versions already have this feature built-in, this project still serves a purpose as a gatekeeper against malicious players or bots that ignore the rules screen.

This mod does not talk to any specific server out of the box. It must be configured before use.

tl;dr: If you are a server admin intending to operate a public server but would like some protection from server scanner griefers and make players agree to some rules, then whitelisted might be a solution.

[!NOTE] If you are a player intending to play on a server, you do not need to install this.

[!IMPORTANT] Setting up this service requires some technical knowledge, and at the moment this mod does not serve any purpose without the backend server.

In the future, this mod will become optional as it is planned for the backend to talk to the management websocket directly.

Footnotes

*: Microsoft Accounts

FAQ

How to install whitelisted?

Install Fabric for your Minecraft version, download whitelisted for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does whitelisted support?

whitelisted has builds for Minecraft 1.21.8–1.21.9, 26.1–26.2.

Is whitelisted needed on the server?

Server only — players don't need to install it

License and source
Apache License 2.0free to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More