LamMailBox 允许管理员向离线玩家发送物品和富文本消息。 这是一个适用于 Paper/Folia 1.20+ 的轻量级邮箱系统，可通过命令或插件触发器运行。
## 核心功能
* **离线投递**: 随时向任何玩家发送邮件和物品附件。 物品在玩家领取前保存在服务器端。
* **命令友好**: 使用 `/lmb send` 或从其他插件触发，即可实现即时奖励、礼物或活动掉落。
* **简单 GUI**: 玩家可以通过直观的界面浏览、阅读和领取邮件，并且在领取时会检查清单。
* **富文本消息**: 支持颜色代码、`\n` 换行符和 Unicode 图标。
* **管理员工具**: 附加控制台命令、安排未来投递、设置过期时间，或通过 `max-runs` 限制重复次数。
* **批量目标**: `player1;player2`、`allonline`（当前玩家的快照）或 `all`（对所有人永久生效）。
* **自动化邮件**: 类似于 Cron 的循环任务，以及首次加入时提供的捆绑包，并在服务器重启时自动补齐。
* **灵活存储**: 可以选择 YAML 或 SQLite 后端（SQLite 推荐用于 1000 封以上的邮件）。
* **通知**: 新邮件的聊天、标题和声音提示，以及加入提醒。
* **Folia/Paper 兼容**: 使用捆绑的 FoliaLib 调度器实现平滑的跨平台计时。
## 限制 & 发展路线图
* 当前不支持跨服务器同步或 Bungee/Velocity 支持。
## 命令
| 命令 | 权限 | 描述 |
| ------------------------------ | ------------------------ | -------------------------------- |
| `/lmb` | `lammailbox.open` | 打开您的邮箱 |
| `/lmb ` | `lammailbox.open.others` | 查看其他玩家的邮箱 |
| `/lmb view ` | *(无权限)* | 通过 ID 查看邮件（如果可以访问） |
| `/lmb as ` | `lammailbox.view.as` | 以其他玩家的身份查看邮件 UI |
| `/lmb send ` | `lammailbox.admin` | 通过命令或控制台发送邮件 |
| `/lmb mailings` | `lammailbox.admin` | 查看 Cron/首次加入自动化仪表盘 |
| `/lmbreload` | `lammailbox.reload` | 重新加载配置文件 |
| `/lmbmigrate ` | `lammailbox.migrate` | 在存储后端之间迁移邮件（yaml/sqlite） |
**别名:** `/mailbox`, `/mail`
## 附加权限
| 权限 | 描述 |
| ---------------------- | ---------------------------------------------- |
| `lammailbox.compose` | 通过 GUI 创建和发送新邮件 |
| `lammailbox.items` | 在创建邮件时添加物品 |
| `lammailbox.delete` | 从已发送邮件视图中删除已发送邮件 |
## 设置
1. 将 jar 文件放入 `plugins/` 目录，并启动服务器以生成配置文件/数据库文件。
2. 编辑 `plugins/LamMailBox/config.yml` 以自定义 GUI 文本、插槽、通知设置和默认过期天数。 将任何按钮条目的 `enabled: false` 来将其从界面中移除。 装饰填充可以通过 `commands` 列表运行控制台命令，其中包含 `%player%` 和 `%uuid%` 占位符。
3. 授予适合您等级的权限。
4. 通过 GUI 或使用 `/lmb send` 撰写邮件；在 `mailings.yml` 中设置循环投递，用于 Cron 或首次加入的工作流程 (`/lmb mailings` 显示状态)。
## 文档
需要示例或更深入的指导？ 查看 Wiki：
* **[主页](https://github.com/LamaliaNetwork/LamMailBox/wiki/Home)** – 概述和快速开始。
* **[发送邮件](https://github.com/LamaliaNetwork/LamMailBox/wiki/Sending-Mail)** – GUI 教程、命令语法、批量目标、附件。
* **[自动化邮件](https://github.com/LamaliaNetwork/LamMailBox/wiki/Automated-Mailings)** – Cron 提示、场景库、补齐行为、`max-runs`。
* **[配置](https://github.com/LamaliaNetwork/LamMailBox/wiki/Configuration)** – 通知、存储后端、权限、GUI 主题链接。
## 要求
* Paper 或 Folia 1.20+
* Java 21 运行时
* [YskLib](https://github.com/YusakiDev/YskLib/releases) 1.6.0 或更高版本
## 支持
* 问题：[GitHub](https://github.com/LamaliaNetwork/LamMailBox/issues)
* Discord：[YusakiDev](https://discord.gg/AjEh3dMPfq)
在玩家离线时发送邮件、礼物和奖励——无需笨拙的箱子交换。