- 版权类型
- 原创
- 插件中文名称
- 青金石 AuthMe 修复扩展
- 插件英文名称
- Lapis-AuthmeReloadedFix
- 支持的核心(服务端)
- Paper
- Folia
- Purpur
- Leaves
- 语言支持
- 多语言
- 前置组件
- Authme Reloaded(必选) https://modrinth.com/plugin/authmereloaded
Fake Player Plugin (可选) https://www.minebbs.com/resources/fake-player-plugin.15790/
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
[MD]
### 插件介绍
AuthMeReloaded 6.0 是一次架构级重写(多模块、PlatformAdapter、PacketEvents),很多老服主依赖的功能在重构中被砍掉了:
- ❌ 防幽灵玩家 / 双重登录处理
- ❌ 基岩版(Floodgate)自动登录
- ❌ 内置的 PlaceholderAPI 变量(`%authme_*%`)
- ❌ 假人插件(FakePlayerPlugin)机器人的免登录方案 —— AuthMe 6 里 `forceLogin` 对**没有数据库账号的玩家直接无效**,导致假人进服后永远处于"未登录"状态,最终被登录超时踢出
**本插件作为 AuthMe 的"邻居插件"修复这一切**:不改 AuthMe 本体、只调它的公开 API,装上即用,缺了哪个依赖就自动跳过对应功能。
### 功能特性
| 功能 | 说明 |
| --- | --- |
| 🛡️ **防幽灵/双重登录** | 检测同名重复在线玩家,踢掉旧会话;FPP 假人永远不会被误踢 |
| 🧱 **基岩自动登录** | Floodgate 玩家进服自动登录(可配置仅限已注册账号) |
| 📊 **PAPI 变量扩展** | `%authme_isloggedin%` / `%authme_isregistered%` / `%authme_email%` / `%authme_lastlogin%` / `%authme_lastip%` / `%authme_regdate%` / `%authme_realname%` / `%authme_debug%` |
| 🤖 **FPP 假人兼容** | 为假人自动创建"临时账号+随机密码+自动登录",假人离开即删除,不污染数据库;**绝不登录/顶掉真实玩家账号** |
| 🔄 **崩溃/重启清理** | 假人临时账号在异常关服后,下次启动自动清理残留 |
| ⚡ **双核兼容** | Paper / Folia 运行时自动识别,线程调度正确 |
### 兼容性 / 依赖
- **必需**:AuthMeReloaded 6.0+,Paper 1.21+(Folia 亦支持),Java 21+
- **可选(缺省自动禁用对应模块)**:`floodgate`(基岩自动登录)、`FakePlayerPlugin`(假人兼容)、`PlaceholderAPI`(变量扩展)
- 通过反射桥接 AuthMe 5.x(`AuthMeApi`)与 6.x(`AuthmeApi`),无需打包任何依赖
### 配置文件(`plugins/Lapis-AuthmeReloadedFix/config.yml`)
```yaml
ghost-player-fix:
enabled: true
kick-message: "&cA player with the same name is already online. Please try again."
bedrock-auto-login:
enabled: true
only-registered: true
fpp-bot-auto-login:
enabled: true
cleanup-on-startup: true
placeholder-api:
enabled: true
```
### 命令 / 权限
- `/lapisauthmefix reload` —— 热重载配置(权限 `lapisauthmefix.reload`,默认 OP)
### 假人兼容原理(简述)
1. 假人进服,AuthMe 会安排登录/注册超时踢人;
2. 本插件识别假人(`FppApi#isBot`)后:
- 名字**未注册** → 注册随机密码临时账号并自动登录,名字写入 `bot-accounts.yml`;
- 名字**是上次我们建的** → 直接 `forceLogin`;
- 名字**属于真实玩家** → 跳过,绝不顶号;
3. 假人离开 → 删除临时账号;崩溃/重启遗留 → 下次启动自动清理。
### 许可
MIT License。AuthMeReloaded 本身仍为 GPL-3.0。
[/MD]