Detailed usage

1. Global prices

DT_MerchantPrice in Content/DataTable provides prices shared by stores. A store entry can use a global price or its own local price.

2. The subsystem

Accessing the subsystem

Use the Get_ADS_MerchantSubsystem function directly. It returns the central reference for stores, trades, prices, and saved state.nnGet ADS Merchant Subsystem

Functions

FunctionDetailed description
Can Open StoreChecks a store is available.
Buy From StoreRuns a purchase.
Sell To StoreRuns a sale.
Auto Sell ItemRuns an automatic sale.
Get Final PriceReturns the final display price.
Get Max ItemCalculates the highest possible quantity.

Event Dispatchers

DispatcherDetailed description
On BuyBroadcast after a purchase attempt.
On SellBroadcast after a sale attempt.
On Auto SellBroadcast after an automatic sale attempt.
On Store ChangedBroadcast after a store change.

3. Store Actor Component

Connecting the component

Add AC Merchant Store to every merchant actor. It registers automatically when the actor starts. Set its unique StoreID and configure its levels in Details.nnAdding the merchant component

4. Blueprint logic

A child of ADS Merchant Logic Base connects trades to your project inventory and currencies. A child of ADS Merchant Store Logic Base, assigned to StoreLogicClass, contains store-specific progression, donation, unlock, or promotion rules.

5. Enhanced Details panel

The enhanced Details panel avoids the tedious work of adding items one by one: it automatically adds every item from the selected DataTable and can filter them. To actually offer an item, simply enable its In Store checkbox.nnIt groups identity, DataTable and context selection, locks, and store levels. Purchase and sale lists use distinct color codes and clearly present each item, its global or local price, stock, promotion, and lock.

Identity and DataTable

Items to buy

Items to sell