Health-Sync Plugin
Overview
HealthSync is a Minecraft plugin designed to allow players to link their health and hunger levels with other players. This functionality enhances gameplay by enabling cooperative strategies and shared resources among players.Features
- Link Health: Players can link their health with another player.
- Unlink Health: Players can unlink their health from another player.
- List Linked Players: Players can view all players they are linked with.
- Clear Links: Players can clear all health links.
- Configurable Settings: The plugin allows configuration of various settings, including maximum linked players.
Requirements
Installation
- Download the latest version of the HealthSync plugin JAR file.
- Place the JAR file into the plugins directory of your Minecraft server.
- Start or restart the server.
- The plugin will generate a configuration file and a data file on first run.
Configuration
The plugin comes with a configuration file (config.yml) that allows server administrators to customize various settings. The default configuration includes:
YAML:
settings:
# Health sync settings
link-hunger: false # Set this to true if you want to link hunger
persistent-groups: true
group-death-sync: true
remove-on-disconnect: false
save-interval: 60 # In seconds (1 minute)Configuration Options :
max-linked-players: The maximum number of players that can be linked to a single player.
auto-save: Whether to automatically save data after linking/unlinking players.
debug: Enables debug logging for troubleshooting.
Commands
The following commands are available in the HealthSync plugin:| Command | Description | Permission |
|---|---|---|
| /healthsync | Main command for HealthSync plugin | healthsync.gui |
| /linkhealth <player> | Link your health with another player | healthsync.link |
| /unlinkhealth <player> | Unlink your health from another player | healthsync.unlink |
| /listlinked | List all players you are linked with | healthsync.list |
| /clearlinks | Clear all health links | healthsync.admin.clear |
Command Usage
| Usage | Command | Description |
|---|---|---|
| Link Health | /linkhealth <player> | Links your health with the specified player. |
| Unlink Health | /unlinkhealth <player> | Unlinks your health from the specified player. |
| List Linked Players | /listlinked | Displays a list of players you are currently linked with. |
| Clear Links | /clearlinks | Removes all health links associated with your player. |
Permissions
The following permissions are used by the HealthSync plugin:| Permission | Description |
|---|---|
| healthsync.* | Grants access to all HealthSync commands |
| healthsync.link | Allows linking health with other players |
| healthsync.unlink | Allows unlinking health from other players |
| healthsync.list | Allows viewing linked players |
| healthsync.gui | Allows using the GUI interface |
| healthsync.admin | Grants access to admin commands |
| healthsync.admin.clear | Allows clearing all health links |
| healthsync.admin.reload | Allows reloading the plugin |
| healthsync.admin.bypass | Prevents being linked by other players |
Data Management
The plugin uses a data.yml file to store linked player data. This file is automatically created upon the first run of the plugin. The structure of the data file is as follows:
YAML:
linked-players:
<player_uuid_1>:
- <linked_player_uuid_1>
- <linked_player_uuid_2>
<player_uuid_2>:
- <linked_player_uuid_3>Data File Management
- The plugin automatically saves data when players link or unlink.
- If the data.yml file is missing or corrupted, the plugin will create a new one with an empty linked-players section.
