Skip to content
Bit Quirky Behavior Trees and
State Machines

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or enter a complete API identifier.

Browse the reference instead

Esc closes · Tab reaches results · Enter opens the focused link

v0.11.0
Menu

Message

Fire one void call and move on, with nothing to wait for and nothing to interpret.

Some calls have nothing to say back. Light the lamp, play the sound, raise the alarm. A message sends one void call and the graph carries on.

A method binding asks you what the return value means. For void Shine() that question has no answer, and a node that keeps asking it hands you a Result card of tests that can never run.

BeaconWarmUp.bqbehavior ends with light the lamp, a message bound to Beacon.Shine(). The node says what it does and nothing else, which is the point.

  • A one-shot command your component performs immediately: play a sound, spawn a hit effect, set a flag through a method.
  • A notification to another system that does not report back.
  • A call with arguments but no answer, like the Platformer gallery’s request slam, bound to Players.Slam(float power) with the parameter left on its declared default.

Use method when a return value, waiting, or result mapping matters.

A message member node requesting a slam
Figure 1. A message names the void method it sends. There is no return value to compare, so what the node reports is the call itself.
The message rail from its Target card down to its Result card
Figure 2. One void call. The parameter stays on its declared default, and Result carries Always with its Reports row on succeeded.
  1. Add message from the picker, under ACTIONS, described as “send a message; fire and forget”.

  2. Finish Target.

  3. Use Member > Change and pick the void method. A method with a return type is refused here, with the picker saying that message operations need a void-returning method.

  4. Fill any Arguments rows the declaration exposes. Optional parameters can stay on Default, ref and out parameters get their own cards, and a trailing params parameter gets its own slot with an Individual values / Collection switch, as variable arguments describes.

Result

Success
The call was accepted or the entity channel request was queued, and Reports names succeeded.
Failure
The call threw, or the target could not be resolved, which is reported as a fault rather than an authored failure.
Running
Nothing waits here. The call or request settles inside this evaluation, not necessarily the channel delivery.
  • The member has to be an exact public void method. Validation rejects anything else.
  • There is no completion to wait for and no value to store or test. What you can author is the result the node reports: Always plus Reports, which is succeeded out of the box. A void method that also writes out or ref values states that contract on the card instead.
  • Arguments behave exactly as they do for a method, including ref reads, out destinations, and params rows. See arguments and results and variable arguments.
  • A thrown call reports a fault with the graph, node, and member recorded, and commits no outputs.
  • On the entity path an ordinary Message needs a static declaring type: components and buffer elements still have no instance call site. A declared Asset target instead queues an unparameterized raise through the event library’s integration. The real channel can fire later in the same frame at the earliest, never in that tick; listening entities observe it on their own next scheduled tick in a later frame. Declared event channels explains the timing and registration boundary.

An exact typed void binding is still the simplest choice when the receiver and method are known. When gameplay chooses the message name at runtime, bind Unity’s native GameObject.SendMessage or Component.SendMessage overload instead. No adapter component or wrapper method is needed.

  • Select the GameObject or Component target and its exact SendMessage overload in Member.
  • Set methodName to Constant for a fixed message or Blackboard for a string variable. Changing that variable changes the message sent by the next invocation; it does not regenerate the provider.
  • Choose an overload with the object value argument when the receivers need a payload. Supply it through the ordinary argument sources and accepted conversions.
  • Choose the overload with SendMessageOptions to decide whether a missing receiver should produce Unity’s receiver diagnostic. DontRequireReceiver permits no matching receiver without that diagnostic.

Unity invokes the matching receiver methods on the target GameObject’s components, with or without the supplied payload. The graph invokes the chosen native void method once; Unity owns receiver selection and its required-receiver behavior. This is not a returned success value from each receiver, and a missing receiver is not a new authored false result. The existing typed direct-message path remains unchanged, and entity messages still require a static declaring type.

When it goes wrong

SymptomCheckFix
The method you want is missing from the picker.Confirm it returns void.Use a method node for a returning member. For a runtime-selected message name, choose a native SendMessage overload instead.
The effect happens too early.Look at the sibling order: a message finishes immediately, so the next node runs on the same update.Put the message after the node whose completion it depends on, such as an event condition.
The call happens more than once.Look for a Repeat above it, or a parent that re-enters the branch.Gate the branch, or move the message where re-entry is the behavior you want.
A NullReferenceException lands inside your method.The fault trace names the graph, the node, and the member.Fix the component state the method assumes, since the graph reports the fault instead of hiding it.
You wanted to know whether the command worked.A message has no answer by design.Bind a method returning bool and map When true and When false.
Full-size image