
MineAuth
A simple Authentication mod with auto Login SUPPORT 1.21.11 /简体中文
About this Mod
MineAuth - Server Authentication

- English
- 简体中文
A simple and easy-to-use Minecraft server authentication mod with IP verification, multi-language support, login protection, session management, and permanent login for special users.
Only supports Minecraft 1.21.11 Java Edition for Fabric.
Attention!!!!! If yours Minecraft Version < 1.21.11, Please Use Another Mods for Auth, this Minecraft version changed old API
Features
- Complete registration/login system with password change support, configurable login attempt limits
- Configurable session expiration time, supports auto-login
- Admins can grant permanent login permission to players using
/passcommand - Admins can reset player account status using
/refreshcommand - Supports Fake Player Auth
- Supports IP verification to prevent login from different locations, option for single account per IP
Installation
- You need Install Fabric-Language-Kotlin too.
- Place the mod file in server's
modsfolder - Start server to generate config file
- Modify
config/mineauth/mineauth.confas needed - Reload config need restart server.
Player Commands
| Command | Description | Permission Level |
|---|---|---|
/register <password> <confirm> |
Register new account | 0 |
/reg <password> <confirm> |
Register new account (short) | 0 |
/login <password> |
Login to account | 0 |
/logout |
Logout from account | 0 |
/changepassword <old> <new> |
Change password | 0 |
/cpwd <old> <new> |
Change password (short) | 0 |
Admin Commands
| Command | Description | Permission Level |
|---|---|---|
/pass <playername> |
Grant permanent login permission to player | 3 |
| • Player will never need to login again | ||
| • Player sessions never expire | ||
| • Only works for unregistered players | ||
/refresh <playername> |
Reset specified player's login status | 3 |
| • Clear login cooldown | ||
| • Reset registration status (requires re-register) | ||
| • Useful when players forget passwords |
You can use /pass on the Fake Player .
Configuration
Edit config/mineauth/mineauth.conf:
# ================================================
# MineAuth 1.0.0 Configuration File
# Author: QuesoX
# 注意: 修改配置后需要重启服务器生效
# Note: Server restart required after modifying configuration
# ================================================
# [语言设置 / Language Setting]
# auto: 自动根据系统语言选择 | auto: Auto-detect based on system language
# zh_cn: 简体中文 | en_us: English
language=auto
# [IP验证 / IP Verification]
# 启用后,不同IP登录同一账号时会要求重新输入密码
# When enabled, logging in from a different IP will require re-entering the password
ipVerify=false
# [同一IP单账号 / One Account per IP]
# 必须开启ipVerify才能生效
# 开启后,同一IP注册多个账号会被禁止,并通知管理员
# 可使用/refresh命令重置账号状态
# When enabled, registering multiple accounts from the same IP will be blocked and admins will be notified
# Requires ipVerify to be enabled
# Use /refresh command to reset account status
sameIPSameAccount=false
# [会话过期时间 / Session Expiration Time]
# 支持格式: 10m (分钟), 2h (小时), 30d (天)
# Supported formats: 10m (minutes), 2h (hours), 30d (days)
sessionTime=1d
# [登录尝试限制 / Login Attempt Limit]
# 如果禁用,则无限尝试次数,不会踢出玩家
# If disabled, unlimited attempts and no player kick
enableLoginLimit=true
# [冷却时间 / CoolDown Time]
# 达到最大尝试次数后的等待时间
# 支持格式: 10m (分钟), 1h (小时), 2d (天)
# /refresh 命令可以重置冷却时间
# Waiting time after reaching maximum attempts
# Supported formats: 10m (minutes), 1h (hours), 2d (days)
# /refresh command can reset cooldown
coolDownTime=5m
# [最大登录尝试次数 / Maximum Login Attempts]
# 仅在 enableLoginLimit=true 时生效
# Only effective when enableLoginLimit=true
maxLoginAttempts=10
# [Pass命令 / Pass Command]
# 开启后,OP可以使用/pass命令让玩家永久登录,无需注册
# 使用后该玩家将永久登录,不受会话时间限制
# When enabled, OP can use /pass command to let players login permanently without registration
# After using, the player will be permanently logged in, not affected by session time
enablePassCommand=false
Available Versions
How to Install MineAuth on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "MineAuth". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
MineAuth server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is MineAuth compatible with fabric?
MineAuth officially supports fabric for Minecraft 1.21.11. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with MineAuth – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if MineAuth consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install MineAuth with just one click on your server.