# **Health-Sync 插件**
## **概述**
_HealthSync 是一个 Minecraft 插件，旨在允许玩家将他们的生命值和饥饿度与其他玩家连接起来。 这种功能通过使玩家之间能够进行协作策略和共享资源来增强游戏体验。_
### 特性
- 连接生命值：玩家可以将他们的生命值与另一个玩家连接。
- 断开连接生命值：玩家可以从另一个玩家那里断开他们的生命值。
- 列出已连接的玩家：玩家可以查看他们连接的所有玩家。
- 清除连接：玩家可以清除所有生命值连接。
- 可配置设置：该插件允许配置各种设置，包括最大连接玩家数。
### **要求**
> Minecraft 服务器：与 1.8.x 到 1.21.x 版本兼容。
>
> Java：需要 Java 1.8 或更高版本。
>
> Spigot/Paper：该插件设计用于与 Spigot 或 Paper 服务器配合使用。
>
### 安装
1. 下载 HealthSync 插件 JAR 文件的最新版本。
2. 将 JAR 文件放入您的 Minecraft 服务器的 plugins 目录中。
3. 启动或重启服务器。
4. 插件将在首次运行时生成一个配置文件和一个数据文件。
### 配置
该插件附带一个配置文件（config.yml），允许服务器管理员自定义各种设置。 默认配置包括：
```
settings:
# 生命值同步设置
link-hunger: false # 如果您想连接饥饿度，请将其设置为 true
persistent-groups: true
group-death-sync: true
remove-on-disconnect: false
save-interval: 60 # 以秒为单位（1 分钟）
```
配置选项：
max-linked-players: 可以链接到单个玩家的最大玩家数。
auto-save: 是否在链接/断开玩家连接后自动保存数据。
debug: 启用调试日志以进行故障排除。
### 命令
以下命令在 HealthSync 插件中可用：
| 命令 | 描述 | 权限 |
|------------------|-----------------------------------------------|---------------------------|
| /healthsync | HealthSync 插件的主要命令 | healthsync.gui |
| /linkhealth <玩家> | 将您的生命值与另一个玩家连接 | healthsync.link |
| /unlinkhealth <玩家> | 从另一个玩家那里断开您的生命值 | healthsync.unlink |
| /listlinked | 列出您连接的所有玩家 | healthsync.list |
| /clearlinks | 清除所有生命值连接 | healthsync.admin.clear |
### 命令用法
| 用法 | 命令 | 描述 |
|------------------|-----------------------------------------------|---------------------------|
| 连接生命值 | /linkhealth <玩家> | 将您的生命值与指定的玩家连接。 |
| 断开连接生命值 | /unlinkhealth <玩家> | 从指定的玩家那里断开您的生命值。 |
| 列出已连接的玩家 | /listlinked | 显示您当前连接的玩家列表。 |
| 清除连接 | /clearlinks | 删除与您的玩家关联的所有生命值连接。 |
### 权限
以下权限由 HealthSync 插件使用：
| 权限 | 描述 |
|-------------------------------|--------------------------------------------------|
| healthsync.* | 授予访问 HealthSync 所有命令的权限 |
| healthsync.link | 允许将生命值与其它玩家连接 |
| healthsync.unlink | 允许从其它玩家那里断开生命值 |
| healthsync.list | 允许查看已连接的玩家 |
| healthsync.gui | 允许使用 GUI 界面 |
| healthsync.admin | 授予访问管理命令的权限 |
| healthsync.admin.clear | 允许清除所有生命值连接 |
| healthsync.admin.reload | 允许重新加载插件 |
| healthsync.admin.bypass | 阻止被其它玩家连接 |
### 数据管理
该插件使用 data.yml 文件来存储已连接的玩家数据。 首次运行插件时，该文件将自动创建。 数据文件的结构如下：
```
linked-players:
:
-
-
:
-
```
### 数据文件管理
- 插件在玩家连接或断开连接时会自动保存数据。
- 如果 _data.yml_ 文件丢失或损坏，插件将创建一个新的文件，其中包含一个空的 _linked-players_ 部分。
### 调试
该插件包含一个调试模式，可以在配置文件中启用。 启用后，插件会将额外的信息记录下来以帮助排除问题。
### 支持
如需支持，请访问我们的 [Discord 服务器](https://discord.gg/krcaTEK5VD) 以便提出任何错误或功能请求。
### 结论
**HealthSync 是一个强大而灵活的插件，通过允许玩家共享他们的生命值和饥饿度来增强 Minecraft 中的多人游戏体验。 凭借其易于安装和配置，它是任何服务器的宝贵补充。 享受与朋友连接您的生命值并共同制定策略！**