Creating Currencies

Learn how to create and configure currencies in your project

Creating Currencies

Currencies represent the numerical values that players earn and spend in your game — gold, gems, energy, tokens, and more. You manage them from the Currencies page under Game Data in The Leap.

Step-by-Step Breakdown

Step 1: Navigate to Currencies

From the left sidebar, expand the Game Data section and click Currencies. This opens the Currencies page, which lists all currencies in your project.

Step 2: Select a Workspace

Before you can create or edit currencies, you need an active workspace. If you're currently on Main, open the workspace switcher in the header and select or create a workspace. If you haven't set one up yet, see Working with Workspaces first.

Step 3: Click "Create Currency"

With a workspace active, click the Create Currency button in the top-right corner of the page. This opens the Create New Currency dialog.

Step 4: Fill In Currency Details

Fill in the following fields in the dialog:

  • Currency ID — A unique identifier for this currency (alphanumeric characters and underscores only, e.g. gold_coins, gems, tokens). This cannot be changed after creation.
  • Icon — Click the icon field to open the icon picker and choose a visual icon for your currency.
  • Description — An optional text field to describe the currency's purpose (e.g. "Main soft currency earned through gameplay").
  • Min Value — The minimum balance a player can have for this currency (defaults to 0).
  • Max Value — The maximum balance a player can hold (defaults to 999,999). Use this to cap hoarding or limit event currencies.

Step 5: Configure Acquisition Cost & Amount (Optional)

The Acquisition Cost & Amount section lets you define how players can convert one currency or resource into this currency. This is useful for setting up exchange rates between currencies (e.g., 50 gold for 100 silver).

To add a conversion:

  1. Click Add Cost to create a cost option.
  2. Set the Amount Awarded — how much of this currency the player receives when they pay the cost.
  3. Use the element selector to pick which resource or currency the player must spend, and set the quantity required.
  4. To require multiple resources for a single conversion, click Add Resource to this option.
  5. To offer alternative ways to acquire the currency, click Add Alternative Cost. Players can use any one of the cost options (OR logic).

Step 6: Create the Currency

Click Create Currency to save. Your new currency appears in the currencies list on the page.

Exploring Currency Flow

Once you've created currencies and connected them to other game elements, you can visualize how each currency flows through your economy. In the currencies list, click the Explore Flow button (the green link icon in the Actions column) on any currency row. This opens the Element Flow page, where you can see how the currency is earned and consumed across your game systems.

Next Steps

With your currencies set up, continue to Creating Statistics to keep building your game economy.