Sollumz 2.8.0

This release is a big step forward for Sollumz. Thanks to our collaboration with Rockstar Games and Cfx.re on their new Materia library, Sollumz now supports native binary formats import and export. This means you can now work with Legacy (Gen8) and Enhanced (Gen9) binary assets directly, making the workflow smoother and more straightforward.

Check out their official announcement.

Blender 5.0 should now be fully compatible as well. This was a major update, so if you run into any issues, please let us know and report them. Sollumz continues to support Blender versions 4.0 through 4.5 too.

Highlights

Binary Formats Import/Export

A long-requested feature is finally here: direct import and export of GTAV’s native binary resource formats without requiring intermediate XML conversions. With this update, you can now work directly with .ybn, .ydr. .ydd, .yft, .yld and .ytyp files. This includes full support Legacy and Enhanced assets.

When exporting, you can choose which formats and game versions to target. For example, during development you can just export for the version you primarily work with, e.g. Legacy, then for release and final testing export to both Legacy and Enhanced simultaneously from the same .blend file. CodeWalker XML support is still and will remain available for those workflows that require it.

import_export.webm

All this is powered by PyMateria, the Python bindings for the new Materia library by Cfx.re. Upon installation of Sollumz, you will be prompted to install the new dependencies. PyMateria is an optional dependency and currently only available on Windows. If you are on a different platform, you won't be able to access the new functionality provided by PyMateria but Sollumz will continue working as it did before.

For Developers

Developers interested on trying PyMateria can install it with:

pip install --index-url https://static.cfx.re/whl/ pymateria

Important: before using PyMateria, please make sure to read and understand the PyMateria License Agreement.

We also have a new library, szio. Independent from Blender, provides an unified interface for working with game files in any format, binary or CW XML. This is what Sollumz now uses for its import and export functionality. Can be installed with:

pip install szio

Automatic Vehicle Windows Shattermap Generation

Creating shattermaps for vehicle windows has always been a tedious process. This update introduces automatic shattermap generation on export, with the same quality as the shattermaps found on vanilla vehicles. Note that this requires PyMateria to be installed.

To use this functionality, make sure you setup your vehicle models correctly:

• Set window meshes to use VEHICLE VEHGLASS shader.
• Set the associated collisions to use one of the CAR GLASS materials. CAR GLASS BULLETPROOF will make it undestructible.
• On the mesh, the blue channel of color attribute Color 1 allows you to define the exposed edges of the window (those without a frame around them). These edges will break cleanly without leaving a border of broken glass.

The old workflow with manual shattermaps is still available so your existing projects will work as they did before, but we recommend switching to the automatic generation. If you want to keep the manual shattermaps when importing a vehicle, you can enable the new import setting Import Window Shattermaps.

This example shows the new Preview Windows button which lets you inspect the generated shattermaps. This allows you to verify that your vehicle windows are setup correctly without going in-game.

preview_windows.webm

Vertex Paint Tools

This release also brings new tools available in vertex paint mode. You can find them in the new "Vertex Paint" side panel.

• Isolate Channel. View and paint specific color channels, including the alpha channel.
• Multi-Object Vertex Paint. Paint multiple objects at the same time.
• Transfer Channels. Copy channels between color attributes.
• Palette Picker. Used along with tint shaders, works like a color picker that sets the correct brush color for the column you select from a palette texture in an Image Editor.
• Gradient. Paints a gradient between two points.
• Terrain Painter. The old Terrain Painter panel has been moved here.

vertex_paint_isolate_multi.webm

vertex_paint_gradient.webm

vertex_paint_palette.webm

Most of these functions are also available through a new vertex paint pie menu. The default keybind is Shift+T.

Name Tables

Sollumz can now load name tables and will attempt to resolve hashed names when importing assets. With proper name tables (shared by the community or your own), this will reduce the amount of hash_1234ABCD names you find after importing assets. This is particularly important when importing binary drawable dictionary .ydd files.

You can configure which name table files to load under Preferences > General. Simply add your .txt or .nametable files to the list:

