Skip to main content

​
Prerequisites

  • Nuke 14.1v2+ (tested on Windows and macOS)
  • Beeble Nuke Plugin - Download HERE

​
Install Plugin

  1. Download and unzip the Beeble plugin folder
  2. Move the Beeble folder to your .nuke directory:
    • Linux, macOS: ~/.nuke/Beeble/
    • Windows: C:\Users\<username>\.nuke\Beeble\
  3. Open or create init.py in your .nuke folder and add:
    Path
  4. Restart Nuke, and you can find Beeble on your toolbar Beeble Toolbar

​
Quick Start

​
1. Load PBR Passes

  1. Prepare your VFX passes. It should be unzipped folder
  2. In Nuke, go to the left toolbar and click Beeble > Load PBR Passes
  3. Select the folder that contains your VFX passes. The plugin supports EXR, PNG, and MP4:
    • EXR: the folder should contain an EXR sequence where multiple passes are packed into each EXR file (e.g.Frame_000001.exr). PBR Passes
    • PNG: the folder should contain subfolders for each pass, and each subfolder holds a PNG image sequence (e.g.Normal/Normal_000001.png).
    • MP4: the folder should include one video per pass, named like <passname>.mp4 (e.g.Normal.mp4).

​
2. Add Light

Go to Beeble > Lights and select the type of light that you want. Connect the PBRController output to the light input. Add Directional Light For the Environment Light, load an HDRI file and connect it to the light input. Add Directional Light

​
3. Relight

  1. Adjust the light properties in the control panel to get your desired look. DirectionalLight Panel
  2. To add multiple lights, use a Merge node, set to plus. DirectionalLight Merge

​
Node Reference

PBR (multi-layer) refers to a single image stream containing multiple Nuke layers: Source, Normal, Basecolor, Roughness, Specular, and Metallic. This format is produced by PBRPacker (for MP4/PNG) or directly available in EXR sequences generated by Beeble.

​
Nodes

​
PBR Packer

The PBR Packer combines individual PBR pass inputs into a single multi-layer stream.
Automatically created when using Load PBR Passes with MP4/PNG. Not needed for EXR sequences as passes are already packed into layers.
  1. To add manually, go to Beeble > Helpers > PBR Packer
  2. Connect the 6 inputs: Source, Normal, Basecolor, Roughness, Specular, Metallic

​
PBR Controller

The PBR Controller allows you to fine-tune the PBR passes.
PBRController is automatically created when you use Load PBR Passes.
  1. To add manually, go to Beeble > Helpers > PBR Controller
  2. Adjust the parameters:

​
Directional Light

  1. Go to Beeble > Lights > Beeble Directional Light
  2. Connect the PBRController output to the light input
  3. Adjust the parameters:

​
Point Light

  1. Go to Beeble > Lights > Beeble Point Light
  2. Connect the PBRController output to the light input
  3. Adjust the parameters:
Double-click the PointLight gizmo and select TransformHandle to interactively position the light in the viewer. Drag to move XY position, rotate (like a screwdriver) to adjust depth.

​
Environment Light

Environment Light applies image-based lighting (IBL) using an HDRI image for realistic ambient illumination.
  1. Go to Beeble > Lights > Beeble Environment Light
  2. Connect the PBRController output to the PBR input
  3. Connect an HDRI image (Read node with .exr or .hdr) to the HDRI input
  4. Adjust the parameters:
Combine Environment Light with Directional or Point lights using a Merge node for more complex lighting setups.