OfflineAuth

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

- Command `/auth help` — Secure commands for players. - Command `/auth help` — Unauthenticated player's inventory is backed up and restored on login. - Command `/auth help` — Too many failed attempts will lock the account for a configurable period and kick the player. - Command `/auth help` — Players can be automatically logged in within a set time window if they join from the same IP. - Command `/auth help` — All prompts and behaviors can be customized in `config/offlineauth/config.json`. - Command `/auth help` — 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