# FaithfulFFA
一个强大且高度可定制的 Build FFA & Kit PVP 插件。
#
FaithfulFFA 的设计以简洁为核心：只需安装，配置极少的设置以符合您的喜好，然后您就可以开始游戏。 拥有极少的依赖项，它易于任何服务器管理员上手。
#
为了运行 FaithfulFFA，您需要满足以下要求：
- Java 版本: `Java 8`
- Spigot/Bukkit/Paper `Minecraft 1.8.8 服务器`
- 拥有可访问的 `MySQL 数据库`
- 已安装 Placeholder API 插件
#
## 基本设置
1. 首先，将您下载的 .jar 文件放入您的 `/Plugins/` 文件夹中。
2. 接下来，您将下载 Placeholder API 并将 .jar 文件放入您的 `/Plugins/` 文件夹中。
3. 然后启动您的服务器并找到 `/Plugins/FaithfulFFA/` 目录。
4. 使用任何文本编辑器打开 `/Plugins/FaithfulFFA/config.yml` 文件，并填写存储信息。
5. 在填写完您的数据库凭据后，可以使用 `/stop` 重启您的服务器。
6. 现在我们需要设置一个 FFA 竞技场的地图。
7. 导航到您想要使用的世界（您可以使用 [Multiverse-Core](https://modrinth.com/plugin/multiverse-core) 来实现此目的）。
8. 在聊天中运行 `/faithfulffa setup`。
9. 阅读说明，然后运行 `/faithfulffa setup ExampleMap` (ExampleMap 是您地图的名称)。
10. 使用青色羊毛设置生成点您站立的位置。
11. 然后使用灰色羊毛设置虚空高度。当玩家掉落到此高度以下时，他们将会死亡。
12. 使用黄色羊毛设置建造高度。玩家将在该高度以下进行战斗并获得他们的套件。
13. 完成步骤 3-5 后，您就可以与 Barrier 块交互了。这将完成对地图的设置。
14. 现在使用 `/stop` 重启您的服务器。
15. 重新加入后，您将被传送到您之前设置的地图生成点。 当您下降到您的建造高度时，您将获得默认套件。
## 编辑配置
1. 为了自定义插件，您可以导航到 `/Plugins/FaithfulFFA/` 目录。
2. 您会在这里找到几个以 .yml 结尾的文件。 您可以打开这些文件并编辑字符串（文本）以符合您的喜好。 警告：除非是每个地图的 `displayname`，否则请勿编辑 maps.yml 文件。
#
## 命令
| 命令 | 参数 | 权限 |
| -------- | -------- | -------- |
| `/ffa reload` | | `faithful.reload` |
| `/ffa setup` | `` | `faithful.setup` |
| `/build` | | `faithful.buildmode` |
| `/stats` | | |
#
## 占位符
| 占位符 | 描述 | 示例 |
| -------- | -------- | -------- |
| %faithful_online% | 在线玩家数 | 50 |
| %faithful_max_online% | 最大在线玩家数 | 100 |
| %faithful_kills% | 总击杀数 | 10 |
| %faithful_deaths% | 总死亡数 | 2 |
| %faithful_killstreak% | 当前连杀数 | 5 |
| %faithful_kit% | 当前装备的套件 | 默认 |
| %faithful_kd% | 击杀与死亡比例 | 5 |
| %faithful_map% | 当前地图名称 | Dust |
| %faithful_time_remaining% | 当前地图剩余时间 | 10:47 |