# Changelog - SharedHealthAndHunger v1.5 ### 🚀 What's New & Fixed in v1.5 * 👁️ **Instant Death-Point Spectator Respawn:** No more flying across the entire map after dying! When spectator mode is active (`respawn-spectator: true`), clicking "Respawn" puts you right back at the exact spot where you died instead of sending them to world spawn or your bed. You can immediately continue watching your team right in the heat of the action. * 🕳️ **Void Fall Protection for Spectators:** Falling into the void in The End or deep below bedrock no longer glitches your camera or drops you into endless darkness. The plugin catches you safely and keeps your spectator floating safely just above the bottom of the world. * 📍 **Bed & Spawn Overwrite Protection:** Fixed an issue where beds or respawn anchors could occasionally hijack your respawn point. You are always guaranteed to stay right with your teammates. * 🌐 **Smooth Cross-Dimension Transitions:** Dying in the Nether or The End now smoothly switches your perspective without screen stutter, camera desync, or dimension loading errors. * 🍂 **Minecraft & Purpur 26.3 Verified:** Fully verified, optimized, and ready to roll on the latest Minecraft and Purpur 26.3 update alongside WorldReset.

# Changelog - SharedHealthAndHunger v1.4 ### 🚀 New Features * 🛡️ **Totem of Undying Support:** Totems held in the main hand or off-hand now trigger properly! When a player takes fatal damage, the totem resurrects them and synchronizes the restored health and golden hearts to the whole team instead of ending the game prematurely. * 🌍 **WorldReset Integration:** Full native compatibility with [WorldReset](https://modrinth.com/plugin/worldreset): * Players waiting in the Limbo lobby are automatically protected from shared damage and hunger loss. * Death detection cleanly triggers WorldReset's automated resets (`/wr death`) and records tracking. * Team health and hunger are seamlessly restored when entering a freshly generated world. * 📱 **Bedrock & Geyser Crossplay Support:** Full compatibility for players joining from consoles, mobile devices, and Windows 10: * Automatic heart scaling (`geyser-health-scale: true`): When team max health exceeds 10 hearts (20 HP), Bedrock players receive visual scaling to keep the health bar clean and prevent it from overflowing the screen. * Automatically detects Bedrock players via Floodgate or Geyser. * 💥 **Visual Hurt Feedback (No Armor Damage):** Teammates now see and feel pain feedback (camera tilt and red flash) when a partner takes damage, without damaging armor durability or canceling invulnerability frames. * 🍗 **Accurate Hunger & Eating Sync:** Overhauled hunger synchronization to match vanilla mechanics. Eating food now instantly syncs hunger and saturation across all teammates without jitter or desync. * 📊 **Enhanced Action Bar Notifications:** Action bar messages showing who took damage and current team health now render smoothly across both Java and Bedrock editions. * 📈 **bStats & FastStats Metrics Integration:** Added anonymous server metrics via [bStats.org](https://bstats.org) and [FastStats.dev](https://faststats.dev) to monitor active installations and Minecraft versions. Both services are included side-by-side to compare their telemetry data and results. ### 🐛 Fixes & Improvements * 🛑 **Fixed Infinite Death Loop:** Fixed an issue where dying with spectator mode disabled could crash the server or trap players in an endless death loop. * 🎯 **Fixed Rapid Combat Hits:** Fixed an issue where rapid attacks and combo hits were silently dropped or ignored. All damage is now reliably shared. * 🛡️ **Fixed Armor Degradation:** Teammates no longer lose durability on chestplates, leggings, and boots when a partner takes environmental damage like falling, fire, or lava. * ⚔️ **Fair Gamemode Switching:** Players switching from Creative or Spectator back to Survival no longer get a free full heal; health and food properly synchronize to the current team state. * 🌐 **Minecraft 1.21 – 26.2 Compatibility:** Updated for the latest Minecraft and Paper versions with improved overall stability and performance.

* Added website link to `plugin.yml`.

### 📝 Changelog v1.2 **🔐 Granular Permissions & Security Update** This update introduces a highly requested feature: **Granular Permissions**. Server administrators can now fine-tune exactly which commands players or moderators can access. * **Granular Control:** You no longer need to give full access to the `/sh toggle` or `/sh set` commands. You can now grant permission for specific sub-commands only. * *Example:* Give a moderator permission to toggle `health` sync, but deny them permission to change `maxhealth` or `hungermult`. * **Smart Tab Completion:** The auto-completion system has been updated. Players will **only** see suggestions for commands they actually have permission to use. If they don't have `sharedhealth.respawn`, they won't see it in the list. * **Wildcard Support:** Added support for wildcard permissions (e.g., `sharedhealth.toggle.*` grants access to all toggle options). **📋 New Permission Nodes:** * **Toggle Options:** * `sharedhealth.toggle.health` * `sharedhealth.toggle.food` * `sharedhealth.toggle.effects` * `sharedhealth.toggle.actionbar` * `sharedhealth.toggle.attackerfeeldamage` * `sharedhealth.toggle.respawn` * `sharedhealth.toggle.*` (All of the above) * **Set Values:** * `sharedhealth.set.maxhealth` * `sharedhealth.set.hungermult` * `sharedhealth.set.*` (All of the above) * **Admin (Full Access):** `sharedhealth.*` --- **Short summary for version description:** *Implemented granular permissions for all sub-commands and smart tab completion filtering.*

### 📝 Changelog v1.1 **🐛 Bug Fixes & Improvements** * **Gamemode Switch Sync:** Added a listener for `PlayerGameModeChangeEvent`. * **Auto-Heal on Survival:** Now, when a player switches their gamemode to **Survival** (e.g., using `/gamemode survival` or other plugins), they will automatically: * Receive the correct Max Health (from config). * Be healed to full HP. * Have their Food Level and Saturation fully restored. * **Why?** This fixes the issue where players returning from Spectator mode manually (without using `/sh respawn`) would sometimes keep old/empty stats.

### ✨ Complete Feature List * **Shared Health & Hunger:** All players share a single HP bar and Food level. * **Shared Potion Effects:** Any potion effect (buff or debuff) applied to one player is applied to everyone. * **Physical Damage Feedback:** When a player takes damage, teammates feel a "phantom" hit (screen flash & slight knockback). * **Action Bar Alerts:** Real-time notifications above the hotbar showing who took damage and how much. * **Game Over System:** If health drops to zero, all players are immediately switched to Spectator Mode. * **Smart Join:** New players automatically sync to the team's current health/food. * **Game Management:** Added `/sh respawn` to fully reset the game, heal players, and teleport to spawn. * **Adjustable Difficulty:** Configure Max Health and Hunger Drain Speed (Metabolism). * **Multi-Language:** Full support for **English** and **Polish**, switchable in-game.