Back to mods
OfflineAuth project artwork

Modrinth · Minecraft mod

OfflineAuth

A lightweight authentication mod for Minecraft servers. Supports registration, login, inventory protection, brute-force prevention, and auto-login based on IP.

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

Quick answer

Which OfflineAuth release matches 1.20.6 Forge?

Updated 1 year ago
Best match for your filters 1.0.3
Game version 1.20.1, 1.20.2, 1.20.3
Loader Forge

OfflineAuth 1.0.3 targets 1.20.1, 1.20.2, 1.20.3 with Forge. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.

Where it goes

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

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
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

This file is marked server-only.

What else does OfflineAuth 1.0.3 need?

1.0.3 on 1.20.6 Forge. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install TrueUUID first. We found matching files for this game-version and loader setup.

TrueUUID Needed by OfflineAuth 1.0.3
required
Matching file found Matched file: 1.3.0+forge-1.20.6

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add OfflineAuth without breaking your instance.

Built for OfflineAuth 1.0.3 on 1.20.6 Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.3. It targets 1.20.1, 1.20.2, 1.20.3 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install TrueUUID first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.3. It opens that exact file at the source.

About this project

What does OfflineAuth add?

OfflineAuth

English | 简体中文

A lightweight authentication mod for Minecraft servers.
Supports registration, login, inventory protection, brute-force prevention, and auto-login based on IP.

Requires TrueUUID mod as a dependency!

Features

  • Register/Login/Change Password — Secure commands for players.
  • Inventory Protection — Unauthenticated player's inventory is backed up and restored on login.
  • Brute-force Protection — Too many failed attempts will lock the account for a configurable period and kick the player.
  • IP Auto-login — Players can be automatically logged in within a set time window if they join from the same IP.
  • Configurable Messages — All prompts and behaviors can be customized in config/offlineauth/config.json.
  • No interference with online (premium) accounts — Only offline UUID players are affected.
  • Command /auth help — View all available commands.

Commands

  • /register <password> <confirm> — Register a new account.
  • /login <password> — Login to your account.
  • /changepassword <old> <new> — Change your password.
  • /auth help — Show help information.

Configuration

Edit config/offlineauth/config.json to customize:

  • timeoutSeconds — Kick unauthenticated players after X seconds.
  • maxFailAttempts — Maximum login/register failures before lock/kick.
  • failLockSeconds — Lockout duration after too many failures.
  • autoLoginEnable — Enable/disable auto-login feature.
  • autoLoginExpireSeconds — Time window for IP-based auto-login.
  • messages — Customize all prompts and warnings.

Security Notice

  • Auto-login (same IP) is convenient, but insecure on public computers/networks. Always warn players to protect their accounts.
  • Passwords are stored in plain text (by default), use at your own risk or extend for encryption.

How to Install

  1. Install TrueUUID mod on your server. (Required!)
  2. Place the OfflineAuth mod jar in your server's mods folder.
  3. Start your server once to generate the config files.
  4. Edit config.json as needed.
  5. Restart the server.

License

LGPLv3

Project description from Modrinth.

Pick your setup

OfflineAuth by Minecraft version and loader

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

6 available setups

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

Recent files

OfflineAuth versions and loaders

3 of 3 releases match
Clear filters

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