DreamPlot 梦境剧情系统

📝 插件介绍
DreamPlot是一款为Minecraft服务器设计的梦境剧情插件，提供丰富的剧情体验功能。玩家可以在服务器中体验梦境探索、剧情解锁、传送锚点等多种功能，管理员可以轻松创建各种剧情区域和互动点。该插件基于Paper API开发，与LuckPerms深度集成，为RPG服务器提供了完整的剧情系统解决方案。

✨ 主要功能
- 📜 剧情独白区域：玩家进入特定区域时触发剧情独白，区分首次进入和后续进入的不同剧情
- 🔮 传送锚点系统：玩家解锁传送锚点获得传送权限，解锁数量达到要求时提升梦境阶段
- 🧚 悦灵引路功能：生成引路精灵带领玩家前往目标，实时显示距离和方向提示
- 🚫 禁止通行区域：基于权限的区域访问控制，未解锁区域自动传送出去
- 📊 梦境阶段系统：31个不同的梦境阶段，随着锚点解锁数量提升等级
- 💫 死亡返回系统：玩家死亡后返回最近解锁的锚点，智能选择安全位置

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/dr region s <id>` | 创建剧情独白区域 | dr.admin |
| `/dr region d <id>` | 创建传送锚点 | dr.admin |
| `/dr region f <id>` | 创建禁止通行区域 | dr.admin |
| `/dr zhixian create <id>` | 创建支线剧情点 | dr.admin |
| `/dr reload` | 重载插件 | dr.admin |
| `/dr tpd <id>` | 传送到已解锁的锚点 | dr.player |
| `/dr gpsd <id>` | 生成悦灵引路 | dr.player |
| `/dr help` | 查看帮助 | dr.player |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `dr.admin` | 管理员权限，允许使用所有命令 | op |
| `dr.player` | 玩家基础权限 | true |
| `dreamregiond.<id>` | 特定锚点的使用权限 | 无 |
| `dreamregionf.<id>` | 特定禁止区域的进入权限 | 无 |

📋 PlaceholderAPI变量
| 变量 | 描述 |
|------|------|
| `%dream_phase%` | 玩家当前梦境阶段数字（1-31） |
| `%dream_phase_name%` | 玩家当前梦境阶段名称（如"初入梦境"） |
| `%dream_phase_prefix%` | 玩家当前梦境阶段前缀（如"Lv1."） |
| `%dream_unlocked_anchors%` | 玩家已解锁的锚点数量 |
| `%dream_triggered_regions%` | 玩家已触发的剧情区域数量 |


🔄 使用方法

创建剧情区域:
1. 站在想要创建剧情区域的位置
2. 执行命令 `/dr region s <id>`（例如：`/dr region s 森林入口`）
3. 区域创建成功后，编辑 `plugins/DreamPlot/regions/<id>.yml` 文件
4. 在文件中设置首次进入和后续进入的剧情文本，以及各梦境阶段的声音效果

创建传送锚点:
1. 执行命令 `/dr region d <id>`（例如：`/dr region d 城堡大门`）
2. 右键点击想要设置为锚点的方块
3. 锚点创建成功后，玩家可以通过右键该方块来解锁锚点
4. 解锁后，玩家可以使用 `/dr tpd <id>` 命令传送到该锚点

创建禁止通行区域:
1. 站在想要创建禁止通行区域的位置
2. 执行命令 `/dr region f <id>`（例如：`/dr region f 危险峡谷`）
3. 区域创建成功后，没有权限的玩家将无法进入该区域
4. 管理员可以通过LuckPerms给予玩家 `dreamregionf.<id>` 权限来允许其进入

使用悦灵引路:
1. 玩家需要先解锁目标锚点
2. 执行命令 `/dr gpsd <id>`（例如：`/dr gpsd 城堡大门`）
3. 悦灵会引导玩家前往目标锚点
4. 右键点击悦灵可以获取方向提示

💻 技术信息
- 支持版本: Paper 1.20.1+
- API版本: 1.20
- 开发语言: Java 17
- 依赖插件:
- LuckPerms (必需): 用于权限管理
- PlaceholderAPI (可选): 用于显示梦境阶段变量

⚙️ 安装方法
1. 将插件放入服务器的plugins文件夹
2. 确保已安装LuckPerms插件
3. 启动服务器，插件会自动生成配置文件
4. 根据需要修改config.yml和msg.yml文件
5. 开始创建剧情区域和锚点

📊 数据存储结构
- `config.yml`: 插件主配置文件
- `msg.yml`: 插件消息配置文件
- `regions/`: 存储剧情独白区域数据
- `regiond/`: 存储传送锚点数据
- `regionf/`: 存储禁止通行区域数据
- `zhixian/`: 存储支线剧情点数据
- `player_data.yml`: 存储玩家数据，包括已解锁的锚点、已触发的区域和梦境阶段

⚠️ 注意事项
- 插件需要LuckPerms作为前置插件
- 梦境阶段系统与锚点解锁数量相关联
- 剧情区域可以设置不同梦境阶段的不同音效
- 死亡返回系统会自动选择最近的已解锁锚点

---
感谢您选择DreamPlot插件！如有任何问题或建议，请随时联系我们。