HealthSync

HealthSync is a comprehensive Minecraft plugin that transforms cooperative gameplay by allowing players to link their vital stats—Health, Hunger, and Effects—into a unified "Group" system. Damage taken by one is shared by all. If one eats, everyone is fed. Survival becomes a true team effort.

---

TESTED MINECRAFT VERSION (1.18.x-1.21.11)

NOT FULLY TESTED ON OTHER MINECRAFT VERSIONS

✨ Key Features

🔗 Dynamic Group Linking

• Squad-Based System: Players form groups with an Owner and Members.
• Invitation Logic: No more force-linking. Send invites via /linkhealth <player> which expire automatically after 60 seconds if ignored.
• Group Management: Use the interactive GUI (/healthsync) to manage members, kick players, or leave groups.

🧠 Smart Synchronization

• Shared Health: All damage is synchronized instantly. If a member takes damage, everyone feels it.
• Shared Hunger & Saturation: Keep your squad fed! Food eaten by one player contributes to the hunger bars of all linked members.
• Effect Sharing: Potions, Golden Apples, and negative effects are shared across the link.
• Experience Sync: (Optional) Share XP levels and progress for shared enchanting sessions.

⚖️ Anti-Exploit "Smart Respawn"

• No Free Heals: Mechanics prevent the "Death/Respawn Loop" exploit.
  • If a linked player dies and respawns, they do not come back with full health if their team is injured.
  • They respawn with the exact health and hunger of their surviving teammates, ensuring the pressure of the fight is maintained.
  • Standard respawn logic applies only if the entire team wipes.

🛡️ Robust & Stable

• Recursion Protection: Advanced guarding prevents infinite damage loops or server crashes from rapid sync events.
• Disconnect Handling:
  • If a group owner disconnects, ownership is automatically transferred to the next active member.
  • If a group becomes empty, it automatically disbands to save resources.

🛠️ Installation

1. Download the HealthSync.jar file.
2. Place it in your server's plugins folder.
3. Restart your server.
4. Configure config.yml to your liking (optional).

⚙️ Configuration

The config.yml allows deep customization of the sync mechanics:

settings:
  # Health sync settings
  link-hunger: true
  persistent-groups: true
  group-death-sync: true
  remove-on-disconnect: false
  save-interval: 60  # In seconds (1 minute)
  
  # Maximum number of players that can be linked together
  max-linked-players: 5

  # Allow OPs to override player bypass permissions when inviting
  ops-override-bypass: true
  
  # Whether to sync saturation along with hunger
  sync-saturation: true

  # Whether to sync effects
  effect-sync:
    enabled: true 
  
  # Health sync behavior
  damage-distribution: "EQUAL"  # EQUAL, PERCENTAGE, or DIRECT
  minimum-health: 1.0  # Minimum health after damage distribution
  
  # Auto-save settings
  auto-save:
    enabled: true
    interval: 300  # Save interval in seconds (5 minutes)
    silent: true   # Whether to show save messages

  # World settings
  worlds:
    enabled-worlds:
      - world
      - world_nether
      - world_the_end
    disabled-worlds: []

🎮 Commands & Permissions

Player Commands

Command	Alias	Description	Permission
/healthsync	/hs	Opens the Link Management GUI.	healthsync.gui
/linkhealth create [name]		Create a new health-linked group.	healthsync.link
/linkhealth invite <player>		Invite a player to your group.	healthsync.link
/linkhealth accept		Accept a pending group invitation.	healthsync.link
/linkhealth deny		Deny a pending group invitation.	healthsync.link
/linkhealth leave		Leave your current group.	healthsync.link
/linkhealth delete		Disband your group (Owner only).	healthsync.link
/listlinked		View your current group members and stats.	healthsync.list

Admin Commands

Command	Description	Permission
/healthsync reload	Reloads the configuration file.	healthsync.admin.reload
/clearlinks	Forcefully dissolves ALL groups on the server.	healthsync.admin.clear

Permissions Nodes

• healthsync.* - Grant all permissions (Default: OP)
• healthsync.admin.bypass - Prevents the player from being invited or linked.

🤝 Support

Found a bug or have a suggestion? Join our support community or open an issue on GitHub.