# Upload Assets to Workspaces

## What is Workspaces?

Workspace is a location in your account on The Sandbox website that allows you to manage your assets. You can upload or replace your creations made in VoxEdit and find them in your Game Maker library for building Experiences using this workflow.

{% embed url="<https://youtu.be/eWh9VfzXGm0>" %}

{% tabs %}
{% tab title="About" %}

### My Workspace

This is your Workspace home, here you will be able to see, access, and bulk manage your uploaded assets.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FdSGrElTeuduEUuZmgUqj%2Fimage.png?alt=media&#x26;token=61836819-86c9-4a9d-8eb8-7cd10e695472" alt=""><figcaption></figcaption></figure>

### My Catalysts

The number and type of Catalyst NFTs you own appear here. Catalyst NFTs are burned to mint assets as NFTs and define their rarity.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FZBS9e8p7PqVMZcK4NjeM%2Fimage.png?alt=media&#x26;token=0a839e1e-65f1-479f-ab94-c252be63a396" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Filters" %}

### Filters

Filters will help you have a better view of your assets and also perform several actions in bulk:

* **All**
  * Select and **mint** several assets (**Draft** assets will not be added)
  * Select and **transfer ownership** of several assets (**Draft** assets will not be added)
  * Select and **delete** several assets (**Draft** assets will not be added)
* **Ready -** Select and set several assets as Draft
* **Draft -** Select and set several assets as Ready
* **Hidden -** Select and set several assets as visible in your profile

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FDLHqerlYdqIHuOqMb7f5%2Fimage.png?alt=media&#x26;token=1875be04-1c18-4a7c-a7af-a9df9a0ea118" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Asset Status" %}

### Asset Status

A Workspace asset can have two different statuses: **Ready** or **Draft**

{% hint style="info" %}
Ready is the default status after you finish uploading your asset (unless you selected **Save as draft** during the process).
{% endhint %}

#### READY

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Assets with Ready status are:</strong></p><ul><li>Ready to Mint as an NFT</li><li>Publicly visible in the <a href="https://www.sandbox.game/en/users/gatostao/ff15ce57-388b-46d7-9210-a1e7482e485e/?tab=Entities">creator's profile</a> (by default)</li><li><p>Available for any user to: </p><ul><li>add it to their Wishlist</li><li>test it in Game Maker</li><li>use it in Experiences to be shared in the Game Maker Gallery</li></ul></li></ul></td></tr><tr><td><p><strong>Use Cases for Ready Status:</strong></p><ul><li>I uploaded my asset and want to mint it.</li><li>I want to share my asset creations with The Sandbox Community.</li><li>I want everyone to be able to use my asset in the Game Maker</li></ul></td></tr></tbody></table>

**DRAFT**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Assets with Draft status are:</strong></td><td><ul><li>Can not be minted</li><li>Only accessed by the owner's account through Workspace and the Game Maker Library</li><li>Hidden in the <a href="https://www.sandbox.game/en/users/gatostao/ff15ce57-388b-46d7-9210-a1e7482e485e/?tab=Entities">account’s public profile</a> by default</li></ul></td></tr><tr><td><strong>Use Cases for Draft Status</strong></td><td><ul><li>I need to upload my asset to quickly test it in the Game Maker.<br>(Select <strong>Save as draft</strong> when uploading to Workspaces)</li><li>I need my asset to be private and only I can have access to it.</li></ul></td></tr></tbody></table>
{% endtab %}

{% tab title="Asset Visibility" %}

### Asset Visibility

Even though a **Ready** asset is publicly visible by default, you have the option to hide it.&#x20;

A **Hidden** asset is hidden from the account’s public profile and searches, but it can still be seen, wishlisted, and used in the Game Maker by anyone who has the direct link to the asset’s public URL.

**Ready and Hidden use cases:**

* I want to share my asset with specific users but I don’t want my asset to be found by anyone else.
* I have a team where multiple accounts need access to the assets.
* I need a private way to share the asset progress with my clients so they can test it.
  {% endtab %}
  {% endtabs %}

## Upload an Asset

Assets are uploaded by default as "not published." Once an asset is uploaded, from its page you can publish, hide, transfer ownership, or delete it using the dropdown menu beneath the asset image. You can also edit all of the custom information you created, which is noted in the step-by-step instructions below.

{% hint style="info" %}
This process does not burn Catalyst NFTs. However, once an asset is uploaded, it can be minted using Catalysts and listed on the Marketplace.&#x20;

