---
description: by uchideshi34
---

# ADDITIONAL SEARCH OPTIONS

{% hint style="info" %}
_Version tested here: 1.2.12_
{% endhint %}

[Additional Search Options](https://cartographyassets.com/assets/48648/additional-search-options/) is a QoL[^1] mod that adds **search boxes** in several tools:&#x20;

* [Terrain Tool](../../all-the-tools/terrain-tab/terrain-brush)
* [Pattern Tool](../../all-the-tools/design-tab/pattern-shape-tool)
* [Wall Tool](../../all-the-tools/design-tab/wall-tool)
* [Roof Tool](../../all-the-tools/design-tab/roof-tool)
* [Light Tool](../../all-the-tools/effects-tab/light-tool)

It also adds a few other options to any search box depending on the tool.

It's especially useful when you have a lot of [custom assets](../custom-asset-creators).



## THE BASICS

### Search Bar

This is what the newly added **Search Bar** looks like in most of the tools.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FZYGWeFJ7Kw84JzdLwLOn%2Fimage.png?alt=media&#x26;token=e7f4a7f1-d31c-4ee2-a42d-29142a23f388" alt=""><figcaption></figcaption></figure>



### ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FIZxQusMCJLdSvQzYxEkG%2Fimage.png?alt=media\&token=2c2b3f47-5cc4-4b08-8376-f9240d3be7a0) Map Icon - Used Assets ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FNwjbdUEgDxnAQod4f1fN%2Fimage.png?alt=media\&token=e4ade56d-9e01-4898-ae3a-d388cc840b6b)

In most tools, the **Map Icon** ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FBEVswRA5vXEMMXU5aBr7%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_NwjbdUEgDxnAQod4f1fN_image.webp?alt=media\&token=759bccc2-82af-4321-aeb1-f43cac9c09e4) can be clicked to automatically find the assets from that tool which were used on the map.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FYGs6PkpzXa922bhyki5l%2Fimage.png?alt=media&#x26;token=cbff1479-f160-4f67-8b35-d82b45ef42c9" alt=""><figcaption></figcaption></figure>



### ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FCcXiczMRGQYnLFAGNm9v%2Fimage.png?alt=media\&token=51896580-a4d9-4506-83d6-bcb0e0416eb5) **Book Icon - Recent History** ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FER72O22ZRmfVOugPPPVo%2Fimage.png?alt=media\&token=636581c5-4a14-492f-bfb8-fbe3a1befa6b)

In a few tools, you'll find a **Book Icon** ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FSIRRm4SDp1iPiYVUZymm%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_ER72O22ZRmfVOugPPPVo_image.webp?alt=media\&token=22278b19-4d3e-40dd-837e-57dd67000944) that can be clicked to access your recent **search history** (limited to the 11 most recent searches).

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FNXVbyvGYgwp32owtCF7o%2Fimage.png?alt=media&#x26;token=84ac875a-74a3-4030-a3e8-bfeffc3df2ac" alt=""><figcaption></figcaption></figure>



### ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F0Cus0qEi3CC7ajKYPZxT%2Fimage.png?alt=media\&token=f577ebfe-aa56-4c96-8369-79aaaa275726) Tornado Icon - Match Patterns and Terrain ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fwm5q2VBpDgAOtPfCKLfK%2Fimage.png?alt=media\&token=578e2ebd-5e4d-4cd0-9d2b-6f00fb61817e)

