Compatibility
Minecraft: Java Edition
1.21.11
Platforms
Supported environments
Links
Creators
Details
Licensed MIT
Published 4 days ago
Updated 2 weeks ago
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


