WarehousePage.xml
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#
<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
DefaultPagesusable 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 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, or14,163is not defined in Item.xml so the item never reaches the handler - New accounts have too many pages -
DefaultPageshigher than intended; lower and reload (existing accounts are unaffected because page count is derived, not stored as a total) - Shipped defaults too restrictive - raise
DefaultPagesto 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