FilmstripStudio

RPG Data and Starting State · Version 0.5

Currencies

Define stable, bounded Currency types for shops, rewards, pickups, Conditions, Actions, and starting balances.

Currencies are reusable project definitions with stable IDs and bounded balances.

A Currency can define:

  • Display name
  • Minimum balance
  • Optional maximum balance
  • Default runtime balance

Leaving the maximum blank means the Currency has no authored upper limit.

Currencies are used by:

  • Shops
  • Reward Bundles
  • Pickups
  • Conditions
  • Actions
  • Party / Inventory Debugger
  • Runtime saves

Currency changes use the same transaction authority everywhere. A failed grant, purchase, or removal cannot quietly leave an invalid balance.

Use separate Currency definitions only when the game genuinely needs distinct wallets, such as gold and arena tokens. Do not create a new Currency for ordinary counters that are better represented by a number or Quest objective.