Changelog

Features

• Support direct import/export of binary resource formats, including Legacy (Gen8) and Enhanced (Gen9) assets.
  • This functionality depends on PyMateria which is only available on Windows at the moment.
  • Note: YMAP and YCD files still require CodeWalker XML.
• (yft) Add automatic vehicle windows shattermaps generation on export. (#913)
  • Requires PyMateria.
  • Added a 'Preview Windows' button in the Fragment > Vehicle Tools panel to inspect generated shattermaps.
  • Existing workflow with manual shattermaps is still supported but is no longer recommended.
• Support name tables to resolve hashes in imported files. The list of name table files to load can be configured in the preferences.
• (ytyp) Add 'Selection Sync Enabled by Default' setting to preferences. (a1d978a)
• (ui) Display Sollumz version in status bar. Can be toggled in the preferences. (4c06e53)
• (ui) Add room name dropdown next to 'Room ID' collision material property. (4d54111)
• (ui) Allow non-sollumz material conversion from material properties. (#1110, 10d4dcc) [@dolutattoo]
• Remove old "Debug" panel. (9694ac9)
• (ui) Add name dropdown next to 'Procedural ID' collision material property. (78653a2)
• Vertex Paint tools:
  • (vertex_paint) Isolate channels and paint gradient tools. (df9d72a)
  • (vertex_paint) Transfer color channels tool. (62a6e10)
  • (vertex_paint) Multi-object vertex paint tool. (5789a96)
  • (vertex_paint) Add tint palette color picker (#1123). (#1123, 26cdda6, de27772) [@El-Extraterrestre]
  • (shader) Tint geonodes work with isolated blue channel of color attribute. (aa82ae2)
• (multiselect) Add "Invert" selection button to collections context menus. (c016bb0)

Bug Fixes

• (ydr) 'Update tinted shaders' button not updating attribute name in shader nodes. (#1106, d1be84c)
• (yft) Allow importing damaged fragments with missing damaged physics archetype. (#1047, 2c468c2)
• Missing properties in unregister. (685ee5a)
• (ytyp) Update MLO gizmos instantly on item selection. (68c7974)
• (ytyp) Error on selection sync with an empty scene. (5096a9f)
• (yld) Reduce normals artifacts on ped cloths. (#1092, e836fa6)
• (ytyp) Selection sync blocks YTYP list. (#1112, 93b5f7b)
• (ydr) Allow any mesh to use the 'Rename by Order'/'Add Missing' buttons instead of only Drawable Models. (9758ea3)
• (ybn) Inverted faces in bound capsule mesh. (4c747e0)
• (ytyp) Limit time properites to 0-24h range for SpawnPoint extension (#1115). (#1115, 1bd74a3) [@cpmodding]
• (ytyp) Use MLO name instead of asset name for collections created on import. (779c543)
• (ydr) Import of ped_decal_exp shaders in gen9 assets. (bff0d43)
• (vertex_paint) Handle unified and per-brush settings. (8e05055)
• *(yft)...

Sollumz 2.7.2

Minor update with some quality-of-life improvements and bug fixes.

Changelog

Features

• (ytyp) Two-way selection sync for archetypes/MLO entities. (c40b507)

selection-sync.mp4

• (ytyp) Gizmos for MLO timecycle modifiers. (cad09e3)

tcm-gizmos.mp4

Bug Fixes

• (ydr) Unassigned textures in materials exported as "None". (#1090, d168e2f)
• (yld) Temporary skeleton getting exported to XML. (3be1004)
• (yld) Corrupted meshes when importing ped cloths with extra edges. (f4ed859)
• Terrain painter tools broken in Blender 4.4. Now these tools change the color of the current brush instead of creating a new brush. (1a90f04)
• (ytyp) Allow negative values in "Door Target Ratio" from door extension. (2182cca)
• (ydr) Show warning about unknown vertex groups instead of a misleading "unweighted vertices" message. (ff5ccb2)
• Compatibility fixes with Blender 4.5 Beta (aa246f4, b2dccaa)
• (ymap) Error during entity instancing on YDD models. (c62ebc9)

Other Changes

• (shaders) Use specMapIntMask to properly mask specular textures. (#1099, 05ab8c1) [@ook3D]

Support Sollumz

If you have found Sollumz useful, please consider supporting its development through:

• Open Collective
• GitHub Sponsors

Sollumz 2.7.1

Hotfix to address a regression where vehicles lost glass shattermaps and wheel LODs on export. See v2.7.0 for full release notes.

Changelog

Bug Fixes

• (yft) Missing vehicle glass shattermaps and wheel LODs on export. (#1087, fc7a71d)
• (yft) Show 'Has Cloth' flag on bone fragment physics properties again. (315fcba)
• (ytyp) Error if no selected vertices in extension update operators. (23fc370)

Other Changes

• (prefs) Add theme settings for MLO portals direction arrows. (c5a614b)

Support Sollumz

If you have found Sollumz useful, please consider supporting its development through:

• Open Collective
• GitHub Sponsors

Sollumz 2.7.0

Highlights

Cloth Support

Import and export of cloth simulation assets is now supported. This includes cloth embedded in vehicle and prop fragments (YFT) as well as character cloth (YLD).

For character cloth, the YLD file is automatically imported or exported together with the corresponding ped drawable dictionary (YDD) file.

A new 'Cloth Tools' panel provides various utilities to configure and visualize cloth-specific attributes and diagnose potential setup issues.

Multi-Selection Support in Archetypes/MLO UI

The item lists in the Archetypes and MLO UI panels now support multi-selection. When multiple items are selected, changes to properties will apply to all selected items simultaneously. Properties that cannot be edited across multiple items will be shown as disabled (greyed out).

Multi-selection follows standard list controls:

• Shift + Click: Extends the selection range.
• Ctrl + Click: Toggles selection of individual items.

Additionally, new buttons have been added next to the lists to select all items with a single click, taking into account the current filter.

multiselection.mp4

Improved Vehicle Shader Preview

You can now preview vehicle shaders more accurately within Blender, including dirt level, paint colors, and lighting (on/off states).

vehicle-shader-preview.mp4

Changelog

Features

• Support cloth simulation assets. (#763, 7488769)
• (ytyp) Support multiselection in archetype/MLO lists (#1064). (#1064, c351a72)
• (shader) Vehicle preview for dirt, colors and light emissives. (#1010, #999, af59d54)
• (ydr/ui) Add a button to material tab to update tint shader modifier (#1072). (#1072, 531d429) [@tiwabs]
• (ytyp) Add default values for flags in preferences (#1074). (#1074, d0f00b8) [@tiwabs]
• (ydr) Support freemode head model export with "Mesh Domain" export setting. (#646, d833c87)
• (ui) Redesign preferences UI. (4bbc747)
• Add preferences for MLO gizmos colors. (4bbc747)

Bug Fixes

• (ybn) Centroid calculation hangs during export. (a3d66ba)
• (shader) Use shader preset name instead of fxc name as material name. (60a3163)
• (ydr) Models attached to bones misplaced when imported to asset library. (#1044, 15307b4)
• (ydr) Correct models origin when imported to asset library. (d4152e7)
• (ui) Fix visibility pie menu missing LOD options. (c8a5e65)
• (shader) Set decals render method to 'Blended'. (cc486c4)
• (ui) Fix minor incompatibility with Blender 4.0. (b69e43f)
• (ydr) Fix crash when generating LODs in Edit mode. (42b8735)
• (ydr) Fix "Generate LODs" only decimating selected vertices. (5e1df0e)
• (ytyp) Incorrect type of SpawnPointOverrideProperties.time_till_ped_leaves. (c9e029d)
• (ymap) Incorrect entities extents calculation. (38dd672)
• (ydd) Fix incorrect drawables order when names are hashed. (0af4434)
• (ydrexport) Emit warning when duplicate material is found in list (#1062). (#1062, 66760d0) [@niekschoemaker]
• (ybn) BVH meshes cutting off on CW import. (3deba2a)
• (ydr) Correct handling of non-color data colorspace. (fdd9e4b)
• (ytyp) Name search not working on entities and portals lists. (#1066, 3bdd064)
• (shader) Light IDs affecting vehicle shader alpha rendering. (0192430)
• (ytyp) Export MLO entity transforms relative to collisions object. (6b309e5)
• (yft) Wheel mesh duplication on export. (#1067, 25f293a)
• Possible crash with "Import To Asset Library". (82382e9)
• (shader) Handle error when converting materials (#1076). (#1076, ad1a49f) [@ook3D]
• (ytyp) Handle error when object missing from view layer (#1081). (#1081, c1ceced) [@ook3D]
• (ui) In Edit mode disable LOD switching buttons in pie menu. (#1080, f5d1b00)
• (ui) Empty shader/collision materials lists after installation. (cffa2da)
• (ytyp) Unhandled errors in extension update operators (#1086). (#1086, 007014c) [@DarkWolf197]

Other Changes

• (ytyp) Altered default draw distance values (#1046). (#1046, 6822e83) [@cpmodding]
• Change default colors of vertex painter presets. (#5, #6, ad5a3cc)
• (shaders) Improve water shaders (#1075). (#1075, fbb8248) [@ook3D]
• (ydr) Refactor code duplication (#1083). (#1083, 90f12fc) [@DarkWolf197]
• (shader) Hide more shader parameters overwritten at runtime. (24ae6a4)
• (yft) Remove bone fragment physics flag 'Has Cloth'. (f6943fe)

Support Sollumz

If you have found Sollumz useful, please consider supporting its development through:

• Open Collective
• GitHub Sponsors

Sollumz 2.6.1

Minor update focusing on bug fixes.

Changelog

Bug Fixes

• (ydr,ybn) Ignore '_' and spaces when searching shaders and collision materials. (713bd58)
• (ytyp) Properly set fragment assets. (#1038, 70216f1) [@ook3D]
• (shader) Fix error when trying to rename color attributes by order. (782a080)
• (ydr) Fix error in capsule light gizmo when there is no active object. (ac105a8)
• (ybn) Fix model lights flickering/weird behavior in some cases. (77b7187)
• (ymap) Use correct property to store model occluder flags. (bedf412)
• (ybn) Evaluate collision meshes on export. (#1042, 8e54e52)
• (ydr, ybn) Free temporary export meshes after using them. (6d334c6)

Performance

• (ytyp) Improve MLO export times and fix stutters when filtering by portal. (#1036, #801, 46c74ac)

Support Sollumz

If you have found Sollumz useful, please consider supporting its development through:

• Open Collective
• GitHub Sponsors

Sollumz 2.6.0

Highlights

Support Sollumz Development

Sollumz is made possible through the dedication of its developers and the support of its community. If you have found Sollumz useful for your projects and want to support its continued development of new features and improvements, please consider contributing.

You can support the development by donating through:

• Open Collective
• GitHub Sponsors

All supporters will receive a special role and gain access to an exclusive channel on our Discord.

Damaged Model Support

Fragments with damaged models can now be imported and exported. These fragments contain an additional drawable and bound composite that replace the main model when entering "damaged" state.

Favorites System for Shaders & Collision Materials

You can now mark specific entries in the shaders and collision materials lists as favorites. A new filter toggle lets you easily view only your favorites.

Changing Material Shader

Now, you can change the shader of a material while preserving its parameters and without the need to create a new material.

Changelog

Features

• (ydr) Tagging and filtering favorite shaders. (#990, bc0ac23)
• (ybn) Tagging and filtering favorite collision materials. (#992, 4648122)
• (ybn) Apply selected flag preset to created/converted bounds. (#1000, #1001, 93f25ef) [@Molicheu]
• (shader) Automatically rename or add missing UVs/color attributes when creating a shader. (fd7e425)
• (yft) Support damaged model fragments. (#489, 338cc7d)
• (shader) Add shader presets. (#787, #1027, f7104c5, db336a0) [@Flyken271]
• (ytyp) Select the linked object of an entity/archetype. (#1019, #946, 3b69dc5) [@ook3D]
• Add buttons to open presets XML files. (7b27b44)
• (shader) Support changing the shader of a material in-place. (9811f0e)

Bug Fixes

• (yft) Paint layer now backed by 'matDiffuseColor' parameter. (#997, 944c0a8)
• (shader) Incorrect render bucket for 'normal_spec_batch' shader. (1a30910)
• (ybn) Calculate inertia of composite bounds. (0b1f4ef)
• (ybn) Incorrect composite cg/centroid calculation. (2bd968a)
• (ytyp) Support 'swap while visible' flag on time archetypes. (#1013, db7cf64)
• (ycd) Rename action groups when retargeting to an armature. (7bc2a03)
• (yft) Override composite CG with physics LOD CG. (#1017, 3476795)
• (ybn) Hide 'shape' properties on certain bound geometry. (#1028, #1023, 8f60f39) [@Flyken271]
• (shader) Incorrect display of some tint palette pixels. (#1029, 8a6d87c)
• (shader) Broken cutout hard edges in Blender 4.2+. (#1002, 32e85a7)
• (ycd) Workaround for deformed ped legs during animation playback. (#1011, c433435)
• (ybn) Improve error handling during bounds export. (#962, 55d4e9c)
• (ycd) Improve error handling with empty actions. (#953, 9e651ac)
• (yft) Improve error handling when no physics children got exported. (14264c3)
• (yft) Calculate fragment flags (UnknownC4) on export. (e575827)
• (ybn) Prevent .ybn export with non-composite bounds. (272b98e)
• (shader) Fix import error when tints have too long palette texture names. (#1035, 79400f9)
• (ydr) Don't export textures/parameters not defined in shaders. (33b6f87)
• (ybn) Remove "split collision" tool. (38a62bc)
• Ensure edit bmeshes are properly freed after use. (#987, 3b32be9)

Other Changes

• (lods) Highlight current LOD in General > View panel buttons. (#995, 83a5762)
• (ybn) Use diffuse BSDF and set diffuse_color on collision materials. (124350d)
• (ybn) Hide bound objects from render. (6bf4f98)
• (ymap) Set diffuse_color on occluder materials. (cd6459f)
• (ytyp) Allow ytyp import with "Import CW XML" button and drag&drop. (42d0e68)
• (ydr) Add warning when exporting with missing UV maps/color attributes. (#952, ce707f4)
• (ytyp) Improve particle extension UI. (6c8772c)
• (ytyp) Improve explosion extension UI. (997f123)
• (ytyp) Show bone name instead of tag for particle/explosion/wind disturbance extensions. (6c8772c, 2b90802)
• (ytyp) Add icons for extension types. (966a852)
• (yft) Show name in "Selection Light ID" instead of just ID value. (ff49c29)

Performance

• (ymap) Improve occluders import times. (f7243e0)

Sollumz 2.5.0

Highlights

Blender 4.2 & Extensions Repository

Added support for Blender 4.2 and now Sollumz can be installed as an extension from our repository https://repo.sollumz.org/.

• First, add https://repo.sollumz.org/ as a remote repository by navigating to Preferences > Get Extensions > Repositories > + > Add Remote Repository:
  

• Next, search for "Sollumz". You will see two available versions to install:

1. Sollumz: The official release version, identical to what you can download from this page.
2. Sollumz (Development): The latest development build, which may be unstable. Use this version to test new features and updates, and provide feedback to help us improve.
   

• Once installed, you can easily update to newer versions directly within Blender whenever they are released.
  

Cable Meshes Support

Meshes using the cable shader can now be imported and exported. These are simplified meshes containing only vertices and edges, with no faces. Each vertex includes several user-editable attributes, such as cable radius and micromovements scale. To modify cable meshes, explore the new Cable Tools panel located under Sollumz Tools > Drawables.

Shared Textures Directories

The new Shared Textures preference lets you specify additional directories to search for textures during model import. If a texture isn't found in the model's texture directory, these directories will be searched for a match.

Changelog

Features

• Added support for Blender 4.2.
• Sollumz is now installed as an extension, also available through https://repo.sollumz.org.
• Shared textures directories to search in during import. Available under the add-on preferences. (fddf77b)
• (ytyp) Support Light Effect entity extension. (323e22b)
• (ydr) Support cable meshes. (3c627dc)
• (ybn) Allow to explicitly choose a parent in 'Create Box from Selection'. (#938, 10bb73b)
• (ytyp) Add 'update location' button to all extensions. (#929, 11f5f5f)
• Show Info Log if any warnings/errors ocurred during export. (a59af37)
• (ymap) Add calculate extents. (#944, #976, 2055114) [@PichotM]

Bug Fixes

• (yft) Use filename as name for imported object. (268e39a)
• (lods) Rework LOD system to prevent 'not single-user' warnings/mesh duplication. (#858, f2ca3de)
• (ytyp) Change timecycle mod percentage type to float. (#898, b4a2a37)
• (ytyp) Define missing special attribute 4. (#897, a632d20)
• (ydr) Export correct light position when matrix_parent_inverse is set. (#865, bac5e48)
• (yft) Handle malformed shattermaps. (#906, baa1028) [@ook3D]
• (ytyp) Fix use-after-free crashes when modifying archetype extensions. (28562d8)
• (ui) Fix descriptions ending with double-dot. (f807a73)
• (ui) Fix shaders list empty on new scene. (#609, 64c69dc)
• (ui) Fix presets and collision materials lists empty on new scene. (b73cfa4)
• (yft) Pack imported shattermaps into the current blend file. (#915, 26b978f) [@ook3D]
• (lods) Fix imported models not defaulting to very-high LOD when available. (0512a0b)
• (ytyp) Show different extension types for archetypes and entities. (#907, 606c228)
• (ydr) Fix importing models with degenerate triangles crashes/hangs Blender. (#862, e7e9325)
• Fix import/export errors when using .blend relative paths. (#919, 47a3b50)
• (yft) Fix export errors when bones have .00# suffix. (4254d1b)
• (ydr) Update tint geometry nodes for Blender 4.2. (bf78d08)
• Use COPY_TRANSFORM constraint instead of CHILD_OF for object-bone parenting. (5007b7c)
• (ycd) Fix errors on unsupported f-curve data paths. (#887, 8b7e21b)
• (ybn) Improve bounds properties calculation. (#860, 52f8e35)
• (ybn) Improve capsule bounds mesh topology. (53946e1)
• Broken path for default presets when installed as extension. (b392293)
• (ybn) Fix location offset ignored on root embedded bounds. (3daaaeb, 6c153f3, dde61fc)
• (ydr) Disallow exporting multiple root embedded bounds. (d61e877)
• (shader) Add missing 'terrain_cb_4lyr_lod' shader definition. (#942, 5120b1a)
• (ytyp) Correctly import lod_dist from xml (#950). (#950, afe7108) [@niekschoemaker]
• (ytyp) Cache get_name for PortalProperties. (49a486f) [@niekschoemaker]
• (ytyphelper) Change is not to != for file path. (cd1ae61) [@niekschoemaker]
• Make import operator callable from bpy.ops. (053efc9)
• (ydr) Fix light gizmos consuming all input events. (#966, d84f74a)
• (ydr) Add warning when attempting to add shader to non mesh object. (#961, #982, 50efa04) [@ook3D]

Other Changes

• (ydr) Refactor how vertex groups are processed. (#895, #845, 5dd6fa3) [@Loyalists]
• (yft) Always import _hi.yft.xml if it exists. (#912, 0cd63b3)
• (light) Improved light creation. (#903, 8d4cc20) [@Hancapo]
• (ydr) Enforce UV maps/color attributes names on export. (#800, 1ea484c)
  • Added a warning under the UV Maps and Color Attributes panels when a mesh is missing any of the UV maps or color attributes used in any of its shaders.
• Remove 'scale light intensity' option. (838fccb)
• Add Blender version check to prevent loading on incompatible versions (#948). (#948, cd62c9f) [@clementinise]
• Add single instance check to prevent loading multiple Sollumz versions. (18d411c)
• (ydr) Add warning when exporting unweighted vertices. (46db59a)
• (shader) More accurate decal_dirt rendering. (1b265c8)
• (ytyp/ymap) Lookup the whole .blend for models when instancing MLO/YMAP entities. (#918, ed718ea)
• (obb) Rework oriented bounding box calculations. (fde4436) [@niekschoemaker]
• (shader) Improve and simplify water shader (#977). (#977, fad4383) [@ook3D]
• (ynv) If poly flags match, use same material (#978). (#978, a84b5db) [@ook3D]
• (ymap) Don't limit ymap entities to drawables (#980). (#980, 8b5a975) [@ook3D]
• Improve descriptions for import options (#984). (#984, 110c7d7) [@ook3D]
• (ydr) Organize UV map shader nodes (#983). (#983, 90ee266) [@ook3D]

Sollumz 2.4.2

Minor update focusing on bug fixes.

Changelog

Features

• (ytyp) MLO entities instancing on import. (#867, 57c89d6)
• Support drag-and-drop for importing CW XML in Blender 4.1. (042ef41)

Bug Fixes

• (ytyp) Support entity set entities attached to portals. (a5b18de)
• (ytyp/ymap) Properly set duplicated object constraints. (#882, a0cda9e) [@ook3D]
• (ydr) Models missing on import. (#883, a6f7cb8)
• (shader) Missing dimmerSetPacked param on vehicle_track_siren. (e03f055)
• (ydr) Handle floating-point imprecision in vertex deduplication. (1a875ac)
• (ymap) Operator poll() errors when no active object in context. (4c857cf)
• Tab toggle operators were never unregistered. (8dd362b)
• Missing __init__.py in some packages. (313344c)
• Support Blender's "Reload Scripts" operator. (b93aabd)
• (ydr) Handle the converted weights where the sum isn't 255. (#893, #831, 81883a4) [@Loyalists]

Other Changes

• (ymap) Select ymap group object on creation and prevent X/Y rotation on Box Occluders and Car Generators. (#879, c18cc9d) [@dolutattoo]

Sollumz 2.4.1

Minor compatibility update adding support for Blender 4.1.

Changelog

Bug Fixes

• Support Blender 4.1. (#868, 77e7ead)
• (ydr) LOD meshes attached to wrong bones on import. (#876, 53a86f4)
• (ycd) Export property bool attributes as integer values. (#875, 6dab157)
• (ui) Remove useless 'Misc > Options' panel. (fe421ff)

Sollumz 2.4

Highlights

Versioning System

Sollumz 2.4 introduces a new data versioning system that aims to make Sollumz backward compatible with .blend files saved on older Sollumz versions, reducing obstacles when wanting to update Sollumz but still having unfinished projects. As a result, projects created with Sollumz 2.3 or 2.3.1 are compatible with 2.4.

When opening .blend files saved with an old Sollumz version for the first time on a newer version, an automatic upgrade process occurs that changes old Sollumz data to be compatible with the current Sollumz version.

Capsule Light Gizmo

Capsule lights now have a gizmo that shows the capsule bounds, providing visual feedback closer to how the light would appear in-game.

Capsule lights can now also be resized in the 3D view via a cage gizmo that appears when hovering the active capsule light, similar to how built-in light gizmos work.

capsule_light.webm

Light Culling Plane Gizmo

Lights with culling plane enabled will now show a gizmo representing the culling plane. This gizmo is a round plane with a cross pattern and arrows to indicate in which side of the culling plane the light is visible. It can be interacted with to move the culling plane along its normal (change its offset).

To change the culling plane normal, there is a new workspace tool “Edit Light Culling Planes” that will show a rotation widget to modify the normal on the selected light. The tool UI also has buttons to flip the plane or set its normal to the XYZ axes.

culling_plane.webm

Typed Shader Parameters

Shader value parameters are now aware of their data type and the UI will display an appropriate widget instead of always four values. For example: from one up to four values, a color picker for RGB and RGBA parameters or a checkbox for boolean parameters. This removes a lot of useless values from the UI, reducing the visual clutter in the panel. In addition, the “Array Parameters” panel has been merged with the “Value Parameters” panel.

Changelog

Features

• (shader) Typed shader parameters. (a588b5a)
• (ydr) Render gizmos for capsule lights. (6d1e9c8)
• (ydr) Interactive capsule light gizmos. (6d8ea2d)
• Versioning system. (5c6b049)
• (ydr) Automatically set model matrix count and flags on export. (223cd1f)
• (ydr) Buttons to move shaders to top or bottom in Order Shaders. (a8da4ea)
• (ydr) Light culling plane gizmo. (#786, d9a7b85)

Bug Fixes

• (shader) Group texture nodes to prevent overlap. (#814, #815, 9ceeedb) [@ook3D]
• (yft) "Rotation Strength" modified the wrong property and "Restoring Strength" was missing. (f01e898)
• (ymap) Incorrect hex color parsing. (#819, 88e13b2)
• (shader) Default mirror shaders draw bucket to 1. (9c50bfd)
• (ymap) Error when loading cargen mesh .obj. (#825, a110936)
• (ycd) Solve some import/export inconsistencies. (#335, d02ac17)
• (ytyp) Export ignored MLO flags. (7fa0f26)
• IndexError when setting flags total on FlagPropertyGroup. (befed68)
• (shader) Add missing vehicle_siren_track shader definition. (155d615)
• (ydr) Drawable not inheriting objects rotation. (#838, 6f170a4) [@ook3D]
• (ydr) Export light shadow_blur as int instead of float. (3e9de3c)
• (ydr) Possible export error when textures original path and export path are the same. (ed70ecf)
• (shader) Use existing UV map nodes for UV anim nodes. (#842, 17dc6b9)
• (yft) Incorrect group parent index when direct parent bone has no physics enabled. (#841, c65d8f2)
• (shader) Parameter UI order changed when active node changed. (8636bac)
• (yft) Calculation of 'Physics > LOD1 > Transforms' in exported XML. (#844, #855, 2a079c5)

Other Changes

• (ybn) Improve YBN import speeds. (#849, b1b9fa2) [@ook3D]
• Light and collision flags presets are now saved in Blender config directory. (#853, 7c39e99)
• Link wiki and issue tracker in add-on info. (e935917)
• Various UI improvements:
  • (shader) Texture and parameter nodes are now labelled with their names. (d5d9135)
  • (shader) Allow linking texture images from material properties panel. (7561f62)
  • (ydr) Update light flags to correct names. (#838, 4a56d22) [@ook3D]
  • (yft) Update fragment properties names. (268453b)
  • (ydr) Update unknown_1 name and remove unused unknown_9a. (#835, 757fb68) [@ook3D]
  • (ydr) Remove unused shader group unknown_30. (f32f2da)
  • (ydr) Compact Lod Distance UI. (#832, 6c05767) [@ook3D]
  • Name fragment unknowns and ytyp/ymap flags. (#818, d9f0287) [@ook3D]
  • (ydr) Update light flags names. (26c36a3)
  • Remove unused time flags. (#828, 989a537) [@ook3D]
  • (shader) Change render buckets to enum dropdown list. (#833, 0a7457a) [@ook3D]
  • (yft) Clean up bone fragment physics panel. (2ddce15)
  • (ydr) Cleaner light properties UI. (#838, 872ceb4) [@ook3D]
  • (ytyp) Update special atttributes to enum dropdown. (#850, 789c1e3) [@ook3D]
  • (ytyp) Use enum dropdown in light shaft flashiness. (fa8730f)
  • (ytyp) Use checkboxes for light shaft flags. (a6dd4cc)
  • (ybn) Make flag presets UI more consistent with light presets. (91c5f01)