For the complete documentation index, see llms.txt. This page is also available as Markdown.
🖼️Texture Dictionaries (.ytd)
Texture dictionaries contain textures that can be used by drawables or fragments. Compared to embedded textures, texture dictionaries allows you to share textures between multiple models and reduce asset file sizes.
The Sollumz Tools > Texture Dictionaries panel in the sidebar lets you create dictionaries and add or remove textures manually, or add source mesh objects that automatically gather all images used by their Sollumz shaders, with a per-image toggle to control what gets included.
Texture Dictionaries panel
Sources
Sources let you reference Objects or Collections whose Sollumz shaders are scanned for textures, keeping the texture dictionary in sync with the textures actually used by your models.
The Images list shows every texture gathered from each source. Use the checkbox to control which of them are included in the texture dictionary. By default, embedded textures are excluded and non-embedded textures are included.
Texture dictionary sources list
HD Texture Dictionaries
HD texture dictionaries (+hi) can also be managed using Sollumz. Next to each textures there is an "HD" toggle. On export, textures marked as HD are exported to a +hi.ytd at full resolution, while the base .ytd contains half-resolution versions. For this, it is necessary for the textures to have mipmaps.
This also works with embedded textures on drawables, fragments, and drawable dictionaries: when HD textures are present, a +hidr.ytd/+hifr.ytd/+hidd.ytd is exported alongside the main asset.
