4 min read

Currency system

How currency items, display formats, and shop transactions work in ScryRPG.

Last updated: October 25, 2026

Overview

Currency in ScryRPG is stored as item instances in containers. You can add currency items and set their quantities in your inventory, or receive and spend them through shop transactions. Currency totals and prices are displayed using your preferred currency format.

Currency as Items

Currency is represented by item instances in containers. When you buy from a shop, the purchase removes currency from the selected payer. When you sell, the shop pays from its available funds. You can also add an item to your inventory yourself and set its quantity.

This means:

  • Currency takes up space according to the item’s stack size and weight
  • Purchases can use character funds or the party wallet
  • Party members can use party-container currency when their container permissions allow it

The Currency Tag

An item template can be marked as currency by adding the currency tag and giving it a value above zero. This tells ScryRPG:

  1. Display it in currency summaries
  2. Make it available for shop transactions
  3. Include it in wealth calculations

Standard currency items are tagged for their game system. Custom currency items you create should also have this tag.

The Gold Piece Peg

Shop prices and currency values use a GP-equivalent value internally. Coin denominations depend on the item’s game system. D&D 5e, Pathfinder 2e, and Draw Steel use these denominations:

CurrencyValue in GP
Copper Piece (CP)0.01 GP
Silver Piece (SP)0.1 GP
Gold Piece (GP)1 GP
Platinum Piece (PP)10 GP

These are not every game’s denominations. Daggerheart uses Gold Coins, Handfuls of Gold, Bags of Gold, and Chests of Gold. The app converts currency values for shop transactions, while your display preference controls how totals and prices appear.

D&D 5e also has Electrum Pieces (EP), worth 0.5 GP.

To change how currency is displayed, open Settings, find Currency Display, and choose a format. Options include Gold Pieces (decimal), Gold Pieces (split), Dollars, and a sci-fi format. This changes display, not the stored item quantities or values.

Shop Transactions

When buying or selling, shops handle currency automatically.

Buying from a Shop

  1. Select the item you want to purchase
  2. Choose a character or party destination and a payment source
  3. The shop calculates the price
  4. Currency is deducted from the selected payer, which can be the party wallet
  5. Item is added to your chosen container

Currency Used for Purchases

When a purchase needs currency, the app spends from the selected payer’s available currency items, starting with the less weight-efficient items in each container. A party wallet can use eligible party-owned containers according to their order and your permissions.

Selling to a Shop

  1. Select the item you want to sell
  2. The shop calculates payment using the item’s value and the shop’s buy modifier
  3. Currency is added to your inventory from the shop’s available funds
  4. If exact denominations are not on hand, the transaction can use canonical currency denominations instead. The shop still needs enough funds.

Making Change

Shops pay from their available funds. If the exact denominations are not on hand, ScryRPG can use canonical currency denominations instead. The shop still needs enough funds, and GMs can add currency items to its inventory.

Multi-Currency Transactions

The app totals the selected payer’s currency by value, then handles denomination changes for the transaction. A purchase can draw across the party’s eligible containers when you select the party wallet; using a specific payer container limits the funds to that container.

The selected game system determines canonical denominations. Custom currency items can also contribute according to their assigned value.

Custom Currencies

You can create currencies for any setting:

Fantasy Examples:

  • Electrum Pieces (0.5 GP)
  • Trade Bars (50 GP)
  • Dragon Scales (currency for a specific faction)

Sci-Fi Examples:

  • Credits
  • Energy Units
  • Corporation Scrip

Creating Custom Currency

  1. Create an item template with your currency’s name
  2. Add the currency tag
  3. Give the currency item a value above zero, using the app’s GP-equivalent value
  4. Set its stack size and weight if those apply to your item

Warning

Custom currency values are compared with item prices using the app’s GP-equivalent values. For example, a currency item valued at 0.1 GP takes 10 units to equal 1 GP of value.

Currency in Party Play

Party Treasury

Many groups keep shared gold in a party container. Party members can use currency in party-owned containers when they have permission to view or withdraw from those containers. You can contribute currency by moving currency items into a party container. Taking currency out depends on that container’s withdrawal permissions.

Shop Purchases

Shop purchases can use party currency directly. Choose the party wallet as the payer and a party destination container. The wallet can spend currency across eligible party-owned containers; selecting a specific payer container restricts payment to that container.

FAQ

Do I need GP specifically, or can I use any currency? Currency items with a value can contribute to shop transactions. Canonical denominations depend on the item’s game system, and displayed values follow your currency display setting.

What if a shop does not have the exact denominations? ScryRPG can use canonical currency denominations to complete the transaction. The shop must still have enough funds for a sale. A GM can add currency items to the shop’s inventory.

Can I create currencies worth more than platinum? Yes. A high-value item can be tagged as currency if its template has a value above zero.

Does currency weight affect encumbrance? Currency items use their configured weight and quantity when inventory weight is calculated. The weight depends on the item and game system.

Pathfinder 2e Coins

In PF2e parties using Bulk encumbrance, currency items count toward Bulk at 1 Bulk per 1,000 coins. ScryRPG calculates this from currency items across the containers the character carries, excluding extradimensional containers.

Which container does the shop pull currency from? Payment can come from a character wallet, the party wallet, or a selected payer container. A party-wallet purchase can draw currency across party-owned containers; a selected payer container restricts the source.

Learn More