WorldHealthGuard
Running a Minecraft server that blends LifeStealZ mechanics with traditional vanilla gameplay can quickly turn into a balancing nightmare. Players who have grinded for extra hearts in a lifesteal world shouldn't lose that progress when they step into a hub, and duels shouldn't permanently strip someone's hard-earned health. That's exactly the problem WorldHealthGuard solves. This lightweight add-on acts as a bridge between LifeStealZ and your multi-world setup, ensuring heart counts stay consistent and fair across every dimension.
What WorldHealthGuard Does
At its core, WorldHealthGuard is a smart health manager. It monitors which world a player is in and applies the correct heart cap based on your configuration. In worlds you designate as vanilla-capped, players are limited to 10 hearts for both display and combat. Their actual LifeStealZ heart count is safely stored in the background, untouched. The moment they leave that world, their true hearts are restored. This means a duel in an arena world won't permanently reduce someone's health, and a hub world won't show inflated health bars that break the vanilla feel.
Beyond simple capping, the add-on actively blocks LifeStealZ heart items from spawning or being picked up in protected worlds. It also integrates with combat-log plugins to ensure that if a player disconnects during a fight, the heart lock remains active until they safely return. Optional hooks for Duels match start and end events, along with WorldGuard region flags like whg-cap-health, whg-protect-storage, and whg-block-heart-items, give you granular control over exactly where and how these rules apply.
How It Works Behind the Scenes
WorldHealthGuard operates on a simple per-world mode system. In your config.yml, you assign each world either a LIFESTEAL or VANILLA_CAP mode. Lifesteal worlds run LifeStealZ normally with no interference. Vanilla-cap worlds enforce the 10-heart limit, lock the player's stored hearts, and prevent heart item interactions. When a player moves from a vanilla-cap world back to a lifesteal world, the add-on reapplies their locked heart count instead of whatever broken snapshot might have been saved during the transition. This prevents the common bug where a player's health gets permanently reduced after a duel or a quick visit to spawn.
For server owners who rely on the foxygame.net launcher to manage their modpacks, adding WorldHealthGuard is a breeze. The launcher's one-click install feature automatically resolves dependencies and ensures you're running the correct version for your server's Paper or Purpur setup, so you can focus on gameplay rather than manual file juggling.
Installation and Setup
Requirements
Before you download WorldHealthGuard, make sure your server meets these prerequisites. The add-on is built for Paper or Purpur 1.21.x and requires Java 21. LifeStealZ is a soft dependency — you only need it if you want the storage protection and world-change reapply features to work. Without LifeStealZ, the plugin still caps hearts and blocks heart items, but it won't manage stored heart data.
How to Install
Installing WorldHealthGuard for Minecraft is straightforward. First, grab the latest JAR file from the official source. Place it into your server's plugins folder. If you're using the foxygame.net launcher, the process is even simpler: just search for WorldHealthGuard in the add-on catalog and click install — the launcher handles version compatibility and auto-updates so you never miss a patch. After the file is in place, restart your server or run a reload command. The plugin will generate a default config.yml with sensible settings, and any old v1 configs will be upgraded automatically on first boot.
Basic Configuration
Open the config.yml to define which worlds use which mode. A typical setup might look like this:
- lifesteal world: mode
LIFESTEAL(no restrictions) - hub world: mode
VANILLA_CAPwith max hearts 10, storage protection on, heart item blocking on - duels world: mode
VANILLA_CAPwith the same protections
You can also tweak per-world settings like max-hearts, protect-storage, and block-heart-items to fine-tune behavior. For advanced control, use the WorldGuard region flags to apply these rules only to specific areas within a world.
Commands and Permissions
WorldHealthGuard keeps administration simple with a few essential commands:
/whg reload— reloads the configuration without restarting the server./whg inspect [player]— shows the player's current world mode, stored hearts, and whether a lock is active./whg unlock <player>— clears a stuck heart lock (admin only).
These commands give you full visibility into how the add-on is handling each player, making troubleshooting quick and painless.
Compatibility and Real-World Use
WorldHealthGuard was originally developed for the inkwell.net.au server network, which runs a complex setup of LifeStealZ, multiple worlds, and duels. It's designed to prevent the exact headaches that come from heart desyncs and accidental permanent health loss. While it's built with Paper and Purpur 1.21.x in mind, it may work on other compatible forks, but always test on a staging server first. The add-on is not guaranteed to play nicely with every plugin combination under the sun, so a quick trial run is recommended.
For server admins who want to offer both lifesteal and vanilla experiences without breaking player progression, WorldHealthGuard for Minecraft is a must-have. It keeps your lifesteal worlds dangerous and rewarding while ensuring that duels, hubs, and event areas remain fair and fun. The heart-locking mechanism is robust, and the optional WorldGuard region flags let you protect specific zones with surgical precision.
Why You Need WorldHealthGuard
Without a tool like this, server owners often resort to clunky workarounds — clearing player data on world change, using separate inventories, or simply accepting that duels will ruin lifesteal progress. WorldHealthGuard eliminates all that. It seamlessly preserves heart counts, prevents item exploits, and integrates with your existing plugins. The result is a polished, professional experience for your players, where they can enjoy both the thrill of lifesteal and the safety of vanilla-capped arenas without ever noticing the complex logic running in the background.
If you're ready to download WorldHealthGuard and bring order to your multi-world server, head to the official repository. The add-on is lightweight, well-documented, and actively maintained. With a few lines of config, you'll have a server that handles heart management intelligently, leaving you free to focus on building the best possible experience for your community.