---
type: User Story
title: "US-001: Track creeper defeats"
description: Record persistent current-tier progress from creeper kills attributable to the player.
status: done
---

# US-001: Track creeper defeats

As a **player**, I want my qualifying creeper kills recorded so that my Creeper Aura progression persists.

## Acceptance criteria

- [x] A creeper kill attributable to a player adds one point to that player's current-tier progress.
- [x] Direct melee kills and indirect kills attributable to the player, including projectiles and the player's tamed wolves, count.
- [x] A single creeper death cannot award progress more than once.
- [x] A creeper explosion awards one point to every player the explosion would have hit, including when armor or aura immunity reduces final damage to zero.
- [x] Each affected player receives at most one point from a given creeper explosion, while multiple affected players can each receive a point.
- [x] Explosion-earned progress produces the same progress and rank-up feedback as a credited kill.
- [x] Progress is stored using the player's UUID rather than their mutable name.
- [x] The player's current rank and current-tier progress are persisted separately.
- [x] Lifetime creeper-kill totals are not retained.
- [x] Rank VI does not accumulate further progress.
- [x] Progress survives logout, server restarts, and player-name changes.
- [x] Progress updates are persisted without blocking the Minecraft server thread on slow storage work.
- [x] Missing or invalid persisted data is handled safely and reported to server administrators.

## Related

- [Creeper Aura ranks](us-002-unlock-creeper-aura-ranks.md)
- [Plugin architecture](../architecture.md)
- [User-story catalog](index.md)