Tips & Troubleshooting                                                     

This page collects practical advice for getting the most out of Octane Light Studio, along with solutions for common issues you might encounter.

Tips

Start with one light. Resist the urge to add multiple lights at once. Place a single key light first and take the time to get its position, intensity, and color right. Only then add a fill light, and after that a rim or accent light. Building your lighting one step at a time gives you much more control over the final result than adjusting five lights simultaneously.

Use Clay Mode early. Switch to Grey clay mode before you start placing lights. Without material distractions, you can clearly see how each light shapes your subject. Once the shadows and highlights look right on  grey, switch back to full materials — you will find that good lighting on grey almost always translates to good lighting with materials.

Name your lights and layers. It takes two seconds to rename a light from "Light 1" to "Key Left" or a layer from "Layer 1" to Character Lighting." In a complex scene with a dozen or more lights, descriptive names save you from constantly guessing which light does what.

Use layer intensity as a master dimmer. Instead of adjusting every light individually when a group is too bright or too dark, use the layer intensity field. It scales all lights in the layer proportionally,  preserving the relative balance you have already established between them.

Save snapshots at decision points. Do not wait until your lighting is finished to create a snapshot. Save one after placing your key light, another after adding fill, and another after rim lighting. This gives you checkpoints to return to if your later experiments go in a direction you do not like.

Keep Realtime Snapshots off during exploration. The default manual mode protects your saved states while you experiment. Only enable Realtime Snapshots when you are in a fast iteration phase where you want every change captured immediately.

Use gradients on area lights by default. Even subtle edge gradients with low values make a noticeable difference in render quality. Real-world light sources never have perfectly sharp edges, and a small amount of edge falloff makes your CG lights look significantly more natural.

Use the viewport overlay toggles. The five overlay toggles in the Settings section let you control which information is displayed on the light beams in the viewport — light names, geometry names, intensity values, tilt angles, and geometry hit dots. Show all overlays during setup for maximum feedback, then hide what you do not need when fine-tuning to reduce visual clutter.

Build a setup library. Every time you create a lighting configuration that works well, save it as a Light Setup. Over time, you build a personal library of proven lighting solutions that you can load into any new project as a starting point instead of building from scratch every time.

Troubleshooting

The addon panel does not appear after installation. 

Make sure you installed the addon from the ZIP file without extracting it first. Blender requires the ZIP to be intact during installation. Also verify that the addon is enabled in Edit, Preferences, Add-ons by searching for "Octane Light Studio" and checking the checkbox.

Start Octane Light Studio" button does not respond.

This means the addon cannot detect a working Octane installation. Make sure the Octane Server is running in the background — without it, Octane cannot function. Also verify that you are using the Octane for Blender build, not a standard Blender installation.

Lights are created but nothing happens in the viewport.

Check that your viewport is set to Rendered shading mode. Octane lights only appear in the Octane rendered preview, not in Solid or Material Preview modes. Also confirm that the Octane Server is running.     

Light intensity slider has no visible effect.

This can happen if the light's emission node is not correctly connected. Try deleting the light and creating a new one through the addon. If the problem persists, check the Shader Editor to verify the node connections are intact.

Visual Light Linking colors are not showing.

Visual Light Linking requires objects to have Octane materials or properties. Standard Blender materials without Octane nodes will not respond to the Light ID system. Make sure your scene objects are configured  for Octane rendering.

Snapshots are not loading correctly.

Snapshots reference lights by name. If you have renamed or deleted lights outside of the addon — for example directly in Blender's Outliner — the snapshot system cannot locate them. Always use the addon's own rename and delete functions to maintain snapshot compatibility.

Light jumps to an unexpected position when activating Adjust.

This usually happens when the light is not pointing at any geometry. The Adjust system uses a raycast to find the orbit center. If the beam misses all surfaces, the orbit center may default to an unexpected location. Aim the light at your subject first using Aim Only, then activate Adjust.

Yellow viewport border stays visible after exiting a tool.

This should not happen under normal circumstances as the border is cleared instantly when a tool exits. If it persists, toggle the Adjust button off and on again, or switch to a different light and back. This forces a viewport redraw that clears the border.

Performance feels slow with many lights.

Octane render times increase with the number of active lights. Use the layer system to disable layers you are not currently working with. Lower the Max Preview value in Settings for faster viewport feedback during scene development, and reduce sampling rates on individual lights that do not need high quality during preview work.