ModsFinder

Live Whitelist

by cyber98

Live Whitelist lets a Forge server check each joining player's UUID against an external API, so an outside service such as a Discord bot can allow or refuse connections.

ForgeServer-side onlyApache License 2.0Open source1.20.1 – 1.20.6

What it does

The server sends each connection request to the base URL set in config.json. The reply decides whether the player may join. A false answer blocks the connection and shows the message string set in the config. The API must answer within about 2 seconds, or the player is kicked before the check finishes. The site must accept plain HTTP connections from the server, and the API needs at least one endpoint that verifies a UUID.

Setup follows the included JSON guide for the response format. Running the bundled script requires script execution to be enabled in Windows, and the script installs its required packages after a short wait. The script then writes config.json, where the API URL and the access token are filled in. After that the server is ready to use. Live Whitelist runs on the server only, so players join without installing anything. It is published for Forge only, for game versions 1.20.1 – 1.20.6, and is open source under the Apache License 2.0.

Key features

  1. UUID-based access check

    Each player's UUID is sent to an external endpoint, which answers whether that account may connect.

  2. Configurable API endpoint

    The base URL, access token and rejection message are set in config.json, so the check can point at any compatible service.

  3. Discord bot integration

    A Discord bot can hold the allow and disallow list, and the server asks it about each connection.

  4. Timeout-sensitive checks

    The server waits about 2 seconds for the reply, so the API needs to respond quickly.

  5. Guided setup script

    A bundled script installs the required packages and creates the config file from the values entered.

Compatibility

Latest build for each game version and loader.

1.20.61.3.1
1.20.51.3.1
1.20.41.3.1
1.20.31.3.1
1.20.21.3.1
1.20.11.3.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Use cases

Who it’s for: Server owners who run their own whitelist service or Discord bot and want the Forge server to query it during login. Players need nothing installed.

Questions

Does Live Whitelist need to be installed on player clients?

No. Players join without it, since only the server has to run the mod.

What happens if the API does not reply in time?

The server waits about 2 seconds for a response. If the reply is late or false, the player is refused with the message from config.json.

Which Minecraft versions does Live Whitelist support?

Forge files exist for 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 and 1.20.6, with 1.3.1 for 1.20.6 as the latest file.

In the catalog

Live Whitelist is one of 5,392 Social mods on ModsFinder, and one of 1,817 Social mods for Forge. 11,154 mods support Minecraft 1.20.6.

Social mods5,392Forge modsMods for 1.20.611,154

More from cyber98

All projects
Create Indestructible1.20.1 – 1.20.6

Similar mods

Simple Voice Chat1.8.8 – 26.3No Chat Reports1.19 – 26.3Chat Heads1.16 – 26.3Essential Mod1.8.9 – 26.3e4mc1.17 – 26.3NetherPortalFix1.12.2 – 26.3

What the author says

and wait a few moments for it to get the required packages. afterwards, create a config.json file with the following information (fill in the fields) Add in your token, and you're ready to hit the ground running! To run the script, open the folder and run
cyber98, on the Modrinth page

Official listing

Owner
cyber98
Published
2025-03-27
Updated on Modrinth
2025-03-27
Facts verified
2026-10-15

Tags

ManagementSocialGame mechanics
Open on ModrinthCompare