# PACKING YOUR ASSETS

Asset packs turn one or several images into a file that Dungeondraft can read an use on several maps.

{% hint style="info" %}
More info on **premade packs** [HERE](https://unofficial-dd-manual.gitbook.io/dungeondraft/custom-assets-and-mods/custom-asset-creators).
{% endhint %}

## PROS AND CONS

{% hint style="success" %}
**PROS**

* Can be used for importing a lot of assets at once
* Way more stable than drag and drop
* Assets can be used in the various tools
* Assets are in the library and can be used on multiple maps
* You have more control over what you do
* You can share your packs with other users
  {% endhint %}

{% hint style="danger" %}
**CONS**

* Takes a bit of time
* Needs to be done properly or it won't work
* Doesn't work with accents and special characters
* No worth the time if you only have a single asset to import
  {% endhint %}

***

<p align="center"><em><mark style="color:yellow;">The following section is a crash course on how to pack assets.</mark></em> </p>

<p align="center"><em><mark style="color:yellow;">We will focus on objects only.</mark></em></p>

<p align="center"><em><mark style="color:yellow;">For more in depth packing, check out</mark></em> <a href="https://www.youtube.com/watch?v=4gpCQnN0xMg&#x26;lc=Ugwmrdddj94PXth8eTN4AaABAg"><em>this video</em></a><em><mark style="color:yellow;">.</mark></em></p>

***

## PACKING BASICS ([OBJECTS](https://unofficial-dd-manual.gitbook.io/dungeondraft/all-the-tools/objects-tab/objects-tool) ONLY)

{% hint style="warning" %}
*While I'd suggest to create a new pack from scratch, you can get a template file from the* [*Package Custom Assets menu*](https://unofficial-dd-manual.gitbook.io/dungeondraft/introduction/first-look/main-menu#package-custom-assets) *to help you with the folder structure.*&#x20;

*If you use it, make sure to remove any file and folder you're not using before you repack it. Keeping files (especially data files) might cause your pack to break.*&#x20;
{% endhint %}

<p align="center"></p>

1. Download [Ryex's Go Packager](https://github.com/Ryex/Dungeondraft-GoPackager/releases) and unzip it.

{% hint style="info" %}
We won't use the built-in packing tool as it's a bit outdated and can be confusing.
{% endhint %}

2. In your explorer, create a series of folders following precisely this structure:\
   `Pack Name\textures\objects\`

{% hint style="danger" %}
*Make sure you didn't use capital letters for the folder names (except for the Pack Name folder)*
{% endhint %}

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FVE0cX5ya26RIG24z1uAq%2Fimage.png?alt=media&#x26;token=c1ad3c6a-b1b2-47ca-a884-810d78f975af" alt=""><figcaption></figcaption></figure>

3. Place your assets inside the **`objects`** folder.&#x20;

{% hint style="info" %}
*You can add subfolders if you want (no name restriction)*
{% endhint %}

4. Open GoPackager and drag and drop your root folder (Pack Name) into GoPackager, or look for the folder with the <kbd><mark style="color:blue;">**Open Folder**<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%2F4uM90fn69J2dvTF025HC%2Fimage.png?alt=media&#x26;token=53af4327-87a9-4372-ab04-0c86c7633d87" alt=""><figcaption></figcaption></figure>

5. Click on <kbd><mark style="color:blue;">**YES**<mark style="color:blue;"></kbd>  to load your pack

6. Click on <kbd><mark style="color:blue;">**Create a pack.json file**<mark style="color:blue;"></kbd> if there isn't one

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FCltS4hcxjITBge1wtm6s%2Fimage.png?alt=media&#x26;token=0eac808b-f40b-4498-aaf7-1605efb6b8a6" alt=""><figcaption></figcaption></figure>

7. Edit the fields you want and click on <kbd><mark style="color:blue;">**Save**<mark style="color:blue;"></kbd>&#x20;

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fvjc9OpTcCNZcENCANpvJ%2Fimage.png?alt=media&#x26;token=dffca193-18b4-4245-9fcb-8c7c96d41b6e" alt=""><figcaption></figcaption></figure>

8. Choose a **destination folder** (where the pack will be exported)

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FqIZELm7SvF6WNWScGvVi%2Fimage.png?alt=media&#x26;token=27179085-7c20-4683-975d-296dd3c557e6" alt=""><figcaption></figcaption></figure>

9. Click on <kbd><mark style="color:blue;">**Generate Thumbnails**<mark style="color:blue;"></kbd>&#x20;

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2Fwr2zdv1OUaiSSv5jgGdB%2Fimage.png?alt=media&#x26;token=72f79958-f896-45bd-9240-21653efd1097" alt=""><figcaption></figcaption></figure>

10. Click on <kbd><mark style="color:blue;">**Generate Tags**<mark style="color:blue;"></kbd> , then <kbd><mark style="color:blue;">**Generate**<mark style="color:blue;"></kbd> , then <kbd><mark style="color:blue;">**OK**<mark style="color:blue;"></kbd>&#x20;

{% hint style="info" %}
*If there are several folders inside the **`objects`** folder, the tags will be the names of the folders*
{% endhint %}

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2FVxaOP58TBDSxuyX3gdDr%2Fimage.png?alt=media&#x26;token=5df56ea1-b501-4ed1-99be-76a9d38b2574" alt=""><figcaption></figcaption></figure>

11. Enable <kbd><mark style="color:blue;">**Replace Existing Files**<mark style="color:blue;"></kbd>&#x20;

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F4HUsNAbfN8iQPWwugwI1%2Fimage.png?alt=media&#x26;token=77440a2f-6aa3-49e1-8fdf-c381c7ed2a24" alt=""><figcaption></figcaption></figure>

12. Click on <kbd><mark style="color:blue;">**Package**<mark style="color:blue;"></kbd> and then on <kbd><mark style="color:blue;">**OK**<mark style="color:blue;"></kbd> when it's generated

<figure><img src="https://717747526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FonbNaZHYfX7cze8ubfnQ%2Fuploads%2F2TcZVbqGQhKMtxNpmjbW%2Fimage.png?alt=media&#x26;token=a37d14ed-cf21-45d6-a81d-93dcfb5d672f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
*Your pack has now been created, you can now* [*load it into Dungeondraft*](https://unofficial-dd-manual.gitbook.io/dungeondraft/introduction/first-look/assets-menu)*!*&#x20;
{% endhint %}
