Skip to content
Bit Quirky Round Trip
Visual Scripting

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or a C# feature.

Browse the reference instead

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

v1.0.0
Menu

These release highlights are grouped around changes to your workflow. The package’s own CHANGELOG.md, installed beside package.json, carries the complete entry for every version.

Current views of recently added tools

Select a screenshot to enlarge it.

The setup wizard offers assertions and if statements for new programmer contracts.
Figure 1. Choose a default guard structure Choose how new programmer contracts are structured during setup. Existing source is not rewritten.
The actual toolbar Align menu lists the six alignment commands and their shortcuts.
Figure 2. Align commands are on the toolbar Use the primary node as the alignment reference. The current Align guide includes the selection and result views.
The real GRID AND CANVAS preferences show grid spacing and Snap to grid.
Figure 3. Grid behavior is a personal preference Snap and spacing live in Preferences. Changing them does not change the game’s C# behavior.

A method call in an if condition that follows an early return, such as if (!IsReady) return; followed by if (!_gods.TryGetByClient(id, out var god)), no longer draws an execution wire from the call back into itself; the call now runs straight into the branch it feeds. Auto layout gives a value node fed by a call its own column between the call and the node that uses it, so the NOT in if (!_gods.TryGetByClient(...)) sits to the right of the call instead of under it, and the call’s bool wire no longer doubles back across both. A method whose layout is already saved keeps its saved positions.

A serialized field marked required, such as an Odin [Required] field the Inspector must assign, no longer wears an attention mark in the Variables rail. Its Default card keeps the calm dashed ring and a neutral Required · set in Inspector chip, because Round Trip cannot see the scene or prefab value that fills it; a required field Unity does not serialize keeps the warning, since only code can fill that one. Clicking a row in the Methods or Variables list now moves the keyboard highlight to that row, so the previously open method no longer looks selected beside the new one. Auto layout keeps a parameter or local wired to its nearest consumers however wide the column gap, so an entry pin is never left dangling while its first use reads from a split pill. This release requires bitquirky-graph 0.2.76, the first Graph build the registry accepted after 0.2.75.

The Setup wizard was redesigned with a product header, numbered steps, and a primary action. The current wizard walks through Welcome, Sources, Layout, Guards, Review, and Index. Review reports whether saving will add the Unity lifecycle catalog. The setup wizard walks through the current screens. The window’s last open class and method moved out of ProjectSettings/RoundTripSettings.asset into UserSettings/RoundTripUserState.asset, so browsing methods no longer dirties a committed file.

Six Align commands line a multi-node selection up on its primary node, the one you selected last: Align Top, Align Bottom, Align Left, Align Right, Align Middle and Align Center, from the node menu, from a new toolbar Align list with an icon and shortcut per row, or from Shift with W, S, A, D, M or C. The primary keeps the blue selection ring and never moves; the other selected nodes wear a light gray ring. Align nodes walks through it. The toolbar is regrouped around the method title: Undo and Redo follow it, then the clipboard buttons, while the layout group of Align and Auto layout leads the right side. The Coverage pill is now opt-in through Show coverage under TOOLBAR in Preferences > Round Trip, and that page carries the Round Trip mark. The Explorer rail marks the open method with the same selection band the class picker uses, and Tools > Round Trip gained a Settings entry that opens the preferences page. Snap to grid now lands pills by their pins, so wires between pills and nodes run straight, and undoing or redoing a layout change keeps pills on the grid.

Hold Cmd (Ctrl on Windows or Linux) over a wire knot and the whole knot, center included, becomes a move handle, so a Cmd/Ctrl-drag from anywhere on it moves it without hunting for its outer ring. It is the same key that moves a wire’s end from a pin or splits a pill off a wire. The knot’s context menu entry is now Remove wire knot, and the docs call these points wire knots throughout. Wire knots covers adding, moving, branching and removing them.

Right-click the class chip at the left of the top rail for Copy Class Name, Copy Full Name (the class with its namespace) and Open Source, which opens the class’s script at its declaration. Classes and members lists every right-click menu in the Explorer, including a method row’s Copy Method Name and Copy Full Path.

