SharedStats – Shared Health & Hunger Plugin

New features NEW Full DownedSession system — Downed players now have a red boss bar showing their name and remaining time before permanent death (30 seconds). The timer automatically pauses while a revive is in progress. DownedSession Camera shake on shared damage — A fake 0.001 damage is dealt to other players to trigger the screen shake animation without affecting their actual health. fakeDamage Alert sound when a downed player reconnects — When a downed player rejoins the server, an ender dragon growl sound is played for all online players and their downed timer is restarted. Reset confirmation menu — A confirmation sub-menu is now required before performing a full plugin reset from the admin menu. openResetConfirmMenu Spanish language (ES) — A third flag has been added to the language menu, with full ES translation support for per-player language selection. Notch Apple crafting recipe — A shaped recipe is now registered on startup: 8 gold blocks + 1 apple = enchanted golden apple. registerRecipes Improved death chest placement — The death chest now automatically moves out of lava or water by searching upward for a valid location. A sign with a countdown timer is placed on the side or top depending on surrounding blocks. Bug fixes FIX Revive: isBeingRevived state — The downed countdown no longer ticks while a revive is active. It correctly resumes if the revive is cancelled. The flag is properly reset in cancelRevive(). Backpack item removed when module is disabled — On login and respawn, if the backpack module is off, the backpack item is now properly removed from the player's inventory. removeBackpackItem Inventory sync source selection on respawn/login — The sync source check now uses the unified canSyncInv() helper instead of scattered manual conditions, preventing edge cases. Milk bucket consumption — The milk bucket clear-effect logic now uses isAfkOrDead() to properly skip AFK and dead players. PvP: revive cancelled when target takes damage — If the revive target receives damage, the healer's revive session is now correctly cancelled (in addition to the existing case where the healer takes damage). Refactoring REFACTOR Centralised helper methods — Three utility methods now replace duplicated inline checks scattered throughout the codebase. isRestricted() isAfkOrDead() canSyncInv() Inline field declarations — sharedTotalXP and isTeamWipeDeath are now initialised inline with their type declarations, reducing class boilerplate. ReviveSession cleaned up — The justification comment (per-player BossBar) has been removed; the class is now self-documenting through its usage. Active player list extraction — Repeated ad hoc loops are replaced by a dedicated getActivePlayers() method used throughout the tick loop. Performance PERF Downed boss bars sorted and capped — Boss bars are now sorted by remaining time (ascending) and only the first 3 are shown to non-downed players, preventing a cluttered HUD when multiple players are downed simultaneously. updateDownedBossBars Version logged on startup — The startup log now explicitly states SharedStats V5 to make version tracking easier in production.

