转载 游戏模式 FresitaDuels 1.0.1

[MD]
# FresitaDuels

FresitaDuels 是一款面向 Spigot/Paper 服务端的现代化、高度可配置的 1v1 单挑插件。它提供竞技化的单挑体验，包含竞技场管理、对局设置、GUI 菜单以及安全的奖励系统。

插件在设计时兼顾性能、可扩展性与清晰的架构，适合竞技类服务器使用。

## 功能

### 1v1 单挑系统

- 发送、接受或拒绝单挑邀请。
- 自动处理邀请超时。
- 支持多场单挑同时进行。

### 竞技场与地图管理

- 通过命令创建单挑竞技场。
- 分别设置两名玩家的出生点。
- 自动检查竞技场是否可用。

### 对局设置 GUI

插件提供一个可交互的 27 格 GUI 菜单，可针对每场单挑独立调整规则：

- 是否允许使用鞘翅。
- 是否允许放置蜘蛛网。
- 是否允许放置梯子。
- 是否允许使用所有类型的台阶与楼梯。
- 设置修改后实时生效。

### 对局计时系统

- 每场单挑最长持续 20 分钟。
- 倒计时会显示在背包界面标题中。
- 时间耗尽后自动结束对局。

### 奖励箱系统

- 获胜者可获得一个大型箱子背包，其中包含败者的物品。
- 战利品领取时间限制为 20 秒。
- 可通过 /duel chest 命令重新打开奖励箱。
- 奖励箱仅限获胜者访问，确保物品安全。

### 公平对局保护

- 玩家无法离开单挑竞技场。
- 方块放置与物品使用会受到本场对局规则限制。
- 对局结束后自动清理相关状态。

### 自动传送

单挑结束后，玩家将自动传送至 /spawn。

### 完整配置支持

- 配置文件：config.yml、messages.yml。
- 默认提供土耳其语消息支持。
- 可根据服务器需求轻松自定义文本与功能设置。

## 命令

| 命令 | 说明 |
| --- | --- |
| `/duel invite <player>` | 向指定玩家发送单挑邀请。 |
| `/duel accept <player>` | 接受指定玩家发起的单挑邀请。 |
| `/duel deny <player>` | 拒绝指定玩家发起的单挑邀请。 |
| `/duel chest` | 打开自己的奖励箱。 |

### 管理员命令

```text
/fresitaduels:create <arena>
/fresitaduels:start 1 <arena>
/fresitaduels:start 2 <arena>
```

## 权限

| 权限节点 | 说明 |
| --- | --- |
| `fresitaduels.admin` | 使用管理员功能。 |

## 兼容性

- 支持 Spigot 与 Paper。
- 支持 Minecraft 1.16 及更高版本。
- 推荐使用 Paper，以获得更好的性能表现。

## 适用场景

FresitaDuels 采用清晰的面向对象架构，并针对服务端性能进行了优化：

- 高效的任务调度机制。
- 安全的背包与对局状态处理。
- 适用于 PvP、练习服和竞技服务器。
- 便于后续扩展 ELO、战绩、排位单挑和数据库功能。

## 计划功能

- 排位单挑与 ELO 系统。
- 单挑数据统计。
- PlaceholderAPI 支持。
- MySQL 与 SQLite 数据存储。
[/MD]