PersistentGuides

Persistent Guides Menu

Persistent guides are context snippets injected into the chat that persist across multiple turns. They help the AI maintain awareness of key details such as the current situation, character thoughts, clothing, position, rules or custom user instructions. The persistent guides menu opens a popup with buttons to generate or manage these guides.

Opening the Persistent Guides Menu

Click the bookmark icon next to the send button to open the main menu, or the book reader icon to open the persistent guides menu. The menu lists guide types and management actions.

Guide Types

Each guide type creates a persistent injection with an identifier (ID). Guides can be regenerated or edited at any time.

Situational

Situational (location dot icon) generates context summarizing recent chat events or a user‑specified focus. It uses the /gen command to summarise the last few messages and injects the result as the situation guide. Use this when you want the AI to recall the current scene or conversation state.

Thinking

Thinking (brain icon) produces an out‑of‑character thought from the character's perspective, giving insight into their inner feelings. It uses the SysThinking guide (ID thinking) and can be triggered automatically after each AI reply if enabled in settings.

Clothes

Clothes (shirt icon) describes the characters' outfits and appearance. It uses the SysClothes guide (ID clothes) and can be auto‑triggered after each AI reply.

State

State (face smile icon) details the characters' positions, physical state or status. It uses the SysState guide (ID state) and can be auto‑triggered.

Rules

Rules (numbered list icon) generates or updates a list of explicit in‑story rules. It calls /gen with a temporary system preset and injects the result as rule_guide. Use this to maintain story constraints or session rules.

Custom

Custom (pen to square icon) allows you to write your own context manually. It opens a large text box where you can enter any guidance, then injects it under the Custom ID. This is useful for notes, reminders or house rules that aren't covered by other guides.

Fun Prompts

Fun Prompts (gamepad icon) provides a selection of creative prompts from a menu such as "Shocking Plot Twist" or group‑chat commentary. When you choose a fun prompt the extension loads the corresponding text from funPrompts.txt and executes it using the same model switching and guide infrastructure. It is great for spicing up the story with unexpected events.

Stat Tracker

Stat Tracker (chart line icon) is a powerful tool that automatically monitors and updates specific aspects of your story as it progresses. Think of it as a smart assistant that keeps track of important information and updates it every time something relevant happens in your chat.

What Does the Stat Tracker Actually Do?

The Stat Tracker works by analyzing recent messages in your chat to find information that matches what you're looking for, then automatically updates a persistent note with the latest details. It's like having a personal secretary who takes notes during your story and keeps them organized and current.

Important Note: Only the current tracker state is sent to the LLM during conversations. The older Stat Tracker messages you can see in the chatlog (showing the history of updates) are not sent to the LLM - they're just for your reference to see how the tracker has evolved over time.

How to Set Up a Stat Tracker

1. Click the Stat Tracker button in the persistent guides menu
2. Configure your stat tracker in the popup that appears:
   • Scan Depth: How many recent messages to analyze (e.g., 10-20 messages)
   • Initial Format: The starting structure for your stat tracker (e.g., "Distance {{char}} has moved in meters: 0")
   • Guide Prompt: What to look for in the messages (e.g., "Look for mentions of character movement, distance traveled, or location changes")
   • Stat Tracker Prompt: How to update the stat tracker when new information is found (e.g., "Update the distance tracker with the new movement information")
   • Include Current Tracker in Guide Prompt Context: Enable this for trackers that need to consider previous state (like mood, relationships, or cumulative values)

Tracker Popup Buttons Explained

• Setup Stat Tracker: Creates the initial tracker note in your chat using the Initial Format
• Sync Stat Tracker with Note: Manually synchronizes the tracker with the last existing tracker notes in your chat
• Save: Saves your current tracker configuration (enabled/disabled, prompts, settings)
• Run Stat Tracker: Manually executes the tracker once using current settings
• Close: Closes the configuration popup

Real-World Use Cases

Distance & Movement Tracking

