[MD]
# OfflineLogin
OfflineLogin 是一个为 Nukkit-MOT 服务器设计的离线登录与账号验证插件，支持基础密码注册以及通过邮箱（Resend API 或标准 SMTP 服务）发送验证码进行注册验证。
## 主要特性
- **安全的世界隔离**：提供一个专门的 `login` 超平坦世界，在玩家验证身份前取消所有的移动、交互、破坏和聊天等操作，避免对主世界造成影响和背包数据混乱。
- **多种验证模式**：
- `NONE`: 仅基础密码验证
- `RESEND`: 通过 Resend API 发送邮箱验证码进行注册
- `SMTP`: 通过传统 SMTP 服务发送邮箱验证码进行注册
- **数据存储支持**：基于 EasySQLX 插件，默认采用 SQLite 存储玩家账号信息，支持扩展到 MySQL。
- **正版数据迁移**：内置 `/offline convertuuid` 指令，方便正版服务器转入离线模式时，将基于 UUID 保存的玩家背包数据安全迁移为基于玩家名字保存的数据（包含自动备份机制）。
## 前置依赖
- **[EasySQLX](https://github.com/MemoriesOfTime/EasySQLX.git)**：用于处理数据库存储。请务必确保服务器已安装该前置插件。
## 指令列表
| 指令 | 描述 | 权限 |
| --- | --- | --- |
| `/reg <password> <password>` | 注册账号 | 默认玩家 |
| `/login <password>` | 登录账号 | 默认玩家 |
| `/reset <password>` | 重置密码 | 默认玩家 |
| `/offline convertuuid` | 将所有基于 UUID 的玩家数据转换为名字保存，适用于正版转盗版 | OP |
## 配置文件说明
`config.yml` 示例与说明：
```yaml
# 注册/验证配置
# 可选：
# - NONE：仅密码注册
# - RESEND：通过 Resend 发送邮箱验证码
# - SMTP：通过 SMTP 发送邮箱验证码
active-method: NONE
security-settings:
# 密码最短长度
min-password-length: 6
# 单个 IP 最多可注册的账号数
max-accounts-per-ip: 1
# 以下仅在 RESEND / SMTP 模式下生效
# 验证码位数
code-length: 6
# 验证码有效期（秒）
expire-time: 300
# 发送验证码的冷却时间（秒）
request-cooldown: 60
mail-settings:
# 邮件标题
subject: "欢迎注册 - 您的验证码"
# 邮件内容，{code} 会替换为实际验证码
html-template: "<h1>欢迎！</h1><p>您的注册验证码：<strong>{code}</strong></p><p>请在 5 分钟内完成验证。</p>"
# 只会读取与 active-method 对应的配置
resend:
# Resend API Key
api-key: "<YOUR_RESEND_API_KEY>"
# 发件地址，需为 Resend 已验证域名下的邮箱
from-address: "onboarding@resend.dev"
smtp:
# SMTP 服务器地址
host: "smtp.example.com"
# 端口：465(SSL) / 587(TLS) / 25(无加密)
port: 465
# 加密方式：SSL / TLS / NONE
encryption: "SSL"
# 登录账号
username: "mc-server@example.com"
# 登录密码或应用专用密码
password: "<YOUR_SMTP_PASSWORD>"
# 发件地址，通常与 username 保持一致
from-address: "mc-server@example.com"
```
## 数据迁移指南 (UUID 转 Name)
如果您的服务器一开始开启了正版验证（基于 UUID 存储玩家背包及状态），而后安装本插件并关闭了正版验证，可以通过以下步骤进行数据迁移：
1. 确保服务器正在运行且只有管理员在线。
2. 执行管理员指令：`/offline convertuuid`。
3. 插件将会自动执行以下操作：
- 将当前的 `nukkit.yml` 中的 `save-player-data-by-uuid` 状态修改为 `false`。
- 备份 `players/` 目录至 `players_backup/`。
- 读取所有 `UUID.dat` 格式的数据，提取其中的玩家名，并将其重命名为小写的 `<玩家名>.dat`。
- 清理旧的 `UUID.dat` 文件。
- 自动关闭服务器以应用更改。
4. 确认服务端无异常后重新启动服务器即可。
## 开发信息
- 适用服务端：Nukkit-MOT
- API版本：1.0.14
- 开发者：mcayear
[/MD]
