KnockedBack/changelog.md

# Changelog

All notable changes since version 1.0.0 are documented in this file.

## Unreleased

### Added
- Owned pets and configured modded followers now enter a saved knocked state on lethal combat damage; players can help them recover with H.
- Added the help-up progress bar when a friendly NPC is reviving the player.
- Added achievements for being rescued by an NPC, owned pet, friendly villager, or iron golem.
- Added separate configuration for mob execution time, executor movement, and knocked-player movement.
- Added configurable NPC help-up behavior for owned pets, friendly villagers, golems, and allowlisted modded NPCs.
- NPC helpers only begin a rescue when they have no hostile target and no living threats remain nearby.

### Fixed
- Improved multiplayer target selection for execute, carry, and help-up interactions so the nearest valid knocked player is selected instead of an arbitrary player.
- Added same-dimension and range validation for ongoing player execution and help-up interactions.
- Broadcast carry mount and dismount passenger updates to tracking clients so other players see carry state changes correctly.
- Cleaned up carry, help-up, mob execution, and player execution state during recovery, respawn, and logout.
- Prevented player execution, mob execution, help-up, and carry states from competing for the same knocked player.

## 1.6.0

### Added
- Added a Help Up feature that lets players revive knocked players by holding the help-up key.
- Added configurable help-up options for enabling the feature, help-up duration, and recovered health amount.
- Added help-up progress display support using the existing execution progress overlay.
- Added advancements for helping up players and being helped up.

### Changed
- Improved execution handling and validation for multiplayer interactions.
- Updated network protocol and client/server progress packets to support multiple progress action types.

### Fixed
- Added missing validation checks around execution state transitions.

## 1.5.3

### Fixed
- Fixed a bug where leaving and rejoining the game could leave knocked state persisting into another save or session after disconnect.

## 1.5.2

### Added
- Added a configuration option to remove potion effects that are not listed in the knocked-effect list while a player is knocked.

## 1.5.1

### Fixed
- Fixed execution and carry cleanup to prevent stuck execution or carry states when conditions change mid-action.

## 1.5.0

### Added
- Added configuration options for mob execution allowlists.
- Added configuration options for potion effects applied while a player is knocked.
- Added a master toggle for mob executions.

### Fixed
- Stabilized knocked-state handling around mob execution and recovery.

## 1.4.x

### Added
- Added player animation library integration.
- Added prone knocked pose animations.
- Added execution animations for executors and other observing clients.
- Added executor id synchronization with execution progress packets.
- Added a damage type tag for damage that bypasses the knockdown mechanic.
- Added additional damage tags for knockdown bypass behavior.

### Changed
- Switched carried knocked player pose to the riding pose.
- Improved local knocked swim animation handling.
- Updated execution animation behavior.

### Fixed
- Fixed mob execution timer and player animation synchronization.
- Fixed player animator integration issues.
- Fixed knocked pose reset issues.
- Fixed a null pointer issue in mob kill handling.

## 1.3.x

### Added
- Added common configuration support.
- Added configurable knocked duration, execution time, and totem behavior.
- Added hostile and aggressive neutral mob execution behavior.
- Added German and English translation support.
- Added parameterized translatable player messages.

### Changed
- Updated the mod for the 1.3.0 and 1.3.1 version line.
- Improved gravity handling while players are knocked.
- Refactored player-facing messages to use translation keys and parameters.

### Fixed
- Fixed death logic issues around knocked players.
- Fixed duplicated player messages.

## 1.2.x

### Added
- Added carrying for knocked players with the carry key.
- Added execution indicator and progress display for executors and knocked players.
- Added cancellable player executions.
- Added gripping progress behavior for mob executions.
- Added first-person rendering handling so carried player models are hidden from the carrier's own view.

### Changed
- Paused the knocked recovery timer while a player is being carried.
- Adjusted execution timing and mob execution delay for balance.
- Refactored mob execution handling and knocked countdown logic.

### Fixed
- Fixed dropping carried players.
- Fixed items and XP not dropping correctly when a knocked player is killed.
- Fixed execution progress bar issues.
- Fixed mob release behavior so player state updates correctly.
- Fixed mob kill attempt cleanup for specific players.

## 1.1.x

### Added
- Added early quality-of-life improvements for the knocked state.
- Added behavior where damage resets knocked time.

### Fixed
- Fixed several early knocked-state and multiplayer interaction bugs.