4.8.5: 🎮 Game Cartridges

Now you can save or export your entire setup:
Save your entire configuration — system prompt sections, ordering, on/off toggles, Game Systems, tracker modules, block order, stock prompts, and the State Tracker's extractor prompt — as a named Game Cartridge. Export it to share with others, or Import one someone else made. Loading a cartridge fully replaces your current configuration.

Bugfixes

• Fixed Lorebook Agent [CORE] blocks being wiped by deduplication regex.

v4.8.0: The Ultimate Customization Upgrade

System Prompt Control Room

Under the Game Systems menu, there's now just two sections: 1. Game System Wizard, and 2. System Prompt Control Room.

The System Prompt Control Room is a unified area for managing the system prompt. It allows adding (via AI or manually), editing, reordering, and enabling/disabling system prompt sections.

Pressing "Unlock" allows you to edit any

of the prompt, allowing total freedom and customization. Change any system as much as you like or disable them altogether.

Any game systems created by the wizard will also show up here, labeled with 🧙 to differentiate them.

v4.7.0: 🧙 AI-Powered Game Systems Wizard

The Game Systems Wizard

I've added a new section to the options called Game Systems. Here you can use the Game System Wizard. This system allows you to simply describe something you want to implement in your game in natural language, for example "reputation system."

AI creates the requested system prompt segment and the accompanying tracker module (if it is necessary.) You can then iterate with AI or edit manually. This means that you don't need to figure out how the logic of the extension works from scratch. You can simply have AI do the heavy lifting and adjust by yourself.

Bars in Percentages

To keep the math simple, values that tick down based on [TIME] deltas between outputs have high totals. This is so that the tracker only has to deal with integers, never decimals, and the tracker doesn't have to be hooked to external calculators. It remains LLM-driven and dead-simple to use.

To keep the UI neat instead of showing something like 234/800, I've added a read-only toggle to the bar options (click on any bar) that converts any bar to percentages, so they will display as X/100 regardless of the total.

Unlock Base Sections

You can now freely unlock and edit any of the base sections of the system prompt, giving you total freedom to edit, rebalance, etc. any stock system in the extension.

The custom sysprompt library from before remains accessible under Advanced: Manual Sysprompt Sections in the same menu.

What's Next?

• Rendering improvements.
• Likely a reworked options menu that takes it out of the cramped drawer. General reworking of the options, ensuring there's nothing redundant.
• Probably something new for World Progression.
• Something to diversify the names given by the character creator and other systems (the Anti-Kaelen Vane Protocol.)

v4.6.0: Improved Character Creation

There's now a full, AI-powered character creator on the startup page. Includes lots of genre and archetype options for characters.

You can either inject the resulting character card into the native SillyTavern Persona system or inject it into Lorebook Agent (while using a generic Persona card like "Player/User/etc.")

This should make starting a fresh scenario better and more interesting.

Thanks to Jas for the feature. He built the thing for the most part; I just polished it up and fixed bugs.

Other Stuff

• Further optimization/performance improvements
• Lorebook Agent's prompts are now correctly dynamically changed when the time & date formats are switched
• Turning off the extension (from the on/off button in the UI) stops it from injecting its system prompt

v4.5.0: New Alt. UI (WIP)

v4.5.0: New UI (WIP) and Optimization

New Tab-Based UI

I've added a new UI option that should work better for small screens/resolutions (including mobile). Instead of the modules being vertically stacked over each other, in this mode you choose which one to display, one at a time.

You can enable it from the General & Visual settings. It's a work in progress and will improve further.

I also changed the layout of the header buttons on mobile. The header now permanently displays Lorebook Agent, Direct Prompt, and Raw View. Other less important buttons are under the drawer.

Optimization

Everything should stutter and lag less now. The code has been optimized to perform less (hopefully no) redundant operations.

Persistent Position

If you close the UI and refresh, the program now remembers that the UI is closed and doesn't reopen it every time. The position is also saved even if the UI is closed and reopened.

v4.3.7

Patch notes since v4.3.4 (commits bb3bc67 → 28eaac1):

---

v4.3.7

28eaac1

Added

• Onboarding Initial Setup step 4: match your SillyTavern Persona name to the State Tracker character after creation; you can still describe the character in Persona as usual.

Fixed

• Scenario Profiles now save and restore stock module prompt edits (including all TIME variants), module enable/order, and per-module pagination. Chat-linked state uses the same snapshot helpers.

---

v4.3.6

b0cadb0 (+ quest UI polish 15efd29)

Added

• Per-chat time/date settings: 24h clock, Day vs DD/MM/YYYY calendar, and initial date anchor persist per chat when chat linking is on.
• Onboarding layout: segmented Day/Date and 12h/24h toggles, Sci-Fi and Horror genre templates with matching archetype buttons, section dividers (How It Works / Setup Guide).

