Pills and literals
Feed a node's pins from compact GET pills, typed values, composite values, and object references, and split a shared pill.
On this page
Most values a node needs already exist somewhere: a variable on this component, a reference to another object, an input the method was given, a value worked out a few nodes earlier. A pill is the small rounded node that brings one of those values onto the canvas. A literal is a value you type straight onto the pin that uses it, because it exists nowhere else.
What it does
Section titled “What it does”A behavior is mostly values flowing into nodes: the health of the thing that was hit, the audio player to make a sound with, the list a loop walks, the number of retries allowed. Drawing each of those as a full node would bury the three or four nodes that matter. Fixed values have the same problem: a 0, a tick box, a name or a sound asset does not deserve a node of its own, but it still has to be visible and editable where it is used.
So a read becomes a pill, colored by its value’s type, with one dot on its right that you wire from. A fixed value becomes a box beside an unwired input pin. One pill can feed several pins at once, and you can split it so each pin gets its own pill.
When to use it
Section titled “When to use it”Use a pill when the value already exists and the node should follow it: a variable or property on this component, a member of another object the component holds, a method input, a local, or the component itself. When the value changes in the game, the pill reads the new value.
Use a literal for a value that belongs at this one use: a jump threshold, a flag, a tag or layer name, a message, an offset, a choice from a list such as a state. If several nodes share the same value, or a designer should tune it in the Inspector, make it a variable and read it with a pill instead.
Use the object picker on the pin for a Unity object, such as a prefab, a material or a sound. The picker remembers which asset you chose, so renaming the asset later does not break the link.
A value read off another value stays one pill, however many steps it takes, such as the y of the transform’s position. The small label above the pill names the steps it passes through.
What it looks like
Section titled “What it looks like”A pill takes the color of its value and can feed several pins. When the canvas lays out a method that reads the same value in several places, it draws one pill for the uses that sit close together and wires it to each of them. Uses far across a wide diagram get a pill of their own beside them, so no wire has to cross the whole canvas. That happens on the first open of a method with no saved layout and each time you press Auto layout; Split long read wires and Split distance, under READ PILLS in Preferences > Round Trip, decide how far apart is far. A literal sits on an unwired input row. A hollow pin means the input has no wire and no value yet.
An unwired bool input draws a checkbox instead of a box to type into. A tick is true and an empty box is false. A short gray dash means no value has been given yet, so the call cannot be written until you wire one or click the box, and the first click sets true. To take the value away again, right-click the box and choose Clear: the dash comes back.
An input that accepts any value, such as the message pin of a Log call, wears the color of whatever arrives: the color of the wire plugged into it, or of the value typed into it. Only the color follows. What you can plug in, which box appears, and what Compile saves stay the same.
What you type decides the type
Section titled “What you type decides the type”Round Trip reads what you type as you type it and checks it against the pin. On an input that accepts any value, the value itself decides the type, so the box takes that type’s color as soon as it makes sense: text in double quotes is string pink, a whole number is int green, and true or false is bool red. A word without quotes is not text. In C# it would be the name of something, so the box turns coral and a hint hangs below it while you are still typing. Add the quotes and the hint goes away.
A pin with a fixed type checks the value against that type instead. A string pin asks for the quotes with String values must be quoted: try “…”. A float pin adds the f that C# needs on a decimal float: type 1.5 and the box reads 1.5f when you press Enter.

