SimpleRewind

# SimpleRewind

SimpleRewind gives players a second chance when lethal damage would kill them. If they have enough XP, time freezes, a short cinematic rewind plays, and the player is returned to a previous position with 1 heart.

## Features

- Automatic rewind on lethal damage.
- XP cost, cooldown and rewind duration.
- Server-side validation for XP and cooldowns.
- World freeze during the rewind sequence.
- Safe-position search before teleporting back.
- Dangerous-position history filtering.
- Optional anti-abuse rules for void deaths, PvP and totems.
- Optional Echo Shard activation modes.
- Cooldown/ready HUD outside the rewind sequence.
- Rewind HUD with default and minimal themes.
- Cinematic sounds, particles, death echo and lingering trail.
- Client-side translucent player ghost instead of an armor stand marker.
- In-game client config screen.
- Optional Mod Menu integration.
- Admin commands for debugging, status and config reload.

## Controls

The config screen is available as a keybind:

- `SimpleRewind -> Open SimpleRewind config`

The key is unbound by default so it does not conflict with existing controls.

If Mod Menu is installed, the same config screen is also available from the Mod Menu config button.

## Commands

Requires gamemaster permissions:

- `/rewind reload` reloads `config/simplerewind.properties`.
- `/rewind status` prints the active server config.
- `/rewind debug trigger` manually triggers a rewind for testing.
- `/rewind debug fill_xp` grants the XP needed for testing.

## Configuration

The config file is created automatically at:

```text
config/simplerewind.properties
```

Available options:

```properties
historySize=11
preset=balanced
defaultDurationSeconds=10
xpCost=30
cooldownSeconds=30
activationMode=xp
persistHistory=false
hudEnabled=true
requiredPermissionLevel=0
safeRewindPosition=true
avoidDangerousHistory=true
disableInVoid=true
disableInPvp=false
respectTotems=true
hudTheme=default
hudAlpha=170
deathAlertStyle=custom
particlesEnabled=true
particlesIntensity=1
```

Notes:

- `historySize` controls how many previous player positions are stored.
- `preset` supports `casual`, `balanced`, `hardcore` and `cinematic`.
- `activationMode` supports `xp`, `item` and `xp_item`; item modes consume 1 Echo Shard.
- `requiredPermissionLevel > 0` limits automatic rewinds to operators.
- `safeRewindPosition` searches nearby for a solid floor and two free blocks before teleporting.
- `avoidDangerousHistory` avoids saving positions in lava, fire, cactus, magma, powder snow, liquids, blocked spaces or unsupported air.
- `disableInVoid` lets void deaths stay lethal instead of rewinding into unsafe space.
- `disableInPvp` disables automatic rewinds caused by player attacks.
- `respectTotems` lets vanilla Totems of Undying trigger before SimpleRewind.
- `hudTheme` supports `default` and `minimal`.
- `deathAlertStyle` supports `custom`, `vanilla` and `both`.
- `particlesIntensity` supports `1`, `2` and `3`.

## License

MIT