Changed

• Time/date UI sync: onboarding, Modules & Order pills, and Extension Settings all use shared setters — no contradictory toggle state.
• TIME module prompt editor: Edit/Reset picks the correct stock variant (time, time_24h, time_ddmmyy, time_ddmmyy_24h) from clock + calendar settings.
• Status footer placement: <end_of_output_footer> moved to immediately after </combat> in both sysprompt files.
• Onboarding copy: updated How It Works, Initial Setup (time/date step), simplified model recommendations (MiMo 2.5 Pro GM, Gemini 3.1 Flash-Lite for tracker/agent).
• Lorebook Agent docs: removed obsolete Max Tokens reference; Campaign Records explains native Lorebook book creation.

Fixed

• Quest log UI (15efd29): remaining active objectives are struck through when a quest is marked completed, even if some OBJ_ACTIVE lines weren’t updated individually.

---

v4.3.5

bb3bc67, dfa1f4f

Added

• Quest archive UI: completed/failed quests move to separate COMPLETED / FAILED sections; archived entries can be dismissed manually. Show archived quests toggle in settings (default on).
• Edit with AI (Modules): Edit with AI in the stock prompt editor and Custom Module Editor — describe changes in plain language, preview/accept flow (same pattern as Add Custom AI).

Changed

• Quest memo cleanup: archived quests (completed, failed, past deadline) sync to settings, then strip from stored [QUESTS] memo automatically.
• Quest prompt wording: restored instructions to keep completed/failed entries with updated STATUS so the tracker can archive before memo strip. Auto-migrates saved prompts that used over-aggressive “active only” wording.

Fixed

• Empty [QUESTS] on completion: State Tracker no longer told to emit an empty quest block when the last active quest completes — prevents lost archive sync.
• Stock prompt editor pagination: TIME (24h) module uses the correct block tag for pagination threshold lookup.

v4.3.4

---

Changes since v4.2.1.

---

Performance

• Faster page reload (F5) — Startup no longer blocks on full lorebook registry scans, duplicate chat-bootstrap work, or Campaign Records rendering while the Lorebook Agent panel is closed.
• Faster Campaign Records — Routine manifest refreshes skip disk/registry rescans; manual ↻ refresh still does a full scan to discover new books. Lorebooks load in parallel; NPC inline editors build lazily on expand.
• disableManagedEntries optimized — Uses saved campaign book lists where possible, avoids redundant API probes, and runs deferred in the background.

---

Lorebook Agent

• Last Run / Next run status — Footer shows when the agent last ran (relative time) and countdown to the next auto-run.
• Since-last-run watermark fixes — Watermark persists per chat, handles swipes/stale indices, restores correctly on undo/redo, and resets auto-run throttle after manual passes.
• [CORE] prompt tightening — Agent instructions now discourage plot-tied scene recaps in permanent NPC identity blocks.
• World Skeleton isolation — Skeleton books are excluded from agent archive, tools, activation, and Campaign Records manifest.
• Activate Books — Refreshes Campaign Records after activation so new books appear without F5.

---

World Progression

• Timer persistence overhaul — WP “last fired” state saves to chat-linked state, survives reloads, and no longer bleeds between chats.
• Time math refactor — Label-based timer anchor, fixed epoch handling, conditional narrative injection.
• UI fixes — “Next fire” display derives from the stored label; fallback parses current memo time when last fired is “Never”.
• Reset Timeline — New button in the Lorebook Agent panel and Extension Settings to reset WP timer state for the current chat.

---

NPCs & Portraits

• Show NPC Portraits toggle — When off, NPCs use the compact list view (like Events/Locations), NPC portrait auto-generation is disabled, and Add NPC to Story remains available.
• Compact NPC view — CORE address-card button (left of name), relationship stats (🤝/💗) when Relationship System is enabled, live rel-stat updates without full manifest reload.
• NPC detail popup — Removed “(Immutable)” from Core Identity section header.

---

Quests

• LogQuest removed — Plain-text [QUESTS] blocks are now the only quest path; Standard/Tool quest mode dropped.
• Quest state on rollback & chat switch — Clears per-chat quest bleed; settings.quests resyncs from memo on restore; memo is authoritative over stale completed entries in the UI.

---

Combat & Connection Manager

• Combat auto-switch — When [COMBAT] is active in the State Tracker memo, switches the main narration Connection Manager profile via /profile; restores baseline when combat ends.
• Combat completion preset override — Combat auto-switch can restore a separate chat completion preset alongside the connection profile.

---

State Tracker & Onboarding

