---
type: User Story
title: "US-017: Expand a Pocket Base"
description: Let Pocket Base owners purchase unlimited levels that add permanent buildable terrain around their pocket world.
status: done
---

# US-017: Expand a Pocket Base

As a **Pocket Base owner**, I want to purchase additional buildable space so that my pocket world can grow with my projects.

## Acceptance criteria

- [x] Using `/basesettings pocket upgrade` after Pocket Base I purchases the next Pocket Base level.
- [x] Each additional level atomically charges a configurable currency and amount that default to 16 diamond blocks.
- [x] Insufficient funds or failed persistence or terrain generation does not consume currency or grant a level.
- [x] Each level adds 16 blocks on every side, producing Level I at 64 by 64, Level II at 96 by 96, Level III at 128 by 128, and size `64 + 32 × (level - 1)` thereafter.
- [x] Newly unlocked terrain has one grass layer over three dirt layers.
- [x] Expansion preserves all existing blocks, inventories, and entities in previously unlocked terrain.
- [x] Owners and visitors cannot place blocks outside the currently unlocked horizontal boundary.
- [x] Pocket Base progression has no plugin-configured level cap, subject only to Minecraft coordinate and integer limits.
- [x] Pocket Base levels, dimensions, contents, and build boundaries persist through restarts.

## Related

- [US-011: Configure and persist progression](us-011-configure-and-persist-progression.md)
- [US-015: Unlock a Pocket Base](us-015-unlock-a-pocket-base.md)
- [US-016: Build and use Pocket Base portals](us-016-build-and-use-pocket-base-portals.md)