# **Core2FA — 双重验证**
## 🛡 概述
**Core2FA** 是一个 Minecraft 插件（Spigot、Paper、PurPur、Folia），通过 Telegram 添加双重验证。
它通过要求通过关联的 Telegram 帐户进行登录确认来保护玩家帐户免受劫持。
通过 Telegram 集成，玩家可以快速轻松地从手机管理其帐户安全。
---
## ✨ 特性
* **账户关联**
玩家可以将他们的 Minecraft 帐户与他们的 Telegram 帐户关联以获得额外的安全保障。
* **登录确认**
当玩家加入时，他们会收到 Telegram 通知，并可以批准或拒绝登录。
* **远程安全控制**
通过交互式 Telegram 菜单，玩家可以：
* 批准或拒绝登录。
* 如果检测到可疑活动，可以阻止其帐户 *(如果已启用)*。
* 解除关联帐户 *(如果服务器管理员允许)*。
* 使用 **Telegram 中的 `/menu` 命令** 远程管理帐户，访问所有设置。
* **可配置选项**
可调整的语言、通知中的自定义服务器名称以及细粒度的权限控制。
* **Folia 支持**
针对基于 Folia 的服务器进行了优化，使其运行流畅。
---
## ⚙ 设置
1. 将插件放入您的 `/plugins` 文件夹中。
2. 启动服务器以生成配置文件。
3. 编辑 `config.yml`：
```yaml
server-name: "MyServer" # 在 Telegram 通知中显示的名称
language: "en" # 插件语言
telegram:
bot-token: "BOT_TOKEN_HERE" # 您的 Telegram 机器人令牌
bot-username: "NAME_BOT" # 您的机器人的用户名
telegram-menu:
settings:
allow-unlinking: false # 允许解除关联帐户
allow-remote-ban: false # 允许远程封禁
```
4. 重启服务器。
5. 玩家可以使用 `/2fa` 关联其帐户。
---
## 📜 命令
| 命令 | 别名 | 描述 |
| -------------------- | --------------- | -------------------------------------------------------------- |
| `/2fa` | `/tfa`, `/auth` | 主要命令，用于管理 2FA |
| `/2fa reload` | — | 重新加载插件配置文件 |
| `/menu` *(Telegram)* | — | 在 Telegram 中打开交互式 Telegram 菜单以远程管理帐户 |
---
## 🔑 权限
| 权限 | 描述 |
| -------------- | ------------------------------------------- |
| `twofa.reload` | 重新加载插件配置文件 (仅限 OP) |
---
## 🖥 兼容性
* **平台:** Spigot, Paper, PurPur, Folia
* **Java:** 17+
---
## 📌 使用示例
1. 玩家加入服务器。
2. 他们收到 Telegram 消息：“*确认登录到 MyServer 吗？*"
3. 他们按下“确认”或“拒绝”。
4. 登录被允许或阻止。
5. 玩家可以使用 **Telegram 中的 `/menu`** 来管理安全设置或解除关联帐户。
6. 服务器管理员可以使用 `/2fa reload` 应用配置更改，而无需重新启动。
---
## 📄 许可证
MIT 许可证 - 免费使用、共享或修改。
---