FilmstripStudio

Player-Facing RPG Systems · Version 0.5

Reward Bundles

Group Items and Currencies into one reusable all-or-nothing reward and reuse it from scenes, quests, shops, or Combat Rewards.

A Reward Bundle groups authored Item and Currency grants into one reusable transaction. It can be presented directly through gameplay Actions and can also be referenced by a Combat Reward.

Author a Reward Bundle

  1. Create the Items and Currencies it will use.
  2. Open Reward Bundles in the RPG Database.
  3. Create a stable ID and display name.
  4. Add Item quantities and Currency amounts.
  5. Save and resolve stack, balance, or missing-reference validation.

Using a Reward Bundle

A shared Action can grant or present the bundle from dialogue, interactions, quests, chests, or other authored flows. A Combat Reward may reference the same bundle while adding experience progression for an Encounter.

All-or-nothing behavior

Every grant is validated before the transaction is accepted. If an Item would exceed its stack limit, a Currency would exceed its bounds, or a definition is missing, the bundle must not apply only the remaining entries.

Combat Reward distinction

Reward Bundles contain Items and Currencies. Combat Rewards belong to Encounters, may award experience, and may reference one Reward Bundle. Use the reusable bundle when the same loot should appear both inside and outside combat.