onShopPurchased

Purpose

Triggered when a player purchases ownership of a shop. Use this hook to register businesses in MDT, log transactions, or update external systems.

When It Triggers

• Player completes shop purchase

• Ownership is transferred to the player

• Payment is processed

Parameters

Parameter	Type	Description
data.source	number	Player server ID who purchased
data.shopId	string	Unique shop identifier
data.shopType	string	Type of shop
data.shopName	string	Display name of the shop
data.ownerIdentifier	string	New owner's player identifier
data.ownerName	string	New owner's character name
data.purchasePrice	number	Amount paid for the shop
data.paymentMethod	string	'cash', 'bank', or 'society'
data.societyName	string	Society name if paid with society funds
data.shopLocation	vector3	Shop coordinates
data.timestamp	number	Server timestamp

Example

exports['sd-shops']:registerServerHook('onShopPurchased', function(data)
    -- Log business purchase
    print(('[BUSINESS] %s purchased %s for $%d'):format(
        data.ownerName, data.shopName, data.purchasePrice
    ))

    -- Register in MDT/business registry
    exports['your-mdt']:RegisterBusiness({
        owner = data.ownerIdentifier,
        ownerName = data.ownerName,
        businessName = data.shopName,
        businessId = data.shopId,
        location = data.shopLocation,
        purchasePrice = data.purchasePrice,
        purchaseDate = os.date('%Y-%m-%d %H:%M:%S', data.timestamp)
    })

    -- Send Discord notification
    exports['your-logging']:Log('business-purchase', {
        title = 'Shop Purchased',
        player = data.ownerName,
        identifier = data.ownerIdentifier,
        shop = data.shopName,
        price = data.purchasePrice,
        paymentMethod = data.paymentMethod
    })
end)