Back to mods
BeaconAuth project artwork

CurseForge · Minecraft mod

BeaconAuth

Secure web, OAuth, and passkey authentication for Minecraft servers using the BeaconAuth mod and a self-hosted auth server.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which BeaconAuth release should I use?

Updated 3 days ago
beta file BeaconAuth 1.0.0 preview 38 (Forge 1.20.1)
Game version 1.20.1
Loader Forge

BeaconAuth 1.0.0 preview 38 (Forge 1.20.1) targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is BeaconAuth required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does BeaconAuth 1.0.0 preview 38 (Forge 1.20.1) need?

BeaconAuth 1.0.0 preview 38 (Forge 1.20.1). Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add BeaconAuth without breaking your instance.

Built for BeaconAuth 1.0.0 preview 38 (Forge 1.20.1). Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use BeaconAuth 1.0.0 preview 38 (Forge 1.20.1). It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside BeaconAuth 1.0.0 preview 38 (Forge 1.20.1). It opens that exact file at the source.

About this project

What does BeaconAuth add?

BeaconAuth adds a secure sign-in layer for Minecraft communities. It connects a Minecraft server to a self-hosted BeaconAuth web service, allowing server owners to require web-based authentication for modded clients while keeping account verification clear, configurable, and under their own control.

Features

  • Web-based Minecraft login flow
  • OAuth and passkey support through the BeaconAuth server
  • Signed session verification with JWT and JWKS
  • Configurable server-side authentication behavior
  • Support for community-managed BeaconAuth accounts
  • Localized client messages
  • No third-party analytics, advertising, telemetry, or external file downloads in the Minecraft mod

How it works

When a player joins a server that uses BeaconAuth, the mod can open the configured BeaconAuth login page in the player’s browser. After the login is completed, the mod returns a signed authentication result to the Minecraft server, where it is verified against the configured BeaconAuth server keys.

Server owners host and configure their own BeaconAuth server URL.

Supported versions

Minecraft version Fabric Forge NeoForge
1.20.1 Yes Yes No
1.21.1 Yes No Yes
1.21.8 Yes No Yes

Install the jar that matches your Minecraft version and loader from the Files tab.

Privacy and network usage

The Minecraft mod connects to the BeaconAuth server configured by the server owner during the login flow. It does not include ads, analytics, telemetry, or background file downloads.

The client may open the configured BeaconAuth web page in the player’s browser and use a temporary local callback listener to complete the login flow.

Server owners are responsible for their own BeaconAuth deployment, logs, OAuth provider configuration, and community privacy notice.

License

BeaconAuth is licensed under the MIT License.

Project description from CurseForge.

Pick your setup

BeaconAuth by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

8 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

BeaconAuth versions and loaders

99 of 99 releases match

Looking for an older file? The official CurseForge project page is in Resources.