转载 工具 [Duels Extension] GUI + 排行榜 v1.5

[MD]
# Duels Extension：GUI 对战界面与排行榜


## 概述

本附加组件为 Duels 插件提供现代、直观的图形界面，取代传统的命令操作方式。玩家可以在对战 GUI 中浏览在线对手、查看评分及胜负数据，并直接发送对战请求。即使服务器在线人数较多，也可通过分页和筛选功能顺畅地查找目标玩家。

组件还提供独立的套件选择界面，可查看各个对战套件对应的排行榜。每个排行榜均基于独立追踪的统计数据生成，确保专精于不同对战套件的玩家能够获得准确、公平的排名比较。

本组件通过专属扩展集成 PlaceholderAPI，可将玩家评分、胜负比等对战信息显示在计分板、聊天格式或其他兼容 PlaceholderAPI 的插件中。所有消息和 GUI 文本均可通过附带的语言文件完全自定义，方便适配服务器的风格与语言。

## 命令

```text
/duelgui
```

打开主对战 GUI，用于选择玩家并发起对战请求。

```text
/duelleaderboard
```

打开套件选择菜单，并显示对应套件的排行榜。

```text
/duelsaddon reload
```

重新加载配置文件和语言文件。

## PlaceholderAPI 占位符

以下为本组件提供的全部 PlaceholderAPI 占位符。所有数值均通过 `playerdata` 目录中存储的玩家数据解析。若请求的排名超过已存储玩家数量，占位符将返回 `null`。

### 指定排名的评分

```text
%duels_rating_<place>%
```

显示指定排行榜位置的玩家评分。

示例：`%duels_rating_1%` 显示排行榜第 1 名玩家的评分。

### 指定排名的玩家名称

```text
%duels_name_<place>%
```

显示指定排行榜位置的玩家名称。

示例：`%duels_name_1%` 显示排行榜第 1 名玩家的名称。

### 指定排名的胜负比

```text
%duels_wlr_<place>%
```

显示指定排行榜位置的玩家胜负比。

示例：`%duels_wlr_1%` 显示排行榜第 1 名玩家的胜负比。

### 当前玩家的胜负比

```text
%duels_wlr%
```

显示使用该占位符的玩家的胜负比。

## 配置说明

默认配置文件中包含全部占位符的详细说明，并已为后续功能扩展做好准备。

所有语言文本均可在 `eng.yml` 文件中修改，以满足服务器的本地化与个性化需求。
[/MD]