Skip to Content
Kinemium

BindableEvent

Send custom events between scripts in the same runtime through an instance.

BindableEvent is a custom event object. One script fires it, other scripts connect to it, and the arguments pass through unchanged. It's a way to publish something without a direct reference between the scripts.

Getting started

local event = Instance.new("BindableEvent")
event.Name = "WaveStarted"
event.Parent = game:GetService("ReplicatedStorage")

event.Event:Connect(function(waveNumber)
    print("Wave", waveNumber, "started")
end)

event:Fire(3)

Members

MemberTypeDescription
EventsignalFires for each call to Fire().
Fire(...)methodFires the event with the arguments you pass.

Fire() accepts any number of arguments and forwards them to listeners in order. It returns nothing and doesn't wait for listeners to finish.

event:Fire("spawn", Vector3.new(0, 0, 0), 5)

The event signal is created the first time Event is read and reused afterward.

Communication boundaries

A BindableEvent is local to the runtime that owns it. A server-side bindable event doesn't deliver to clients, and a client's event doesn't reach the server. Use RemoteEvent when you need to cross that boundary.

-- Both sides need their own event, or one shared through replication.
local serverEvent = game:GetService("ServerStorage"):FindFirstChild("WaveStarted")

Because the object has to be visible to both scripts for them to share it, ReplicatedStorage is a common home for events used across several systems on one side.

Notes

  • Listeners run when Fire() is called, in connection order, on the calling thread.
  • Arguments aren't copied or serialized; they're passed as-is to the same runtime.
  • Cloning the event creates an independent event with no connections.
  • Destroying the event disconnects nothing automatically; listeners on the old object stop receiving fires because there's nothing left to fire.
  • There's no way to inspect how many listeners are connected.

See also

  • BindableFunction, the function-shaped variant.
  • RemoteEvent, events that cross between server and client.

On this page