Skip to main content

Pulse.Notify

Pulse.Notify fires WindUI toast notifications from anywhere in your components. It wraps the adapter's _PulseNotify function so you never have to call it directly.


Basic usage

Pulse.Notify("Aimbot enabled", 3)
ParameterTypeDefaultDescription
msgstringThe message body shown in the notification
durationnumber3Seconds the toast stays on screen
// In a function:
function shoot() {
// ...
Pulse.Notify('Fired!', 2)
}

// In an on.signal handler:
on.signal(enabled, (v) => {
Pulse.Notify(v ? 'Feature on' : 'Feature off', 3)
})

Pulse.Notify.onToggle

Subscribes to a boolean signal and automatically fires a notification every time it changes. Call this in component setup to wire up on/off toasts for any toggle.

Pulse.Notify.onToggle(signal, name, opts?)
ParameterTypeDescription
signalSignalA boolean signal to watch
namestringFeature name — used to generate default messages
optstable?Optional overrides (see below)

Returns an unsubscribe function (same as signal:onChange).

Options

KeyTypeDefaultDescription
onstring"<name> on"Message when the signal becomes true
offstring"<name> off"Message when the signal becomes false
durationnumber3Toast duration in seconds
notify_onbooleantrueSet false to suppress the "on" toast
notify_offbooleantrueSet false to suppress the "off" toast

Examples

// Standard pattern — wire in component setup
Pulse.Notify.onToggle(Aimbot.enabled, 'Aimbot')
// fires "Aimbot on" / "Aimbot off" on every toggle
// Custom messages
Pulse.Notify.onToggle(ESP.titanEnabled, 'Titan ESP', {
on: 'Titan ESP active',
off: 'Titan ESP off',
duration: 2,
})
// Only notify on enable
Pulse.Notify.onToggle(Protection.enabled, 'Protection', {
notify_off: false,
})

Load-time behaviour

onToggle uses signal:onChange internally. Because the UI widget sets the signal's default value at load, onToggle fires once on startup for every feature that has a default: true in its toggle widget. This doubles as a load confirmation — you'll see toasts for whichever features start enabled.

To suppress startup toasts, subscribe after a short delay:

task.delay(2, () => {
Pulse.Notify.onToggle(MyComp.enabled, 'My Feature')
})

How it works

Pulse.Notify wraps _PulseNotify, which the WindUI adapter defines at load time. All calls are wrapped in pcall, so a missing adapter (e.g. in test environments) never crashes a component. The title shown in the toast comes from layout.tstitle.