blender-syntax-rendering

Quick Reference

Critical Warnings

NEVER use 'BLENDER_EEVEE' in Blender 4.2-4.4 — the identifier is 'BLENDER_EEVEE_NEXT' in those versions.

NEVER call bpy.ops.render.render() without write_still=True for still images — the render completes but the image is never saved to disk.

NEVER set Cycles GPU device without calling cycles_prefs.get_devices() first — the device list is empty until explicitly refreshed.

NEVER use scene.use_nodes = True in Blender 5.0+ — the compositor is always active; the attribute is deprecated.

NEVER use scene.node_tree in Blender 5.0+ — use scene.compositing_node_group instead.

NEVER use eevee.use_gtao in Blender 5.0+ — use view_layer.eevee.ambient_occlusion_distance instead.

ALWAYS use the version-safe EEVEE selection pattern when targeting multiple Blender versions.