---
type: User Story
title: "US-015: Unlock a Pocket Base"
description: Let Base IV owners purchase a persistent private void world that serves as the foundation for portal access and expansion.
status: done
---

# US-015: Unlock a Pocket Base

As a **player with an established Base IV**, I want to unlock a persistent Pocket Base so that I can build in a personal space beyond the normal world.

## Acceptance criteria

- [x] Pocket Base progression requires an established Base IV.
- [x] `/basesettings pocket upgrade` unlocks Pocket Base I and is offered through contextual autocomplete.
- [x] Unlocking atomically charges a configurable currency and amount that default to 64 diamond blocks.
- [x] Insufficient funds or failed persistence or world creation does not consume currency or grant Pocket Base I.
- [x] Pocket Base I creates a persistent owner-specific void world keyed by the owner's UUID.
- [x] The initial platform is 64 by 64 blocks with one grass layer over three dirt layers.
- [x] The pocket world provides a safe arrival location and a generated return portal.
- [x] Pocket Base worlds, contents, ownership, and progression persist through reconnects, restarts, and normal-base relocation.
- [x] `/basesettings status` displays the current Pocket Base level and the next upgrade requirement.

## Related

- [US-008: Unlock Base IV visitor access](us-008-unlock-visitor-access.md)
- [US-009: View progression and notifications](us-009-view-progression-and-notifications.md)
- [US-011: Configure and persist progression](us-011-configure-and-persist-progression.md)
- [US-016: Build and use Pocket Base portals](us-016-build-and-use-pocket-base-portals.md)
- [US-017: Expand a Pocket Base](us-017-expand-a-pocket-base.md)
- [US-023: Craft and use a Pocket Base Keystone](us-023-craft-pocket-base-keystone.md)