MineAuth

MineAuth

A simple Authentication mod with auto Login SUPPORT 1.21.11 /简体中文

by
460 Downloads
fabric
Rent Server with this Mod

About this Mod

MineAuth - Server Authentication

same

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
    
    

Available Versions

MineAuth 1.0.1release
MC 1.21.11fabric
January 6, 2026

How to Install MineAuth on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).

3

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

fabric

Minecraft Versions

1.21.11

Server-side

Required

Recommended 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.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.11