BodyHealth - Locational Health & Damage

- Added a raytracing.fix-rotation config option to fix imprecise mob rotations that caused raytracing to fail sometimes - Added a lenient-movement-restrictions config option (disabled by default), that makes the PREVENT_WALK and PREVENT_JUMP effects allow some mobility instead of completely preventing movement - Added a hide-potion-effects config option that disables ambient, particles and the effect icon for effects applied by BodyHealth - Added defaults for poison damage to the body-damage config section - Added more debug information for bypassing damage and regeneration to resolve permission problems more easily - Added heal-on-respawn and heal-on-full-health as new config options, controlling body part regeneration - Added a display.betterhud.enabled-only config option that only shows BodyHealth's HUD in worlds/regions where BodyHealth is enabled - Fixed BodyHealth not taking BetterHud's build-folder-location and pack-type config options into account - Fixed disabling the display.betterhud.as-default config option having no effect - Fixed a small formatting issue with debug messages

Here we go again, 5000 lines added, 500 removed... Official addons will be updated to work with this version right after this is released.

BodyHealth v4.0.0

Renamed 'BODY' (body part) to 'TORSO'. Your config, language files, the selected storage, and BetterHud's configuration will automatically be migrated to reflect that change, but if you are using body parts anywhere externally, you need to migrate that manually Retextured all HUD elements of the 'DAMAGED' state to match the quality standard imposed by the four other states Added Folia support! BetterHud should already work on Folia as-is, for PlaceholderAPI, you will need to use a fork that supports Folia, until the main version does: https://github.com/Folia-Inquisitors/PlaceholderAPI-Folia…<br> NOTE: On Folia, it is not possible to reliably remove all effects from a player on shutdown, because the global thread is no longer available. Instead, we store all currently active effects per player and remove them the next time the player joins. On PaperMC and its forks, you can toggle this behavior with a new remove-effects-on-shutdown setting in config.yml Added an optional 'enabled' property to permission overrides that allows you to disable them and disabled the default overrides Added a data command ('/bh data save/dump/erase/move') that allows for asynchronous data management and easy storage type changes Added HUD scaling! You can now scale BodyHealth's HUD with a new config option at display.betterhud.position.scale (default is 1.5) Added a debug command that allows toggling both debug modes, as well as dumping debug information that could be useful for diagnosing issues Added a translated variant of the state placeholder ('%bodyhealth_state_<part>_translated%') outputs new translations that may contain other placeholders and formatting Improved the default body-damage configuration to not apply the damage you take when dying to all of your body parts Improved BodyHealth's UpdateChecker to show name and current version in "You are running the latest version" messages Improved the default effect configuration further, aiming to showcase all effects while still making sense in a survival environment Improved tips at the end of config.yml to include instructions on how to merge BetterHud's pack with ItemsAdder for those who need that Improved Debug logging in AddonManager so you better understand what went wrong with an addon, if problems with one arise Fixed default prefix missing a formatting-reset at the end Fixed the UpdateChecker's first empty line not being shown in some consoles Fixed BodyHealth's calculations not considering the change in head height caused by sneaking Fixed some parts of the plugin still not using the by now no longer new, but still robust error logging logic Fixed some effects not being listed as ongoing, despite them being active (didn't matter before v4) Fixed the Japanese language translation (submitted by jekyllh, thank you!) Fixed many other small inaccuracies and updated many dependencies

For Developers

Renamed BodyPart.BODY to BodyPart.TORSO Renamed BodyHealthAddon#onAddonPreEnable to BodyHealthAddon#onAddonLoad (it is now called onLoad) Renamed BodyHealthAddon#onBodyHealthReload to BodyHealthAddon#onAddonReload Fixed missing @NotNull annotations in BodyPartHealthChangeEvent

Alright, buckle up...

BodyHealth v3.0.0

New official addon: [LocationalArmorAddon](https://modrinth.com/plugin/bodyhealthaddon-locationalarm… (BodyHealth v3.0.0+, Minecraft v1.21.3+) Added a %BodyPart% placeholder to the COMMAND and COMMAND_UNDO effects that translates into the BodyPart that caused the effect, so you can copy/paste the effect onto different parts Added a new update checker that checks for updates on Modrinth, works with dev versions and prereleases, and formats update notifications a bit nicer Added a new config option that allows you to chose whether to check for development versions and prereleases, or full releases only Added permission overrides to the body-health and body-damage configuration sections (examples are added to your config) Added a %bodyhealth_enabled% PAPI placeholder that returns true when BodyHealth is enabled for a player Added more robust error logging for throwables and error logging for failing math expressions Added new meta effects (DELAYED & REPEATING) to execute effects delayed and/or repeating Improved the default effect config to still use all effects there are, but while actually making sense in a survival environment, so it can now be used without changes (check it out [here](https://github.com/Mitality/BodyHealth/blob/a17a4cf3565c5… Improved MySQL and SQLite storage types to use HikariCP for extra performance and stability Improved various methods to be thread safe when used by multiple plugins/addons at the same time Improved debug logging to not only include the calling class, but now also the line of code Improved various comments within the plugin's source code and its configuration file Improved parsing of the body-damage section to warn users in case of invalid entries Improved meta effects to allow you to chain them together Fixed missing javadoc params in the BodyHealth and EffectHandler classes Fixed en-us being set as the default language, despite the file being named en.yml Fixed attribute modifiers being expected in one specific format, causing errors with other formats present Updated the following wiki entries: [Setup Guide](https://github.com/Mitality/BodyHealth/wiki/Setup), [API Usage](https://github.com/Mitality/BodyHealth/wiki/API), [Addons](https://github.com/Mitality/BodyHealth/wiki/Addons)

For Developers

Events

Added causing/underlying event to BodyPartHealthChangeEvent (retrieve with BodyPartHealthChangeEvent#getCause, can optionally be set via API) Fixed health value in BodyPartHealthChangeEvent#setNewHealth being set as an int instead of double

Effects

Added methods that let you register your own BodyHealthEffects via the API or directly within an addon's main class ([docs](https://github.com/Mitality/BodyHealth/wiki/API#effects))

API

Added way more methods to the BodyHealthAPI class to ensure you don't have to touch anything else in most cases (check it out [here](https://github.com/Mitality/BodyHealth/blob/main/src/main… Changed BodyHealthAPI#getInstance to BodyHealthAPI#getBodyHealthPlugin and BodyHealthAPI#reloadSystem to BodyHealthAPI#reloadBodyHealthPlugin Changed BodyHealthAPI to be object based, retrievable with BodyHealthAPI#getInstance

Addons

Overhauled the AddonFileManager class, simplifying its use, adding javadoc comments and adding a new method that lets you update yaml configurations with [BodyHealth's config updater](https://github.com/tchristofferson/Config-Updater) Overhauled the AddonManager class, also simplifying it, adding javadoc comments and adding logging that's up to standard with the rest of the plugin Added AddonDebug#logRaw for you to log something regardless of debug or dev mode being enabled Improved addon debug methods to also include logging for throwables and the calling line of code Fixed debug messages in the AddonManager class not logging enough information to tell what addon caused something

tl;dr:

This update includes a lot (and I mean A LOT) of things.<br>If you're a developer using the API and/or addon system, prepare for breaking changes and read at least the "For Developers" section.<br>Casual users should be fine, as the plugin's config is updated automatically.

Enjoy!

- Added a new config option that allows using the /kill command to kill players with the KILL_PLAYER effect as that's more consistent across different server software than using the API - Added meta effects WHEN_DAMAGED & WHEN_HEALED. These allow triggering effects only when conditions are met due to the player taking damage or regenerating. For example, when_damaged/sound/minecraft:entity.bogged.hurt at effects.BODY.INTERMEDIATE would trigger the sound when the state of your body changes from NEARLYFULL to INTERMEDIATE (damage), but NOT when it changes from DAMAGED to INTERMEDIATE (regeneration). - Categorized effects into persistent, one-time and meta effects - Improved effect keyword matching to allow case-insensitive identifiers - Updated validation methods to reflect the above - Corrected config comments

Advanced HUD positioning and more!

Added a new positioning option that allows you to specify an anchor point for BodyHealth's HUD (e.g. BOTTOM_LEFT). The HUD's position will always be relative to that anchor point, no matter the screen ratio and resolution, and the correct offsets are automatically calculated and applied for you. The anchor point therefore effectively changes the HUD's default position to one of nine possible places from where you can still move it in all directions with the offset values from the last update. Added a new option in the display section that automatically reloads BetterHud together with BodyHealth when enabled to instantly apply any changes there. Improved the PREVENT_JUMP and PREVENT_WALK effects to handle their attribute modifiers more consistently and hopefully never leave them applied under any circumstances ever again due to other plugins interfering with them. *Sidenote: When repositioning the HUD, always adjust the anchor point first and then use the offsets from last update if needed*.

A few things...

- Added SOUND effect to play sounds to only the target player - Added an option to disable BetterHud's entity popup feature - Added customizable offsets to BodyHealth's HUD (can be found in a new "position" category at display.betterhud) - Added yet another safety feature for attribute modifiers to ensure they are removed correctly in any case - Updated the effect config's default values to include the new SOUND effect and to match the newest version's syntax - Improved the three display.betterhud.disable options to re-enable the respective features when set to false - Improved the display.betterhud.as-default option to be reversible too - Fixed a few typos here and there (mostly internal + debug messages) - Removed fix-height option in favor of the new offsets

- Fixed an incompatibility with MyWorlds - Improved addon name extraction process to handle more complex names and version patterns - Fixed various typos in method descriptions, debug messages and config files

MiniMessage Support!

All messages (except debug messages) can now use MiniMessage formatting in addition to legacy color/formatting codes like &c (red). Some things like coloring the shadow of your text isn't possible in Minecraft, as this is handled client side, but you can now use all 16.7M colors in the RGB spectrum, add hover text to your messages, execute commands when someone clicks them and much more! : ![image](https://github.com/user-attachments/assets/d9c0b51e-67d3-… BodyHealth's default messages are still formatted using legacy codes due to them being much shorter.

Storage update! - Added SQLite storage type (new default) - Added MySQL storage type for multi server environments - Improved data handling to only load data needed at a given time, unloading and saving data for players when they disconnect, etc. With SQLite being the new default storage method, loading times should no longer scale with the number of players of which data is stored that much, resulting in loading times hundreds if not thousands of times faster than before, depending on how many entries there are in your YAML storage. Speaking of which, it is still available to use, as it's way more readable and therefore great for debugging. You can find storage settings in a new config section between the raytracing- and body-health settings within config.yml \:)

Changed Reorganized BodyHealth's config internally Fixed players with bypass permissions bypassing forced health changes<br> Improved HUD is now also shown to players in adventure mode<br> Improved Better handling and logging of regeneration caused by external plugins

Changed Assembled resource packs now have their own output folder and the existing packaging process of BetterHud's assets to a usable resource pack has been updated to:<br> ...fully support all versions from 1.21 upwards (no more red highlighted, outdated packs)<br> ...make it a little more presentable by reworking the pack's description and adding sort of a gradient<br> ...allow customizing the filenames of generated resource packs

Added/Fixed This update introduces a new config option at display.betterhud.fix-height (true/false) that attempts to fix an issue with BodyHealth's HUD being pushed down by other HUDs when activated. Do NOT activate this setting unless this happens to you.

Improved Body parts are now case-insensitive across all commands Fixed Mc 1.21.3 introduced a bug that renders it impossible to retrieve the block that damaged a player under certain circumstances (e.g. lava). BodeHealth now applies damage to all body parts in these cases, instead of spamming errors. ([PaperMC/Paper#11984](https://github.com/PaperMC/Paper/issues/11984))

Fixed players body parts not being healed after respawning under certain circumstances Previous behavior: Fully heal players 3 ticks after respawning if the system is enabled where they respawn. Revised behavior (now): Fully heal players body parts 1 tick after respawning regardless of the system being enabled at their respawn point

Fixed an issue with said compatibility leading to players being healed despite the command not even being registered by any plugin. Players are now only healed based on their increase in health, still supporting /heal <player>

After changing this effect from SEND_MESSAGE to just MESSAGE by accident, then pushing a fix for it that somehow didn't end up in any release and ultimately deciding to leave it at MESSAGE, we somehow ended up in a state where the default config generates a SEND_MESSAGE effect whilst the effect engine only knows MESSAGE.... Changed This update therefore adjusts the default configuration and the effect explanation to say MESSAGE instead of SEND_MESSAGE to finally end the confusion IF YOU CURRENTLY USE THE MESSAGE/SEND_MESSAGE EFFECT, MAKE SURE IT SAYS "MESSAGE"

Improved PAPI expansion is now persistent through PAPI reloads

Fixed Not exactly sure what combination of events triggered this, but in rare cases, an invalid PlayerInteractEvent was fired. If that should ever happen to you, this version of BodyHealth ensures it is unaffected by it.

Added This update lowers the default interval between repeated update checks to check once every 12 hours instead of hourly. It also adds a new config option for you to specify this interval yourself, as some servers restart twice a day and some weekly or less.

Fixed POTION_EFFECT effect not correctly parsing the potion effect's amplifier from your effect configuration and defaulting to 256 instead of 1. Please report stuff like this if you notice something is wrong. I won't hunt you down for invalid reports, I promise Changed (Internal) BodyHealthEffects.java is now split up into an EffectHandler and a unique effect class per effect, implements a new BodyHealthEffect interface. This change aims to make the code more readable and to make it easier for future addons to add their own effects. Improved Some code cleanup here and there to reach that A+ code quality on CodeFactor

Fixed typo in language reader leading to an error when executing "/bodyhealth add [...]" on a single body part (command even works with exception, but pls update anyway) Improved Corrected Japanese language translation [Corrections submitted by jekyllh (Discord)]

Improved Rewrote all existing commands to make arguments optional where possible. You can find the updated command syntax at the top of your config.yml instead of the old one. [Requested by Jekyll] Added a new command (/bodyhealth add [player] [body part] ) for you to be able to modify health values relatively. Improved Rewrote all TAB completions to make them truly intelligent, suggesting command syntax and possible inputs not only based on your position within the command, but also by analysing your partial inputs and comparing them to possible command completions Added Health values in commands are now taken as raw health values per default, meaning they are calculated into the corresponding percentages, taking your configuration per body part into account, but you can still modify health values directly in percent by appending a '%' sign to your value. The new TAB completions make sure you don't forget that option Added support for popular vanish plugins like PremiumVanish and SuperVanish, excluding vanished players from TAB completions. Added a new config option for you to choose if you also want to force-keep body parts at their new state for the set amount of seconds, that have been modified relatively (Good for excluding health related items, so it's default is "false"). Improved All language files have been updated to not only include the new command, but also a new format, containing definitions for body part names, to make smoother command responses possible. All natively supported languages are updated automatically, but if you made your own language configuration, you have to update it to the new format. Changed Moved language file generation and validation messages from normal- to dev-debug mode.

Fixed an issue with BodyHealth's DataManager that could lead to data not being correctly loaded for offline players

Improved Rewrote the language system to support multiple built-in languages. Added the top 30 languages (according to crowdin) as built-in languages, those being - Afrikaans - Arabic - Catalan - Chinese (simplified) - Chinese (traditional) - Czech - Danish - Dutch - English (as before, but filename changed to en.yml) - Finnish - French - German - Greek - Hebrew - Hungarian - Italian - Japanese - Korean - Norwegian - Polish - Portuguese - Portuguese (Brazilian) - Romanian - Russian - Serbian (Cyrillic) - Spanish - Swedish - Turkish - Ukrainian - Vietnamese _I only speak English and German fluently, so the other languages ​​have been translated by an AI. If you happen to speak one of them and you notice mistakes, feel free to reach out to me. You may also send me language configurations that aren't natively supported yet so I can change that for you :)_ Improved the effects system to only (re)calculate effects when necessary.

Fixed COMMAND_UNDO effect sometimes leading to effects not being removed properly on shutdown<br> Fixed potential double reloads of BetterHud under certain conditions - should only reload once, after adding/validating the display's content

Changed Commands are now handled by a CommandManager. This was done to deal with subcommands as individual classes, to enable addons to add their own. Added an addon system to extend the functionality of BodyHealth without relying on third-party plugins. In the future, new features may be published as addons, allowing you to choose which functionalities you want to include, optimizing server space and CPU usage. You may also write and publish your own addons. Here's a guide for doing so: [https://github.com/Mitality/BodyHealth/wiki/Addons](https… If you happen to write a cool addon, let me know and I'll feature it somewhere. Changed Data is now stored within a data folder, instead of directly within the plugin folder. To still use your current data file, move it to plugins/BodyHealth/data and name it bodyhealth.yml. Added A new language option will automatically be added to your config.yml which stays where it is now. It allows you to chose a language from a new language folder at plugins/BodyHealth/language to allow native support for more languages in the future. To keep your current language configuration, move it to plugins/BodyHealth/language and either name it en-us.yml, or set the language option in your config.yml to the name of your language file without the .yml. Feel free to add your own translations and submit them to me to be added natively.

Added an [API](https://github.com/Mitality/BodyHealth/wiki/API)<br> Improved numbers in debug messages to now also be limited to two decimal places

Improved compatibility with other plugins by respecting their handling of damage events more<br> Added a new config option to force-keep body parts that have been modified by a command at their new state to avoid immediate regeneration when the player has full health and to avoid potential issues with the effects system's timings in such cases<br> Improved The body parts suggested when using commands are now filtered to show only relevant parts. For example, after typing "/bh set testplayer h" it will only suggest "HEAD"<br> Improved When no player is provided for the heal command, now, the player who executed the command is healed

Fixed an exception on join for servers that don't use WorldGuard

Fixed an issue where overloaded servers would continuously reload BetterHud due to insufficient timings

Added a world blacklist that can be turned into a whitelist to disable- or only enable body health in specific worlds.<br> Added a WorldGuard hook: BodyHealth can now hook into WorldGuard and register a flag called 'bodyhealth' to enable/disable body health in specific regions. Added bypass permissions to control damage and regeneration per player and body part<br> Fixed the KILL_PLAYER effect, to (hopefully) no longer cause double deaths

Fixed an issue with asynchronous pack loading of BetterHud causing the BetterHud integration to initially fail on startup<br> Added additional information regarding ItemsAdder in config.yml and highlighted the fact that. by default, the display is shown to players in survival mode only

Added Metrics to enhance the plugins development in the future Changed Numbers in command responses are now limited to 2 decimal places

Changed the appearance of the in-game display and resource pack icon for smoother color transitions