1.5 typed on both float pins of Assert.AreApproximatelyEqual is committed as 1.5f, and Compile writes Assert.AreApproximatelyEqual(1.5f, 1.5f);.Clear a value
Section titled “Clear a value”Every value you can type or pick beside a pin can be taken back to empty. Right-click the value, or the pin it sits beside, and choose Clear. It works the same on a checkbox, a typed number or text, a choice from a list, a box split into parts such as a Vector3, and an object chosen with the picker. Clear is dimmed when there is nothing to clear.
A value the script already passes to a call is sometimes required: C# cannot write that call without it. Clear refuses there and explains why, instead of leaving a call that can no longer be written. A value on a node you placed yourself, which is not in the script yet, can always be cleared. So can a value you typed into a pin after deleting the wire that fed it: the script never held that value, so Clear puts the pin back to no value and the node’s Node not completely wired message returns until you give the pin a value again.
The refusal reads This value is required, so it can’t be cleared. Wire a value into this pin to replace it. Under a checkbox or a choice from a list it shows for four seconds, or until you set a value. On a typed value the editor opens empty with the message below it: type a new value and press Enter, or press Escape to keep the old one.
A pill can feed more than one node. Right-click one of its wires for Split pill, then right-click the new pill’s wire for Recombine pill. You can also right-click the shared pill and choose Split pins to give each wire its own pill.
Or hold Cmd (Ctrl on Windows/Linux) over the pill end of a wire and drag: the new pill lands where you let go.
How to use it
Section titled “How to use it”The captures use the Platformer scene and PlayerController. The canvas is framed for clarity; pointers and click markers in clips are site overlays.
Feed a call with values
Add a Log call
In the left rail, click + on the Methods header and press Enter. A magenta entry node appears. Drag from its white Exec pin onto empty canvas to its right and let go. Search for
Debug.Logand choose Log(object message). A dark teal call card titled Log appears, already wired from the entry node.
6 stepsFull size ↗Enter a literal
Look at the Log node’s message pin: it is hollow, with an empty box beside it, both object purple, because the pin takes any value. Click the box and type
"Coin collected", quotes included, then press Enter.
2 stepsFull size ↗Read an existing value
Right-click empty canvas to the left of the Log node. In the VARIABLES section of the menu, click get on a variable row, such as gameObject. A purple pill labeled gameObject appears. Drag from the dot on its right end to the message pin. A purple wire appears and the pin turns purple.
Break the wire
Alt-click (Option-click on macOS) the purple wire. It breaks, and the message box comes back, ready for a typed value again.
Share one pill
Place a second Log call to the right of the first and drag a white wire from the first node’s Exec output to its Exec input. Reconnect the gameObject pill to the first Log node’s message pin, then drag from the same pill’s dot to the second node’s message pin. One pill now carries two purple wires.
12 stepsFull size ↗
Split and recombine a pill
Split the pill
Right-click the shared gameObject pill and choose Split pins. A second pill appears, and each pill now carries one wire. To fold the two back into one, right-click a split pill’s wire and choose Recombine pill.
To split just one wire instead, hover it and right-click Split pill. A wire that runs straight from a method input on the entry node, or from a local, can be split and recombined the same way.
5 stepsFull size ↗
Drag a wire to split
Drag a wire to split
Once the wires share one pill again, hold Cmd (Ctrl on Windows/Linux) over the pill end of one wire. DRAG TO SPLIT PILL appears. Drag that end to an empty spot and let go.
Enter a composite value
Enter a Vector3
For a separate composite example, place AudioSource.PlayClipAtPoint(AudioClip clip, Vector3 position). Its position input has one box per axis: enter
1in X,2in Y and3in Z.
Choose and clear values
Choose an asset
Click Select asset beside the clip pin to open the Unity object picker. Search for
sfx_coinand select the sample sound; its name appears in the box. To find the asset in Unity’s Project window, click the Reveal in the Project window. icon at the end of the box, or Alt-click (Option-click on macOS) the pin label.Clear a value
To take a value back to empty, right-click it, or the pin beside it, and choose Clear. A checkbox shows the gray dash again and a typed box empties.
Write the connected example
What it writes
Section titled “What it writes”If you also work in C#, this is how a call fed by pills and one typed value appears in the script. This one is drafted on AudioCuePlayer in the Platformer sample:
_coinClip is a variable holding an asset chosen with the object picker, transform.position is a read passed through transform, and 0.8f is a value typed on the volume pin. A wired pin writes whatever the wire carries. An unwired pin writes the value typed on it. Splitting or recombining pills changes the drawing only; the script reads each value exactly as often as it did.
Typed values on a pin that takes any object are written as you typed them, so their type in C# is the type you saw on the canvas. This is TypedLiteralsDemo from the pictures above, compiled:
When it goes wrong
Section titled “When it goes wrong”When it goes wrong
| Symptom | Check | Fix |
|---|---|---|
| The box beside a pin is missing. | Look for a wire entering the pin, or a pin type that takes no typed value. | Alt-click the wire to break it and the box returns, or wire a pill of the matching color into the pin. |
| Split pins is dimmed and reads needs two or more wires. | Count the wires leaving the pill. | Splitting needs a pill with two or more wires. Wire it into another pin, or leave it as it is. |
| The box beside a pin turns coral while I type. | Read the hint below the box. On a pin that takes any object, a word without double quotes is not text. | Put the text in double quotes, such as "hello", or type a number, true or false. |
| The object picker shows no matches. | Read the pin type, and the type of the asset you expect. | Choose an asset that fits the pin, or leave the box empty until the asset exists. |
| Clear is refused: This value is required, so it can't be cleared. | The node is already in the script, and C# cannot write its call without this value. A value you set after deleting the pin's wire is not refused: Clear returns that pin to no value. | Type or pick a different value, or wire a pill or another node's output into the pin. To remove the call, delete the node. |
| Clear is dimmed. | Look at the value. An empty box, a dash in a checkbox or an empty object box has nothing to clear. | Nothing to do. Clear lights up again once the pin has a value. |
- Variables: drag variables from the left rail to make pills and SET nodes.
- Layout, wire knots, and comments: arrange pills and nodes clearly.
- Get and set: read a value and change it on the white path.





















