服务端插件 泰拉瑞亚服务器插件-parkourplugin

[SAP]

以下是插件说明
---

### TShock跑酷插件使用说明

---作者:SAP (一个9年级的菜逼)
QQ群:755216350感兴趣的你们可以为我们的群注入活力吗😘(目前十分安静~p)

#### 一、插件功能
1. 多地图管理：支持创建多个跑酷地图，每个地图独立配置起点、终点和排行榜。
2. 计时与排名：自动记录玩家跑酷时间，每个玩家仅保留最佳成绩。
3. 告示牌显示：排行榜可实时显示在游戏内的告示牌（Sign）上。
4. 数据持久化：配置和记录自动保存，重启服务器不丢失。
5. 便捷指令：提供传送、地图列表、排行榜查询等功能。

---

#### 二、安装步骤
1. 下载插件
- 将编译后的 ParkourPlugin.dll 放入 TShock/ServerPlugins 文件夹。
- 确保已安装依赖项（如 Newtonsoft.Json.dll）。

2. 启动服务器
- 启动Terraria服务器后，插件会自动加载。控制台会显示加载成功提示。

---

#### 三、命令列表
| 命令 | 权限节点 | 说明 |
|------|----------|------|
| /setstart <地图名> | parkour.setstart | 在当前位置设置地图的起点。 |
| /setend <地图名> | parkour.setend | 在当前位置设置地图的终点。 |
| /setsign <地图名> | parkour.setsign | 将当前位置的告示牌绑定为地图的排行榜显示位置。 |
| /startparkour <地图名> | parkour.start | 传送到指定地图的起点并开始计时。 |
| /rank <地图名> | parkour.rank | 查看指定地图的排行榜（前5名）。 |
| /map list | parkour.maplist | 列出所有已配置的跑酷地图。 |

---

#### 四、配置地图
1. 设置起点与终点
- 步骤：
- 站在目标位置，输入 /setstart 地图名（如 /setstart map1）。
- 同理，输入 /setend 地图名 设置终点。
- 示例：
``
/setstart (地图名字)
/setend (地图名字)

2. **绑定告示牌**  (警告:此功能现在还有bug，会出现绑定失败的情况，具体解决方法看下)
   - **步骤**：  
     1. 在目标位置放置一个告示牌（Sign）。  
     2. 站在告示牌旁，输入 `/setsign 地图名`。  
   - **效果**：  
     - 告示牌会自动显示该地图的排行榜（前5名）。
   -**setsign解决**
      -其实肥肠简单，玩家要将告示牌全部挡住，再输入指令即可解决。
---

#### **五、开始跑酷**
1. **玩家指令**  
   - 输入 `/startparkour 地图名`（如 `/startparkour map1`）。  
   - **效果**：  
     - 玩家会被传送到起点，并开始计时。  
     - 到达终点后自动记录时间，并更新排行榜。

2. **规则**  
   - 如果玩家中途退出或死亡，计时自动重置。  
   - 每个玩家在同一地图的排行榜中仅保留最佳成绩。

---

#### **六、查看排行榜**
1. **通过指令查看**  
   - 输入 `/rank 地图名`（如 `/rank map1`）。  
   - **显示内容**：

=== 地图 [map1] 跑酷排行榜 ===
第 1 名: PlayerA - 12.34 秒
第 2 名: PlayerB - 15.67 秒

2. **通过告示牌查看**  
   - 已绑定的告示牌会自动更新为以下格式：

=== map1 排行榜 ===
1. PlayerA - 12.34 秒
2. PlayerB - 15.67 秒
```

---

#### 七、数据文件说明
- 路径：TShock/ParkourPlugin/
- parkour_maps.json：保存所有地图的起点、终点和告示牌位置。
- parkour_records.json：保存玩家的跑酷记录。
- 手动备份：直接复制这两个文件即可。

---

#### 八、常见问题
1. 无法设置起点/终点
- 检查权限：确保用户有 parkour.setstart 和 parkour.setend 权限。
- 命令格式：必须包含地图名（如 /setstart map1）。

2. 排行榜未更新
- 确保告示牌已通过 /setsign 正确绑定。
- 检查告示牌坐标是否有效（未被破坏或覆盖）。

3. 数据丢失
- 确保服务器正常关闭（插件会自动保存数据）。
- 避免直接修改JSON文件，除非熟悉格式。

---

#### 九、权限管理
- 默认权限：
- 普通玩家可使用 /startparkour、/rank 和 /map list(好像要自己加上去)。
- 管理员权限：
- 在 tshock 权限组中添加以下节点：
```ini
parkour.setstart
parkour.setend
parkour.setsign

SAP现在正努力学习，所以插件出现bug一时半会修不了。但大体可以用(小声bb)