# HealthSync<\/p>\n
 –(1.21.11)-green.svg)<\/p>\n
## \ud83c\udd95 Version 0.3 – World Sync Control
\n* **Added World Restriction System**: Control which worlds health-sync is active in.
\n* **Added Sync Modes**: Choose between `PAUSE` and `KICK` when players enter restricted worlds.
\n* **Added Anti-Heal Logic**: Automatically forces player stats to match the group upon returning from a safe world.
\n* **Bug Fixes**: Improved listener reliability across multiple world environments.<\/p>\n
**HealthSync** is a comprehensive Minecraft plugin that transforms cooperative gameplay by allowing players to link their vital stats\u2014Health, Hunger, and Effects\u2014into a unified “Group” system. Damage taken by one is shared by all. If one eats, everyone is fed. Survival becomes a true team effort.<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83d\udd17 Dynamic Group Linking ### \ud83e\udde0 Smart Synchronization ### \ud83c\udf0d World Restriction Sync ### \u2696\ufe0f Anti-Exploit “Smart Respawn” ### \ud83d\udee1\ufe0f Robust & Stable ## \ud83d\udee0\ufe0f Installation<\/p>\n 1. Download the `HealthSync.jar` file. ## \u2699\ufe0f Configuration<\/p>\n The `config.yml` allows deep customization of the sync mechanics:<\/p>\n “`yaml # Maximum players allowed in a single group # Enable GUI for management effect-sync: # NEW: World Restriction Settings ## \ud83c\udfae Commands & Permissions<\/p>\n ### Player Commands<\/p>\n | Command | Alias | Description | Permission | ### Admin Commands<\/p>\n | Command | Description | Permission | ### Permissions Nodes<\/p>\n * `healthsync.*` – Grant all permissions (Default: OP) ## \ud83c\udfae Enhance Your Experience * **\ud83c\udf92 Sync Inventory**: Share items, tools, and resources instantly in real-time. **Combining both plugins creates the ultimate cooperative survival challenge!**<\/p>\n ## \ud83e\udd1d Support<\/p>\n Found a bug or have a suggestion? Join our support community Discord Server.<\/p>\n","protected":false},"excerpt":{"rendered":" Health-Sync — Link hearts, hunger, and effects with your entire squad! Damage is shared instantly\u2014if one takes damage, everyone feels it. The ultimate Health Share plugin for cooperative survival and hardcore challenges.<\/p>\n","protected":false},"featured_media":80059,"template":"","meta":{"_minecraft_slug":"health-sync","_minecraft_project_id":"ZOKLevpf","_minecraft_author":"UG88","_minecraft_license":"MIT","_minecraft_downloads":1973,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"health-sync.zip","_minecraft_size_bytes":190464,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T06:19:43.207046Z","_minecraft_date_created":"2025-02-09T02:31:10.234520Z","_minecraft_date_modified":"2026-02-28T16:35:32.592495Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/health-sync","_minecraft_icon_attachment_id":80059,"_minecraft_imported_at":"2026-06-04T14:44:43+00:00","_minecraft_import_hash":"26fd57b39d011a26a387ed05511f54fa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,90,127,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-80058","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n* **Squad-Based System**: Players form groups with an Owner and Members.
\n* **Invitation Logic**: No more force-linking. Send invites via `\/linkhealth
\n* **Group Management**: Use the interactive GUI (`\/healthsync`) to manage members, kick players, or leave groups.<\/p>\n
\n* **Shared Health**: All damage is synchronized instantly. If a member takes damage, everyone feels it.
\n* **Shared Hunger & Saturation**: Keep your squad fed! Food eaten by one player contributes to the hunger bars of all linked members.
\n* **Effect Sharing**: Potions, Golden Apples, and negative effects are shared across the link.
\n* **Expanded Command Suite**: The `\/linkhealth` command has been overhauled with new subcommands:
\n * `\/linkhealth create [name]`: Create a new group (optional name).
\n * `\/linkhealth invite
\n * `\/linkhealth accept`: Accept a pending invitation.
\n * `\/linkhealth deny`: Deny a pending invitation.
\n * `\/linkhealth leave`: Leave your current group.
\n * `\/linkhealth delete`: Disband your group (Owner only).
\n* **Experience Sync**: (Optional) Share XP levels and progress for shared enchanting sessions.<\/p>\n
\n* **Per-World Control**: Use `enabled-worlds` and `disabled-worlds` to white\/blacklist sync areas.
\n* **PAUSE Mode**: Syncing is frozen for players in safe worlds. Upon returning to a survival world, their stats “snap” back to match the group immediately.
\n* **KICK Mode**: Players are automatically removed from their group if they enter a restricted world.
\n* **Anti-Heal Protection**: Prevents players from healing in safe worlds and bringing that health back into the group link.<\/p>\n
\n* **No Free Heals**: Mechanics prevent the “Death\/Respawn Loop” exploit.
\n * If a linked player dies and respawns, they do **not** come back with full health if their team is injured.
\n * They respawn with the **exact health and hunger** of their surviving teammates, ensuring the pressure of the fight is maintained.
\n * Standard respawn logic applies only if the entire team wipes.<\/p>\n
\n* **Recursion Protection**: Advanced guarding prevents infinite damage loops or server crashes from rapid sync events.
\n* **Disconnect Handling**:
\n * If a group owner disconnects, ownership is automatically transferred to the next active member.
\n * If a group becomes empty, it automatically disbands to save resources.<\/p>\n
\n2. Place it in your server’s `plugins` folder.
\n3. Restart your server.
\n4. Configure `config.yml` to your liking (optional).<\/p>\n
\nsettings:
\n # Enable or disable hunger synchronization
\n link-hunger: true<\/p>\n
\n max-linked-players: 5<\/p>\n
\n gui:
\n enabled: true
\n update-interval: 20<\/p>\n
\n # Enable sharing of potion effects
\n enabled: true<\/p>\n
\nworlds:
\n # PAUSE – Freeze sync but stay in group. KICK – Remove from group on world change.
\n restriction-mode: “PAUSE”
\n enabled-worlds:
\n – world
\n – world_nether
\n – world_the_end
\n disabled-worlds:
\n – spawn_world
\n“`<\/p>\n
\n| :— | :— | :— | :— |
\n| `\/healthsync` | `\/hs` | Opens the Link Management GUI. | `healthsync.gui` |
\n| `\/linkhealth
\n| `\/unlinkhealth [player]` | | Unlink yourself or kick a member (if owner). | `healthsync.unlink` |
\n| `\/listlinked` | | View your current group members and stats. | `healthsync.list` |<\/p>\n
\n| :— | :— | :— |
\n| `\/healthsync reload` | Reloads the configuration file. | `healthsync.admin.reload` |
\n| `\/clearlinks` | Forcefully dissolves ALL groups on the server. | `healthsync.admin.clear` |<\/p>\n
\n* `healthsync.admin.bypass` – Prevents the player from being invited or linked.<\/p>\n
\nWant to take the challenge to the next level? Pair **Health-Sync** with **InventorySync**!<\/p>\n
\n* **\ud83d\udee1\ufe0f Sync Armor**: Equip one, equip all! Armor updates for everyone.
\n* **\u2728 Sync XP**: Level up together and share the experience progress.<\/p>\n