Feature Guide & FAQ

1. Open the Campaigns tab (first tab).
2. Tap the + button in the top-right corner.
3. Enter a campaign name (e.g. "The Lost Mines").
4. Choose a genre: Fantasy, Cyberpunk, Post-Apocalyptic, or Horror. This affects generator results, oracle flavor text, and the app's color theme.
5. Tap Save. Your campaign is created with an empty Journal, Prep Board, and tracking tabs for Threads, NPCs, and Characters.

Tap any campaign in the Campaigns list to open it. The most recently opened campaign becomes your active campaign, which is used by Solo oracle tools and generators when adding results to threads.

A campaign contains five main sections, accessible via tabs:

• Journal - Session-by-session play log with inline dice, oracle, generators, and cards.
• Prep Board - GM notes, pinned generator results, and session planning. (Pro)
• Threads - Track plot hooks, quests, and story arcs with status and priority.
• NPCs - Track characters you meet, their relationships, motivations, and secrets.
• Characters - Customizable character sheets with counters, dice fields, and sections.

Each campaign also has its own Chaos Factor (1-9) that affects oracle results during solo play.

Delete: Long-press a campaign in the list, then select Delete. This removes the campaign and all its threads, NPCs, characters, and journal entries. This action cannot be undone.

Backup: Long-press a campaign and select Export Backup (JSON). This creates a full backup file you can share or save. To restore, use Import Backup from the campaign list.

The Journal is a session-by-session play log inside your campaign. It's where you narrate what happens, roll dice, consult oracles, and draw cards - all without leaving the editor.

1. Open a campaign and make sure you're on the Journal tab.
2. Tap the text input at the bottom to write what happened (e.g. "The party enters the tavern").
3. Press Enter or the send button to add the entry as a bullet point.
4. Use the toolbar icons below the input to roll dice, consult the oracle, generate content, or draw cards. Results appear as sub-entries attached to your text.

The Journal toolbar has five tool panels:

• Dice - Tap to roll standard dice (d4-d100) or enter a formula like 2d6+3. The result is inserted as a sub-entry.
• Oracle - Ask Yes/No questions, roll on meaning tables, check scenes, generate NPC actions, and more. Free tools: Yes/No, Meaning Tables, Reaction Roll. Other tools require Pro.
• Generators - Run any built-in or custom generator. The result appears inline with its fields.
• Cards - Draw from a standard deck or tarot. (Pro)
• Dice (formula) - Quick formula input for custom dice rolls.

Each tool shows a preview of the result before you insert it. Tap Add to insert, or Re-roll to try again.

Sessions group your journal entries chronologically:

1. Session 1 is created automatically when you write your first entry.
2. To end a session, tap End Session in the journal toolbar. The session is closed and stamped with a timestamp.
3. To start a new session, tap New Session. A new session header appears with an incremented number.

You can still edit entries in closed sessions. Swipe left on a session header to delete the entire session and all its entries.

You can reference campaign NPCs and threads directly in your journal text:

• Type @ followed by an NPC name to mention them (e.g. @Brina). A picker shows matching NPCs.
• Type # followed by a thread name to reference it (e.g. #Lost Temple).

Mentions become tappable links in the journal. Tapping an @NPC opens their details; tapping a #Thread opens the thread editor. This creates a web of connections across your campaign.

The Prep Board is a GM planning space inside your campaign. Use it between sessions to organize notes, save ideas, and pin generator results you want to use later.

Think of it as your scratchpad - the Journal is where the story happens, the Prep Board is where you plan what's next.

1. Type a note: Open the Prep tab, type in the input field, and press Enter. Supports the same inline tools as the Journal (dice, oracle, generators).
2. Pin from generators: When viewing a generator result, tap the three-dot menu and select Pin to Prep Board. The result is saved as a prep item.
3. Organize with sections: Use the section field to group related items (e.g. "Session 5 Prep", "Random Encounters").

You can reorder items by long-pressing and dragging, edit by tapping, and delete by swiping left.

1. Open a campaign and go to the Threads tab (tap the thread icon badge).
2. Tap + New Thread.
3. Enter a title (required), and optionally set:
   • Type - e.g. "Dungeon Crawl", "Murder Mystery" (or tap the dice icon to generate a random type)
   • Status - Active, Dormant, Urgent, Progressing, Near Resolution, Complicated, Stalled, Abandoned, On Hold, or Secret
   • Priority - Main Quest, Side Quest, Personal Goal, Background, or Resolved
   • Notes - Longer-form text for plotting