• What it tracks: Character movement, distance traveled, location changes, travel progress
• Example setup:
  • Initial Format: > Distance {{char}} has moved in meters: 0
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Considering the last message alone, write me how far {{char}} has moved in meters in the last message. Give an exact number of your best estimate.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update the Tracker with the Last update without any preamble. Use the following format for your output:] > Distance {{char}} has moved in meters: X
  • Include Current Tracker in Guide Prompt Context: ❌ Disabled - Distance is an absolute value that doesn't depend on previous state
• Result: A running log like "> Distance Alice has moved in meters: 150"

Relationship Tracking

• What it tracks: Character relationships, friendship levels, romantic progress, trust building
• Example setup:
  • Initial Format: {{user}} & {{char}}: 5/10 (Neutral)
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for conversations, gifts, shared experiences, or conflicts between {{user}} and {{char}}. Rate the interaction from -2 to +2.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update the relationship score by adding the interaction value. Keep the format: {{user}} & {{char}}: X/10 (Status)]
  • Include Current Tracker in Guide Prompt Context: ✅ Enabled - Current relationship level affects how difficult it is to increase further
• Result: A running log like "Alice & Bob: 7/10 (Good friends, shared adventure, minor disagreement resolved)"

Story Timeline & Events

• What it tracks: Important dates, story milestones, character achievements, world changes
• Example setup:
  • Initial Format: Day 1: Story begins. Events: []
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for mentions of time passing, major events, character growth, or world developments in the last message.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Add new events with timestamps. Keep the format: Day X: [event description]. Events: [list of all events]]
  • Include Current Tracker in Guide Prompt Context: ❌ Disabled - Events are additive and don't depend on previous state
• Result: A chronological log like "Day 3: Village festival begins, Sarah learns fire magic. Events: [Story begins, Village festival begins, Sarah learns fire magic]"

Resource & Inventory Management

• What it tracks: Money, items, resources, character abilities, equipment
• Example setup:
  • Initial Format: Gold: 100, Items: [], Skills: []
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for purchases, item acquisitions, skill improvements, or resource consumption in the last message.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update the inventory with new items, skills, or gold changes. Keep the format: Gold: X, Items: [list], Skills: [list]]
  • Include Current Tracker in Guide Prompt Context: ❌ Disabled - Resources are absolute values that don't depend on previous state
• Result: A detailed inventory like "Gold: 150, Items: [Steel Sword +2, 5 Healing Potions], Skills: [Fire Magic Level 3]"

Character Development

• What it tracks: Character growth, personality changes, new abilities, character arcs
• Example setup:
  • Initial Format: {{char}}: Started [initial state]. Skills: []. Arc Progress: 0%
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for character decisions, emotional changes, new skills learned, or personality developments in the last message.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update the character sheet with new information, skills, and personality traits. Estimate arc progress percentage.]
  • Include Current Tracker in Guide Prompt Context: ✅ Enabled - Current character state affects how growth and development should be evaluated
• Result: A character sheet like "Emma: Started shy, now confident leader. Skills: [Diplomacy, Sword fighting]. Arc Progress: 70%"

World State & Lore

• What it tracks: World changes, political developments, environmental changes, lore discoveries
• Example setup:
  • Initial Format: World Status: Peaceful, Political Climate: Stable, Events: []
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for world events, political changes, environmental shifts, or new lore revealed in the last message.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update world information, political landscape, and environmental changes. Add new events to the list.]
  • Include Current Tracker in Guide Prompt Context: ✅ Enabled - Current world state affects how new developments should be interpreted
• Result: A world log like "World Status: At war, Political Climate: Tense, Events: [Kingdom declares war on neighboring empire, Unseasonal storms increasing, Ancient ruins discovered]"

Mood & Emotional State Tracking

• What it tracks: Character emotional states, mood changes, stress levels, mental health
• Example setup:
  • Initial Format: {{char}} Mood: 5/10 (Neutral) - Stress: Low
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for emotional changes, stress factors, or mood influences in the last message. Rate mood change from -3 to +3, stress from -2 to +2.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update the mood and stress levels. Keep the format: {{char}} Mood: X/10 (Description) - Stress: Level]
  • Include Current Tracker in Guide Prompt Context: ✅ Enabled - Current emotional state affects how new events impact mood and stress
