MineAuth

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 /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

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