App Store Settings (πͺ)
The App Store system allows you to control which optional applications players can "install" on their smartphones. This is a powerful tool for narrative progression and world-building. You can start players with only basic phone functions and allow them to unlock more advanced apps later in the campaign, perhaps as a quest reward, by purchasing them from a vendor, or by visiting a specific location.
How to Access App Store Settings:
- Method 1 (Main Settings):
- Go to the main Foundry VTT Configure Settings menu (βοΈ).
- Navigate to the Module Settings tab.
- Find "Smartphone Widget" in the list and click the button labeled "App Store Settings."
- Method 2 (In-App Shortcut):
- As the GM, open your Smartphone Widget (π±).
- Navigate to the Settings app (βοΈ).
- In the "GM Only" section, tap on "App Store Settings."
The Configuration Panel Explained:
The settings panel presents a list of all non-essential apps available in the module. This includes apps like the Calculator, Notes, Social, Banking, Gacha, and various games, as well as any apps registered by third-party add-on modules.
Each app entry has an icon preview, its display name, and two toggle switches:
- Store toggle (left): Check (β
) this to make the app visible in the App Store for players to install. Any app with this toggle off will be completely hidden from the App Store.
- Default toggle (right): Check (β
) this to automatically pre-install the app on every phone. When an app is marked as Default, it will already be on every player's Home Screen without them needing to visit the App Store β and it will be hidden from the Store listing since it's already installed.
Note: Core applications like Phone, Messages, Contacts, and Settings are considered essential to the smartphone's function. They are always installed, cannot be removed, and do not appear in this list.
How Store and Default interact:
| Store |
Default |
Result |
| ON |
OFF |
App appears in the App Store. Players can install it manually. |
| OFF |
OFF |
App is completely hidden. Players cannot see or install it. |
| β |
ON |
App is automatically installed on all phones. It does not appear in the App Store (since it's already installed). The Store toggle is ignored when Default is ON. |
Default Apps: Use Cases
The Default toggle is great for scenarios where you want certain apps to be universally available from the start:
- Campaign Essentials: Mark the Banking App or Calendar App as Default so every player has them immediately without needing to visit the Store.
- Add-on Modules: Third-party module developers can register their apps with the
defaultInstalled: true option in the API, which automatically marks the app as Default. You can override this in the settings at any time.
- Narrative Progression: Start with a minimal set of Default apps, then enable more apps in the Store as the campaign progresses β or switch apps from "Store" to "Default" when the story calls for it.
The Player Experience:
- When a player opens the App Store app (π) on their smartphone, they will see a list of all the apps you have enabled in the Store (but not marked as Default, since those are already installed).