• Result: A running log like "Alice Mood: 7/10 (Happy) - Stress: Low"

Skill & Experience Tracking

• What it tracks: Character skill levels, experience points, learning progress, mastery
• Example setup:
  • Initial Format: {{char}} Skills: [Sword Fighting: 1/100 XP], Total XP: 0
  • Guide Prompt: [OOC: Answer me out of Character! Don't continue the RP. Look for skill usage, learning moments, or practice in the last message. Estimate XP gained from 1-10.]
  • Stat Tracker Prompt: [OOC: Answer me out of Character! Don't continue the RP. Update skill XP and total XP. Keep the format: {{char}} Skills: [Skill: X/100 XP], Total XP: X]
  • Include Current Tracker in Guide Prompt Context: ✅ Enabled - Current skill levels affect how much XP should be gained from activities
• Result: A running log like "Alice Skills: [Sword Fighting: 25/100 XP], Total XP: 25"

How the Stat Tracker Works in Practice

1. Automatic Monitoring: Once set up, the stat tracker runs automatically before each message you send
2. Smart Analysis: It reads through recent chat messages looking for information that matches your guide prompt
3. Intelligent Updates: When it finds relevant information, it uses your stat tracker prompt to update the persistent note
4. Persistent Storage: The updated stat tracker information stays in your chat context, so the AI always knows the current state
5. Context Awareness: The AI can reference this information to maintain consistency in your story
6. Historical Reference: Old tracker messages remain in the chatlog for your reference, but only the current state is sent to the LLM

Tips for Effective Stat Tracker Use

• Be Specific: Instead of "track relationships," try "track romantic progress between Alice and Bob, noting dates, gifts, and meaningful conversations"
• Use Clear Formats: Make your initial format easy to read and update (e.g., "Points: 0, Status: Neutral, Last Event: None")
• Balance Detail vs. Simplicity: Too much detail can overwhelm the AI, too little can be useless
• Regular Review: Check your stat tracker occasionally to make sure it's capturing what you want
• Adapt Over Time: As your story evolves, you might want to adjust what the stat tracker looks for
• Use OOC Instructions: Include "[OOC: Answer me out of Character! Don't continue the RP.]" in prompts to ensure the AI gives you the information you need without continuing the story

The Stat Tracker transforms your story from a series of disconnected events into a living, breathing world where everything matters and nothing is forgotten. It's perfect for complex stories with multiple characters, ongoing plots, or detailed world-building where you want to maintain consistency and depth across many chat sessions.

Management Actions

After you have created guides you can manage them from the bottom of the persistent guides menu:

• Edit Guides (edit icon): Opens a popup listing all active guides. Select a guide to edit its text and reinject it. This uses /listinjects and /input commands.
• Show Guides (eye icon): Displays all active guide injections in a popup without editing.
• Flush Guides (trash icon): Lists active guides and allows you to remove selected ones or all guides using /flushinjects. Use this to clear outdated context.

Auto‑Triggers

You can enable automatic triggering of the Thinking, Clothes, State and Custom Auto guides in the settings panel. When enabled the corresponding guide will run after every AI message. Auto‑triggered guides help keep context up to date without manual intervention.

Using Persistent Guides

1. Open the menu: Click the persistent guides button.
2. Choose a guide type:
   • For Situational, you may be asked to provide a focus (optional) and the extension will summarise the recent chat.
   • For Thinking, Clothes or State, the guide runs immediately.
   • For Rules, it will ask for any topics to include.
   • For Custom, a text box appears where you can write your own context.
   • For Fun or Stat Tracker, follow the instructions in the pop‑up.
3. The generated guide will be injected and persist until you flush or edit it.
4. Use the management actions to edit, view or remove guides as needed.

Tips

• Use situational guides when the conversation moves to a new scene or when the AI seems to lose track of earlier events.
• Keep the thinking, clothes and state guides concise; they should provide relevant details without overwhelming the model.
• Remember to flush guides when they are no longer relevant to avoid conflicting context.