As Serpens 3.0 is a major rewrite of the addons core functionality addons from Serpens 2.x will not be compatible with Serpens 3.

While this is of course unfortunate as it means you’ll likely have to rebuild your addons, we think that this is the best way to go forward. The new way of compiling and other internal structural changes allow for more flexibility and should make for a more stable experience as well as more opportunity for expansion, both from our side as well as from external packages.

If you have a complex addon that you don’t want to rebuild, you don’t have to. You can simply stick with 2.x for that addon. Just make sure you have separate blender versions for the Serpens installs as you can’t have 2.x and 3.x installed at the same time. We won’t be supporting 2.x going forward, but if it worked for you until now it should still work in the future.

If you have a less complex addon this is the perfect way of learning the changes! Take what you learned from your first implementation and rebuild the addon in Serpens 3. The core concepts are still the same, so you’ll just have to adjust to some changes, including:

• Different behavior and access to blend data
• Slightly different Easy BPY integration
• New nodes and node names

In addition to that, you of course have access to new features that you didn’t have before, like:

• Dynamically adding icons from images and displaying them as galleries
• Collection, pointer, and group properties
• Live compiling

We hope this documentation can give you insights into how to use this new version of Serpens, but as always feel free to ask questions on the discord server.

If you find parts of this documentation unclear or lacking, please let us know in the server as well!