Open-source project
LuxCoreRender/BlendLuxCore avatar
LuxCoreRender/BlendLuxCore

BlendLuxCore: putting the LuxCore renderer inside Blender

Blender Integration for LuxCore

884 stars107 forksPythonGPL-3.0

At a glance

What is it?
BlendLuxCore is the Blender add-on that integrates the LuxCore render engine, offering accelerated rendering of indirect light and efficient rendering of caustics. The current line targets Blender 4.5 LTS and 5.2 LTS on four platforms, and the project recommends building the extension through GitHub Actions rather than on your own machine.
Who is it for?
BlendLuxCore suits a Blender artist who has outgrown Cycles for a given shot, or who needs caustics and fast indirect lighting that a rasteriser cannot do, and who is prepared to match the add-on version to the Blender version. It does not suit a project on an older Blender without checking the compatibility table, and it is not a simple install, because the readme asks you to uninstall any previous copy before installing from disk.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 5 days ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 22, 2026, and from our analysis. They are not legal advice.

Editorial analysis

What the add-on actually adds over Cycles

The addon integrates the LuxCore render engine into Blender, and the features it advertises are specific: accelerated rendering of indirect light and efficient rendering of caustics. Both of those are the places where a rasteriser is weak, since a path tracer handles them naturally but a rasteriser either approximates them badly or cannot do them at all. Caustics are the clearest case, because light refracting through a glass surface onto a floor is what a path tracer traces and what a rasteriser fakes. So the practical question for an artist is whether the specific shot in front of them needs those qualities, and if it does, whether the extra render time is worth it. The project is a Blender integration rather than a renderer of its own, and the primary language of the repository is Python, which is the language Blender's add-on API is written against. The example render on the readme is a dark mode scene, which is a good hint about the kind of work this is used for.

The version matrix is a hard constraint, not a suggestion

The compatibility section is the most important operational information in the readme, and it is laid out as a table of add-on release against Blender release. BlendLuxCore v2.11.x officially supports Blender versions 4.5 LTS and 5.2 LTS, and support for other 4.x and non-LTS releases has not been tested and is not guaranteed. The history is listed going backwards: Blender 4.2 LTS is supported by v2.10, Blender 2.93 by v2.6, Blender 2.83 to 2.92 by v2.5, Blender 2.83 by v2.4, Blender 2.80, 2.81 and 2.82 by v2.2 and v2.3, and Blender 2.79 by v2.0, v2.1 and v2.2. The supported platforms for the current line are Windows x86_64, Linux, MacOS Intel and MacOS ARM, while the previous releases listed only Windows, Linux and MacOS Intel, so MacOS ARM support is a recent addition. The two long term support releases are the safe pairing, and the add-on line follows Blender's own release cycle rather than staying on the newest one.

Installing from a release zip means uninstalling the old one first

The recommended installation path is the release page, and it is four steps with one trap in the middle. Find the latest suitable BlendLuxCore release, download the extension archive named BlendLuxCore-*.zip from the release assets, open Blender and follow the Install from disk procedure. The trap is that you must uninstall any previous version of BlendLuxCore before doing this, which you do in the Get Extensions panel, and the same advice is repeated for the source build path. This is the standard behaviour of Blender extensions, where the installed copy is a registered extension rather than a loose script, so a new copy does not simply replace the old one. The wiki has a more detailed installation guide at the BlendLuxCore Installation page, and the readme links to it for the cases where the short version is not enough.

Building it locally, and why the project says not to

The source build path exists and is documented, but the recommendation attached to it is unusual: it is recommended to build the extension using GitHub Actions in a local fork. The prerequisites are cmake and blender installed and in your PATH. The sequence is to clone the repository, configure and build:

bash
git clone https://github.com/LuxCoreRender/BlendLuxCore.git
cmake -S BlendLuxCore -B blc-build -DCMAKE_BUILD_TYPE=Release
cmake --build blc-build

