Soul Debt

# Soul Debt v3.0.0 ## Highlights - Complete UI/UX rework for stored lives. - Soul Debt stored lives are now fixed at a maximum of 10. - Each protected death consumes exactly 1 stored life. - Soul Apples can no longer be consumed when the player already has 10 stored lives. - Death penalties now correctly distinguish item loss, XP loss, and combined item + XP loss. ## HUD and Visuals - Removed the old HUD that displayed a heart icon with a number. - Removed the extra standalone heart bar from the mod. - Stored lives now appear as blue borders directly on the vanilla Minecraft heart bar. - Each blue border represents 1 stored life, up to a maximum of 10. - The borders now better follow vanilla heart animations, including low-health shaking and regeneration jumps. - The HUD remains hidden in Creative, Spectator, and when the game GUI is hidden. - Added custom sprites for blue heart borders and their pulse variant. ## Stored Life Rules - `max_lives` was removed from the generated config. - `lives_consumed_per_death` was removed from the generated config. - Old saves with more than 10 stored lives are automatically clamped to the new limit. - The amount of lives granted by Soul Apples remains configurable, but it can never exceed the internal 10-life cap. - Soul Apple consumption messages now show only the real amount of lives gained. ## Soul Apples - The item name was simplified: - before: "Soul Apple (+1 Life)" - now: "Soul Apple" - If the player already has 10 stored lives, Soul Apple use is blocked before consumption. - When blocked, the apple is not consumed, no success effect is played, and the stored-life counter is unchanged. - Added a warning message when stored lives are already full. ## Penalties and Feedback - Fixed the case where a player lost XP but received item-loss feedback. - Deaths without stored lives now correctly report: - items lost only; - XP lost only; - both items and XP lost; - no eligible penalty. - HUD, chat, sounds, and particles now use separate effects for each penalty type. - Death messages are now more robust and match the penalty that was actually applied. ## TOML Configuration - Added the `[messages]` section. - Added `enable_client_chat_messages`, allowing Soul Debt chat messages to be disabled for players. - Chat messages can be disabled without affecting HUD, sync, sounds, particles, or internal rules. - Generated TOML string lists are now written vertically for easier reading and editing. - Old keys from the `[lives]` section are ignored and removed when the config is rewritten. ## Compatibility - Existing configs continue to load. - Old maximum-life and death-cost values no longer affect the mod. - Existing players with stored lives above the limit are automatically clamped to 10. - The protected item list still works and is now easier to edit in the generated TOML file.