In the [Terrain Tool](#matching-terrain-and-patterns-textures) and the [Pattern Tool](#matching-patterns-and-terrain-textures), clicking the **Tornado Icon** ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F9HgeHIoBs628IhhpPIgE%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_wm5q2VBpDgAOtPfCKLfK_image.webp?alt=media\&token=8475bca9-8157-4ef0-b80b-1a75f739fd9b) will try to find a match for textures you've used in the other tool.&#x20;



***



## SETTINGS

When using [\_Lib](_lib), you can access the [mods settings](../_lib#mod-list-and-mod-settings) from [Preferences](../../../introduction/first-look/main-menu#preferences). By clicking on the gear icon ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FeIkMbuwduXshwQK4SFd1%2Fimage.png?alt=media\&token=742a50af-e1c1-442c-a465-086a05c8248d), you will be able to modify some settings related to the mod.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FM9DVnxjX2acbYdVjkA2p%2Fimage.png?alt=media&#x26;token=d6b9f7c4-af66-4c1a-b844-76cad8c0ef57" alt=""><figcaption></figcaption></figure>

The first one toggles the auto-search as soon as you type in a character. Disabling it is better for less powerful configs.\
\
The second one removes any color you might have applied to the walls so they appear with their default look in the search.



***

## **OBJECTS & PATHS**

The [Objects Tool](../../all-the-tools/objects-tab) and the [Path Tool](../../all-the-tools/terrain-tab/path-tool) already have a **Search Bar** in [vanilla Dungeondraft](#user-content-fn-2)[^2], but the mod adds a [Map Icon](#map-icon-used-assets) (used assets) for the Path Tool and [Book Icon](#book-icon-recent-history) (recent history) in both tools.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fb8DmbRqMK9lO7mc1Z59O%2Fimage.png?alt=media&#x26;token=d50a38a1-7044-422b-9f81-159a8ca1971c" alt=""><figcaption><p>Path Tool</p></figcaption></figure>

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FMtGcgwCF0NOl2g0mHTh3%2Fimage.png?alt=media&#x26;token=039c5da3-f0d8-4698-8e2e-1227df371206" alt=""><figcaption><p>Objects Tool</p></figcaption></figure>



***

## WALLS, ROOFS & LIGHTS

The mod adds a Search Bar in the [Wall Tool](../../all-the-tools/design-tab/wall-tool), the [Roof Tool](../../all-the-tools/design-tab/roof-tool) and the [Light Tool](../../all-the-tools/effects-tab/light-tool), which works the same in each tool. You simply type in the name of the asset you're looking for and it will dynamically appear in the library underneath as you write. You can use the [Map Icon](#map-icon-used-assets) to find assets used on the map.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FoyKPXUjqLxN5ccW4zKY4%2Fimage.png?alt=media&#x26;token=6c65e14c-f671-4fe3-b556-4e12586dc988" alt=""><figcaption></figcaption></figure>



***

## TERRAIN

In the [Terrain Brush](../../all-the-tools/terrain-tab/terrain-brush), you can enable the **Search Bar** by clicking on the **Enable Terrain Search** button.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FGhXcwXDIMuYcyE2KzIhW%2Fimage.png?alt=media&#x26;token=659648a7-17c6-44ae-956e-734e05872c6d" alt=""><figcaption></figcaption></figure>

This will display a few new things:&#x20;

* a **Move Search To RH Panel** toggle button

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FQfqla0izKykVQjtI0wQk%2Fimage.png?alt=media&#x26;token=b147b75b-beb1-4324-b3a0-0d5ccc06c661" alt=""><figcaption></figcaption></figure>

* a <kbd><mark style="color:blue;">**Set Terrain Slot**<mark style="color:blue;"></kbd> button

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FPudP0JebwxPHYlqXY7mK%2Fimage.png?alt=media&#x26;token=9b14e041-28b4-4da1-94d9-d71449a0c8e2" alt=""><figcaption></figcaption></figure>

* a Search Bar with **two buttons** on its right

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FmlAjou9QiPlM6AQCCZY2%2Fimage.png?alt=media&#x26;token=fd8a798b-96b7-461e-afe7-b4e86a85f0e4" alt=""><figcaption></figcaption></figure>

* the full **Terrain Library**

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FK7yMunenaAY16pWpWAYx%2Fimage.png?alt=media&#x26;token=086f6d99-ab62-48bf-854e-9ad584cbd633" alt=""><figcaption></figcaption></figure>





### **Moving the UI to the right**

The **Move Search To RH Panel** toggle buttonis pretty self explanatory. It will move the mod's UI[^3] to the right of your screen. It's useful when you have a standard resolution like 1920x1080, as the tool will look a bit cramped at the bottom of the left panel by default, especially if you have [8 slots](../../../all-the-tools/terrain-tab/terrain-brush#adding-more-texture-slots) of terrain.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Ffnk56RGfDs3zrwsQRDj9%2FMod%201.png?alt=media&#x26;token=d3c6a9ae-b953-4832-8cd1-ec62c7c2a013" alt=""><figcaption><p>Default UI with the mod enabled</p></figcaption></figure>

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fsa5VrAEEgRVxPN0lg4hy%2FMod%202.png?alt=media&#x26;token=4c02986e-7966-456a-a54c-98cb69070673" alt=""><figcaption><p>Mod's UI moved to the right</p></figcaption></figure>



### **Selecting and using a Terrain**

As for the regular [terrain tool](../../all-the-tools/terrain-tab/terrain-brush), you first need to **choose the slot** you want to use. Click on the one you want to use in the left panel. For this example, let's say we want to use the fourth one.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FYz9QgJSwbShmCNfD2PFq%2Fimage.png?alt=media&#x26;token=086fb299-1386-4b03-a0c6-01b7e5390996" alt=""><figcaption></figcaption></figure>



In the mod's **Terrain Library**, **select the texture** you want to apply to that slot.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F6tzEkxeHqMvTQT890tH4%2Fimage.png?alt=media&#x26;token=7cbc2b5e-1485-4eee-b731-8f1b6dcfb294" alt=""><figcaption></figcaption></figure>



Then, to **apply** the selected texture to the **slot** you chose, click on <kbd><mark style="color:blue;">**Set Terrain Slot**<mark style="color:blue;"></kbd>.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FXkPFhgAuMVfDkarJi0Nd%2Fimage.png?alt=media&#x26;token=078fa421-3df5-4eff-9cf4-ac9da5c7611d" alt=""><figcaption></figcaption></figure>



The texture is now **set** on the **slot** you selected earlier and you can start to **use it**.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FwFTRl16MV0TBceR3hh65%2Fimage.png?alt=media&#x26;token=f9b83bbc-ba73-40e2-9e90-4633453a9941" alt=""><figcaption></figcaption></figure>



### Searching for a texture

You can use the **Search Bar** to look for a terrain texture name. Results are displayed dynamically as you type your search.&#x20;

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FGGfvylyv5N6D9BxxgAwB%2Fimage.png?alt=media&#x26;token=3292639c-b258-4ed3-804e-850c7a3a2872" alt=""><figcaption></figcaption></figure>



### Matching Terrain and Patterns textures

Using the Terrain Tool and the [Pattern Tool](../../all-the-tools/design-tab/pattern-shape-tool) together is often required to achieve your design ideas but finding the same texture in both tools is often a pain. The mod has a convenient option to quickly find corresponding textures used in one or another tool, represented by a [**Tornado** icon](#tornado-icon-match-patterns-and-terrain) ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FomQgGqLsrmi5qCUUt71v%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_wm5q2VBpDgAOtPfCKLfK_image.webp?alt=media\&token=150ce941-9605-48a6-85a1-84cefa54435f)**.**



**Example of how it works:**

1. **Draw a shape** in the **Pattern Tool** with any texture.
2. In the **Terrain Tool**, with the mod enabled, click on the **Tornado** icon
3. If the texture exists in both tools, it will appear in the Library.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F3k9vVXvVEpDzsCpD9Yhc%2Fimage.png?alt=media&#x26;token=18854950-5438-4172-8b41-ca98fa54c491" alt=""><figcaption><p>Left: a texture from the Pattern Shape Tool<br>Right: the same texture found in the Terrain Tool</p></figcaption></figure>



If several different **Pattern textures** were used, they will be all displayed with this feature.

This feature is also available in the **Pattern Tool** to match used **Terrain textures**.



{% hint style="danger" %}
_**Matching doesn't work, why?**_

* _The textures do not exist in the other tool_
* _The Terrain and Pattern textures are not sharing the same exact name in the pack_
* _The textures are not sharing the same format (for example, one is Dirt.jpg and the other is Dirt.webp)_
{% endhint %}

***

## PATTERNS

### Displaying the Search Bar

By default, in the [Pattern Tool](../../all-the-tools/design-tab/pattern-shape-tool), the **Search Bar** is not available due to coding limitations in this tool. You can display it by changing the **Search Type** from **No Search** to either **Simple Tiles**, **Patterns** or **Patterns Colorable**.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F9m56tnYm8ELrczShnwM5%2Fimage.png?alt=media&#x26;token=81bbced2-cc5d-4e78-9193-ed19014e7e7e" alt=""><figcaption></figcaption></figure>

* **SImple Tiles**: textures only available in the [Building Tool](../../all-the-tools/design-tab/building-tool)
* **Patterns**: Any other pattern texture from the Pattern Tool
* **Patterns Colorable:** any colorable pattern from the Pattern Tool

Once you select any of these 3 options, the **Search Bar** will be displayed.

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fg8kjokCIPUKjp3SceDBR%2Fimage.png?alt=media&#x26;token=e6cd083a-e243-4bc1-84a5-38110223d677" alt=""><figcaption></figcaption></figure>



You can now type in the name of the Pattern texture you're looking for and the results will be displayed as you type.



### Load used Patterns only

Next to the **Search Bar**, you can see a [Map Icon](#map-icon-used-assets) ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fh7cVacnYJvIiaQEyzOmE%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_NwjbdUEgDxnAQod4f1fN_image.webp?alt=media\&token=c92116da-32d1-425c-a205-d46603937722). **Clicking** on it will automatically **find** the textures you've **used** on your map, according to the **search type** you've selected.&#x20;

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FaSYVL9gPik4Du99fuZr6%2Fimage.png?alt=media&#x26;token=e5406fa3-4f89-4a8c-a0cd-e6283ac328e3" alt=""><figcaption></figcaption></figure>



### Matching Patterns and Terrain textures

As for [this feature](#matching-terrain-and-patterns-textures) in the [Terrain Tool](../../all-the-tools/terrain-tab/terrain-brush), you can find Pattern textures that were used as Terrain on your map if the textures share the same name. For that, you need to click on the [**Tornado** icon](#tornado-icon-match-patterns-and-terrain) ![](https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FIE0HUKIk8CceoFMQTjua%2Fspaces_onbNaZHYfX7cze8ubfnQ_uploads_wm5q2VBpDgAOtPfCKLfK_image.webp?alt=media\&token=14b669fd-b59b-4e59-b9e8-776a5d863dbd).



**Example of how it works:**

1. Paint some **Terrain** textures from **custom asset packs**
2. In the **Pattern Tool**, with the correct **Search Type** enabled, click on the **Tornado icon**
3. If there are **matching textures** in both tools, they will appear in the Library

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FCJcvJvlXxnLe7MPfuSHd%2Fimage.png?alt=media&#x26;token=bc6adcda-9d31-4dbe-8877-263cc5129c38" alt=""><figcaption><p>Right: Terrain textures used on the map<br>Left: Matching Pattern textures</p></figcaption></figure>



{% hint style="danger" %}
_**Matching doesn't work, why?**_

* _The textures do not exist in the other tool_
* _The textures are not sharing the same exact name in the pack_
* _The textures are not sharing the same format (for example, one is Dirt.jpg and the other is Dirt.webp)_
* _You didn't choose the correct Search Type (for example, one of your Terrain textures is not a Pattern but a Simple Tile)_
{% endhint %}

***

## SELECTION TOOL

The [Selection Tool](../../all-the-tools/select-tool) is also displaying the previous additional search options when selecting either a [Path](../../all-the-tools/terrain-tab/path-tool), a [Wall](../../all-the-tools/design-tab/wall-tool), a [Pattern](../../all-the-tools/design-tab/pattern-shape-tool) or a [Light](../../all-the-tools/effects-tab/light-tool).

***

{% hint style="warning" %}
Usually, creators post some minor updates of their mods on [Discord](https://discord.com/invite/J9Czgpu) and release a bigger update from time to time on [CartographyAssets.com](https://cartographyassets.com/asset-category/specific-assets/dungeondraft/mods-scripts/), so if you're missing some features from there, you might find the most recent version on Discord.
{% endhint %}

***

{% hint style="success" %}
<p align="center"><a href="https://cartographyassets.com/assets/48648/additional-search-options/"><strong>DOWNLOAD</strong></a></p>
{% endhint %}

[^1]: _Quality of Life_, any change that is making the user's experience easier

[^2]: Unmodded version of Dungeondraft

[^3]: _User Interface,_ how you interact with Dungeondraft (the buttons, menus, and layout...)
