外观
氛围动效
FE_PVP 使用文档
FE_PVP 是锐界幻境的独立 PvP 竞技系统，提供单挑 1v1、团队竞技、快速匹配、饥饿游戏、押注决斗、观战、装备组合、ELO 段位与排行榜等功能。
系统能力
| 能力 | 说明 |
|---|---|
| 单挑 1v1 | 创建或加入房间，选图后选装备开打 |
| 团队竞技 2v2 / 3v3 / 4v4 | 红蓝对抗，淘汰制与击杀数制两种规则 |
| 饥饿游戏 | 单人求生，靠场地补给箱活到最后 |
| 快速匹配 | 一键自动建房间，随机地图 |
| 押注决斗 | 单挑专属，双方对押，胜者通吃，支持灵叶与星痕石 |
| 排行榜与 ELO 段位 | 8 段位体系，分页排行榜 |
| 装备组合 | 管理员预设装备，赛前通过 GUI 选择 |
| 方块复原 | 比赛中可破坏与放置，赛后分批复原，tile 保真 |
| 背包归还 | 比赛结束或断线重连时自动恢复背包 |
| 每日奖励 | 胜利与平局发放星痕石与灵叶，带每日上限 |
| 世界保护 | 非竞技状态禁止进入竞技场世界，可绕过 |
安装与部署
环境要求
| 项目 | 要求 |
|---|---|
| 服务端 | Paper 1.21.11+（Paper 26.2+） |
| Java | JDK 21+ |
| 内存 | 无额外要求，插件本身小于 50MB |
可选依赖
| 插件 | 用途 | 必需 |
|---|---|---|
| PlaceholderAPI | 占位符支持，30 个以上 | 否 |
| Multiverse-Core | 多世界竞技场管理 | 否 |
| Vault | 押注局灵叶货币、每日奖励发放 | 否，用押注或奖励才需要 |
| PlayerPoints | 押注局星痕石货币、每日奖励发放 | 否，用押注或奖励才需要 |
| SkinsRestorer | 排行榜与玩家头颅皮肤 | 否 |
安装步骤
- 下载
[F][竞技场]FE_PVP.jar放入服务器plugins/目录。 - 启动服务器，插件自动生成配置文件。
- 按需编辑
plugins/FE_PVP/config.yml。 - 执行
/fepvp admin reload或重启服务器。
目录结构
启动后自动生成：
text
plugins/
└── FE_PVP/
├── config.yml # 主配置
├── lang.yml # 语言文件
├── arenas.yml # 竞技场数据（自动生成）
├── kits.yml # 装备组合数据（自动生成）
├── fepvp.db # SQLite 数据库（默认）
├── daily-rewards.yml # 每日奖励领取量（自动生成）
├── pending-restore/ # 方块恢复与背包备份（崩溃恢复用，正常自动清理）
└── data-loss-backup.yml # MySQL 不可达时的数据兜底备份（异常时生成）1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
首次启动检查
启动后控制台应看到：
text
[FE_PVP] SQLite database initialized.
[FE_PVP] Loaded 0 arena(s).
[FE_PVP] Loaded 0 kit(s).
[FE_PVP] FE_PVP has been enabled!1
2
3
4
2
3
4
看到 PlaceholderAPI expansion 注册成功，说明 PAPI 已对接；使用押注或奖励时还会看到 Vault 与 PlayerPoints 挂钩日志。
数据库选择
默认使用 SQLite，零配置且已内嵌驱动。如需 MySQL，编辑 config.yml：
yaml
database:
type: mysql
mysql:
host: localhost
port: 3306
database: fepvp
user: root
password: "your_password"1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
切换数据库
MySQL 需要额外放入 mysql-connector-j 驱动 JAR 到 plugins/FE_PVP/lib/，重启后自动使用 MySQL。SQLite 与 MySQL 数据不互通，切换前需手动迁移。
服主上手
- 创建竞技场：执行
/fepvp arena create 森林竞技场 duel，再依次执行/fepvp arena setworld 森林竞技场、/fepvp arena setspawn 森林竞技场 1、/fepvp arena setspawn 森林竞技场 2。 - 创建装备组合：穿好装备后执行
/fepvp kit create 经典PvP。 - 开服测试：执行
/fepvp打开大厅 GUI。