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/releases/tag/Tango
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__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 (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)

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, API Usage, 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)

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)

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

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.
If you're a developer using the API and/or addon system, prepare for breaking changes and read at least the "For Developers" section.
Casual users should be fine, as the plugin's config is updated automatically.

Enjoy!

HotFix for BetterHud 1.13.0+

Needed fix for users on 1.21.6+

• 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