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

1. Download the latest version of the HealthSync plugin JAR file.

2. Place the JAR file into the plugins directory of your Minecraft server.

3. Start or restart the server.

4. 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!