fix(examples): gate every use_nodes = True on bpy.app.version < (5, 0, 0)

5.x deprecates use_nodes on materials, worlds, lights and scenes (removal
in 6.0), and creates their node trees without it. Measured on 5.2.1:
use_nodes defaults to True and node_tree exists for all four; on 4.5.14 it
defaults to False and node_tree is None. 532 ungated assignments in 136
scripts were teaching the deprecated call, including the bmesh-gear
anatomy every new example copies. A codemod now wraps each one in
'if bpy.app.version < (5, 0, 0):', and splits the 11 one-line
'x = new(...); x.use_nodes = True' forms.

tests/check_example_rules.py rejects an ungated .use_nodes = True in
examples/, showcase/, templates/ and snippets/. A probe file without the
gate fails it.

Verified:
- smoke catalog happy paths on 5.2.1: 150 PASS;
- bmesh-gear, turntable and the anvil showcase rendered with
  --output --engine cycles on 5.2.1 and 4.5.14: exit 0, no use_nodes
  deprecation warnings.

compositor-glare also claimed scene.use_nodes = True raises on 5.x. On
5.2.1 it only warns; scene.node_tree is what is gone.

Closes #471

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

Author: TMHSDigital

docs/gallery/compositor-glare/index.html

@@ -61,7 +61,7 @@ <h1>Compositor Glare</h1>
     </div>
     <nav class="jumpnav" aria-label="On this page"><span class="tag">jump to</span> <a href="#run">Run</a> <a href="#exit-codes">Exit codes</a> <a href="#source">Source</a> <a href="#related">Related</a></nav>
     <section class="detail-section md">
