World Currency

In addition to Spatial Coins, you can create a currency specific to your World (and thus all the spaces within the World). This is called a World Currency.

What is World Currency?

World currency can be awarded to the user as rewards for completing tasks within your experience. When a world has a currency and items for sale, these elements show up in the interface.

  1. The Shop button, showing the world currency balance.

    Image showing you the shop button

  2. The Shop menu, which lists all of the items in your world that are up for sale.

    Image showing you the shop menu

Creating a Currency

To begin, you will need a space that was published from Unity. See Economy Overview if this is a new concept for you.

Currencies can be created in Spatial Studio (spatial.io/studio) after selecting a world. Simply click the Currency tab and create a new currency item. Once a currency is created it is not possible to remove it at this time.

  1. Create one if it doesn’t exist yet

    Image showing you creating a world currency

  2. Manage your currency

    Image showing you managing the world currency

You can then assign a thumbnail, name and description. By default, currency items always have these properties:

  • Scope: World
  • Stackable: Yes

Rewarding Currency

Rewarding currency is just like rewarding other items. See Rewarding Items for details.

For convenience, we provided an Award World Currency scripting node in Unity that you can use like this:

Note that this node only works as a coroutine. The triggering node needs to be marked as a coroutine

Note that this node only works as a coroutine. The triggering node needs to be marked as a coroutine

Pricing Items

Once you have created a world currency, new pricing settings become available when editing items! You can list items for purchase via your World Currency. See Selling Items to learn how!

  1. Select an item you want to price from the Items tab in Spatial Studio

  2. Then scroll down to the pricing settings section

  3. Enable the “For Sale” checkbox, select your currency from the drop-down and fill in the amount.

    Image showing you enabling item for sale

  4. You can also price your items in Spatial Coins, which will enable you to monetize your content and experiences. Find out more: Monetization

    Image showing you setting the item price