https://d.nostr.build/lLwmM.pdf

PF2e is a rules-heavy tabletop RPG with a focus on tactical combat, deep character customization, and balanced encounter design. Key elements to consider for the bot include:[]( https://rpgbot.net/p2/)[](https://www.dicebreaker.com/games/pathfinder-2e/how-to/how-to-play-pathfinder-rpg-2e)

- **Three-Action System**: Characters have three actions per turn, used for attacks, movement, spells, or other activities. The bot must track action economy and suggest or simulate NPC actions accurately.

- **Encounter Balance**: PF2e’s encounter-building rules are precise, using XP budgets based on party level and threat (Trivial, Low, Moderate, Severe, Extreme). The bot should calculate encounter difficulty dynamically.[]( https://rpgbot.net/p2/)[](https://themudworldblog.com/beginning-pathfinder-2e-roleplaying-game-campaign/)

- **Character Customization**: With 16 classes, numerous ancestries, backgrounds, and feats, the bot needs to handle diverse player builds and NPC stat blocks.[]( https://www.cbr.com/pathfinder-2nd-edition-adventure-paths-ranked/)[](https://www.cbr.com/pathfinder-2e-beginner-builds/)

- **Custom Setting Integration**: The bot must adapt PF2e’s rules to your unique world (e.g., replacing Golarion’s lore with your setting’s gods, factions, or cosmology) while maintaining mechanical consistency.[]( https://pathfinderwiki.com/wiki/Pathfinder_campaign_setting)

### 2. Bot Architecture and Optimization Strategies

To create an efficient DM bot, we need a modular architecture that handles PF2e mechanics, narrative generation, and long-term memory. Here’s a proposed structure:

#### A. Core Components

1. **Rules Engine**:

- **Purpose**: Interprets PF2e rules for combat, skill checks, and character progression.

- **Implementation**: Use a database or structured JSON to store PF2e rules (e.g., action costs, spell effects, feat prerequisites). Archives of Nethys (a free PF2e rules resource) can be a reference for rule codification.[]( https://paizo.com/pathfinder)

- **Optimization**: Precompute common calculations (e.g., attack rolls, saving throws) to reduce real-time processing. Cache frequently used rules like critical success/failure thresholds (10 above/below DC).[]( https://www.dicebreaker.com/games/pathfinder-2e/how-to/how-to-play-pathfinder-rpg-2e)

2. **Narrative Generator**:

- **Purpose**: Creates immersive descriptions, NPC dialogue, and plot hooks tailored to your custom setting.

- **Implementation**: Use a large language model (LLM) fine-tuned on fantasy narratives and your setting’s lore (e.g., world-specific factions, locations, or history).

- **Optimization**: Employ prompt templates to reduce token usage and ensure consistent output (see Prompt Engineering below).

3. **Memory Manager**:

- **Purpose**: Tracks campaign state, including significant events, player choices, and world changes.

- **Implementation**: Store data in a structured format (e.g., graph database for relationships, timeline for events) to enable quick retrieval and updates.

- **Optimization**: Prioritize key events (e.g., major NPC deaths, faction shifts) over minor details to manage memory efficiently.

4. **Encounter Builder**:

- **Purpose**: Generates balanced encounters using PF2e’s XP budget system.

- **Implementation**: Algorithmically select monsters from a database (e.g., Monster Core) based on party level and desired difficulty.[]( https://paizo.com/pathfinder)

- **Optimization**: Pre-generate encounter templates for common scenarios (e.g., bandit ambush, dungeon trap) to save processing time.

#### B. Long-Term Memory Optimization

To track a long-term campaign, the bot must retain critical information without overwhelming its context window or storage. Strategies include:

- **Structured Data Storage**:

- Use a database (e.g., SQLite, Neo4j) to store campaign state: characters (PCs and NPCs), locations, factions, and events.

- Example schema:

- **Characters**: Name, class, level, key traits, major actions (e.g., “killed the dragon”).

- **Events**: Timestamp, description, participants, consequences (e.g., “village burned, faction X weakened”).

- **Relationships**: Graph-based connections (e.g., “NPC A hates PC B due to betrayal”).

- **Trade-off**: Structured storage is fast and scalable but requires upfront design and maintenance. It’s less flexible for unstructured narrative data.

- **Summarization**:

- Periodically summarize sessions into concise logs (e.g., “Session 5: Party defeated Lich King, gained artifact X, allied with faction Y”).

- Feed summaries to the LLM for context, reducing token usage compared to storing full session transcripts.

- **Trade-off**: Summarization saves memory but risks losing nuanced details. Use player input to validate summaries.

- **Selective Memory**:

- Prioritize “significant” events (defined by impact on plot, characters, or world state) for retention.

- Example: Store “PC killed mayor” but discard “PC bought a sword” unless it’s plot-relevant.

- **Trade-off**: Selective memory reduces data load but requires clear criteria for “significance,” which may need manual tuning.

- **External Memory**:

- Offload detailed logs to an external system (e.g., Scabard for campaign management) and query only relevant data during sessions.[]( https://www.scabard.com/pbs)

- **Trade-off**: External systems improve scalability but introduce latency and dependency on third-party tools.

#### C. Custom Setting Integration

To integrate your custom setting:

- **Lore Database**: Create a structured repository of your world’s elements (e.g., gods, factions, geography). Example: If your setting has a pantheon of elemental deities, store their domains, motivations, and associated rituals.

- **Dynamic Adaptation**: Map PF2e mechanics to your setting. For example, if your world lacks arcane magic, replace wizard spell lists with divine or primal equivalents.[]( https://pathfinderwiki.com/wiki/Pathfinder_campaign_setting)

- **Narrative Consistency**: Train the LLM on a corpus of your setting’s lore (e.g., short stories, gazetteers) to ensure generated content aligns with your world’s tone and themes.

- **Trade-off**: Deep integration enhances immersion but increases setup time. Start with a minimal viable setting (e.g., one city, two factions) and expand iteratively.

### 3. Prompt Engineering for Efficiency

Efficient prompt generation is critical for minimizing computational cost and maintaining coherence. Here’s a framework for crafting prompts optimized for a PF2e DM bot:

#### A. Prompt Structure

A good prompt should include:

1. **Context**: Campaign setting, current session state, and relevant past events.

2. **Task**: Specific action (e.g., generate NPC dialogue, describe a combat encounter, update world state).

3. **Constraints**: Tone, length, and PF2e rule adherence.

4. **Memory Cues**: References to significant events or character details to ensure continuity.

**Example Prompt**:

```

You are a Dungeon Master for a Pathfinder Second Edition campaign set in [Custom Setting Name], a world of floating islands ruled by elemental lords. The party (Level 5 Fighter, Rogue, Druid) is exploring the Ruins of Skyhold, seeking the Orb of Storms. Last session, they defeated a wind drake (noted in memory: Event_023) and angered the Storm Cult. Generate a 100-word description of an encounter with a Storm Cult patrol (Moderate threat, 3 NPCs, use PF2e Monster Core stats). Include dialogue reflecting the cult’s zeal for the Storm Lord. Ensure descriptions match the setting’s stormy, aerial aesthetic. Reference the party’s prior actions and maintain PF2e combat rules (three-action system, critical success/failure).

```

#### B. Optimization Techniques

- **Templates**: Use reusable prompt templates with placeholders for variables (e.g., party level, location, threat level). This reduces prompt length and ensures consistency.

- Example: `Generate a [threat_level] encounter for a Level [party_level] party in [location]. Use PF2e rules, reference [event_id] for context.`

- **Batched Requests**: Combine multiple small tasks (e.g., NPC dialogue + encounter description) into a single prompt to minimize API calls.

- **Trade-off**: Batching saves tokens but risks less precise outputs if tasks are too complex.

- **Context Pruning**: Include only the most relevant memory cues (e.g., last 3 sessions or major events) to stay within token limits.

- **Trade-off**: Pruning saves resources but may omit useful context, requiring careful selection.

- **Rule References**: Embed shorthand rule references (e.g., “use CRB p. 123 for skill checks”) to ensure mechanical accuracy without lengthy explanations.

- **Iterative Refinement**: Start with broad prompts and refine based on output quality. For example, if NPC dialogue feels generic, add specific personality traits to the prompt.

#### C. Handling Long-Term Memory in Prompts

To maintain continuity:

- **Event Tagging**: Assign unique IDs to significant events (e.g., “Event_023: Wind Drake Defeated”). Reference these in prompts to trigger relevant responses.

- **State Summaries**: Include a brief campaign state in each prompt (e.g., “Current allies: Storm Riders; Enemies: Storm Cult”).

- **Player-Driven Cues**: Allow players to flag key moments (e.g., via a command like “!remember NPC betrayal”) to ensure the bot prioritizes them.

- **Trade-off**: Detailed memory improves coherence but increases prompt complexity. Use summarization to balance this.

### 4. Trade-Offs for Data Storage and Content Generation

Here are the key trade-offs to consider:

#### A. Data Storage

- **In-Memory (LLM Context)**:

- **Pros**: Fast access, seamless integration with narrative generation.

- **Cons**: Limited by token budget, risks forgetting older events as context window fills.

- **Best for**: Short-term campaigns or sessions with minimal state changes.

- **External Database**:

- **Pros**: Scalable, supports complex queries, retains data indefinitely.

- **Cons**: Requires setup, maintenance, and integration code; slower retrieval.

- **Best for**: Long-term campaigns with rich world states.

- **Hybrid Approach**:

- Store summaries in LLM context for quick access and detailed logs in a database for reference.

- **Pros**: Balances speed and scalability.

- **Cons**: Requires synchronization between systems.

- **Recommendation**: Use a hybrid approach, with a graph database for relationships and events, and LLM context for recent session summaries.

#### B. Content Generation

- **Pre-Generated Content**:

- **Pros**: Fast, consistent, low computational cost. Example: Pre-build encounter templates for common scenarios.

- **Cons**: Less dynamic, may feel repetitive without customization.

- **Best for**: Combat encounters, generic NPCs, or recurring locations.

- **On-Demand Generation**:

- **Pros**: Highly tailored, immersive, and responsive to player actions.

- **Cons**: Computationally expensive, risks inconsistencies (e.g., LLM hallucinations).[]( https://www.reddit.com/r/LocalLLaMA/comments/1eqr8gn/deleted_by_user/)

- **Best for**: Unique story beats, NPC dialogue, or setting-specific descriptions.

- **Hybrid Approach**:

- Use pre-generated templates for mechanics (e.g., stat blocks) and on-demand generation for narrative flavor.

- **Pros**: Balances efficiency and creativity.

- **Cons**: Requires careful prompt design to blend both seamlessly.

- **Recommendation**: Pre-generate mechanical elements (e.g., encounters, loot) and use on-demand generation for narrative and dialogue, referencing your custom setting’s lore.

### 5. Sample Workflow for a Session

Here’s how the bot might operate in a session:

1. **Session Start**:

- Query database for campaign state (e.g., party status, recent events).

- Prompt: `Summarize the campaign state for [Custom Setting Name]. Include party details, last 3 events, and active quests.`

2. **Encounter Generation**:

- Use encounter builder to select a Moderate threat encounter based on party level.

- Prompt: `Generate a Moderate encounter for a Level 5 party in [Location]. Use PF2e Monster Core stats, include 2-3 NPCs, and reference Event_023.`

3. **Narrative Interaction**:

- Generate NPC dialogue or location descriptions on-demand.

- Prompt: `Describe the Storm Cult leader’s reaction to the party’s actions in Event_023. Use zealous tone, 50 words.`

4. **Memory Update**:

- After the session, log new events (e.g., “Event_024: Party ambushed by Storm Cult”).

- Summarize session for next prompt: `Summarize Session 6: Party fought Storm Cult, gained clue to Orb of Storms.`

### 6. Tools and Resources

- **Rules Reference**: Archives of Nethys (free PF2e rules) or Pathfinder Nexus (Paizo’s digital toolset).[]( https://paizo.com/pathfinder)[](https://rpgbot.net/p2/how-to-play/beginner-box/)

- **Campaign Management**: Scabard for organizing notes, relationships, and maps.[]( https://www.scabard.com/pbs)

- **Encounter Tools**: PF2.tools for encounter building and stat block generation.[]( https://pf2.tools/)

- **LLM Frameworks**: Use LangChain or similar for managing LLM context and database integration.

- **Inspiration**: PF2e Adventure Paths (e.g., Abomination Vaults) for narrative structure.[]( https://www.cbr.com/pathfinder-2nd-edition-adventure-paths-ranked/)

### 7. Potential Challenges and Mitigations

- **LLM Hallucinations**: PF2e’s strict rules can conflict with LLM improvisation. Mitigate by grounding prompts with rule references and validating outputs against a rules database.[]( https://www.reddit.com/r/LocalLLaMA/comments/1eqr8gn/deleted_by_user/)

- **Memory Overload**: Large campaigns generate vast data. Mitigate with summarization and selective memory (e.g., focus on events impacting major factions).

- **Custom Setting Drift**: Ensure the LLM adheres to your setting by regularly feeding it updated lore documents.

- **Player Agency**: Allow players to override bot decisions (e.g., via a “!retcon” command) to maintain flexibility.

### 8. Example “Core Recipe” for the Bot

Here’s a cohesive rule set for your DM bot:

1. **Initialize**: Load campaign state from database, including party details, setting lore, and recent events.

2. **Prompt Loop**:

- Use templated prompts for encounters, dialogue, and descriptions.

- Reference PF2e rules (e.g., Monster Core, CRB) for mechanical accuracy.

- Include memory cues (e.g., “Event_023”) for continuity.

3. **Encounter Generation**: Build encounters using PF2e XP budgets, pre-generating stat blocks where possible.

4. **Memory Update**: Log new events with IDs, summarize sessions, and store in a graph database.

5. **Player Interaction**: Accept player inputs (e.g., “!describe NPC”) to trigger specific prompts.

6. **Validation**: Cross-check outputs against PF2e rules and setting lore to prevent drift.

### 9. Trade-Off Summary

- **Memory vs. Speed**: In-memory storage is fast but limited; databases are scalable but slower. Hybrid is best.

- **Pre-Generated vs. On-Demand**: Pre-generated content is efficient but static; on-demand is immersive but costly. Blend both for balance.

- **Rules vs. Narrative**: Strict PF2e adherence ensures fairness but may stifle creativity. Allow flexibility for non-mechanical elements.

### 10. Next Steps

- **Prototype**: Start with a single module (e.g., encounter builder) using a small LLM (e.g., Llama 3) and a SQLite database.

- **Test**: Run a short PF2e session with pre-generated characters (e.g., from Paizo’s Beginner Box).[]( https://rpgbot.net/p2/how-to-play/beginner-box/)

- **Iterate**: Refine prompts based on player feedback and output quality.

- **Expand**: Add more setting details and memory as the campaign grows.

https://play.google.com/store/apps/details?id=com.easy.currency.extra.androary