MineAuth

MineAuth - 服务器认证

• English
• 简体中文

一个简单易用的 Minecraft 服务器认证模组，支持 IP 验证、多语言、登录保护、会话管理以及特殊用户的永久登录。

仅支持 Fabric 的 Minecraft 1.21.11 Java 版。

注意！！！！！如果你的 Minecraft 版本 < 1.21.11，请使用其他认证模组，该 Minecraft 版本更改了旧版 API

功能特性

• 完整的注册/登录系统，支持修改密码，可配置登录尝试次数限制
• 可配置的会话过期时间，支持自动登录
• 管理员可使用 /pass 命令授予玩家永久登录权限
• 管理员可使用 /refresh 命令重置玩家账号状态
• 支持假人（Fake Player）认证
• 支持 IP 验证，防止从不同位置登录，可选每个 IP 仅允许一个账号

安装

1. 你还需要安装 Fabric-Language-Kotlin。
2. 将模组文件放入服务器的 mods 文件夹
3. 启动服务器以生成配置文件
4. 根据需要修改 config/mineauth/mineauth.conf
5. 重新加载配置需要重启服务器。

玩家命令

命令	描述	权限等级
/register <password> <confirm>	注册新账号	0
/reg <password> <confirm>	注册新账号（简写）	0
/login <password>	登录账号	0
/logout	退出登录	0
/changepassword <old> <new>	修改密码	0
/cpwd <old> <new>	修改密码（简写）	0

管理员命令

命令	描述	权限等级
/pass <playername>	授予玩家永久登录权限	3
	• 玩家将永远无需再次登录
	• 玩家会话永不过期
	• 仅对未注册玩家有效
/refresh <playername>	重置指定玩家的登录状态	3
	• 清除登录冷却
	• 重置注册状态（需要重新注册）
	• 玩家忘记密码时非常有用

你可以对假人（Fake Player）使用 /pass 命令。

配置

编辑 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