API Reference

​

Public Functions

FMerchantSnapshot OpenVendor(APlayerController* Player);

FPurchaseQuote QuotePurchase(APlayerController* Player, UItemDataAsset* ItemData, int32 QtyRequested);

• Player: Player controller requesting quote
• ItemData: Item to purchase
• QtyRequested: Desired quantity

• ✓ Player proximity
• ✓ Item exists in stock
• ✓ Stock availability (if finite)
• ✓ Player has sufficient funds
• ✓ Player inventory has space

void Server_ConfirmPurchase(APlayerController* Player, UItemDataAsset* ItemData,
                           int32 Qty, float ClientQuotedPrice, FGuid Nonce);

• Player: Player executing purchase
• ItemData: Item being purchased
• Qty: Quantity to purchase
• ClientQuotedPrice: Total from quote (for validation)
• Nonce: Unique nonce from quote (for idempotency)

1. Deduct currency from player
2. Add items to player inventory
3. Reduce stock (if finite)
4. Log transaction
5. Mark nonce as processed
6. Broadcast events

FSellQuote QuoteSell(APlayerController* Player, UItemDataAsset* ItemData, int32 QtyOffered);

• ✓ Player proximity
• ✓ Merchant accepts item type
• ✓ Player owns sufficient quantity

void Server_ConfirmSell(APlayerController* Player, UItemDataAsset* ItemData,
                       int32 Qty, float ClientQuotedPrice, FGuid Nonce);

1. Remove items from player inventory
2. Add currency to player
3. Apply replenishment logic (if configured)
4. Log transaction
5. Mark nonce as processed
6. Broadcast events

FRestockResult RestockNow();

• Sets all CurrentStock = MaxStock
• No-op if bHasStock = false
• Can be called by admin/scripts/cron
• Logs restock event
• Broadcasts events

​

Utility Functions

FStockItem* FindStockItem(UItemDataAsset* ItemData);

int32 GetCurrentStock(UItemDataAsset* ItemData) const;

bool WillBuyItem(UItemDataAsset* ItemData) const;

float GetItemSellPrice(UItemDataAsset* ItemData, const FStockItem* StockItem = nullptr) const;

float GetItemBuyPrice(UItemDataAsset* ItemData, const FStockItem* StockItem = nullptr) const;