# OfflineAuth<\/p>\n
### English | \u7b80\u4f53\u4e2d\u6587<\/p>\n
A lightweight authentication mod for Minecraft servers.
\nSupports registration, login, inventory protection, brute-force prevention, and auto-login based on IP.<\/p>\n
> **Requires TrueUUID mod as a dependency!**<\/p>\n
## Features<\/p>\n
– **Register\/Login\/Change Password** \u2014 Secure commands for players.
\n– **Inventory Protection** \u2014 Unauthenticated player’s inventory is backed up and restored on login.
\n– **Brute-force Protection** \u2014 Too many failed attempts will lock the account for a configurable period and kick the player.
\n– **IP Auto-login** \u2014 Players can be automatically logged in within a set time window if they join from the same IP.
\n– **Configurable Messages** \u2014 All prompts and behaviors can be customized in `config\/offlineauth\/config.json`.
\n– **No interference with online (premium) accounts** \u2014 Only offline UUID players are affected.
\n– **Command `\/auth help`** \u2014 View all available commands.<\/p>\n
## Commands<\/p>\n
– `\/register ## Configuration<\/p>\n Edit `config\/offlineauth\/config.json` to customize:<\/p>\n – `timeoutSeconds` \u2014 Kick unauthenticated players after X seconds. ## Security Notice<\/p>\n – **Auto-login (same IP)** is convenient, but insecure on public computers\/networks. Always warn players to protect their accounts. ## How to Install<\/p>\n 1. **Install TrueUUID mod on your server. (Required!)** ## License<\/p>\n LGPLv3<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight authentication mod for Minecraft servers. Supports registration, login, inventory protection, brute-force prevention, and auto-login based on IP.<\/p>\n","protected":false},"featured_media":115186,"template":"","meta":{"_minecraft_slug":"offlineauth","_minecraft_project_id":"DQxq3OlC","_minecraft_author":"YuWan030","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":2111,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"offlineauth.zip","_minecraft_size_bytes":82825,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T23:57:04.061911Z","_minecraft_date_created":"2025-10-06T01:59:21.245183Z","_minecraft_date_modified":"2025-10-31T17:55:58.342688Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/offlineauth","_minecraft_icon_attachment_id":115186,"_minecraft_imported_at":"2026-06-06T18:52:00+00:00","_minecraft_import_hash":"3b8c4ea2b69d62e881c0ffa3baed31cd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104],"mod_loader":[106],"minecraft_version":[36,60,93,94,101,102],"class_list":["post-115185","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_loader-forge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n
\n– `\/login
\n– `\/changepassword
\n– `\/auth help` \u2014 Show help information.<\/p>\n
\n– `maxFailAttempts` \u2014 Maximum login\/register failures before lock\/kick.
\n– `failLockSeconds` \u2014 Lockout duration after too many failures.
\n– `autoLoginEnable` \u2014 Enable\/disable auto-login feature.
\n– `autoLoginExpireSeconds` \u2014 Time window for IP-based auto-login.
\n– `messages` \u2014 Customize all prompts and warnings.<\/p>\n
\n– Passwords are stored in plain text (by default), use at your own risk or extend for encryption.<\/p>\n
\n2. Place the OfflineAuth mod jar in your server’s `mods` folder.
\n3. Start your server once to generate the config files.
\n4. Edit `config.json` as needed.
\n5. Restart the server.<\/p>\n