Shop settings

CoinsShopSettings is the shop catalog. It does not contain the price or rewards of each product; it references the bundle assets that the coins shop displays.

• Watch Ad Bundle — bundle granted after a successful rewarded ad;

• Shop Bundles — purchasable bundles displayed in the shop.

The order of Shop Bundles is the display order in the coins shop. Remove a bundle from this list to hide it without deleting its asset.

The asset is:

Assets/HomeDesignMatch3Kit/Resources/Settings/ShopSettings/CoinsShopSettings.asset

The referenced product IDs must match the products configured in the Unity IAP provider. Test both the purchase flow and the rewarded-ad flow on a device or supported test environment.

Coin bundles

Coin bundles are ShopBundleScriptable assets whose main reward is the Coins resource. The included project examples are stored in:

Assets/HomeDesignMatch3Kit/Resources/Settings/ShopSettings/CoinsBundle*.asset

Typical coin bundle fields are:

• Bundle Name — internal or display name, for example 100 Coins;

• Pack Elements — the coin pack item and the number of coins granted;

• Product ID — the Unity IAP product assigned to the bundle;

• Price — fallback price shown in the Editor and when a localized store price is unavailable;

• View Prefab — UI prefab instantiated as the shop row;

• Rewarded Ad Reference — leave empty for a paid bundle.

For a coin bundle, add a PackElementScriptable whose Resource is Coins, then set its quantity in Pack Elements. The shop uses the first coin entry to calculate the main quantity displayed for the bundle.

Create or edit a coin bundle

1. Select an existing CoinsBundle*.asset, or create a Shop Bundle asset from Assets > Create > HomeDesignMatch3Kit > Shop > Bundle.

2. Set Bundle Name.

3. Add the coin PackElementScriptable to Pack Elements and set the quantity.

4. Assign a unique Product ID that exists in the Unity IAP configuration.

5. Set Price and assign the correct View Prefab.

6. Add the bundle to CoinsShopSettings > Shop Bundles.

7. Test that the displayed amount, localized price, purchase, and reward are correct.

Coin bundles can contain additional pack elements, but keep the main coin entry clear so that the shop quantity label remains meaningful.

Shop bundle settings

Shop bundle assets define individual entries used by the coins shop. A shop bundle can contain coins, boosters, lives, or other PackElementScriptable rewards. The same asset type is used for coin bundles; coin bundles are simply configured with a Coins reward as their primary content.

• Bundle Name — display name;

• Pack Elements — resources and quantities granted by the bundle;

• Product ID — Unity IAP product reference;

• Price — price displayed by the shop;

• View Prefab — visual representation of the bundle in the shop;

• Rewarded Ad Reference — rewarded ad used for ad-based bundles;

• Badge Type — Most Popular, Best Deal, or Hidden;

• badge sprites and text materials — visuals used for the selected badge type.

Shop bundle types

Paid shop bundle

A paid bundle requires:

• a Product ID that matches a store product;

• a Price used as the fallback display price;

• a View Prefab containing the supported shop-bundle UI;

• one or more entries in Pack Elements.

When a player completes the purchase, the configured pack elements are granted and the shop popup closes.

Watch-ad bundle

The free watch-ad bundle is assigned to CoinsShopSettings > Watch Ad Bundle and normally contains:

• Product ID left empty;

• Price set to a descriptive value such as FREE;

• Rewarded Ad Reference assigned to a rewarded ad;

• Pack Elements containing the reward, usually coins;

• a View Prefab containing a RewardedButtonHandler.

The reward is granted only after the rewarded ad completes successfully. The view prefab must be compatible with the ShopBundle component.

Non-consumable bundle

For a non-consumable product such as No Ads, assign a non-consumable Product ID. After the product is recorded as purchased, the corresponding shop item is hidden on subsequent shop openings.

Bundle badges

Set Badge Type to:

• Most Popular — displays the most-popular badge;

• Best Deal — displays the best-deal badge;

• Hidden — hides the badge.

Assign the matching badge sprite and text material when using a visible badge. Badge text uses the localization keys MOST_POPULAR and BEST_DEAL.

Add a shop bundle to the shop

1. Create or edit the ShopBundleScriptable asset.

2. Configure its pack elements, product information, price, and view prefab.

3. Add the asset to CoinsShopSettings > Shop Bundles.

4. Place the list in the desired display order.

5. Verify that the view prefab contains a ShopBundle component.

6. Test the item in Play Mode and then in the store's test environment.

Paid bundles require a valid Product ID and a matching product configuration in the store dashboard. Use Rewarded Ad Reference only for ad-based bundles.