# QRMap
QRMap 是一个 Paper/Spigot 版本的 Minecraft 插件，允许玩家生成二维码并在游戏地图上显示。它具有用户友好的 GUI、分页功能以及使用简单数据库系统实现的持久化存储。
## 功能
* 直接在 Minecraft 中生成二维码。
* 在分页 GUI 中显示二维码地图。
* 在 GUI 中取用二维码地图（左键点击）或删除它们（右键点击）。
* 二维码地图按唯一 ID 存储，以防止命名问题。
* API 支持以编程方式向玩家提供二维码地图。
* 权限系统控制谁可以生成二维码地图。
## 指令
```
/qrmap
```
* 如果不带参数使用，则打开 QRMap GUI。
* `/qrmap ` 使用指定的文本/URL 生成一个新的二维码地图并将其添加到你的物品栏中。
**权限：**
* `qrmap.use` – 必须拥有才能打开 GUI 或生成地图。
## GUI 使用
* **左键点击 (🖱️ LMB):** 取用地图 (需要 OP 权限)。
* **右键点击 (🖱️ RMB):** 删除地图。
* **箭头:** 在页面间导航。
## API 使用
你可以以编程方式向玩家提供二维码地图：
```java
QRMapAPI.giveQRMap(player, "https://example.com", "Example Map");
```
这将生成一个新的地图，将其保存在数据库中，并将其提供给玩家。
## 安装
1. 将 `QRMap.jar` 放置在你的 `plugins` 文件夹中。
2. 启动服务器。
3. 确保插件创建了其数据文件夹 (`plugins/QRMap`) 和数据库。
## 数据库
* QRMap 使用基于文件的简单数据库（或您可以切换到 SQLite/MySQL）来存储地图数据，并使用唯一 ID。
* 每个地图存储：
* ID
* 二维码文本（URL 或自定义文本）
* 显示名称
## 兼容性
* Minecraft 1.21+ (Paper/Spigot)
## 许可
MIT 许可。 免费使用和修改。