GameCult/VibeGeometry
Watch
9
0
Fork
You've already forked VibeGeometry
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
VibeGeometry/docs/research/geometry-script-fork-notes.md
Meta Vens ea60838405 Record Geometry Script fork branch hygiene
2026-05-04 14:22:57 +01:00

2.8 KiB
Raw Blame History

Geometry Script Fork Notes

VibeGeometry uses a repo-local Geometry Script clone at:

external/geometry-script

The clone currently tracks upstream:

https://github.com/carson-katri/geometry-script.git

The GameCult fork remote is:

https://github.com/GameCult/geometry-script.git

The fork is intentionally kept small. As of 2026-05-04, its live branches are:

main
vibegeometry/blender-5-nested-tree-groups

Upstream may still have historical branches such as gh-pages or nodes_to_script; those are upstream history, not GameCult fork policy.

Patch work belongs in this clone first, then in a fork branch/PR. Do not patch the installed AppData add-on directly. That path is live installation state, not source control, and it will quietly become a stupid little archaeological layer if indulged.

Setup

Run from the VibeGeometry repo root:

.\tools\setup_geometry_script_clone.ps1

This clones upstream into external/geometry-script, creates or switches to the patch branch, and applies the patch stored in:

patches/geometry-script/0001-fix-nested-tree-group-references-on-blender-4.patch

external/ is intentionally ignored by the VibeGeometry repository. The clone is source-controlled as its own repo, not smuggled into this repo as a pile of vendor files.

Active Patch Branch

Branch:

vibegeometry/blender-5-nested-tree-groups

Problem:

  • Geometry Script's @tree decorator returns a Python function intended to create a nested node-group node when called inside another @tree.
  • Under Blender 5.1, that returned function tries to call geometrynodegroup(...), but no such generated DSL symbol exists.
  • Manually calling the generated group(node_tree=...) wrapper returned None in the nested path, so callers could not access group outputs.

Patch:

  • In Blender 4/5, create GeometryNodeGroup directly.
  • Assign result.node_tree = node_group.
  • Wire positional and keyword arguments into enabled group inputs with Geometry Script's existing set_or_create_link(...) helper.
  • Return Type(...) wrappers for each enabled group output.

Verification:

  • examples/geometry_script/shriinivas_cartesian_helper.py loads external/geometry-script through tools/geometry_script_loader.py.
  • VG Cartesian Circle calls vg_cartesian_helper(...) twice inside its own @tree body.
  • Generated circle graph contains nested GeometryNodeGroup nodes.
  • tools/verify_cartesian_translations.py verifies helper, line, parabola, and circle behavior against the source cartesian.blend groups in Blender 5.1.1.

Fork/PR Todo