> 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/cashshop.md).
# CashShop.xml
Defines every item, package, and banner shown in the in-game cash shop. Covers three currencies (WCoin C, WCoin P, Goblin Points), category hierarchy, per-product options, and time-boxed banners.
## File Location
```
Data/CashShop/CashShop.xml
```
Loaded once at GameServer startup. Changes require a restart.
## Structure
```xml
[` entries pointing at the actual items.
| Attribute | Type | Default | Effect |
| -------------- | --------------- | ------------ | ---------------------------------------------------------------------------------------------------- |
| `Category` | int | *(required)* | `Seq` of the owning category |
| `BaseIndex` | int | *(required)* | Package identifier, part 1. Unique per shop |
| `MainIndex` | int | *(required)* | Package identifier, part 2 |
| `Name` | string | *(required)* | Display name |
| `Description` | string | *(empty)* | Tooltip text |
| `ItemIndex` | int | *(required)* | Primary item index shown as the package icon |
| `CoinIndex` | `508`/`509`/`0` | `0` | Currency used. Must match the client's coin-type field in the purchase packet or the buy is rejected |
| `CoinValue` | int | `0` | Price in that currency |
| `BonusGP` | int | `0` | Extra Goblin Points credited on purchase |
| `ProductType` | enum | `170` | Usually `170` for packages |
| `SalesFlag` | enum | `182` | `182` = purchasable |
| `GiftFlag` | enum | `184` | `184` = giftable |
| `CapsuleFlag` | enum | `177` | `176` marks as a random-contents capsule |
| `EventFlag` | enum | `200` | `199` = event-only |
| `DeleteFlag` | enum | `181` | `181` = active, `180` = soft-deleted |
| `CashType` | int | `0` | Internal cash type classification |
| `CashTypeFlag` | int | `668` | Internal cash type flag |
### `][` children
Inside ``, each `][`.
| Attribute | Type | Default | Effect |
| ------------------------ | ------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `BaseIndex` | int | *(required)* | Product identifier part 1 |
| `MainIndex` | int | *(required)* | Product identifier part 2 |
| `Name` | string | *(required)* | Display name |
| `ItemIndex` | int | *(required)* | Item index from `Item.xml` |
| `ItemLevel` | int | `0` | Item +level at grant |
| `CoinValue` | int | `0` | Price. Only charged when the product is purchased standalone; package-referenced products apply this as the per-product cost inside the package flow and must be balanced against the `` `CoinValue` |
| `ProductType` | enum | `140` | See [Product types](#product-types) |
| `PropertyType` | int | `142` | Internal property flag |
| `StorageGroup` | int | `0` | Inventory storage bucket |
| `Opt1` / `Opt2` / `Opt3` | int | `0` | Item options 1-3 |
| `NewOpt` | int | `0` | Modern item option |
| `SetOpt` | int | `0` | Set option |
| `HarmonyOpt` | int | `0` | Jewel of Harmony option |
| `OptEx` | int | `0` | Excellent option bitmask |
| `Sock1` ... `Sock5` | int | `255` | Socket options (255 = empty socket slot) |
| `Quantity` | int | `0` | Quantity granted per purchase |
| `Duration` | int | `0` | Duration in seconds for time-limited items (pairs with `ProductType="140"`). `0` = permanent |
## Banner Attributes
Promotional tiles shown at the top of the shop.
| Attribute | Type | Effect |
| ----------- | ------ | -------------------------------------------------- |
| `Seq` | int | Unique banner ID |
| `Name` | string | Internal name |
| `ImageFile` | string | Client-side image filename |
| `LinkURL` | string | Click destination URL |
| `Order` | int | Sort order |
| `Direction` | int | Rotation direction for animated banners |
| `StartDate` | string | `YYYY-MM-DD` start date. Banner hidden before this |
| `EndDate` | string | `YYYY-MM-DD` end date. Banner hidden after this |
## Examples
{% tabs %}
{% tab title="Simple standalone product" %}
{% code title="CashShop.xml fragment" %}
```xml
```
{% endcode %}
Standalone +0 Magic Backpack for 690 WCoin(C). ProductType `139` = Eternity (permanent).
{% endtab %}
{% tab title="Package referencing products" %}
{% code title="CashShop.xml fragment" %}
```xml
][` pairs does not match any `` entry. Extras beyond the per-package ref cap are dropped silently at load
* **Gift button greyed out** - `GiftFlag="185"` (not giftable) on the package
* **Category empty in-game** - no packages or products reference that `Seq`, or `OpenFlag` is not `201`
* **Event category always visible** - `EventFlag` on category should be `199` for event-only visibility; setting `199` alone does not schedule show/hide
* **Banner never appears** - current date is outside `StartDate`..`EndDate` range, or the `ImageFile` is missing from the client
* **"Loaded 0 categories"** - XML syntax error, or root node is not ``. The loader logs category / package / product / banner counts at startup
* **Wrong currency charged** - the client sends a `CoinIndex` with the purchase; the server rejects the buy if it does not match the package's `CoinIndex`
]