onUpgradePurchased

Purpose

Triggered when a shop upgrade is purchased. Use this hook to track business investments and log upgrades.

When It Triggers

• Owner purchases a shop upgrade

• Payment is processed and upgrade is applied

Parameters

Parameter	Type	Description
data.source	number	Server ID
data.shopId	string	Unique shop identifier
data.shopName	string	Display name of the shop
data.upgradeId	string	Upgrade identifier
data.upgradeName	string	Upgrade display name
data.upgradeDescription	string	What the upgrade does
data.previousLevel	number	Level before purchase
data.newLevel	number	Level after purchase
data.cost	number	Amount paid
data.paymentMethod	string	'society', 'cash', or 'bank'
data.purchasedBy	string	Name of purchaser
data.purchasedByIdentifier	string	Identifier of purchaser
data.upgradeEffects	table	What the upgrade changes
data.timestamp	number	Server timestamp

Example

exports['sd-shops']:registerServerHook('onUpgradePurchased', function(data)
    -- Log upgrade
    print(('[UPGRADE] %s purchased "%s" (Level %d -> %d) for $%d at %s'):format(
        data.purchasedBy, data.upgradeName,
        data.previousLevel, data.newLevel,
        data.cost, data.shopName
    ))

    -- Send Discord notification
    exports['your-logging']:Log('upgrade-purchased', {
        shop = data.shopName,
        upgrade = data.upgradeName,
        previousLevel = data.previousLevel,
        newLevel = data.newLevel,
        cost = data.cost,
        purchasedBy = data.purchasedBy
    })

    -- Track for economy
    exports['your-economy']:TrackBusinessInvestment(data.shopId, data.cost)
end)