4. Tap Save.

Threads appear as cards in the campaign with colored status indicators. Tap a thread to edit it, or link generator/oracle results to it from the result action menu.

When you generate a result (from generators, oracle, or dice), you can save it to a thread:

1. After generating a result, tap the folder icon (Add to Campaign).
2. Choose Add to Thread from the save options.
3. Select the thread from the picker. The result is linked as a thread entry with timestamp and category.

Thread entries build a timeline of discoveries, encounters, and plot developments related to that story arc.

1. Open a campaign and go to the NPCs tab (tap the NPC icon badge).
2. Tap + New NPC.
3. Fill in the details:
   • Name (required)
   • Occupation - What they do (e.g. "Blacksmith", "Gang Leader")
   • Relationship - Ally (green), Neutral (blue), Enemy (red), or Unknown (gray)
   • Description - Appearance, mannerisms
   • Notes - Anything else you need to remember
4. Expand More Details for optional Motivation and Secret fields.
5. Tap Save.

When you generate an NPC using the Quick NPC or Full NPC generator:

1. View the generated result.
2. Tap the folder icon (Add to Campaign).
3. Select Track as NPC.
4. The NPC editor opens with all fields pre-filled from the generator result (name, occupation, personality, etc.).
5. Adjust any details and tap Save.

This also works from the History screen and from NPC Action oracle results.

1. Open a campaign and go to the Characters tab.
2. Tap + New Character.
3. Enter a name and optional subtitle (e.g. "Level 5 Fighter").
4. Choose a template:
   • Classic RPG - STR, DEX, CON, INT, WIS, CHA + HP, AC, Gear, Notes
   • Narrative - Aspects, Stress, Consequences, Stunts
   • Minimal - Body, Mind, Spirit + Gear + Notes
   • Blank - Start empty and build your own
5. Tap Create. The sheet opens in play mode.

Tap the pencil icon to enter Edit Mode. In edit mode you can:

• Add sections - Create groups like "Combat", "Inventory", "Spells".
• Add fields - Choose from 6 field types:
  • Number - Static value (e.g. Strength: 16)
  • Counter - Current/Max tracker (e.g. HP: 8/10)
  • Text - Notes or descriptions
  • Checkbox - Toggle for abilities or conditions
  • Dice - Rollable notation (e.g. 1d6+2) - tap to roll in play mode
  • List - Multi-item list (inventory, spell list)
• Reorder fields and sections by dragging.
• Delete fields or sections you don't need.

Exit edit mode to return to Play Mode where you can tap counters to adjust values, roll dice fields, and toggle checkboxes.

Generators produce random content from curated tables. Open the Generators tab to browse 85+ generators organized by category:

• Names - Human, Elf, Dwarf, Cyberpunk, Horror, and more (30+ variants)
• NPCs - Quick NPC, Full NPC, Occupation, Personality, Quirk, Voice
• Places - Tavern, Street, Shop, District
• Dungeon - Room, Trap, Door, Atmosphere
• Wilderness - Terrain, Weather, Encounter, Campsite
• Quests - Hook, Full Quest, Objective, Reward
• Items & Treasure - Magic Item, Cyberware, Loot
• Events - Urban, Wilderness, Plot Twist, Rumor
• Creatures - Encounter, Lair, Behavior, Motivation
• Social - Faction, Alliance, Betrayal
• World Building - Kingdom, Religion, Legend, Prophecy

Tap a generator to see a result. Tap Generate again for a new result. Use the action buttons to copy, share, save to history, pin to prep, or add to a campaign thread.

On the Spark tab (built-in generators), you'll see genre filter buttons below the search bar: Fantasy, Cyberpunk, Post-Apocalyptic, and Horror.

The active genre controls which generators are visible and which data tables are used. For example, the Weather generator produces medieval weather in Fantasy mode and acid rain in Post-Apocalyptic mode.

Long-press any generator in the list to pin it. Pinned generators appear in a dedicated Pinned section at the top of the generator list for quick access.

Recently used generators also appear in a Recently Used section automatically.

1. Open any built-in generator and generate a result.
2. Tap the wrench icon in the header (if available for that generator).
3. For single generators: the Custom Generator Editor opens pre-filled with the original's entries. Edit names, add/remove entries, adjust weights, then save.
4. For combo generators (like Full Encounter): a confirmation dialog appears. It will create copies of all component generators plus a combo that links them together.