New Features Progressive Revive System (BossBar) The revive mechanic has been completely reworked. Instead of an instant Shift+Right-Click, the healer must now hold Shift and continuously right-click the downed player for 5 seconds without moving. A green BossBar is displayed to all online players showing the revive progress in real time. The revive is immediately cancelled if the healer moves, walks more than 4 blocks away from the target, or receives any damage during the process. An action bar message notifies the healer upon interruption, along with a distinct sound feedback. PvP Toggle Module A new pvp module has been added. When disabled, all player-to-player damage is blocked at the lowest event priority, preventing any accidental friendly fire. The toggle is available both in the /menu GUI and via /all true|false. The setting persists across restarts via config.yml. Inventory Clear on Death Module (clearInvOnDeath) A new module clears the entire player inventory upon death, excluding the shared backpack slot. This module is independent of the death penalty and can be combined with it for a full hardcore experience. It is accessible in the GUI and via the /clearinv true|false command. Notch Apple Craft Recipe A custom shaped crafting recipe for the Enchanted Golden Apple has been re-added to the game. The recipe uses 8 Gold Blocks surrounding an Apple. The recipe is registered on startup using a NamespacedKey and only if it is not already present, preventing duplicate registration on reload. Full Plugin Reset with Confirmation A dedicated reset button (TNT item, slot 53) has been added to the /menu GUI. Clicking it opens a separate confirmation inventory with a YES (lime wool) and NO (red wool) option. Confirming the reset wipes all module states, resets team lives, max health, XP, downed players, the shared backpack contents, and all death scores. All online players have their max health restored to 20 and their backpack item removed. "Enable All" / "Disable All" GUI Buttons Two new buttons have been added to the bottom row of the /menu GUI: a lime dye to enable all modules at once, and a red dye to disable all. These dispatch /all true and /all false respectively and close the menu automatically with a distinct sound feedback for each action. Changes & Improvements GUI — Lore Descriptions on All Items Every toggle item in the /menu now displays a short description in its lore, explaining what the module does. Command hints (e.g. /lives <number>, /proximity <blocks>) are also shown directly in the lore of the relevant items, removing the need to guess available commands. GUI — Redesigned Layout The menu has been reorganised into cleaner thematic rows. Basic sharing modules (Health, Food, Oxygen, XP, Potions, Inventory, Backpack) occupy the second row. Hardcore mechanics (Lives, Revive, Death Penalty, Inventory Loss, UHC, Shared States, Proximity) occupy the third row. Additional options (AFK, PvP, Heart Buy) occupy the fourth row. Language flags are on the fifth row, and action buttons (Enable All, Disable All, Close, Reset) are on the bottom row. GUI — Toggle Sound Feedback Clicking a toggle in the menu now plays a pitch-adjusted sound: high pitch when enabling a module, low pitch when disabling. This gives clear audio confirmation of the action taken without relying solely on the colour change. GUI — Chat Confirmation Messages Every toggle now sends a formatted confirmation message in chat ([SharedStats] Module : ON/OFF) using a dedicated sendToggleMessage() helper, making it easier to track which modules are active when operating from the console or as a non-OP admin. Scoreboard — Tab List Sorting by Deaths The player tab list now sorts players by death count using a team-based sort (updateAllPlayersScores()). The player with the most deaths is highlighted in red in the tab list. Stale sort teams are automatically cleaned up to avoid scoreboard bloat. Scoreboard — Active Modules Summary in Tab Header The tab list header now displays a compact summary of all currently active modules (e.g. Health | Food | XP | Revive) in addition to the team lives counter. This gives players a constant at-a-glance overview of the current ruleset without opening the menu. Shared Backpack — Reduced to 9 Slots The shared backpack inventory has been reduced from 54 slots to 9 slots. This makes it a true quick-access pouch rather than a full secondary inventory, encouraging players to use it for emergency items only (totems, food, keys). The backpack title is properly localised and recreated on language change. Inventory Sync — Creative Mode Exclusion Players in Creative mode are now fully excluded from inventory synchronisation. They will neither send nor receive inventory updates, preventing accidental overwrite of their creative inventory when shared inventory is active. Inventory Sync — Improved Item Pickup Handling When shared inventory is active, item pickup is now intercepted at HIGHEST priority. The item is manually removed from the world and added to the picking-up player's inventory via a safeAddItem() method that gracefully overflows into the shared backpack, then drops to the ground as a last resort. This eliminates the desync that could occur when multiple players simultaneously picked up items near each other. Inventory Sync — Game Mode Change Sync A new PlayerGameModeChangeEvent listener automatically re-syncs the inventory when a player switches from Creative to Survival, ensuring they receive the current team inventory state immediately. Downed Immunity — Extended to 4 Seconds The post-downed immunity window has been extended from 2 seconds to 4 seconds, giving newly downed players more time to stabilise before taking further damage from environmental sources (lava, fall, suffocation). Movement Lock — Gravity Fix The frozen/downed movement lock now correctly allows vertical downward movement (falling). Players can no longer be soft-locked mid-air by the freeze mechanic; they will fall naturally while still being blocked from walking or jumping. Damage Action Bar — Reformatted Message The damage notification displayed on the action bar has been reformatted. Instead of §c-X | PlayerName, it now reads PlayerName lost X with proper localisation in all three languages (FR/EN/ES), making it easier to read at a glance. Bug Fixes · Fixed a case where the revive BossBar would not be removed if the healer disconnected mid-revive. · Fixed clearOtherInventories not correctly skipping Creative mode players, which could cause item loss when toggling shared inventory with a Creative player online. · Fixed updateAllPlayersScores not being called on join, causing the tab list sort to be stale for newly connected players until the next death event. · Fixed the shared backpack title not updating when switching language if a player had the backpack open, by forcefully closing all viewers before recreating the inventory. · Fixed the /all false command not setting pvpEnabled back to true and not setting clearInvOnDeath to false, leaving those modules in an inconsistent state after a bulk disable.