• Character creator XP fix — [XP] block is always included with level-specific thresholds; onboarding level dropdown value is forwarded correctly for all archetypes (including Custom and Persona).
• Onboarding prompt hints — Opening/closing tags enforced in hints to reduce unclosed block output from the model.
• Renamed setting — “Enable RPG Tracker” → “Enable State Tracker” in settings and tooltips.

---

Fixes

• Fixed saveSettings reference error in narrative-hooks.js.
• Fixed manifest refresh scoping issues when toggling NPC portrait mode.
• Fixed settings toggle not reloading Campaign Records immediately (manifest refresh wiring).

---

Upgrade notes

• If you use World Progression, timer state is now per-chat — switching chats should no longer carry “last fired” between scenarios. Use Reset Timeline if a chat’s WP clock looks wrong after upgrading.
• If you relied on LogQuest / tool-based quests, migrate to plain-text [QUESTS] output in your narrator prompt.
• After upgrading, a normal F5 should feel noticeably snappier; open the Lorebook Agent panel when you want Campaign Records to load.

---

Full commit range: 4.2.1 → 4.3.4 (20 commits)

---

v4.2.1

Version 4.2.1

🛠️ NPC Core Identity & Tooling Upgrades

• Upgraded Core Identity Updates: The old physical appearance update tool (UPDATE_APPEARANCE) has been replaced by a generalized UPDATE_CORE tool. The agent now has full surgical access to edit any of the permanent fields inside the [CORE] block:
  • Appearance/Species
  • Personality
  • Brief Background
  • Habits/Behaviors
• Sensible Extrapolation Guidance: Rewrote the system instructions for character creation in the prompt. The agent is now commanded to treat core fields as a character bible entry and extrapolate sensibly from behavior/clues rather than simply summarizing the immediate observed scene.
• UI Clarification: Removed the (Immutable) label from the Core Identity section header in the NPC detail popup, reflecting the agent's new ability to update these fields as characters develop.

⚙️ Performance & Default Adjustments

• Default Router Runs to 3: The Lorebook Agent now runs every 3 turns by default instead of every turn for new configurations. This reduces token usage, increases generation speed, and lets the agent see more context before updating (producing more coherent entries). Keyword activation remains immediate.
  • Added descriptions and hover tooltips explaining the tradeoff to both the settings menu and the inline panel.
• Relationships Enabled by Default: New configurations now default to having NPC Relationship Bars (npcRelationshipBars) enabled. Existing user configurations are preserved.

📜 Quest System Fixes & Improvements

• Quest Persistence Fix: Resolved an issue where completed quests would disappear from the UI upon page reloads. Quests are now properly persisted to disk in the chat state rather than being derived solely from the active memo.
• Autocompleting Active Quests: Quests whose objectives are all marked complete will now automatically transition to a completed status instead of remaining stuck as active.
• Clean State Tracker Boundaries: Instructed the State Tracker in the system prompt to never create new quests on its own, leaving quest logging strictly to the LogQuest tool.

v4.0.0: 💞 Relationship System

There's now an optional dating sim-style component that tracks relations between the player and NPCs. The current relationship values are dynamically injected based on keyword matching.

This is split into two categories: friendship and affection. The GM will give these as updates, for example, "(Affection: Seraphina +2 — she found his honesty disarming, his humor endearing)", and Lorebook Agent will then record them as part of its regular pass.

On initial NPC recording, Lorebook Agent will infer a reasonable starting relationship for the NPC based on the immediate context. For example, an established friend might start with +40 friendship, a lover with +70 affection, and so on.

It works, but I haven't tested it nearly enough yet. It was largely implemented by @ontimejas. I just polished it and fixed some bugs, as well as doing some brief testing. Thanks for the contribution!

It's off by default, but turn it on and give it a try if you're into this kind of thing. The system can be toggled either in narrator configuration or Lorebook Agent settings.

As always, all of the prompts for this system, too, can be adjusted and are split between the main system prompt and the Lorebook Agent's NPC prompt in the Modular Repertoire (Prompt Rules) section.

Bugfixes

• Toggling quests on/off now correctly hides the QUESTS module in the State Tracker and removes the pertinent
  from the system prompt.
• Not exactly a bugfix, but you can now add/import NPCs into an empty story even if there's no existing NPC lorebook. Remember that you can also create or do anything in Lorebook Agent using the 💬 direct prompt option.

🕒 v3.8.5: 24h Time and Bugfixes

I updated the Lorebook Agent NPC prompt to format the [CORE] blocks correctly and not put timestamps to them. Previously it would timestamp the basic NPC card as well (at least with Gemini 3 Flash), which made zero sense. Update and opt to reset the prompt to benefit from this.

24h clock can now also be selected in the [TIME] module.