ProAuthMeLogin

A plugin allowing your players to login without typing password by entering commands. Now we have supported Folia, Paper, Purpur and Leaf.

Dependencies

Dependency	Type
Paper 1.21+ / Folia	✅Required
Java 21	✅Required
AuthMe 5.6.1+	✅Required
Floodgate + Geyser	⚠️Optional (Bedrock Edition Support)
ItemsAdder	⚠️Optional (Custom Items)
FastLogin	⚠️Optional (Automatic Login for Genuine Players)
PlaceholderAPI	⚠️Optional

Features

• Dual GUI Mode: Clients 1.21.5+ automatically use the native Dialog window; other clients revert to the Anvil GUI.

• User Agreement Pop-up: Displays the agreement after login/registration; rejection results in being kicked from the server.

• Bedrock Edition Support: Automatically identifies and routes to the Bedrock Edition GUI via Floodgate.

• Security Protection: Login failure lockout, IP address protection. Rate limiting, security audit logs

• Password policy: Configurable length limit, uppercase letter requirement

• Folia compatibility: All scheduling operations are adapted to Folia multi-threading

配置

max-attempts: 3           # 最大登录尝试次数
lockout-duration: 300     # 锁定时长（秒）

config:
  isRequestUpper: true    # 密码须含大写字母
  checkLowestPassword: true
  checkLongestPassword: true
  enableAgreement: true   # 启用用户协议弹窗
  useDialogGui: true      # 启用 Dialog GUI（1.21.5+ 客户端）
  close-kick: true        # 强制无法关闭登录界面

materials: login: left: "PAPER" right: "REDSTONE" output: "ARROW" register: left: "DIAMOND" right: "IRON_INGOT" output: "ARROW"

messages: login-title: "Login" reg-title: "Register"

... 其余见默认 config.yml

agreement:

• "1. 禁止作弊"
• "2. 遵守服务器规则"

... 自定义协议内容

> Items support the ItemsAdder format：`namespace:item_id`

## 命令

| 命令             | 说明       | 权限                     |
|----------------|----------|------------------------|
| `/al reload`   | reload config     | `authanvillogin.admin` |
| `/al list`     | Check player authentication status | `authanvillogin.admin` |
| `/al login`    | Manually open the login GUI | 所有人                    |
| `/al register` | Manually open the register GUI | 所有人                    |

## Frequently Asked Questions

**Login screen cannot be opened:** Check if the item names in the `materials` configuration are valid.

**Authentic players still need to enter a password:** Ensure FastLogin and AuthMe are both running correctly. The plugin will delay for 2 seconds to wait for automatic login to complete.

**Folia error UnsupportedOperationException:** Upgrade to the latest version. The issue with BukkitScheduler in older versions has been fixed.

**getClientBrandName() NullPointerException:** Upgrade to the latest version. Null value protection has been added.

## License

GPL-3.0 license ©