Distribute Vertically and Distribute Horizontally join the selected node’s command menu as a Distribution group, spacing three or more selected nodes evenly between the outermost two. The feature lives in io.bitquirky.graph; this release raised that dependency to bitquirky-graph 0.2.74, and the next release requires bitquirky-graph 0.2.75, the first published Graph that includes it.

Select two or more nodes and press an arrow key to nudge the whole selection one grid cell in that direction, landing on the grid. Each press is one undoable move. This release also stops VersionControlChangeDetector logging a git failure for processes it deliberately ended ahead of a domain reload.

Snap to grid is on by default, with Grid spacing and the switch under Preferences > Round Trip. A node snaps by its top-left corner so every pin row lands on a grid dot, and the Round Trip graphs window no longer logs a struggling layout on a blank canvas. Snap to grid covers the feature.

Opening the Round Trip graphs window no longer floods the Unity console. The background scan that parses every indexed method for coverage used to print hundreds of parser warnings for methods you had never opened; it now runs through a console-silent logger, while opening or editing a method still shows that method’s parser diagnostics. This release also raises the Bit Quirky Graph dependency for the align-selected-nodes canvas feature and removes a vestigial [Serializable] from the class index model that triggered a UAC1001 analyzer warning on every recompile.

Opening a method whose graph carries a data cycle no longer crashes the editor. Every for loop makes one, and when it sat behind a branch target the layout pass that lines up a branch target’s data dependencies followed the cycle forever. In the Platformer sample, PlayerController.IsStompContact was the repeatable case. The same release restored four sample methods that earlier authoring runs had degraded, including CoinUnlockRule.ShouldUnlock, which compares the coin count with the threshold again.

Player controls. With Unity’s Input System installed, the Lifecycle + list has INPUT sections that list every action a saved Player Input sends, such as OnJump and OnMove. Picking one writes On…(InputValue value) with the control’s value already read: a press check for a button, a Vector2 for a direction, a float for an amount. new player control… opens a window that adds an action with common keys and gamepad buttons, puts a Player Input set to Send Messages on the player, saves the scene and opens the new method on the canvas. A method named like a handler that no Player Input calls now shows a warning. Your first class walks through it.

Method names can be renamed in the right-rail identity header. External include roots with the same final folder name now receive stable distinct storage ids. This release also standardizes dropdown and disclosure controls, improves narrow-rail layouts, and makes Enter finish single-line edits consistently on macOS.

Enums became indexed editor types with member creation, values, rename, removal, attributes and comments. Class headers, fields, constants and attributes gained source-faithful editing. New field drafts persist until Compile, while declaration refusals name the exact unsupported shape and leave source unchanged.

Interpolated strings and null coalescing gained faithful write-back and canvas authoring, as did coalescing assignment and supported type tests. Pattern-bound values now remain readable, multi-operand operator chains keep every operand, and unsupported pattern shapes appear as readable gray nodes instead of being rewritten into different code.

All ten compound assignment operators write back in block and expression-bodied methods while preserving their compound spelling. The editor assembly also recovered from a duplicated merge block that had prevented it from compiling.

Dragging a variable from the rail can walk into its members and create nested GET or SET shapes. Tuple creation and element reads gained authoring and faithful write-back, along with deconstruction and deconstructing foreach statements. Placed arrays and structs also retain edited slots and wires across reloads.

Element access, indexer assignment, ranges, from-end indices and slices gained write-back and canvas authoring. Source spelling and operand structure stay distinct for cases such as multi-dimensional access versus chained access.

Array and struct construction gained faithful source spelling, plus editing and creation from the canvas. The editor can choose array types, infer a placed array’s element type from values or wires, and discover public struct constructors from the project compilation.

Switch statements and switch expressions became writable and authorable, including case structure, guards, fallthrough-sensitive flow and created decision tables. Edits inside a case now reach source instead of being hidden by the enclosing switch.

A release entry may say that a construct “writes back.” That means a supported visual change can be composed as C#, checked, written and re-parsed. It does not mean every possible C# shape around that construct is supported. Current exceptions stay listed on what it does not do yet.

  • What it does not do yet: check current boundaries after the recent additions.
  • Compatibility: confirm the package and Unity versions.
  • Guides: learn the current editor surfaces instead of relying on an older release’s UI.
Full-size image