PurchaseResultModal — Animated purchase result UI for Roblox

PurchaseResultModal is a lightweight client-side Luau module for showing animated success or failure feedback after a purchase flow resolves.

The module creates a result card at runtime, animates its status icon and gradient, and closes it automatically or in response to player input. It presents the result your game provides; it does not determine whether a transaction succeeded.

Quick example

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PurchaseResultModal = require(
	ReplicatedStorage.Packages.PurchaseResultModal
)

local modal = PurchaseResultModal.new()

if purchaseSucceeded then
	modal:ShowSuccess()
else
	modal:ShowFailure()
end

-- Reuse the modal for later results. Call modal:Destroy() when it is no longer needed.

When no Parent is supplied, the generated ScreenGui is placed in the local player's PlayerGui.

🚀 Features

• Show success and failure results with separate icons and color gradients
• Animate the result card, status icon, and gradient shine
• Automatically close after a configurable delay
• Allow click or tap dismissal
• Override the auto-close duration for each presentation
• Replace an active result safely without stale timers closing the new one
• Respect Roblox reduced-motion settings
• No external runtime dependencies

🛠️ Installation

ModuleScript

Place init.luau in a client-accessible ModuleScript, for example:

ReplicatedStorage
└── Packages
    └── PurchaseResultModal
        └── init.luau

Require and construct it from a LocalScript:

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PurchaseResultModal = require(
	ReplicatedStorage:WaitForChild("Packages"):WaitForChild("PurchaseResultModal")
)

local modal = PurchaseResultModal.new()

Wally

Add the package to your project's wally.toml:

[dependencies]
PurchaseResultModal = "biotoxin495/purchase-result-modal@1.0.0"

Construct the controller on the client.

Basic usage

Pass the result from your own purchase flow to the modal:

if purchaseSucceeded then
	modal:ShowSuccess()
else
	modal:ShowFailure()
end

You can choose the time a result stays open for one presentation:

modal:ShowSuccess({
	AutoCloseDuration = 5,
})

Set the duration to 0 to leave the result open until the player dismisses it or your code calls Close():

modal:ShowFailure({
	AutoCloseDuration = 0,
})

The package does not call MarketplaceService, listen to remotes, or decide whether a purchase succeeded. Do not show a failure result when a player merely cancels a purchase prompt unless that is the experience you want.

---

API reference

PurchaseResultModal.new(config?) -> PurchaseResultModal

Creates the controller and its generated ScreenGui. The UI is parented to config.Parent when provided, or to the local player's PlayerGui by default. Create the controller on the client.

Configuration

All fields are optional.

Per-presentation options currently support AutoCloseDuration:

modal:Show("Success", {
	AutoCloseDuration = 4,
})

modal:Show(status, options?)

Shows a result. status must be "Success" or "Failure". Showing a new result replaces any currently active presentation.

modal:Show("Success")
modal:Show("Failure", { AutoCloseDuration = 4 })

modal:ShowSuccess(options?)

Convenience method for modal:Show("Success", options).

modal:ShowFailure(options?)

Convenience method for modal:Show("Failure", options).

modal:Close(immediate?)

Closes the current result with the slide-up animation. Pass true to close immediately:

modal:Close(true)

modal:IsOpen() -> boolean

Returns whether a result is currently active.

modal:GetStatus() -> "Success" | "Failure" | nil

Returns the active result status, or nil when no result is open.

modal:Destroy()

Cancels owned tasks and tweens, disconnects input, destroys internal events, and removes the generated UI. A destroyed controller cannot be reused.

Signals

modal.Opened:Connect(function(status)
	print("Opened:", status)
end)

modal.Closed:Connect(function(status)
	print("Closed:", status)
end)

Opened fires when a presentation begins. Closed fires when its closing transition finishes.

Replacement behavior

Each presentation cancels the previous result's auto-close timer, icon and gradient tasks, closing task, and active tweens. An earlier result therefore cannot close a result shown afterward:

modal:ShowSuccess()

task.wait(0.5)
modal:ShowFailure()

Notes

• The default card is square, centered on screen, and includes an aspect-ratio constraint.
• The success and failure gradients use separate built-in color sequences and share the same shine timing.
• The invisible DismissArea captures click/tap input so dismissal does not fall through to underlying game UI.
• The modal does not create a darkened backdrop. Use PurchaseLoadingOverlay separately if your design needs one.
• Every generated Instance belongs to the controller. The same UI is reused for each presentation and removed by Destroy().

Project structure

PurchaseResultModal/
├── init.luau
├── README.md
├── wally.toml
├── sourcemap.json
└── LICENSE

License

MIT — see LICENSE.

---

made with ❤️ by biotoxin495