dmg/spigot-creeper-fear
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

docs(design): define creeper aura plugin

Browse Source
This commit is contained in:
dmg
2026-08-08 13:44:14 -04:00
commit f9ad2d9461
10 changed files with 250 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
design/user-stories/us-002-unlock-creeper-aura-ranks.md
+41
View File
@@ -0,0 +1,41 @@
---
type: User Story
title: "US-002: Unlock Creeper Aura ranks"
description: Protect blocks and modify creeper damage according to a player's earned aura rank.
status: backlog
---
# US-002: Unlock Creeper Aura ranks
As a **player**, I want Creeper Aura to become stronger as I defeat creepers so that I progressively master their explosions.
## Default progression
| State | Required lifetime kills | Damage to protected player | Creeper block damage |
| --- | ---: | ---: | --- |
| Locked | 0–99 | 1× | Normal |
| Creeper Aura I | 100 | 3× | Prevented |
| Creeper Aura II | 200 | 2× | Prevented |
| Creeper Aura III | 300 | 1.5× | Prevented |
| Creeper Aura IV | 400 | 1× | Prevented |
| Creeper Aura V | 500 | 0.5× | Prevented |
| Creeper Aura VI | 600 | 0× | Prevented |
## Acceptance criteria
- [ ] A player unlocks ranks according to the configured cumulative kill thresholds.
- [ ] A player below rank I receives normal creeper explosion behavior.
- [ ] An aura activates when an unlocked player would have been hit by the creeper explosion, even when armor or another modifier would reduce the eventual damage to zero.
- [ ] An activated aura prevents that creeper explosion from breaking or removing blocks for everyone affected by the explosion.
- [ ] Other nearby players and entities continue to receive their normal creeper explosion effects unless they have their own aura damage modifier.
- [ ] The protected player's rank multiplier is applied to vanilla creeper explosion damage before armor, enchantments, resistance, and difficulty mitigation.
- [ ] At rank VI, the protected player's creeper explosion damage event is cancelled so that damage and knockback are nullified.
- [ ] Charged creepers obey the same aura rules while retaining their vanilla base explosion strength.
- [ ] Explosions from TNT, beds, respawn anchors, and non-creeper entities are unchanged.
- [ ] Simultaneous exposure of players with different aura ranks is deterministic and tested.
## Related
- [Track creeper defeats](us-001-track-creeper-defeats.md)
- [Configure aura progression](us-006-configure-aura-progression.md)
- [User-story catalog](index.md)