Your customized copy is fully independent of the original - editing it won't affect the built-in version. (Pro feature)

1. Go to Generators and switch to the Custom tab.
2. Tap + New Generator.
3. Enter a name (e.g. "Tavern Rumors").
4. Choose a mode:
   • Simple (List) - A flat list of entries. One is picked at random each time. Best for straightforward tables.
   • Template (Pattern) - A pattern like "The {1} {2}" with numbered placeholders. Each number references a separate sub-table. Great for combinations like "The [adjective] [noun]".
   • Dice Table - Entries mapped to dice outcomes (e.g. d6, 2d6, d100). Each result has a roll range. Use the merge/split controls to customize ranges.
5. Add your entries. You can type them one by one, or use Paste List to import from clipboard (one entry per line).
6. Tap Save.

Template mode lets you create complex generators with multiple random components:

1. Write a pattern using numbered placeholders: The {1} of {2}
2. Each number creates a sub-table below the pattern field.
3. Fill in each sub-table with options. For example:
   • Table 1: "Crown", "Sword", "Ring", "Staff"
   • Table 2: "Fire", "Shadows", "the Ancients", "Storms"
4. When generated, the pattern picks one random entry from each table: "The Sword of Storms".

The live preview at the bottom shows what a generated result looks like in real-time.

Combos run multiple generators in sequence with a single tap:

1. Go to Generators > Custom tab.
2. Tap + New Combo.
3. Enter a name (e.g. "Full NPC Package").
4. Select 2 or more generators from the picker. You can mix built-in and custom generators.
5. Drag to reorder them (the order determines the result field order).
6. Tap Save.

When you run the combo, it generates all selected generators at once and displays the combined result. Great for building complex encounters, full NPCs, or location setups in one tap.

Custom generators and combos support optional organization:

• Section - A text label that groups items under collapsible headers on the Custom tab (e.g. "Session Prep", "Combat", "NPCs").
• Category Icon & Color - Choose a custom icon and color for the generator card.

Items without a section appear under "Uncategorized". Generators and combos with the same section name are grouped together.

The Solo Oracle is a set of tools for solo RPG play, inspired by Mythic GME and similar systems. It replaces the Game Master by answering your questions about the world.

Open the Solo tab to see the tool grid. Each tool serves a different purpose. The Chaos Factor (1-9) affects results - higher chaos means more surprises.

You can also access all oracle tools inline from the Journal and Prep Board toolbar, so you never have to leave the editor.

The core solo play tool. Ask any yes/no question about the world:

1. Think of a question (e.g. "Is the door locked?").
2. Select the odds - how likely is "Yes"? Options range from Impossible to Sure Thing (10 tiers).
3. Tap Roll.
4. Get one of four result tiers:
   • Yes / No - Plain answer
   • Yes, but... / No, but... - Answer with a complication
   • Exceptional Yes / Exceptional No - Strong answer (doubles rolled)
   • Extreme Yes / Extreme No - Dramatic twist

The Chaos Factor shifts the odds slightly. Doubles may also trigger a Chaos Event - an unexpected story twist. (Free)

Meaning Tables generate random Action + Subject pairs for creative interpretation:

• Tap Meaning Tables on the Solo screen.
• Get a result like: "Betray" + "Innocence" or "Discover" + "Power".
• Some results include a Descriptor for additional context.

Use them when you need inspiration: "What does the NPC want?" "What's in the hidden room?" Interpret the pair creatively in context. (Free)

The Reaction Roll determines how an NPC or creature reacts to the player:

1. Optionally select a tone: Random, Hostile, Suspicious, Neutral, Friendly, or Helpful.
2. Tap Roll.
3. Get a result combining the tone with a specific reaction (e.g. "Friendly - Offers assistance eagerly").

If you select "Random", the tone is determined by the roll. Great for quick NPC encounters. (Free)

Pro oracle tools for deeper solo play:

• Scene Check - Roll against Chaos Factor to see if a scene plays out normally, gets altered, or is interrupted by something unexpected. (Pro)
• NPC Action - Determine what an NPC does: mood (Hostile/Neutral/Friendly), bearing (Threatening/Curious/Reasonable), and focus. Supports 4-beat conversation escalation. (Pro)
• Random Event - Full story event with category, focus, action, subject, descriptor, and interpretation. (Pro)
• Quest Generator - Complete quest hook: Giver, Objective, Location, Antagonist, and Twist. (Pro)
• Discovery - Generate a Clue, Obstacle, Opportunity, or Threat with details. (Pro)
• Complication - Unexpected twist from 17 categories (Equipment, Combat, Magical, Tech, Moral, Social, and more). (Pro)

The Chaos Factor is a number from 1 to 9 that represents how unpredictable the story is:

• 1-3 (Stable) - Events are less likely to intervene. Good for calm, controlled scenes.
• 4-6 (Balanced) - Normal odds. The default starting point.
• 7-9 (Chaotic) - Expect surprises. More chaos events, more scene alterations, more unexpected twists.

It affects the Yes/No Oracle (shifts odds slightly), Scene Checks (higher chaos = more alterations), and Chaos Events (doubles on the dice with chaos 5+ trigger random events).

Adjust it from the Solo screen or the Journal. Each campaign stores its own Chaos Factor. A good rule of thumb: raise chaos after things go wrong, lower it after the party gains control.

Open the Dice tab. You have several options:

• Standard dice - Tap d4, d6, d8, d10, d12, d20, or d100 for a quick roll.
• Formula input - Type a dice formula like 2d6+3, 4d8-2, or 1d20+5 and tap Roll.
• Dice Pool - Build a pool of multiple dice, then roll them all at once. Tap "+" to add dice, hold "-" to remove.

All rolls are automatically saved to History.

Custom dice systems let you define dice with symbols instead of numbers (like narrative RPG dice):

1. Go to Dice and switch to the Custom tab.
2. Tap + New System (or pick from built-in presets like Narrative, Fortune, or Success).
3. Define your symbols - e.g. "Hit" (positive, green), "Miss" (negative, red), "Crit" (positive, gold).
4. Set up cancellation pairs - e.g. Hits cancel Misses to show net result.
5. Add dice definitions - configure which symbols appear on each die face.
6. Tap Save.

Roll your custom dice from the Custom tab. Results show symbol counts and net totals after cancellations. Free tier allows 1 custom system; Pro gives unlimited. (1 Free / Unlimited Pro)

Open Cards from the More menu. Two modes available:

• Playing Cards - Standard 52-card deck (optional Jokers). Tap to draw one card at a time. The deck tracks what's been drawn - no duplicates until you shuffle. Discard cards selectively (long-press), view the discard pile, and return cards to hand or deck.
• Tarot - Full 78-card deck (22 Major + 56 Minor Arcana). Draw single cards, or use spreads:
  • 3-Card Spread - Past / Present / Future
  • 5-Card Character Spread - Strength / Weakness / Goal / Fear / Destiny
  • Major Arcana Only - Draw from the 22 powerful archetypal cards

Tarot cards include meanings, reversed interpretations, and scene prompts (in GM Mode). Toggle between GM Mode (improvisation-focused) and Traditional Mode (classic meanings) in Settings.

Custom card decks are a Pro feature. Go to Cards > Custom tab, then tap Create Deck. In the editor you can:

• Name your deck and pick an accent color
• Add cards with titles, descriptions, and optional images
• Set per-card quantity (e.g., 3x "Nothing Happens")
• Create groups (e.g., "Level 1", "Level 2") with shared usage pools - perfect for spell slots
• Assign cards to groups so they share the group's slot count
• Paste a list to bulk-add cards (one per line, use " - " for title and description)

Once saved, switch between Draw mode (draw/discard like physical cards) and Browse mode (view all cards in a gallery with usage tracking).

Groups let you organize cards into categories with shared usage pools - like spell levels in D&D. For example:

• "Level 1 Spells" with 3 slots - any 3 Level 1 spells can be cast
• "Level 2 Spells" with 1 slot - one Level 2 spell per rest

In Browse mode, tap a card to see its details, then tap Use to spend a slot. When a group's slots are spent, all cards in that group dim. Tap the ... menu to reset uses (like a long rest).

Cards without a group can have individual usage tracking instead.

Yes! GMs with Pro can share cards with their players:

1. Open your deck in Browse mode
2. Tap ... and choose Share Cards
3. Select which cards to share (tap to toggle)
4. Tap the share bar to export as a card pack (with or without images)

