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
Minecraft Server: Compatible with versions 1.8.x to 1.21.x.
Java: Requires Java 1.8 or higher.
Spigot/Paper: The plugin is designed to work with Spigot or Paper servers.
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:
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:
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.
Debugging
The plugin includes a debug mode that can be enabled in the configuration file. When enabled, the plugin will log additional information to help troubleshoot issues.
Support
For support, please visit our Discord Server on issue for any bugs or feature requests.
Conclusion
HealthSync is a powerful and flexible plugin that enhances the multiplayer experience in Minecraft by allowing players to share their health and hunger levels. With easy installation and configuration, it is a valuable addition to any server. Enjoy linking your health with friends and strategizing together!
