功能详解

命令系统

LHAuth 提供了两套命令系统：一套用于普通玩家，一套用于管理员管理。

玩家命令

普通玩家可以直接使用，或通过 /lhauth 主命令访问。

命令	别名	描述	权限
/register <密码> <确认密码>	/reg	注册新账号	无
/login <密码>	/l	登录账号	无
/changepassword <旧> <新>	/cp	修改密码	无
/logout	/exit	登出当前账号	无

提示：玩家也可以使用 /lhauth login 或 /lhauth register 等完整格式。

管理员命令

需要 lhauth.admin 权限（默认 OP 拥有）。

命令	描述
/lhauth help	显示管理员帮助菜单
/lhauth reload	重载 config.yml 和语言文件
/lhauth setlobby	将当前脚下位置设置为登录大厅（登录成功后传送至此）
/lhauth setauthspawn	将当前脚下位置设置为认证出生点（未登录玩家强制在此）

---

GUI 交互系统

LHAuth 的核心特色是全图形化交互。

• 触发机制：玩家加入服务器时，如果未登录，会自动打开 GUI 面板。
• 输入方式：点击面板上的数字物品输入密码。
• 操作逻辑：
  • 确认 (绿色方块)：提交密码进行验证。
  • 退格 (红色方块)：删除最后一位输入的字符。
  • 背景：灰色玻璃板装饰，防止误触拿取物品。
• 命令呼出：如果玩家不小心关闭了面板，输入 /login 或 /register 会再次呼出面板（或者直接在聊天栏输入参数）。

---

传送管理系统

LHAuth 提供了灵活的玩家位置管理，确保未登录玩家不会干扰服务器秩序。

1. 认证出生点 (Auth Spawn)

   • 作用：将所有未登录的玩家固定在一个封闭或安全的区域。
   • 设置：站定位置后输入 /lhauth setauthspawn。
   • 效果：玩家加入时会立即被传送到此位置，且无法移动（可通过配置调整）。

2. 登录大厅 (Lobby)

   • 作用：玩家登录成功后，将其传送到的主城或大厅位置。
   • 设置：站定位置后输入 /lhauth setlobby。
   • 效果：登录/注册成功后，玩家会被传送至此。

3. 返回下线位置 (Return Last Location)

   • 开关：在配置中设置 teleport.return-last-location: true。
   • 逻辑：如果开启，玩家登录后将回到上次下线的地方（适合生存服）。如果关闭，则强制传送到 Lobby（适合小游戏/大厅服）。

---

安全与日志

• 日志脱敏：插件内置过滤器，会自动识别并隐藏控制台中的敏感命令日志。
  • 例如：玩家输入 /login 123456，控制台只会显示 *** 或完全不显示，防止管理员或后台查看者窃取密码。
  • 兼容性：同时支持 Log4j2（高版本）和 Java Util Logging（低版本）。
• 密码强度：管理员可以在配置文件中限制密码的长度（默认 4-16 位）和字符类型（默认仅限字母数字），防止玩家使用过于简单的密码。