Skip to content
Curious Trove
Get OctoShaper
Upgrade Guide Migration OctoShaper 1.3Updated

Upgrading to 1.3

1.3 keeps your graphs, parameters and procedural prefabs as they are. The main change under the hood is that OctoShaper now ships entirely as source, which matters if you write custom nodes. Everything else is new tools you can adopt when you like.

Checklist

  1. Back up your project, or commit it to version control.
  2. Import OctoShaper 1.3 over your existing install and let Unity finish compiling. The old DLLs are replaced automatically, and your OctoShaper project settings and procedural prefab imports are kept.
  3. If you have custom node assemblies, update their references (see below).
  4. Run Tools > OctoShaper > Generate Graph Code and let Unity compile. Generated executors need this to support result caching.
  5. Open your main graphs once. Check the Preview Stage and the Console.

The minimum Unity version is still 2022.3.

New: a UPM package

1.3 is also available as a UPM package. It installs under Packages through Package Manager, which resolves Burst, Collections and Mathematics for you. It behaves exactly like the classic package. To switch while upgrading, delete Assets/OctoShaper and install the UPM package instead of importing in step 2, then continue the checklist from step 3. See Installation for details.

OctoShaper now ships as source

There are no precompiled DLLs any more. Core has its own assembly definition, CuriousTrove.OctoShaper.Core.

If an assembly definition of yours lists CuriousTrove.OctoShaper.Core.dll under Assembly References (precompiled references), remove it and add CuriousTrove.OctoShaper.Core to its assembly definition references instead. See Creating custom nodes.

Behavior worth knowing

  • Default material and texture. Draw Instanced and Draw Instanced Indirect without a material now draw with a default lit material for your render pipeline, and texture-sampling nodes without a texture use a checker texture. Before 1.3, a missing material skipped drawing. Assign a material, or remove the draw node, if a branch was relying on that.
  • The Preview Stage runs a real executor. It now shows the actual generated hierarchy, built exactly as in a scene, including colliders and spawn receivers. Preview objects are read-only.
  • Undo goes through Unity. Graph edits appear in Edit > Undo, and Ctrl+Z in the graph window and in Unity stay in step.
  • Caching is opt-in. Nothing changes until you enable Use Caching.

New tools to try

  • Scene handles: drag number parameters as sliders, box faces or radius discs.
  • Drawing splines: click or sketch a spline onto the scene, then extrude it with Extrude Spline Mesh.
  • Result caching: rerun only the nodes a change affects.
  • Click an object drawn with Draw Instanced in the Scene view to select its executor.
  • Animation curve parameters can be edited in the graph settings panel.

The full list of changes is in the changelog. Coming from 1.1? Read Upgrading to 1.2 first.

Frequently asked questions

Can I move from the classic package to the UPM package?
Yes. Delete Assets/OctoShaper, then install the UPM package from My Assets. Both share the same GUIDs, so graphs, prefabs and settings keep working.
Will my 1.2 graphs still work in 1.3?
Yes. Graphs, configurations and procedural prefabs are unchanged. Regenerate graph code after importing.
I get errors about CuriousTrove.OctoShaper.Core.dll. What do I do?
Your custom node assembly still lists the old DLL. Remove it from precompiled references and reference the CuriousTrove.OctoShaper.Core assembly definition instead.
Did the minimum Unity version change?
No, it is still Unity 2022.3.