See [**Mint & List Assets to Sell**](https://docs.sandbox.game/en/creator/voxedit/mint-assets-sell-nfts) for more information about Catalysts and Attribute Points.
{% endhint %}

{% tabs %}
{% tab title="1. Upload from VoxEdit" %}
{% hint style="warning" %}
Make sure your asset is optimised to be the best version possible. Reduce face count and nodes and use texture instead of voxels when possible. View [**Quality Guidelines**](https://docs.sandbox.game/en/creator/voxedit/docs/ve-guidelines) and [**Creative Guides**](https://docs.sandbox.game/en/creator/game-maker/creative-guides) for resources to improve your assets.
{% endhint %}

### From VoxEdit

Before you begin, log in to your into VoxEdit using the same login credentials for your account. With the asset you want to upload open:

1. Open the **File** menu and click **Upload to Workspace**. For an animated asset, you can choose an animation to display and move the arrowhead to the right time for a pose you want displayed in your asset's thumbnail.\
   \
   ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/Ql9PNWoWkud99GZIPLYx/VE%20upload%20to%20workspace.png)\
   \
   Multiple thumbnail options from different directions will be available to choose from. Select the thumbnail you want to display on your asset's page, select the default animation from the dropdown menu, and click **Export**. This will open a tab in your browser directly on The Sandbox website.
   {% endtab %}

{% tab title="2. New or Replace" %}
2\.  Select **New Asset** or **Replace Existing Asset**.<br>

```
<figure><img src="https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/YlmTg4ADzQPV6vARPEW4/image.png" alt=""><figcaption></figcaption></figure>

\
If you choose **Replace Existing Asset**:\
A list of assets you have already uploaded to your Workspace will appear. This list is filtered by default to display unpublished assets. Select an asset to replace by clicking the radio button on the left of its thumbnail, which becomes green. Then click **Replace**.
```

{% endtab %}

{% tab title="3. Add Discovery Data" %}
3\. Proceed through the following steps to add details that make your asset easier to find in search engines and on the Marketplace, pressing **Continue** after each step:

:black\_square\_button: Choose asset type:

* **Character:** Non-playable characters you can place in experiences
* **Block:** Construction item for landscaping
* **Equipment:** Wearable item for avatars
* **Prop:** Decorative item to place in an experience
* **Pass:** Exclusive item used for NFT gating and more

The potential options will automatically be detected based on the asset you've created.

<figure><img src="https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/4plrcN9QYihTIJF2sBBG/image.png" alt=""><figcaption></figcaption></figure>

:black\_square\_button: Create a name (maximum 150 characters) and a description (maxiumum 500 characters).

See[ **Asset Name & Description** ](https://docs.sandbox.game/en/creator/voxedit/docs/ve-guidelines/asset-name-and-description)for recommendations.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F0qDQhziYKDrgU64TWW0p%2Fimage.png?alt=media&#x26;token=8de1d20d-63cf-4f86-9156-57957e61d472" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Both name and description are automatically moderated to identify content such as violence, verbal abuse, etc. If a message appears indicating your name or description violate terms of use, please review the reason(s) listed and replace the content.
{% endhint %}

:black\_square\_button: Select a category, sub-categories, and custom tags.

Categories: structure, vehicles, furniture, electronics, vegetation, art, animated, scene, gameplay, other props.

**Category and Sub-Categories Example:**

Animals -> Mammals -> Wolves

**Custom Tags**

Define up to 10 custom tags to better categorize your asset. An auto completion feature will suggest relevant tags that have already been used by other creators. These tags will make it easier to find your creations using the new marketplace filters.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FpEBd47iYlMPSoKiUonIa%2Fimage.png?alt=media&#x26;token=95cb5203-ca6a-4ee6-a3d9-75de88e6e2c2" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="4. Catalyst & Attributes" %}
4\. The Catalyst selected will determine the rarity of the asset. For equipment assets only, it will also grant a fixed amount of points to distribute between different attributes that will enhance your gameplay.

{% hint style="warning" %}
The team is working on a system in which Catalysts can add value to non-equipment assets, which still require a Catalyst to mint, but do not have Attribute Points.
{% endhint %}

{% hint style="info" %}
If you are uploading a non-equipment asset (Character, Prop, Pass) this is the last step of the upload flow. You can skip to asset edit page after this step.
{% endhint %}

:black\_square\_button: Set rarity by choosing a **Catalyst** and press **Continue**.

:black\_square\_button: (For equipment assets only) Apply Attribute Points available from your chosen Catalyst and click **Create Asset**.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F2p0hs9u4RRHbMqBWlZOV%2FL2%20Catalyst%20Attribute%20Points%20crop.gif?alt=media&#x26;token=94247ad1-7300-4345-a7ae-f49f0193e114" alt=""><figcaption><p>Assigning Attribute Points when creating a new equipment asset based on the rarity of the Catalyst</p></figcaption></figure>

The Attribute will get a random value within a range, depending on the amount of points spent on it:

**1 point spent:** Random value between **1 and 25**

**2 points spent:** Random value between **26 and 50**

**3 points spent:** Random value between **51 and 75**

**4 points spent:** Random value between **76 and 100**

{% hint style="warning" %}
The final values will be defined when the asset is minted.
{% endhint %}

You will then see an editable page describing all of the characteristics you've added to your asset. \
Press the three dots button ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/NGFRftLKTWqAV4KqoMzI/image.png) below your asset's thumbnail to:

* publish
* set as private
* transfer ownership
* delete the asset&#x20;

Click the pencil icon ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/1PgOQIw7kkggvCWPrGXO/image.png) on the right side of any characteristic to make modifications.

You can modify assets you've created anytime in your [**Workspace**](https://www.sandbox.game/en/me/communities/the-sandbox/workspace/) and via your Inventory.
{% endtab %}
{% endtabs %}

## Asset Edit Page

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FC0d0e6ayj7lwP0nn6vNu%2Fimage.png?alt=media&#x26;token=34ba48cb-815f-45a7-9a77-5bad38fad5c4" alt=""><figcaption></figcaption></figure>

Click on any asset in your Inventory to open the asset edit page. There, you can edit all of the characteristics added to the asset in the upload process.

{% hint style="warning" %}
After the asset is minted, you will not be able to change this information.
{% endhint %}

Press the three dots button ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/NGFRftLKTWqAV4KqoMzI/image.png) below your asset's thumbnail to change the [**asset status**](#asset-status-1).

Click the pencil icon ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/1PgOQIw7kkggvCWPrGXO/image.png) on the right side of any characteristic to make modifications.

You can modify assets you've created anytime in your [**Workspace**](https://www.sandbox.game/en/me/communities/the-sandbox/workspace/).