Players (even on the free tier) can import shared card packs. They get full browse and usage tracking - perfect for receiving spell cards or item decks from the GM. Free players can import one shared deck.

Every dice roll, card draw, generator result, and oracle answer is automatically saved to History (accessible from the More menu).

• Filter by type - Use the tabs to show only Dice, Cards, Generators, Oracle, or Saved results.
• Actions - Tap any result to expand details. Use the action icons to copy, share, save/star (Pro), or add to a campaign thread.
• Delete - Swipe left on any entry to remove it.

Free tier keeps the last 50 entries. Pro gives unlimited history with a Saved/Starred tab for favorites.

From a campaign detail screen:

• Export Journal (Markdown or PDF) - Exports all sessions and entries as a formatted file. Includes session numbers, chaos levels, scene markers, and all inline results (dice, oracle, generators). Share via email, messaging, or save to files.
• Export Prep Notes (Markdown or PDF) - Exports your prep board items with section headers preserved.

Both export options are available from the campaign's action menu. (Pro)

Full campaign backup:

1. Export: Long-press a campaign in the list and select Export Backup (JSON). This creates a complete backup including all threads, NPCs, characters, journal sessions, and prep notes.
2. Import: From the campaign list, use the Import Backup option and select a previously exported JSON file. The campaign is restored with all its data intact.

Individual item export/import:

You can also export and import individual items - threads, NPCs, characters, custom generators, combos, and dice systems. Each item screen has export/import options. Use the file picker to import JSON files directly from your device. This makes it easy to share specific items between campaigns or with other players.

Useful for transferring content between devices, sharing with friends, or keeping safe backups before major story arcs.

Yes! Character sheets can be exported as genre-themed PDFs with styling that matches your campaign's genre:

• Fantasy - Parchment and gold aesthetic
• Cyberpunk - Neon terminal style
• Post-Apocalyptic - Weathered, worn look
• Horror - Dark gothic theme

Free: Basic 1-column PDF export. Pro: 2-column layout, blank sheet mode (empty fields for pen-and-paper play), and PDF preview before export.

RPG Spark is generous with the free tier. You can play full sessions with:

• 1 campaign with Journal, 3 Threads, 3 NPCs, 1 Character (3 sections)
• 25 generators including Quick NPC, Names (Human + Elf), Quest Hook, Tavern, Weather, and more
• 3 oracle tools - Yes/No Oracle, Meaning Tables, and Reaction Roll
• Full dice roller - Standard, extended, formula, pool, and 1 custom dice system
• Card decks with deck tracking (draw, discard, return) + import shared card decks from GM
• Export & import individual items (threads, NPCs, characters, dice systems)
• 50 history entries
• 4 genre themes - Fantasy, Cyberpunk, Post-Apocalyptic, Horror
• 7 languages - English, German, Spanish, French, Italian, Polish, Chinese

No ads, no accounts, works fully offline.

Pro is a one-time purchase that removes all limits:

• Unlimited campaigns, threads, NPCs, characters, and history
• 85+ generators (Full NPC, Full Quest, all genre names, creatures, world building, combos)
• All 8 oracle tools (adds Scene Check, NPC Action, Random Event, Quest, Discovery, Complication)
• Custom generators & combos - Create your own tables, templates, and dice tables
• Clone & Customize - Copy and modify any built-in generator
• Custom card decks - Create decks with images, spell slot groups, and usage tracking
• Card sharing - Share selected cards with players as card packs
• Tarot - Full 78-card deck with spreads and meanings
• Unlimited custom dice systems
• GM Prep Board - Planning space with pinnable results
• Genre-themed PDF character sheets (2-column layout, blank sheets, preview)
• Journal & Prep export (PDF + Markdown)
• Campaign backup & restore (JSON)

Pro is a one-time purchase - no subscriptions, no recurring fees. Buy once, keep forever.

No. RPG Spark works 100% offline. All generators, oracle tables, dice, and cards run locally on your device. There are no accounts, no cloud sync, and no data leaves your phone. The only network request is for the initial Pro purchase verification through the app store.

All data is stored locally in a SQLite database on your device. It persists across app updates. However, uninstalling the app or wiping your device will delete everything.

To protect your work: Use Export Backup (JSON) regularly to save campaign snapshots, or export individual items (threads, NPCs, characters) separately. Store the files somewhere safe (cloud storage, email to yourself, etc.). You can restore any backup or import individual items with the Import feature.