The build script then places the collected zip file in the blc-build/out subfolder. There is a second build type, Latest, which you pass instead of Release at the configure step when you want to create a Latest release. The advice to use GitHub Actions in a fork is a workaround for the fact that a native build needs a matching Blender build environment, and letting the project's own workflow produce the archive avoids reproducing that locally. After the build, the same Install from disk procedure applies, and the readme suggests uninstalling a previous version first, this time as a recommendation rather than a requirement.

A companion extension for development and debugging

There is a separate extension for working on BlendLuxCore, and the readme recommends installing the two together if you are developing the addon, and optionally LuxCore itself. That companion is BlendLuxHelper, a separate repository, and the wiki has a full guide for developing and debugging BlendLuxCore. The existence of a second extension says something about the shape of the project, since a renderer integration of this size needs more than a single Python module, and the repository layout reflects that division into many packages. There is a draw directory, an engine directory, an export directory, a nodes directory, an operators directory, a properties directory, a ui directory, a preview_scene directory, a luxloader directory, a handlers directory, a utils directory, a cmake directory, a scripts directory, a doc directory, a debug-helpers directory, and an icons and a thumbnails directory for the interface assets. There is also a CMakeLists.txt at the root and a blender_manifest.toml, the latter being the manifest Blender itself reads to register the extension.

Where the project lives and how to get help

The supporting resources are listed in a block of important links, and the split between them tells you where a question belongs. The homepage is the LuxCore project site, with a wiki for documentation, a gallery for finished work, and a page of example scenes. There are forums, a Discord server, and a note that in case of questions or support you should open an issue on GitHub or get in touch via the forums or the Discord server. The example scenes page is the practical resource, because a renderer integration is best judged by what it can produce, and the addon is aimed at people who already know the engine. The repository itself is not archived, the last push was on 2026-10-17, and the release history shows v2.11.1 in September 2026, v2.11.0 in July, and a v2.11.0 alpha in June, which is a steady cadence for a project that follows Blender's release schedule rather than shipping on its own timeline.

Editorial conclusion

BlendLuxCore suits a Blender artist who has outgrown Cycles for a given shot, or who needs caustics and fast indirect lighting that a rasteriser cannot do, and who is prepared to match the add-on version to the Blender version. It does not suit a project on an older Blender without checking the compatibility table, and it is not a simple install, because the readme asks you to uninstall any previous copy before installing from disk. Before you install, read the version matrix, because each BlendLuxCore release line pins specific Blender releases, and check that your platform is one of the four supported ones, since the previous releases dropped MacOS ARM.

Frequently asked questions

Which Blender versions does BlendLuxCore support?

BlendLuxCore v2.11.x officially supports Blender 4.5 LTS and 5.2 LTS, and other 4.x and non-LTS releases are not tested and not guaranteed. Older pairs work too: Blender 4.2 LTS with v2.10, Blender 2.93 with v2.6, Blender 2.83 to 2.92 with v2.5, and Blender 2.79 with v2.0 to v2.2.

How do I install BlendLuxCore from a release?

Find the latest suitable release, download the BlendLuxCore-*.zip from the release assets, and use Blender's Install from disk procedure. You must uninstall any previous version of BlendLuxCore first, through the Get Extensions panel, and the wiki has a fuller installation guide.

Can I build BlendLuxCore from source?

Yes, with cmake and blender installed and in your PATH. Clone the repository, configure with cmake -S BlendLuxCore -B blc-build -DCMAKE_BUILD_TYPE=Release, and build with cmake --build blc-build, and the archive lands in the blc-build/out subfolder. The project recommends using GitHub Actions in a local fork instead of building natively.

What does BlendLuxCore add compared to Blender's own renderer?

It integrates the LuxCore render engine into Blender and advertises accelerated rendering of indirect light and efficient rendering of caustics, the two areas where a rasteriser has to approximate. It is a renderer integration rather than a renderer of its own, and it is written in Python against Blender's add-on API.

Official sources

  1. Issues
  2. License: GPL-3.0
  3. LuxCoreRender/BlendLuxCore on GitHub
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/luxcorerender-blendluxcore.svg)](https://hysenlabs.com/projects/luxcorerender-blendluxcore)

Was this useful?