-<p>A runnable example that puts bloom where it actually lives: the compositor. Three emissive rings are rendered, then a <code>Glare</code> (Fog Glow) node fed by <code>Render Layers</code> grows the halo — wired through <code>scene.compositing_node_group</code> on Blender 5.x and through <code>scene.node_tree</code> on 4.x, because the 5.0 compositor rewrite removed the scene-level tree entirely (<code>scene.use_nodes = True</code> now raises <code>AttributeError</code>).</p>
+<p>A runnable example that puts bloom where it actually lives: the compositor. Three emissive rings are rendered, then a <code>Glare</code> (Fog Glow) node fed by <code>Render Layers</code> grows the halo — wired through <code>scene.compositing_node_group</code> on Blender 5.x and through <code>scene.node_tree</code> on 4.x, because the 5.0 compositor rewrite removed the scene-level tree entirely (<code>scene.node_tree</code> now raises <code>AttributeError</code>; <code>scene.use_nodes</code> survives only as a deprecated flag, removal in 6.0).</p>
 <p>The Glare node changed shape with it: on 4.x it takes legacy enum properties (<code>glare_type=&#x27;FOG_GLOW&#x27;</code>, <code>quality=&#x27;HIGH&#x27;</code>, <code>size=6</code>), while on 5.x the same choices are menu/float <strong>input sockets</strong> (<code>inputs[&#x27;Type&#x27;].default_value = &#x27;Fog Glow&#x27;</code>). The 4.x <code>threshold</code> property is a dead shim — the real threshold is the <code>Threshold</code> input socket on both versions. And EEVEE has no <code>use_bloom</code> toggle on either version (removed in 4.2): bloom is a compositor node, period.</p>
 <p><strong>What it witnesses:</strong> the halo is the compositor&#x27;s output, proven with pixels. The check renders the scene twice at 96×54 (single-sample Cycles, noise-free) — once with <code>use_compositing</code> on, once off — and samples a column of pixels above the middle ring&#x27;s silhouette via <code>world_to_camera_view</code>. With the compositor on, the halo luminance just outside the silhouette is far above zero and falls off strictly with distance (the Fog Glow kernel signature); with it off, those same pixels are exactly zero. The structural check pins the wiring (<code>Render Layers → Glare → output</code>), the version-correct tree plumbing, and the absence of any EEVEE bloom toggle.</p>
 <h2 id="run">Run<a class="anchor" href="#run" aria-label="Link to this section">#</a></h2>

examples/armature-bend/armature_bend.py

@@ -252,7 +252,8 @@ def render_still(rigs, path, engine):
 
     def principled(name, base, rough, metal=0.0, noise=None):
         m = bpy.data.materials.new(name)
-        m.use_nodes = True
+        if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+            m.use_nodes = True
         b = m.node_tree.nodes["Principled BSDF"]
         b.inputs["Base Color"].default_value = (*base, 1.0)
         b.inputs["Roughness"].default_value = rough
@@ -276,7 +277,8 @@ def principled(name, base, rough, metal=0.0, noise=None):
     # the hose: bone tint on the rib crests, dark rubber down in the valleys,
     # so the weight bands the LBS check asserts still read as colour
     hose = bpy.data.materials.new("WeightBands")
-    hose.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        hose.use_nodes = True
     nt = hose.node_tree
     bsdf = nt.nodes["Principled BSDF"]
     tint = nt.nodes.new("ShaderNodeAttribute")
@@ -361,7 +363,8 @@ def flange(x):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Studio")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -374,7 +377,8 @@ def flange(x):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
     scene.world = world
 

examples/attribute-domain-shear/attribute_domain_shear.py

@@ -192,7 +192,8 @@ def make_attr_material(name, attr_name):
     """Canopy fabric: base color read straight from the color attribute.
     Fully matte (flat color data carries no specular line, VISUAL-STYLE)."""
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     bsdf = nt.nodes["Principled BSDF"]
     spec = bsdf.inputs.get("Specular IOR Level")
@@ -208,7 +209,8 @@ def make_attr_material(name, attr_name):
 
 def make_material(name, rgb, rough=0.45, metallic=0.35):
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     b = mat.node_tree.nodes["Principled BSDF"]
     b.inputs["Base Color"].default_value = (*rgb, 1.0)
     b.inputs["Roughness"].default_value = rough
@@ -552,7 +554,8 @@ def build_studio(sc):
     sc.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (
         0.02, 0.021, 0.025, 1.0,
     )

examples/bake-normal-high-to-low/bake_normal_high_to_low.py

@@ -157,7 +157,8 @@ def setup_bake_target(obj, name, size=BAKE_RES):
     img = bpy.data.images.new(name, size, size, alpha=True, float_buffer=False)
     img.colorspace_settings.name = "Non-Color"
     mat = bpy.data.materials.new(name + "Mat")
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nodes = mat.node_tree.nodes
     tex = nodes.new("ShaderNodeTexImage")
     tex.image = img
@@ -388,7 +389,8 @@ def make_map_card(image, name="BakeCard"):
     finally:
         bm.free()
     mat = bpy.data.materials.new(name + "Mat")
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nodes = mat.node_tree.nodes
     links = mat.node_tree.links
     nodes.clear()
@@ -446,7 +448,8 @@ def seat_on_plinth(ob, name):
     finally:
         bm.free()
     pmat = bpy.data.materials.new(name + "Mat")
-    pmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        pmat.use_nodes = True
     paint_principled(pmat, (0.045, 0.042, 0.04, 1.0), 0.0, 0.55)
     slab.materials.append(pmat)
     plinth = bpy.data.objects.new(name, slab)
@@ -462,7 +465,8 @@ def make_label(text, loc, name):
     cu.align_x, cu.align_y = "CENTER", "CENTER"
     cu.extrude = 0.004
     lm = bpy.data.materials.new(name + "Mat")
-    lm.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        lm.use_nodes = True
     b = paint_principled(lm, (0.62, 0.60, 0.56, 1.0), 0.0, 0.5)
     b.inputs["Emission Color"].default_value = (0.9, 0.86, 0.78, 1.0)
     b.inputs["Emission Strength"].default_value = 0.35
@@ -490,11 +494,13 @@ def render_still(high, low, mat, tex, path, engine):
     # The solidify rim is the plate's edge, not baked surface: give it plain
     # bronze. Wearing the map, it sampled the UV border and rendered ragged.
     rim = bpy.data.materials.new("BronzeRim")
-    rim.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        rim.use_nodes = True
     bronze(rim)
     low.data.materials.append(rim)
     src = bpy.data.materials.new("BronzeSource")
-    src.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        src.use_nodes = True
     bronze(src)
     high.data.materials.clear()
     high.data.materials.append(src)
@@ -522,7 +528,8 @@ def render_still(high, low, mat, tex, path, engine):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Floor")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -535,7 +542,8 @@ def render_still(high, low, mat, tex, path, engine):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (
         0.02,
         0.021,

examples/bmesh-gear/bmesh_gear.py

@@ -119,7 +119,8 @@ def machined_brass():
     the geometry wherever the gear is posed.
     """
     mat = bpy.data.materials.new("MachinedBrass")
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     nodes, links = nt.nodes, nt.links
     bsdf = nodes["Principled BSDF"]
@@ -244,7 +245,8 @@ def box(bm, lo, hi):
 
 def principled(name, base, rough, metal=0.0, noise=None, coat=0.0):
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     b = nt.nodes["Principled BSDF"]
     b.inputs["Base Color"].default_value = (*base, 1.0)
@@ -434,7 +436,8 @@ def plinth(bm):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Studio")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -447,7 +450,8 @@ def plinth(bm):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     # metals reflect the environment: keep a faint cool ambient so flanks never go black
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.022, 0.028, 1.0)
     scene.world = world

examples/boolean-exact-volume/boolean_exact_volume.py

@@ -191,7 +191,8 @@ def principled(name, base, rough, metal=0.0, coat=0.0, coat_rough=0.1, rough_var
     """A designed Principled material. *rough_var* adds a low-frequency
     roughness drift (no fine noise: on metal that reads as glitter)."""
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     b = nt.nodes["Principled BSDF"]
     b.inputs["Base Color"].default_value = (*base, 1.0)
@@ -215,7 +216,8 @@ def principled(name, base, rough, metal=0.0, coat=0.0, coat_rough=0.1, rough_var
 def ghost_glass(name, tint):
     """Frosted, faintly tinted glass for an operand volume the result lost."""
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     b = mat.node_tree.nodes["Principled BSDF"]
     b.inputs["Base Color"].default_value = (*tint, 1.0)
     b.inputs["Roughness"].default_value = 0.22
@@ -229,7 +231,8 @@ def walnut_material():
     bands mixed between two walnut tones, a soft blotch layer, a light bump,
     and a satin coat that does not mirror the scene."""
     mat = bpy.data.materials.new("Walnut")
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     b = nt.nodes["Principled BSDF"]
     coord = nt.nodes.new("ShaderNodeTexCoord")
@@ -420,7 +423,8 @@ def add(name, me, mat, mw=None):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Studio")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -434,7 +438,8 @@ def add(name, me, mat, mw=None):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
     scene.world = world
 

examples/car-mirror-symmetry/car_mirror_symmetry.py

@@ -592,7 +592,8 @@ def eevee_engine_id():
 def _finish_materials():
     def principled(name):
         m = bpy.data.materials[name]
-        m.use_nodes = True
+        if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+            m.use_nodes = True
         return m.node_tree.nodes["Principled BSDF"]
     p = principled("Paint")
     # candy red over a faint metallic base, under a glassy clear coat: the coat
@@ -774,7 +775,8 @@ def render_still(objs, path, engine):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Studio")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -787,7 +789,8 @@ def render_still(objs, path, engine):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
     scene.world = world
 

examples/collision-hull-proxy/collision_hull_proxy.py

@@ -197,7 +197,8 @@ def lathe_object(name, profile, segments, inflate=1.0):
 
 def make_material(name, color, metallic, roughness):
     mat = bpy.data.materials.new(name)
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     bsdf = mat.node_tree.nodes["Principled BSDF"]
     bsdf.inputs["Base Color"].default_value = (*color, 1.0)
     bsdf.inputs["Metallic"].default_value = metallic
@@ -393,7 +394,8 @@ def render_still(groups, pieces, path, engine):
     # translucent shell: Transparent mixed over Principled works identically
     # in EEVEE and Cycles without touching blend-method RNA (renamed in 4.2)
     shell = bpy.data.materials.new("HullShell")
-    shell.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        shell.use_nodes = True
     nt = shell.node_tree
     nt.nodes.clear()
     out = nt.nodes.new("ShaderNodeOutputMaterial")
@@ -440,7 +442,8 @@ def render_still(groups, pieces, path, engine):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
     scene.world = world
 

examples/color-attribute-wheel/color_attribute_wheel.py

@@ -165,7 +165,8 @@ def eevee_engine_id():
 
 def build_material():
     mat = bpy.data.materials.new("Wheel")
-    mat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        mat.use_nodes = True
     nt = mat.node_tree
     bsdf = nt.nodes["Principled BSDF"]
     attr_node = nt.nodes.new('ShaderNodeAttribute')
@@ -228,7 +229,8 @@ def _beam(bm, p0, p1, w, d):
 
 def _mat(name, base, rough, metal=0.0, noise=None, coat=0.0):
     m = bpy.data.materials.new(name)
-    m.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        m.use_nodes = True
     nt = m.node_tree
     b = nt.nodes["Principled BSDF"]
     b.inputs["Base Color"].default_value = (*base, 1.0)
@@ -357,7 +359,8 @@ def plane_y(z):
     finally:
         bm.free()
     fmat = bpy.data.materials.new("Studio")
-    fmat.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        fmat.use_nodes = True
     fb = fmat.node_tree.nodes["Principled BSDF"]
     fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
     fb.inputs["Roughness"].default_value = 0.7
@@ -370,7 +373,8 @@ def plane_y(z):
     scene.collection.objects.link(wall)
 
     world = bpy.data.worlds.new("World")
-    world.use_nodes = True
+    if bpy.app.version < (5, 0, 0):  # use_nodes is deprecated on 5.x (removed in 6.0)
+        world.use_nodes = True
     world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.021, 0.025, 1.0)
     scene.world = world
 

examples/compositor-glare/README.md

@@ -4,7 +4,7 @@ A runnable example that puts bloom where it actually lives: the compositor. Thre
 emissive rings are rendered, then a `Glare` (Fog Glow) node fed by `Render Layers`
 grows the halo — wired through `scene.compositing_node_group` on Blender 5.x and
 through `scene.node_tree` on 4.x, because the 5.0 compositor rewrite removed the
-scene-level tree entirely (`scene.use_nodes = True` now raises `AttributeError`).
+scene-level tree entirely (`scene.node_tree` now raises `AttributeError`; `scene.use_nodes` survives only as a deprecated flag, removal in 6.0).
 
 The Glare node changed shape with it: on 4.x it takes legacy enum properties
 (`glare_type='FOG_GLOW'`, `quality='HIGH'`, `size=6`), while on 5.x the same