> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/plugins/warehousepage.md).

# WarehousePage

Controls how many warehouse pages each account has and the maximum unlock cap. Players purchase additional pages by consuming Vault Expansion Certificates.

## File Location

```
Data/Plugins/Items/WarehousePage.xml
```

Loaded once at GameServer startup. Supports hot reload via plugin admin command.

## Schema

```xml
<WarehousePage>
    <Settings DefaultPages="..." MaxPages="..." />
</WarehousePage>
```

## Attributes

| Attribute      | Type | Default | Range                | Effect                                                                                                                                              |
| -------------- | ---- | ------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DefaultPages` | int  | `1`     | 1 and up             | Pages every account has free. Values below `1` are clamped to `1`                                                                                   |
| `MaxPages`     | int  | `10`    | `DefaultPages`-`255` | Hard ceiling on total pages per account. Values below `DefaultPages` are clamped up to `DefaultPages`; values above `255` are clamped down to `255` |

If the config file is missing or lacks the `WarehousePage` root node, defaults of `DefaultPages=1, MaxPages=10` apply.

## How It Works

* Every account starts with `DefaultPages` usable pages
* Consuming a Vault Expansion Certificate (item index 14,163) unlocks one additional page and immediately persists the account's expansion count to the DataServer
* Unlock is account-wide, shared across every character on that account
* When the account is already at `MaxPages`, further Certificates are rejected with a notice and the item is not consumed
* Guild warehouse view ignores this config: it always reports a single page while the guild warehouse is loaded

## Cross-File Dependencies

| Setting                          | Related in                                                   |
| -------------------------------- | ------------------------------------------------------------ |
| Vault Expansion Certificate item | [Item.xml](/docs/data/item/item.md) entry for index `14,163` |
| Storage persistence              | Handled by the DataServer warehouse persistence layer        |

## Common Issues

* **Players cannot unlock more pages** - account already at `MaxPages`, or `14,163` is not defined in Item.xml so the item never reaches the handler
* **New accounts have too many pages** - `DefaultPages` higher than intended; lower and reload (existing accounts are unaffected because page count is derived, not stored as a total)
* **Shipped defaults too restrictive** - raise `DefaultPages` to 2 or 3 to give every account more baseline storage
* **Guild warehouse shows only one page** - expected; multi-page is disabled for guild warehouse regardless of config