This major update focuses on fixing duplication exploits, ensuring full compatibility with PaperMC (1.21), and balancing the Hardcore / UHC modes. Backpack & Shared Inventory · [Major Fix] Slot 17 Anti-Duplication: Fixed a critical exploit where enabling the Backpack with a full shared inventory would multiply the item in slot 17 (e.g., wheat) by the number of connected players. Now, only the player activating the module "salvages" the item safely. · [Fix] Smart Deactivation: When disabling the shared inventory, the player executing the command now keeps their entire inventory, while other players' inventories are cleared. Previously, everyone's inventory was wiped out due to a synchronization delay. · [Aesthetic] Vanilla Backpack: The Backpack now uses its official BUNDLE item icon instead of a player head for a much better Vanilla feel. Revive System · [New] Death Timer (30 Seconds): When a player is downed, they now have exactly 30 seconds to be revived (Shift + Right Click) before dying permanently. · [New] Private Countdown: Downed players receive discreet countdown alerts in their private chat (30s, 20s, 10s, 5, 4, 3, 2, 1). This prevents global team chat spam. · [Balancing] 2-Second Immunity: Going down now grants a brief 2-second damage immunity. This prevents instant deaths if you fall into lava or get hit by a mob right as you are downed. · [Fix] Death Counting: If the 30-second timer expires and a player dies alone, only their personal death counter (Scoreboard) increases. The rest of the team is only penalized (group death) if there is a full Team Wipe (everyone downed at the same time). UHC Mode & Survival · [Major Fix] UHC Hunger Drain: Enabling UHC mode now properly disables the server's native NATURAL_REGENERATION gamerule. Food will no longer drain at lightning speed trying to heal blocked hearts; food is once again used strictly for sprinting/saturation. · [Improvement] /all true Command: Globally enabling all modules now displays a helpful reminder message with the customization commands (/lives <number> and /proximity <blocks>). Shared States (Fire & Freeze) · [Rework] 100% Visual Fire: If a player steps in fire, teammates will see the flames on their screen but will no longer take direct fire damage. As soon as the burning player jumps into water, the flames disappear instantly for everyone. · [Optimization] Extreme Responsiveness: The physical states engine now ticks every 0.1 seconds (instead of 1 second). Visual status sharing is now immediate. ️ Server Stability & PaperMC · [Silent Action Bar]: Damage notifications now use a native Action Bar method that is completely undetectable by the server console. This removes the giant middle-screen text and stops Operator chat spam. The display is now clean and minimalist: §c-2.5 | PlayerName. · [PaperMC Anti-Crash]: Fixed the fatal java.lang.NoClassDefFoundError: SharedStatsPlugin$1 crash linked to the revive timer. Counters have been rewritten using Lambda expressions to compile and run perfectly on modern PaperMC servers. · [Native Reloading]: The plugin no longer relies on custom reload commands or forces inventory closures during a server /reload. It now lets the Paper API manage memory natively, eliminating the risk of RAM leaks and inventory crashes.

Here is the summary of the major new features and fixes moving from the basic version to this ultimate release. NEW MECHANICS & MODULES · Total GUI Overhaul: No more tedious commands. Everything is now managed via an interactive visual menu (/menu) featuring a dynamic flag system for language selection. · UHC Mode Added: A new option to block natural health regeneration (from food/satiety). Healing is now only possible via potions and golden apples! · "Heart Shop" Module Added: Players can now buy back lost hearts (from Death Penalties) using Emeralds via /buyheart (or directly through the menu). · Physical Backpack Item: The backpack module now adds an actual "Bundle" item in slot 17 (top right) of your inventory. This item is indestructible, unmovable, and cannot be dropped upon death. · Smart Payment System: When buying hearts, the plugin first scans players' pockets, then automatically draws the remaining required Emeralds from the shared Backpack. · Full Multi-Language Support: Added Spanish. The /help sharedstats command is now intercepted and translated live based on the server's selected language. It also detects typos (like /help sharestats or /help ss). BUG FIXES & OPTIMIZATIONS · Totem Anti-Duplication Fix: Previously, using a Totem of Undying with shared inventory allowed allies to keep theirs. Now, an instant sync destroys the totem in everyone's inventory the exact millisecond it pops. · Death Penalty Fix (Offline Players): Players who were offline during a team wipe used to keep their hearts. The health variable is now global: upon login, the player's max health is instantly updated to match the team's real current hearts. · Backpack Data Security: Disabling the backpack in the menu removes the physical item from players to prevent access, but no longer deletes the virtual items. Your diamonds stay safely saved in the config.yml! · Custom Heads API Fix: Replaced Bukkit's unreliable Profile API with a pure Base64 string injection to guarantee that flag heads (FR, EN, ES) display perfectly on any server environment (Spigot/Paper 1.21). · Spigot Syntax Fixes: Fixed compilation errors related to SLOWNESS (replaced by SLOW) and satiety regeneration blocking SATIETY (replaced by SATIATED).

New features, check the plugin page. <3

BIG UPDATE AND FIX ISSUE

v1.3.1

Solved Golden Apple / Cactus / Totem of undying issue

Bug fix