Files
spigot-tree-feller/design/user-stories/us-004-control-personal-tree-felling.md
T

31 lines
1.7 KiB
Markdown

---
type: User Story
title: "US-004: Control personal tree felling"
description: Let players persistently enable or disable their own automatic tree felling.
status: done
---
# US-004: Control personal tree felling
As a **player**, I want to turn automatic felling on or off independently of my unlocks so that I remain in control of how I mine.
## Acceptance criteria
- [x] `/treefeller enabled <on|off>` enables or disables automatic felling for the issuing player.
- [x] `/treefeller enabled` without a value reports the player's current preference and whether an administrative lock currently overrides it.
- [x] The preference defaults to enabled for a player with no saved value.
- [x] Changing the preference does not alter species progress or earned unlocks.
- [x] Repeating the currently saved value is idempotent and reports that no change was needed.
- [x] The player receives clear confirmation after a successful change.
- [x] The saved preference survives logout and server restart.
- [x] `/treefeller` provides concise usage for `enabled`, `unlocked`, and `undo` without advertising inaccessible administrative commands.
- [x] Position-aware autocomplete suggests player subcommands and valid `on` or `off` values.
- [x] Player commands use player permissions that are distinct from `treefeller.admin`; possession of player permissions does not grant `/treefelleradmin` access.
## Related
- [US-002: View tree progress](us-002-view-tree-progress.md)
- [US-003: Fell unlocked trees](us-003-fell-unlocked-trees.md)
- [US-007: Administer Tree Feller](us-007-administer-tree-feller.md)
- [US-008: Configure and persist Tree Feller](us-008-configure-and-persist-tree-feller.md)