> For the complete documentation index, see [llms.txt](https://docs.sollumz.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sollumz.org/documentation/drawable-dictionary.ydd.md).

# Drawable Dictionary (.ydd)

The Drawable Dictionary is a container that holds a collection of drawables. Its primary use is for storing LOD models, ped components, ped props, mesh minimaps and instanced props.

It is recommended that you read the Drawable documentation page before creating a Drawable Dictionary, as it consists of drawables.

{% content-ref url="<https://github.com/Sollumz/wiki/blob/main/documentation/drawables.ydr>" %}
<https://github.com/Sollumz/wiki/blob/main/documentation/drawables.ydr>
{% endcontent-ref %}

### File Layout

```
Drawable Dictionary
    Drawable#1
        ShaderGroup
        Skeleton (sometimes, mostly seen on ped components)
        DrawableModelsHigh
        DrawableModelsMed
        …
    Drawable#2
    Drawable#3
    Drawable#4
    Drawable#5
    …
```

For the hierarchy, several drawables exist as regular game-ready assets, but all of them share one parent drawable dictionary object.

### Blender Hierarchy

<div align="left" data-full-width="false"><figure><img src="/files/PrCjMzRugxSNmPLpUL5R" alt=""><figcaption><p>Example Drawable Dictionay object</p></figcaption></figure></div>

In Blender, Drawable Dictionaries comprises a parent object and one or more drawable objects in its hierarchy.

### Limitation

Some features of Drawable objects cannot be inherited by Drawable Dictionaries. For example, the embedded collision **cannot function** when the drawable is in a drawable dictionary.

Furthermore, CodeWalker cannot identify the real name of a drawable in drawable dictionaries unless a nametable with resolved names is loaded. Thus, it is recommended to create a nametable whenever utilizing a drawable dictionary in your project to facilitate your own and others' modding processes.

### Archetype Definition

{% hint style="info" %}
A Drawable Dictionary does not have its own archetype definition.
{% endhint %}

When creating the archetype definition for a drawable in a drawable dictionary, it is necessary to fill the correct name of your drawable dictionary in the "Drawable Dictionary" blank to ensure it workds within the game.

For instance, if we have the drawable dictionary `my_ydd` and the drawable `my_ydr` in the scene. Then you should fill in "Drawable Dictionary" in the archetype as shown in the picture below:

<div align="left" data-full-width="false"><figure><img src="/files/uSb61J1GjfQIjiFUY4vY" alt=""><figcaption><p>Fill the "Drawable Dictionary" with the name of your drawable dictionary</p></figcaption></figure></div>

{% hint style="info" %}
If you use the "Auto-Create From Selected" function, the "Drawable Dictionary" will be filled in automatically.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sollumz.org/documentation/drawable-dictionary.ydd.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.