Banking System

The Banking System is a powerful tool that allows you to create a functional in-game economy. As the GM, you define all the currencies that exist, create the banks that players can use, and have administrative oversight of all accounts. A proper setup here is essential for the Banking App to work for your players.

How to Access Banking System Settings:

• Method 1 (Main Settings):
  1. Go to the main Foundry VTT Configure Settings menu (⚙️).
  2. Navigate to the Module Settings tab.
  3. Find "Smartphone Widget" in the list and click the button labeled "Currency & Bank Management."
• Method 2 (In-App Shortcut):
  1. As the GM, open your Smartphone Widget (📱).
  2. Navigate to the Settings app (⚙️).
  3. In the "GM Only" section, tap on "Banking System."

The management panel is divided into three tabs: Currency Settings, Account Management, and Bank Management.

1. Currency Settings (💰 Most Important First Step)

This tab is the foundation of your world's economy. You must define your currencies here before players can deposit, withdraw, or transfer money.

• Load System Preset: A dropdown menu at the top allows you to quickly load pre-configured currency settings for popular systems like Dungeons & Dragons 5e or Cyberpunk RED. This is the easiest way to get started.
• Base Unit: This is the most crucial setting. It defines the single, smallest unit of currency to which all others are compared. All exchange rates are based on this unit.
  • Example: In D&D 5e, Copper Pieces (cp) are the smallest unit. If 1 sp = 10 cp and 1 gp = 100 cp, you would set cp as the Base Unit.
• Currency List: Here you define each type of money.
  • Unit ID: A short, unique code for the currency (e.g., gp, eb, credits). Do not use spaces or special characters.
  • Name: The full, player-facing name (e.g., "Gold Piece," "Eurobuck").
  • Rate: The currency's value relative to the Base Unit. The Base Unit itself should always have a rate of 1. (e.g., If cp is base, gp would have a rate of 100).
  • Symbol: The symbol used to represent the currency (e.g., Gp, €, ¥).
  • Actor Path: This is the "address" of the currency on a character's sheet. It tells the app where to find and update the character's money.
    • How to find it: Open a character sheet, right-click on the currency field (e.g., the input for Gold), and choose "Inspect Element." In the developer console, you'll see an input element with a name attribute. That name is the Actor Path (e.g., system.currency.gp).

2. Bank Management (🏦)

This tab is where you create the financial institutions of your world that players will see in their Banking App.

• Add Bank: Click this button to add a new row to the list.
• Bank List:
  • Logo URL: An image path for the bank's logo. You can paste a path directly or click the folder icon (🖼️) to use the File Picker.
  • Bank Name: The name of the bank as players will see it (e.g., "City Bank," "Militech Financial").
  • Account Format: Defines the structure for this bank's account numbers. Use N as a placeholder for a random number. This adds a great deal of flavor to your world.
    • Examples: NNN-NN-NNNN for a standard format, or ARASAKA-NNNN-N for a corporate account.
  • Delete (🗑️): Removes the bank. Warning: Deleting a bank will not delete existing accounts, but they will appear as belonging to an "Unknown Bank."

3. Account Management (👤)

This tab is your administrative tool for viewing and managing all bank accounts held by Actors in the world. It is primarily used for troubleshooting or narrative purposes.