MineAuth - Server Authentication

!same

• 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 /pass command
• Admins can reset player account status using /refresh command
• Supports Fake Player Auth
• Supports IP verification to prevent login from different locations, option for single account per IP

Installation

0. You need Install Fabric-Language-Kotlin too.
1. Place the mod file in server's mods folder
2. Start server to generate config file
3. Modify config/mineauth/mineauth.conf as needed
4. 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