v3.7.2: Fix status field key generation for parenthetical names & scroll preservation

- Fix: Status fields with parenthetical descriptions (e.g., 'Conditions (up to 5 traits)') now use the base name for the JSON key ('conditions' instead of 'conditions_up_to_5_traits')
- Fix: Status field value templates no longer repeat the field name with numbered suffixes
- Fix: Editing fields in Present Characters no longer scrolls the panel to the top
- Updated jsonPromptHelpers.js, parser.js, and userStats.js to use new toFieldKey() helper
- Added scroll position preservation to renderThoughts() when re-rendering after field edits

127.0.0.1-1764910915146.log

@@ -1,683 +0,0 @@
-i18n.js:143 Unsupported language: en-us
-findLang @ i18n.js:143
-getLocaleData @ i18n.js:119
-initLocales @ i18n.js:274
-await in initLocales
-firstLoadInit @ script.js:657
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-extensions.js:368  GET http://127.0.0.1:8000/scripts/extensions/third-party/chroma/manifest.json 404 (Not Found)
-(anonymous) @ extensions.js:368
-getManifests @ extensions.js:367
-loadExtensionSettings @ extensions.js:1331
-await in loadExtensionSettings
-getSettings @ script.js:7011
-await in getSettings
-firstLoadInit @ script.js:671
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-extensions.js:368  GET http://127.0.0.1:8000/scripts/extensions/third-party/NemoEngine/manifest.json 404 (Not Found)
-(anonymous) @ extensions.js:368
-getManifests @ extensions.js:367
-loadExtensionSettings @ extensions.js:1331
-await in loadExtensionSettings
-getSettings @ script.js:7011
-await in getSettings
-firstLoadInit @ script.js:671
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-extensions.js:368  GET http://127.0.0.1:8000/scripts/extensions/third-party/Hi/manifest.json 404 (Not Found)
-(anonymous) @ extensions.js:368
-getManifests @ extensions.js:367
-loadExtensionSettings @ extensions.js:1331
-await in loadExtensionSettings
-getSettings @ script.js:7011
-await in getSettings
-firstLoadInit @ script.js:671
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-power-user.js:3223 Window resize: 1081x854 -> 1081x854
-index.js:198 No current task
-system.js:121 Using default TTS Provider settings
-index.js:21 [QR2] sets:  [QuickReplySet]
-index.js:21 [QR2] settings:  QuickReplySettings {isEnabled: false, isCombined: false, isPopout: false, showPopoutButton: true, config: QuickReplyConfig, …}
-jquery-highlight.js:7 Patching jQuery highlight
-index.js:751 [RPG Companion] Starting initialization...
-mobile.js:58 [RPG Mobile] ========================================
-mobile.js:59 [RPG Mobile] setupMobileToggle called
-mobile.js:60 [RPG Mobile] Button exists: true jQuery object: S {0: button#rpg-mobile-toggle.rpg-mobile-toggle, length: 1}
-mobile.js:61 [RPG Mobile] Panel exists: true
-mobile.js:62 [RPG Mobile] Window width: 1081
-mobile.js:63 [RPG Mobile] Is mobile viewport (<=1000): false
-mobile.js:64 [RPG Mobile] ========================================
-mobile.js:75 [RPG Mobile] Loading saved FAB position: {left: '854.6666870117188px', top: '110px'}
-desktop.js:106 [RPG Desktop] Desktop tabs initialized
-thoughts.js:24 [RPG Thoughts] ==================== RENDERING PRESENT CHARACTERS ==================== 
-thoughts.js:24 [RPG Thoughts] showCharacterThoughts setting: true
-thoughts.js:24 [RPG Thoughts] Container exists: true
-thoughts.js:24 [RPG Thoughts] Raw characterThoughts data: 
-thoughts.js:24 [RPG Thoughts] Data length: 0 chars
-thoughts.js:24 [RPG Thoughts] Enabled custom fields: (2) ['Appearance', 'Demeanor']
-thoughts.js:24 [RPG Thoughts] Enabled character stats: (12) ['Energy', 'Fertility', 'Stress', 'Affection for Dev', 'Libido', 'Loyalty', 'Bladder', 'Bowel', 'Hunger', 'Cleanliness', 'Obedience to Dev', 'Dominance']
-thoughts.js:24 [RPG Thoughts] Split into lines count: 1
-thoughts.js:24 [RPG Thoughts] Lines: ['']
-thoughts.js:24 [RPG Thoughts] ==================== PARSING COMPLETE ==================== 
-thoughts.js:24 [RPG Thoughts] Total characters parsed: 
-thoughts.js:24 [RPG Thoughts] Characters array: []
-thoughts.js:24 [RPG Thoughts] ==================== BUILDING HTML ==================== 
-thoughts.js:24 [RPG Thoughts] Starting HTML generation for 0 characters
-thoughts.js:24 [RPG Thoughts] ⚠ No characters parsed - showing placeholder card 
-thoughts.js:24 [RPG Thoughts] ✓ HTML rendered to container 
-thoughts.js:24 [RPG Thoughts] ======================================================= 
-memoryRecollection.js:717 [Memory Recollection] Setting up button via event listener
-lorebookLimiter.js:16 [Lorebook Limiter] Initializing...
-lorebookLimiter.js:137 [Lorebook Limiter] Setting up activation limiter...
-lorebookLimiter.js:197 [Lorebook Limiter] ✅ Patched SillyTavern.getContext().getWorldInfoPrompt
-htmlCleaning.js:66 [RPG Companion] HTML cleaning regex already exists, skipping import
-mobile.js:498 [RPG Mobile] Skipping viewport constraint - button not visible
-index.js:700 [RPG Companion] Preset "RPG Companion Trackers" already exists
-index.js:841 [RPG Companion] ✅ Extension loaded successfully
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '::-webkit-scrollbar-track:focus-visible { background-color: rgba(126, 126, 126, 0.2); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-panel::-webkit-scrollbar-thumb:focus-visible, #rpg-panel-content::-webkit-scrollbar-thumb:focus-visible, .rpg-content-box::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-border); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-panel::-webkit-scrollbar-thumb:focus-visible, #rpg-panel-content::-webkit-scrollbar-thumb:focus-visible, .rpg-content-box::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-border); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-panel::-webkit-scrollbar-thumb:focus-visible, #rpg-panel-content::-webkit-scrollbar-thumb:focus-visible, .rpg-content-box::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-border); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-inventory-items::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-stats-left::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-stats-grid::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-classic-stats-grid::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-info-content::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-notebook-lines::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-text); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-character-card::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-highlight); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-character-info::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-highlight); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-character-stats::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-highlight); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-thought-bubble::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-highlight, #e94560); opacity: 0.8; }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-inventory-subtabs::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-accent); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-inventory-header::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-accent); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-dynamic-styles.js:147 Failed to insert focus rule: SyntaxError: Failed to execute 'insertRule' on 'CSSStyleSheet': Failed to parse the rule '.rpg-tabs-nav::-webkit-scrollbar-thumb:focus-visible { background: var(--rpg-highlight); }'.
-    at dynamic-styles.js:145:34
-    at Array.forEach (<anonymous>)
-    at applyDynamicFocusStyles (dynamic-styles.js:118:16)
-    at dynamic-styles.js:193:13
-    at Array.forEach (<anonymous>)
-    at initDynamicStyles (dynamic-styles.js:191:38)
-    at firstLoadInit (script.js:673:5)
-    at async HTMLDocument.<anonymous> (script.js:11134:5)
-(anonymous) @ dynamic-styles.js:147
-applyDynamicFocusStyles @ dynamic-styles.js:118
-(anonymous) @ dynamic-styles.js:193
-initDynamicStyles @ dynamic-styles.js:191
-firstLoadInit @ script.js:673
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-memoryRecollection.js:728 [Memory Recollection] app_ready event fired
-memoryRecollection.js:758 [Memory Recollection] Attempting to add button...
-memoryRecollection.js:777 [Memory Recollection] Found container with selector: #WorldInfo .justifyLeft <div class=​"range-block-title justifyLeft">​…​</div>​
-memoryRecollection.js:817 [Memory Recollection] ✅ Button added successfully!
-memoryRecollection.js:754 [Memory Recollection] Button already exists
-lorebookLimiter.js:46 [Lorebook Limiter] Attached to WI drawer button
-lorebookLimiter.js:69 [Lorebook Limiter] Injecting UI...
-lorebookLimiter.js:91 [Lorebook Limiter] Found Memory Recollection button, injecting slider after it
-lorebookLimiter.js:129 [Lorebook Limiter] ✅ UI injected successfully
-utils.js:1663 Uncaught (in promise) Error: Timed out waiting for condition to be true
-    at utils.js:1663:23
-(anonymous) @ utils.js:1663
-setTimeout
-(anonymous) @ utils.js:1660
-waitUntilCondition @ utils.js:1659
-bindConnectionProfilesSelect @ index.js:349
-(anonymous) @ index.js:681
-g @ eventemitter.js:193
-EventEmitter.emit @ eventemitter.js:146
-await in EventEmitter.emit
-firstLoadInit @ script.js:705
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501
-extensions.js:290  GET http://localhost:5100/api/modules net::ERR_CONNECTION_REFUSED
-doExtrasFetch @ extensions.js:290
-connectToApi @ extensions.js:570
-loadExtensionSettings @ extensions.js:1339
-await in loadExtensionSettings
-getSettings @ script.js:7011
-await in getSettings
-firstLoadInit @ script.js:671
-await in firstLoadInit
-(anonymous) @ script.js:11134
-e @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-setTimeout
-(anonymous) @ jquery-3.5.1.min.js:2
-c @ jquery-3.5.1.min.js:2
-add @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-Deferred @ jquery-3.5.1.min.js:2
-then @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-(anonymous) @ jquery-3.5.1.min.js:2
-S @ jquery-3.5.1.min.js:2
-(anonymous) @ script.js:9501

CHARACTER_TRACKING_README.md

@@ -1,479 +0,0 @@
-# Character State Tracking System for SillyTavern RPG Companion
-
-## 📖 Overview
-
-This is a **comprehensive character state tracking system** based on the Katherine RPG framework. Unlike traditional RPG companions that track **{{user}}** stats, this system tracks **{{char}}** (the AI character's) internal states, emotions, relationships, and physical condition.
-
-### What It Tracks
-
-#### 🧬 Primary Traits (Personality DNA)
-- **40+ personality traits** that define who the character IS
-- Core disposition (dominance, introversion, emotional stability)
-- Sexual personality (perversion, exhibitionism, masochism, etc.)
-- Moral core (honesty, empathy, corruption, etc.)
-- Intellectual traits (intelligence, wisdom, creativity)
-- **These change SLOWLY** - only through sustained experiences over time
-
-#### 🌤️ Secondary States (Emotional Weather)
-- **70+ temporary emotional states** that change frequently
-- Core emotions (happy, sad, angry, anxious, etc.)
-- Arousal & sexual states (horny, frustrated, seductive, etc.)
-- Social states (lonely, confident, playful, etc.)
-- Energy & altered states (drunk, exhausted, euphoric, etc.)
-- **These change FAST** - minute to hour timescales
-
-#### 💭 Beliefs & Worldview
-- Track character's beliefs with strength and stability
-- Moral beliefs, spiritual beliefs, self-concept
-- Relationship beliefs, sexual morality
-- Beliefs can fracture during pivotal moments
-
-#### 🏃 Physical Stats
-- Survival needs (hunger, thirst, bladder, energy, sleep)
-- Physical condition (health, pain, temperature, cleanliness)
-- Physical attributes (strength, stamina, agility)
-
-#### 👗 Outfit/Clothing System
-- Dynamic tracking of what character is wearing
-- Per-piece tracking (bra, panties, shirt, pants, etc.)
-- Status tracking (worn properly, shifted, removed, torn, wet)
-- Coverage calculation (0-100% body coverage)
-
-#### ❤️ Relationship Tracking
-- **Per-NPC detailed relationship stats**
-- Core metrics: Trust, Love, Loyalty, Attraction, Respect, Fear
-- Social dynamics: Closeness, Openness, Comfort, Dependency
-- Sexual dynamics: Flirtiness, Sexual Compatibility, Satisfaction
-- Power dynamics: Dominance, Submissiveness, Possessiveness
-- Current thoughts about each person
-
-#### 🎬 Contextual Information
-- Location, time of day, weather
-- Present characters in the scene
-- Recent events
-- Current activity
-
----
-
-## 🔄 How It Works
-
-### The Flow
-
-1. **LLM receives current character state** as input before generating a response
-2. **LLM generates the character's response** based on their current emotional/physical state
-3. **LLM updates character states** based on what happened in the response
-4. **Parser extracts and applies updates** to the character state
-5. **UI displays updated states** for the user to see
-
-### Example
-
-**Before Response:**
-- Character: Katherine
-- Emotional State: Lonely (70), Anxious (40), Horny (30)
-- Relationship with User: Trust 85, Love 60, Attraction 75
-- Physical: Energy 50%, Arousal 30%
-- Location: Katherine's apartment
-- Thoughts: "I wish {{user}} would stay longer..."
-
-**LLM generates response where Katherine invites {{user}} to stay for dinner**
-
-**After Response:**
-- Emotional State Changes:
-  - Lonely: -20 (reason: {{user}} accepted invitation)
-  - Happy: +25 (reason: spending time with {{user}})
-  - Hopeful: +15 (reason: possibility of intimacy)
-- Relationship Updates:
-  - Trust: +5 (reason: {{user}} agreed to stay)
-  - Closeness: +10 (reason: intimate setting)
-  - Thoughts: "Maybe tonight is finally the night..."
-- Physical Changes:
-  - Energy: -5 (reason: cooking dinner)
-  - Arousal: +15 (reason: anticipation of being alone with {{user}})
-
----
-
-## 📁 File Structure
-
-```
-src/
-├── core/
-│   ├── characterState.js          # Character state data structure & management
-│   └── state.js                    # Original extension state (keep for compatibility)
-│
-├── systems/
-│   ├── generation/
-│   │   ├── characterPromptBuilder.js   # Generates prompts for character tracking
-│   │   ├── characterParser.js          # Parses LLM responses and updates states
-│   │   ├── promptBuilder.js            # Original prompt builder (still used for user tracking)
-│   │   └── parser.js                   # Original parser
-│   │
-│   └── rendering/
-│       ├── characterStateRenderer.js   # Renders character state in UI
-│       └── [other renderers...]
-│
-└── [other modules...]
-```
-
----
-
-## 🚀 Getting Started
-
-### 1. Installation
-
-Copy all the new files into your RPG Companion extension:
-
-- `src/core/characterState.js`
-- `src/systems/generation/characterPromptBuilder.js`
-- `src/systems/generation/characterParser.js`
-- `src/systems/rendering/characterStateRenderer.js`
-
-### 2. Integration with Main Extension
-
-You'll need to modify `index.js` to integrate the character tracking system:
-
-```javascript
-// Import character tracking modules
-import {
-    getCharacterState,
-    updateCharacterState,
-    initializeRelationship
-} from './src/core/characterState.js';
-
-import {
-    generateCharacterTrackingPrompt,
-    generateSeparateCharacterTrackingPrompt
-} from './src/systems/generation/characterPromptBuilder.js';
-
-import {
-    parseAndApplyCharacterStateUpdate,
-    removeCharacterStateBlock
-} from './src/systems/generation/characterParser.js';
-
-import {
-    renderCharacterStateOverview,
-    updateCharacterStateDisplay
-} from './src/systems/rendering/characterStateRenderer.js';
-```
-
-### 3. Hook into Message Received Event
-
-```javascript
-// In your onMessageReceived handler
-async function onMessageReceived(data) {
-    if (!extensionSettings.enabled) return;
-
-    // Parse character state update from the response
-    const stateUpdate = parseAndApplyCharacterStateUpdate(data.mes);
-
-    // Update UI
-    updateCharacterStateDisplay();
-
-    // Optionally remove the state block from the displayed message
-    if (stateUpdate) {
-        data.mes = removeCharacterStateBlock(data.mes);
-    }
-}
-```
-
-### 4. Hook into Generation Started Event
-
-```javascript
-// In your onGenerationStarted handler
-async function onGenerationStarted(data) {
-    if (!extensionSettings.enabled) return;
-
-    // Add character tracking prompt to the generation
-    const characterPrompt = generateCharacterTrackingPrompt();
-
-    // Inject into the prompt (method depends on your setup)
-    // Example: use extension_prompts system
-    setExtensionPrompt(
-        'CHARACTER_STATE_TRACKING',
-        characterPrompt,
-        extension_prompt_types.AFTER_SCENARIO,
-        0, // position
-        false, // scan depth
-        extension_prompt_roles.SYSTEM
-    );
-}
-```
-
-### 5. Add UI Container
-
-Add this to your `template.html`:
-
-```html
-<div id="rpg-character-state-container" class="rpg-section">
-    <!-- Character state will be rendered here -->
-</div>
-```
-
----
-
-## 🎨 Customization
-
-### Choosing Which States to Track
-
-You can customize which states to track by modifying `characterState.js`:
-
-```javascript
-// Focus on emotional tracking only
-export let characterState = {
-    characterName: null,
-    secondaryStates: {
-        happy: 50,
-        sad: 0,
-        angry: 0,
-        horny: 0
-        // Add only the emotions you care about
-    },
-    // Remove sections you don't need
-};
-```
-
-### Customizing the Prompt
-
-Edit `characterPromptBuilder.js` to change how the LLM is instructed:
-
-```javascript
-// Simplify the tracking instructions
-instructions += `Update only these states:\n`;
-instructions += `- Emotions: happy, sad, angry, aroused\n`;
-instructions += `- Energy level\n`;
-instructions += `- Thoughts about {{user}}\n`;
-```
-
-### Styling the UI
-
-Add custom CSS for the character state display:
-
-```css
-.rpg-character-overview {
-    background: rgba(0, 0, 0, 0.7);
-    border-radius: 8px;
-    padding: 15px;
-}
-
-.rpg-emotion-item {
-    display: flex;
-    align-items: center;
-    margin-bottom: 8px;
-}
-
-.rpg-relationship-card {
-    background: rgba(255, 255, 255, 0.05);
-    padding: 10px;
-    border-radius: 5px;
-    margin-bottom: 10px;
-}
-```
-
----
-
-## 💡 Advanced Features
-
-### Automatic Character Initialization
-
-When starting a new chat, you can automatically initialize the character's personality traits from their character card:
-
-```javascript
-import { generateCharacterInitializationPrompt } from './src/systems/generation/characterPromptBuilder.js';
-import { parseCharacterInitialization } from './src/systems/generation/characterParser.js';
-
-async function initializeCharacterFromCard() {
-    const prompt = await generateCharacterInitializationPrompt();
-
-    // Send to LLM (using your API client)
-    const response = await generateRaw(messages, api, false);
-
-    // Parse and apply
-    const traits = parseCharacterInitialization(response);
-    if (traits) {
-        updateCharacterState({ primaryTraits: traits });
-    }
-}
-```
-
-### Relationship Analysis
-
-Automatically analyze relationships when new characters appear:
-
-```javascript
-import { generateRelationshipAnalysisPrompt } from './src/systems/generation/characterPromptBuilder.js';
-import { parseRelationshipAnalysis } from './src/systems/generation/characterParser.js';
-
-async function analyzeRelationship(npcName) {
-    const prompt = generateRelationshipAnalysisPrompt(npcName);
-
-    // Send to LLM
-    const response = await generateRaw([{role: 'user', content: prompt}], api, false);
-
-    // Parse and apply
-    const relationshipData = parseRelationshipAnalysis(response);
-    if (relationshipData) {
-        updateRelationship(npcName, relationshipData);
-    }
-}
-```
-
-### Persistent State Storage
-
-Save character state to chat metadata:
-
-```javascript
-import { getCharacterState } from './src/core/characterState.js';
-
-function saveCharacterState() {
-    const charState = getCharacterState();
-
-    // Save to SillyTavern chat metadata
-    chat_metadata.rpg_character_state = charState;
-    saveChatDebounced();
-}
-
-function loadCharacterState() {
-    if (chat_metadata.rpg_character_state) {
-        setCharacterState(chat_metadata.rpg_character_state);
-    }
-}
-```
-
----
-
-## 📊 State Change Guidelines
-
-### Emotional States (Secondary States)
-
-**Small changes (+/- 5-15):**
-- Normal conversation
-- Minor events
-- Gradual mood shifts
-
-**Medium changes (+/- 20-40):**
-- Significant events
-- Important revelations
-- Strong emotional moments
-
-**Large changes (+/- 50+):**
-- Life-changing events
-- Trauma
-- Peak experiences
-
-### Relationship Changes
-
-**Trust:**
-- Vulnerability rewarded: +5 to +15
-- Promise kept: +5
-- Betrayal: -30 to -60
-
-**Love:**
-- Romantic moment: +5 to +20
-- Declaration of feelings: +20 to +40
-- Heartbreak: -40 to -80
-
-**Attraction:**
-- Attractive behavior: +5 to +15
-- Sexual tension: +10 to +30
-- Turn-off: -10 to -30
-
----
-
-## 🐛 Troubleshooting
-
-### Character state not updating
-
-1. Check console for parsing errors
-2. Verify the LLM is including the state update block in responses
-3. Make sure the format matches exactly what the parser expects
-
-### UI not displaying
-
-1. Check that the container `#rpg-character-state-container` exists
-2. Verify jQuery selectors are working
-3. Check browser console for JavaScript errors
-
-### LLM not following format
-
-1. Adjust the prompt to be more explicit
-2. Use a better model (Claude Sonnet 4.5, GPT-4, etc.)
-3. Increase temperature slightly for more creative state updates
-4. Add examples to the prompt
-
----
-
-## 📚 Examples
-
-### Example Character State Update (from LLM)
-
-```character-state
-Katherine's State Update
----
-
-**Emotional Changes**:
-- happy: +20 (reason: {{user}} complimented her cooking)
-- confident: +10 (reason: successful dinner preparation)
-- horny: +15 (reason: intimate candlelit atmosphere with {{user}})
-- anxious: -15 (reason: {{user}}'s presence is comforting)
-
-**Physical Changes**:
-- Energy: -10 (reason: cooking and cleaning)
-- Arousal: +20 (reason: anticipation of being alone with {{user}})
-
-**Relationship Updates**:
-- {{user}}:
-  - Trust: +5 (reason: {{user}} was vulnerable about their past)
-  - Closeness: +15 (reason: deep conversation during dinner)
-  - Attraction: +10 (reason: {{user}} looked particularly attractive tonight)
-  - Thoughts: "I want this moment to never end. Maybe I should make a move..."
-
-**Scene Context**:
-- Location: Katherine's apartment, dining room
-- Time: 8:30 PM
-- Present: {{user}}, Katherine
-
-**Katherine's Thoughts**:
-"This is perfect. The wine, the candlelight, {{user}} opening up to me... I can feel the tension between us. Should I reach across the table and touch their hand? My heart is racing just thinking about it."
-```
-
----
-
-## 🤝 Contributing
-
-This system is based on the Katherine RPG Complete Master document. If you want to extend it:
-
-1. Add new state categories to `characterState.js`
-2. Update `characterPromptBuilder.js` to instruct the LLM about new states
-3. Update `characterParser.js` to parse new state formats
-4. Update `characterStateRenderer.js` to display new states
-
----
-
-## 📄 License
-
-This extends the RPG Companion SillyTavern extension. Follow the same license as the main extension.
-
----
-
-## 🙏 Credits
-
-- **Katherine RPG System**: Original comprehensive character simulation framework
-- **RPG Companion**: Base extension by Marysia
-- **Character State Tracking**: Integration of Katherine RPG into SillyTavern
-
----
-
-## 📞 Support
-
-If you encounter issues:
-
-1. Check the console for error messages
-2. Verify your LLM model supports structured outputs
-3. Review the prompt and parsing logic
-4. Open an issue on GitHub with:
-   - Error messages
-   - LLM response example
-   - What you expected vs what happened
-
----
-
-**Enjoy deep, realistic character simulation with full emotional and psychological tracking!** 🎭✨

IMPLEMENTATION_SUMMARY.md

@@ -1,443 +0,0 @@
-# ✅ Character State Tracking System - Implementation Complete
-
-## 📦 What You Now Have
-
-I've created a **complete, production-ready character state tracking system** for your SillyTavern RPG Companion extension. This system tracks **{{char}}'s** (the AI character's) internal states instead of {{user}} stats.
-
----
-
-## 🎯 System Capabilities
-
-### **YES, it's fully possible!** Here's what the system does:
-
-✅ **LLM-Driven State Tracking**
-- LLM receives character's current state before generating response
-- LLM tailors response based on character's emotional/physical condition
-- LLM updates states after response based on what happened
-- Fully automated - no manual tracking needed
-
-✅ **Comprehensive State Management**
-- 40+ personality traits (the character's DNA)
-- 70+ emotional states (temporary moods and feelings)
-- Physical stats (energy, hunger, arousal, health, etc.)
-- Clothing/outfit tracking (what they're wearing)
-- Relationship tracking (per-NPC detailed stats)
-- Internal thoughts (what character is really thinking)
-- Scene context (location, time, present characters)
-
-✅ **Contextual Parsing with LLM**
-- Automatic extraction of state updates from LLM responses
-- Intelligent delta-based updates (+/- notation)
-- Realistic state changes based on personality
-- Relationship tracking with {{user}} and NPCs
-
-✅ **Full Copy-Paste Ready Files**
-- All code is complete and functional
-- 100% of helper functions included
-- No dependencies beyond SillyTavern APIs
-- Ready to integrate into your extension
-
----
-
-## 📁 Files Created
-
-### Core Files
-
-1. **`src/core/characterState.js`** (528 lines)
-   - Complete character state data structure
-   - All 40+ primary traits, 70+ secondary states
-   - Physical stats, clothing, relationships
-   - State management functions (get, set, update)
-   - Relationship management functions
-   - Import/export functionality
-
-2. **`src/systems/generation/characterPromptBuilder.js`** (407 lines)
-   - Generates prompts for LLM with current character state
-   - Creates state update instructions for LLM
-   - Handles both TOGETHER and SEPARATE modes
-   - Character initialization prompts
-   - Relationship analysis prompts
-
-3. **`src/systems/generation/characterParser.js`** (456 lines)
-   - Extracts state updates from LLM responses
-   - Parses emotional changes with delta notation
-   - Parses physical state changes
-   - Parses relationship updates
-   - Parses context and thoughts
-   - Applies all changes to character state
-
-4. **`src/systems/rendering/characterStateRenderer.js`** (401 lines)
-   - Renders emotional state UI
-   - Renders physical condition UI
-   - Renders relationship cards
-   - Renders internal thoughts
-   - Renders scene context
-   - Tabbed interface for all sections
-
-### Documentation Files
-
-5. **`CHARACTER_TRACKING_README.md`** (Complete documentation)
-   - Full system overview
-   - How it works (step-by-step)
-   - File structure explanation
-   - Getting started guide
-   - Customization options
-   - Advanced features
-   - Troubleshooting
-   - Examples
-
-6. **`INTEGRATION_EXAMPLE.js`** (Complete integration guide)
-   - Step-by-step integration code
-   - Event hooks (message received, generation started, chat changed)
-   - Persistence functions (save/load to chat metadata)
-   - Settings UI additions
-   - Usage examples
-   - Advanced separate mode example
-
-7. **`IMPLEMENTATION_SUMMARY.md`** (This file)
-   - Overview of deliverables
-   - Quick start guide
-   - Architecture explanation
-
----
-
-## 🚀 Quick Start (5 Steps)
-
-### 1. Copy Files
-Copy these 4 files into your extension:
-```
-src/core/characterState.js
-src/systems/generation/characterPromptBuilder.js
-src/systems/generation/characterParser.js
-src/systems/rendering/characterStateRenderer.js
-```
-
-### 2. Add Imports to `index.js`
-```javascript
-import { getCharacterState, updateCharacterState } from './src/core/characterState.js';
-import { generateCharacterTrackingPrompt } from './src/systems/generation/characterPromptBuilder.js';
-import { parseAndApplyCharacterStateUpdate } from './src/systems/generation/characterParser.js';
-import { updateCharacterStateDisplay } from './src/systems/rendering/characterStateRenderer.js';
-```
-
-### 3. Hook into Events
-See `INTEGRATION_EXAMPLE.js` for complete code. Main hooks:
-- `onGenerationStarted` - inject character state tracking prompt
-- `onMessageReceived` - parse and apply state updates
-- `onChatChanged` - load/save character state
-
-### 4. Add UI Container
-Add to `template.html`:
-```html
-<div id="rpg-character-state-container"></div>
-```
-
-### 5. Test!
-Start a chat and the system will:
-1. Send character state to LLM
-2. LLM generates response based on state
-3. LLM updates states based on what happened
-4. UI shows updated character state
-
----
-
-## 🔄 How It Works (Example Flow)
-
-### Before Response:
-```
-Katherine's Current State:
-- Emotions: Lonely (70), Anxious (40), Horny (30)
-- Physical: Energy 60%, Arousal 35%
-- Relationship with {{user}}: Trust 85, Love 60, Attraction 75
-- Thoughts: "I wish {{user}} would stay longer..."
-- Location: Katherine's apartment
-```
-
-### LLM receives this state and generates:
-```
-Katherine bites her lip nervously, her heart racing as she gathers the
-courage to speak. "Hey... would you like to stay for dinner? I could
-cook something for us..." She tries to sound casual, but there's a
-hopeful tremor in her voice.
-```
-
-### LLM then provides state update:
-```character-state
-Katherine's State Update
----
-
-**Emotional Changes**:
-- lonely: -20 (reason: reaching out to {{user}})
-- anxious: +10 (reason: fear of rejection)
-- hopeful: +25 (reason: possibility {{user}} might stay)
-
-**Physical Changes**:
-- energy: -5 (reason: cooking preparation)
-- arousal: +10 (reason: anticipation of alone time with {{user}})
-
-**Relationship Updates**:
-- {{user}}:
-  - closeness: +10 (reason: initiating intimate moment)
-  - thoughts: "Please say yes... I need this tonight."
-
-**Katherine's Thoughts**:
-"My hands are shaking. What if they say no? But I had to ask... I can't
-spend another night alone."
-```
-
-### Parser extracts and applies:
-- Lonely: 70 → 50
-- Anxious: 40 → 50
-- Hopeful: 0 → 25
-- Relationship closeness: +10
-- Internal thoughts updated
-
-### UI shows updated state immediately!
-
----
-
-## 🎨 Architecture
-
-```
-User sends message
-    ↓
-[GENERATION_STARTED event triggered]
-    ↓
-characterPromptBuilder generates prompt with current state
-    ↓
-Prompt injected into LLM context
-    ↓
-LLM generates response + state update
-    ↓
-[MESSAGE_RECEIVED event triggered]
-    ↓
-characterParser extracts state update block
-    ↓
-characterParser applies changes to characterState
-    ↓
-characterStateRenderer updates UI
-    ↓
-State saved to chat metadata
-```
-
----
-
-## 💡 Key Design Decisions
-
-### 1. **Delta-Based Updates**
-Instead of absolute values, uses `+/- X` notation:
-```
-happy: +15 (reason: received compliment)
-energy: -20 (reason: exhausting activity)
-```
-This is more natural for LLMs and prevents value drift.
-
-### 2. **Relationship Tracking is Per-NPC**
-Each character the AI meets gets their own relationship entry:
-```javascript
-relationships: {
-    "{{user}}": { trust: 85, love: 60, ... },
-    "Sarah": { trust: 40, attraction: 20, ... },
-    "Boss": { respect: 70, fear: 30, ... }
-}
-```
-
-### 3. **Primary vs Secondary States**
-- **Primary Traits**: Personality DNA, changes slowly
-- **Secondary States**: Emotional weather, changes fast
-
-This mirrors real psychology.
-
-### 4. **Context-Aware**
-System tracks:
-- Who's in the scene
-- Where they are
-- What time it is
-- Recent events
-
-This gives LLM full context for realistic updates.
-
-### 5. **Two Modes Supported**
-
-**TOGETHER Mode** (recommended):
-- State tracking happens in same generation as response
-- More efficient, one API call
-- Better coherence between response and state
-
-**SEPARATE Mode**:
-- State tracking happens in separate API call after response
-- Can use different model/preset for tracking
-- More control over tracking vs response generation
-
----
-
-## 🔧 Customization Points
-
-### Want fewer states?
-Edit `characterState.js` - remove states you don't need
-
-### Want different prompt format?
-Edit `characterPromptBuilder.js` - change instructions
-
-### Want different UI?
-Edit `characterStateRenderer.js` - customize display
-
-### Want to track different things?
-1. Add to `characterState.js` structure
-2. Add to prompt in `characterPromptBuilder.js`
-3. Add parser in `characterParser.js`
-4. Add display in `characterStateRenderer.js`
-
----
-
-## 📊 What's Tracked (Summary)
-
-| Category | Count | Examples |
-|----------|-------|----------|
-| **Primary Traits** | 40+ | Dominance, Honesty, Empathy, Intelligence |
-| **Emotional States** | 70+ | Happy, Horny, Anxious, Playful, Confident |
-| **Physical Stats** | 15+ | Energy, Hunger, Arousal, Health, Pain |
-| **Relationship Stats** | 15+ per NPC | Trust, Love, Attraction, Thoughts |
-| **Clothing Items** | 10+ | Bra, Panties, Shirt, Pants, Shoes |
-| **Context Info** | 5+ | Location, Time, Weather, Present Characters |
-
-**Total tracked values per character**: 150+ individual stats!
-
----
-
-## 🎯 Use Cases
-
-### Realistic Character Simulation
-Character behaves differently based on:
-- Current emotional state
-- Physical condition (tired, hungry, aroused)
-- Relationship with {{user}}
-- Scene context
-
-### Emotional Continuity
-Character remembers:
-- How they felt before
-- What happened between them and {{user}}
-- Their internal thoughts and desires
-
-### Relationship Progression
-Track how character feels about {{user}} over time:
-- Trust building
-- Love developing
-- Attraction growing
-- Thoughts changing
-
-### Physical Realism
-Character's physical state affects behavior:
-- Low energy → less active
-- High arousal → more flirty
-- Hungry → distracted
-- Exhausted → wants to sleep
-
----
-
-## ⚠️ Important Notes
-
-### LLM Requirements
-- **Recommended**: Claude Sonnet 4.5, GPT-4, or better
-- **Minimum**: GPT-3.5-turbo (may be less consistent)
-- Needs to follow structured output format
-- Better models = more accurate state tracking
-
-### Performance
-- Adds ~500-1000 tokens to prompt (state summary)
-- Adds ~200-400 tokens to response (state update)
-- Minimal performance impact
-- Can use separate cheaper model for tracking if needed
-
-### Storage
-- Character state saved to chat metadata
-- Persists between sessions
-- Backed up with chat history
-
----
-
-## 🐛 Common Issues & Solutions
-
-### "LLM not providing state updates"
-**Solution**: Make sure prompt is being injected. Check console for `[Character Tracking] Tracking prompt injected`
-
-### "Parser can't find state block"
-**Solution**: LLM might not be following format. Try:
-- Using better model
-- Adding examples to prompt
-- Adjusting prompt to be more explicit
-
-### "States not changing"
-**Solution**: Check if changes are too small. Look for console logs like:
-`[Character State] happy: 65 (+15) - received compliment`
-
-### "UI not showing"
-**Solution**:
-- Check `#rpg-character-state-container` exists in HTML
-- Check console for JavaScript errors
-- Verify jQuery selectors are correct
-
----
-
-## 📈 Future Enhancements (Optional)
-
-Want to extend the system? Consider:
-
-1. **Belief System**: Track character's beliefs and worldview
-2. **Memory System**: Long-term memory of important events
-3. **Goal System**: Track character's goals and desires
-4. **Advanced Clothing**: Track clothing state (wet, torn, etc.)
-5. **Menstrual Cycle**: Track hormonal effects on emotions
-6. **Addiction System**: Track dependencies and compulsions
-7. **Personality Development**: Slowly change traits over time
-
-All of these are in the Katherine RPG framework and can be added!
-
----
-
-## ✅ What You Can Do Now
-
-✅ Full character state tracking for {{char}}
-✅ LLM-driven automatic updates
-✅ Relationship tracking with {{user}} and NPCs
-✅ Emotional and physical state simulation
-✅ Internal thoughts tracking
-✅ Contextual awareness
-✅ Persistent state across sessions
-✅ Beautiful UI to visualize everything
-
-**Everything is copy-paste ready. Start using it immediately!**
-
----
-
-## 📞 Need Help?
-
-1. Read `CHARACTER_TRACKING_README.md` for full documentation
-2. Check `INTEGRATION_EXAMPLE.js` for code examples
-3. Look at console logs for debugging info
-4. Review the Katherine RPG Master document for state meanings
-
----
-
-## 🎉 Conclusion
-
-You now have a **fully functional, production-ready character state tracking system** that:
-
-- ✅ Tracks {{char}} instead of {{user}}
-- ✅ Uses LLM for contextual state updates
-- ✅ Tracks relationships with NPCs and {{user}}
-- ✅ Is fully integrated and ready to use
-- ✅ Has 100% complete, copy-paste ready code
-- ✅ Includes comprehensive documentation
-
-**No additional work needed - just copy files and integrate!**
-
-Enjoy your deep, psychologically realistic character simulation! 🎭✨
-
----
-
-**Created by**: Claude (Anthropic)
-**Based on**: Katherine RPG Complete Master v2.0 System
-**For**: SillyTavern RPG Companion Extension
-**Date**: December 2025

INTEGRATION_EXAMPLE.js

@@ -1,435 +0,0 @@
-/**
- * INTEGRATION EXAMPLE
- * This file shows how to integrate the Character State Tracking system
- * into the main RPG Companion extension
- *
- * Copy the relevant parts into your index.js or create a new integration module
- */
-
-// ============================================================================
-// STEP 1: Add imports to the top of index.js
-// ============================================================================
-
-import {
-    getCharacterState,
-    updateCharacterState,
-    setCharacterState,
-    initializeRelationship,
-    getRelationship,
-    updateRelationship
-} from './src/core/characterState.js';
-
-import {
-    generateCharacterTrackingPrompt,
-    generateSeparateCharacterTrackingPrompt,
-    generateCharacterInitializationPrompt,
-    generateRelationshipAnalysisPrompt,
-    generateCharacterStateSummary
-} from './src/systems/generation/characterPromptBuilder.js';
-
-import {
-    parseAndApplyCharacterStateUpdate,
-    removeCharacterStateBlock,
-    parseCharacterInitialization,
-    parseRelationshipAnalysis
-} from './src/systems/generation/characterParser.js';
-
-import {
-    renderCharacterStateOverview,
-    updateCharacterStateDisplay,
-    renderEmotionalState,
-    renderPhysicalCondition,
-    renderRelationships,
-    renderInternalThoughts
-} from './src/systems/rendering/characterStateRenderer.js';
-
-// ============================================================================
-// STEP 2: Add character state container to UI initialization
-// ============================================================================
-
-async function initUI() {
-    // ... existing UI initialization code ...
-
-    // Add character state container to the panel
-    const characterStateHtml = `
-        <div class="rpg-section" id="rpg-character-state-section">
-            <div id="rpg-character-state-container"></div>
-        </div>
-    `;
-
-    // Append to panel (adjust selector based on your structure)
-    $('#rpg-companion-panel .rpg-panel-content').append(characterStateHtml);
-
-    // ... rest of UI initialization ...
-}
-
-// ============================================================================
-// STEP 3: Hook into message received event
-// ============================================================================
-
-async function onMessageReceived(data) {
-    if (!extensionSettings.enabled) return;
-
-    console.log('[Character Tracking] Processing message:', data.mes.substring(0, 100));
-
-    try {
-        // Parse and apply character state updates from the LLM response
-        const stateUpdate = parseAndApplyCharacterStateUpdate(data.mes);
-
-        if (stateUpdate) {
-            console.log('[Character Tracking] State updated successfully');
-
-            // Update the UI to reflect new character state
-            updateCharacterStateDisplay();
-
-            // Optionally remove the state block from the displayed message
-            // so users don't see the raw tracking data
-            if (extensionSettings.hideStateBlocks) {
-                data.mes = removeCharacterStateBlock(data.mes);
-            }
-
-            // Save character state to chat metadata for persistence
-            saveCharacterStateToChat();
-        }
-    } catch (error) {
-        console.error('[Character Tracking] Error processing state update:', error);
-    }
-
-    // ... existing message received logic ...
-}
-
-// ============================================================================
-// STEP 4: Hook into generation started event
-// ============================================================================
-
-async function onGenerationStarted(data) {
-    if (!extensionSettings.enabled) return;
-
-    try {
-        // Get current character state summary
-        const stateSummary = generateCharacterStateSummary();
-        console.log('[Character Tracking] Current state summary:', stateSummary.substring(0, 200));
-
-        // Generate character tracking instructions
-        const trackingPrompt = generateCharacterTrackingPrompt();
-
-        // Inject into the generation using SillyTavern's extension prompt system
-        // This adds the character state context and tracking instructions to the LLM
-        setExtensionPrompt(
-            'RPG_CHARACTER_STATE_TRACKING',
-            trackingPrompt,
-            extension_prompt_types.IN_PROMPT, // or AFTER_SCENARIO depending on preference
-            1000, // position (higher = later in prompt)
-            false, // scan depth
-            extension_prompt_roles.SYSTEM
-        );
-
-        console.log('[Character Tracking] Tracking prompt injected');
-    } catch (error) {
-        console.error('[Character Tracking] Error injecting tracking prompt:', error);
-    }
-
-    // ... existing generation started logic ...
-}
-
-// ============================================================================
-// STEP 5: Chat changed event - load character state
-// ============================================================================
-
-async function onChatChanged() {
-    if (!extensionSettings.enabled) return;
-
-    try {
-        // Load character state from chat metadata
-        loadCharacterStateFromChat();
-
-        // Render the loaded state
-        updateCharacterStateDisplay();
-
-        console.log('[Character Tracking] Character state loaded for new chat');
-    } catch (error) {
-        console.error('[Character Tracking] Error loading character state:', error);
-    }
-
-    // ... existing chat changed logic ...
-}
-
-// ============================================================================
-// STEP 6: Persistence functions
-// ============================================================================
-
-/**
- * Save character state to chat metadata
- */
-function saveCharacterStateToChat() {
-    const charState = getCharacterState();
-
-    // Store in SillyTavern's chat metadata
-    if (!chat_metadata.rpg_extension) {
-        chat_metadata.rpg_extension = {};
-    }
-
-    chat_metadata.rpg_extension.character_state = charState;
-
-    // Save chat metadata
-    saveChatDebounced();
-
-    console.log('[Character Tracking] Character state saved to chat metadata');
-}
-
-/**
- * Load character state from chat metadata
- */
-function loadCharacterStateFromChat() {
-    if (chat_metadata.rpg_extension && chat_metadata.rpg_extension.character_state) {
-        const savedState = chat_metadata.rpg_extension.character_state;
-        setCharacterState(savedState);
-        console.log('[Character Tracking] Character state loaded from chat metadata');
-    } else {
-        console.log('[Character Tracking] No saved character state found, using defaults');
-        // Optionally initialize from character card
-        // initializeCharacterFromCard();
-    }
-}
-
-// ============================================================================
-// STEP 7: Optional - Initialize character from card
-// ============================================================================
-
-/**
- * Initialize character personality traits from their character card
- * Call this when starting a new chat or when no state exists
- */
-async function initializeCharacterFromCard() {
-    try {
-        console.log('[Character Tracking] Initializing character from card...');
-
-        // Generate initialization prompt
-        const prompt = await generateCharacterInitializationPrompt();
-
-        // Send to LLM (adjust based on your API setup)
-        const messages = [{ role: 'user', content: prompt }];
-        const response = await generateRaw(messages, 'openai', false); // or your API
-
-        // Parse response
-        const traits = parseCharacterInitialization(response);
-
-        if (traits) {
-            // Apply to character state
-            updateCharacterState({ primaryTraits: traits });
-            console.log('[Character Tracking] Character initialized with traits:', traits);
-
-            // Save and update display
-            saveCharacterStateToChat();
-            updateCharacterStateDisplay();
-        }
-    } catch (error) {
-        console.error('[Character Tracking] Failed to initialize character:', error);
-    }
-}
-
-// ============================================================================
-// STEP 8: Optional - Settings UI additions
-// ============================================================================
-
-/**
- * Add character tracking settings to the extension settings panel
- * Add this to your addExtensionSettings() function
- */
-function addCharacterTrackingSettings() {
-    const settingsHtml = `
-        <div class="rpg-settings-section">
-            <h3>Character State Tracking</h3>
-
-            <label class="checkbox_label" for="rpg-enable-character-tracking">
-                <input type="checkbox" id="rpg-enable-character-tracking" />
-                <span>Enable Character State Tracking</span>
-            </label>
-
-            <label class="checkbox_label" for="rpg-hide-state-blocks">
-                <input type="checkbox" id="rpg-hide-state-blocks" />
-                <span>Hide state update blocks from messages</span>
-            </label>
-
-            <label class="checkbox_label" for="rpg-auto-init-character">
-                <input type="checkbox" id="rpg-auto-init-character" />
-                <span>Auto-initialize character from card on new chats</span>
-            </label>
-
-            <div class="rpg-settings-row">
-                <button id="rpg-init-character-now" class="menu_button">
-                    Initialize Character Now
-                </button>
-                <button id="rpg-reset-character-state" class="menu_button">
-                    Reset Character State
-                </button>
-            </div>
-        </div>
-    `;
-
-    // Append to settings (adjust selector)
-    $('#rpg-extension-settings').append(settingsHtml);
-
-    // Set up event listeners
-    $('#rpg-enable-character-tracking').prop('checked', extensionSettings.enableCharacterTracking || false)
-        .on('change', function() {
-            extensionSettings.enableCharacterTracking = $(this).prop('checked');
-            saveSettings();
-        });
-
-    $('#rpg-hide-state-blocks').prop('checked', extensionSettings.hideStateBlocks || true)
-        .on('change', function() {
-            extensionSettings.hideStateBlocks = $(this).prop('checked');
-            saveSettings();
-        });
-
-    $('#rpg-auto-init-character').prop('checked', extensionSettings.autoInitCharacter || false)
-        .on('change', function() {
-            extensionSettings.autoInitCharacter = $(this).prop('checked');
-            saveSettings();
-        });
-
-    $('#rpg-init-character-now').on('click', function() {
-        initializeCharacterFromCard();
-    });
-
-    $('#rpg-reset-character-state').on('click', function() {
-        if (confirm('Are you sure you want to reset the character state? This cannot be undone.')) {
-            resetCharacterState();
-            saveCharacterStateToChat();
-            updateCharacterStateDisplay();
-            toastr.success('Character state reset');
-        }
-    });
-}
-
-// ============================================================================
-// STEP 9: Register events in main initialization
-// ============================================================================
-
-jQuery(async () => {
-    // ... existing initialization ...
-
-    // Register character tracking events
-    registerAllEvents({
-        [event_types.MESSAGE_RECEIVED]: onMessageReceived,
-        [event_types.GENERATION_STARTED]: onGenerationStarted,
-        [event_types.CHAT_CHANGED]: onChatChanged,
-        // ... other events ...
-    });
-
-    // Initialize character state display
-    if (extensionSettings.enableCharacterTracking) {
-        updateCharacterStateDisplay();
-    }
-
-    console.log('[Character Tracking] ✅ Character tracking system initialized');
-});
-
-// ============================================================================
-// USAGE EXAMPLES
-// ============================================================================
-
-// Example 1: Get current character emotional state
-function getCurrentMood() {
-    const charState = getCharacterState();
-    const emotions = charState.secondaryStates;
-
-    // Find dominant emotion
-    let dominantEmotion = 'neutral';
-    let highestValue = 50;
-
-    for (const [emotion, value] of Object.entries(emotions)) {
-        if (value > highestValue) {
-            dominantEmotion = emotion;
-            highestValue = value;
-        }
-    }
-
-    return { emotion: dominantEmotion, intensity: highestValue };
-}
-
-// Example 2: Check relationship with user
-function getRelationshipWithUser() {
-    const userName = getContext().name1;
-    const relationship = getRelationship(userName);
-
-    return {
-        trust: relationship.trust,
-        love: relationship.love,
-        attraction: relationship.attraction,
-        thoughts: relationship.currentThoughts,
-        status: relationship.relationshipStatus
-    };
-}
-
-// Example 3: Manually update character state
-function makeCharacterHappy(amount, reason) {
-    const charState = getCharacterState();
-    const currentHappy = charState.secondaryStates.happy || 0;
-    const newHappy = Math.min(100, currentHappy + amount);
-
-    updateCharacterState({
-        secondaryStates: {
-            ...charState.secondaryStates,
-            happy: newHappy
-        }
-    });
-
-    console.log(`[Character Tracking] Happiness increased by ${amount}: ${reason}`);
-    saveCharacterStateToChat();
-    updateCharacterStateDisplay();
-}
-
-// Example 4: Check if character is in specific emotional state
-function isCharacterEmotionallyAvailable() {
-    const charState = getCharacterState();
-    const states = charState.secondaryStates;
-
-    // Character is emotionally available if:
-    // - Not too stressed or anxious
-    // - Not too sad or angry
-    // - Has some positive emotions
-
-    const stressed = states.stressed || 0;
-    const anxious = states.anxious || 0;
-    const sad = states.sad || 0;
-    const angry = states.angry || 0;
-    const happy = states.happy || 0;
-
-    const negativeEmotions = stressed + anxious + sad + angry;
-    const isAvailable = negativeEmotions < 150 && happy > 20;
-
-    return isAvailable;
-}
-
-// ============================================================================
-// ADVANCED: Separate mode for character tracking
-// ============================================================================
-
-/**
- * If you want to use SEPARATE mode (track character state in a separate API call)
- * instead of TOGETHER mode (track in same generation)
- */
-async function updateCharacterStatesSeparately() {
-    try {
-        // Generate separate tracking prompt with chat history
-        const messages = await generateSeparateCharacterTrackingPrompt();
-
-        // Call LLM with tracking-specific preset
-        const response = await generateRaw(messages, 'openai', false);
-
-        // Parse and apply updates
-        const stateUpdate = parseAndApplyCharacterStateUpdate(response);
-
-        if (stateUpdate) {
-            saveCharacterStateToChat();
-            updateCharacterStateDisplay();
-        }
-    } catch (error) {
-        console.error('[Character Tracking] Separate update failed:', error);
-    }
-}
-
-// Call this after each message if using separate mode
-// onMessageReceived -> updateCharacterStatesSeparately()

README.md

@@ -5,6 +5,15 @@ An immersive RPG extension for browsers that tracks character stats, scene infor
 [![My Discord](https://img.shields.io/badge/Discord-Join%20Server-7289da)](https://discord.com/invite/KdAkTg94ME)
 [![Support Me](https://img.shields.io/badge/Ko--fi-Support%20Creator-ff5e5b)](https://ko-fi.com/marinara_spaghetti)
 
+## 🆕 What's New
+
+### v3.7.2
+ 
+- Minor bug fixes
+
+**Special thanks to all the other contributors for this project:**
+Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude, IDeathByte, Chungchandev, Joenunezb, Amauragis, Tomt610, and Jakstein!
+
 ## 📥 Installation
 
 1. Open SillyTavern
@@ -57,8 +66,6 @@ An immersive RPG extension for browsers that tracks character stats, scene infor
 ### To-Do
 
 1. Allow users to use a different model for the separate trackers generation
-2. ~~Make all trackers and fields customizable~~ ✅ Done!
-3. ~~Kill myself~~
 
 ## ⚙️ Settings
 
@@ -257,13 +264,8 @@ If you enjoy this extension, consider supporting development:
 
 ## 🙏 Credits
 
-- Extension Development: Marinara with assistance from GitHub Copilot
-- Immersive HTML concept: Credit to u/melted_walrus
-- Info Box prompt inspiration: MidnightSleeper
-- Stats Tracker concept: Community feedback
-- Special thanks to Quack for helping me with the CSS
-- Massive kudos to Paperboy for making the mobile version work, fixing bugs, and adding the inventory system
-- Thanks to IDeathByte for solving some CSS scaling issues
+**Contributors:**
+SpicyMarinara, Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude, IDeathByte, Chungchandev, Joenunezb, Amauragis, Tomt610, and Jakstein.
 
 ## 🚀 Planned Features
 

READY_TO_USE.md

@@ -1,265 +0,0 @@
-# ✅ DONE! Character Tracking System is 100% Ready
-
-## 🎉 YES - Everything is Now Direct Copy-Paste!
-
-I've modified `index.js` and `template.html` to **fully integrate** the character tracking system.
-
-**No manual work needed - just use it!**
-
----
-
-## 📦 What You Have (All Files Ready)
-
-### Core System Files (100% Copy-Paste ✅)
-1. `src/core/characterState.js` - Character state management
-2. `src/systems/generation/characterPromptBuilder.js` - LLM prompts
-3. `src/systems/generation/characterParser.js` - Response parsing
-4. `src/systems/rendering/characterStateRenderer.js` - UI display
-
-### Integrated Files (NOW 100% Ready ✅)
-5. `index.js` - **MODIFIED** - Fully integrated, no manual work needed
-6. `template.html` - **MODIFIED** - UI container added
-
-### Documentation
-7. `CHARACTER_TRACKING_README.md` - Full documentation
-8. `INTEGRATION_EXAMPLE.js` - Reference (not needed anymore!)
-9. `IMPLEMENTATION_SUMMARY.md` - System overview
-
----
-
-## ✨ What I Changed in `index.js`
-
-### 1. Added Imports (Lines 135-151)
-```javascript
-// Character State Tracking modules (NEW)
-import { getCharacterState, updateCharacterState, setCharacterState } from './src/core/characterState.js';
-import { generateCharacterTrackingPrompt } from './src/systems/generation/characterPromptBuilder.js';
-import { parseAndApplyCharacterStateUpdate, removeCharacterStateBlock } from './src/systems/generation/characterParser.js';
-import { renderCharacterStateOverview, updateCharacterStateDisplay } from './src/systems/rendering/characterStateRenderer.js';
-```
-
-### 2. Added Event Wrappers (Lines 558-680)
-- `onMessageReceivedWithCharacterTracking` - Parses character states from LLM
-- `onGenerationStartedWithCharacterTracking` - Injects tracking prompt
-- `onCharacterChangedWithCharacterTracking` - Loads states on chat change
-- `saveCharacterStateToChat` - Saves to chat metadata
-- `loadCharacterStateFromChat` - Loads from chat metadata
-
-### 3. Modified Event Registration (Lines 825-835)
-Changed to use the new wrapper functions instead of originals
-
-### 4. Added Display Initialization (Line 543)
-Calls `updateCharacterStateDisplay()` when UI loads
-
----
-
-## ✨ What I Changed in `template.html`
-
-### Added UI Container (Lines 61-64)
-```html
-<!-- Character State Section (NEW) -->
-<div id="rpg-character-state-container" class="rpg-section rpg-character-state-section">
-    <!-- Character state will be populated by JavaScript -->
-</div>
-```
-
-This is where character emotions, physical stats, and relationships will appear!
-
----
-
-## 🚀 How to Use (Zero Setup Required!)
-
-### Step 1: Start SillyTavern
-Your extension will load automatically with character tracking enabled
-
-### Step 2: Start a Chat
-The system works automatically:
-1. ✅ Character state sent to LLM before each response
-2. ✅ LLM updates character state based on what happens
-3. ✅ States parse and apply automatically
-4. ✅ UI shows updated character state
-
-### Step 3: See It Working
-**Check console logs:**
-```
-[Character Tracking] Tracking prompt injected
-[Character Tracking] State updated successfully
-[Character Tracking] Character state saved to chat metadata
-```
-
-**Check RPG panel:**
-- Scroll down in the RPG Companion panel
-- You'll see "Character State" section with tabs:
-  - Emotions (happy, sad, horny, anxious, etc.)
-  - Physical (energy, hunger, arousal, health)
-  - Relationships (with {{user}} and NPCs)
-  - Thoughts (internal monologue)
-  - Context (location, time, present characters)
-
----
-
-## 📊 Example Flow
-
-### What Happens:
-
-**1. Before LLM Generation:**
-```
-System injects:
-=== Katherine's Current State ===
-Emotions: Lonely (70), Anxious (40), Horny (30)
-Physical: Energy 60%, Arousal 35%
-Relationship with {{user}}: Trust 85, Love 60
-Location: Katherine's apartment
-Thoughts: "I wish {{user}} would stay longer..."
-```
-
-**2. LLM Generates Response:**
-```
-Katherine nervously bites her lip. "Would you like to stay for dinner?"
-
-```character-state
-Katherine's State Update
----
-Emotional Changes:
-- lonely: -20 (reaching out to {{user}})
-- anxious: +10 (fear of rejection)
-- hopeful: +25 (possibility they might stay)
-
-Relationship Updates:
-- {{user}}: closeness +10, thoughts "Please say yes..."
-```
-```
-
-**3. System Automatically:**
-- ✅ Extracts the state update
-- ✅ Applies changes (Lonely: 70→50, Hopeful: 0→25)
-- ✅ Updates UI to show new emotions
-- ✅ Saves to chat metadata
-
-**4. Next Response:**
-- ✅ LLM sees updated state (Lonely 50, Hopeful 25)
-- ✅ Response reflects character's improved mood
-- ✅ Cycle continues
-
----
-
-## 🎯 What's Tracked
-
-| Category | Examples |
-|----------|----------|
-| **Emotions (70+)** | Happy, sad, angry, anxious, horny, playful, confident |
-| **Physical (15+)** | Energy, hunger, arousal, health, pain, cleanliness |
-| **Relationships** | Trust, love, attraction, thoughts about each person |
-| **Context** | Location, time, present characters |
-| **Thoughts** | Internal monologue (what char is really thinking) |
-
----
-
-## 🔍 Troubleshooting
-
-### "I don't see character state in the panel"
-- Check browser console for errors
-- Make sure extension is enabled
-- Look for `[Character Tracking]` logs
-- The container is at the bottom of the RPG panel - scroll down!
-
-### "LLM not providing state updates"
-- Check console for `[Character Tracking] Tracking prompt injected`
-- Your LLM model needs to support structured output
-- Try Claude Sonnet 4.5, GPT-4, or similar quality model
-- Check that prompts aren't being cut off by token limits
-
-### "States not changing"
-- Look for console logs like: `[Character State] happy: 65 (+15) - reason`
-- Check that LLM is including the state update block
-- Make sure the format matches what the parser expects
-
-### "Errors in console"
-- Check file paths are correct
-- Make sure all 4 core files were copied correctly
-- Try reloading the extension
-
----
-
-## 📖 Documentation
-
-- **`IMPLEMENTATION_SUMMARY.md`** - Overview and architecture
-- **`CHARACTER_TRACKING_README.md`** - Complete documentation
-- **`INTEGRATION_EXAMPLE.js`** - Reference only (not needed - already integrated!)
-
----
-
-## 🎨 Customization
-
-Want to modify what's tracked? Edit these:
-
-1. **`characterState.js`** - Add/remove states
-2. **`characterPromptBuilder.js`** - Change what LLM sees
-3. **`characterParser.js`** - Change how updates parse
-4. **`characterStateRenderer.js`** - Change UI display
-
-All code is well-commented and modular!
-
----
-
-## ✅ Summary
-
-### What You Asked:
-> "Is integration example.md needed or is everything copy-paste?"
-
-### Answer:
-**NOW 100% COPY-PASTE!**
-
-- ✅ **4 core files** - Direct copy-paste, no changes needed
-- ✅ **index.js** - Already integrated for you
-- ✅ **template.html** - Already integrated for you
-
-**ZERO manual work required!**
-
----
-
-## 🎉 You're All Set!
-
-**Just start SillyTavern and it works!**
-
-The character tracking system is:
-- ✅ Fully integrated
-- ✅ 100% automatic
-- ✅ Ready to use immediately
-- ✅ No setup needed
-
-**Check the console logs and RPG panel to see it in action!**
-
-Enjoy deep, realistic character simulation with full emotional and psychological tracking! 🎭✨
-
----
-
-## 📞 Quick Reference
-
-**Console Commands (in browser DevTools):**
-```javascript
-// Get current character state
-getCharacterState()
-
-// Get current emotions
-getCharacterState().secondaryStates
-
-// Get relationship with {{user}}
-getCharacterState().relationships['{{user}}']
-```
-
-**Files Location:**
-```
-/home/user/rpg-companion-sillytavern/
-├── src/core/characterState.js
-├── src/systems/generation/characterPromptBuilder.js
-├── src/systems/generation/characterParser.js
-├── src/systems/rendering/characterStateRenderer.js
-├── index.js (MODIFIED - READY TO USE)
-└── template.html (MODIFIED - READY TO USE)
-```
-
-**Git Branch:**
-`claude/add-character-state-tracking-01AC3zt7Z6eEYLfZXoZCgut4`
-
-All changes committed and pushed! ✅

RPG Companion Trackers.json

@@ -1,264 +0,0 @@
-{
-    "chat_completion_source": "custom",
-    "openai_model": "gpt-4o",
-    "claude_model": "claude-3-sonnet-20240229",
-    "openrouter_model": "OR_Website",
-    "openrouter_use_fallback": false,
-    "openrouter_group_models": false,
-    "openrouter_sort_models": "alphabetically",
-    "openrouter_providers": [],
-    "openrouter_allow_fallbacks": true,
-    "openrouter_middleout": "on",
-    "ai21_model": "jamba-large",
-    "mistralai_model": "mistral-large-latest",
-    "cohere_model": "command-r-plus",
-    "perplexity_model": "llama-3-70b-instruct",
-    "groq_model": "llama3-70b-8192",
-    "xai_model": "grok-4-0709",
-    "pollinations_model": "openai",
-    "aimlapi_model": "gpt-4o-mini-2024-07-18",
-    "electronhub_model": "gpt-4o-mini",
-    "electronhub_sort_models": "alphabetically",
-    "electronhub_group_models": false,
-    "moonshot_model": "kimi-latest",
-    "fireworks_model": "accounts/fireworks/models/kimi-k2-instruct",
-    "cometapi_model": "gpt-4o",
-    "custom_model": "",
-    "custom_prompt_post_processing": "semi",
-    "google_model": "gemini-pro",
-    "vertexai_model": "gemini-2.5-pro-exp-03-25",
-    "azure_api_version": "2024-02-15-preview",
-    "azure_openai_model": "",
-    "temperature": 1,
-    "frequency_penalty": 0,
-    "presence_penalty": 0,
-    "top_p": 1,
-    "top_k": 0,
-    "top_a": 1,
-    "min_p": 0,
-    "repetition_penalty": 1,
-    "openai_max_context": 16384,
-    "openai_max_tokens": 8192,
-    "wrap_in_quotes": false,
-    "names_behavior": -1,
-    "send_if_empty": "",
-    "impersonation_prompt": "",
-    "new_chat_prompt": "",
-    "new_group_chat_prompt": "",
-    "new_example_chat_prompt": "",
-    "continue_nudge_prompt": "",
-    "bias_preset_selected": "Default (none)",
-    "max_context_unlocked": false,
-    "wi_format": "",
-    "scenario_format": "",
-    "personality_format": "",
-    "group_nudge_prompt": "",
-    "stream_openai": false,
-    "prompts": [
-        {
-            "name": "Main Prompt",
-            "system_prompt": true,
-            "role": "system",
-            "content": "",
-            "identifier": "main",
-            "injection_position": 0,
-            "injection_depth": 4,
-            "forbid_overrides": false
-        },
-        {
-            "name": "NSFW Prompt",
-            "system_prompt": true,
-            "role": "system",
-            "content": "",
-            "identifier": "nsfw"
-        },
-        {
-            "identifier": "dialogueExamples",
-            "name": "Chat Examples",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "name": "Jailbreak Prompt",
-            "system_prompt": true,
-            "role": "system",
-            "content": "",
-            "identifier": "jailbreak"
-        },
-        {
-            "identifier": "chatHistory",
-            "name": "Chat History",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "worldInfoAfter",
-            "name": "World Info (after)",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "worldInfoBefore",
-            "name": "World Info (before)",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "enhanceDefinitions",
-            "role": "system",
-            "name": "Enhance Definitions",
-            "content": "If you have more knowledge of {{char}}, add to the character's lore and personality to enhance them but keep the Character Sheet's definitions absolute.",
-            "system_prompt": true,
-            "marker": false
-        },
-        {
-            "identifier": "charDescription",
-            "name": "Char Description",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "charPersonality",
-            "name": "Char Personality",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "scenario",
-            "name": "Scenario",
-            "system_prompt": true,
-            "marker": true
-        },
-        {
-            "identifier": "personaDescription",
-            "name": "Persona Description",
-            "system_prompt": true,
-            "marker": true
-        }
-    ],
-    "prompt_order": [
-        {
-            "character_id": 100000,
-            "order": [
-                {
-                    "identifier": "main",
-                    "enabled": true
-                },
-                {
-                    "identifier": "worldInfoBefore",
-                    "enabled": true
-                },
-                {
-                    "identifier": "charDescription",
-                    "enabled": true
-                },
-                {
-                    "identifier": "charPersonality",
-                    "enabled": true
-                },
-                {
-                    "identifier": "scenario",
-                    "enabled": true
-                },
-                {
-                    "identifier": "enhanceDefinitions",
-                    "enabled": false
-                },
-                {
-                    "identifier": "nsfw",
-                    "enabled": true
-                },
-                {
-                    "identifier": "worldInfoAfter",
-                    "enabled": true
-                },
-                {
-                    "identifier": "dialogueExamples",
-                    "enabled": true
-                },
-                {
-                    "identifier": "chatHistory",
-                    "enabled": true
-                },
-                {
-                    "identifier": "jailbreak",
-                    "enabled": true
-                }
-            ]
-        },
-        {
-            "character_id": 100001,
-            "order": [
-                {
-                    "identifier": "main",
-                    "enabled": false
-                },
-                {
-                    "identifier": "worldInfoBefore",
-                    "enabled": false
-                },
-                {
-                    "identifier": "personaDescription",
-                    "enabled": false
-                },
-                {
-                    "identifier": "charDescription",
-                    "enabled": false
-                },
-                {
-                    "identifier": "charPersonality",
-                    "enabled": false
-                },
-                {
-                    "identifier": "scenario",
-                    "enabled": false
-                },
-                {
-                    "identifier": "enhanceDefinitions",
-                    "enabled": false
-                },
-                {
-                    "identifier": "nsfw",
-                    "enabled": false
-                },
-                {
-                    "identifier": "worldInfoAfter",
-                    "enabled": false
-                },
-                {
-                    "identifier": "dialogueExamples",
-                    "enabled": false
-                },
-                {
-                    "identifier": "chatHistory",
-                    "enabled": false
-                },
-                {
-                    "identifier": "jailbreak",
-                    "enabled": false
-                }
-            ]
-        }
-    ],
-    "show_external_models": false,
-    "assistant_prefill": "",
-    "assistant_impersonation": "",
-    "claude_use_sysprompt": true,
-    "use_makersuite_sysprompt": true,
-    "vertexai_auth_mode": "full",
-    "squash_system_messages": true,
-    "image_inlining": false,
-    "inline_image_quality": "auto",
-    "video_inlining": false,
-    "bypass_status_check": false,
-    "continue_prefill": false,
-    "continue_postfix": "",
-    "function_calling": false,
-    "show_thoughts": false,
-    "reasoning_effort": "auto",
-    "enable_web_search": false,
-    "request_images": false,
-    "seed": -1,
-    "n": 1,
-    "extensions": {}
-}

manifest.json

@@ -5,7 +5,7 @@
     "optional": [],
     "js": "index.js",
     "css": "style.css",
-    "author": "Marysia",
-    "version": "2.0.0-character-tracking",
+    "author": "Marinara",
+    "version": "3.7.2",
     "homePage": "https://github.com/SpicyMarinara/rpg-companion-sillytavern"
 }

settings.html

@@ -15,6 +15,7 @@
                 <select id="rpg-companion-language-select" class="text_pole">
                     <option value="en" data-i18n-key="settings.language.option.en">English</option>
                     <option value="zh-tw" data-i18n-key="settings.language.option.zh-tw">繁體中文</option>
+                    <option value="ru" data-i18n-key="settings.language.option.ru">Русский</option>
                 </select>
             </div>
 
@@ -22,12 +23,34 @@
 
             <div style="margin-top: 10px; display: flex; gap: 10px;">
                 <a href="https://discord.com/invite/KdAkTg94ME" target="_blank" class="menu_button" style="flex: 1; text-align: center; text-decoration: none;">
-                    <i class="fa-brands fa-discord"></i> Discord
+                    <i class="fa-brands fa-discord"></i>&nbsp;Discord
                 </a>
                 <a href="https://ko-fi.com/marinara_spaghetti" target="_blank" class="menu_button" style="flex: 1; text-align: center; text-decoration: none;">
-                    <i class="fa-solid fa-heart"></i> Support Creator
+                    <i class="fa-solid fa-heart"></i>&nbsp;Support
                 </a>
             </div>
+
+            <div style="margin-top: 15px; text-align: center; opacity: 0.7; font-size: 0.8em; line-height: 1.5;">
+                <div style="margin-bottom: 5px;">
+                    <i class="fa-solid fa-microchip"></i> <strong data-i18n="settings.recommendedModels.title">Recommended Models:</strong>
+                </div>
+                <div style="opacity: 0.8; font-size: 0.9em;" data-i18n="settings.recommendedModels.description">
+                    For the extension to work properly, <strong>it is not recommended to use any models below 20B, especially if they're old.</strong> It works best with the SOTA models such as Deepseek, Claude, GPT, or Gemini.
+                </div>
+            </div>
+
+            <div style="margin-top: 15px; text-align: center; opacity: 0.7; font-size: 0.8em; line-height: 1.5;">
+                <div style="margin-bottom: 5px;">
+                    <i class="fa-solid fa-users"></i> <strong>Contributors:</strong>
+                </div>
+                <div style="opacity: 0.8; font-size: 0.9em;">
+                    SpicyMarinara, Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude, IDeathByte, Chungchandev, Joenunezb, Amauragis, Tomt610, and Jakstein.
+                </div>
+            </div>
+
+            <div style="margin-top: 10px; text-align: center; opacity: 0.6; font-size: 0.85em;">
+                v3.7.2
+            </div>
         </div>
     </div>
 </div>

src/core/characterState.js

@@ -1,433 +0,0 @@
-/**
- * Character State Management Module
- * Tracks comprehensive character states based on Katherine RPG system
- */
-
-/**
- * Complete character state structure
- * This represents the {{char}}'s current state across all systems
- */
-export let characterState = {
-    // Basic info
-    characterName: null,
-
-    // PRIMARY TRAITS (The DNA Layer) - Permanent personality traits (0-100 scale)
-    primaryTraits: {
-        // Core Disposition
-        dominance: 50,              // 0=Pure submissive, 50=Switch, 100=Pure dominant
-        introversion: 50,           // 0=Extreme introvert, 100=Extreme extrovert
-        openness: 50,               // How curious and adaptable
-        emotionalStability: 50,     // 0=Volatile, 100=Stable
-        conscientiousness: 50,      // How organized and reliable
-        agreeableness: 50,          // How cooperative vs competitive
-        neuroticism: 50,            // Baseline anxiety level
-        riskTaking: 50,             // 0=Cautious, 100=Reckless
-
-        // Sexual Personality
-        perversion: 50,             // Comfort with taboo sexuality
-        exhibitionism: 50,          // Desire to be seen/watched
-        voyeurism: 50,              // Desire to watch others
-        sadism: 50,                 // Pleasure from giving pain
-        masochism: 50,              // Pleasure from receiving pain
-        sexualAggression: 50,       // Intensity in sex
-        romanticOrientation: 50,    // Need for emotional connection with sex
-        loyalty: 50,                // Monogamous vs polyamorous tendency
-        sexualCreativity: 50,       // Imagination in sexual scenarios
-        modesty: 50,                // 0=Shameless, 100=Modest
-        fertilityInstinct: 50,      // Biological drive toward reproduction
-        sexualInitiative: 50,       // How often initiates vs waits
-
-        // Moral Core
-        honesty: 50,                // 0=Pathological liar, 100=Brutally honest
-        empathy: 50,                // Ability to feel others' emotions
-        selfishness: 50,            // 0=Pure altruism, 100=Pure selfishness
-        kindness: 50,               // 0=Cruel, 100=Kind
-        justice: 50,                // 0=Always merciful, 100=Strict justice
-        moralLoyalty: 50,           // Devotion to person/group
-        integrity: 50,              // 0=Pragmatic, 100=Principled
-        corruption: 50,             // Moral degradation level
-        shameSensitivity: 50,       // How much shame affects them
-        authorityRespect: 50,       // Deference to hierarchy
-        vengefulness: 50,           // Holds grudges and seeks revenge
-        materialismSpiritualism: 50, // 0=Pure materialism, 100=Pure spiritualism
-
-        // Intellectual Traits
-        intelligence: 50,           // General cognitive ability
-        wisdom: 50,                 // Practical judgment
-        creativity: 50,             // Original thinking
-        logicIntuition: 50,         // 0=Pure intuition, 100=Pure logic
-        analyticalThinking: 50,     // Breaking problems into components
-        memory: 50,                 // Recall ability
-        perception: 50,             // Noticing details
-        curiosity: 50               // Drive to learn and explore
-    },
-
-    // SECONDARY STATES (The Weather Layer) - Temporary emotional states (0-100 intensity)
-    secondaryStates: {
-        // Core Emotions
-        happy: 50,
-        sad: 0,
-        angry: 0,
-        anxious: 0,
-        stressed: 0,
-        scared: 0,
-        disgusted: 0,
-        surprised: 0,
-        ashamed: 0,
-        guilty: 0,
-        proud: 0,
-        jealous: 0,
-
-        // Arousal & Sexual States
-        horny: 0,
-        sexuallyFrustrated: 0,
-        arousedNonSexual: 0,
-        cravingTouch: 0,
-        sensuallyStimulated: 0,
-        seductive: 0,
-        submissiveSexual: 0,
-        dominantSexual: 0,
-
-        // Social States
-        seekingValidation: 0,
-        lonely: 0,
-        needy: 0,
-        confident: 50,
-        insecure: 0,
-        defensive: 0,
-        vulnerable: 0,
-        aggressive: 0,
-        playful: 0,
-        curious: 50,
-        competitive: 0,
-        grateful: 0,
-
-        // Energy & Altered States
-        drunk: 0,
-        high: 0,
-        exhausted: 0,
-        energized: 50,
-        overstimulated: 0,
-        dissociating: 0,
-        manic: 0,
-        melancholic: 0,
-        euphoric: 0,
-        numb: 0
-    },
-
-    // BELIEFS & WORLDVIEW (The Filter Layer)
-    beliefs: [
-        // Example format:
-        // {
-        //     belief: "Loyalty matters more than truth",
-        //     strength: 85,
-        //     stability: 75,
-        //     category: "moral"
-        // }
-    ],
-
-    // PHYSICAL STATS (The Body's Needs)
-    physicalStats: {
-        // Survival Needs
-        bladder: 20,               // 0-100 urge to urinate
-        hunger: 40,                // 0-100 need to eat
-        thirst: 30,                // 0-100 need to drink
-        energy: 70,                // 0-100 physical energy level
-        sleepNeed: 20,             // 0-100 tiredness
-
-        // Physical Condition
-        health: 100,               // 0-100 overall wellbeing
-        pain: 0,                   // 0-100 current pain level
-        arousal: 0,                // 0-100 sexual arousal (detailed below)
-        temperatureComfort: 50,    // 0=Freezing, 50=Perfect, 100=Overheating
-        cleanliness: 80,           // 0-100 how clean they feel
-
-        // Physical Attributes (rarely change)
-        strength: 50,
-        stamina: 50,
-        agility: 50,
-        coordination: 50,
-        flexibility: 50
-    },
-
-    // SEXUAL BIOLOGY (Detailed Arousal System)
-    sexualBiology: {
-        arousalLevel: 0,           // 0-100 current arousal
-        refractoryPeriod: false,   // Currently in refractory period?
-        refractoryUntil: null,     // Timestamp when refractory ends
-        ovulationDay: null,        // Day of cycle (for female chars)
-        menstrualPhase: null,      // 'menstruation', 'follicular', 'ovulation', 'luteal'
-        dayOfCycle: 1,             // 1-28 day of menstrual cycle
-        lastOrgasm: null,          // Timestamp of last orgasm
-        orgasmIntensity: 0,        // 0-100 intensity of last orgasm
-        deprivationDays: 0         // Days since last sexual release
-    },
-
-    // OUTFIT/CLOTHING SYSTEM (Dynamic tracking)
-    clothing: {
-        underwear: {
-            bra: { worn: true, type: 'Regular bra', description: '', status: 'Worn normally', coverage: 15 },
-            panties: { worn: true, type: 'Regular panties', description: '', status: 'Worn normally', coverage: 10 }
-        },
-        upperBody: {
-            shirt: { worn: true, type: 'Blouse', description: '', status: 'Worn properly', coverage: 30 }
-        },
-        lowerBody: {
-            pants: { worn: true, type: 'Jeans', description: '', status: 'Worn properly', coverage: 30 }
-        },
-        outerwear: {
-            jacket: { worn: false, type: '', description: '', status: '', coverage: 0 }
-        },
-        footwear: {
-            shoes: { worn: true, type: 'Sneakers', description: '', status: 'On', coverage: 5 },
-            socks: { worn: true, type: 'Regular socks', description: '', status: 'On', coverage: 2 }
-        },
-        accessories: [],
-        totalCoverage: 92,         // Sum of all coverage percentages
-        lastChange: null           // Timestamp of last clothing change
-    },
-
-    // PHYSICAL STATE (Sweat, Temperature, Cleanliness)
-    physicalState: {
-        bodyTemperature: 37.0,     // Celsius
-        heartRate: 70,             // BPM
-        breathingRate: 14,         // breaths per minute
-        sweatLevel: 10,            // 0-100
-        hairCondition: 'Clean, styled',
-        makeupState: 'Fresh',
-        skinCondition: 'Soft, smooth',
-        marks: [],                 // Hickeys, bruises, scratches
-        scent: 'Natural (clean)'
-    },
-
-    // RELATIONSHIP TRACKING (Per-NPC detailed stats)
-    relationships: {
-        // Example format:
-        // "NPC_Name": {
-        //     // Core Metrics
-        //     trust: 50,
-        //     love: 0,
-        //     loyalty: null,         // null until unlocked
-        //     attraction: 0,
-        //     respect: 50,
-        //     fear: 0,
-        //
-        //     // Social Dynamics
-        //     closeness: 20,
-        //     openness: 20,
-        //     comfort: 50,
-        //     dependency: 0,
-        //
-        //     // Attraction Breakdown
-        //     physicalAttraction: 0,
-        //     emotionalAttraction: 0,
-        //     intellectualAttraction: 0,
-        //
-        //     // Sexual Dynamics
-        //     flirtiness: 0,
-        //     sexualCompatibility: 50,
-        //     sexualSatisfaction: 50,
-        //
-        //     // Power Dynamics
-        //     dominanceOverThem: 50,      // How dominant char is over them
-        //     submissivenessToThem: 0,    // How submissive char is to them
-        //     possessivenessToward: 0,
-        //
-        //     // Negative Feelings
-        //     jealousyOf: 0,
-        //     resentment: 0,
-        //
-        //     // Thoughts & Notes
-        //     currentThoughts: '',         // What char is thinking about this person
-        //     relationshipStatus: 'Acquaintance',
-        //     lastInteraction: null
-        // }
-    },
-
-    // CONTEXTUAL INFO (Extracted from scene)
-    contextInfo: {
-        location: '',
-        timeOfDay: '',
-        weather: '',
-        presentCharacters: [],     // List of characters currently present
-        recentEvents: '',
-        currentActivity: ''
-    },
-
-    // INTERNAL THOUGHTS (Character's current thoughts)
-    thoughts: {
-        internalMonologue: '',     // What they're thinking right now
-        desires: '',               // What they want in this moment
-        fears: '',                 // What they're afraid of
-        plans: ''                  // What they're planning to do
-    }
-};
-
-/**
- * Initialize a new relationship entry for an NPC
- * @param {string} npcName - Name of the NPC
- * @returns {Object} Default relationship data
- */
-export function initializeRelationship(npcName) {
-    return {
-        // Core Metrics
-        trust: 50,
-        love: 0,
-        loyalty: null,
-        attraction: 0,
-        respect: 50,
-        fear: 0,
-
-        // Social Dynamics
-        closeness: 20,
-        openness: 20,
-        comfort: 50,
-        dependency: 0,
-
-        // Attraction Breakdown
-        physicalAttraction: 0,
-        emotionalAttraction: 0,
-        intellectualAttraction: 0,
-
-        // Sexual Dynamics
-        flirtiness: 0,
-        sexualCompatibility: 50,
-        sexualSatisfaction: 50,
-
-        // Power Dynamics
-        dominanceOverThem: 50,
-        submissivenessToThem: 0,
-        possessivenessToward: 0,
-
-        // Negative Feelings
-        jealousyOf: 0,
-        resentment: 0,
-
-        // Thoughts & Notes
-        currentThoughts: '',
-        relationshipStatus: 'Stranger',
-        lastInteraction: new Date().toISOString()
-    };
-}
-
-/**
- * Get or create relationship data for an NPC
- * @param {string} npcName - Name of the NPC
- * @returns {Object} Relationship data
- */
-export function getRelationship(npcName) {
-    if (!characterState.relationships[npcName]) {
-        characterState.relationships[npcName] = initializeRelationship(npcName);
-    }
-    return characterState.relationships[npcName];
-}
-
-/**
- * Update relationship data for an NPC
- * @param {string} npcName - Name of the NPC
- * @param {Object} updates - Partial relationship data to update
- */
-export function updateRelationship(npcName, updates) {
-    const relationship = getRelationship(npcName);
-    Object.assign(relationship, updates);
-    relationship.lastInteraction = new Date().toISOString();
-}
-
-/**
- * Set the entire character state
- * @param {Object} newState - New character state object
- */
-export function setCharacterState(newState) {
-    characterState = newState;
-}
-
-/**
- * Update specific parts of character state
- * @param {Object} updates - Partial character state to update
- */
-export function updateCharacterState(updates) {
-    // Deep merge for nested objects
-    if (updates.primaryTraits) {
-        Object.assign(characterState.primaryTraits, updates.primaryTraits);
-    }
-    if (updates.secondaryStates) {
-        Object.assign(characterState.secondaryStates, updates.secondaryStates);
-    }
-    if (updates.physicalStats) {
-        Object.assign(characterState.physicalStats, updates.physicalStats);
-    }
-    if (updates.sexualBiology) {
-        Object.assign(characterState.sexualBiology, updates.sexualBiology);
-    }
-    if (updates.clothing) {
-        Object.assign(characterState.clothing, updates.clothing);
-    }
-    if (updates.physicalState) {
-        Object.assign(characterState.physicalState, updates.physicalState);
-    }
-    if (updates.contextInfo) {
-        Object.assign(characterState.contextInfo, updates.contextInfo);
-    }
-    if (updates.thoughts) {
-        Object.assign(characterState.thoughts, updates.thoughts);
-    }
-    if (updates.beliefs !== undefined) {
-        characterState.beliefs = updates.beliefs;
-    }
-    if (updates.relationships) {
-        Object.assign(characterState.relationships, updates.relationships);
-    }
-    if (updates.characterName !== undefined) {
-        characterState.characterName = updates.characterName;
-    }
-}
-
-/**
- * Get current character state
- * @returns {Object} Current character state
- */
-export function getCharacterState() {
-    return characterState;
-}
-
-/**
- * Reset character state to defaults
- */
-export function resetCharacterState() {
-    characterState = {
-        characterName: null,
-        primaryTraits: {},
-        secondaryStates: {},
-        beliefs: [],
-        physicalStats: {},
-        sexualBiology: {},
-        clothing: {},
-        physicalState: {},
-        relationships: {},
-        contextInfo: {},
-        thoughts: {}
-    };
-}
-
-/**
- * Export character state as JSON
- * @returns {string} JSON string of character state
- */
-export function exportCharacterState() {
-    return JSON.stringify(characterState, null, 2);
-}
-
-/**
- * Import character state from JSON
- * @param {string} jsonData - JSON string of character state
- */
-export function importCharacterState(jsonData) {
-    try {
-        const imported = JSON.parse(jsonData);
-        characterState = imported;
-        return true;
-    } catch (error) {
-        console.error('[Character State] Import failed:', error);
-        return false;
-    }
-}

src/core/config.js

@@ -26,14 +26,16 @@ export const defaultSettings = {
     autoUpdate: true,
     updateDepth: 4, // How many messages to include in the context
     generationMode: 'together', // 'separate' or 'together' - whether to generate with main response or separately
-    useSeparatePreset: false, // Use 'RPG Companion Trackers' preset for tracker generation instead of main API model
     showUserStats: true,
     showInfoBox: true,
     showCharacterThoughts: true,
     showInventory: true, // Show inventory section (v2 system)
+    showQuests: true, // Show quests section
+    showLockIcons: true, // Show lock/unlock icons on tracker items
     showThoughtsInChat: true, // Show thoughts overlay in chat
-    alwaysShowThoughtBubble: false, // Auto-expand thought bubble without clicking icon
     enableHtmlPrompt: false, // Enable immersive HTML prompt injection
+    enableSpotifyMusic: false, // Enable Spotify music integration (asks AI for Spotify URLs)
+    customSpotifyPrompt: '', // Custom Spotify prompt text (empty = use default)
     // Controls when the extension skips injecting tracker instructions/examples/HTML
     // into generations that appear to be user-injected instructions. Valid values:
     //  - 'none'          -> never skip (legacy behavior: always inject)
@@ -42,6 +44,7 @@ export const defaultSettings = {
     // This setting helps compatibility with other extensions like GuidedGenerations.
     skipInjectionsForGuided: 'none',
     enablePlotButtons: true, // Show plot progression buttons above chat input
+    saveTrackerHistory: false, // Save tracker data in chat history for each message
     panelPosition: 'right', // 'left', 'right', or 'top'
     theme: 'default', // Theme: default, sci-fi, fantasy, cyberpunk, custom
     customColors: {
@@ -82,7 +85,5 @@ export const defaultSettings = {
         cha: 10
     },
     lastDiceRoll: null, // Store last dice roll result
-    collapsedInventoryLocations: [], // Array of collapsed storage location names
-    debugMode: false, // Enable debug logging visible in UI (for mobile debugging)
-    memoryMessagesToProcess: 16 // Number of messages to process per batch in memory recollection
+    collapsedInventoryLocations: [] // Array of collapsed storage location names
 };

src/core/persistence.js

@@ -17,6 +17,7 @@ import {
 } from './state.js';
 import { migrateInventory } from '../utils/migration.js';
 import { validateStoredInventory, cleanItemString } from '../utils/security.js';
+import { migrateToV3JSON } from '../utils/jsonMigration.js';
 
 const extensionName = 'third-party/rpg-companion-sillytavern';
 
@@ -78,6 +79,66 @@ export function loadSettings() {
             }
 
             updateExtensionSettings(savedSettings);
+
+            // Perform settings migrations based on version
+            const currentVersion = extensionSettings.settingsVersion || 1;
+            let settingsChanged = false;
+
+            // Migration to version 2: Enable dynamic weather for existing users
+            if (currentVersion < 2) {
+                // console.log('[RPG Companion] Migrating settings to version 2 (enabling dynamic weather)');
+                extensionSettings.enableDynamicWeather = true;
+                extensionSettings.settingsVersion = 2;
+                settingsChanged = true;
+            }
+
+            // Migration to version 3: Convert text trackers to JSON format
+            if (currentVersion < 3) {
+                // console.log('[RPG Companion] Migrating settings to version 3 (JSON tracker format)');
+                migrateToV3JSON();
+                extensionSettings.settingsVersion = 3;
+                settingsChanged = true;
+            }
+
+            // Migration to version 4: Enable FAB widgets by default
+            if (currentVersion < 4) {
+                // console.log('[RPG Companion] Migrating settings to version 4 (enabling FAB widgets)');
+                if (!extensionSettings.mobileFabWidgets) {
+                    extensionSettings.mobileFabWidgets = {};
+                }
+                extensionSettings.mobileFabWidgets.enabled = true;
+                extensionSettings.mobileFabWidgets.weatherIcon = { enabled: true };
+                extensionSettings.mobileFabWidgets.weatherDesc = { enabled: true };
+                extensionSettings.mobileFabWidgets.clock = { enabled: true };
+                extensionSettings.mobileFabWidgets.date = { enabled: true };
+                extensionSettings.mobileFabWidgets.location = { enabled: true };
+                extensionSettings.mobileFabWidgets.stats = { enabled: true };
+                extensionSettings.mobileFabWidgets.attributes = { enabled: true };
+                extensionSettings.settingsVersion = 4;
+                settingsChanged = true;
+            }
+
+            // Migration to version 5: Add opacity properties for all colors
+            if (currentVersion < 5) {
+                // console.log('[RPG Companion] Migrating settings to version 5 (adding color opacity)');
+                if (!extensionSettings.customColors) {
+                    extensionSettings.customColors = {};
+                }
+                if (extensionSettings.customColors.bgOpacity === undefined) extensionSettings.customColors.bgOpacity = 100;
+                if (extensionSettings.customColors.accentOpacity === undefined) extensionSettings.customColors.accentOpacity = 100;
+                if (extensionSettings.customColors.textOpacity === undefined) extensionSettings.customColors.textOpacity = 100;
+                if (extensionSettings.customColors.highlightOpacity === undefined) extensionSettings.customColors.highlightOpacity = 100;
+                if (extensionSettings.statBarColorLowOpacity === undefined) extensionSettings.statBarColorLowOpacity = 100;
+                if (extensionSettings.statBarColorHighOpacity === undefined) extensionSettings.statBarColorHighOpacity = 100;
+                extensionSettings.settingsVersion = 5;
+                settingsChanged = true;
+            }
+
+            // Save migrated settings
+            if (settingsChanged) {
+                saveSettings();
+            }
+
             // console.log('[RPG Companion] Settings loaded:', extensionSettings);
         } else {
             // console.log('[RPG Companion] No saved settings found, using defaults');
@@ -87,7 +148,7 @@ export function loadSettings() {
         if (FEATURE_FLAGS.useNewInventory) {
             const migrationResult = migrateInventory(extensionSettings.userStats.inventory);
             if (migrationResult.migrated) {
-                console.log(`[RPG Companion] Inventory migrated from ${migrationResult.source} to v2 format`);
+                // console.log(`[RPG Companion] Inventory migrated from ${migrationResult.source} to v2 format`);
                 extensionSettings.userStats.inventory = migrationResult.inventory;
                 saveSettings(); // Persist migrated inventory
             }
@@ -95,10 +156,19 @@ export function loadSettings() {
 
         // Migrate to trackerConfig if it doesn't exist
         if (!extensionSettings.trackerConfig) {
-            console.log('[RPG Companion] Migrating to trackerConfig format');
+            // console.log('[RPG Companion] Migrating to trackerConfig format');
             migrateToTrackerConfig();
             saveSettings(); // Persist migration
         }
+
+        // Migrate to preset manager system if presets don't exist
+        migrateToPresetManager();
+
+        // Initialize custom status fields
+        initializeCustomStatusFields();
+
+        // Ensure all stats have maxValue (for number display mode)
+        ensureStatsHaveMaxValue();
     } catch (error) {
         console.error('[RPG Companion] Error loading settings:', error);
         console.error('[RPG Companion] Error details:', error.message, error.stack);
@@ -134,6 +204,14 @@ export function saveChatData() {
         return;
     }
 
+    // console.log('[RPG Companion] 💾 saveChatData called - committedTrackerData:', {
+    //     userStats: committedTrackerData.userStats ? `${committedTrackerData.userStats.substring(0, 50)}...` : 'null',
+    //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+    //     characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
+    // });
+    // console.log('[RPG Companion] 💾 saveChatData RAW committedTrackerData:', committedTrackerData);
+    // console.log('[RPG Companion] 💾 saveChatData RAW lastGeneratedData:', lastGeneratedData);
+
     chat_metadata.rpg_companion = {
         userStats: extensionSettings.userStats,
         classicStats: extensionSettings.classicStats,
@@ -247,21 +325,36 @@ export function loadChatData() {
         };
     }
 
-    // Restore last generated data
-    if (savedData.lastGeneratedData) {
-        setLastGeneratedData({ ...savedData.lastGeneratedData });
+    // Restore committed tracker data first
+    if (savedData.committedTrackerData) {
+        // console.log('[RPG Companion] 📥 loadChatData restoring committedTrackerData:', {
+        //     userStats: savedData.committedTrackerData.userStats ? `${savedData.committedTrackerData.userStats.substring(0, 50)}...` : 'null',
+        //     infoBox: savedData.committedTrackerData.infoBox ? 'exists' : 'null',
+        //     characterThoughts: savedData.committedTrackerData.characterThoughts ? 'exists' : 'null'
+        // });
+        // console.log('[RPG Companion] 📥 RAW savedData.committedTrackerData:', savedData.committedTrackerData);
+        // console.log('[RPG Companion] 📥 Type check:', {
+        //     userStatsType: typeof savedData.committedTrackerData.userStats,
+        //     infoBoxType: typeof savedData.committedTrackerData.infoBox,
+        //     characterThoughtsType: typeof savedData.committedTrackerData.characterThoughts
+        // });
+        setCommittedTrackerData({ ...savedData.committedTrackerData });
     }
 
-    // Restore committed tracker data
-    if (savedData.committedTrackerData) {
-        setCommittedTrackerData({ ...savedData.committedTrackerData });
+    // Restore last generated data (for display)
+    // Always prefer lastGeneratedData as it contains the most recent generation (including swipes)
+    if (savedData.lastGeneratedData) {
+        // console.log('[RPG Companion] 📥 loadChatData restoring lastGeneratedData');
+        setLastGeneratedData({ ...savedData.lastGeneratedData });
+    } else {
+        // console.log('[RPG Companion] ⚠️ No lastGeneratedData found in save');
     }
 
     // Migrate inventory in chat data if feature flag enabled
     if (FEATURE_FLAGS.useNewInventory && extensionSettings.userStats.inventory) {
         const migrationResult = migrateInventory(extensionSettings.userStats.inventory);
         if (migrationResult.migrated) {
-            console.log(`[RPG Companion] Chat inventory migrated from ${migrationResult.source} to v2 format`);
+            // console.log(`[RPG Companion] Chat inventory migrated from ${migrationResult.source} to v2 format`);
             extensionSettings.userStats.inventory = migrationResult.inventory;
             saveChatData(); // Persist migrated inventory to chat metadata
         }
@@ -351,7 +444,7 @@ function validateInventoryStructure(inventory, source) {
 
     // Persist repairs if needed
     if (needsSave) {
-        console.log(`[RPG Companion] Repaired inventory structure from ${source}, saving...`);
+        // console.log(`[RPG Companion] Repaired inventory structure from ${source}, saving...`);
         saveSettings();
         if (source === 'chat') {
             saveChatData();
@@ -405,7 +498,7 @@ function migrateToTrackerConfig() {
                     { id: 'physicalState', label: 'Physical State', enabled: true, placeholder: 'Visible Physical State (up to three traits)' },
                     { id: 'demeanor', label: 'Demeanor Cue', enabled: true, placeholder: 'Observable Demeanor Cue (one trait)' },
                     { id: 'relationship', label: 'Relationship', enabled: true, type: 'relationship', placeholder: 'Enemy/Neutral/Friend/Lover' },
-                    { id: 'internalMonologue', label: 'Internal Monologue', enabled: true, placeholder: 'Internal Monologue (in first person POV, up to three sentences long)' }
+                    { id: 'internalMonologue', label: 'Internal Monologue', enabled: true, placeholder: 'Internal Monologue (in first person from character\'s POV, up to three sentences long)' }
                 ],
                 characterStats: {
                     enabled: false,
@@ -423,7 +516,7 @@ function migrateToTrackerConfig() {
             name: extensionSettings.statNames[id] || id.charAt(0).toUpperCase() + id.slice(1),
             enabled: true
         }));
-        console.log('[RPG Companion] Migrated statNames to customStats array');
+        // console.log('[RPG Companion] Migrated statNames to customStats array');
     }
 
     // Ensure all stats have corresponding values in userStats
@@ -447,7 +540,7 @@ function migrateToTrackerConfig() {
             { id: 'cha', name: 'CHA', enabled: shouldShow }
         ];
         delete extensionSettings.trackerConfig.userStats.showRPGAttributes;
-        console.log('[RPG Companion] Migrated showRPGAttributes to rpgAttributes array');
+        // console.log('[RPG Companion] Migrated showRPGAttributes to rpgAttributes array');
     }
 
     // Ensure rpgAttributes exists even if no migration was needed
@@ -485,7 +578,7 @@ function migrateToTrackerConfig() {
             const hasOldFormat = pc.customFields.some(f => f.label || f.placeholder || f.type === 'relationship');
 
             if (hasOldFormat) {
-                console.log('[RPG Companion] Migrating Present Characters to new structure');
+                // console.log('[RPG Companion] Migrating Present Characters to new structure');
 
                 // Extract relationship fields from old customFields
                 const relationshipFields = ['Lover', 'Friend', 'Ally', 'Enemy', 'Neutral'];
@@ -505,7 +598,7 @@ function migrateToTrackerConfig() {
                 const thoughts = {
                     enabled: thoughtsField ? (thoughtsField.enabled !== false) : true,
                     name: 'Thoughts',
-                    description: thoughtsField?.placeholder || 'Internal monologue (in first person POV, up to three sentences long)'
+                    description: thoughtsField?.placeholder || 'Internal Monologue (in first person from character\'s POV, up to three sentences long)'
                 };
 
                 // Update to new structure
@@ -513,7 +606,7 @@ function migrateToTrackerConfig() {
                 pc.customFields = newCustomFields;
                 pc.thoughts = thoughts;
 
-                console.log('[RPG Companion] Present Characters migration complete');
+                // console.log('[RPG Companion] Present Characters migration complete');
                 saveSettings(); // Persist the migration
             }
         }
@@ -532,12 +625,489 @@ function migrateToTrackerConfig() {
                 'Neutral': '⚖️'
             };
         }
+
+        // Migrate to new relationships structure if not already present
+        if (!pc.relationships) {
+            pc.relationships = {
+                enabled: true, // Default to enabled for backward compatibility
+                relationshipEmojis: pc.relationshipEmojis || {
+                    'Lover': '❤️',
+                    'Friend': '⭐',
+                    'Ally': '🤝',
+                    'Enemy': '⚔️',
+                    'Neutral': '⚖️'
+                }
+            };
+        }
+
         if (!pc.thoughts) {
             pc.thoughts = {
                 enabled: true,
                 name: 'Thoughts',
-                description: 'Internal monologue (in first person POV, up to three sentences long)'
+                description: 'Internal Monologue (in first person from character\'s POV, up to three sentences long)'
             };
         }
     }
 }
+
+// ============================================================================
+// Preset Management Functions
+// ============================================================================
+
+/**
+ * Gets the entity key for the current character or group
+ * @returns {string|null} Entity key in format "char_{id}" or "group_{id}", or null if no character selected
+ */
+export function getCurrentEntityKey() {
+    const context = getContext();
+    if (context.groupId) {
+        return `group_${context.groupId}`;
+    } else if (context.characterId !== undefined && context.characterId !== null) {
+        return `char_${context.characterId}`;
+    }
+    return null;
+}
+
+/**
+ * Gets the display name for the current character or group
+ * @returns {string} Display name for the current entity
+ */
+export function getCurrentEntityName() {
+    const context = getContext();
+    if (context.groupId) {
+        const group = context.groups?.find(g => g.id === context.groupId);
+        return group?.name || 'Group Chat';
+    } else if (context.characterId !== undefined && context.characterId !== null) {
+        return context.name2 || 'Character';
+    }
+    return 'No Character';
+}
+
+/**
+ * Migrates existing trackerConfig to the preset system if presetManager doesn't exist
+ * Creates a "Default" preset from the current trackerConfig
+ */
+export function migrateToPresetManager() {
+    if (!extensionSettings.presetManager || Object.keys(extensionSettings.presetManager.presets || {}).length === 0) {
+        // console.log('[RPG Companion] Migrating to preset manager system');
+
+        // Initialize presetManager if it doesn't exist
+        if (!extensionSettings.presetManager) {
+            extensionSettings.presetManager = {
+                presets: {},
+                characterAssociations: {},
+                activePresetId: null,
+                defaultPresetId: null
+            };
+        }
+
+        // Create default preset from existing trackerConfig
+        const defaultPresetId = 'preset_default';
+        extensionSettings.presetManager.presets[defaultPresetId] = {
+            id: defaultPresetId,
+            name: 'Default',
+            trackerConfig: JSON.parse(JSON.stringify(extensionSettings.trackerConfig))
+        };
+        extensionSettings.presetManager.activePresetId = defaultPresetId;
+        extensionSettings.presetManager.defaultPresetId = defaultPresetId;
+
+        // console.log('[RPG Companion] Created Default preset from existing trackerConfig');
+        saveSettings();
+    }
+}
+
+/**
+ * Initializes custom status fields in userStats based on trackerConfig
+ * Ensures all defined custom status fields have a value in the userStats object
+ */
+function initializeCustomStatusFields() {
+    const customFields = extensionSettings.trackerConfig?.userStats?.statusSection?.customFields || [];
+
+    // Initialize each custom field if it doesn't exist
+    for (const fieldName of customFields) {
+        const fieldKey = fieldName.toLowerCase();
+        if (extensionSettings.userStats[fieldKey] === undefined) {
+            extensionSettings.userStats[fieldKey] = 'None';
+            // console.log(`[RPG Companion] Initialized custom status field: ${fieldKey}`);
+        }
+    }
+}
+
+/**
+ * Ensures all custom stats have a maxValue property
+ * This migration supports the number display mode feature
+ */
+function ensureStatsHaveMaxValue() {
+    const customStats = extensionSettings.trackerConfig?.userStats?.customStats || [];
+
+    for (const stat of customStats) {
+        if (stat && stat.maxValue === undefined) {
+            stat.maxValue = 100; // Default to 100 for backward compatibility
+            // console.log(`[RPG Companion] Added maxValue to stat: ${stat.id || stat.name}`);
+        }
+    }
+
+    // Ensure statsDisplayMode is set (default to percentage)
+    if (extensionSettings.trackerConfig?.userStats &&
+        extensionSettings.trackerConfig.userStats.statsDisplayMode === undefined) {
+        extensionSettings.trackerConfig.userStats.statsDisplayMode = 'percentage';
+        // console.log('[RPG Companion] Initialized statsDisplayMode to percentage');
+    }
+}
+
+/**
+ * Gets all available presets
+ * @returns {Object} Map of preset ID to preset data
+ */
+export function getPresets() {
+    return extensionSettings.presetManager?.presets || {};
+}
+
+/**
+ * Gets a specific preset by ID
+ * @param {string} presetId - The preset ID
+ * @returns {Object|null} The preset object or null if not found
+ */
+export function getPreset(presetId) {
+    return extensionSettings.presetManager?.presets?.[presetId] || null;
+}
+
+/**
+ * Gets the currently active preset ID
+ * @returns {string|null} The active preset ID or null
+ */
+export function getActivePresetId() {
+    return extensionSettings.presetManager?.activePresetId || null;
+}
+
+/**
+ * Gets the default preset ID
+ * @returns {string|null} The default preset ID or null
+ */
+export function getDefaultPresetId() {
+    return extensionSettings.presetManager?.defaultPresetId || null;
+}
+
+/**
+ * Sets a preset as the default
+ * @param {string} presetId - The preset ID to set as default
+ */
+export function setDefaultPreset(presetId) {
+    if (extensionSettings.presetManager.presets[presetId]) {
+        extensionSettings.presetManager.defaultPresetId = presetId;
+        saveSettings();
+        // console.log(`[RPG Companion] Set preset ${presetId} as default`);
+    }
+}
+
+/**
+ * Checks if the given preset is the default
+ * @param {string} presetId - The preset ID to check
+ * @returns {boolean} True if it's the default preset
+ */
+export function isDefaultPreset(presetId) {
+    return extensionSettings.presetManager?.defaultPresetId === presetId;
+}
+
+/**
+ * Creates a new preset from the current trackerConfig
+ * @param {string} name - Name for the new preset
+ * @returns {string} The ID of the newly created preset
+ */
+export function createPreset(name) {
+    const presetId = `preset_${Date.now()}`;
+    extensionSettings.presetManager.presets[presetId] = {
+        id: presetId,
+        name: name,
+        trackerConfig: JSON.parse(JSON.stringify(extensionSettings.trackerConfig)),
+        historyPersistence: extensionSettings.historyPersistence
+            ? JSON.parse(JSON.stringify(extensionSettings.historyPersistence))
+            : null
+    };
+    // Also set it as the active preset so edits go to the new preset
+    extensionSettings.presetManager.activePresetId = presetId;
+    saveSettings();
+    // console.log(`[RPG Companion] Created preset "${name}" with ID ${presetId}`);
+    return presetId;
+}
+
+/**
+ * Saves the current trackerConfig and historyPersistence to the specified preset
+ * @param {string} presetId - The preset ID to save to
+ */
+export function saveToPreset(presetId) {
+    const preset = extensionSettings.presetManager.presets[presetId];
+    if (preset) {
+        preset.trackerConfig = JSON.parse(JSON.stringify(extensionSettings.trackerConfig));
+        preset.historyPersistence = extensionSettings.historyPersistence
+            ? JSON.parse(JSON.stringify(extensionSettings.historyPersistence))
+            : null;
+        saveSettings();
+        // console.log(`[RPG Companion] Saved current config to preset "${preset.name}"`);
+    }
+}
+
+/**
+ * Loads a preset's trackerConfig and historyPersistence as the active configuration
+ * @param {string} presetId - The preset ID to load
+ * @returns {boolean} True if loaded successfully, false otherwise
+ */
+export function loadPreset(presetId) {
+    const preset = extensionSettings.presetManager.presets[presetId];
+    if (preset && preset.trackerConfig) {
+        extensionSettings.trackerConfig = JSON.parse(JSON.stringify(preset.trackerConfig));
+        // Load historyPersistence if present, otherwise use defaults
+        if (preset.historyPersistence) {
+            extensionSettings.historyPersistence = JSON.parse(JSON.stringify(preset.historyPersistence));
+        } else {
+            // Default values for presets that don't have historyPersistence yet
+            extensionSettings.historyPersistence = {
+                enabled: false,
+                messageCount: 5,
+                injectionPosition: 'assistant_message_end',
+                contextPreamble: ''
+            };
+        }
+        extensionSettings.presetManager.activePresetId = presetId;
+        saveSettings();
+        // console.log(`[RPG Companion] Loaded preset "${preset.name}"`);
+        return true;
+    }
+    return false;
+}
+
+/**
+ * Renames a preset
+ * @param {string} presetId - The preset ID to rename
+ * @param {string} newName - The new name for the preset
+ */
+export function renamePreset(presetId, newName) {
+    const preset = extensionSettings.presetManager.presets[presetId];
+    if (preset) {
+        preset.name = newName;
+        saveSettings();
+        // console.log(`[RPG Companion] Renamed preset to "${newName}"`);
+    }
+}
+
+/**
+ * Deletes a preset
+ * @param {string} presetId - The preset ID to delete
+ * @returns {boolean} True if deleted, false if it's the last preset (can't delete)
+ */
+export function deletePreset(presetId) {
+    const presets = extensionSettings.presetManager.presets;
+    const presetIds = Object.keys(presets);
+
+    // Don't delete if it's the last preset
+    if (presetIds.length <= 1) {
+        // console.warn('[RPG Companion] Cannot delete the last preset');
+        return false;
+    }
+
+    // Remove any character associations using this preset
+    const associations = extensionSettings.presetManager.characterAssociations;
+    for (const entityKey of Object.keys(associations)) {
+        if (associations[entityKey] === presetId) {
+            delete associations[entityKey];
+        }
+    }
+
+    // Delete the preset
+    delete presets[presetId];
+
+    // If the deleted preset was active, switch to the first available preset
+    if (extensionSettings.presetManager.activePresetId === presetId) {
+        const remainingIds = Object.keys(presets);
+        if (remainingIds.length > 0) {
+            loadPreset(remainingIds[0]);
+        }
+    }
+
+    saveSettings();
+    // console.log(`[RPG Companion] Deleted preset ${presetId}`);
+    return true;
+}
+
+/**
+ * Associates the current preset with the current character/group
+ */
+export function associatePresetWithCurrentEntity() {
+    const entityKey = getCurrentEntityKey();
+    const activePresetId = extensionSettings.presetManager.activePresetId;
+
+    if (entityKey && activePresetId) {
+        extensionSettings.presetManager.characterAssociations[entityKey] = activePresetId;
+        saveSettings();
+        // console.log(`[RPG Companion] Associated preset ${activePresetId} with ${entityKey}`);
+    }
+}
+
+/**
+ * Removes the preset association for the current character/group
+ */
+export function removePresetAssociationForCurrentEntity() {
+    const entityKey = getCurrentEntityKey();
+    if (entityKey && extensionSettings.presetManager.characterAssociations[entityKey]) {
+        delete extensionSettings.presetManager.characterAssociations[entityKey];
+        saveSettings();
+        // console.log(`[RPG Companion] Removed preset association for ${entityKey}`);
+    }
+}
+
+/**
+ * Gets the preset ID associated with the current character/group
+ * @returns {string|null} The associated preset ID or null
+ */
+export function getPresetForCurrentEntity() {
+    const entityKey = getCurrentEntityKey();
+    if (entityKey) {
+        return extensionSettings.presetManager.characterAssociations[entityKey] || null;
+    }
+    return null;
+}
+
+/**
+ * Checks if the current character/group has a preset association
+ * @returns {boolean} True if there's an association
+ */
+export function hasPresetAssociation() {
+    const entityKey = getCurrentEntityKey();
+    return entityKey && extensionSettings.presetManager.characterAssociations[entityKey] !== undefined;
+}
+
+/**
+ * Checks if the current character/group is associated with the currently active preset
+ * @returns {boolean} True if the current entity is associated with the active preset
+ */
+export function isAssociatedWithCurrentPreset() {
+    const entityKey = getCurrentEntityKey();
+    const activePresetId = extensionSettings.presetManager?.activePresetId;
+    if (!entityKey || !activePresetId) return false;
+    return extensionSettings.presetManager.characterAssociations[entityKey] === activePresetId;
+}
+
+/**
+ * Auto-switches to the preset associated with the current character/group
+ * Called when character changes. Falls back to default preset if no association.
+ * @returns {boolean} True if a preset was switched, false otherwise
+ */
+export function autoSwitchPresetForEntity() {
+    const associatedPresetId = getPresetForCurrentEntity();
+
+    // If there's a character-specific preset, use it
+    if (associatedPresetId && associatedPresetId !== extensionSettings.presetManager.activePresetId) {
+        // Check if the preset still exists
+        if (extensionSettings.presetManager.presets[associatedPresetId]) {
+            return loadPreset(associatedPresetId);
+        } else {
+            // Preset was deleted, remove the stale association
+            removePresetAssociationForCurrentEntity();
+        }
+    }
+
+    // No character association - fall back to default preset if set
+    if (!associatedPresetId) {
+        const defaultPresetId = extensionSettings.presetManager.defaultPresetId;
+        if (defaultPresetId &&
+            defaultPresetId !== extensionSettings.presetManager.activePresetId &&
+            extensionSettings.presetManager.presets[defaultPresetId]) {
+            return loadPreset(defaultPresetId);
+        }
+    }
+
+    return false;
+}
+
+/**
+ * Exports presets for sharing (without character associations)
+ * @param {string[]} presetIds - Array of preset IDs to export, or empty for all
+ * @returns {Object} Export data object
+ */
+export function exportPresets(presetIds = []) {
+    const presetsToExport = {};
+    const allPresets = extensionSettings.presetManager.presets;
+
+    // If no specific IDs provided, export all
+    const idsToExport = presetIds.length > 0 ? presetIds : Object.keys(allPresets);
+
+    for (const id of idsToExport) {
+        if (allPresets[id]) {
+            presetsToExport[id] = {
+                id: allPresets[id].id,
+                name: allPresets[id].name,
+                trackerConfig: allPresets[id].trackerConfig
+            };
+        }
+    }
+
+    return {
+        version: '1.0',
+        exportDate: new Date().toISOString(),
+        presets: presetsToExport
+        // Note: characterAssociations are intentionally NOT exported
+    };
+}
+
+/**
+ * Imports presets from an export file
+ * @param {Object} importData - The imported data object
+ * @param {boolean} overwrite - If true, overwrites existing presets with same name
+ * @returns {number} Number of presets imported
+ */
+export function importPresets(importData, overwrite = false) {
+    if (!importData.presets || typeof importData.presets !== 'object') {
+        throw new Error('Invalid import data: missing presets');
+    }
+
+    let importCount = 0;
+    const existingNames = new Set(
+        Object.values(extensionSettings.presetManager.presets).map(p => p.name.toLowerCase())
+    );
+
+    for (const [originalId, preset] of Object.entries(importData.presets)) {
+        if (!preset.name || !preset.trackerConfig) {
+            continue; // Skip invalid presets
+        }
+
+        let name = preset.name;
+        const nameLower = name.toLowerCase();
+
+        // Check for name collision
+        if (existingNames.has(nameLower)) {
+            if (overwrite) {
+                // Find and delete the existing preset with this name
+                for (const [existingId, existingPreset] of Object.entries(extensionSettings.presetManager.presets)) {
+                    if (existingPreset.name.toLowerCase() === nameLower) {
+                        delete extensionSettings.presetManager.presets[existingId];
+                        break;
+                    }
+                }
+            } else {
+                // Generate a unique name
+                let counter = 1;
+                while (existingNames.has(`${nameLower} (${counter})`)) {
+                    counter++;
+                }
+                name = `${preset.name} (${counter})`;
+            }
+        }
+
+        // Create new preset with new ID
+        const newId = `preset_${Date.now()}_${importCount}`;
+        extensionSettings.presetManager.presets[newId] = {
+            id: newId,
+            name: name,
+            trackerConfig: JSON.parse(JSON.stringify(preset.trackerConfig))
+        };
+        existingNames.add(name.toLowerCase());
+        importCount++;
+    }
+
+    if (importCount > 0) {
+        saveSettings();
+    }
+
+    return importCount;
+}
+

src/core/state.js

@@ -10,51 +10,121 @@
  * Extension settings - persisted to SillyTavern settings
  */
 export let extensionSettings = {
+    settingsVersion: 4, // Version number for settings migrations (v4 = FAB widgets enabled by default)
     enabled: true,
-    autoUpdate: true,
+    autoUpdate: false,
     updateDepth: 4, // How many messages to include in the context
     generationMode: 'together', // 'separate' or 'together' - whether to generate with main response or separately
-    useSeparatePreset: false, // Use 'RPG Companion Trackers' preset for tracker generation instead of main API model
     showUserStats: true,
     showInfoBox: true,
     showCharacterThoughts: true,
     showInventory: true, // Show inventory section (v2 system)
+    showQuests: true, // Show quests section
     showThoughtsInChat: true, // Show thoughts overlay in chat
+    narratorMode: false, // Use character card as narrator instead of fixed character references
+    customNarratorPrompt: '', // Custom narrator mode prompt text (empty = use default)
+    customContextInstructionsPrompt: '', // Custom context instructions prompt text (empty = use default)
     enableHtmlPrompt: false, // Enable immersive HTML prompt injection
     customHtmlPrompt: '', // Custom HTML prompt text (empty = use default)
+    enableDialogueColoring: false, // Enable dialogue coloring prompt injection
+    customDialogueColoringPrompt: '', // Custom dialogue coloring prompt text (empty = use default)
+    enableDeceptionSystem: false, // Enable deception tracking with <lie> tags
+    customDeceptionPrompt: '', // Custom deception prompt text (empty = use default)
+    enableOmniscienceFilter: false, // Enable omniscience filter with <filter> tags
+    customOmnisciencePrompt: '', // Custom omniscience filter prompt text (empty = use default)
+    enableCYOA: false, // Enable "Choose Your Own Adventure" formatting with action choices
+    customCYOAPrompt: '', // Custom CYOA prompt text (empty = use default)
+    enableSpotifyMusic: false, // Enable Spotify music integration (asks AI for Spotify URLs)
+    customSpotifyPrompt: '', // Custom Spotify prompt text (empty = use default)
+
+    enableDynamicWeather: true, // Enable dynamic weather effects based on Info Box weather field (v2: enabled by default)
+    weatherBackground: true, // Show weather effects in background (behind chat)
+    weatherForeground: false, // Show weather effects in foreground (on top of chat)
+    dismissedHolidayPromo: false, // User dismissed the holiday promotion banner
+    showHtmlToggle: true, // Show Immersive HTML toggle in main panel
+    showDialogueColoringToggle: true, // Show Dialogue Coloring toggle in main panel (enabled by default)
+    showDeceptionToggle: true, // Show Deception System toggle in main panel
+    showOmniscienceToggle: true, // Show Omniscience Filter toggle in main panel
+    showCYOAToggle: true, // Show CYOA toggle in main panel
+    showSpotifyToggle: true, // Show Spotify Music toggle in main panel
+
+    showDynamicWeatherToggle: true, // Show Dynamic Weather Effects toggle in main panel
+    showNarratorMode: true, // Show Narrator Mode toggle in main panel
+    showAutoAvatars: true, // Show Auto-generate Avatars toggle in main panel
     skipInjectionsForGuided: 'none', // skip injections for instruct injections and quiet prompts (GuidedGenerations compatibility)
-    enablePlotButtons: true, // Show plot progression buttons above chat input
+    enableRandomizedPlot: true, // Show randomized plot progression button above chat input
+    enableNaturalPlot: true, // Show natural plot progression button above chat input
+    // History persistence settings - inject selected tracker data into historical messages
+    historyPersistence: {
+        enabled: false, // Master toggle for history persistence feature
+        messageCount: 5, // Number of messages to include (0 = all available)
+        injectionPosition: 'assistant_message_end', // 'user_message_end', 'assistant_message_end', 'extra_user_message', 'extra_assistant_message'
+        contextPreamble: '', // Optional custom preamble text (empty = use default short one)
+        sendAllEnabledOnRefresh: false // If true, sends all enabled stats from preset instead of only persistInHistory-enabled stats on Refresh RPG Info
+    },
     panelPosition: 'right', // 'left', 'right', or 'top'
     theme: 'default', // Theme: default, sci-fi, fantasy, cyberpunk, custom
     customColors: {
         bg: '#1a1a2e',
+        bgOpacity: 100,
         accent: '#16213e',
+        accentOpacity: 100,
         text: '#eaeaea',
-        highlight: '#e94560'
+        textOpacity: 100,
+        highlight: '#e94560',
+        highlightOpacity: 100
     },
     statBarColorLow: '#cc3333', // Color for low stat values (red)
+    statBarColorLowOpacity: 100,
     statBarColorHigh: '#33cc66', // Color for high stat values (green)
+    statBarColorHighOpacity: 100,
     enableAnimations: true, // Enable smooth animations for stats and content updates
     mobileFabPosition: {
         top: 'calc(var(--topBarBlockSize) + 60px)',
         right: '12px'
     }, // Saved position for mobile FAB button
-    userStats: {
-        health: 100,
-        satiety: 100,
-        energy: 100,
-        hygiene: 100,
-        arousal: 0,
-        mood: '😐',
-        conditions: 'None',
-        /** @type {InventoryV2} */
-        inventory: {
-            version: 2,
-            onPerson: "None",
-            stored: {},
-            assets: "None"
-        }
+    // Mobile FAB widget display options (8-position system around the button)
+    mobileFabWidgets: {
+        enabled: true, // Master toggle for FAB widgets
+        weatherIcon: { enabled: true, position: 0 },      // Weather emoji (☀️, 🌧️, etc.)
+        weatherDesc: { enabled: true, position: 1 },      // Weather description text
+        clock: { enabled: true, position: 2 },            // Current time display
+        date: { enabled: true, position: 3 },             // Date display
+        location: { enabled: true, position: 4 },         // Location name
+        stats: { enabled: true, position: 5 },            // All stats as compact numbers
+        attributes: { enabled: true, position: 6 }        // Compact RPG attributes display
     },
+    // Desktop strip widget display options (shown in collapsed panel strip)
+    desktopStripWidgets: {
+        enabled: true, // Master toggle for strip widgets (enabled by default)
+        weatherIcon: { enabled: true },      // Weather emoji (☀️, 🌧️, etc.)
+        clock: { enabled: true },            // Current time display
+        date: { enabled: true },             // Date display
+        location: { enabled: true },         // Location name
+        stats: { enabled: true },            // All stats as compact numbers
+        attributes: { enabled: true }        // Compact RPG attributes display
+    },
+    userStats: JSON.stringify({
+        stats: [
+            { id: 'health', name: 'Health', value: 100 },
+            { id: 'satiety', name: 'Satiety', value: 100 },
+            { id: 'energy', name: 'Energy', value: 100 },
+            { id: 'hygiene', name: 'Hygiene', value: 100 },
+            { id: 'arousal', name: 'Arousal', value: 0 }
+        ],
+        status: {
+            mood: '😐',
+            conditions: 'None'
+        },
+        inventory: {
+            onPerson: [],
+            stored: []
+        },
+        quests: {
+            active: [],
+            completed: []
+        }
+    }, null, 2),
     statNames: {
         health: 'Health',
         satiety: 'Satiety',
@@ -65,55 +135,75 @@ export let extensionSettings = {
     // Tracker customization configuration
     trackerConfig: {
         userStats: {
+            // Stats display mode: 'percentage' or 'number'
+            statsDisplayMode: 'percentage',
             // Array of custom stats (allows add/remove/rename)
             customStats: [
-                { id: 'health', name: 'Health', enabled: true },
-                { id: 'satiety', name: 'Satiety', enabled: true },
-                { id: 'energy', name: 'Energy', enabled: true },
-                { id: 'hygiene', name: 'Hygiene', enabled: true },
-                { id: 'arousal', name: 'Arousal', enabled: true }
+                { id: 'health', name: 'Health', enabled: true, persistInHistory: false, maxValue: 100 },
+                { id: 'satiety', name: 'Satiety', enabled: true, persistInHistory: false, maxValue: 100 },
+                { id: 'energy', name: 'Energy', enabled: true, persistInHistory: false, maxValue: 100 },
+                { id: 'hygiene', name: 'Hygiene', enabled: true, persistInHistory: false, maxValue: 100 },
+                { id: 'arousal', name: 'Arousal', enabled: true, persistInHistory: false, maxValue: 100 }
             ],
             // RPG Attributes (customizable D&D-style attributes)
             showRPGAttributes: true,
+            showLevel: true, // Show/hide level in UI and prompts
             alwaysSendAttributes: false, // If true, always send attributes; if false, only send with dice rolls
             rpgAttributes: [
-                { id: 'str', name: 'STR', enabled: true },
-                { id: 'dex', name: 'DEX', enabled: true },
-                { id: 'con', name: 'CON', enabled: true },
-                { id: 'int', name: 'INT', enabled: true },
-                { id: 'wis', name: 'WIS', enabled: true },
-                { id: 'cha', name: 'CHA', enabled: true }
+                { id: 'str', name: 'STR', enabled: true, persistInHistory: false },
+                { id: 'dex', name: 'DEX', enabled: true, persistInHistory: false },
+                { id: 'con', name: 'CON', enabled: true, persistInHistory: false },
+                { id: 'int', name: 'INT', enabled: true, persistInHistory: false },
+                { id: 'wis', name: 'WIS', enabled: true, persistInHistory: false },
+                { id: 'cha', name: 'CHA', enabled: true, persistInHistory: false }
             ],
             // Status section config
             statusSection: {
                 enabled: true,
                 showMoodEmoji: true,
-                customFields: ['Conditions'] // User can edit what to track
+                customFields: ['Conditions'], // User can edit what to track
+                persistInHistory: false // Persist status in historical messages
             },
             // Optional skills field
             skillsSection: {
                 enabled: false,
                 label: 'Skills', // User-editable
-                customFields: [] // Array of skill names
-            }
+                customFields: [], // Array of skill names
+                persistInHistory: false // Persist skills in historical messages
+            },
+            // Inventory persistence
+            inventoryPersistInHistory: false, // Persist inventory in historical messages
+            // Quests persistence
+            questsPersistInHistory: false // Persist quests in historical messages
         },
         infoBox: {
             widgets: {
-                date: { enabled: true, format: 'Weekday, Month, Year' }, // Format options in UI
-                weather: { enabled: true },
-                temperature: { enabled: true, unit: 'C' }, // 'C' or 'F'
-                time: { enabled: true },
-                location: { enabled: true },
-                recentEvents: { enabled: true }
+                date: { enabled: true, format: 'Weekday, Month, Year', persistInHistory: true }, // Date enabled by default for history
+                weather: { enabled: true, persistInHistory: true }, // Weather enabled by default for history
+                temperature: { enabled: true, unit: 'C', persistInHistory: false }, // 'C' or 'F'
+                time: { enabled: true, persistInHistory: true }, // Time enabled by default for history
+                location: { enabled: true, persistInHistory: true }, // Location enabled by default for history
+                recentEvents: { enabled: true, persistInHistory: false }
             }
         },
         presentCharacters: {
             // Fixed fields (always shown)
             showEmoji: true,
             showName: true,
-            // Relationship fields (shown after name, separated by /)
+            // Relationship fields configuration
+            relationships: {
+                enabled: true,
+                // Relationship to emoji mapping (shown on character portraits)
+                relationshipEmojis: {
+                    'Lover': '❤️',
+                    'Friend': '⭐',
+                    'Ally': '🤝',
+                    'Enemy': '⚔️',
+                    'Neutral': '⚖️'
+                }
+            },
+            // Legacy fields kept for backward compatibility
             relationshipFields: ['Lover', 'Friend', 'Ally', 'Enemy', 'Neutral'],
-            // Relationship to emoji mapping (shown on character portraits)
             relationshipEmojis: {
                 'Lover': '❤️',
                 'Friend': '⭐',
@@ -123,14 +213,15 @@ export let extensionSettings = {
             },
             // Custom fields (appearance, demeanor, etc. - shown after relationship, separated by |)
             customFields: [
-                { id: 'appearance', name: 'Appearance', enabled: true, description: 'Visible physical appearance (clothing, hair, notable features)' },
-                { id: 'demeanor', name: 'Demeanor', enabled: true, description: 'Observable demeanor or emotional state' }
+                { id: 'appearance', name: 'Appearance', enabled: true, description: 'Visible physical appearance (clothing, hair, notable features)', persistInHistory: false },
+                { id: 'demeanor', name: 'Demeanor', enabled: true, description: 'Observable demeanor or emotional state', persistInHistory: false }
             ],
             // Thoughts configuration (separate line)
             thoughts: {
                 enabled: true,
                 name: 'Thoughts',
-                description: 'Internal monologue (in first person POV, up to three sentences long)'
+                description: 'Internal Monologue (in first person from character\'s POV, up to three sentences long)',
+                persistInHistory: false
             },
             // Character stats toggle (optional feature)
             characterStats: {
@@ -146,6 +237,16 @@ export let extensionSettings = {
         main: "None",        // Current main quest title
         optional: []         // Array of optional quest titles
     },
+    infoBox: JSON.stringify({
+        date: { value: new Date().toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }) },
+        weather: { emoji: '☀️', forecast: 'Clear skies' },
+        temperature: { value: 20, unit: 'C' },
+        time: { start: '00:00', end: '00:00' },
+        location: { value: 'Unknown Location' }
+    }, null, 2),
+    characterThoughts: JSON.stringify({
+        characters: []
+    }, null, 2),
     level: 1, // User's character level
     classicStats: {
         str: 10,
@@ -156,14 +257,67 @@ export let extensionSettings = {
         cha: 10
     },
     lastDiceRoll: null, // Store last dice roll result
+    showDiceDisplay: true, // Show the "Last Roll" display in the panel
     collapsedInventoryLocations: [], // Array of collapsed storage location names
     inventoryViewModes: {
         onPerson: 'list', // 'list' or 'grid' view mode for On Person section
         stored: 'list',   // 'list' or 'grid' view mode for Stored section
         assets: 'list'    // 'list' or 'grid' view mode for Assets section
     },
-    debugMode: false, // Enable debug logging visible in UI (for mobile debugging)
-    memoryMessagesToProcess: 16 // Number of messages to process per batch in memory recollection
+    npcAvatars: {}, // Store custom avatar images for NPCs (key: character name, value: base64 data URI)
+    // Combat encounter settings
+    encounterSettings: {
+        enabled: true, // Show Start Encounter button above chat input
+        historyDepth: 8, // Number of recent messages to include in combat initialization
+        autoSaveLogs: false // Save detailed combat logs to file
+    },
+    // Auto avatar generation settings
+    autoGenerateAvatars: true, // Master toggle for auto-generating avatars
+    avatarLLMCustomInstruction: '', // Custom instruction for LLM prompt generation
+    // External API settings for 'external' generation mode
+    externalApiSettings: {
+        baseUrl: '',           // OpenAI-compatible API base URL (e.g., "https://api.openai.com/v1")
+        // apiKey is NOT stored here for security. It is stored in localStorage('rpg_companion_api_key')
+        model: '',             // Model identifier (e.g., "gpt-4o-mini")
+        maxTokens: 8192,       // Maximum tokens for generation
+        temperature: 0.7       // Temperature setting for generation
+    },
+    // Lock state for tracker items (v3 JSON format feature)
+    lockedItems: {
+        stats: [],              // Array of locked stat IDs (e.g., ["health", "satiety"])
+        skills: [],             // Array of locked skill names (e.g., ["Cooking", "Swordsmanship"])
+        inventory: {
+            onPerson: [],       // Array of locked item indices (e.g., [0, 2])
+            clothing: [],       // Array of locked item indices
+            stored: {},         // Object with location keys, each containing array of locked indices (e.g., {"Home": [0, 1]})
+            assets: []          // Array of locked asset indices
+        },
+        quests: {
+            main: false,        // Boolean for main quest lock
+            optional: []        // Array of locked optional quest indices (e.g., [0, 2])
+        },
+        infoBox: {
+            date: false,        // Boolean for date widget lock
+            weather: false,     // Boolean for weather widget lock
+            temperature: false, // Boolean for temperature widget lock
+            time: false,        // Boolean for time widget lock
+            location: false,    // Boolean for location widget lock
+            recentEvents: false // Boolean for recent events widget lock
+        },
+        characters: {}          // Object mapping character names to their locked fields (e.g., {"Sarah": {relationship: true, thoughts: false}})
+    },
+    // Preset management for tracker configurations
+    presetManager: {
+        // Map of preset ID to preset data (contains name and trackerConfig)
+        presets: {},
+        // Map of character/group entity to preset ID (e.g., "char_0": "preset_123", "group_abc": "preset_456")
+        // Note: This is stored separately and NOT exported with presets
+        characterAssociations: {},
+        // Currently active preset ID
+        activePresetId: null,
+        // Default preset ID (used when no character association exists)
+        defaultPresetId: null
+    }
 };
 
 /**
@@ -186,6 +340,25 @@ export let committedTrackerData = {
     characterThoughts: null
 };
 
+/**
+ * Session-only storage for LLM-generated avatar prompts
+ * Maps character names to their generated prompts
+ * Resets on new chat (not persisted to extensionSettings)
+ */
+export let sessionAvatarPrompts = {};
+
+export function setSessionAvatarPrompt(characterName, prompt) {
+    sessionAvatarPrompts[characterName] = prompt;
+}
+
+export function getSessionAvatarPrompt(characterName) {
+    return sessionAvatarPrompts[characterName] || null;
+}
+
+export function clearSessionAvatarPrompts() {
+    sessionAvatarPrompts = {};
+}
+
 /**
  * Tracks whether the last action was a swipe (for separate mode)
  * Used to determine whether to commit lastGeneratedData to committedTrackerData
@@ -202,6 +375,12 @@ export let isGenerating = false;
  */
 export let isPlotProgression = false;
 
+/**
+ * Flag indicating if we're actively expecting a new message from generation
+ * (as opposed to loading chat history)
+ */
+export let isAwaitingNewMessage = false;
+
 /**
  * Temporary storage for pending dice roll (not saved until user clicks "Save Roll")
  */
@@ -248,6 +427,7 @@ export let $infoBoxContainer = null;
 export let $thoughtsContainer = null;
 export let $inventoryContainer = null;
 export let $questsContainer = null;
+export let $musicPlayerContainer = null;
 
 /**
  * State setters - provide controlled mutation of state variables
@@ -269,11 +449,24 @@ export function updateLastGeneratedData(updates) {
 }
 
 export function setCommittedTrackerData(data) {
+    // console.log('[RPG State] setCommittedTrackerData called with:', data);
+    // console.log('[RPG State] Type check on input:', {
+    //     userStatsType: typeof data.userStats,
+    //     infoBoxType: typeof data.infoBox,
+    //     characterThoughtsType: typeof data.characterThoughts,
+    //     userStatsValue: data.userStats,
+    //     infoBoxValue: data.infoBox,
+    //     characterThoughtsValue: data.characterThoughts
+    // });
     committedTrackerData = data;
+    // console.log('[RPG State] committedTrackerData after assignment:', committedTrackerData);
 }
 
 export function updateCommittedTrackerData(updates) {
+    // console.log('[RPG State] updateCommittedTrackerData called with:', updates);
+    // console.log('[RPG State] committedTrackerData before update:', committedTrackerData);
     Object.assign(committedTrackerData, updates);
+    // console.log('[RPG State] committedTrackerData after update:', committedTrackerData);
 }
 
 export function setLastActionWasSwipe(value) {
@@ -288,6 +481,10 @@ export function setIsPlotProgression(value) {
     isPlotProgression = value;
 }
 
+export function setIsAwaitingNewMessage(value) {
+    isAwaitingNewMessage = value;
+}
+
 export function setPendingDiceRoll(roll) {
     pendingDiceRoll = roll;
 }
@@ -319,3 +516,7 @@ export function setInventoryContainer($element) {
 export function setQuestsContainer($element) {
     $questsContainer = $element;
 }
+
+export function setMusicPlayerContainer($element) {
+    $musicPlayerContainer = $element;
+}

src/i18n/en.json

@@ -1,165 +1,242 @@
-{
-    "settings.language.label": "Language",
-    "settings.language.option.en": "English",
-    "settings.language.option.zh-tw": "繁體中文",
-    "settings.extensionEnabled": "Enable RPG Companion",
-    "settings.note": "Toggle to enable/disable the RPG Companion extension. Configure additional settings within the panel itself.",
-    "template.settingsTitle": "RPG Companion Settings",
-    "template.settingsModal.themeTitle": "Theme",
-    "template.settingsModal.themeLabel": "Visual Theme:",
-    "template.settingsModal.themeOptions.default": "Default",
-    "template.settingsModal.themeOptions.sciFi": "Sci-Fi (Synthwave)",
-    "template.settingsModal.themeOptions.fantasy": "Fantasy (Rustic Parchment)",
-    "template.settingsModal.themeOptions.cyberpunk": "Cyberpunk (Neon Grid)",
-    "template.settingsModal.themeOptions.custom": "Custom",
-    "template.settingsModal.themeOptions.custom.background": "Background:",
-    "template.settingsModal.themeOptions.custom.accent": "Accent:",
-    "template.settingsModal.themeOptions.custom.text": "Text:",
-    "template.settingsModal.themeOptions.custom.highlight": "Highlight:",
-    "template.settingsModal.theme.statBarLow": "Stat Bar Color (Low):",
-    "template.settingsModal.theme.statBarLowNote": "Color when stats are at 0%",
-    "template.settingsModal.theme.statBarHigh": "Stat Bar Color (High):",
-    "template.settingsModal.theme.statBarHighNote": "Color when stats are at 100%",
-    "template.settingsModal.displayTitle": "Display Options",
-    "template.settingsModal.displayNote": "Use the Extensions tab to enable/disable the RPG Companion extension.",
-    "template.settingsModal.display.panelPosition": "Panel Position:",
-    "template.settingsModal.display.panelPositionOptions.right": "Right Sidebar",
-    "template.settingsModal.display.panelPositionOptions.left": "Left Sidebar",
-    "template.settingsModal.display.toggleAutoUpdate": "Auto-update after messages",
-    "template.settingsModal.display.showUserStats": "Show User Stats",
-    "template.settingsModal.display.showInfoBox": "Show Info Box",
-    "template.settingsModal.display.showPresentCharacters": "Show Present Characters",
-    "template.settingsModal.display.showInventory": "Show Inventory",
-    "template.settingsModal.display.showThoughtsInChat": "Show Thoughts in Chat",
-    "template.settingsModal.display.showThoughtsInChatNote": "Display character thoughts as overlay bubbles next to their messages",
-    "template.settingsModal.display.alwaysShowThoughtBubble": "Always Show Thought Bubble",
-    "template.settingsModal.display.alwaysShowThoughtBubbleNote": "Auto-expand thought bubble without clicking the icon first",
-    "template.settingsModal.display.enableAnimations": "Enable Animations",
-    "template.settingsModal.display.enableAnimationsNote": "Smooth transitions for stats, content updates, and dice rolls",
-    "template.settingsModal.display.showPlotProgressionButtons": "Show Plot Progression Buttons",
-    "template.settingsModal.display.showPlotProgressionButtonsNote": "Display buttons above chat input for plot progression prompts",
-    "template.settingsModal.display.enableDebugMode": "Enable Debug Mode",
-    "template.settingsModal.display.enableDebugModeNote": "Shows parser logs in a mobile-friendly UI panel. Useful for troubleshooting. Look for the red bug button.",
-    "template.settingsModal.advancedTitle": "Advanced",
-    "template.settingsModal.advanced.generationMode": "Generation Mode:",
-    "template.settingsModal.advanced.generationModeOptions.together": "Together with Main Generation",
-    "template.settingsModal.advanced.generationModeOptions.separate": "Separate Generation",
-    "template.settingsModal.advanced.generationModeNote": "Together: Adds RPG tracking to main roleplay. Separate: Generates RPG data separately (manual or auto).",
-    "template.settingsModal.advanced.contextMessages": "Context Messages:",
-    "template.settingsModal.advanced.contextMessagesNote": "Number of recent messages to include (Separate mode only)",
-    "template.settingsModal.advanced.memoryBatchSize": "Memory Batch Size:",
-    "template.settingsModal.advanced.memoryBatchSizeNote": "Number of messages to process per batch in Memory Recollection",
-    "template.settingsModal.advanced.useSeparatePreset": "Use model connected to RPG Companion Trackers preset",
-    "template.settingsModal.advanced.useSeparatePresetNote": "Separate mode only. When enabled, tracker generation will use the model from the \"RPG Companion Trackers\" preset instead of your main API model. The preset will be switched automatically during generation and restored afterward. Select the desired model in that preset and make sure the \"Bind presets to API connections\" toggle is on (next to the import/export preset buttons).",
-    "template.settingsModal.advanced.skipInjections": "Skip Injections during Guided Generations:",
-    "template.settingsModal.advanced.skipInjectionsOptions.none": "Never skip",
-    "template.settingsModal.advanced.skipInjectionsOptions.impersonation": "Only on impersonation requests",
-    "template.settingsModal.advanced.skipInjectionsOptions.guided": "Always for guided or quiet prompts",
-    "template.settingsModal.advanced.skipInjectionsNote": "When set, the extension will not inject tracker prompts, examples, or HTML instructions according to the selected mode when a guided generation (via `instruct` or `quiet_prompt`) is detected. Useful when using GuidedGenerations or similar extensions.",
-    "template.settingsModal.advanced.customHtmlPromptTitle": "Custom HTML Prompt:",
-    "template.settingsModal.advanced.restoreDefaultHtmlPrompt": "Restore Default",
-    "template.settingsModal.advanced.customHtmlPromptNote": "Customize the HTML prompt injected when \"Enable Immersive HTML\" is enabled. The default prompt is shown above - you can edit it directly or replace it entirely. Click \"Restore Default\" to reset. This affects all generation modes (together, separate, and plot progression).",
-    "template.settingsModal.advanced.clearCache": "Clear Extension Cache",
-    "template.settingsModal.advanced.resetFabPositions": "Reset Button Positions",
-    "template.settingsModal.advanced.resetFabPositionsNote": "Resets all floating action buttons (toggle, refresh, debug) to default top-left positions. Useful if buttons are off-screen.",
-    "template.trackerEditorModal.title": "Edit Trackers",
-    "template.trackerEditorModal.tabs.userStats": "User Stats",
-    "template.trackerEditorModal.tabs.infoBox": "Info Box",
-    "template.trackerEditorModal.tabs.presentCharacters": "Present Characters",
-    "template.trackerEditorModal.buttons.reset": "Reset to Defaults",
-    "template.trackerEditorModal.buttons.cancel": "Cancel",
-    "template.trackerEditorModal.buttons.save": "Save & Apply",
-    "template.trackerEditorModal.userStatsTab.customStatsTitle": "Custom Stats",
-    "template.trackerEditorModal.userStatsTab.addCustomStatButton": "Add Custom Stat",
-    "template.trackerEditorModal.userStatsTab.rpgAttributesTitle": "RPG Attributes",
-    "template.trackerEditorModal.userStatsTab.enableRpgAttributes": "Enable RPG Attributes Section",
-    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributes": "Always Include Attributes in Prompt",
-    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributesNote": "If disabled, attributes are only sent when a dice roll is active.",
-    "template.trackerEditorModal.userStatsTab.addAttributeButton": "Add Attribute",
-    "template.trackerEditorModal.userStatsTab.statusSectionTitle": "Status Section",
-    "template.trackerEditorModal.userStatsTab.enableStatusSection": "Enable Status Section",
-    "template.trackerEditorModal.userStatsTab.showMoodEmoji": "Show Mood Emoji",
-    "template.trackerEditorModal.userStatsTab.statusFieldsLabel": "Status Fields (comma-separated):",
-    "template.trackerEditorModal.userStatsTab.skillsSectionTitle": "Skills Section",
-    "template.trackerEditorModal.userStatsTab.enableSkillsSection": "Enable Skills Section",
-    "template.trackerEditorModal.userStatsTab.skillsLabelLabel": "Skills Label:",
-    "template.trackerEditorModal.userStatsTab.skillsListLabel": "Skills List (comma-separated):",
-    "template.trackerEditorModal.infoBoxTab.widgetsTitle": "Widgets",
-    "template.trackerEditorModal.infoBoxTab.dateWidget": "Date",
-    "template.trackerEditorModal.infoBoxTab.weatherWidget": "Weather",
-    "template.trackerEditorModal.infoBoxTab.temperatureWidget": "Temperature",
-    "template.trackerEditorModal.infoBoxTab.timeWidget": "Time",
-    "template.trackerEditorModal.infoBoxTab.locationWidget": "Location",
-    "template.trackerEditorModal.infoBoxTab.recentEventsWidget": "Recent Events",
-    "template.trackerEditorModal.presentCharactersTab.relationshipStatusTitle": "Relationship Status Fields",
-    "template.trackerEditorModal.presentCharactersTab.relationshipStatusHint": "Define relationship types with corresponding emojis shown on character portraits",
-    "template.trackerEditorModal.presentCharactersTab.newRelationshipButton": "New Relationship",
-    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorTitle": "Appearance/Demeanor Fields",
-    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorHint": "Fields shown below character name, separated by |",
-    "template.trackerEditorModal.presentCharactersTab.addCustomFieldButton": "Add Custom Field",
-    "template.trackerEditorModal.presentCharactersTab.thoughtsConfigTitle": "Thoughts Configuration",
-    "template.trackerEditorModal.presentCharactersTab.enableCharacterThoughts": "Enable Character Thoughts",
-    "template.trackerEditorModal.presentCharactersTab.thoughtsLabelLabel": "Thoughts Label:",
-    "template.trackerEditorModal.presentCharactersTab.aiInstructionLabel": "AI Instruction:",
-    "template.trackerEditorModal.presentCharactersTab.characterStatsTitle": "Character Stats",
-    "template.trackerEditorModal.presentCharactersTab.trackCharacterStats": "Track Character Stats",
-    "template.trackerEditorModal.presentCharactersTab.characterStatsHint": "Create stats to track for each character (displayed as colored bars)",
-    "template.trackerEditorModal.presentCharactersTab.addCharacterStatButton": "Add Character Stat",
-    "template.mainPanel.title": "RPG Companion",
-    "template.mainPanel.lastRoll": "Last Roll:",
-    "template.mainPanel.clearLastRoll": "Clear last roll",
-    "template.mainPanel.enableImmersiveHtml": "Enable Immersive HTML",
-    "template.mainPanel.refreshRpgInfo": "Refresh RPG Info",
-    "template.mainPanel.updating": "Updating...",
-    "template.mainPanel.editTrackersButton": "Edit Trackers",
-    "template.mainPanel.settingsButton": "Settings",
-    "global.none": "None",
-    "global.add": "Add",
-    "global.cancel": "Cancel",
-    "global.listView": "List view",
-    "global.gridView": "Grid view",
-    "global.save": "Save",
-    "global.status":"Status",
-    "global.inventory":"Inventory",
-    "global.quests":"Quests",
-    "global.info":"Info",
-    "infobox.noData.title": "No data yet",
-    "infobox.noData.instruction": "Generate a new response in the roleplay or switch to \"Separate Generation\" in Settings to access and click the \"Refresh RPG Info\" button",
-    "infobox.recentEvents.title": "Recent Events",
-    "infobox.recentEvents.addEventPlaceholder": "Add event...",
-    "inventory.section.onPerson": "On Person",
-    "inventory.section.stored": "Stored",
-    "inventory.section.assets": "Assets",
-    "inventory.onPerson.empty": "No items carried",
-    "inventory.onPerson.title": "Items Currently Carried",
-    "inventory.onPerson.addItemButton": "Add Item",
-    "inventory.onPerson.addItemPlaceholder": "Enter item name...",
-    "inventory.stored.title": "Storage Locations",
-    "inventory.stored.addLocationButton": "Add Location",
-    "inventory.stored.addLocationPlaceholder": "Enter location name...",
-    "inventory.stored.saveButton": "Save",
-    "inventory.stored.empty": "No storage locations yet. Click \"Add Location\" to create one.",
-    "inventory.stored.noItems": "No items stored here",
-    "inventory.stored.addItemToLocationPlaceholder": "Enter item name...",
-    "inventory.stored.addItemButton": "Add Item",
-    "inventory.stored.confirmRemoveLocationMessage": "Remove \"${location}\"? This will delete all items stored there.",
-    "inventory.stored.confirmRemoveLocationConfirmButton": "Confirm",
-    "inventory.assets.empty": "No assets owned",
-    "inventory.assets.title": "Vehicles, Property & Major Possessions",
-    "inventory.assets.addAssetModalTitle": "Add Asset",
-    "inventory.assets.addAssetButton": "Add Asset",
-    "inventory.assets.addAssetPlaceholder": "Enter asset name...",
-    "inventory.assets.description": "Assets include vehicles (cars, motorcycles), property (homes, apartments), and major equipment (workshop tools, special items).",
-    "quests.section.main": "Main Quest",
-    "quests.section.optional": "Optional Quests",
-    "quests.main.title": "Main Quests",
-    "quests.main.addQuestButton": "Add Quest",
-    "quests.main.addQuestPlaceholder": "Enter main quest title...",
-    "quests.main.empty": "No active main quests",
-    "quests.main.hint": "The main quest represents your primary objective in the story.",
-    "quests.optional.title": "Optional Quests",
-    "quests.optional.addQuestButton": "Add Quest",
-    "quests.optional.addQuestPlaceholder": "Enter optional quest title...",
-    "quests.optional.empty": "No active optional quests",
-    "quests.optional.hint": "Optional quests are side objectives that complement your main story."
-}
+{
+    "settings.language.label": "Language",
+    "settings.language.option.en": "English",
+    "settings.language.option.zh-tw": "繁體中文",
+    "settings.language.option.ru": "Русский",
+    "settings.extensionEnabled": "Enable RPG Companion",
+    "settings.note": "Toggle to enable/disable the RPG Companion extension. Configure additional settings within the panel itself.",
+    "template.settingsTitle": "RPG Companion Settings",
+    "template.settingsModal.themeTitle": "Theme",
+    "template.settingsModal.themeLabel": "Visual Theme:",
+    "template.settingsModal.themeOptions.default": "Default",
+    "template.settingsModal.themeOptions.sciFi": "Sci-Fi (Synthwave)",
+    "template.settingsModal.themeOptions.fantasy": "Fantasy (Rustic Parchment)",
+    "template.settingsModal.themeOptions.cyberpunk": "Cyberpunk (Neon Grid)",
+    "template.settingsModal.themeOptions.custom": "Custom",
+    "template.settingsModal.themeOptions.custom.background": "Background:",
+    "template.settingsModal.themeOptions.custom.accent": "Accent:",
+    "template.settingsModal.themeOptions.custom.text": "Text:",
+    "template.settingsModal.themeOptions.custom.highlight": "Highlight:",
+    "template.settingsModal.theme.statBarLow": "Stat Bar Color (Low):",
+    "template.settingsModal.theme.statBarLowNote": "Color when stats are at 0%.",
+    "template.settingsModal.theme.statBarHigh": "Stat Bar Color (High):",
+    "template.settingsModal.theme.statBarHighNote": "Color when stats are at 100%.",
+    "template.settingsModal.displayTitle": "Display Options",
+    "template.settingsModal.displayNote": "You can enable/disable the entire RPG Companion extension in the Extensions tab of the SillyTavern.",
+    "template.settingsModal.display.panelPosition": "Panel Position:",
+    "template.settingsModal.display.panelPositionOptions.right": "Right Sidebar",
+    "template.settingsModal.display.panelPositionOptions.left": "Left Sidebar",
+    "template.settingsModal.display.toggleAutoUpdate": "Auto-update after messages",
+    "template.settingsModal.display.toggleAutoUpdateNote": "Automatically refresh RPG info after each message.",
+    "template.settingsModal.display.showUserStats": "Show User Stats",
+    "template.settingsModal.display.showUserStatsNote": "Enable User Stats that track your persona's statistics, mood, attributes, skills, etc.",
+    "template.settingsModal.display.showInfoBox": "Show Info Box",
+    "template.settingsModal.display.showInfoBoxNote": "Display location, time, weather, and recent events.",
+    "template.settingsModal.display.showPresentCharacters": "Show Present Characters",
+    "template.settingsModal.display.showPresentCharactersNote": "Display character portraits with their current thoughts and status.",
+    "template.settingsModal.display.narratorMode": "Narrator Mode",
+    "template.settingsModal.display.narratorModeNote": "Use character card as narrator. Infer characters from context instead of using fixed character references.",
+    "template.settingsModal.display.showInventory": "Show Inventory",
+    "template.settingsModal.display.showInventoryNote": "Track items carried, clothing worn, stored items, and assets.",
+    "template.settingsModal.display.showQuests": "Show Quests",
+    "template.settingsModal.display.showQuestsNote": "Manage main and optional quests with objectives.",
+    "template.settingsModal.display.showLockIcons": "Show Locking/Unlocking Trackers",
+    "template.settingsModal.display.showLockIconsNote": "Display lock/unlock icons on tracker items to prevent AI from modifying them.",
+    "template.settingsModal.display.showThoughtsInChat": "Show Thoughts",
+    "template.settingsModal.display.showThoughtsInChatNote": "Display character thoughts as overlay bubbles next to their messages.",
+    "template.settingsModal.display.alwaysShowThoughtBubble": "Always Show Thought Bubble",
+    "template.settingsModal.display.alwaysShowThoughtBubbleNote": "Auto-expand thought bubble without clicking the icon first",
+    "template.settingsModal.display.enableAnimations": "Enable Animations",
+    "template.settingsModal.display.enableAnimationsNote": "Smooth transitions for stats, content updates, and dice rolls.",
+    "template.settingsModal.display.showImmersiveHtmlToggle": "Show Immersive HTML",
+    "template.settingsModal.display.showImmersiveHtmlToggleNote": "Display a toggle button to enable/disable HTML formatting in messages.",
+    "template.settingsModal.display.showDialogueColoringToggle": "Show Colored Dialogues",
+    "template.settingsModal.display.showDialogueColoringToggleNote": "Display a toggle button to enable/disable colored dialogue formatting.",
+    "template.settingsModal.display.showDeceptionToggle": "Show Deception System",
+    "template.settingsModal.display.showDeceptionToggleNote": "Display a toggle button to enable/disable the Deception System for marking lies and deceptions.",
+    "template.settingsModal.display.showOmniscienceToggle": "Show Omniscience Filter",
+    "template.settingsModal.display.showOmniscienceToggleNote": "Display a toggle button to enable/disable the Omniscience Filter for filtering hidden events.",
+    "template.settingsModal.display.showSpotifyMusicToggle": "Show Spotify Music",
+    "template.settingsModal.display.showSpotifyMusicToggleNote": "Display Spotify music player with AI-suggested scene-appropriate tracks.",
+    "template.settingsModal.display.showSnowflakesToggle": "Show Snowflakes Effect",
+    "template.settingsModal.display.showDynamicWeatherToggle": "Show Dynamic Weather Effects",
+    "template.settingsModal.display.showDynamicWeatherToggleNote": "Display a toggle button to enable/disable animated weather effects.",
+    "template.settingsModal.display.showNarratorMode": "Show Narrator Mode",
+    "template.settingsModal.display.showNarratorModeNote": "Display a toggle button to enable/disable narrator mode (infer characters from context).",
+    "template.settingsModal.display.showAutoAvatars": "Show Auto-generate Avatars",
+    "template.settingsModal.display.showAutoAvatarsNote": "Display a toggle button to automatically generate avatars for characters without images.",
+    "template.settingsModal.display.showRandomizedPlot": "Show Randomized Plot Progression",
+    "template.settingsModal.display.showRandomizedPlotNote": "Display button for AI-generated random plot progression prompts.",
+    "template.settingsModal.display.showNaturalPlot": "Show Natural Plot Progression",
+    "template.settingsModal.display.showNaturalPlotNote": "Display button for context-aware narrative continuation prompts.",
+    "template.settingsModal.display.showStartEncounter": "Show Start Encounter",
+    "template.settingsModal.display.showStartEncounterNote": "Display button to initiate interactive combat encounters.",
+    "template.settingsModal.display.showDiceDisplay": "Show Dice Roll Display",
+    "template.settingsModal.display.showDiceDisplayNote": "Display the \"Last Roll\" indicator in the panel.",
+    "template.mainPanel.autoAvatars": "Auto Avatars",
+    "template.settingsModal.advancedTitle": "Advanced",
+    "template.settingsModal.advanced.encounterHistoryDepth": "Chat History Depth For Encounters:",
+    "template.settingsModal.advanced.encounterHistoryDepthNote": "Number of recent messages to include in combat initialization.",
+    "template.settingsModal.advanced.autoSaveCombatLogs": "Auto-save Combat Logs",
+    "template.settingsModal.advanced.autoSaveCombatLogsNote": "Save detailed combat logs to file for future reference and analysis.",
+    "template.settingsModal.advanced.clearCacheNote": "Clears committed and displayed tracker data for your currently active chat.",
+    "template.settingsModal.advanced.generationMode": "Generation Mode:",
+    "template.settingsModal.advanced.generationModeOptions.together": "Together with Main Generation",
+    "template.settingsModal.advanced.generationModeOptions.separate": "Separate Generation",
+    "template.settingsModal.advanced.generationModeNote": "Together: Adds RPG tracking to main roleplay. Separate: Generates RPG data separately (manual or auto). External: Connects to an OpenAI-compatible endpoint directly.",
+    "template.settingsModal.advanced.generationModeOptions.external": "External API",
+    "template.settingsModal.advanced.externalApi.title": "External API Settings",
+    "template.settingsModal.advanced.externalApi.baseUrl": "API Base URL",
+    "template.settingsModal.advanced.externalApi.baseUrlNote": "OpenAI-compatible endpoint (e.g., OpenAI, OpenRouter, local LLM server).",
+    "template.settingsModal.advanced.externalApi.apiKey": "API Key",
+    "template.settingsModal.advanced.externalApi.apiKeyNote": "Your API key for the external service.",
+    "template.settingsModal.advanced.externalApi.model": "Model",
+    "template.settingsModal.advanced.externalApi.modelNote": "Model identifier (e.g., gpt-4o-mini, claude-3-haiku, mistral-7b).",
+    "template.settingsModal.advanced.externalApi.maxTokens": "Max Tokens",
+    "template.settingsModal.advanced.externalApi.temperature": "Temperature",
+    "template.settingsModal.advanced.externalApi.testConnection": "Test Connection",
+    "template.settingsModal.advanced.contextMessages": "Context Messages:",
+    "template.settingsModal.advanced.contextMessagesNote": "Number of recent messages to include.",
+    "template.settingsModal.advanced.useSeparatePreset": "Use model connected to RPG Companion Trackers preset",
+    "template.settingsModal.advanced.useSeparatePresetNote": "When enabled, tracker generation will use the model from the \"RPG Companion Trackers\" preset instead of your main API model. The preset will be switched automatically during generation and restored afterward. Select the desired model in that preset and make sure the \"Bind presets to API connections\" toggle is on (next to the import/export preset buttons).",
+    "template.settingsModal.advanced.skipInjections": "Skip Injections During Guided Generations:",
+    "template.settingsModal.advanced.skipInjectionsOptions.none": "Never skip",
+    "template.settingsModal.advanced.skipInjectionsOptions.impersonation": "Only on impersonation requests",
+    "template.settingsModal.advanced.skipInjectionsOptions.guided": "Always for guided or quiet prompts",
+    "template.settingsModal.advanced.skipInjectionsNote": "When set, the extension will not inject tracker prompts, examples, or HTML instructions according to the selected mode when a guided generation (via `instruct` or `quiet_prompt`) is detected. Useful when using GuidedGenerations or similar extensions.",
+    "template.settingsModal.advanced.customHtmlPromptTitle": "Custom HTML Prompt:",
+    "template.settingsModal.advanced.restoreDefaultHtmlPrompt": "Restore Default",
+    "template.settingsModal.advanced.customHtmlPromptNote": "Customize the HTML prompt injected when \"Enable Immersive HTML\" is enabled. The default prompt is shown above - you can edit it directly or replace it entirely. Click \"Restore Default\" to reset. This affects all generation modes (together, separate, and plot progression).",
+    "template.settingsModal.advanced.clearCache": "Clear Extension Cache",
+    "template.settingsModal.advanced.resetFabPositions": "Reset Button Positions",
+    "template.settingsModal.advanced.resetFabPositionsNote": "Resets all floating action buttons (toggle, refresh, debug) to default top-left positions. Useful if buttons are off-screen.",
+    "template.trackerEditorModal.title": "Edit Trackers",
+    "template.trackerEditorModal.tabs.userStats": "User Stats",
+    "template.trackerEditorModal.tabs.infoBox": "Info Box",
+    "template.trackerEditorModal.tabs.presentCharacters": "Present Characters",
+    "template.trackerEditorModal.buttons.reset": "Reset",
+    "template.trackerEditorModal.buttons.cancel": "Cancel",
+    "template.trackerEditorModal.buttons.save": "Save & Apply",
+    "template.trackerEditorModal.buttons.export": "Export",
+    "template.trackerEditorModal.buttons.import": "Import",
+    "template.trackerEditorModal.messages.exportSuccess": "Tracker preset exported successfully!",
+    "template.trackerEditorModal.messages.exportError": "Failed to export tracker preset. Check console for details.",
+    "template.trackerEditorModal.messages.importSuccess": "Tracker preset imported successfully!",
+    "template.trackerEditorModal.messages.importError": "Failed to import tracker preset",
+    "template.trackerEditorModal.messages.importConfirm": "This will replace your current tracker configuration. Continue?",
+    "template.trackerEditorModal.userStatsTab.customStatsTitle": "Custom Stats",
+    "template.trackerEditorModal.userStatsTab.addCustomStatButton": "Add Custom Stat",
+    "template.trackerEditorModal.userStatsTab.rpgAttributesTitle": "RPG Attributes",
+    "template.trackerEditorModal.userStatsTab.enableRpgAttributes": "Enable RPG Attributes Section",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributes": "Always Include Attributes in Prompt",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributesNote": "If disabled, attributes are only sent when a dice roll is active.",
+    "template.trackerEditorModal.userStatsTab.addAttributeButton": "Add Attribute",
+    "template.trackerEditorModal.userStatsTab.statusSectionTitle": "Status Section",
+    "template.trackerEditorModal.userStatsTab.enableStatusSection": "Enable Status Section",
+    "template.trackerEditorModal.userStatsTab.showMoodEmoji": "Show Mood Emoji",
+    "template.trackerEditorModal.userStatsTab.statusFieldsLabel": "Status Fields (comma-separated):",
+    "template.trackerEditorModal.userStatsTab.skillsSectionTitle": "Skills Section",
+    "template.trackerEditorModal.userStatsTab.enableSkillsSection": "Enable Skills Section",
+    "template.trackerEditorModal.userStatsTab.skillsLabelLabel": "Skills Label:",
+    "template.trackerEditorModal.userStatsTab.skillsListLabel": "Skills List (comma-separated):",
+    "template.trackerEditorModal.infoBoxTab.widgetsTitle": "Widgets",
+    "template.trackerEditorModal.infoBoxTab.dateWidget": "Date",
+    "template.trackerEditorModal.infoBoxTab.weatherWidget": "Weather",
+    "template.trackerEditorModal.infoBoxTab.temperatureWidget": "Temperature",
+    "template.trackerEditorModal.infoBoxTab.timeWidget": "Time",
+    "template.trackerEditorModal.infoBoxTab.locationWidget": "Location",
+    "template.trackerEditorModal.infoBoxTab.recentEventsWidget": "Recent Events",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusTitle": "Relationship Status Fields",
+    "template.trackerEditorModal.presentCharactersTab.enableRelationshipStatus": "Enable Relationship Status Fields",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusHint": "Define relationship types with corresponding emojis shown on character portraits.",
+    "template.trackerEditorModal.presentCharactersTab.newRelationshipButton": "New Relationship",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorTitle": "Appearance/Demeanor Fields",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorHint": "Fields shown below character name.",
+    "template.trackerEditorModal.presentCharactersTab.addCustomFieldButton": "Add Custom Field",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsConfigTitle": "Thoughts Configuration",
+    "template.trackerEditorModal.presentCharactersTab.enableCharacterThoughts": "Enable Character Thoughts",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsLabelLabel": "Thoughts Label:",
+    "template.trackerEditorModal.presentCharactersTab.aiInstructionLabel": "AI Instruction:",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsTitle": "Character Stats",
+    "template.trackerEditorModal.presentCharactersTab.trackCharacterStats": "Track Character Stats",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsHint": "Create stats to track for each character (displayed as colored numbers).",
+    "template.trackerEditorModal.presentCharactersTab.addCharacterStatButton": "Add Character Stat",
+    "template.mainPanel.title": "RPG Companion",
+    "template.mainPanel.lastRoll": "Last Roll:",
+    "template.mainPanel.clearLastRoll": "Clear last roll",
+    "template.mainPanel.immersiveHtml": "Immersive HTML",
+    "template.mainPanel.coloredDialogues": "Colored Dialogues",
+    "template.mainPanel.deceptionSystem": "Deception System",
+    "template.mainPanel.omniscienceFilter": "Omniscience Filter",
+    "template.mainPanel.spotifyMusic": "Spotify Music",
+    "template.mainPanel.snowflakesEffect": "Snowflakes Effect",
+    "template.mainPanel.dynamicWeatherEffects": "Dynamic Weather",
+    "template.mainPanel.narratorMode": "Narrator Mode",
+    "template.mainPanel.refreshRpgInfo": "Refresh RPG Info",
+    "template.mainPanel.updating": "Updating...",
+    "template.mainPanel.editTrackersButton": "Edit Trackers",
+    "template.mainPanel.settingsButton": "Settings",
+    "global.none": "None",
+    "global.add": "Add",
+    "global.cancel": "Cancel",
+    "global.listView": "List view",
+    "global.gridView": "Grid view",
+    "global.save": "Save",
+    "global.status":"Status",
+    "global.inventory":"Inventory",
+    "global.quests":"Quests",
+    "global.info":"Info",
+    "infobox.noData.title": "No data yet",
+    "infobox.noData.instruction": "Generate a new response in the roleplay or switch to \"Separate Generation\" in Settings to access and click the \"Refresh RPG Info\" button",
+    "infobox.recentEvents.title": "Recent Events",
+    "infobox.recentEvents.addEventPlaceholder": "Add event...",
+    "inventory.section.onPerson": "On Person",
+    "inventory.section.clothing": "Clothing",
+    "inventory.section.stored": "Stored",
+    "inventory.section.assets": "Assets",
+    "inventory.onPerson.empty": "No items carried",
+    "inventory.onPerson.title": "Items Currently Carried",
+    "inventory.onPerson.addItemButton": "Add Item",
+    "inventory.onPerson.addItemPlaceholder": "Enter item name...",
+    "inventory.clothing.empty": "Not wearing anything",
+    "inventory.clothing.title": "Clothing & Armor",
+    "inventory.clothing.addItemButton": "Add Clothing",
+    "inventory.clothing.addItemPlaceholder": "Enter clothing item...",
+    "inventory.stored.title": "Storage Locations",
+    "inventory.stored.addLocationButton": "Add Location",
+    "inventory.stored.addLocationPlaceholder": "Enter location name...",
+    "inventory.stored.saveButton": "Save",
+    "inventory.stored.empty": "No storage locations yet. Click \"Add Location\" to create one.",
+    "inventory.stored.noItems": "No items stored here",
+    "inventory.stored.addItemToLocationPlaceholder": "Enter item name...",
+    "inventory.stored.addItemButton": "Add Item",
+    "inventory.stored.confirmRemoveLocationMessage": "Remove \"${location}\"? This will delete all items stored there.",
+    "inventory.stored.confirmRemoveLocationConfirmButton": "Confirm",
+    "inventory.assets.empty": "No assets owned",
+    "inventory.assets.title": "Vehicles, Property & Major Possessions",
+    "inventory.assets.addAssetModalTitle": "Add Asset",
+    "inventory.assets.addAssetButton": "Add Asset",
+    "inventory.assets.addAssetPlaceholder": "Enter asset name...",
+    "inventory.assets.description": "Assets include vehicles (cars, motorcycles), property (homes, apartments), and major equipment (workshop tools, special items).",
+    "quests.section.main": "Main Quest",
+    "quests.section.optional": "Optional Quests",
+    "quests.main.title": "Main Quests",
+    "quests.main.addQuestButton": "Add Quest",
+    "quests.main.addQuestPlaceholder": "Enter main quest title...",
+    "quests.main.empty": "No active main quests",
+    "quests.main.hint": "The main quest represents your primary objective in the story.",
+    "quests.optional.title": "Optional Quests",
+    "quests.optional.addQuestButton": "Add Quest",
+    "quests.optional.addQuestPlaceholder": "Enter optional quest title...",
+    "quests.optional.empty": "No active optional quests",
+    "quests.optional.hint": "Optional quests are side objectives that complement your main story.",
+    "checkpoint.setChapterStart": "Set Chapter Start",
+    "checkpoint.clearChapterStart": "Clear Chapter Start",
+    "checkpoint.indicator": "Chapter Start",
+    "checkpoint.tooltip": "Messages before this point are excluded from context",
+    "musicPlayer.title": "Scene Music",
+    "musicPlayer.noMusic": "AI will suggest music when appropriate for the scene",
+    "errors.parsingError": "RPG Companion Trackers' parsing error! The model returned an incorrect format. If the issue persists, consider changing the model for generations.",
+    "settings.recommendedModels.title": "Recommended Models",
+    "settings.recommendedModels.description": "For the extension to work properly, **it is not recommended to use any models below 20B, especially if they're old.** It works best with the SOTA models such as Deepseek, Claude, GPT, or Gemini."
+}

src/i18n/ru.json

@@ -0,0 +1,236 @@
+{
+    "settings.language.label": "Язык",
+    "settings.language.option.en": "English",
+    "settings.language.option.zh-tw": "繁體中文",
+    "settings.language.option.ru": "Русский",
+    "settings.extensionEnabled": "Включить RPG Companion",
+    "settings.note": "Включить или отключить расширение RPG Companion. Дополнительные настройки производятся непосредственно в панели приложения.",
+    "template.settingsTitle": "Настройки RPG Companion",
+    "template.settingsModal.themeTitle": "Тема",
+    "template.settingsModal.themeLabel": "Стиль:",
+    "template.settingsModal.themeOptions.default": "По умолчанию",
+    "template.settingsModal.themeOptions.sciFi": "Скай-фай (Synthwave)",
+    "template.settingsModal.themeOptions.fantasy": "Фэнтези (Rustic Parchment)",
+    "template.settingsModal.themeOptions.cyberpunk": "Киберпанк (Neon Grid)",
+    "template.settingsModal.themeOptions.custom": "Своя",
+    "template.settingsModal.themeOptions.custom.background": "Фон:",
+    "template.settingsModal.themeOptions.custom.accent": "Акцент:",
+    "template.settingsModal.themeOptions.custom.text": "Текст:",
+    "template.settingsModal.themeOptions.custom.highlight": "Подсветка:",
+    "template.settingsModal.theme.statBarLow": "Цвет полоски характеристики (Низкие значения):",
+    "template.settingsModal.theme.statBarLowNote": "Цвет при значении показателей 0%.",
+    "template.settingsModal.theme.statBarHigh": "Цвет полоски характеристики (Высокие значения):",
+    "template.settingsModal.theme.statBarHighNote": "Цвет при значении показателей 100%.",
+    "template.settingsModal.displayTitle": "Настройки отображения",
+    "template.settingsModal.displayNote": "Вы можете вкючить/отключить расширение RPG Companion во вкладке расширений для SillyTavern.",
+    "template.settingsModal.display.panelPosition": "Положение боковой панели:",
+    "template.settingsModal.display.panelPositionOptions.right": "Справа",
+    "template.settingsModal.display.panelPositionOptions.left": "Слева",
+    "template.settingsModal.display.toggleAutoUpdate": "Авто-обновление после ответа",
+    "template.settingsModal.display.toggleAutoUpdateNote": "Автоматически обновлять информацию в трекрере после каждого ответа.",
+    "template.settingsModal.display.showUserStats": "Показать Характеристики Игрока",
+    "template.settingsModal.display.showUserStatsNote": "Включить Характеристики Игрока, которые отслеживают статистику используемой персоны - характеристики, настроение, навыки и т.д.",
+    "template.settingsModal.display.showInfoBox": "Показывать Инфо-панель",
+    "template.settingsModal.display.showInfoBoxNote": "Отображение локации, времени, погоды и недавних событий.",
+    "template.settingsModal.display.showPresentCharacters": "Показывать персонажей",
+    "template.settingsModal.display.showPresentCharactersNote": "Показывать портреты персонажей с их текущимы мыслями и статусом.",
+    "template.settingsModal.display.narratorMode": "Режим расказчика",
+    "template.settingsModal.display.narratorModeNote": "Использовать карточку персонажа в качестве расказчика. Персонажи берутся из контекста вместо фиксированных отсылок.",
+    "template.settingsModal.display.showInventory": "Показывать инвентарь",
+    "template.settingsModal.display.showInventoryNote": "Отслеживайте переносимые предметы, одежду, хранимые вещи и активы.",
+    "template.settingsModal.display.showQuests": "Показывать задания",
+    "template.settingsModal.display.showQuestsNote": "Управляйте основными и дополнительными заданиями с целями.",
+    "template.settingsModal.display.showLockIcons": "Показывать значки блокировки/разблокировки трекеров",
+    "template.settingsModal.display.showLockIconsNote": "Отображать значки блокировки/разблокировки на элементах трекера, чтобы предотвратить их изменение ИИ.",
+    "template.settingsModal.display.showThoughtsInChat": "Показывать мысли",
+    "template.settingsModal.display.showThoughtsInChatNote": "Отображать мысли персонажей в виде всплывающих пузырьков рядом с их сообщениями.",
+    "template.settingsModal.display.alwaysShowThoughtBubble": "Всегда показывать пузырь мыслей",
+    "template.settingsModal.display.alwaysShowThoughtBubbleNote": "Автоматически раскрывать пузырь мыслей без предварительного нажатия на значок",
+    "template.settingsModal.display.enableAnimations": "Включить анимации",
+    "template.settingsModal.display.enableAnimationsNote": "Плавные переходы для характеристик, обновления контента и бросков кубиков.",
+    "template.settingsModal.display.showImmersiveHtmlToggle": "Показывать переключатель Immersive HTML",
+    "template.settingsModal.display.showImmersiveHtmlToggleNote": "Отображать кнопку переключения для включения/отключения HTML-форматирования в сообщениях.",
+    "template.settingsModal.display.showDialogueColoringToggle": "Показывать переключатель цветных диалогов",
+    "template.settingsModal.display.showDialogueColoringToggleNote": "Отображать кнопку переключения для включения/отключения цветного форматирования диалогов.",
+    "template.settingsModal.display.showSpotifyMusicToggle": "Показывать переключатель музыки Spotify",
+    "template.settingsModal.display.showSpotifyMusicToggleNote": "Отображать музыкальный проигрыватель Spotify с предложенными ИИ треками, подходящими для сцены.",
+    "template.settingsModal.display.showSnowflakesToggle": "Показывать переключатель погодных эффектов",
+    "template.settingsModal.display.showDynamicWeatherToggle": "Показывать переключатель динамических погодных эффектов",
+    "template.settingsModal.display.showDynamicWeatherToggleNote": "Отображать кнопку переключения для включения/отключения анимированных погодных эффектов.",
+    "template.settingsModal.display.showNarratorMode": "Показывать переключатель режима рассказчика",
+    "template.settingsModal.display.showNarratorModeNote": "Отображать кнопку переключения для включения/отключения режима рассказчика (персонажи определяются из контекста).",
+    "template.settingsModal.display.showAutoAvatars": "Показывать переключатель автоматической генерации аватаров",
+    "template.settingsModal.display.showAutoAvatarsNote": "Отображать кнопку переключения для автоматической генерации аватаров для персонажей без изображений.",
+    "template.settingsModal.display.showRandomizedPlot": "Показывать переключатель случайного развития сюжета",
+    "template.settingsModal.display.showRandomizedPlotNote": "Отображать кнопку для генерации ИИ случайных подсказок для развития сюжета.",
+    "template.settingsModal.display.showNaturalPlot": "Показывать переключатель естественного развития сюжета",
+    "template.settingsModal.display.showNaturalPlotNote": "Отображать кнопку для контекстно-зависимых подсказок продолжения повествования.",
+    "template.settingsModal.display.showStartEncounter": "Показывать переключатель начала встречи",
+    "template.settingsModal.display.showStartEncounterNote": "Отображать кнопку для начала интерактивных боевых столкновений.",
+    "template.settingsModal.display.showDiceDisplay": "Показывать отображение броска кубиков",
+    "template.settingsModal.display.showDiceDisplayNote": "Отображать индикатор \"Последний бросок\" на панели.",
+    "template.mainPanel.autoAvatars": "Авто-аватары",
+    "template.settingsModal.advancedTitle": "Дополнительно",
+    "template.settingsModal.advanced.encounterHistoryDepth": "Глубина истории чата для боя:",
+    "template.settingsModal.advanced.encounterHistoryDepthNote": "Количество последних сообщений, включаемых при инициализации боя.",
+    "template.settingsModal.advanced.autoSaveCombatLogs": "Автосохранение журналов боя",
+    "template.settingsModal.advanced.autoSaveCombatLogsNote": "Сохранять подробные журналы боя в файл для будущего использования и анализа.",
+    "template.settingsModal.advanced.clearCacheNote": "Очищает сохраненные и отображаемые данные трекеров для текущего активного чата.",
+    "template.settingsModal.advanced.generationMode": "Режим генерации:",
+    "template.settingsModal.advanced.generationModeOptions.together": "Вместе с основной генерацией",
+    "template.settingsModal.advanced.generationModeOptions.separate": "Отдельная генерация",
+    "template.settingsModal.advanced.generationModeNote": "Вместе: добавляет RPG-трекинг к основному ответу. Отдельно: генерирует RPG-данные отдельно (вручную или автоматически). Внешний: подключается напрямую к OpenAI-совместимому эндпоинту.",
+    "template.settingsModal.advanced.generationModeOptions.external": "Внешний API",
+    "template.settingsModal.advanced.externalApi.title": "Настройки внешнего API",
+    "template.settingsModal.advanced.externalApi.baseUrl": "Базовый URL API",
+    "template.settingsModal.advanced.externalApi.baseUrlNote": "OpenAI-совместимый эндпоинт (например, OpenAI, OpenRouter, локальный сервер LLM).",
+    "template.settingsModal.advanced.externalApi.apiKey": "API-ключ",
+    "template.settingsModal.advanced.externalApi.apiKeyNote": "Ваш API-ключ для внешнего сервиса.",
+    "template.settingsModal.advanced.externalApi.model": "Модель",
+    "template.settingsModal.advanced.externalApi.modelNote": "Идентификатор модели (например, gpt-4o-mini, claude-3-haiku, mistral-7b).",
+    "template.settingsModal.advanced.externalApi.maxTokens": "Максимальное количество токенов",
+    "template.settingsModal.advanced.externalApi.temperature": "Температура",
+    "template.settingsModal.advanced.externalApi.testConnection": "Тестировать соединение",
+    "template.settingsModal.advanced.contextMessages": "Контекстные сообщения:",
+    "template.settingsModal.advanced.contextMessagesNote": "Количество последних сообщений, включаемых в контекст.",
+    "template.settingsModal.advanced.useSeparatePreset": "Использовать модель, подключенную к пресету RPG Companion Trackers",
+    "template.settingsModal.advanced.useSeparatePresetNote": "При включении генерация трекеров будет использовать модель из пресета \"RPG Companion Trackers\" вместо основной модели API. Пресет будет автоматически переключаться во время генерации и восстанавливаться после нее. Выберите желаемую модель в этом пресете и убедитесь, что переключатель \"Bind presets to API connections\" включен (рядом с кнопками импорта/экспорта пресетов).",
+    "template.settingsModal.advanced.skipInjections": "Пропускать инъекции во время управляемых генераций:",
+    "template.settingsModal.advanced.skipInjectionsOptions.none": "Никогда не пропускать",
+    "template.settingsModal.advanced.skipInjectionsOptions.impersonation": "Только при запросах олицетворения",
+    "template.settingsModal.advanced.skipInjectionsOptions.guided": "Всегда для управляемых или тихих подсказок",
+    "template.settingsModal.advanced.skipInjectionsNote": "При установке расширение не будет внедрять подсказки трекеров, примеры или HTML-инструкции в соответствии с выбранным режимом при обнаружении управляемой генерации (через `instruct` или `quiet_prompt`). Полезно при использовании GuidedGenerations или аналогичных расширений.",
+    "template.settingsModal.advanced.customHtmlPromptTitle": "Пользовательская HTML-подсказка:",
+    "template.settingsModal.advanced.restoreDefaultHtmlPrompt": "Восстановить по умолчанию",
+    "template.settingsModal.advanced.customHtmlPromptNote": "Настройте HTML-подсказку, которая внедряется при включенной опции \"Enable Immersive HTML\". Подсказка по умолчанию показана выше - вы можете редактировать ее напрямую или полностью заменить. Нажмите \"Восстановить по умолчанию\" для сброса. Это влияет на все режимы генерации (together, separate и plot progression).",
+    "template.settingsModal.advanced.clearCache": "Очистить кэш расширения",
+    "template.settingsModal.advanced.resetFabPositions": "Сбросить позиции кнопок",
+    "template.settingsModal.advanced.resetFabPositionsNote": "Сбрасывает все плавающие кнопки действий (переключение, обновление, отладка) в позиции по умолчанию (сверху слева). Полезно, если кнопки находятся за пределами экрана.",
+    "template.trackerEditorModal.title": "Редактировать трекеры",
+    "template.trackerEditorModal.tabs.userStats": "Характеристики пользователя",
+    "template.trackerEditorModal.tabs.infoBox": "Инфо-панель",
+    "template.trackerEditorModal.tabs.presentCharacters": "Присутствующие персонажи",
+    "template.trackerEditorModal.buttons.reset": "Сбросить",
+    "template.trackerEditorModal.buttons.cancel": "Отмена",
+    "template.trackerEditorModal.buttons.save": "Сохранить и применить",
+    "template.trackerEditorModal.buttons.export": "Экспорт",
+    "template.trackerEditorModal.buttons.import": "Импорт",
+    "template.trackerEditorModal.messages.exportSuccess": "Шаблон трекеров успешно экспортирован!",
+    "template.trackerEditorModal.messages.exportError": "Не удалось экспортировать шаблон трекеров. Проверьте консоль для получения подробностей.",
+    "template.trackerEditorModal.messages.importSuccess": "Шаблон трекеров успешно импортирован!",
+    "template.trackerEditorModal.messages.importError": "Не удалось импортировать шаблон трекеров",
+    "template.trackerEditorModal.messages.importConfirm": "Это заменит текущую конфигурацию трекеров. Продолжить?",
+    "template.trackerEditorModal.userStatsTab.customStatsTitle": "Пользовательские характеристики",
+    "template.trackerEditorModal.userStatsTab.addCustomStatButton": "Добавить пользовательскую характеристику",
+    "template.trackerEditorModal.userStatsTab.rpgAttributesTitle": "RPG-атрибуты",
+    "template.trackerEditorModal.userStatsTab.enableRpgAttributes": "Включить раздел RPG-атрибутов",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributes": "Всегда включать атрибуты в подсказку",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributesNote": "Если отключено, атрибуты отправляются только при активном броске кубиков.",
+    "template.trackerEditorModal.userStatsTab.addAttributeButton": "Добавить атрибут",
+    "template.trackerEditorModal.userStatsTab.statusSectionTitle": "Раздел статуса",
+    "template.trackerEditorModal.userStatsTab.enableStatusSection": "Включить раздел статуса",
+    "template.trackerEditorModal.userStatsTab.showMoodEmoji": "Показывать эмодзи настроения",
+    "template.trackerEditorModal.userStatsTab.statusFieldsLabel": "Поля статуса (через запятую):",
+    "template.trackerEditorModal.userStatsTab.skillsSectionTitle": "Раздел навыков",
+    "template.trackerEditorModal.userStatsTab.enableSkillsSection": "Включить раздел навыков",
+    "template.trackerEditorModal.userStatsTab.skillsLabelLabel": "Метка навыков:",
+    "template.trackerEditorModal.userStatsTab.skillsListLabel": "Список навыков (через запятую):",
+    "template.trackerEditorModal.infoBoxTab.widgetsTitle": "Виджеты",
+    "template.trackerEditorModal.infoBoxTab.dateWidget": "Дата",
+    "template.trackerEditorModal.infoBoxTab.weatherWidget": "Погода",
+    "template.trackerEditorModal.infoBoxTab.temperatureWidget": "Температура",
+    "template.trackerEditorModal.infoBoxTab.timeWidget": "Время",
+    "template.trackerEditorModal.infoBoxTab.locationWidget": "Местоположение",
+    "template.trackerEditorModal.infoBoxTab.recentEventsWidget": "Недавние события",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusTitle": "Поля статуса отношений",
+    "template.trackerEditorModal.presentCharactersTab.enableRelationshipStatus": "Включить поля статуса отношений",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusHint": "Определите типы отношений с соответствующими эмодзи, отображаемыми на портретах персонажей.",
+    "template.trackerEditorModal.presentCharactersTab.newRelationshipButton": "Новое отношение",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorTitle": "Поля внешности/поведения",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorHint": "Поля, отображаемые под именем персонажа.",
+    "template.trackerEditorModal.presentCharactersTab.addCustomFieldButton": "Добавить пользовательское поле",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsConfigTitle": "Настройки мыслей",
+    "template.trackerEditorModal.presentCharactersTab.enableCharacterThoughts": "Включить мысли персонажей",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsLabelLabel": "Метка мыслей:",
+    "template.trackerEditorModal.presentCharactersTab.aiInstructionLabel": "Инструкция для ИИ:",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsTitle": "Характеристики персонажей",
+    "template.trackerEditorModal.presentCharactersTab.trackCharacterStats": "Отслеживать характеристики персонажей",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsHint": "Создавайте характеристики для отслеживания для каждого персонажа (отображаются в виде цветных полос).",
+    "template.trackerEditorModal.presentCharactersTab.addCharacterStatButton": "Добавить характеристику персонажа",
+    "template.mainPanel.title": "RPG Companion",
+    "template.mainPanel.lastRoll": "Последний бросок:",
+    "template.mainPanel.clearLastRoll": "Очистить последний бросок",
+    "template.mainPanel.immersiveHtml": "Immersive HTML",
+    "template.mainPanel.coloredDialogues": "Цветные диалоги",
+    "template.mainPanel.spotifyMusic": "Музыка Spotify",
+    "template.mainPanel.snowflakesEffect": "Эффект снежинок",
+    "template.mainPanel.dynamicWeatherEffects": "Динамическая погода",
+    "template.mainPanel.narratorMode": "Режим рассказчика",
+    "template.mainPanel.refreshRpgInfo": "Обновить RPG-информацию",
+    "template.mainPanel.updating": "Обновление...",
+    "template.mainPanel.editTrackersButton": "Редактировать трекеры",
+    "template.mainPanel.settingsButton": "Настройки",
+    "global.none": "Нет",
+    "global.add": "Добавить",
+    "global.cancel": "Отмена",
+    "global.listView": "Вид списка",
+    "global.gridView": "Вид сетки",
+    "global.save": "Сохранить",
+    "global.status": "Статус",
+    "global.inventory": "Инвентарь",
+    "global.quests": "Задания",
+    "global.info": "Информация",
+    "infobox.noData.title": "Данных пока нет",
+    "infobox.noData.instruction": "Сгенерируйте новый ответ в ролевой игре или переключитесь на \"Отдельную генерацию\" в Настройках, чтобы получить доступ и нажать кнопку \"Обновить RPG-информацию\"",
+    "infobox.recentEvents.title": "Недавние события",
+    "infobox.recentEvents.addEventPlaceholder": "Добавить событие...",
+    "inventory.section.onPerson": "При себе",
+    "inventory.section.clothing": "Одежда",
+    "inventory.section.stored": "Хранимое",
+    "inventory.section.assets": "Активы",
+    "inventory.onPerson.empty": "Нет переносимых предметов",
+    "inventory.onPerson.title": "Предметы, которые сейчас в инвентаре",
+    "inventory.onPerson.addItemButton": "Добавить предмет",
+    "inventory.onPerson.addItemPlaceholder": "Введите название предмета...",
+    "inventory.clothing.empty": "Ничего не надето",
+    "inventory.clothing.title": "Одежда и броня",
+    "inventory.clothing.addItemButton": "Добавить одежду",
+    "inventory.clothing.addItemPlaceholder": "Введите элемент одежды...",
+    "inventory.stored.title": "Места хранения",
+    "inventory.stored.addLocationButton": "Добавить место",
+    "inventory.stored.addLocationPlaceholder": "Введите название места...",
+    "inventory.stored.saveButton": "Сохранить",
+    "inventory.stored.empty": "Пока нет мест хранения. Нажмите \"Добавить место\", чтобы создать.",
+    "inventory.stored.noItems": "Здесь нет хранимых предметов",
+    "inventory.stored.addItemToLocationPlaceholder": "Введите название предмета...",
+    "inventory.stored.addItemButton": "Добавить предмет",
+    "inventory.stored.confirmRemoveLocationMessage": "Удалить \"${location}\"? Это удалит все предметы, хранящиеся там.",
+    "inventory.stored.confirmRemoveLocationConfirmButton": "Подтвердить",
+    "inventory.assets.empty": "Нет активов",
+    "inventory.assets.title": "Транспорт, недвижимость и крупные владения",
+    "inventory.assets.addAssetModalTitle": "Добавить актив",
+    "inventory.assets.addAssetButton": "Добавить актив",
+    "inventory.assets.addAssetPlaceholder": "Введите название актива...",
+    "inventory.assets.description": "Активы включают транспортные средства (автомобили, мотоциклы), недвижимость (дома, квартиры) и крупное оборудование (инструменты для мастерской, специальные предметы).",
+    "quests.section.main": "Основное задание",
+    "quests.section.optional": "Дополнительные задания",
+    "quests.main.title": "Основные задания",
+    "quests.main.addQuestButton": "Добавить задание",
+    "quests.main.addQuestPlaceholder": "Введите название основного задания...",
+    "quests.main.empty": "Нет активных основных заданий",
+    "quests.main.hint": "Основное задание представляет вашу главную цель в истории.",
+    "quests.optional.title": "Дополнительные задания",
+    "quests.optional.addQuestButton": "Добавить задание",
+    "quests.optional.addQuestPlaceholder": "Введите название дополнительного задания...",
+    "quests.optional.empty": "Нет активных дополнительных заданий",
+    "quests.optional.hint": "Дополнительные задания - это побочные цели, которые дополняют основную историю.",
+    "checkpoint.setChapterStart": "Установить начало главы",
+    "checkpoint.clearChapterStart": "Очистить начало главы",
+    "checkpoint.indicator": "Начало главы",
+    "checkpoint.tooltip": "Сообщения до этой точки исключаются из контекста",
+    "musicPlayer.title": "Музыка сцены",
+    "musicPlayer.noMusic": "ИИ будет предлагать музыку, когда это уместно для сцены",
+    "errors.parsingError": "Ошибка парсинга RPG Companion Trackers! Модель вернула неправильный формат. Если проблема сохраняется, рассмотрите возможность смены модели для генераций.",
+    "settings.recommendedModels.title": "Рекомендуемые модели",
+    "settings.recommendedModels.description": "Для правильной работы расширения **не рекомендуется использовать модели с базой обчучения ниже 20B, особенно если они старые.** Оно лучше всего работает с современными моделями, такими как Deepseek, Claude, GPT или Gemini."
+}

src/i18n/zh-tw.json

@@ -1,165 +1,201 @@
-{
-    "settings.language.label": "語言",
-    "settings.language.option.en": "English",
-    "settings.language.option.zh-tw": "繁體中文",
-    "settings.extensionEnabled": "啟用 RPG Companion",
-    "settings.note": "切換開關以啟用/停用 RPG Companion。其他設定可在面板內配置。",
-    "template.settingsTitle": "RPG Companion 設定",
-    "template.settingsModal.themeTitle": "主題",
-    "template.settingsModal.themeLabel": "可選主題：",
-    "template.settingsModal.themeOptions.default": "預設",
-    "template.settingsModal.themeOptions.sciFi": "科幻 (合成波)",
-    "template.settingsModal.themeOptions.fantasy": "奇幻 (古樸羊皮紙)",
-    "template.settingsModal.themeOptions.cyberpunk": "賽博朋克 (霓虹網格)",
-    "template.settingsModal.themeOptions.custom": "自訂",
-    "template.settingsModal.themeOptions.custom.background": "背景：",
-    "template.settingsModal.themeOptions.custom.accent": "強調色：",
-    "template.settingsModal.themeOptions.custom.text": "文字：",
-    "template.settingsModal.themeOptions.custom.highlight": "高亮：",
-    "template.settingsModal.theme.statBarLow": "屬性條顏色 (低)：",
-    "template.settingsModal.theme.statBarLowNote": "屬性在 0% 時的顏色",
-    "template.settingsModal.theme.statBarHigh": "屬性條顏色 (高)：",
-    "template.settingsModal.theme.statBarHighNote": "屬性在 100% 時的顏色",
-    "template.settingsModal.displayTitle": "顯示設定",
-    "template.settingsModal.displayNote": "使用擴充功能標籤來啟用/停用 RPG Companion 擴充功能。",
-    "template.settingsModal.display.panelPosition": "面板位置：",
-    "template.settingsModal.display.panelPositionOptions.right": "右側邊欄",
-    "template.settingsModal.display.panelPositionOptions.left": "左側邊欄",
-    "template.settingsModal.display.toggleAutoUpdate": "訊息後自動更新",
-    "template.settingsModal.display.showUserStats": "顯示 user 屬性",
-    "template.settingsModal.display.showInfoBox": "顯示資訊框",
-    "template.settingsModal.display.showPresentCharacters": "顯示在場角色",
-    "template.settingsModal.display.showInventory": "顯示物品欄",
-    "template.settingsModal.display.showThoughtsInChat": "在聊天中顯示想法",
-    "template.settingsModal.display.showThoughtsInChatNote": "將角色想法顯示為其訊息旁的泡泡",
-    "template.settingsModal.display.alwaysShowThoughtBubble": "始終顯示想法泡泡",
-    "template.settingsModal.display.alwaysShowThoughtBubbleNote": "自動展開想法泡泡",
-    "template.settingsModal.display.enableAnimations": "啟用動畫",
-    "template.settingsModal.display.enableAnimationsNote": "屬性、內容更新和擲骰的動畫效果",
-    "template.settingsModal.display.showPlotProgressionButtons": "顯示劇情推進按鈕（QR）",
-    "template.settingsModal.display.showPlotProgressionButtonsNote": "在聊天輸入框上方顯示劇情推進提示按鈕（QR）",
-    "template.settingsModal.display.enableDebugMode": "Debug Mode",
-    "template.settingsModal.display.enableDebugModeNote": "UI 面板中顯示日誌，對於故障排除很有用。",
-    "template.settingsModal.advancedTitle": "進階",
-    "template.settingsModal.advanced.generationMode": "生成模式：",
-    "template.settingsModal.advanced.generationModeOptions.together": "同時生成",
-    "template.settingsModal.advanced.generationModeOptions.separate": "單獨生成",
-    "template.settingsModal.advanced.generationModeNote": "同時生成：將 RPG 追蹤添加到主要提示詞中一同生成。單獨生成：分開生成 RPG 數據。（就是手動或自動的差別）。",
-    "template.settingsModal.advanced.contextMessages": "上下文訊息：",
-    "template.settingsModal.advanced.contextMessagesNote": "包含的最近訊息數量（僅限單獨生成模式）",
-    "template.settingsModal.advanced.memoryBatchSize": "記憶批次大小：",
-    "template.settingsModal.advanced.memoryBatchSizeNote": "在記憶回憶中每批處理的訊息數量",
-    "template.settingsModal.advanced.useSeparatePreset": "使用 RPG Companion 追蹤預設模型（設置次要模型）",
-    "template.settingsModal.advanced.useSeparatePresetNote": "僅限單獨生成模式。啟用後將使用“RPG Companion Trackers”預設中綁定的模型，而不是您的主要 API 模型。生成期間會自動切換預設，之後會恢復原使用預設。請在“RPG Companion Trackers”預設中選擇次要模型，並確保“將預設綁定到 API 連接”切換已開啟（在導入/導出預設按鈕旁邊）。",
-    "template.settingsModal.advanced.skipInjections": "在引導生成期間跳過注入：",
-    "template.settingsModal.advanced.skipInjectionsOptions.none": "從不跳過",
-    "template.settingsModal.advanced.skipInjectionsOptions.impersonation": "僅在模擬請求時跳過",
-    "template.settingsModal.advanced.skipInjectionsOptions.guided": "始終跳過引導",
-    "template.settingsModal.advanced.skipInjectionsNote": "當設置後，擴充功能在檢測到引導生成（通過 `instruct` 或 `quiet_prompt`）時，將根據所選模式不注入追蹤提示詞、範例或 HTML 指令。當與 GuidedGenerations 或類似擴充功能一起使用時非常有用。",
-    "template.settingsModal.advanced.customHtmlPromptTitle": "自訂 HTML 提示詞：",
-    "template.settingsModal.advanced.restoreDefaultHtmlPrompt": "恢復預設",
-    "template.settingsModal.advanced.customHtmlPromptNote": "自訂啟用“啟用沉浸式 HTML”時注入的 HTML 提示詞。上方顯示預設提示詞 - 您可以直接編輯或完全替換它。點擊“恢復預設”以重置。這會影響所有生成模式（同時、單獨和劇情推進）。",
-    "template.settingsModal.advanced.clearCache": "清除擴充功能快取",
-    "template.settingsModal.advanced.resetFabPositions": "重置按鈕位置",
-    "template.settingsModal.advanced.resetFabPositionsNote": "將所有浮動操作按鈕（切換、刷新、調試）重置為預設的左上位置。如果按鈕在螢幕外，這會很有用。",
-    "template.trackerEditorModal.title": "追蹤器編輯",
-    "template.trackerEditorModal.tabs.userStats": "User 屬性",
-    "template.trackerEditorModal.tabs.infoBox": "資訊框",
-    "template.trackerEditorModal.tabs.presentCharacters": "在場角色",
-    "template.trackerEditorModal.buttons.reset": "重置為預設值",
-    "template.trackerEditorModal.buttons.cancel": "取消",
-    "template.trackerEditorModal.buttons.save": "保存並應用",
-    "template.trackerEditorModal.userStatsTab.customStatsTitle": "自訂屬性",
-    "template.trackerEditorModal.userStatsTab.addCustomStatButton": "添加自訂屬性",
-    "template.trackerEditorModal.userStatsTab.rpgAttributesTitle": "RPG 屬性",
-    "template.trackerEditorModal.userStatsTab.enableRpgAttributes": "啟用 RPG 屬性",
-    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributes": "始終發送屬性（prompt）",
-    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributesNote": "將 RPG 屬性始終包含在提示詞中，即使它們未顯示在面板上也一樣。",
-    "template.trackerEditorModal.userStatsTab.addAttributeButton": "添加屬性",
-    "template.trackerEditorModal.userStatsTab.statusSectionTitle": "狀態欄",
-    "template.trackerEditorModal.userStatsTab.enableStatusSection": "啟用狀態欄",
-    "template.trackerEditorModal.userStatsTab.showMoodEmoji": "顯示心情emoji",
-    "template.trackerEditorModal.userStatsTab.statusFieldsLabel": "狀態欄欄位（以逗號分隔）：",
-    "template.trackerEditorModal.userStatsTab.skillsSectionTitle": "技能欄",
-    "template.trackerEditorModal.userStatsTab.enableSkillsSection": "啟用技能欄",
-    "template.trackerEditorModal.userStatsTab.skillsLabelLabel": "技能欄標籤：",
-    "template.trackerEditorModal.userStatsTab.skillsListLabel": " 技能列表（以逗號分隔）：",
-    "template.trackerEditorModal.infoBoxTab.widgetsTitle": "小工具",
-    "template.trackerEditorModal.infoBoxTab.dateWidget": "日期",
-    "template.trackerEditorModal.infoBoxTab.weatherWidget": "天氣",
-    "template.trackerEditorModal.infoBoxTab.temperatureWidget": "溫度",
-    "template.trackerEditorModal.infoBoxTab.timeWidget": "時間",
-    "template.trackerEditorModal.infoBoxTab.locationWidget": "位置",
-    "template.trackerEditorModal.infoBoxTab.recentEventsWidget": "近期事件",
-    "template.trackerEditorModal.presentCharactersTab.relationshipStatusTitle": "關係狀態",
-    "template.trackerEditorModal.presentCharactersTab.relationshipStatusHint": "定義關係類型，並在角色頭像上顯示對應的表情符號",
-    "template.trackerEditorModal.presentCharactersTab.newRelationshipButton": "新增關係類型",
-    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorTitle": "外觀與當前行為舉止",
-    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorHint": "角色名稱下方顯示的字段，以 | 分隔。",
-    "template.trackerEditorModal.presentCharactersTab.addCustomFieldButton": "添加自訂字段",
-    "template.trackerEditorModal.presentCharactersTab.thoughtsConfigTitle": "內心話配置",
-    "template.trackerEditorModal.presentCharactersTab.enableCharacterThoughts": "啟用角色內心話",
-    "template.trackerEditorModal.presentCharactersTab.thoughtsLabelLabel": "內心話標籤：",
-    "template.trackerEditorModal.presentCharactersTab.aiInstructionLabel": "內心話提示詞：",
-    "template.trackerEditorModal.presentCharactersTab.characterStatsTitle": "角色屬性",
-    "template.trackerEditorModal.presentCharactersTab.trackCharacterStats": "啟用角色屬性",
-    "template.trackerEditorModal.presentCharactersTab.characterStatsHint": "建立統計資料以追蹤每個角色（以彩色長條圖顯示）",
-    "template.trackerEditorModal.presentCharactersTab.addCharacterStatButton": "添加角色屬性",
-    "template.mainPanel.title": "RPG Companion",
-    "template.mainPanel.lastRoll": "上次擲骰：",
-    "template.mainPanel.clearLastRoll": "清除上次擲骰",
-    "template.mainPanel.enableImmersiveHtml": "啟用沉浸式 HTML",
-    "template.mainPanel.refreshRpgInfo": "刷新資訊",
-    "template.mainPanel.updating": "更新中...",
-    "template.mainPanel.editTrackersButton": "追蹤器編輯",
-    "template.mainPanel.settingsButton": "設定",
-    "global.none": "None",
-    "global.add": "添加",
-    "global.cancel": "取消",
-    "global.save": "保存",
-    "global.listView": "清單檢視",
-    "global.gridView": "格子檢視",
-    "global.status": "狀態欄",
-    "global.inventory": "物品欄",
-    "global.quests": "任務",
-    "global.info":"資訊",
-    "infobox.noData.title": "無資訊可顯示",
-    "infobox.noData.instruction": "在RP中產生新的回复，或在設定中切換到“單獨生成”，然後點擊“刷新資訊”按鈕。",
-    "infobox.recentEvents.title": "近期事件",
-    "infobox.recentEvents.addEventPlaceholder": "添加事件...",
-    "inventory.section.onPerson": "隨身物品",
-    "inventory.section.stored": "倉庫物品",
-    "inventory.section.assets": "資產",
-    "inventory.onPerson.empty": "這裡什麼都沒有 (⚲□⚲)",
-    "inventory.onPerson.title": "攜帶的物品",
-    "inventory.onPerson.addItemButton": "添加物品",
-    "inventory.onPerson.addItemPlaceholder": "輸入物品名稱...",
-    "inventory.stored.title": "倉庫位置",
-    "inventory.stored.addLocationButton": "添加倉庫",
-    "inventory.stored.addLocationPlaceholder": "輸入倉庫名稱...",
-    "inventory.stored.saveButton": "保存",
-    "inventory.stored.empty": "沒有倉庫 (⚲□⚲), 點擊\"添加倉庫\"來新增一個倉庫",
-    "inventory.stored.noItems": "這個倉庫是空的 (⚲□⚲)",
-    "inventory.stored.addItemToLocationPlaceholder": "輸入物品名稱...",
-    "inventory.stored.addItemButton": "添加物品",
-    "inventory.stored.confirmRemoveLocationMessage": "確定要刪除這個倉庫嗎？這將移除所有其中的物品。",
-    "inventory.stored.confirmRemoveLocationConfirmButton": "刪除",
-    "inventory.assets.empty": "沒有資產 (⚲□⚲) 好窮",
-    "inventory.assets.title": "車輛、房產及主要財產",
-    "inventory.assets.addAssetModalTitle": "添加資產",
-    "inventory.assets.addAssetButton": "添加資產",
-    "inventory.assets.addAssetPlaceholder": "輸入資產名稱...",
-    "inventory.assets.description": "資產包括車輛（汽車、摩托車）、房產（房屋、公寓）和主要設備（車間工具、特殊物品）。",
-    "quests.section.main": "主線任務",
-    "quests.section.optional": "支線任務",
-    "quests.main.title": "主線任務",
-    "quests.main.addQuestButton": "添加主要任務",
-    "quests.main.addQuestPlaceholder": "輸入主線任務名稱...",
-    "quests.main.empty": "當前無主要任務 (ฅ˙Ⱉ˙ฅ)",
-    "quests.main.hint": "主線任務代表你在故事中的主要目標。",
-    "quests.optional.title": "支線任務",
-    "quests.optional.addQuestButton": "添加支線任務",
-    "quests.optional.addQuestPlaceholder": "輸入支線任務名稱...",
-    "quests.optional.empty": "當前無支線任務 (ʘ̆ʚʘ̆)",
-    "quests.optional.hint": "支線任務是補充主線劇情的支線目標。"
-}
+{
+    "settings.language.label": "語言",
+    "settings.language.option.en": "English",
+    "settings.language.option.zh-tw": "繁體中文",
+    "settings.language.option.ru": "Русский",
+    "settings.extensionEnabled": "啟用 RPG Companion",
+    "settings.note": "切換開關以啟用/停用 RPG Companion。其他設定可在面板內配置。",
+    "template.settingsTitle": "RPG Companion 設定",
+    "template.settingsModal.themeTitle": "主題",
+    "template.settingsModal.themeLabel": "可選主題：",
+    "template.settingsModal.themeOptions.default": "預設",
+    "template.settingsModal.themeOptions.sciFi": "科幻 (合成波)",
+    "template.settingsModal.themeOptions.fantasy": "奇幻 (古樸羊皮紙)",
+    "template.settingsModal.themeOptions.cyberpunk": "賽博朋克 (霓虹網格)",
+    "template.settingsModal.themeOptions.custom": "自訂",
+    "template.settingsModal.themeOptions.custom.background": "背景：",
+    "template.settingsModal.themeOptions.custom.accent": "強調色：",
+    "template.settingsModal.themeOptions.custom.text": "文字：",
+    "template.settingsModal.themeOptions.custom.highlight": "高亮：",
+    "template.settingsModal.theme.statBarLow": "屬性條顏色 (低)：",
+    "template.settingsModal.theme.statBarLowNote": "屬性在 0% 時的顏色",
+    "template.settingsModal.theme.statBarHigh": "屬性條顏色 (高)：",
+    "template.settingsModal.theme.statBarHighNote": "屬性在 100% 時的顏色",
+    "template.settingsModal.displayTitle": "顯示設定",
+    "template.settingsModal.displayNote": "使用擴充功能標籤來啟用/停用 RPG Companion 擴充功能。",
+    "template.settingsModal.display.panelPosition": "面板位置：",
+    "template.settingsModal.display.panelPositionOptions.right": "右側邊欄",
+    "template.settingsModal.display.panelPositionOptions.left": "左側邊欄",
+    "template.settingsModal.display.toggleAutoUpdate": "訊息後自動更新",
+    "template.settingsModal.display.showUserStats": "顯示 user 屬性",
+    "template.settingsModal.display.showInfoBox": "顯示資訊框",
+    "template.settingsModal.display.showPresentCharacters": "顯示在場角色",
+    "template.settingsModal.display.showInventory": "顯示物品欄",
+    "template.settingsModal.display.showLockIcons": "顯示鎖定/解鎖追蹤器",
+    "template.settingsModal.display.showLockIconsNote": "在追蹤器項目上顯示鎖定/解鎖圖示，以防止 AI 修改它們。",
+    "template.settingsModal.display.showThoughtsInChat": "在聊天中顯示想法",
+    "template.settingsModal.display.showThoughtsInChatNote": "將角色想法顯示為其訊息旁的泡泡",
+    "template.settingsModal.display.alwaysShowThoughtBubble": "始終顯示想法泡泡",
+    "template.settingsModal.display.alwaysShowThoughtBubbleNote": "自動展開想法泡泡",
+    "template.settingsModal.display.enableAnimations": "啟用動畫",
+    "template.settingsModal.display.enableAnimationsNote": "屬性、內容更新和擲骰的動畫效果",
+    "template.settingsModal.display.showImmersiveHtmlToggle": "顯示沉浸式 HTML",
+    "template.settingsModal.display.showDialogueColoringToggle": "顯示彩色對話",
+    "template.settingsModal.display.showDialogueColoringToggleNote": "顯示一個切換按鈕以啟用/停用彩色對話格式。",
+    "template.settingsModal.display.showSpotifyMusicToggle": "顯示 Spotify 音樂",
+    "template.settingsModal.display.showSnowflakesToggle": "顯示雪花效果",    "template.settingsModal.display.showDynamicWeatherToggle": "顯示動態天氣效果",    "template.settingsModal.display.showNarratorMode": "顯示旁白模式",    "template.settingsModal.display.showNarratorModeNote": "顯示切換按鈕以啟用/停用旁白模式",    "template.settingsModal.display.showAutoAvatars": "顯示自動生成頭像",    "template.settingsModal.display.showAutoAvatarsNote": "顯示切換按鈕以自動為沒有圖片的角色生成頭像",    "template.settingsModal.display.showPlotProgressionButtons": "顯示劇情推進按鈕（QR）",
+    "template.settingsModal.display.showPlotProgressionButtonsNote": "在聊天輸入框上方顯示劇情推進提示按鈕（QR）",
+    "template.settingsModal.advancedTitle": "進階",
+    "template.settingsModal.advanced.generationMode": "生成模式：",
+    "template.settingsModal.advanced.generationModeOptions.together": "同時生成",
+    "template.settingsModal.advanced.generationModeOptions.separate": "單獨生成",
+    "template.settingsModal.advanced.generationModeNote": "同時生成：將 RPG 追蹤添加到主要提示詞中一同生成。單獨生成：分開生成 RPG 數據。（就是手動或自動的差別）。外部 API：直接連接 OpenAI 兼容端點生成數據。",
+    "template.settingsModal.advanced.generationModeOptions.external": "外部 API",
+    "template.settingsModal.advanced.externalApi.title": "外部 API 設定",
+    "template.settingsModal.advanced.externalApi.baseUrl": "API 基礎 URL",
+    "template.settingsModal.advanced.externalApi.baseUrlNote": "OpenAI 兼容端點（例如 OpenAI、OpenRouter、本地 LLM 伺服器）",
+    "template.settingsModal.advanced.externalApi.apiKey": "API 金鑰",
+    "template.settingsModal.advanced.externalApi.apiKeyNote": "外部服務的 API 金鑰",
+    "template.settingsModal.advanced.externalApi.model": "模型",
+    "template.settingsModal.advanced.externalApi.modelNote": "模型識別碼（例如 gpt-4o-mini、claude-3-haiku、mistral-7b）",
+    "template.settingsModal.advanced.externalApi.maxTokens": "最大 Token",
+    "template.settingsModal.advanced.externalApi.temperature": "溫度 (Temperature)",
+    "template.settingsModal.advanced.externalApi.testConnection": "測試連接",
+    "template.settingsModal.advanced.contextMessages": "上下文訊息：",
+    "template.settingsModal.advanced.contextMessagesNote": "包含的最近訊息數量（僅限單獨生成模式）",
+    "template.settingsModal.advanced.memoryBatchSize": "記憶批次大小：",
+    "template.settingsModal.advanced.memoryBatchSizeNote": "在記憶回憶中每批處理的訊息數量",
+    "template.settingsModal.advanced.useSeparatePreset": "使用 RPG Companion 追蹤預設模型（設置次要模型）",
+    "template.settingsModal.advanced.useSeparatePresetNote": "僅限單獨生成模式。啟用後將使用“RPG Companion Trackers”預設中綁定的模型，而不是您的主要 API 模型。生成期間會自動切換預設，之後會恢復原使用預設。請在“RPG Companion Trackers”預設中選擇次要模型，並確保“將預設綁定到 API 連接”切換已開啟（在導入/導出預設按鈕旁邊）。",
+    "template.settingsModal.advanced.skipInjections": "在引導生成期間跳過注入：",
+    "template.settingsModal.advanced.skipInjectionsOptions.none": "從不跳過",
+    "template.settingsModal.advanced.skipInjectionsOptions.impersonation": "僅在模擬請求時跳過",
+    "template.settingsModal.advanced.skipInjectionsOptions.guided": "始終跳過引導",
+    "template.settingsModal.advanced.skipInjectionsNote": "當設置後，擴充功能在檢測到引導生成（通過 `instruct` 或 `quiet_prompt`）時，將根據所選模式不注入追蹤提示詞、範例或 HTML 指令。當與 GuidedGenerations 或類似擴充功能一起使用時非常有用。",
+    "template.settingsModal.advanced.customHtmlPromptTitle": "自訂 HTML 提示詞：",
+    "template.settingsModal.advanced.restoreDefaultHtmlPrompt": "恢復預設",
+    "template.settingsModal.advanced.customHtmlPromptNote": "自訂啟用“啟用沉浸式 HTML”時注入的 HTML 提示詞。上方顯示預設提示詞 - 您可以直接編輯或完全替換它。點擊“恢復預設”以重置。這會影響所有生成模式（同時、單獨和劇情推進）。",
+    "template.settingsModal.advanced.clearCache": "清除擴充功能快取",
+    "template.settingsModal.advanced.resetFabPositions": "重置按鈕位置",
+    "template.settingsModal.advanced.resetFabPositionsNote": "將所有浮動操作按鈕（切換、刷新、調試）重置為預設的左上位置。如果按鈕在螢幕外，這會很有用。",
+    "template.trackerEditorModal.title": "追蹤器編輯",
+    "template.trackerEditorModal.tabs.userStats": "User 屬性",
+    "template.trackerEditorModal.tabs.infoBox": "資訊框",
+    "template.trackerEditorModal.tabs.presentCharacters": "在場角色",
+    "template.trackerEditorModal.buttons.reset": "重置",
+    "template.trackerEditorModal.buttons.cancel": "取消",
+    "template.trackerEditorModal.buttons.save": "保存並應用",
+    "template.trackerEditorModal.buttons.export": "匯出",
+    "template.trackerEditorModal.buttons.import": "匯入",
+    "template.trackerEditorModal.messages.exportSuccess": "追蹤器預設匯出成功！",
+    "template.trackerEditorModal.messages.exportError": "匯出追蹤器預設失敗。請檢查控制台以獲取詳細資訊。",
+    "template.trackerEditorModal.messages.importSuccess": "追蹤器預設匯入成功！",
+    "template.trackerEditorModal.messages.importError": "匯入追蹤器預設失敗",
+    "template.trackerEditorModal.messages.importConfirm": "這將替換您當前的追蹤器配置。繼續？",
+    "template.trackerEditorModal.userStatsTab.customStatsTitle": "自訂屬性",
+    "template.trackerEditorModal.userStatsTab.addCustomStatButton": "添加自訂屬性",
+    "template.trackerEditorModal.userStatsTab.rpgAttributesTitle": "RPG 屬性",
+    "template.trackerEditorModal.userStatsTab.enableRpgAttributes": "啟用 RPG 屬性",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributes": "始終發送屬性（prompt）",
+    "template.trackerEditorModal.userStatsTab.alwaysIncludeAttributesNote": "將 RPG 屬性始終包含在提示詞中，即使它們未顯示在面板上也一樣。",
+    "template.trackerEditorModal.userStatsTab.addAttributeButton": "添加屬性",
+    "template.trackerEditorModal.userStatsTab.statusSectionTitle": "狀態欄",
+    "template.trackerEditorModal.userStatsTab.enableStatusSection": "啟用狀態欄",
+    "template.trackerEditorModal.userStatsTab.showMoodEmoji": "顯示心情emoji",
+    "template.trackerEditorModal.userStatsTab.statusFieldsLabel": "狀態欄欄位（以逗號分隔）：",
+    "template.trackerEditorModal.userStatsTab.skillsSectionTitle": "技能欄",
+    "template.trackerEditorModal.userStatsTab.enableSkillsSection": "啟用技能欄",
+    "template.trackerEditorModal.userStatsTab.skillsLabelLabel": "技能欄標籤：",
+    "template.trackerEditorModal.userStatsTab.skillsListLabel": " 技能列表（以逗號分隔）：",
+    "template.trackerEditorModal.infoBoxTab.widgetsTitle": "小工具",
+    "template.trackerEditorModal.infoBoxTab.dateWidget": "日期",
+    "template.trackerEditorModal.infoBoxTab.weatherWidget": "天氣",
+    "template.trackerEditorModal.infoBoxTab.temperatureWidget": "溫度",
+    "template.trackerEditorModal.infoBoxTab.timeWidget": "時間",
+    "template.trackerEditorModal.infoBoxTab.locationWidget": "位置",
+    "template.trackerEditorModal.infoBoxTab.recentEventsWidget": "近期事件",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusTitle": "關係狀態",
+    "template.trackerEditorModal.presentCharactersTab.enableRelationshipStatus": "啟用關係狀態欄位",
+    "template.trackerEditorModal.presentCharactersTab.relationshipStatusHint": "定義關係類型，並在角色頭像上顯示對應的表情符號",
+    "template.trackerEditorModal.presentCharactersTab.newRelationshipButton": "新增關係類型",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorTitle": "外觀與當前行為舉止",
+    "template.trackerEditorModal.presentCharactersTab.appearanceDemeanorHint": "角色名稱下方顯示的字段，以 | 分隔。",
+    "template.trackerEditorModal.presentCharactersTab.addCustomFieldButton": "添加自訂字段",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsConfigTitle": "內心話配置",
+    "template.trackerEditorModal.presentCharactersTab.enableCharacterThoughts": "啟用角色內心話",
+    "template.trackerEditorModal.presentCharactersTab.thoughtsLabelLabel": "內心話標籤：",
+    "template.trackerEditorModal.presentCharactersTab.aiInstructionLabel": "內心話提示詞：",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsTitle": "角色屬性",
+    "template.trackerEditorModal.presentCharactersTab.trackCharacterStats": "啟用角色屬性",
+    "template.trackerEditorModal.presentCharactersTab.characterStatsHint": "建立統計資料以追蹤每個角色（以彩色長條圖顯示）",
+    "template.trackerEditorModal.presentCharactersTab.addCharacterStatButton": "添加角色屬性",
+    "template.mainPanel.title": "RPG Companion",
+    "template.mainPanel.lastRoll": "上次擲骰：",
+    "template.mainPanel.clearLastRoll": "清除上次擲骰",
+    "template.mainPanel.immersiveHtml": "沉浸式 HTML",
+    "template.mainPanel.coloredDialogues": "彩色對話",
+    "template.mainPanel.spotifyMusic": "Spotify 音樂",
+    "template.mainPanel.snowflakesEffect": "雪花效果",    "template.mainPanel.dynamicWeatherEffects": "動態天氣",    "template.mainPanel.narratorMode": "旁白模式",    "template.mainPanel.autoAvatars": "自動頭像",    "template.mainPanel.refreshRpgInfo": "刷新資訊",
+    "template.mainPanel.updating": "更新中...",
+    "template.mainPanel.editTrackersButton": "追蹤器編輯",
+    "template.mainPanel.settingsButton": "設定",
+    "global.none": "None",
+    "global.add": "添加",
+    "global.cancel": "取消",
+    "global.save": "保存",
+    "global.listView": "清單檢視",
+    "global.gridView": "格子檢視",
+    "global.status": "狀態欄",
+    "global.inventory": "物品欄",
+    "global.quests": "任務",
+    "global.info":"資訊",
+    "infobox.noData.title": "無資訊可顯示",
+    "infobox.noData.instruction": "在RP中產生新的回复，或在設定中切換到“單獨生成”，然後點擊“刷新資訊”按鈕。",
+    "infobox.recentEvents.title": "近期事件",
+    "infobox.recentEvents.addEventPlaceholder": "添加事件...",
+    "inventory.section.onPerson": "隨身物品",
+    "inventory.section.clothing": "服裝",
+    "inventory.section.stored": "倉庫物品",
+    "inventory.section.assets": "資產",
+    "inventory.onPerson.empty": "這裡什麼都沒有 (⚲□⚲)",
+    "inventory.onPerson.title": "攜帶的物品",
+    "inventory.onPerson.addItemButton": "添加物品",
+    "inventory.onPerson.addItemPlaceholder": "輸入物品名稱...",
+    "inventory.clothing.empty": "未穿著任何服裝 (⚲□⚲)",
+    "inventory.clothing.title": "服裝與護甲",
+    "inventory.clothing.addItemButton": "添加服裝",
+    "inventory.clothing.addItemPlaceholder": "輸入服裝物品...",
+    "inventory.stored.title": "倉庫位置",
+    "inventory.stored.addLocationButton": "添加倉庫",
+    "inventory.stored.addLocationPlaceholder": "輸入倉庫名稱...",
+    "inventory.stored.saveButton": "保存",
+    "inventory.stored.empty": "沒有倉庫 (⚲□⚲), 點擊\"添加倉庫\"來新增一個倉庫",
+    "inventory.stored.noItems": "這個倉庫是空的 (⚲□⚲)",
+    "inventory.stored.addItemToLocationPlaceholder": "輸入物品名稱...",
+    "inventory.stored.addItemButton": "添加物品",
+    "inventory.stored.confirmRemoveLocationMessage": "確定要刪除這個倉庫嗎？這將移除所有其中的物品。",
+    "inventory.stored.confirmRemoveLocationConfirmButton": "刪除",
+    "inventory.assets.empty": "沒有資產 (⚲□⚲) 好窮",
+    "inventory.assets.title": "車輛、房產及主要財產",
+    "inventory.assets.addAssetModalTitle": "添加資產",
+    "inventory.assets.addAssetButton": "添加資產",
+    "inventory.assets.addAssetPlaceholder": "輸入資產名稱...",
+    "inventory.assets.description": "資產包括車輛（汽車、摩托車）、房產（房屋、公寓）和主要設備（車間工具、特殊物品）。",
+    "quests.section.main": "主線任務",
+    "quests.section.optional": "支線任務",
+    "quests.main.title": "主線任務",
+    "quests.main.addQuestButton": "添加主要任務",
+    "quests.main.addQuestPlaceholder": "輸入主線任務名稱...",
+    "quests.main.empty": "當前無主要任務 (ฅ˙Ⱉ˙ฅ)",
+    "quests.main.hint": "主線任務代表你在故事中的主要目標。",
+    "quests.optional.title": "支線任務",
+    "quests.optional.addQuestButton": "添加支線任務",
+    "quests.optional.addQuestPlaceholder": "輸入支線任務名稱...",
+    "quests.optional.empty": "當前無支線任務 (ʘ̆ʚʘ̆)",
+    "quests.optional.hint": "支線任務是補充主線劇情的支線目標。",
+    "musicPlayer.title": "場景音樂",
+    "musicPlayer.noMusic": "AI 會在適當時為場景建議音樂",
+    "errors.parsingError": "RPG Companion 追蹤器解析錯誤！模型返回了不正確的格式。如果問題持續存在，請考慮更換生成模型。",
+    "settings.recommendedModels.title": "推薦模型",
+    "settings.recommendedModels.description": "為了讓擴充功能正常運作，**不建議使用任何小於 20B 的模型，尤其是舊模型。**它最適合使用 SOTA 模型，例如 Deepseek、Claude、GPT 或 Gemini。"
+}

src/systems/features/avatarGenerator.js

@@ -0,0 +1,403 @@
+/**
+ * Avatar Generator Module
+ * Handles automatic and manual avatar generation for NPC characters
+ *
+ * Features:
+ * - Batch generation with awaitable completion
+ * - Batch prompt generation via LLM
+ * - Individual image generation via /sd command
+ * - Manual regeneration support
+ */
+
+import { characters, this_chid } from '../../../../../../../script.js';
+import { safeGenerateRaw } from '../../utils/responseExtractor.js';
+import { executeSlashCommandsOnChatInput } from '../../../../../../../scripts/slash-commands.js';
+import { selected_group, getGroupMembers } from '../../../../../../group-chats.js';
+import { extensionSettings, sessionAvatarPrompts, setSessionAvatarPrompt } from '../../core/state.js';
+import { saveSettings } from '../../core/persistence.js';
+import { generateAvatarPromptGenerationPrompt } from '../generation/promptBuilder.js';
+import { getCurrentPresetName, switchToPreset, generateWithExternalAPI } from '../generation/apiClient.js';
+
+// Generation state - tracks characters currently being generated
+const pendingGenerations = new Set();
+
+
+/**
+ * Checks if a character is pending generation (waiting or actively generating)
+ * @param {string} characterName - Name of character to check
+ * @returns {boolean} True if generation is pending
+ */
+export function isGenerating(characterName) {
+    return pendingGenerations.has(characterName);
+}
+
+/**
+ * Checks if any avatars are currently being generated
+ * @returns {boolean} True if any generation is in progress
+ */
+export function isAnyGenerating() {
+    return pendingGenerations.size > 0;
+}
+
+/**
+ * Gets all characters currently pending generation
+ * @returns {string[]} Array of character names
+ */
+export function getPendingGenerations() {
+    return [...pendingGenerations];
+}
+
+/**
+ * Helper to check if two character names match (case-insensitive, handles partial matches)
+ * @param {string} cardName - Name from character card
+ * @param {string} aiName - Name from AI response
+ * @returns {boolean} True if names match
+ */
+function namesMatch(cardName, aiName) {
+    if (!cardName || !aiName) return false;
+    const cardLower = cardName.toLowerCase().trim();
+    const aiLower = aiName.toLowerCase().trim();
+    if (cardLower === aiLower) return true;
+    const cardCore = cardLower.split(/[\s,'"]+/)[0];
+    const aiCore = aiLower.split(/[\s,'"]+/)[0];
+    if (cardCore === aiCore) return true;
+    const escapedCardCore = cardCore.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const wordBoundary = new RegExp(`\\b${escapedCardCore}\\b`);
+    return wordBoundary.test(aiCore);
+}
+
+/**
+ * Checks if a character already has an avatar (custom NPC avatar or from character card)
+ * @param {string} characterName - Name of character to check
+ * @returns {boolean} True if character has an avatar
+ */
+export function hasExistingAvatar(characterName) {
+    // Check for custom NPC avatar first
+    if (extensionSettings.npcAvatars && extensionSettings.npcAvatars[characterName]) {
+        const avatar = extensionSettings.npcAvatars[characterName];
+        if (typeof avatar === 'string' && avatar) {
+            return true;
+        }
+    }
+
+    // Check group members for avatar
+    if (selected_group) {
+        try {
+            const groupMembers = getGroupMembers(selected_group);
+            if (groupMembers && groupMembers.length > 0) {
+                const matchingMember = groupMembers.find(member =>
+                    member && member.name && namesMatch(member.name, characterName)
+                );
+                if (matchingMember && matchingMember.avatar && matchingMember.avatar !== 'none') {
+                    return true;
+                }
+            }
+        } catch (e) {
+            // Ignore errors
+        }
+    }
+
+    // Check all characters for avatar
+    if (characters && characters.length > 0) {
+        const matchingCharacter = characters.find(c =>
+            c && c.name && namesMatch(c.name, characterName)
+        );
+        if (matchingCharacter && matchingCharacter.avatar && matchingCharacter.avatar !== 'none') {
+            return true;
+        }
+    }
+
+    // Check current character in 1-on-1 chat
+    if (this_chid !== undefined && characters[this_chid] &&
+        characters[this_chid].name && namesMatch(characters[this_chid].name, characterName)) {
+        if (characters[this_chid].avatar && characters[this_chid].avatar !== 'none') {
+            return true;
+        }
+    }
+
+    return false;
+}
+
+/**
+ * Generates avatars for multiple characters and waits for all to complete.
+ * This is the main entry point for auto-generation within a workflow.
+ *
+ * @param {string[]} characterNames - Array of character names to generate avatars for
+ * @param {Function} onStarted - Optional callback when generation starts (to update UI)
+ * @returns {Promise<void>} Resolves when all generations complete
+ */
+export async function generateAvatarsForCharacters(characterNames, onStarted = null) {
+    if (!extensionSettings.autoGenerateAvatars) {
+        return;
+    }
+
+    // Filter to characters that need avatars
+    const needsGeneration = characterNames.filter(name => {
+        // Skip if already pending
+        if (pendingGenerations.has(name)) {
+            return false;
+        }
+        // Skip if has avatar
+        if (hasExistingAvatar(name)) {
+            return false;
+        }
+        return true;
+    });
+
+    if (needsGeneration.length === 0) {
+        return;
+    }
+
+    // console.log('[RPG Avatar] Starting batch generation for:', needsGeneration);
+
+    // Mark all as pending IMMEDIATELY (before any async work)
+    for (const name of needsGeneration) {
+        pendingGenerations.add(name);
+    }
+
+    // Trigger UI update to show loading spinners
+    if (onStarted) {
+        try {
+            onStarted([...needsGeneration]);
+        } catch (e) {
+            console.error('[RPG Avatar] Error in onStarted callback:', e);
+        }
+    }
+
+    try {
+        // Generate images one at a time, generating prompt on demand
+        for (const characterName of needsGeneration) {
+            // Skip if somehow already has avatar now
+            if (hasExistingAvatar(characterName)) {
+                pendingGenerations.delete(characterName);
+                continue;
+            }
+
+            // Generate LLM prompt for this character
+            const prompt = await generateAvatarPrompt(characterName);
+
+            // Generate the image using the prompt
+            await generateSingleAvatar(characterName, prompt);
+
+            pendingGenerations.delete(characterName);
+
+            // Small delay between generations to avoid overwhelming the API
+            if (needsGeneration.indexOf(characterName) < needsGeneration.length - 1) {
+                await new Promise(resolve => setTimeout(resolve, 500));
+            }
+        }
+    } finally {
+        // Ensure all are removed from pending even if there's an error
+        for (const name of needsGeneration) {
+            pendingGenerations.delete(name);
+        }
+    }
+
+    // console.log('[RPG Avatar] Batch generation complete');
+}
+
+/**
+ * Regenerates avatar for a specific character
+ * Clears existing avatar and prompt, then generates new ones
+ * Handles preset switching if useSeparatePreset is enabled
+ *
+ * @param {string} characterName - Name of character to regenerate
+ * @returns {Promise<string|null>} New avatar URL or null if failed
+ */
+export async function regenerateAvatar(characterName) {
+    // console.log('[RPG Avatar] Regenerating avatar for:', characterName);
+
+    // Mark as pending immediately
+    pendingGenerations.add(characterName);
+
+    // Clear existing avatar
+    if (extensionSettings.npcAvatars && extensionSettings.npcAvatars[characterName]) {
+        delete extensionSettings.npcAvatars[characterName];
+        saveSettings();
+    }
+
+    // Clear existing prompt cache
+    if (sessionAvatarPrompts[characterName]) {
+        delete sessionAvatarPrompts[characterName];
+    }
+
+    try {
+        // Generate new LLM prompt
+        const prompt = await generateAvatarPrompt(characterName);
+
+        // Generate the avatar
+        return await generateSingleAvatar(characterName, prompt);
+    } finally {
+        // Remove from pending when done
+        pendingGenerations.delete(characterName);
+    }
+}
+
+/**
+ * Generates an LLM prompt for a single character
+ *
+ * @param {string} characterName - Name of character
+ * @returns {Promise<string|null>} Generated prompt or null if failed
+ */
+async function generateAvatarPrompt(characterName) {
+    // Check cache first if not forcing regeneration
+    if (sessionAvatarPrompts[characterName]) {
+        return sessionAvatarPrompts[characterName];
+    }
+
+    try {
+        // console.log('[RPG Avatar] Generating LLM prompt for:', characterName);
+
+        const promptMessages = await generateAvatarPromptGenerationPrompt(characterName);
+        let response;
+
+        if (extensionSettings.generationMode === 'external') {
+            // console.log('[RPG Avatar] Using external API for avatar prompt generation');
+            response = await generateWithExternalAPI(promptMessages);
+        } else {
+            response = await safeGenerateRaw({
+                prompt: promptMessages,
+                quietToLoud: false
+            });
+        }
+
+        if (response) {
+            const prompt = response.trim();
+            // console.log(`[RPG Avatar] Generated prompt for ${characterName}:`, prompt);
+
+            // Store prompt in session storage
+            setSessionAvatarPrompt(characterName, prompt);
+            return prompt;
+        }
+    } catch (error) {
+        console.error(`[RPG Avatar] Failed to generate LLM prompt for ${characterName}:`, error);
+    }
+    return null;
+}
+
+/**
+ * Builds a fallback prompt when LLM prompt generation fails or isn't available
+ * Uses information embedded in the character name if present (e.g., from malformed tracker output)
+ *
+ * @param {string} characterName - Character name (may contain additional details)
+ * @returns {string} A basic prompt for image generation
+ */
+function buildFallbackPrompt(characterName) {
+    // Check if the name contains embedded details (malformed format from weaker models)
+    // e.g., "Eris Details: 🌟 | beautiful girl with white hair | kind expression"
+    if (characterName.includes('Details:') || characterName.includes('|')) {
+        // Extract useful description parts
+        const parts = characterName.split(/Details:|[|]/).map(p => p.trim()).filter(p => p && !p.match(/^[\p{Emoji}]+$/u));
+        if (parts.length > 1) {
+            // First part is likely the name, rest are descriptions
+            const name = parts[0];
+            const descriptions = parts.slice(1).join(', ');
+            return `portrait of ${name}, ${descriptions}, fantasy art style, detailed`;
+        }
+    }
+
+    // Simple fallback - just use the name
+    return `portrait of ${characterName}, character portrait, fantasy art style, detailed face, high quality`;
+}
+
+/**
+ * Generates a single avatar using the /sd command
+ *
+ * @param {string} characterName - Name of character to generate avatar for
+ * @param {string|null} prompt - The prompt to use (optional, will fallback if null)
+ * @returns {Promise<string|null>} Avatar URL or null if failed
+ */
+async function generateSingleAvatar(characterName, prompt = null) {
+    // Use provided prompt, or check cache, or build fallback
+    if (!prompt) {
+        prompt = sessionAvatarPrompts[characterName];
+    }
+
+    if (!prompt) {
+        // console.log(`[RPG Avatar] No LLM prompt for ${characterName}, using fallback prompt`);
+        prompt = buildFallbackPrompt(characterName);
+    }
+
+    // console.log(`[RPG Avatar] Starting image generation for: ${characterName}`);
+
+    try {
+        // Execute /sd command with quiet=true to suppress chat output
+        const result = await executeSlashCommandsOnChatInput(
+            `/sd quiet=true ${prompt}`,
+            { clearChatInput: false }
+        );
+
+        // Extract image URL from result
+        const imageUrl = extractImageUrl(result);
+
+        if (imageUrl) {
+            // Store the avatar
+            if (!extensionSettings.npcAvatars) {
+                extensionSettings.npcAvatars = {};
+            }
+            extensionSettings.npcAvatars[characterName] = imageUrl;
+            saveSettings();
+
+            // console.log(`[RPG Avatar] Successfully generated avatar for: ${characterName}`);
+            return imageUrl;
+        } else {
+            console.warn(`[RPG Avatar] Failed to extract image URL for ${characterName}:`, result);
+            return null;
+        }
+    } catch (error) {
+        console.error(`[RPG Avatar] Generation failed for ${characterName}:`, error);
+        return null;
+    }
+}
+
+/**
+ * Extracts image URL from /sd command result
+ * Handles various result formats
+ *
+ * @param {any} result - Result from executeSlashCommandsOnChatInput
+ * @returns {string|null} Image URL or null
+ */
+function extractImageUrl(result) {
+    if (!result) return null;
+
+    // Handle string result
+    if (typeof result === 'string') {
+        // Validate it looks like a URL or data URI
+        if (result.startsWith('http') || result.startsWith('data:') || result.startsWith('/')) {
+            return result;
+        }
+        return null;
+    }
+
+    // Handle object result with various possible properties
+    if (typeof result === 'object') {
+        // Try common properties
+        const url = result.pipe || result.output || result.image || result.url || result.result;
+
+        if (url && typeof url === 'string') {
+            if (url.startsWith('http') || url.startsWith('data:') || url.startsWith('/')) {
+                return url;
+            }
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Clears all pending generations and resets state
+ */
+export function clearPendingGenerations() {
+    pendingGenerations.clear();
+}
+
+/**
+ * Gets the current generation status for display
+ * @returns {{pending: number, names: string[]}}
+ */
+export function getGenerationStatus() {
+    return {
+        pending: pendingGenerations.size,
+        names: [...pendingGenerations]
+    };
+}

src/systems/features/chapterCheckpoint.js

@@ -0,0 +1,189 @@
+/**
+ * Chapter Checkpoint Module
+ * Allows users to mark messages as "chapter start" points to filter context
+ * Uses SillyTavern's /hide and /unhide commands to exclude messages from context
+ */
+
+import { getContext } from '../../../../../../extensions.js';
+import { chat_metadata, saveChatDebounced } from '../../../../../../../script.js';
+import { executeSlashCommandsOnChatInput } from '../../../../../../../scripts/slash-commands.js';
+
+// Track the message range that is currently hidden
+let currentlyHiddenRange = null;
+
+// Debounce restore to prevent loops
+let isRestoring = false;
+let restoreTimeout = null;
+let pendingResolve = null;
+
+/**
+ * Gets the current chapter checkpoint message ID for the active chat
+ * @returns {number|null} Message ID of the checkpoint, or null if none set
+ */
+export function getChapterCheckpoint() {
+    const context = getContext();
+    if (!context || !chat_metadata) return null;
+
+    return chat_metadata.rpg_companion_chapter_checkpoint || null;
+}
+
+/**
+ * Sets a message as the chapter checkpoint
+ * Automatically clears any previous checkpoint (only one checkpoint allowed at a time)
+ * Hides all messages before the checkpoint
+ * @param {number} messageId - The chat message index to set as checkpoint
+ * @returns {Promise<boolean>} True if successful
+ */
+export async function setChapterCheckpoint(messageId) {
+    const context = getContext();
+    const chat = context.chat;
+
+    if (!chat || messageId < 0 || messageId >= chat.length) {
+        console.error('[RPG Companion] Invalid message ID for checkpoint:', messageId);
+        return false;
+    }
+
+    const previousCheckpoint = chat_metadata.rpg_companion_chapter_checkpoint;
+
+    // If moving checkpoint, unhide the old range first
+    if (previousCheckpoint !== null && previousCheckpoint !== undefined && previousCheckpoint !== messageId && currentlyHiddenRange !== null) {
+        const { start, end } = currentlyHiddenRange;
+        await executeSlashCommandsOnChatInput(`/unhide ${start}-${end}`, { quiet: true });
+        // console.log(`[RPG Companion] Unhid previous range: ${start}-${end}`);
+    }
+
+    // Store in chat metadata (this automatically overrides any previous checkpoint)
+    chat_metadata.rpg_companion_chapter_checkpoint = messageId;
+    saveChatDebounced();
+
+    // Hide all messages before the checkpoint
+    if (messageId > 0) {
+        const rangeEnd = messageId - 1;
+        await executeSlashCommandsOnChatInput(`/hide 0-${rangeEnd}`, { quiet: true });
+        currentlyHiddenRange = { start: 0, end: rangeEnd };
+        // console.log(`[RPG Companion] Hidden messages 0-${rangeEnd} (checkpoint at ${messageId})`);
+    }
+
+    if (previousCheckpoint !== null && previousCheckpoint !== undefined && previousCheckpoint !== messageId) {
+        // console.log(`[RPG Companion] Chapter checkpoint moved from message ${previousCheckpoint} to ${messageId}`);
+    } else {
+        // console.log('[RPG Companion] Chapter checkpoint set at message', messageId);
+    }
+
+    // Emit event for UI updates
+    if (typeof document !== 'undefined') {
+        const event = new CustomEvent('rpg-companion-checkpoint-changed', {
+            detail: { messageId, previousCheckpoint }
+        });
+        document.dispatchEvent(event);
+    }
+
+    return true;
+}
+
+/**
+ * Clears the chapter checkpoint and unhides all hidden messages
+ */
+export async function clearChapterCheckpoint() {
+    if (!chat_metadata) return;
+
+    // Unhide any hidden messages
+    if (currentlyHiddenRange !== null) {
+        const { start, end } = currentlyHiddenRange;
+        await executeSlashCommandsOnChatInput(`/unhide ${start}-${end}`, { quiet: true });
+        // console.log(`[RPG Companion] Unhid messages ${start}-${end}`);
+        currentlyHiddenRange = null;
+    }
+
+    delete chat_metadata.rpg_companion_chapter_checkpoint;
+    saveChatDebounced();
+
+    // console.log('[RPG Companion] Chapter checkpoint cleared');
+
+    // Emit event for UI updates
+    if (typeof document !== 'undefined') {
+        const event = new CustomEvent('rpg-companion-checkpoint-changed', {
+            detail: { messageId: null }
+        });
+        document.dispatchEvent(event);
+    }
+}
+
+/**
+ * Checks if a message is the current checkpoint
+ * @param {number} messageId - The message index to check
+ * @returns {boolean} True if this is the checkpoint message
+ */
+export function isCheckpointMessage(messageId) {
+    const checkpointId = getChapterCheckpoint();
+    return checkpointId === messageId;
+}
+
+/**
+ * Restores checkpoint state after page reload or generation events
+ * Checks if a checkpoint exists and re-applies the /hide command
+ * Debounced to prevent loops when called from multiple events
+ */
+export async function restoreCheckpointOnLoad() {
+    // Prevent concurrent executions
+    if (isRestoring) {
+        return;
+    }
+
+    // Clear any pending timeout and resolve the pending promise
+    if (restoreTimeout) {
+        clearTimeout(restoreTimeout);
+        restoreTimeout = null;
+    }
+    if (pendingResolve) {
+        pendingResolve();
+        pendingResolve = null;
+    }
+
+    // Debounce: wait 100ms before actually restoring
+    return new Promise((resolve) => {
+        pendingResolve = resolve;
+        restoreTimeout = setTimeout(async () => {
+            isRestoring = true;
+            try {
+                const checkpointId = getChapterCheckpoint();
+
+                if (checkpointId !== null && checkpointId !== undefined && checkpointId > 0) {
+                    const context = getContext();
+                    const chat = context.chat;
+
+                    if (chat && checkpointId < chat.length) {
+                        const rangeEnd = checkpointId - 1;
+
+                        // Check if messages are already hidden
+                        let needsRestore = false;
+                        let hiddenCount = 0;
+                        let visibleCount = 0;
+                        for (let i = 0; i <= rangeEnd; i++) {
+                            if (chat[i]) {
+                                if (chat[i].is_system) {
+                                    hiddenCount++;
+                                } else {
+                                    visibleCount++;
+                                    needsRestore = true;
+                                }
+                            }
+                        }
+
+                        if (needsRestore) {
+                            await executeSlashCommandsOnChatInput(`/hide 0-${rangeEnd}`, { quiet: true });
+                            currentlyHiddenRange = { start: 0, end: rangeEnd };
+                            // console.log(`[RPG Companion] Restored checkpoint: Hidden messages 0-${rangeEnd}`);
+                        } else {
+                            currentlyHiddenRange = { start: 0, end: rangeEnd };
+                        }
+                    }
+                }
+            } finally {
+                isRestoring = false;
+                pendingResolve = null;
+                resolve();
+            }
+        }, 100);
+    });
+}

src/systems/features/classicStats.js

@@ -8,6 +8,7 @@ import {
     $userStatsContainer
 } from '../../core/state.js';
 import { saveSettings, saveChatData } from '../../core/persistence.js';
+import { updateFabWidgets } from '../ui/mobile.js';
 
 /**
  * Sets up event listeners for classic stat +/- buttons using delegation.
@@ -19,24 +20,34 @@ export function setupClassicStatsButtons() {
     // Delegated event listener for increase buttons
     $userStatsContainer.on('click', '.rpg-stat-increase', function() {
         const stat = $(this).data('stat');
-        if (extensionSettings.classicStats[stat] < 100) {
+        // Initialize custom attributes if they don't exist
+        if (extensionSettings.classicStats[stat] === undefined) {
+            extensionSettings.classicStats[stat] = 10;
+        }
+        if (extensionSettings.classicStats[stat] < 999) {
             extensionSettings.classicStats[stat]++;
             saveSettings();
             saveChatData();
             // Update only the specific stat value, not the entire stats panel
             $(this).closest('.rpg-classic-stat').find('.rpg-classic-stat-value').text(extensionSettings.classicStats[stat]);
+            updateFabWidgets();
         }
     });
 
     // Delegated event listener for decrease buttons
     $userStatsContainer.on('click', '.rpg-stat-decrease', function() {
         const stat = $(this).data('stat');
+        // Initialize custom attributes if they don't exist
+        if (extensionSettings.classicStats[stat] === undefined) {
+            extensionSettings.classicStats[stat] = 10;
+        }
         if (extensionSettings.classicStats[stat] > 1) {
             extensionSettings.classicStats[stat]--;
             saveSettings();
             saveChatData();
             // Update only the specific stat value, not the entire stats panel
             $(this).closest('.rpg-classic-stat').find('.rpg-classic-stat-value').text(extensionSettings.classicStats[stat]);
+            updateFabWidgets();
         }
     });
 }

src/systems/features/dice.js

@@ -85,6 +85,15 @@ export async function executeRollCommand(command) {
  * Updates the dice display in the sidebar.
  */
 export function updateDiceDisplay() {
+    // Hide the entire dice display if showDiceDisplay is false
+    const $display = $('#rpg-dice-display');
+    if (!extensionSettings.showDiceDisplay) {
+        $display.hide();
+        return;
+    } else {
+        $display.show();
+    }
+
     const lastRoll = extensionSettings.lastDiceRoll;
     const label = i18n.getTranslation('template.mainPanel.lastRoll') || 'Last Roll: ';
     const noneValue = i18n.getTranslation('global.none') || 'None';
@@ -98,6 +107,7 @@ export function updateDiceDisplay() {
 
 /**
  * Clears the last dice roll.
+ * Called when the x button is clicked.
  */
 export function clearDiceRoll() {
     extensionSettings.lastDiceRoll = null;

src/systems/features/encounterState.js

@@ -0,0 +1,130 @@
+/**
+ * Encounter State Module
+ * Manages combat encounter state and history
+ */
+
+/**
+ * Current encounter state
+ */
+export let currentEncounter = {
+    active: false,
+    initialized: false,
+    combatHistory: [], // Array of {role: 'user'|'assistant'|'system', content: string}
+    combatStats: null, // Current combat stats (HP, party, enemies, etc.)
+    preEncounterContext: [], // Messages from before the encounter started
+    encounterStartMessage: '', // The message that triggered the encounter
+    encounterLog: [] // Full log of combat actions for final summary
+};
+
+/**
+ * Encounter logs storage (per chat)
+ */
+export let encounterLogs = {
+    // chatId: [
+    //   {
+    //     timestamp: Date,
+    //     log: [],
+    //     summary: string,
+    //     result: 'victory'|'defeat'|'fled'
+    //   }
+    // ]
+};
+
+/**
+ * Sets the current encounter state
+ * @param {object} encounter - The encounter state object
+ */
+export function setCurrentEncounter(encounter) {
+    currentEncounter = encounter;
+}
+
+/**
+ * Updates current encounter state with partial data
+ * @param {object} updates - Partial encounter state to merge
+ */
+export function updateCurrentEncounter(updates) {
+    Object.assign(currentEncounter, updates);
+}
+
+/**
+ * Resets the encounter state
+ */
+export function resetEncounter() {
+    currentEncounter = {
+        active: false,
+        initialized: false,
+        combatHistory: [],
+        combatStats: null,
+        preEncounterContext: [],
+        encounterStartMessage: '',
+        encounterLog: []
+    };
+}
+
+/**
+ * Adds a message to combat history
+ * @param {string} role - Message role ('user', 'assistant', or 'system')
+ * @param {string} content - Message content
+ */
+export function addCombatMessage(role, content) {
+    currentEncounter.combatHistory.push({ role, content });
+}
+
+/**
+ * Adds an entry to the encounter log
+ * @param {string} action - The action taken
+ * @param {string} result - The result of the action
+ */
+export function addEncounterLogEntry(action, result) {
+    currentEncounter.encounterLog.push({
+        timestamp: Date.now(),
+        action,
+        result
+    });
+}
+
+/**
+ * Saves an encounter log for a specific chat
+ * @param {string} chatId - The chat identifier
+ * @param {object} logData - The encounter log data
+ */
+export function saveEncounterLog(chatId, logData) {
+    if (!encounterLogs[chatId]) {
+        encounterLogs[chatId] = [];
+    }
+    encounterLogs[chatId].push({
+        timestamp: new Date(),
+        log: logData.log || [],
+        summary: logData.summary || '',
+        result: logData.result || 'unknown'
+    });
+}
+
+/**
+ * Gets encounter logs for a specific chat
+ * @param {string} chatId - The chat identifier
+ * @returns {Array} Array of encounter logs
+ */
+export function getEncounterLogs(chatId) {
+    return encounterLogs[chatId] || [];
+}
+
+/**
+ * Clears all encounter logs for a specific chat
+ * @param {string} chatId - The chat identifier
+ */
+export function clearEncounterLogs(chatId) {
+    if (encounterLogs[chatId]) {
+        delete encounterLogs[chatId];
+    }
+}
+
+/**
+ * Exports encounter logs as JSON
+ * @param {string} chatId - The chat identifier
+ * @returns {string} JSON string of encounter logs
+ */
+export function exportEncounterLogs(chatId) {
+    const logs = getEncounterLogs(chatId);
+    return JSON.stringify(logs, null, 2);
+}

src/systems/features/htmlCleaning.js

@@ -63,7 +63,7 @@ export async function ensureHtmlCleaningRegex(st_extension_settings, saveSetting
         );
 
         if (alreadyExists) {
-            console.log('[RPG Companion] HTML cleaning regex already exists, skipping import');
+            // console.log('[RPG Companion] HTML cleaning regex already exists, skipping import');
             return;
         }
 
@@ -107,10 +107,93 @@ export async function ensureHtmlCleaningRegex(st_extension_settings, saveSetting
             console.warn('[RPG Companion] saveSettingsDebounced is not a function, cannot save HTML regex');
         }
 
-        console.log('[RPG Companion] ✅ HTML cleaning regex imported successfully');
+        // console.log('[RPG Companion] ✅ HTML cleaning regex imported successfully');
     } catch (error) {
         console.error('[RPG Companion] Failed to import HTML cleaning regex:', error);
         console.error('[RPG Companion] Error details:', error.message, error.stack);
         // Don't throw - this is a nice-to-have feature
     }
 }
+
+/**
+ * Automatically imports a regex script to clean tracker JSON from outgoing prompts.
+ * This is useful when switching from together mode to separate mode mid-roleplay,
+ * as it prevents old tracker JSON from chat history being sent to the AI.
+ * @param {Object} st_extension_settings - SillyTavern extension settings object
+ * @param {Function} saveSettingsDebounced - Function to save settings
+ */
+export async function ensureTrackerCleaningRegex(st_extension_settings, saveSettingsDebounced) {
+    try {
+        // Validate extension settings structure
+        if (!st_extension_settings || typeof st_extension_settings !== 'object') {
+            console.warn('[RPG Companion] Invalid extension_settings object, skipping tracker cleaning regex import');
+            return;
+        }
+
+        // Check if the tracker cleaning regex already exists
+        const scriptName = 'Clean RPG Trackers (From Outgoing Prompt)';
+        const existingScripts = st_extension_settings?.regex || [];
+
+        // Validate regex array
+        if (!Array.isArray(existingScripts)) {
+            console.warn('[RPG Companion] extension_settings.regex is not an array, resetting to empty array');
+            st_extension_settings.regex = [];
+        }
+
+        const alreadyExists = existingScripts.some(script =>
+            script && typeof script === 'object' && script.scriptName === scriptName
+        );
+
+        if (alreadyExists) {
+            // console.log('[RPG Companion] Tracker cleaning regex already exists, skipping import');
+            return;
+        }
+
+        // Generate a UUID for the script
+        const uuidv4 = () => {
+            return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+                const r = Math.random() * 16 | 0;
+                const v = c === 'x' ? r : (r & 0x3 | 0x8);
+                return v.toString(16);
+            });
+        };
+
+        // Create the regex script to remove ```json...``` blocks containing tracker data
+        // This regex matches markdown code blocks with "json" language tag
+        const regexScript = {
+            id: uuidv4(),
+            scriptName: scriptName,
+            findRegex: '/```json\\s*\\n\\{[\\s\\S]*?(?:\"userStats\"|\"infoBox\"|\"characters\")[\\s\\S]*?\\}\\s*\\n```/gm',
+            replaceString: '',
+            trimStrings: [],
+            placement: [2], // 2 = Input (affects outgoing prompt)
+            disabled: false,
+            markdownOnly: false,
+            promptOnly: true,
+            runOnEdit: true,
+            substituteRegex: 0,
+            minDepth: null,
+            maxDepth: null
+        };
+
+        // Add to global regex scripts
+        if (!Array.isArray(st_extension_settings.regex)) {
+            st_extension_settings.regex = [];
+        }
+
+        st_extension_settings.regex.push(regexScript);
+
+        // Save the changes
+        if (typeof saveSettingsDebounced === 'function') {
+            saveSettingsDebounced();
+        } else {
+            console.warn('[RPG Companion] saveSettingsDebounced is not a function, cannot save tracker cleaning regex');
+        }
+
+        // console.log('[RPG Companion] ✅ Tracker cleaning regex imported successfully');
+    } catch (error) {
+        console.error('[RPG Companion] Failed to import tracker cleaning regex:', error);
+        console.error('[RPG Companion] Error details:', error.message, error.stack);
+        // Don't throw - this is a nice-to-have feature
+    }
+}

src/systems/features/jsonCleaning.js

@@ -0,0 +1,167 @@
+/**
+ * JSON Cleaning Module
+ * Automatically registers a regex script to strip tracker JSON from Together mode output
+ */
+
+/**
+ * Registers an output transformation regex to remove tracker JSON from messages
+ * This uses SillyTavern's built-in regex system to transform text BEFORE display
+ * @param {Object} st_extension_settings - SillyTavern extension settings object
+ * @param {Function} saveSettingsDebounced - Function to save settings
+ */
+export async function ensureJsonCleaningRegex(st_extension_settings, saveSettingsDebounced) {
+    try {
+        // Validate extension settings structure
+        if (!st_extension_settings || typeof st_extension_settings !== 'object') {
+            console.warn('[RPG Companion] Invalid extension_settings object, skipping JSON cleaning regex');
+            return;
+        }
+
+        // Check if the JSON cleaning regex already exists
+        const scriptName = 'RPG Companion - Remove Tracker JSON (Together Mode)';
+        const existingScripts = st_extension_settings?.regex || [];
+
+        // Validate regex array
+        if (!Array.isArray(existingScripts)) {
+            console.warn('[RPG Companion] extension_settings.regex is not an array, resetting to empty array');
+            st_extension_settings.regex = [];
+        }
+
+        const existingScript = existingScripts.find(script =>
+            script && script.scriptName && script.scriptName === scriptName
+        );
+
+        if (existingScript) {
+            // Update existing script with new regex pattern if it's different
+            const newPattern = '/```(?:json|markdown)?[\\s\\S]*?```/gim';
+
+            // Always ensure these properties are set correctly
+            let needsSave = false;
+
+            if (existingScript.findRegex !== newPattern) {
+                existingScript.findRegex = newPattern;
+                needsSave = true;
+            }
+
+            if (JSON.stringify(existingScript.placement) !== JSON.stringify([2])) {
+                existingScript.placement = [2]; // 2 = AI Output
+                needsSave = true;
+            }
+
+            if (existingScript.disabled !== false) {
+                existingScript.disabled = false;
+                needsSave = true;
+            }
+
+            if (existingScript.runOnEdit !== true) {
+                existingScript.runOnEdit = true;
+                needsSave = true;
+            }
+
+            if (existingScript.markdownOnly !== true) {
+                existingScript.markdownOnly = true; // Only process markdown
+                needsSave = true;
+            }
+
+            if (existingScript.promptOnly !== true) {
+                existingScript.promptOnly = true; // Enable prompt processing
+                needsSave = true;
+            }
+
+            if (needsSave && typeof saveSettingsDebounced === 'function') {
+                // Force immediate save and wait for it
+                const saveResult = saveSettingsDebounced();
+                if (saveResult && typeof saveResult.then === 'function') {
+                    await saveResult;
+                }
+                // Small delay to ensure save completes
+                await new Promise(resolve => setTimeout(resolve, 100));
+                console.log('[RPG Companion] ✅ Updated JSON cleaning regex to v3.2.3 settings.');
+            } else {
+                console.log('[RPG Companion] JSON Cleaning Regex is up to date.');
+            }
+
+            return;
+        }
+
+        // Generate a UUID for the script
+        const uuidv4 = () => {
+            return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+                const r = Math.random() * 16 | 0;
+                const v = c === 'x' ? r : (r & 0x3 | 0x8);
+                return v.toString(16);
+            });
+        };
+
+        // Create the regex script object for cleaning JSON tracker data
+        // This regex matches ```json...```, ```markdown...```, or plain ```...``` code blocks
+        // The prompt now explicitly instructs models to use this format
+        // Updated to handle various whitespace scenarios and ensure it catches all variations
+        const regexScript = {
+            id: uuidv4(),
+            scriptName: scriptName,
+            // Match ```json...```, ```markdown...```, or ```...``` code blocks (handles spaces, newlines, any content)
+            // Using a more permissive pattern to catch all variations
+            findRegex: '/```(?:json|markdown)?[\\s\\S]*?```/gim',
+            replaceString: '',
+            trimStrings: [],
+            placement: [2], // 2 = AI Output
+            disabled: false,
+            markdownOnly: true,
+            promptOnly: true, // Enable prompt processing
+            runOnEdit: true,
+            substituteRegex: 0,
+            minDepth: null,
+            maxDepth: null
+        };
+
+        // Add to global regex scripts
+        if (!Array.isArray(st_extension_settings.regex)) {
+            st_extension_settings.regex = [];
+        }
+
+        st_extension_settings.regex.push(regexScript);
+        console.log('[RPG Companion] JSON Cleaning Regex created and activated.');
+
+        // Save the changes
+        if (typeof saveSettingsDebounced === 'function') {
+            saveSettingsDebounced();
+        } else {
+            console.warn('[RPG Companion] saveSettingsDebounced is not a function, cannot save JSON cleaning regex');
+        }
+    } catch (error) {
+        console.error('[RPG Companion] JSON Cleaning Regex failed to properly initialize!');
+        console.error('[RPG Companion] Error details:', error.message, error.stack);
+        // Don't throw - continue without it
+    }
+}
+
+/**
+ * Removes the JSON cleaning regex if it exists
+ * Useful when switching to separate mode or disabling the feature
+ * @param {Object} st_extension_settings - SillyTavern extension settings object
+ * @param {Function} saveSettingsDebounced - Function to save settings
+ */
+export function removeJsonCleaningRegex(st_extension_settings, saveSettingsDebounced) {
+    try {
+        if (!st_extension_settings?.regex || !Array.isArray(st_extension_settings.regex)) {
+            return;
+        }
+
+        const scriptName = 'RPG Companion - Remove Tracker JSON (Together Mode)';
+        const initialLength = st_extension_settings.regex.length;
+
+        st_extension_settings.regex = st_extension_settings.regex.filter(script =>
+            !script || !script.scriptName || script.scriptName !== scriptName
+        );
+
+        if (st_extension_settings.regex.length < initialLength) {
+            // console.log('[RPG Companion] Removed JSON cleaning regex');
+            if (typeof saveSettingsDebounced === 'function') {
+                saveSettingsDebounced();
+            }
+        }
+    } catch (error) {
+        console.error('[RPG Companion] Failed to remove JSON cleaning regex:', error);
+    }
+}

src/systems/features/lorebookLimiter.js

@@ -1,267 +0,0 @@
-/**
- * Lorebook Limiter Module
- * Adds maximum activation limit to SillyTavern's World Info system
- */
-
-import { eventSource, event_types } from '../../../../../../../script.js';
-
-let maxActivations = 0; // 0 = unlimited
-let settingsInitialized = false;
-let activatedEntriesThisGeneration = [];
-
-/**
- * Initialize the lorebook limiter
- */
-export function initLorebookLimiter() {
-    console.log('[Lorebook Limiter] Initializing...');
-
-    // Load saved setting
-    const saved = localStorage.getItem('rpg_max_lorebook_activations');
-    if (saved !== null) {
-        maxActivations = parseInt(saved, 10);
-    }
-
-    // Wait for World Info settings to be ready
-    eventSource.on('worldInfoSettings', () => {
-        setTimeout(() => {
-            if (!settingsInitialized) {
-                injectMaxActivationsUI();
-                settingsInitialized = true;
-            }
-        }, 100);
-    });
-
-    // Try when the WI drawer is opened
-    const tryInjectOnClick = () => {
-        const wiButton = document.querySelector('#WIDrawerIcon');
-        if (wiButton) {
-            wiButton.addEventListener('click', () => {
-                setTimeout(() => {
-                    if (!settingsInitialized) {
-                        injectMaxActivationsUI();
-                        settingsInitialized = true;
-                    }
-                }, 300);
-            });
-            console.log('[Lorebook Limiter] Attached to WI drawer button');
-        }
-    };
-
-    // Also try on app ready
-    eventSource.on('app_ready', () => {
-        setTimeout(() => {
-            tryInjectOnClick();
-            if (!settingsInitialized) {
-                injectMaxActivationsUI();
-                settingsInitialized = true;
-            }
-        }, 1000);
-    });
-
-    // Patch the world info activation system
-    patchWorldInfoActivation();
-}
-
-/**
- * Inject the Maximum Activations UI into World Info settings
- */
-function injectMaxActivationsUI() {
-    console.log('[Lorebook Limiter] Injecting UI...');
-
-    // Check if already injected
-    if (document.querySelector('#rpg-max-lorebook-activations-container')) {
-        console.log('[Lorebook Limiter] UI already injected');
-        return;
-    }
-
-    // Find the Memory Recollection button - we'll add our UI right after it
-    const memoryButton = document.querySelector('.rpg-memory-recollection-btn');
-
-    if (!memoryButton) {
-        console.log('[Lorebook Limiter] Memory Recollection button not found yet');
-        return;
-    }
-
-    const container = memoryButton.parentElement;
-    if (!container) {
-        console.log('[Lorebook Limiter] Could not find button container');
-        return;
-    }
-
-    console.log('[Lorebook Limiter] Found Memory Recollection button, injecting slider after it');
-
-    // Create the UI - styled to match the extension's theme
-    const settingHTML = `
-        <div id="rpg-max-lorebook-activations-container" class="rpg-lorebook-limiter-container">
-            <label class="rpg-lorebook-limiter-label">
-                <span class="rpg-lorebook-limiter-title">Max Lorebook Activations</span>
-                <input type="number"
-                       id="rpg-max-activations-input"
-                       class="rpg-lorebook-limiter-input"
-                       min="0"
-                       max="9999"
-                       step="1"
-                       value="${maxActivations}"
-                       placeholder="0 = unlimited" />
-            </label>
-            <small class="rpg-lorebook-limiter-hint">Limit entries per generation (0 = unlimited)</small>
-        </div>
-    `;
-
-    // Insert after the Memory Recollection button
-    memoryButton.insertAdjacentHTML('afterend', settingHTML);
-
-    // Add event listener
-    const input = document.querySelector('#rpg-max-activations-input');
-
-    if (input) {
-        input.addEventListener('input', (e) => {
-            let value = parseInt(e.target.value, 10);
-            if (isNaN(value) || value < 0) value = 0;
-            if (value > 9999) value = 9999;
-
-            maxActivations = value;
-            e.target.value = value;
-            localStorage.setItem('rpg_max_lorebook_activations', value.toString());
-            console.log(`[Lorebook Limiter] Max activations set to: ${value}`);
-        });
-
-        console.log('[Lorebook Limiter] ✅ UI injected successfully');
-    }
-}
-
-/**
- * Patch the world info activation system to enforce the limit
- */
-function patchWorldInfoActivation() {
-    console.log('[Lorebook Limiter] Setting up activation limiter...');
-
-    // We need to intercept at the module level
-    // Use a Proxy on the module loader
-    const originalDefine = window.define;
-    const originalRequire = window.require;
-
-    // Try multiple approaches to hook into the WI system
-    const attemptPatch = () => {
-        // Approach 1: Direct window access
-        if (window.getWorldInfoPrompt) {
-            const original = window.getWorldInfoPrompt;
-            window.getWorldInfoPrompt = async function(...args) {
-                const result = await original.apply(this, args);
-
-                if (maxActivations > 0 && result) {
-                    // Count entries in the worldInfoString
-                    const lines = (result.worldInfoBefore + result.worldInfoAfter).split('\n').filter(l => l.trim());
-                    if (lines.length > maxActivations) {
-                        console.log(`[Lorebook Limiter] Limiting ${lines.length} WI lines to ${maxActivations}`);
-
-                        // Trim the strings
-                        const limitedLines = lines.slice(0, maxActivations);
-                        result.worldInfoBefore = limitedLines.join('\n');
-                        result.worldInfoAfter = '';
-                        result.worldInfoString = result.worldInfoBefore;
-
-                        console.log(`[Lorebook Limiter] ✅ Limited from ${lines.length} to ${limitedLines.length} entries`);
-                    }
-                }
-
-                return result;
-            };
-
-            console.log('[Lorebook Limiter] ✅ Patched window.getWorldInfoPrompt');
-            return true;
-        }
-
-        // Approach 2: Through SillyTavern context
-        if (window.SillyTavern?.getContext) {
-            const ctx = window.SillyTavern.getContext();
-            if (ctx.getWorldInfoPrompt) {
-                const original = ctx.getWorldInfoPrompt;
-                ctx.getWorldInfoPrompt = async function(...args) {
-                    const result = await original.apply(this, args);
-
-                    if (maxActivations > 0 && result) {
-                        const lines = (result.worldInfoBefore + result.worldInfoAfter).split('\n').filter(l => l.trim());
-                        if (lines.length > maxActivations) {
-                            console.log(`[Lorebook Limiter] Limiting ${lines.length} WI entries to ${maxActivations}`);
-                            const limitedLines = lines.slice(0, maxActivations);
-                            result.worldInfoBefore = limitedLines.join('\n');
-                            result.worldInfoAfter = '';
-                            result.worldInfoString = result.worldInfoBefore;
-                        }
-                    }
-
-                    return result;
-                };
-
-                console.log('[Lorebook Limiter] ✅ Patched SillyTavern.getContext().getWorldInfoPrompt');
-                return true;
-            }
-
-            // Try checkWorldInfo instead
-            if (ctx.checkWorldInfo) {
-                const original = ctx.checkWorldInfo;
-                ctx.checkWorldInfo = async function(...args) {
-                    const result = await original.apply(this, args);
-
-                    if (maxActivations > 0 && result?.allActivatedEntries?.size > maxActivations) {
-                        console.log(`[Lorebook Limiter] Limiting ${result.allActivatedEntries.size} entries to ${maxActivations}`);
-
-                        // Keep only first N entries
-                        const entries = Array.from(result.allActivatedEntries.entries());
-                        result.allActivatedEntries = new Map(entries.slice(0, maxActivations));
-
-                        // Also limit the string output
-                        const lines = (result.worldInfoBefore + result.worldInfoAfter).split('\n').filter(l => l.trim());
-                        if (lines.length > maxActivations) {
-                            const limitedLines = lines.slice(0, maxActivations);
-                            result.worldInfoBefore = limitedLines.join('\n');
-                            result.worldInfoAfter = '';
-                        }
-
-                        console.log(`[Lorebook Limiter] ✅ Limited to ${result.allActivatedEntries.size} entries`);
-                    }
-
-                    return result;
-                };
-
-                console.log('[Lorebook Limiter] ✅ Patched SillyTavern.getContext().checkWorldInfo');
-                return true;
-            }
-        }
-
-        return false;
-    };
-
-    // Try immediately
-    if (!attemptPatch()) {
-        // Retry after delays
-        setTimeout(() => attemptPatch() || setTimeout(() => attemptPatch(), 2000), 1000);
-    }
-}
-
-/**
- * Update the maximum activations limit
- */
-export function setMaxActivations(value) {
-    maxActivations = parseInt(value, 10);
-    localStorage.setItem('rpg_max_lorebook_activations', value.toString());
-
-    // Update UI if it exists
-    const valueDisplay = document.querySelector('#rpg-max-activations-value');
-    const slider = document.querySelector('#rpg-max-activations-slider');
-
-    if (valueDisplay) {
-        valueDisplay.textContent = value;
-    }
-    if (slider) {
-        slider.value = value;
-    }
-}
-
-/**
- * Get current maximum activations limit
- */
-export function getMaxActivations() {
-    return maxActivations;
-}

src/systems/features/memoryRecollection.js

@@ -1,843 +0,0 @@
-/**
- * Memory Recollection Module
- * Handles generation of lorebook entries from chat history
- */
-
-import { chat, characters, this_chid, generateRaw, substituteParams, eventSource, event_types } from '../../../../../../../script.js';
-import { selected_group } from '../../../../../../group-chats.js';
-import { extensionSettings, addDebugLog } from '../../core/state.js';
-import { saveSettings } from '../../core/persistence.js';
-import { checkWorldInfo, createNewWorldInfo, openWorldInfoEditor, saveWorldInfo, setWorldInfoSettings } from '../../../../../../world-info.js';
-
-/**
- * Helper to log to both console and debug logs array
- */
-function debugLog(message, data = null) {
-    if (data !== null && data !== undefined) {
-        console.log(message, data);
-    } else {
-        console.log(message);
-    }
-    if (extensionSettings.debugMode) {
-        addDebugLog(message, data);
-    }
-}
-
-/**
- * Get or create the Memory Recollection lorebook
- * @returns {Promise<string>} The UID of the Memory Recollection lorebook
- */
-async function getOrCreateMemoryLorebook() {
-    const lorebookName = 'Memory Recollection';
-
-    try {
-        debugLog('[Memory Recollection] Checking for existing lorebook...');
-
-        // Use checkWorldInfo to see if it exists
-        const exists = await checkWorldInfo(lorebookName);
-
-        if (exists) {
-            debugLog('[Memory Recollection] Found existing lorebook:', lorebookName);
-            return lorebookName;
-        }
-
-        // Create new lorebook using SillyTavern's imported function
-        debugLog('[Memory Recollection] Creating new Memory Recollection lorebook');
-
-        // Call the imported createNewWorldInfo function
-        await createNewWorldInfo(lorebookName, true);
-
-        debugLog('[Memory Recollection] Created lorebook:', lorebookName);
-
-        // Wait for the file system to settle
-        await new Promise(resolve => setTimeout(resolve, 500));
-
-        return lorebookName;
-    } catch (error) {
-        console.error('[Memory Recollection] Error in getOrCreateMemoryLorebook:', error);
-        throw error;
-    }
-}
-/**
- * Create the constant "Relevant Memories:" header entry
- * @param {string} lorebookUid - The UID of the lorebook
- * @returns {Object} The header entry object
- */
-function createConstantHeaderEntry() {
-    const entry = {
-        uid: 1, // Fixed UID so it's always first
-        key: [],
-        keysecondary: [],
-        comment: 'Relevant Memories Header',
-        content: 'Relevant Memories:',
-        constant: true, // Always inserted
-        vectorized: false,
-        selective: false,
-        selectiveLogic: 0,
-        addMemo: false,
-        order: 99, // First in order
-        position: 4, // at Depth
-        disable: false,
-        ignoreBudget: false,
-        excludeRecursion: false,
-        preventRecursion: false,
-        matchPersonaDescription: false,
-        matchCharacterDescription: false,
-        matchCharacterPersonality: false,
-        matchCharacterDepthPrompt: false,
-        matchScenario: false,
-        matchCreatorNotes: false,
-        delayUntilRecursion: false,
-        probability: 100,
-        useProbability: true,
-        depth: 1, // Insertion depth
-        outletName: '',
-        group: '',
-        groupOverride: false,
-        groupWeight: 100,
-        scanDepth: null,
-        caseSensitive: null,
-        matchWholeWords: null,
-        useGroupScoring: null,
-        automationId: '',
-        role: 0, // System role
-        sticky: 0,
-        cooldown: 0,
-        delay: 0,
-        triggers: [],
-        displayIndex: 0,
-        characterFilter: {
-            isExclude: false,
-            names: [],
-            tags: []
-        }
-    };
-
-    debugLog('[Memory Recollection] Created constant header entry');
-    return entry;
-}
-
-/**
- * Save a world info entry to a lorebook
- * @param {string} lorebookUid - The filename/UID of the lorebook
- * @param {Object} entry - The entry data
- */
-async function saveWorldInfoEntry(lorebookUid, entry) {
-    try {
-        debugLog('[Memory Recollection] Saving entry to lorebook:', lorebookUid);
-
-        // Open the world info editor for this lorebook to load its data
-        await openWorldInfoEditor(lorebookUid);
-
-        // Wait for it to load
-        await new Promise(resolve => setTimeout(resolve, 500));
-
-        // Now access the loaded world info data
-        const worldInfo = window.world_info;
-
-        debugLog('[Memory Recollection] World info after opening:', {
-            type: typeof worldInfo,
-            isArray: Array.isArray(worldInfo),
-            hasEntries: worldInfo?.entries !== undefined,
-            keys: worldInfo ? Object.keys(worldInfo).slice(0, 10) : null
-        });
-
-        // Try different structures - it might be an array or might have different properties
-        let entries;
-        if (worldInfo && typeof worldInfo === 'object') {
-            if (worldInfo.entries) {
-                entries = worldInfo.entries;
-            } else if (Array.isArray(worldInfo)) {
-                // If it's an array, convert to entries object
-                entries = {};
-                worldInfo.forEach((e, i) => {
-                    if (e && e.uid) {
-                        entries[e.uid] = e;
-                    }
-                });
-            }
-        }
-
-        if (!entries) {
-            entries = {};
-        }
-
-        // Add the entry
-        entries[entry.uid] = entry;
-
-        debugLog('[Memory Recollection] Entry added, saving world info...');
-
-        // Save using the imported saveWorldInfo function
-        // Pass the entries as the data structure
-        await saveWorldInfo(lorebookUid, { entries });
-
-        debugLog('[Memory Recollection] Entry saved successfully');
-        return { success: true };
-    } catch (error) {
-        console.error('[Memory Recollection] Error saving entry:', error);
-        throw error;
-    }
-}
-
-/**
- * Save multiple world info entries to a lorebook at once
- * @param {string} lorebookUid - The filename/UID of the lorebook
- * @param {Array} newEntries - Array of entry objects to add
- */
-async function saveWorldInfoEntries(lorebookUid, newEntries) {
-    try {
-        debugLog(`[Memory Recollection] Saving ${newEntries.length} entries to lorebook:`, lorebookUid);
-
-        // Open the world info editor for this lorebook to load its data
-        await openWorldInfoEditor(lorebookUid);
-
-        // Wait for it to load
-        await new Promise(resolve => setTimeout(resolve, 500));
-
-        // Now access the loaded world info data
-        const worldInfo = window.world_info;
-
-        // Try different structures - it might be an array or might have different properties
-        let entries = {};
-        if (worldInfo && typeof worldInfo === 'object') {
-            if (worldInfo.entries) {
-                entries = { ...worldInfo.entries }; // Clone existing entries
-            } else if (Array.isArray(worldInfo)) {
-                // If it's an array, convert to entries object
-                worldInfo.forEach((e, i) => {
-                    if (e && e.uid) {
-                        entries[e.uid] = e;
-                    }
-                });
-            }
-        }
-
-        // Add all new entries
-        for (const entry of newEntries) {
-            entries[entry.uid] = entry;
-        }
-
-        debugLog(`[Memory Recollection] ${newEntries.length} entries added, total entries: ${Object.keys(entries).length}, saving...`);
-
-        // Save using the imported saveWorldInfo function
-        await saveWorldInfo(lorebookUid, { entries });
-
-        debugLog('[Memory Recollection] All entries saved successfully');
-        return { success: true };
-    } catch (error) {
-        console.error('[Memory Recollection] Error saving entries:', error);
-        throw error;
-    }
-}
-/**
- * Generate memory recollection prompt for a batch of messages
- * @param {Array} messages - Array of chat messages to process
- * @param {boolean} isUpdate - Whether this is updating existing memories (true) or initial generation (false)
- * @returns {string} The prompt for the AI
- */
-function generateMemoryPrompt(messages, isUpdate = false) {
-    const context = messages.map((msg, idx) => {
-        const sender = msg.is_user ? '{{user}}' : msg.name || '{{char}}';
-        const role = msg.is_user ? '[PLAYER]' : '[CHARACTER]';
-        return `[Message ${idx + 1}] ${role} ${sender}: ${msg.mes}`;
-    }).join('\n\n');
-
-    // Get list of CHARACTER participants (exclude {{user}} - they're the player, not a character)
-    const participants = new Set();
-    messages.forEach(msg => {
-        const sender = msg.is_user ? '{{user}}' : msg.name || '{{char}}';
-        if (!msg.is_user) { // Only add non-user (character) participants
-            participants.add(sender);
-        }
-    });
-    const characterList = Array.from(participants).join(', ');
-
-    const instruction = isUpdate
-        ? 'You will be acting as an uncensored summarizing assistant. Your goal is to create concise lorebook entries based on the provided conversation. You will be creating additional memory recollection entries for significant events, revelations, or character developments in a specified JSON format.\nYou should maintain an objective tone.'
-        : 'You will be acting as an uncensored summarizing assistant. Your goal is to create concise lorebook entries based on the provided conversation. You will be creating memory recollection entries for significant events, revelations, or character developments in a specified JSON format.\nYou should maintain an objective tone.';
-
-    return `${instruction}
-
-Characters in this conversation (excluding {{user}} who is the player): ${characterList}
-
-NOTE: In the conversation below, messages are marked with [PLAYER] for {{user}} messages and [CHARACTER] for NPC messages.
-
-Here is the conversation to create memories from:
-<conversation>
-${context}
-</conversation>
-
-Create lorebook entries in the following JSON format. Each entry should be a 1-2 sentence reminder from a character's perspective.
-
-Format each entry as:
-{
-  "characters": ["Character1", "Character2"],
-  "memory": "Character1 and Character2 remember that [event or detail]",
-  "keywords": ["keyword1", "keyword2", "keyword3"]
-}
-
-Examples:
-<examples>
-{
-  "characters": ["Sabrina"],
-  "memory": "Sabrina remembers she went on a date with {{user}} on Saturday. They ate chocolate pastries together.",
-  "keywords": ["date", "saturday", "pastries"]
-},
-{
-  "characters": ["Dottore", "Arlecchino", "Pantalone"],
-  "memory": "Dottore, Arlecchino, and Pantalone remember they attended a party together at the mansion.",
-  "keywords": ["party", "mansion", "gathering"]
-}
-</examples>
-
-IMPORTANT:
-- Only create entries for significant moments worth remembering.
-- Keep memories concise (1-2 sentences maximum).
-- Use third person perspective: "{name} remembers..."
-- Choose 3 specific, relevant keywords per entry.
-- ONLY assign memories to CHARACTERS (NPCs) - NEVER include {{user}} in the "characters" array.
-- {{user}} is the player, not a character, so they should NEVER be in the characters list.
-- Only characters who were ACTUALLY PRESENT in that specific scene/moment should remember it.
-- If multiple characters share the memory, list all of them in the "characters" array.
-- If known, include details such as dates, locations, and other relevant context in the memories.
-
-Return ONLY a JSON array of memory objects, nothing else:`;
-}
-
-/**
- * Parse the AI response to extract memory entries
- * @param {string} response - The AI's response
- * @returns {Array<Object>} Array of parsed memory entries
- */
-function parseMemoryResponse(response) {
-    try {
-        // Try to extract JSON from code blocks
-        const jsonMatch = response.match(/```(?:json)?\s*(\[[\s\S]*?\])\s*```/);
-        const jsonString = jsonMatch ? jsonMatch[1] : response;
-
-        // Parse JSON
-        const memories = JSON.parse(jsonString.trim());
-
-        if (!Array.isArray(memories)) {
-            throw new Error('Response is not an array');
-        }
-
-        debugLog('[Memory Recollection] Parsed memories:', memories);
-        return memories;
-
-    } catch (error) {
-        debugLog('[Memory Recollection] Failed to parse response:', error);
-        console.error('[Memory Recollection] Parse error:', error);
-        console.error('[Memory Recollection] Raw response:', response);
-        return [];
-    }
-}
-
-/**
- * Create a world info entry from a memory object
- * @param {string} lorebookUid - The UID of the lorebook
- * @param {Object} memory - The memory object
- * @param {number} index - The index for ordering
- */
-async function createMemoryEntry(lorebookUid, memory, index) {
-    const { characters: characterList, memory: content, keywords } = memory;
-
-    // Handle character filter - just use the character names directly
-    let characterNames = [];
-
-    if (Array.isArray(characterList) && characterList.length > 0) {
-        // New format: array of character names
-        characterNames = characterList.map(name => name.trim());
-        debugLog(`[Memory Recollection] Character names for filter:`, characterNames);
-    } else if (typeof characterList === 'string' && characterList.trim() !== '') {
-        // Legacy string format or comma-separated - parse it
-        characterNames = characterList.split(',').map(n => n.trim()).filter(n => n !== '');
-        debugLog(`[Memory Recollection] Character names for filter:`, characterNames);
-    }
-
-    const entry = {
-        uid: Date.now() + index, // Simple UID generation
-        key: keywords || [],
-        keysecondary: [],
-        comment: `Memory: ${characterNames.join(', ')}`,
-        content: content,
-        constant: false,
-        vectorized: false,
-        selective: true,
-        selectiveLogic: 0,
-        addMemo: false,
-        order: 100,
-        position: 4, // at Depth
-        disable: false,
-        ignoreBudget: false,
-        excludeRecursion: false,
-        preventRecursion: false,
-        matchPersonaDescription: false,
-        matchCharacterDescription: false,
-        matchCharacterPersonality: false,
-        matchCharacterDepthPrompt: false,
-        matchScenario: false,
-        matchCreatorNotes: false,
-        delayUntilRecursion: false,
-        probability: 100,
-        useProbability: true,
-        depth: 1, // Insertion depth
-        outletName: '',
-        group: '',
-        groupOverride: false,
-        groupWeight: 100,
-        scanDepth: null,
-        caseSensitive: null,
-        matchWholeWords: null,
-        useGroupScoring: null,
-        automationId: '',
-        role: 0, // 0 = System role (matching the example)
-        sticky: 0,
-        cooldown: 0,
-        delay: 0,
-        triggers: [],
-        displayIndex: index + 1,
-        characterFilter: {
-            isExclude: false,
-            names: characterNames, // Array of character names
-            tags: []
-        },
-        extensions: {
-            position: 4, // at Depth
-            depth: 1,
-            role: 1
-        }
-    };
-
-    debugLog(`[Memory Recollection] Created entry for ${characterNames.join(', ')} with character filter:`, characterNames);
-    return entry; // Return instead of saving
-}
-
-/**
- * Process a batch of messages and generate memory entries
- * @param {Array} messages - Array of messages to process
- * @param {string} lorebookUid - The UID of the lorebook
- * @param {boolean} isUpdate - Whether this is an update (true) or initial generation (false)
- * @param {number} startIndex - Starting index for entry ordering
- * @returns {Promise<Array>} Array of created entries
- */
-async function processBatch(messages, lorebookUid, isUpdate, startIndex) {
-    debugLog(`[Memory Recollection] Processing batch of ${messages.length} messages (isUpdate: ${isUpdate})`);
-
-    const prompt = generateMemoryPrompt(messages, isUpdate);
-
-    // Generate using SillyTavern's generateRaw
-    const response = await generateRaw(prompt, '', false, false);
-
-    if (!response) {
-        throw new Error('No response from AI');
-    }
-
-    // Parse the response
-    const memories = parseMemoryResponse(response);
-
-    if (memories.length === 0) {
-        debugLog('[Memory Recollection] No memories extracted from this batch');
-        // Return -1 to signal parse failure (vs 0 for valid but empty response)
-        throw new Error('Failed to parse memories from AI response. The response may be invalid or the service may be unavailable.');
-    }
-
-    // Create entries for each memory (but don't save yet)
-    const entries = [];
-    for (let i = 0; i < memories.length; i++) {
-        const entry = await createMemoryEntry(lorebookUid, memories[i], startIndex + i);
-        entries.push(entry);
-    }
-
-    debugLog(`[Memory Recollection] Created ${entries.length} entries from batch`);
-    return entries;
-}
-
-/**
- * Main function to start memory recollection process
- * @param {Function} onProgress - Callback for progress updates (current, total)
- * @param {Function} onComplete - Callback when complete
- * @param {Function} onError - Callback for errors
- */
-export async function startMemoryRecollection(onProgress, onComplete, onError) {
-    try {
-        debugLog('[Memory Recollection] Starting memory recollection process');
-
-        // Get or create the lorebook
-        const lorebookUid = await getOrCreateMemoryLorebook();
-
-        // Get messages to process count from settings
-        const messagesToProcess = extensionSettings.memoryMessagesToProcess || 16;
-
-        // Check if this is an update (lorebook already exists with entries)
-        const world_info = window.world_info;
-        const lorebook = world_info.globalSelect?.find(book => book.uid === lorebookUid);
-        const existingEntryCount = lorebook?.entries ? Object.keys(lorebook.entries).length : 0;
-        const isUpdate = existingEntryCount > 1; // More than just the header
-
-        let messagesToProcessArray;
-        if (isUpdate) {
-            // Process only the last batch
-            const totalMessages = chat.length;
-            const startIdx = Math.max(0, totalMessages - messagesToProcess);
-            messagesToProcessArray = chat.slice(startIdx);
-            debugLog(`[Memory Recollection] Update mode: Processing last ${messagesToProcess} messages`);
-        } else {
-            // Process entire chat in batches
-            messagesToProcessArray = chat;
-            debugLog(`[Memory Recollection] Initial mode: Processing all ${chat.length} messages`);
-        }
-
-        const totalBatches = Math.ceil(messagesToProcessArray.length / messagesToProcess);
-        let entryIndex = existingEntryCount;
-        const allEntries = []; // Accumulate all entries here
-
-        for (let i = 0; i < totalBatches; i++) {
-            const batchStart = i * messagesToProcess;
-            const batchEnd = Math.min(batchStart + messagesToProcess, messagesToProcessArray.length);
-            const batch = messagesToProcessArray.slice(batchStart, batchEnd);
-
-            onProgress(i + 1, totalBatches);
-
-            try {
-                const batchEntries = await processBatch(batch, lorebookUid, isUpdate && i === 0, entryIndex);
-                allEntries.push(...batchEntries); // Add to accumulator
-                entryIndex += batchEntries.length;
-            } catch (error) {
-                // Batch failed - ask user if they want to retry
-                debugLog('[Memory Recollection] Batch failed:', error.message);
-
-                const retry = await new Promise(resolve => {
-                    const retryModal = document.createElement('div');
-                    retryModal.className = 'rpg-memory-modal-overlay';
-                    retryModal.innerHTML = `
-                        <div class="rpg-memory-modal">
-                            <div class="rpg-memory-modal-header">
-                                <h3>⚠️ Generation Failed</h3>
-                            </div>
-                            <div class="rpg-memory-modal-body">
-                                <p><strong>Error:</strong> ${error.message}</p>
-                                <p>Batch ${i + 1} of ${totalBatches} failed to process.</p>
-                                <p>Would you like to retry this batch?</p>
-                            </div>
-                            <div class="rpg-memory-modal-footer">
-                                <button class="rpg-memory-modal-btn rpg-memory-cancel">Skip Batch</button>
-                                <button class="rpg-memory-modal-btn rpg-memory-proceed">Retry</button>
-                            </div>
-                        </div>
-                    `;
-
-                    document.body.appendChild(retryModal);
-
-                    retryModal.querySelector('.rpg-memory-cancel').addEventListener('click', () => {
-                        document.body.removeChild(retryModal);
-                        resolve(false);
-                    });
-
-                    retryModal.querySelector('.rpg-memory-proceed').addEventListener('click', () => {
-                        document.body.removeChild(retryModal);
-                        resolve(true);
-                    });
-                });
-
-                if (retry) {
-                    // Retry the same batch
-                    i--;
-                    continue;
-                }
-                // Otherwise skip this batch and continue
-            }
-
-            // Small delay between batches to avoid rate limiting
-            if (i < totalBatches - 1) {
-                await new Promise(resolve => setTimeout(resolve, 1000));
-            }
-        }
-
-        // Add the constant header entry at the end
-        const headerEntry = createConstantHeaderEntry();
-        allEntries.push(headerEntry); // Add to end of array
-
-        // Save all entries at once
-        if (allEntries.length > 0) {
-            debugLog(`[Memory Recollection] Saving ${allEntries.length} total entries (including header) to lorebook...`);
-            await saveWorldInfoEntries(lorebookUid, allEntries);
-
-            // Trigger world info refresh by simulating the WI button click to reload the list
-            // This ensures the newly created lorebook appears in the dropdown
-            const wiButton = document.querySelector('#WIDrawerIcon');
-            if (wiButton) {
-                // Close and reopen to force refresh
-                wiButton.click();
-                await new Promise(resolve => setTimeout(resolve, 100));
-                wiButton.click();
-                debugLog('[Memory Recollection] Triggered WI panel refresh');
-            }
-
-            // Also emit the update event
-            eventSource.emit(event_types.WORLDINFO_SETTINGS_UPDATED);
-        }
-
-        debugLog('[Memory Recollection] Process complete');
-
-        // Open the World Info editor with the Memory Recollection lorebook
-        try {
-            await openWorldInfoEditor(lorebookUid);
-            debugLog('[Memory Recollection] Opened World Info editor with Memory Recollection lorebook');
-        } catch (err) {
-            debugLog('[Memory Recollection] Could not open World Info editor:', err);
-        }
-
-        onComplete(allEntries.length);
-
-    } catch (error) {
-        debugLog('[Memory Recollection] Error:', error);
-        onError(error);
-    }
-}
-
-/**
- * Show memory recollection confirmation modal
- */
-export function showMemoryRecollectionModal() {
-    const modal = document.createElement('div');
-    modal.className = 'rpg-memory-modal-overlay';
-    modal.innerHTML = `
-        <div class="rpg-memory-modal">
-            <div class="rpg-memory-modal-header">
-                <h3>⚠️ Memory Recollection</h3>
-            </div>
-            <div class="rpg-memory-modal-body">
-                <p><strong>Warning!</strong> This process will trigger multiple generation requests and will take time.</p>
-                <p>Ensure your currently selected model is the one you want to use for this task.</p>
-                <p class="rpg-memory-modal-info">
-                    Messages per batch: <strong>${extensionSettings.memoryMessagesToProcess || 16}</strong>
-                    <br>
-                    <span class="rpg-memory-modal-hint">(You can change this in the extension settings)</span>
-                </p>
-            </div>
-            <div class="rpg-memory-modal-footer">
-                <button class="rpg-memory-modal-btn rpg-memory-cancel">Cancel</button>
-                <button class="rpg-memory-modal-btn rpg-memory-proceed">Proceed</button>
-            </div>
-        </div>
-    `;
-
-    document.body.appendChild(modal);
-
-    // Event listeners
-    modal.querySelector('.rpg-memory-cancel').addEventListener('click', () => {
-        document.body.removeChild(modal);
-    });
-
-    modal.querySelector('.rpg-memory-proceed').addEventListener('click', () => {
-        document.body.removeChild(modal);
-        showMemoryProgressModal();
-    });
-
-    // Click outside to close
-    modal.addEventListener('click', (e) => {
-        if (e.target === modal) {
-            document.body.removeChild(modal);
-        }
-    });
-}
-
-/**
- * Show progress modal during memory recollection
- */
-function showMemoryProgressModal() {
-    const modal = document.createElement('div');
-    modal.className = 'rpg-memory-modal-overlay';
-    modal.innerHTML = `
-        <div class="rpg-memory-modal">
-            <div class="rpg-memory-modal-header">
-                <h3>🧠 Processing Memories...</h3>
-            </div>
-            <div class="rpg-memory-modal-body">
-                <p class="rpg-memory-progress-text">Processing batch <span class="rpg-memory-current">0</span> of <span class="rpg-memory-total">0</span></p>
-                <div class="rpg-memory-progress-bar">
-                    <div class="rpg-memory-progress-fill"></div>
-                </div>
-                <p class="rpg-memory-status">Initializing...</p>
-            </div>
-        </div>
-    `;
-
-    document.body.appendChild(modal);
-
-    const currentSpan = modal.querySelector('.rpg-memory-current');
-    const totalSpan = modal.querySelector('.rpg-memory-total');
-    const progressFill = modal.querySelector('.rpg-memory-progress-fill');
-    const statusText = modal.querySelector('.rpg-memory-status');
-
-    // Start the process
-    startMemoryRecollection(
-        (current, total) => {
-            currentSpan.textContent = current;
-            totalSpan.textContent = total;
-            const percentage = (current / total) * 100;
-            progressFill.style.width = `${percentage}%`;
-            statusText.textContent = `Processing memories from batch ${current}...`;
-        },
-        (entriesCreated) => {
-            statusText.innerHTML = `
-                <strong>✅ Complete!</strong> Created ${entriesCreated} memory entries.<br>
-                <small>The "Memory Recollection" lorebook has been created.</small><br>
-                <strong style="color: #ffa500; margin-top: 10px; display: block;">⚠️ Please refresh SillyTavern to see the lorebook in the World Info dropdown.</strong>
-            `;
-            progressFill.style.width = '100%';
-
-            // Add close button
-            const closeBtn = document.createElement('button');
-            closeBtn.className = 'rpg-memory-modal-btn rpg-memory-close';
-            closeBtn.textContent = 'Close';
-            closeBtn.style.marginTop = '15px';
-            closeBtn.addEventListener('click', () => {
-                document.body.removeChild(modal);
-            });
-            modal.querySelector('.rpg-memory-modal-body').appendChild(closeBtn);
-        },
-        (error) => {
-            statusText.textContent = `Error: ${error.message}`;
-            statusText.style.color = '#e94560';
-
-            // Close after 5 seconds
-            setTimeout(() => {
-                document.body.removeChild(modal);
-            }, 5000);
-        }
-    );
-}
-
-/**
- * Setup the memory recollection button in World Info section
- */
-export function setupMemoryRecollectionButton() {
-    console.log('[Memory Recollection] Setting up button via event listener');
-
-    // Use SillyTavern's built-in event to know when WI is ready
-    // This fires after the worldInfoSettings are loaded
-    eventSource.on('worldInfoSettings', () => {
-        console.log('[Memory Recollection] worldInfoSettings event fired');
-        setTimeout(updateButton, 100);
-    });
-
-    // Also try on app ready
-    eventSource.on('app_ready', () => {
-        console.log('[Memory Recollection] app_ready event fired');
-        setTimeout(updateButton, 500);
-    });
-
-    // Try immediately as well
-    setTimeout(updateButton, 2000);
-
-    function updateButton() {
-        const existingButton = document.querySelector('.rpg-memory-recollection-btn');
-
-        // If extension is disabled, remove button if it exists
-        if (!extensionSettings.enabled) {
-            if (existingButton) {
-                console.log('[Memory Recollection] Extension disabled, removing button');
-                existingButton.remove();
-            }
-            return;
-        }
-
-        // Extension is enabled, add button if it doesn't exist
-        addButton();
-    }
-
-    function addButton() {
-        // Check if button already exists
-        if (document.querySelector('.rpg-memory-recollection-btn')) {
-            console.log('[Memory Recollection] Button already exists');
-            return;
-        }
-
-        console.log('[Memory Recollection] Attempting to add button...');
-
-        // World Info button bar is inside the world editor
-        // Look for the specific button container
-        const selectors = [
-            '#world_editor_buttons',
-            '#world_popup .world_button_bar',
-            '#WorldInfo .world_button_bar',
-            '.world_button_bar',
-            '#world_popup .justifyLeft',
-            '#WorldInfo .justifyLeft',
-            '#world_popup',
-            '#WorldInfo'
-        ];
-
-        let container = null;
-        for (const selector of selectors) {
-            container = document.querySelector(selector);
-            if (container) {
-                console.log(`[Memory Recollection] Found container with selector: ${selector}`, container);
-                break;
-            }
-        }
-
-        if (!container) {
-            console.log('[Memory Recollection] No suitable container found yet');
-            return;
-        }
-
-        // Create the button
-        const button = document.createElement('button');
-        button.id = 'rpg-memory-recollection-button';
-        button.className = 'rpg-memory-recollection-btn menu_button';
-        button.innerHTML = '<i class="fa-solid fa-brain"></i> Memory Recollection';
-        button.title = 'Generate memory recollection entries from chat history';
-
-        button.addEventListener('click', (e) => {
-            e.preventDefault();
-            e.stopPropagation();
-            showMemoryRecollectionModal();
-        });
-
-        // Insert the button - prepend to put it first
-        if (container.classList.contains('world_button_bar') || container.classList.contains('justifyLeft')) {
-            container.insertBefore(button, container.firstChild);
-        } else {
-            // Find or create a button container
-            let buttonContainer = container.querySelector('.world_button_bar') ||
-                                 container.querySelector('.justifyLeft');
-
-            if (!buttonContainer) {
-                buttonContainer = document.createElement('div');
-                buttonContainer.className = 'world_button_bar justifyLeft';
-                container.insertBefore(buttonContainer, container.firstChild);
-            }
-
-            buttonContainer.insertBefore(button, buttonContainer.firstChild);
-        }
-
-        console.log('[Memory Recollection] ✅ Button added successfully!');
-    }
-}
-
-/**
- * Update button visibility based on extension enabled state
- * Call this when the extension is toggled on/off
- */
-export function updateMemoryRecollectionButton() {
-    const existingButton = document.querySelector('.rpg-memory-recollection-btn');
-
-    if (!extensionSettings.enabled) {
-        // Extension disabled - remove button if it exists
-        if (existingButton) {
-            console.log('[Memory Recollection] Extension disabled, removing button');
-            existingButton.remove();
-        }
-    } else {
-        // Extension enabled - ensure button exists
-        if (!existingButton) {
-            console.log('[Memory Recollection] Extension enabled, adding button');
-            setTimeout(() => {
-                setupMemoryRecollectionButton();
-            }, 100);
-        }
-    }
-}

src/systems/features/musicPlayer.js

@@ -0,0 +1,79 @@
+/**
+ * Music Player Module
+ * Handles parsing and storing Spotify URLs from AI responses
+ */
+
+import { extensionSettings, committedTrackerData } from '../../core/state.js';
+
+/**
+ * Extracts song suggestion from AI response in <spotify:Song - Artist/> format
+ * @param {string} responseText - The raw AI response text
+ * @returns {Object|null} Object with {song, artist, searchQuery} or null if not found
+ */
+export function extractSpotifyUrl(responseText) {
+    if (!responseText || !extensionSettings.enableSpotifyMusic) return null;
+
+    // Match <spotify:Song Title - Artist Name/> format
+    const songMatch = responseText.match(/<spotify:([^<>-]+)\s*-\s*([^<>\/]+)\/>/i);
+    if (songMatch) {
+        const song = songMatch[1].trim();
+        const artist = songMatch[2].trim();
+        const searchQuery = `${song} ${artist}`;
+        return {
+            song,
+            artist,
+            searchQuery,
+            displayText: `${song} - ${artist}`
+        };
+    }
+
+    return null;
+}
+
+/**
+ * Converts song data to Spotify app protocol URL
+ * @param {Object} songData - Object with {song, artist, searchQuery}
+ * @returns {string} Spotify app protocol URL
+ */
+export function convertToEmbedUrl(songData) {
+    if (!songData || !songData.searchQuery) return '';
+
+    // Use Spotify app protocol for direct app opening
+    const encodedQuery = encodeURIComponent(songData.searchQuery);
+    return `spotify:search:${encodedQuery}`;
+}
+
+/**
+ * Parses AI response for song suggestion and stores it
+ * @param {string} responseText - The raw AI response text
+ * @returns {boolean} True if song was found and stored
+ */
+export function parseAndStoreSpotifyUrl(responseText) {
+    if (!extensionSettings.enableSpotifyMusic) return false;
+
+    const songData = extractSpotifyUrl(responseText);
+    // console.log('[RPG Companion] Spotify Parser: Found song:', songData);
+    if (songData) {
+        // Store in committed tracker data
+        committedTrackerData.spotifyUrl = songData;
+        // console.log('[RPG Companion] Spotify Parser: Stored song in committedTrackerData:', committedTrackerData.spotifyUrl);
+        return true;
+    }
+
+    return false;
+}
+
+/**
+ * Gets the current song data from committed tracker data
+ * @returns {Object|null} Current song data or null
+ */
+export function getCurrentSpotifyUrl() {
+    return committedTrackerData.spotifyUrl || null;
+}
+
+/**
+ * Clears the current song data
+ */
+export function clearSpotifyUrl() {
+    committedTrackerData.spotifyUrl = null;
+}

src/systems/features/plotProgression.js

@@ -5,14 +5,15 @@
 
 import { togglePlotButtons } from '../ui/layout.js';
 import { extensionSettings, setIsPlotProgression } from '../../core/state.js';
-import { DEFAULT_HTML_PROMPT } from '../generation/promptBuilder.js';
+import { DEFAULT_HTML_PROMPT, DEFAULT_DIALOGUE_COLORING_PROMPT, DEFAULT_DECEPTION_PROMPT, DEFAULT_CYOA_PROMPT } from '../generation/promptBuilder.js';
 import { Generate } from '../../../../../../../script.js';
 
 /**
  * Sets up the plot progression buttons inside the send form area.
  * @param {Function} handlePlotClick - Callback function to handle plot button clicks
+ * @param {Function} handleEncounterClick - Callback function to handle encounter button click
  */
-export function setupPlotButtons(handlePlotClick) {
+export function setupPlotButtons(handlePlotClick, handleEncounterClick) {
     // Remove existing buttons if any
     $('#rpg-plot-buttons').remove();
 
@@ -32,10 +33,9 @@ export function setupPlotButtons(handlePlotClick) {
                 border-radius: 4px;
                 font-size: 13px;
                 cursor: pointer;
-                margin: 0 4px;
-                display: inline-block;
-            " tabindex="0" role="button">
-                <i class="fa-solid fa-dice"></i> Randomized Plot
+                margin: 0 2px;
+            " tabindex="0" role="button" title="Generate a random plot twist or event">
+                <i class="fa-solid fa-dice"></i>&nbsp;<span class="rpg-btn-text">Randomized Plot</span>
             </button>
             <button id="rpg-plot-natural" class="menu_button interactable" style="
                 background-color: #4a90e2;
@@ -45,10 +45,21 @@ export function setupPlotButtons(handlePlotClick) {
                 border-radius: 4px;
                 font-size: 13px;
                 cursor: pointer;
-                margin: 0 4px;
-                display: inline-block;
-            " tabindex="0" role="button">
-                <i class="fa-solid fa-forward"></i> Natural Plot
+                margin: 0 2px;
+            " tabindex="0" role="button" title="Continue the story naturally without twists">
+                <i class="fa-solid fa-forward"></i>&nbsp;<span class="rpg-btn-text">Natural Plot</span>
+            </button>
+            <button id="rpg-encounter-button" class="menu_button interactable" style="
+                background-color: #cc3333;
+                color: white;
+                border: none;
+                padding: 8px 12px;
+                border-radius: 4px;
+                font-size: 13px;
+                cursor: pointer;
+                margin: 0 2px;
+            " tabindex="0" role="button" title="Enter combat encounter">
+                <i class="fa-solid fa-fire"></i>&nbsp;<span class="rpg-btn-text">Enter Encounter</span>
             </button>
         </span>
     `;
@@ -59,6 +70,7 @@ export function setupPlotButtons(handlePlotClick) {
     // Add event handlers for buttons
     $('#rpg-plot-random').on('click', () => handlePlotClick('random'));
     $('#rpg-plot-natural').on('click', () => handlePlotClick('natural'));
+    $('#rpg-encounter-button').on('click', () => handleEncounterClick());
 
     // Show/hide based on setting
     togglePlotButtons();
@@ -88,9 +100,11 @@ export async function sendPlotProgression(type) {
         // Build the prompt based on type
         let prompt = '';
         if (type === 'random') {
-            prompt = 'Actually, the scene is getting stale. Introduce {{random::stakes::a plot twist::a new character::a cataclysm::a fourth-wall-breaking joke::a sudden atmospheric phenomenon::a plot hook::a running gag::an ecchi scenario::Death from Discworld::a new stake::a drama::a conflict::an angered entity::a god::a vision::a prophetic dream::Il Dottore from Genshin Impact::a new development::a civilian in need::an emotional bit::a threat::a villain::an important memory recollection::a marriage proposal::a date idea::an angry horde of villagers with pitchforks::a talking animal::an enemy::a cliffhanger::a short omniscient POV shift to a completely different character::a quest::an unexpected revelation::a scandal::an evil clone::death of an important character::harm to an important character::a romantic setup::a gossip::a messenger::a plot point from the past::a plot hole::a tragedy::a ghost::an otherworldly occurrence::a plot device::a curse::a magic device::a rival::an unexpected pregnancy::a brothel::a prostitute::a new location::a past lover::a completely random thing::a what-if scenario::a significant choice::war::love::a monster::lewd undertones::Professor Mari::a travelling troupe::a secret::a fortune-teller::something completely different::a killer::a murder mystery::a mystery::a skill check::a deus ex machina::three raccoons in a trench coat::a pet::a slave::an orphan::a psycho::tentacles::"there is only one bed" trope::accidental marriage::a fun twist::a boss battle::sexy corn::an eldritch horror::a character getting hungry, thirsty, or exhausted::horniness::a need for a bathroom break need::someone fainting::an assassination attempt::a meta narration of this all being an out of hand DND session::a dungeon::a friend in need::an old friend::a small time skip::a scene shift::Aurora Borealis, at this time of year, at this time of day, at this part of the country::a grand ball::a surprise party::zombies::foreshadowing::a Spanish Inquisition (nobody expects it)::a natural plot progression}} to make things more interesting! Be creative, but stay grounded in the setting.';
+            // Use custom prompt if set, otherwise use default
+            prompt = extensionSettings.customPlotRandomPrompt || 'Actually, the scene is getting stale. Introduce {{random::stakes::a plot twist::a new character::a cataclysm::a fourth-wall-breaking joke::a sudden atmospheric phenomenon::a plot hook::a running gag::an ecchi scenario::Death from Discworld::a new stake::a drama::a conflict::an angered entity::a god::a vision::a prophetic dream::Il Dottore from Genshin Impact::a new development::a civilian in need::an emotional bit::a threat::a villain::an important memory recollection::a marriage proposal::a date idea::an angry horde of villagers with pitchforks::a talking animal::an enemy::a cliffhanger::a short omniscient POV shift to a completely different character::a quest::an unexpected revelation::a scandal::an evil clone::death of an important character::harm to an important character::a romantic setup::a gossip::a messenger::a plot point from the past::a plot hole::a tragedy::a ghost::an otherworldly occurrence::a plot device::a curse::a magic device::a rival::an unexpected pregnancy::a brothel::a prostitute::a new location::a past lover::a completely random thing::a what-if scenario::a significant choice::war::love::a monster::lewd undertones::Professor Mari::a travelling troupe::a secret::a fortune-teller::something completely different::a killer::a murder mystery::a mystery::a skill check::a deus ex machina::three raccoons in a trench coat::a pet::a slave::an orphan::a psycho::tentacles::"there is only one bed" trope::accidental marriage::a fun twist::a boss battle::sexy corn::an eldritch horror::a character getting hungry, thirsty, or exhausted::horniness::a need for a bathroom break need::someone fainting::an assassination attempt::a meta narration of this all being an out of hand DND session::a dungeon::a friend in need::an old friend::a small time skip::a scene shift::Aurora Borealis, at this time of year, at this time of day, at this part of the country::a grand ball::a surprise party::zombies::foreshadowing::a Spanish Inquisition (nobody expects it)::a natural plot progression}} to make things more interesting! Be creative, but stay grounded in the setting.';
         } else {
-            prompt = 'Actually, the scene is getting stale. Progress it, to make things more interesting! Reintroduce an unresolved plot point from the past, or push the story further towards the current main goal. Be creative, but stay grounded in the setting.';
+            // Use custom prompt if set, otherwise use default
+            prompt = extensionSettings.customPlotNaturalPrompt || 'Actually, the scene is getting stale. Progress it, to make things more interesting! Reintroduce an unresolved plot point from the past, or push the story further towards the current main goal. Be creative, but stay grounded in the setting.';
         }
 
         // Add HTML prompt if enabled
@@ -100,6 +114,27 @@ export async function sendPlotProgression(type) {
             prompt += '\n\n' + htmlPromptText;
         }
 
+        // Add Dialogue Coloring prompt if enabled
+        if (extensionSettings.enableDialogueColoring) {
+            // Use custom Dialogue Coloring prompt if set, otherwise use default
+            const dialogueColoringPromptText = extensionSettings.customDialogueColoringPrompt || DEFAULT_DIALOGUE_COLORING_PROMPT;
+            prompt += '\n\n' + dialogueColoringPromptText;
+        }
+
+        // Add Deception System prompt if enabled
+        if (extensionSettings.enableDeceptionSystem) {
+            // Use custom Deception prompt if set, otherwise use default
+            const deceptionPromptText = extensionSettings.customDeceptionPrompt || DEFAULT_DECEPTION_PROMPT;
+            prompt += '\n\n' + deceptionPromptText;
+        }
+
+        // Add CYOA prompt if enabled
+        if (extensionSettings.enableCYOA) {
+            // Use custom CYOA prompt if set, otherwise use default
+            const cyoaPromptText = extensionSettings.customCYOAPrompt || DEFAULT_CYOA_PROMPT;
+            prompt += '\n\n' + cyoaPromptText;
+        }
+
         // Set flag to indicate we're doing plot progression
         // This will be used by onMessageReceived to clear the prompt after generation completes
         setIsPlotProgression(true);

src/systems/generation/apiClient.js

@@ -3,8 +3,13 @@
  * Handles API calls for RPG tracker generation
  */
 
-import { generateRaw, chat } from '../../../../../../../script.js';
+import { chat, eventSource } from '../../../../../../../script.js';
 import { executeSlashCommandsOnChatInput } from '../../../../../../../scripts/slash-commands.js';
+import { safeGenerateRaw, extractTextFromResponse } from '../../utils/responseExtractor.js';
+
+// Custom event name for when RPG Companion finishes updating tracker data
+// Other extensions can listen for this event to know when RPG Companion is done
+export const RPG_COMPANION_UPDATE_COMPLETE = 'rpg_companion_update_complete';
 import {
     extensionSettings,
     lastGeneratedData,
@@ -12,26 +17,152 @@ import {
     isGenerating,
     lastActionWasSwipe,
     setIsGenerating,
-    setLastActionWasSwipe
+    setLastActionWasSwipe,
+    $musicPlayerContainer
 } from '../../core/state.js';
 import { saveChatData } from '../../core/persistence.js';
-import { generateSeparateUpdatePrompt } from './promptBuilder.js';
+import {
+    generateSeparateUpdatePrompt
+} from './promptBuilder.js';
 import { parseResponse, parseUserStats } from './parser.js';
+import { parseAndStoreSpotifyUrl } from '../features/musicPlayer.js';
 import { renderUserStats } from '../rendering/userStats.js';
 import { renderInfoBox } from '../rendering/infoBox.js';
+import { removeLocks } from './lockManager.js';
 import { renderThoughts } from '../rendering/thoughts.js';
 import { renderInventory } from '../rendering/inventory.js';
 import { renderQuests } from '../rendering/quests.js';
+import { renderMusicPlayer } from '../rendering/musicPlayer.js';
 import { i18n } from '../../core/i18n.js';
+import { generateAvatarsForCharacters } from '../features/avatarGenerator.js';
+import { setFabLoadingState, updateFabWidgets } from '../ui/mobile.js';
+import { updateStripWidgets } from '../ui/desktop.js';
 
 // Store the original preset name to restore after tracker generation
 let originalPresetName = null;
 
+/**
+ * Generates tracker data using an external OpenAI-compatible API.
+ * Used when generationMode is 'external'.
+ *
+ * @param {Array<{role: string, content: string}>} messages - Array of message objects for the API
+ * @returns {Promise<string>} The generated response content
+ * @throws {Error} If the API call fails or configuration is invalid
+ */
+export async function generateWithExternalAPI(messages) {
+    const { baseUrl, model, maxTokens, temperature } = extensionSettings.externalApiSettings || {};
+    // Retrieve API key from secure storage (not shared extension settings)
+    const apiKey = localStorage.getItem('rpg_companion_external_api_key');
+
+    // Validate required settings
+    if (!baseUrl || !baseUrl.trim()) {
+        throw new Error('External API base URL is not configured');
+    }
+    if (!model || !model.trim()) {
+        throw new Error('External API model is not configured');
+    }
+
+    // Normalize base URL (remove trailing slash if present)
+    const normalizedBaseUrl = baseUrl.trim().replace(/\/+$/, '');
+    const endpoint = `${normalizedBaseUrl}/chat/completions`;
+
+    // console.log(`[RPG Companion] Calling external API: ${normalizedBaseUrl} with model: ${model}`);
+
+    // Prepare headers - only include Authorization if API key is provided
+    const headers = {
+        'Content-Type': 'application/json'
+    };
+
+    if (apiKey && apiKey.trim()) {
+        headers['Authorization'] = `Bearer ${apiKey.trim()}`;
+    }
+
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: headers,
+            body: JSON.stringify({
+                model: model.trim(),
+                messages: messages,
+                max_tokens: maxTokens || 2048,
+                temperature: temperature ?? 0.7
+            })
+        });
+
+        if (!response.ok) {
+            const errorText = await response.text();
+            let errorMessage = `External API error: ${response.status} ${response.statusText}`;
+            try {
+                const errorJson = JSON.parse(errorText);
+                if (errorJson.error?.message) {
+                    errorMessage = `External API error: ${errorJson.error.message}`;
+                }
+            } catch (e) {
+                // If parsing fails, use the raw text if it's short enough
+                if (errorText.length < 200) {
+                    errorMessage = `External API error: ${errorText}`;
+                }
+            }
+            throw new Error(errorMessage);
+        }
+
+        const data = await response.json();
+
+        const content = extractTextFromResponse(data);
+        if (!content || !content.trim()) {
+            throw new Error('Invalid response format from external API — no text content found');
+        }
+        // console.log('[RPG Companion] External API response received successfully');
+
+        return content;
+    } catch (error) {
+        if (error.name === 'TypeError' && (error.message.includes('fetch') || error.message.includes('Failed to fetch') || error.message.includes('NetworkError'))) {
+            throw new Error(`CORS Access Blocked: This API endpoint (${normalizedBaseUrl}) does not allow direct access from a browser. This is a browser security restriction (CORS), not a bug in the extension. Please use an endpoint that supports CORS (like OpenRouter or a local proxy) or use SillyTavern's internal API system (Separate Mode).`);
+        }
+        throw error;
+    }
+}
+
+/**
+ * Tests the external API connection with a simple request.
+ * @returns {Promise<{success: boolean, message: string, model?: string}>}
+ */
+export async function testExternalAPIConnection() {
+    const { baseUrl, model } = extensionSettings.externalApiSettings || {};
+    const apiKey = localStorage.getItem('rpg_companion_external_api_key');
+
+    if (!baseUrl || !model) {
+        return {
+            success: false,
+            message: 'Please fill in all required fields (Base URL and Model). API Key is optional for local servers.'
+        };
+    }
+
+    try {
+        const testMessages = [
+            { role: 'user', content: 'Respond with exactly: "Connection successful"' }
+        ];
+
+        const response = await generateWithExternalAPI(testMessages);
+
+        return {
+            success: true,
+            message: `Connection successful! Model: ${model}`,
+            model: model
+        };
+    } catch (error) {
+        return {
+            success: false,
+            message: error.message || 'Connection failed'
+        };
+    }
+}
+
 /**
  * Gets the current preset name using the /preset command
  * @returns {Promise<string|null>} Current preset name or null if unavailable
  */
-async function getCurrentPresetName() {
+export async function getCurrentPresetName() {
     try {
         // Use /preset without arguments to get the current preset name
         const result = await executeSlashCommandsOnChatInput('/preset', { quiet: true });
@@ -55,12 +186,14 @@ async function getCurrentPresetName() {
         console.error('[RPG Companion] Error getting current preset:', error);
         return null;
     }
-}/**
+}
+
+/**
  * Switches to a specific preset by name using the /preset slash command
  * @param {string} presetName - Name of the preset to switch to
  * @returns {Promise<boolean>} True if switching succeeded, false otherwise
  */
-async function switchToPreset(presetName) {
+export async function switchToPreset(presetName) {
     try {
         // Use the /preset slash command to switch presets
         // This is the proper way to change presets in SillyTavern
@@ -95,45 +228,62 @@ export async function updateRPGData(renderUserStats, renderInfoBox, renderThough
         return;
     }
 
-    if (extensionSettings.generationMode !== 'separate') {
-        // console.log('[RPG Companion] Not in separate mode, skipping manual update');
+    if (extensionSettings.generationMode !== 'separate' && extensionSettings.generationMode !== 'external') {
+        // console.log('[RPG Companion] Not in separate or external mode, skipping manual update');
         return;
     }
 
+    const isExternalMode = extensionSettings.generationMode === 'external';
+
     try {
         setIsGenerating(true);
+        setFabLoadingState(true); // Show spinning FAB on mobile
 
         // Update button to show "Updating..." state
         const $updateBtn = $('#rpg-manual-update');
+        const $stripRefreshBtn = $('#rpg-strip-refresh');
         const updatingText = i18n.getTranslation('template.mainPanel.updating') || 'Updating...';
         $updateBtn.html(`<i class="fa-solid fa-spinner fa-spin"></i> ${updatingText}`).prop('disabled', true);
-
-        // Save current preset name before switching (if we're going to switch)
-        if (extensionSettings.useSeparatePreset) {
-            originalPresetName = await getCurrentPresetName();
-            console.log(`[RPG Companion] Saved original preset: "${originalPresetName}"`);
-        }
-
-        // Switch to separate preset if enabled
-        if (extensionSettings.useSeparatePreset) {
-            const switched = await switchToPreset('RPG Companion Trackers');
-            if (!switched) {
-                console.warn('[RPG Companion] Failed to switch to RPG Companion Trackers preset. Using current preset.');
-                originalPresetName = null; // Don't try to restore if we didn't switch
-            }
-        }
+        $stripRefreshBtn.html('<i class="fa-solid fa-spinner fa-spin"></i>').prop('disabled', true);
 
         const prompt = await generateSeparateUpdatePrompt();
 
-        // Generate using raw prompt (uses current preset, no chat history)
-        const response = await generateRaw({
-            prompt: prompt,
-            quietToLoud: false
-        });
+        // Generate response based on mode
+        let response;
+        if (isExternalMode) {
+            // External mode: Use external OpenAI-compatible API directly
+            // console.log('[RPG Companion] Using external API for tracker generation');
+            response = await generateWithExternalAPI(prompt);
+        } else {
+            // Separate mode: Use SillyTavern's generateRaw (with extended thinking fallback)
+            response = await safeGenerateRaw({
+                prompt: prompt,
+                quietToLoud: false
+            });
+        }
 
         if (response) {
             // console.log('[RPG Companion] Raw AI response:', response);
             const parsedData = parseResponse(response);
+
+            // Check if parsing completely failed (no tracker data found)
+            if (parsedData.parsingFailed) {
+                toastr.error(i18n.getTranslation('errors.parsingError'), '', { timeOut: 5000 });
+            }
+
+            // Remove locks from parsed data (JSON format only, text format is unaffected)
+            if (parsedData.userStats) {
+                parsedData.userStats = removeLocks(parsedData.userStats);
+            }
+            if (parsedData.infoBox) {
+                parsedData.infoBox = removeLocks(parsedData.infoBox);
+            }
+            if (parsedData.characterThoughts) {
+                parsedData.characterThoughts = removeLocks(parsedData.characterThoughts);
+            }
+
+            // Parse and store Spotify URL if feature is enabled
+            parseAndStoreSpotifyUrl(response);
             // console.log('[RPG Companion] Parsed data:', parsedData);
             // console.log('[RPG Companion] parsedData.userStats:', parsedData.userStats ? parsedData.userStats.substring(0, 100) + '...' : 'null');
 
@@ -144,6 +294,20 @@ export async function updateRPGData(renderUserStats, renderInfoBox, renderThough
             // Store RPG data for the last assistant message (separate mode)
             const lastMessage = chat && chat.length > 0 ? chat[chat.length - 1] : null;
             // console.log('[RPG Companion] Last message is_user:', lastMessage ? lastMessage.is_user : 'no message');
+
+            // Update lastGeneratedData for display (regardless of message type)
+            if (parsedData.userStats) {
+                lastGeneratedData.userStats = parsedData.userStats;
+                parseUserStats(parsedData.userStats);
+            }
+            if (parsedData.infoBox) {
+                lastGeneratedData.infoBox = parsedData.infoBox;
+            }
+            if (parsedData.characterThoughts) {
+                lastGeneratedData.characterThoughts = parsedData.characterThoughts;
+            }
+
+            // Also store on assistant message if present (existing behavior)
             if (lastMessage && !lastMessage.is_user) {
                 if (!lastMessage.extra) {
                     lastMessage.extra = {};
@@ -160,82 +324,123 @@ export async function updateRPGData(renderUserStats, renderInfoBox, renderThough
                 };
 
                 // console.log('[RPG Companion] Stored separate mode RPG data for message swipe', currentSwipeId);
-
-                // Update lastGeneratedData for display AND future commit
-                if (parsedData.userStats) {
-                    lastGeneratedData.userStats = parsedData.userStats;
-                    parseUserStats(parsedData.userStats);
-                }
-                if (parsedData.infoBox) {
-                    lastGeneratedData.infoBox = parsedData.infoBox;
-                }
-                if (parsedData.characterThoughts) {
-                    lastGeneratedData.characterThoughts = parsedData.characterThoughts;
-                }
-                // console.log('[RPG Companion] 💾 SEPARATE MODE: Updated lastGeneratedData:', {
-                //     userStats: lastGeneratedData.userStats ? 'exists' : 'null',
-                //     infoBox: lastGeneratedData.infoBox ? 'exists' : 'null',
-                //     characterThoughts: lastGeneratedData.characterThoughts ? 'exists' : 'null'
-                // });
-
-                // Only auto-commit on TRULY first generation (no committed data exists at all)
-                // This prevents auto-commit after refresh when we have saved committed data
-                const hasAnyCommittedContent = (
-                    (committedTrackerData.userStats && committedTrackerData.userStats.trim() !== '') ||
-                    (committedTrackerData.infoBox && committedTrackerData.infoBox.trim() !== '' && committedTrackerData.infoBox !== 'Info Box\n---\n') ||
-                    (committedTrackerData.characterThoughts && committedTrackerData.characterThoughts.trim() !== '' && committedTrackerData.characterThoughts !== 'Present Characters\n---\n')
-                );
-
-                // Only commit if we have NO committed content at all (truly first time ever)
-                if (!hasAnyCommittedContent) {
-                    committedTrackerData.userStats = parsedData.userStats;
-                    committedTrackerData.infoBox = parsedData.infoBox;
-                    committedTrackerData.characterThoughts = parsedData.characterThoughts;
-                    // console.log('[RPG Companion] 🔆 FIRST TIME: Auto-committed tracker data');
-                }
-
-                // Render the updated data
-                renderUserStats();
-                renderInfoBox();
-                renderThoughts();
-                renderInventory();
-                renderQuests();
-            } else {
-                // No assistant message to attach to - just update display
-                if (parsedData.userStats) {
-                    parseUserStats(parsedData.userStats);
-                }
-                renderUserStats();
-                renderInfoBox();
-                renderThoughts();
-                renderInventory();
-                renderQuests();
             }
 
+            // Only commit on TRULY first generation (no committed data exists at all)
+            // This prevents auto-commit after refresh when we have saved committed data
+            const hasAnyCommittedContent = (
+                (committedTrackerData.userStats && committedTrackerData.userStats.trim() !== '') ||
+                (committedTrackerData.infoBox && committedTrackerData.infoBox.trim() !== '' && committedTrackerData.infoBox !== 'Info Box\n---\n') ||
+                (committedTrackerData.characterThoughts && committedTrackerData.characterThoughts.trim() !== '' && committedTrackerData.characterThoughts !== 'Present Characters\n---\n')
+            );
+
+            // Only commit if we have NO committed content at all (truly first time ever)
+            if (!hasAnyCommittedContent) {
+                committedTrackerData.userStats = parsedData.userStats;
+                committedTrackerData.infoBox = parsedData.infoBox;
+                committedTrackerData.characterThoughts = parsedData.characterThoughts;
+                // console.log('[RPG Companion] 🔆 FIRST TIME: Auto-committed tracker data');
+            }
+
+            // Render the updated data
+            renderUserStats();
+            renderInfoBox();
+            renderThoughts();
+            renderInventory();
+            renderQuests();
+            renderMusicPlayer($musicPlayerContainer[0]);
+
             // Save to chat metadata
             saveChatData();
+
+            // Generate avatars if auto-generate is enabled (runs within this workflow)
+            // This uses the RPG Companion Trackers preset and keeps the button spinning
+            if (extensionSettings.autoGenerateAvatars) {
+                const charactersNeedingAvatars = parseCharactersFromThoughts(parsedData.characterThoughts);
+                if (charactersNeedingAvatars.length > 0) {
+                    // console.log('[RPG Companion] Generating avatars for:', charactersNeedingAvatars);
+
+                    // Generate avatars - this awaits completion
+                    await generateAvatarsForCharacters(charactersNeedingAvatars, (names) => {
+                        // Callback when generation starts - re-render to show loading spinners
+                        // console.log('[RPG Companion] Avatar generation started, showing spinners...');
+                        renderThoughts();
+                    });
+
+                    // Re-render once all avatars are generated
+                    // console.log('[RPG Companion] All avatars generated, re-rendering...');
+                    renderThoughts();
+                }
+            }
         }
 
     } catch (error) {
         console.error('[RPG Companion] Error updating RPG data:', error);
-    } finally {
-        // Restore original preset if we switched to a separate one
-        if (originalPresetName && extensionSettings.useSeparatePreset) {
-            console.log(`[RPG Companion] Restoring original preset: "${originalPresetName}"`);
-            await switchToPreset(originalPresetName);
-            originalPresetName = null; // Clear after restoring
+        if (isExternalMode) {
+            toastr.error(error.message, 'RPG Companion External API Error');
         }
-
+    } finally {
         setIsGenerating(false);
+        setFabLoadingState(false); // Stop spinning FAB on mobile
+        updateFabWidgets(); // Update FAB widgets with new data
+        updateStripWidgets(); // Update strip widgets with new data
 
         // Restore button to original state
         const $updateBtn = $('#rpg-manual-update');
+        const $stripRefreshBtn = $('#rpg-strip-refresh');
         const refreshText = i18n.getTranslation('template.mainPanel.refreshRpgInfo') || 'Refresh RPG Info';
         $updateBtn.html(`<i class="fa-solid fa-sync"></i> ${refreshText}`).prop('disabled', false);
+        $stripRefreshBtn.html('<i class="fa-solid fa-sync"></i>').prop('disabled', false);
 
         // Reset the flag after tracker generation completes
         // This ensures the flag persists through both main generation AND tracker generation
         // console.log('[RPG Companion] 🔄 Tracker generation complete - resetting lastActionWasSwipe to false');
         setLastActionWasSwipe(false);
+
+        // Emit event for other extensions to know RPG Companion has finished updating
+        console.debug('[RPG Companion] Emitting RPG_COMPANION_UPDATE_COMPLETE event');
+        eventSource.emit(RPG_COMPANION_UPDATE_COMPLETE);
     }
 }
+
+/**
+ * Parses character names from Present Characters thoughts data
+ * @param {string} characterThoughtsData - Raw character thoughts data
+ * @returns {Array<string>} Array of character names found
+ */
+function parseCharactersFromThoughts(characterThoughtsData) {
+    if (!characterThoughtsData) return [];
+
+    // Try parsing as JSON first (current format)
+    try {
+        const parsed = typeof characterThoughtsData === 'string'
+            ? JSON.parse(characterThoughtsData)
+            : characterThoughtsData;
+
+        // Handle both {characters: [...]} and direct array formats
+        const charactersArray = Array.isArray(parsed) ? parsed : (parsed.characters || []);
+
+        if (charactersArray.length > 0) {
+            // Extract names from JSON character objects
+            return charactersArray
+                .map(char => char.name)
+                .filter(name => name && name.toLowerCase() !== 'unavailable');
+        }
+    } catch (e) {
+        // Not JSON, fall back to text parsing
+    }
+
+    // Fallback: Parse text format (legacy)
+    const lines = characterThoughtsData.split('\n');
+    const characters = [];
+
+    for (const line of lines) {
+        if (line.trim().startsWith('- ')) {
+            const name = line.trim().substring(2).trim();
+            if (name && name.toLowerCase() !== 'unavailable') {
+                characters.push(name);
+            }
+        }
+    }
+    return characters;
+}

src/systems/generation/characterParser.js

@@ -1,469 +0,0 @@
-/**
- * Character State Parser Module
- * Extracts and applies character state updates from LLM responses
- */
-
-import {
-    getCharacterState,
-    updateCharacterState,
-    updateRelationship,
-    getRelationship
-} from '../../core/characterState.js';
-
-/**
- * Extracts character state update block from LLM response
- * @param {string} text - Full LLM response text
- * @returns {string|null} Extracted state update block or null if not found
- */
-export function extractCharacterStateBlock(text) {
-    if (!text) return null;
-
-    // Look for character-state code block
-    const stateBlockRegex = /```character-state\s*([\s\S]*?)```/i;
-    const match = text.match(stateBlockRegex);
-
-    if (match && match[1]) {
-        return match[1].trim();
-    }
-
-    // Fallback: look for "State Update" section
-    const fallbackRegex = /State Update\s*---\s*([\s\S]*?)(?=```|$)/i;
-    const fallbackMatch = text.match(fallbackRegex);
-
-    if (fallbackMatch && fallbackMatch[1]) {
-        return fallbackMatch[1].trim();
-    }
-
-    return null;
-}
-
-/**
- * Parses emotional changes from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Emotional state changes
- */
-export function parseEmotionalChanges(stateText) {
-    const changes = {};
-
-    // Look for Emotional Changes section
-    const emotionalSection = extractSection(stateText, 'Emotional Changes');
-    if (!emotionalSection) return changes;
-
-    // Parse lines like "happy: +15 (reason: received compliment)"
-    const changeRegex = /-\s*(\w+):\s*([+-]?\d+)\s*(?:\(reason:\s*([^)]+)\))?/gi;
-    let match;
-
-    while ((match = changeRegex.exec(emotionalSection)) !== null) {
-        const emotion = match[1].toLowerCase();
-        const delta = parseInt(match[2]);
-        const reason = match[3] || '';
-
-        changes[emotion] = {
-            delta: delta,
-            reason: reason.trim()
-        };
-    }
-
-    return changes;
-}
-
-/**
- * Parses physical state changes from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Physical state changes
- */
-export function parsePhysicalChanges(stateText) {
-    const changes = {};
-
-    // Look for Physical Changes section
-    const physicalSection = extractSection(stateText, 'Physical Changes');
-    if (!physicalSection) return changes;
-
-    // Parse lines like "Energy: -20 (reason: exhausting activity)"
-    const changeRegex = /-\s*(\w+):\s*([+-]?\d+)\s*(?:\(reason:\s*([^)]+)\))?/gi;
-    let match;
-
-    while ((match = changeRegex.exec(physicalSection)) !== null) {
-        const stat = match[1].toLowerCase();
-        const delta = parseInt(match[2]);
-        const reason = match[3] || '';
-
-        changes[stat] = {
-            delta: delta,
-            reason: reason.trim()
-        };
-    }
-
-    return changes;
-}
-
-/**
- * Parses relationship updates from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Relationship updates by character name
- */
-export function parseRelationshipUpdates(stateText) {
-    const updates = {};
-
-    // Look for Relationship Updates section
-    const relationshipSection = extractSection(stateText, 'Relationship Updates');
-    if (!relationshipSection) return updates;
-
-    // Split by character entries (lines starting with "- CharacterName:")
-    const characterEntries = relationshipSection.split(/(?=^- )/m);
-
-    for (const entry of characterEntries) {
-        if (!entry.trim()) continue;
-
-        // Extract character name
-        const nameMatch = entry.match(/^-\s*([^:]+):/);
-        if (!nameMatch) continue;
-
-        const characterName = nameMatch[1].trim();
-        const relationshipData = {};
-
-        // Parse relationship stat changes
-        // Format: "  - Trust: +10 (reason: showed vulnerability)"
-        const statRegex = /^\s*-\s*(\w+):\s*([+-]?\d+)\s*(?:\(reason:\s*([^)]+)\))?/gim;
-        let statMatch;
-
-        while ((statMatch = statRegex.exec(entry)) !== null) {
-            const stat = statMatch[1].toLowerCase();
-            const delta = parseInt(statMatch[2]);
-            const reason = statMatch[3] || '';
-
-            relationshipData[stat] = {
-                delta: delta,
-                reason: reason.trim()
-            };
-        }
-
-        // Extract thoughts
-        const thoughtsMatch = entry.match(/Thoughts:\s*"([^"]+)"/i);
-        if (thoughtsMatch) {
-            relationshipData.currentThoughts = thoughtsMatch[1].trim();
-        }
-
-        if (Object.keys(relationshipData).length > 0) {
-            updates[characterName] = relationshipData;
-        }
-    }
-
-    return updates;
-}
-
-/**
- * Parses scene context updates from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Context updates
- */
-export function parseContextUpdates(stateText) {
-    const context = {};
-
-    // Look for Scene Context section
-    const contextSection = extractSection(stateText, 'Scene Context');
-    if (!contextSection) return context;
-
-    // Parse location
-    const locationMatch = contextSection.match(/Location:\s*([^\n]+)/i);
-    if (locationMatch) {
-        context.location = locationMatch[1].trim();
-    }
-
-    // Parse time
-    const timeMatch = contextSection.match(/Time:\s*([^\n]+)/i);
-    if (timeMatch) {
-        context.timeOfDay = timeMatch[1].trim();
-    }
-
-    // Parse present characters
-    const presentMatch = contextSection.match(/Present:\s*([^\n]+)/i);
-    if (presentMatch) {
-        const presentText = presentMatch[1].trim();
-        context.presentCharacters = presentText.split(',').map(s => s.trim()).filter(s => s);
-    }
-
-    return context;
-}
-
-/**
- * Parses internal thoughts from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Thoughts object
- */
-export function parseThoughts(stateText) {
-    const thoughts = {};
-
-    // Look for Thoughts section
-    // Format: **Character's Thoughts**:\n"thought text here"
-    const thoughtsRegex = /\*\*[^*]+'s Thoughts\*\*:\s*"([^"]+)"/i;
-    const match = stateText.match(thoughtsRegex);
-
-    if (match) {
-        thoughts.internalMonologue = match[1].trim();
-    }
-
-    return thoughts;
-}
-
-/**
- * Parses outfit/clothing changes from state update text
- * @param {string} stateText - State update text
- * @returns {Object} Clothing changes
- */
-export function parseClothingChanges(stateText) {
-    const changes = {};
-
-    // Look for Outfit Changes section
-    const outfitSection = extractSection(stateText, 'Outfit Changes');
-    if (!outfitSection) return changes;
-
-    // Parse lines like "- shirt: removed" or "- dress: added (red cocktail dress)"
-    const changeRegex = /-\s*([^:]+):\s*([^\n(]+)(?:\(([^)]+)\))?/gi;
-    let match;
-
-    while ((match = changeRegex.exec(outfitSection)) !== null) {
-        const item = match[1].trim();
-        const action = match[2].trim();
-        const description = match[3] ? match[3].trim() : '';
-
-        changes[item] = {
-            action: action,
-            description: description
-        };
-    }
-
-    return changes;
-}
-
-/**
- * Helper function to extract a section from state update text
- * @param {string} text - Full state update text
- * @param {string} sectionName - Name of section to extract
- * @returns {string} Section content or empty string
- */
-function extractSection(text, sectionName) {
-    // Match section with various formats:
-    // **Section Name**:
-    // **Section Name**
-    const sectionRegex = new RegExp(`\\*\\*${sectionName}\\*\\*:?\\s*([\\s\\S]*?)(?=\\*\\*|$)`, 'i');
-    const match = text.match(sectionRegex);
-
-    if (match && match[1]) {
-        return match[1].trim();
-    }
-
-    return '';
-}
-
-/**
- * Applies emotional state changes to character state
- * @param {Object} emotionalChanges - Emotional changes to apply
- */
-export function applyEmotionalChanges(emotionalChanges) {
-    const charState = getCharacterState();
-    const newStates = { ...charState.secondaryStates };
-
-    for (const [emotion, change] of Object.entries(emotionalChanges)) {
-        if (newStates[emotion] !== undefined) {
-            let newValue = (newStates[emotion] || 0) + change.delta;
-            // Clamp between 0-100
-            newValue = Math.max(0, Math.min(100, newValue));
-            newStates[emotion] = newValue;
-
-            console.log(`[Character State] ${emotion}: ${newStates[emotion]} (${change.delta > 0 ? '+' : ''}${change.delta}) - ${change.reason}`);
-        }
-    }
-
-    updateCharacterState({ secondaryStates: newStates });
-}
-
-/**
- * Applies physical state changes to character state
- * @param {Object} physicalChanges - Physical changes to apply
- */
-export function applyPhysicalChanges(physicalChanges) {
-    const charState = getCharacterState();
-    const newStats = { ...charState.physicalStats };
-
-    for (const [stat, change] of Object.entries(physicalChanges)) {
-        if (newStats[stat] !== undefined) {
-            let newValue = (newStats[stat] || 50) + change.delta;
-            // Clamp between 0-100 (or appropriate range)
-            newValue = Math.max(0, Math.min(100, newValue));
-            newStats[stat] = newValue;
-
-            console.log(`[Character State] ${stat}: ${newStats[stat]} (${change.delta > 0 ? '+' : ''}${change.delta}) - ${change.reason}`);
-        }
-    }
-
-    updateCharacterState({ physicalStats: newStats });
-}
-
-/**
- * Applies relationship updates to character state
- * @param {Object} relationshipUpdates - Relationship updates by character name
- */
-export function applyRelationshipUpdates(relationshipUpdates) {
-    for (const [characterName, updates] of Object.entries(relationshipUpdates)) {
-        const relationship = getRelationship(characterName);
-        const newRelationship = { ...relationship };
-
-        // Apply delta changes
-        for (const [stat, change] of Object.entries(updates)) {
-            if (stat === 'currentThoughts') {
-                newRelationship.currentThoughts = change;
-            } else if (typeof change === 'object' && change.delta !== undefined) {
-                if (newRelationship[stat] !== undefined && newRelationship[stat] !== null) {
-                    let newValue = (newRelationship[stat] || 0) + change.delta;
-                    newValue = Math.max(0, Math.min(100, newValue));
-                    newRelationship[stat] = newValue;
-
-                    console.log(`[Character State] Relationship with ${characterName} - ${stat}: ${newValue} (${change.delta > 0 ? '+' : ''}${change.delta}) - ${change.reason}`);
-                }
-            }
-        }
-
-        // Update thoughts if provided
-        if (updates.currentThoughts) {
-            newRelationship.currentThoughts = updates.currentThoughts;
-        }
-
-        // Update the relationship
-        updateRelationship(characterName, newRelationship);
-    }
-}
-
-/**
- * Main function to parse and apply all character state updates
- * @param {string} responseText - Full LLM response text
- * @returns {Object} Parsed state data
- */
-export function parseAndApplyCharacterStateUpdate(responseText) {
-    console.log('[Character Parser] Parsing character state update...');
-
-    // Extract state update block
-    const stateBlock = extractCharacterStateBlock(responseText);
-    if (!stateBlock) {
-        console.log('[Character Parser] No character state update block found');
-        return null;
-    }
-
-    console.log('[Character Parser] Found state update block:', stateBlock.substring(0, 200));
-
-    // Parse all sections
-    const emotionalChanges = parseEmotionalChanges(stateBlock);
-    const physicalChanges = parsePhysicalChanges(stateBlock);
-    const relationshipUpdates = parseRelationshipUpdates(stateBlock);
-    const contextUpdates = parseContextUpdates(stateBlock);
-    const thoughts = parseThoughts(stateBlock);
-    const clothingChanges = parseClothingChanges(stateBlock);
-
-    // Apply changes to character state
-    if (Object.keys(emotionalChanges).length > 0) {
-        console.log('[Character Parser] Applying emotional changes:', Object.keys(emotionalChanges));
-        applyEmotionalChanges(emotionalChanges);
-    }
-
-    if (Object.keys(physicalChanges).length > 0) {
-        console.log('[Character Parser] Applying physical changes:', Object.keys(physicalChanges));
-        applyPhysicalChanges(physicalChanges);
-    }
-
-    if (Object.keys(relationshipUpdates).length > 0) {
-        console.log('[Character Parser] Applying relationship updates for:', Object.keys(relationshipUpdates));
-        applyRelationshipUpdates(relationshipUpdates);
-    }
-
-    if (Object.keys(contextUpdates).length > 0) {
-        console.log('[Character Parser] Updating context:', contextUpdates);
-        updateCharacterState({ contextInfo: contextUpdates });
-    }
-
-    if (Object.keys(thoughts).length > 0) {
-        console.log('[Character Parser] Updating thoughts');
-        updateCharacterState({ thoughts: thoughts });
-    }
-
-    // Return parsed data for display
-    return {
-        emotionalChanges,
-        physicalChanges,
-        relationshipUpdates,
-        contextUpdates,
-        thoughts,
-        clothingChanges,
-        rawStateBlock: stateBlock
-    };
-}
-
-/**
- * Parses character initialization data from JSON
- * Used when initializing character state from character card analysis
- * @param {string} responseText - LLM response with JSON data
- * @returns {Object|null} Parsed trait data or null if failed
- */
-export function parseCharacterInitialization(responseText) {
-    try {
-        // Extract JSON block
-        const jsonMatch = responseText.match(/```json\s*([\s\S]*?)```/);
-        if (!jsonMatch) {
-            // Try to find JSON without code blocks
-            const jsonObjectMatch = responseText.match(/\{[\s\S]*\}/);
-            if (jsonObjectMatch) {
-                return JSON.parse(jsonObjectMatch[0]);
-            }
-            return null;
-        }
-
-        const jsonData = JSON.parse(jsonMatch[1]);
-        return jsonData;
-    } catch (error) {
-        console.error('[Character Parser] Failed to parse initialization data:', error);
-        return null;
-    }
-}
-
-/**
- * Parses relationship analysis data from JSON
- * @param {string} responseText - LLM response with JSON data
- * @returns {Object|null} Parsed relationship data or null if failed
- */
-export function parseRelationshipAnalysis(responseText) {
-    try {
-        // Extract JSON block
-        const jsonMatch = responseText.match(/```json\s*([\s\S]*?)```/);
-        if (!jsonMatch) {
-            // Try to find JSON without code blocks
-            const jsonObjectMatch = responseText.match(/\{[\s\S]*\}/);
-            if (jsonObjectMatch) {
-                return JSON.parse(jsonObjectMatch[0]);
-            }
-            return null;
-        }
-
-        const jsonData = JSON.parse(jsonMatch[1]);
-        return jsonData;
-    } catch (error) {
-        console.error('[Character Parser] Failed to parse relationship analysis:', error);
-        return null;
-    }
-}
-
-/**
- * Cleans the LLM response by removing the character state update block
- * This leaves only the actual roleplay response
- * @param {string} responseText - Full LLM response
- * @returns {string} Cleaned response without state update block
- */
-export function removeCharacterStateBlock(responseText) {
-    if (!responseText) return '';
-
-    // Remove character-state code block
-    let cleaned = responseText.replace(/```character-state\s*[\s\S]*?```/gi, '');
-
-    // Clean up extra whitespace
-    cleaned = cleaned.trim();
-
-    return cleaned;
-}

src/systems/generation/characterPromptBuilder.js

@@ -1,379 +0,0 @@
-/**
- * Character Prompt Builder Module
- * Handles AI prompt generation for character state tracking
- * Based on Katherine RPG System - tracks {{char}} states instead of {{user}}
- */
-
-import { getContext } from '../../../../../../extensions.js';
-import { chat, characters, this_chid } from '../../../../../../../script.js';
-import { selected_group, getGroupMembers, getGroupChat } from '../../../../../../group-chats.js';
-import { extensionSettings } from '../../core/state.js';
-import { getCharacterState } from '../../core/characterState.js';
-
-/**
- * Gets the main character name from the current chat
- * @returns {string} Character name
- */
-function getCharacterName() {
-    if (selected_group) {
-        // For group chats, we'll need to track multiple characters
-        // For now, return the first active character
-        const groupMembers = getGroupMembers(selected_group);
-        if (groupMembers && groupMembers.length > 0) {
-            return groupMembers[0].name;
-        }
-    } else if (this_chid !== undefined && characters && characters[this_chid]) {
-        return characters[this_chid].name;
-    }
-    return 'Character';
-}
-
-/**
- * Generates a summary of the current character states for LLM context
- * @returns {string} Formatted character state summary
- */
-export function generateCharacterStateSummary() {
-    const charState = getCharacterState();
-    const charName = charState.characterName || getCharacterName();
-
-    let summary = `=== ${charName}'s Current State ===\n\n`;
-
-    // Primary Traits (most important personality traits only)
-    summary += `**Core Personality Traits** (0-100 scale):\n`;
-    const keyTraits = {
-        dominance: charState.primaryTraits.dominance,
-        introversion: charState.primaryTraits.introversion,
-        emotionalStability: charState.primaryTraits.emotionalStability,
-        honesty: charState.primaryTraits.honesty,
-        empathy: charState.primaryTraits.empathy,
-        corruption: charState.primaryTraits.corruption
-    };
-    for (const [trait, value] of Object.entries(keyTraits)) {
-        if (value !== undefined && value !== null) {
-            summary += `- ${trait}: ${value}\n`;
-        }
-    }
-    summary += `\n`;
-
-    // Secondary States (current emotions)
-    summary += `**Current Emotional States** (0-100 intensity):\n`;
-    const activeStates = Object.entries(charState.secondaryStates)
-        .filter(([key, value]) => value > 10) // Only show non-trivial states
-        .sort((a, b) => b[1] - a[1]) // Sort by intensity
-        .slice(0, 10); // Top 10 states
-
-    if (activeStates.length > 0) {
-        for (const [state, value] of activeStates) {
-            summary += `- ${state}: ${value}\n`;
-        }
-    } else {
-        summary += `- (Emotionally neutral)\n`;
-    }
-    summary += `\n`;
-
-    // Physical Stats
-    summary += `**Physical Condition**:\n`;
-    summary += `- Health: ${charState.physicalStats.health || 100}%\n`;
-    summary += `- Energy: ${charState.physicalStats.energy || 70}%\n`;
-    summary += `- Hunger: ${charState.physicalStats.hunger || 40}%\n`;
-    summary += `- Arousal: ${charState.physicalStats.arousal || 0}%\n`;
-    summary += `\n`;
-
-    // Clothing Summary
-    if (charState.clothing && charState.clothing.totalCoverage !== undefined) {
-        summary += `**Current Outfit**: `;
-        const outfit = [];
-        if (charState.clothing.upperBody?.shirt?.worn) {
-            outfit.push(charState.clothing.upperBody.shirt.type);
-        }
-        if (charState.clothing.lowerBody?.pants?.worn) {
-            outfit.push(charState.clothing.lowerBody.pants.type);
-        }
-        if (outfit.length > 0) {
-            summary += outfit.join(', ');
-        } else {
-            summary += 'Minimal clothing';
-        }
-        summary += ` (${charState.clothing.totalCoverage}% coverage)\n\n`;
-    }
-
-    // Context Info
-    if (charState.contextInfo.location || charState.contextInfo.timeOfDay) {
-        summary += `**Scene Context**:\n`;
-        if (charState.contextInfo.location) {
-            summary += `- Location: ${charState.contextInfo.location}\n`;
-        }
-        if (charState.contextInfo.timeOfDay) {
-            summary += `- Time: ${charState.contextInfo.timeOfDay}\n`;
-        }
-        if (charState.contextInfo.presentCharacters && charState.contextInfo.presentCharacters.length > 0) {
-            summary += `- Present: ${charState.contextInfo.presentCharacters.join(', ')}\n`;
-        }
-        summary += `\n`;
-    }
-
-    // Relationships (active ones only)
-    const activeRelationships = Object.entries(charState.relationships)
-        .filter(([name, data]) => data.trust > 30 || data.love > 10 || data.attraction > 10);
-
-    if (activeRelationships.length > 0) {
-        summary += `**Key Relationships**:\n`;
-        for (const [name, rel] of activeRelationships) {
-            summary += `- ${name}: Trust ${rel.trust}, Love ${rel.love}, Attraction ${rel.attraction}\n`;
-            if (rel.currentThoughts) {
-                summary += `  Thoughts: "${rel.currentThoughts}"\n`;
-            }
-        }
-        summary += `\n`;
-    }
-
-    // Current Thoughts
-    if (charState.thoughts.internalMonologue) {
-        summary += `**Internal Thoughts**: "${charState.thoughts.internalMonologue}"\n\n`;
-    }
-
-    return summary;
-}
-
-/**
- * Generates the tracking prompt for character state updates
- * @returns {string} Formatted instruction text for the AI
- */
-export function generateCharacterTrackingInstructions() {
-    const charName = getCharacterName();
-    const charState = getCharacterState();
-
-    let instructions = `\n=== CHARACTER STATE TRACKING ===\n\n`;
-    instructions += `After your response, you MUST update ${charName}'s state based on what happened in your response.\n\n`;
-    instructions += `Provide the updates in this exact format:\n\n`;
-
-    instructions += `\`\`\`character-state\n`;
-    instructions += `${charName}'s State Update\n`;
-    instructions += `---\n\n`;
-
-    // Emotional States Changes
-    instructions += `**Emotional Changes**:\n`;
-    instructions += `- [Emotion]: [+/- amount] (reason: [brief explanation])\n`;
-    instructions += `Example: "happy: +15 (reason: received compliment from {{user}})"\n`;
-    instructions += `Example: "anxious: -10 (reason: situation resolved peacefully)"\n`;
-    instructions += `(Only list emotions that changed. Use +/- notation.)\n\n`;
-
-    // Physical State Changes
-    instructions += `**Physical Changes**:\n`;
-    instructions += `- Energy: [+/- amount] (reason: [brief])\n`;
-    instructions += `- Arousal: [+/- amount] (reason: [brief])\n`;
-    instructions += `- [Other stats if changed]: [+/- amount] (reason: [brief])\n\n`;
-
-    // Relationship Changes (if applicable)
-    instructions += `**Relationship Updates** (if any character interactions occurred):\n`;
-    instructions += `- [Character Name]:\n`;
-    instructions += `  - Trust: [+/- amount] (reason: [brief])\n`;
-    instructions += `  - Love: [+/- amount] (reason: [brief])\n`;
-    instructions += `  - Attraction: [+/- amount] (reason: [brief])\n`;
-    instructions += `  - Thoughts: "[what ${charName} is thinking about this person now]"\n\n`;
-
-    // Context Updates
-    instructions += `**Scene Context**:\n`;
-    instructions += `- Location: [current location]\n`;
-    instructions += `- Time: [current time of day]\n`;
-    instructions += `- Present: [list of characters currently in scene]\n\n`;
-
-    // Internal Thoughts
-    instructions += `**${charName}'s Thoughts**:\n`;
-    instructions += `"[${charName}'s internal monologue in first person, 1-3 sentences]"\n\n`;
-
-    // Clothing Changes (if applicable)
-    instructions += `**Outfit Changes** (only if clothing changed):\n`;
-    instructions += `- [Item]: [removed/added/changed to X]\n`;
-    instructions += `Example: "shirt: removed", "dress: added (red cocktail dress)"\n\n`;
-
-    instructions += `\`\`\`\n\n`;
-
-    instructions += `IMPORTANT GUIDELINES:\n`;
-    instructions += `1. All changes should be REALISTIC and GRADUAL (+/- 1-15 for normal events, +/- 20+ only for major events)\n`;
-    instructions += `2. Consider ${charName}'s personality traits when determining emotional reactions\n`;
-    instructions += `3. Track physical needs realistically (energy decreases with activity, arousal changes with context)\n`;
-    instructions += `4. Relationship changes require INTERACTION - don't change relationships with characters not in the scene\n`;
-    instructions += `5. Internal thoughts should reflect ${charName}'s true feelings, even if different from what they say\n`;
-    instructions += `6. If nothing significant happened, you can note "No significant state changes"\n\n`;
-
-    return instructions;
-}
-
-/**
- * Generates the full prompt for character state tracking in TOGETHER mode
- * This is injected as part of the main generation
- * @returns {string} Prompt text to inject
- */
-export function generateCharacterTrackingPrompt() {
-    const charName = getCharacterName();
-    const stateSummary = generateCharacterStateSummary();
-    const instructions = generateCharacterTrackingInstructions();
-
-    let prompt = `\n--- CHARACTER STATE TRACKING ---\n\n`;
-    prompt += stateSummary;
-    prompt += instructions;
-
-    return prompt;
-}
-
-/**
- * Generates the full prompt for SEPARATE character state tracking mode
- * Creates a message array suitable for the generateRaw API
- * @returns {Array<{role: string, content: string}>} Array of message objects for API
- */
-export async function generateSeparateCharacterTrackingPrompt() {
-    const depth = extensionSettings.updateDepth || 4;
-    const charName = getCharacterName();
-    const userName = getContext().name1;
-    const charState = getCharacterState();
-
-    const messages = [];
-
-    // System message
-    let systemMessage = `You are a character state tracking system for an AI roleplay.\n\n`;
-    systemMessage += `Your ONLY job is to analyze the most recent response from ${charName} and update their internal states accordingly.\n\n`;
-    systemMessage += `You must track:\n`;
-    systemMessage += `- Emotional states (happiness, arousal, stress, etc.)\n`;
-    systemMessage += `- Physical condition (energy, health, hunger, etc.)\n`;
-    systemMessage += `- Relationships (how ${charName} feels about other characters)\n`;
-    systemMessage += `- Internal thoughts (what ${charName} is truly thinking)\n`;
-    systemMessage += `- Context (location, time, who's present)\n\n`;
-    systemMessage += `Be realistic and consider ${charName}'s personality when determining state changes.\n\n`;
-
-    messages.push({
-        role: 'system',
-        content: systemMessage
-    });
-
-    // Add current character state
-    const stateSummary = generateCharacterStateSummary();
-    messages.push({
-        role: 'user',
-        content: `Current ${charName}'s state:\n\n${stateSummary}`
-    });
-
-    // Add recent chat history for context
-    messages.push({
-        role: 'user',
-        content: `Recent conversation history (for context):\n\n`
-    });
-
-    const recentMessages = chat.slice(-depth);
-    for (const message of recentMessages) {
-        messages.push({
-            role: message.is_user ? 'user' : 'assistant',
-            content: `[${message.is_user ? userName : charName}]: ${message.mes}`
-        });
-    }
-
-    // Add tracking instructions
-    const instructions = generateCharacterTrackingInstructions();
-    messages.push({
-        role: 'user',
-        content: instructions + `\nProvide ONLY the character state update in the exact format specified above. Do not include any other commentary.`
-    });
-
-    return messages;
-}
-
-/**
- * Generates a prompt for initializing character state from character card
- * This is used when starting a new chat or resetting state
- * @returns {string} Prompt for initialization
- */
-export async function generateCharacterInitializationPrompt() {
-    const charName = getCharacterName();
-    let character = null;
-
-    if (this_chid !== undefined && characters && characters[this_chid]) {
-        character = characters[this_chid];
-    }
-
-    let prompt = `You are analyzing a character card to initialize state tracking.\n\n`;
-
-    if (character) {
-        prompt += `Character: ${character.name}\n\n`;
-
-        if (character.description) {
-            prompt += `Description:\n${character.description}\n\n`;
-        }
-
-        if (character.personality) {
-            prompt += `Personality:\n${character.personality}\n\n`;
-        }
-
-        if (character.scenario) {
-            prompt += `Scenario:\n${character.scenario}\n\n`;
-        }
-    }
-
-    prompt += `Based on this character information, provide reasonable initial values (0-100 scale) for these personality traits:\n\n`;
-    prompt += `\`\`\`json\n`;
-    prompt += `{\n`;
-    prompt += `  "dominance": 50,\n`;
-    prompt += `  "introversion": 50,\n`;
-    prompt += `  "emotionalStability": 50,\n`;
-    prompt += `  "honesty": 50,\n`;
-    prompt += `  "empathy": 50,\n`;
-    prompt += `  "corruption": 10,\n`;
-    prompt += `  "intelligence": 50,\n`;
-    prompt += `  "confidence": 50\n`;
-    prompt += `}\n`;
-    prompt += `\`\`\`\n\n`;
-    prompt += `Consider the character's description and personality when setting these values.\n`;
-    prompt += `For example:\n`;
-    prompt += `- A shy character would have high introversion (70-90)\n`;
-    prompt += `- A leader would have high dominance (70-90)\n`;
-    prompt += `- A kind character would have high empathy (70-90)\n\n`;
-    prompt += `Provide ONLY the JSON object with your estimated values.`;
-
-    return prompt;
-}
-
-/**
- * Generates a relationship analysis prompt for a specific character
- * Used when a new character is introduced or to analyze existing relationships
- * @param {string} targetCharacterName - Name of the character to analyze relationship with
- * @returns {string} Prompt for relationship analysis
- */
-export function generateRelationshipAnalysisPrompt(targetCharacterName) {
-    const charName = getCharacterName();
-    const charState = getCharacterState();
-
-    let prompt = `Analyze ${charName}'s relationship with ${targetCharacterName} based on recent interactions.\n\n`;
-
-    // Add chat context
-    const recentMessages = chat.slice(-10).filter(msg => {
-        return msg.mes.toLowerCase().includes(targetCharacterName.toLowerCase());
-    });
-
-    if (recentMessages.length > 0) {
-        prompt += `Recent interactions:\n\n`;
-        for (const msg of recentMessages) {
-            prompt += `- ${msg.mes.substring(0, 200)}${msg.mes.length > 200 ? '...' : ''}\n`;
-        }
-        prompt += `\n`;
-    }
-
-    prompt += `Provide relationship stats (0-100 scale) in this format:\n\n`;
-    prompt += `\`\`\`json\n`;
-    prompt += `{\n`;
-    prompt += `  "trust": 50,\n`;
-    prompt += `  "love": 0,\n`;
-    prompt += `  "attraction": 0,\n`;
-    prompt += `  "respect": 50,\n`;
-    prompt += `  "closeness": 20,\n`;
-    prompt += `  "currentThoughts": "[What ${charName} thinks about ${targetCharacterName}]",\n`;
-    prompt += `  "relationshipStatus": "Stranger|Acquaintance|Friend|Close Friend|Lover|Enemy"\n`;
-    prompt += `}\n`;
-    prompt += `\`\`\`\n\n`;
-    prompt += `Consider:\n`;
-    prompt += `- How long they've known each other\n`;
-    prompt += `- Quality of interactions (positive/negative)\n`;
-    prompt += `- ${charName}'s personality (empathy: ${charState.primaryTraits.empathy}, trust tendency, etc.)\n`;
-    prompt += `- Current emotional state of ${charName}\n\n`;
-    prompt += `Provide ONLY the JSON object.`;
-
-    return prompt;
-}

src/systems/generation/encounterPrompts.js

@@ -0,0 +1,818 @@
+/**
+ * Encounter Prompt Builder Module
+ * Handles all AI prompt generation for combat encounters
+ */
+
+import { getContext } from '../../../../../../extensions.js';
+import { chat, characters, this_chid, substituteParams } from '../../../../../../../script.js';
+import { selected_group, getGroupMembers, groups } from '../../../../../../group-chats.js';
+import { extensionSettings, committedTrackerData } from '../../core/state.js';
+import { currentEncounter } from '../features/encounterState.js';
+import { repairJSON } from '../../utils/jsonRepair.js';
+import { buildInventorySummary, generateTrackerInstructions, generateTrackerExample } from './promptBuilder.js';
+import { applyLocks } from './lockManager.js';
+
+/**
+ * Gets character information from the current chat
+ * @returns {Promise<string>} Formatted character information
+ */
+async function getCharactersInfo() {
+    let characterInfo = '';
+
+    // Check if in group chat
+    if (selected_group) {
+        const group = groups.find(g => g.id === selected_group);
+        const groupMembers = getGroupMembers(selected_group);
+
+        if (groupMembers && groupMembers.length > 0) {
+            characterInfo += 'Characters in this roleplay:\n';
+
+            const disabledMembers = group?.disabled_members || [];
+            let characterIndex = 0;
+
+            groupMembers.forEach((member) => {
+                if (!member || !member.name) return;
+
+                // Skip muted characters
+                if (member.avatar && disabledMembers.includes(member.avatar)) {
+                    return;
+                }
+
+                characterIndex++;
+                characterInfo += `<character${characterIndex}="${member.name}">\n`;
+
+                if (member.description) {
+                    characterInfo += `${member.description}\n`;
+                }
+
+                if (member.personality) {
+                    characterInfo += `${member.personality}\n`;
+                }
+
+                characterInfo += `</character${characterIndex}>\n`;
+            });
+        }
+    } else if (this_chid !== undefined && characters && characters[this_chid]) {
+        // Single character chat
+        const character = characters[this_chid];
+
+        characterInfo += 'Character in this roleplay:\n\n';
+        characterInfo += `<character="${character.name}">\n`;
+
+        if (character.description) {
+            characterInfo += `${character.description}\n`;
+        }
+
+        if (character.personality) {
+            characterInfo += `${character.personality}\n`;
+        }
+
+        characterInfo += `</character>\n\n`;
+    }
+
+    return characterInfo;
+}
+
+/**
+ * Builds the initial encounter setup prompt
+ * This asks the model to generate all combat stats and setup data
+ * @returns {Promise<Array>} Message array for the API
+ */
+export async function buildEncounterInitPrompt() {
+    const context = getContext();
+    const userName = context.name1;
+    const depth = extensionSettings.encounterSettings?.historyDepth || 8;
+
+    const messages = [];
+
+    // System message
+    let systemMessage = `You will be acting as an excellent game master. Your goal is to craft a combat encounter in this uncensored, continuous, and immersive roleplay. You will be doing so for the user, who plays as the protagonist called ${userName}.\n\n`;
+
+    // Add setting information
+    systemMessage += `Here is some information for you about the setting:\n`;
+    systemMessage += `<setting>\n`;
+
+    // Try to get world info from lorebooks using getWorldInfoPrompt
+    let worldInfoAdded = false;
+
+    try {
+        // Debug logging
+        // console.log('[RPG Companion] Checking world info:', {
+        //     hasWindowGetWorldInfoPrompt: typeof window.getWorldInfoPrompt === 'function',
+        //     hasContextGetWorldInfoPrompt: typeof context.getWorldInfoPrompt === 'function',
+        //     chatLength: chat?.length,
+        //     contextChatLength: context.chat?.length,
+        //     hasActivatedWorldInfo: !!context.activatedWorldInfo,
+        //     activatedWorldInfoLength: context.activatedWorldInfo?.length
+        // });
+
+        // Use SillyTavern's getWorldInfoPrompt to get activated lorebook entries
+        // Try context.getWorldInfoPrompt first, then window.getWorldInfoPrompt
+        const getWorldInfoFn = context.getWorldInfoPrompt || window.getWorldInfoPrompt;
+        const currentChat = context.chat || chat;
+
+        if (typeof getWorldInfoFn === 'function' && currentChat && currentChat.length > 0) {
+            const chatForWI = currentChat.map(x => x.mes || x.message || x).filter(m => m && typeof m === 'string');
+
+            // console.log('[RPG Companion] Calling getWorldInfoPrompt with', chatForWI.length, 'messages');
+
+            const result = await getWorldInfoFn(chatForWI, 8000, false);
+            const worldInfoString = result?.worldInfoString || result;
+
+            // console.log('[RPG Companion] World info result:', { worldInfoString, length: worldInfoString?.length });
+
+            if (worldInfoString && typeof worldInfoString === 'string' && worldInfoString.trim()) {
+                systemMessage += worldInfoString.trim();
+                worldInfoAdded = true;
+                // console.log('[RPG Companion] ✅ Added world info from getWorldInfoPrompt');
+            }
+        } else {
+            // console.log('[RPG Companion] getWorldInfoPrompt not available or no chat');
+        }
+    } catch (e) {
+        console.warn('[RPG Companion] Failed to get world info from getWorldInfoPrompt:', e);
+    }
+
+    // Fallback to activatedWorldInfo
+    if (!worldInfoAdded && context.activatedWorldInfo && Array.isArray(context.activatedWorldInfo) && context.activatedWorldInfo.length > 0) {
+        // console.log('[RPG Companion] Using fallback activatedWorldInfo:', context.activatedWorldInfo.length, 'entries');
+        context.activatedWorldInfo.forEach((entry) => {
+            if (entry && entry.content) {
+                systemMessage += `${entry.content}\n\n`;
+                worldInfoAdded = true;
+            }
+        });
+    }
+
+    if (!worldInfoAdded) {
+        console.warn('[RPG Companion] ⚠️ No world information available');
+        systemMessage += 'No world information available.';
+    }
+
+    systemMessage += `\n</setting>\n\n`;
+
+    // Add character information
+    const charactersInfo = await getCharactersInfo();
+    if (charactersInfo) {
+        systemMessage += `Here is the information available to you about the characters participating in the fight:\n`;
+        systemMessage += `<characters>\n${charactersInfo}</characters>\n\n`;
+    }
+
+    // Add persona information
+    systemMessage += `Here are details about the user's ${userName}:\n`;
+    systemMessage += `<persona>\n`;
+
+    try {
+        const personaText = substituteParams('{{persona}}');
+        if (personaText && personaText !== '{{persona}}') {
+            systemMessage += personaText;
+        } else {
+            systemMessage += 'No persona information available.';
+        }
+    } catch (e) {
+        systemMessage += 'No persona information available.';
+    }
+
+    systemMessage += `\n</persona>\n\n`;
+
+    // Add chat history from before the encounter
+    systemMessage += `Here is the chat history from before the encounter started between the user and the assistant:\n`;
+    systemMessage += `<history>\n`;
+
+    messages.push({
+        role: 'system',
+        content: systemMessage
+    });
+
+    // Add recent chat history (last X messages before encounter)
+    if (chat && chat.length > 0) {
+        const recentMessages = chat.slice(-depth - 1, -1); // Exclude the last message (encounter trigger)
+
+        for (const message of recentMessages) {
+            const content = message.mes?.trim();
+            // Skip empty messages
+            if (content) {
+                messages.push({
+                    role: message.is_user ? 'user' : 'assistant',
+                    content: content
+                });
+            }
+        }
+
+        // Add the encounter trigger message
+        const lastMessage = chat[chat.length - 1];
+        if (lastMessage && lastMessage.mes?.trim()) {
+            currentEncounter.encounterStartMessage = lastMessage.mes;
+            messages.push({
+                role: lastMessage.is_user ? 'user' : 'assistant',
+                content: lastMessage.mes.trim()
+            });
+        }
+    }
+
+    // Build user's current stats
+    let userStatsInfo = '';
+
+    // Add HP and other stats from committed tracker data
+    if (committedTrackerData.userStats) {
+        userStatsInfo += `${userName}'s Current Stats:\n${committedTrackerData.userStats}\n\n`;
+    }
+
+    // Add skills if available
+    const skillsSection = extensionSettings.trackerConfig?.userStats?.skillsSection;
+    if (skillsSection?.enabled && skillsSection.customFields && skillsSection.customFields.length > 0) {
+        userStatsInfo += `${userName}'s Skills: ${skillsSection.customFields.join(', ')}\n`;
+    }
+
+    // Add inventory
+    const inventory = extensionSettings.userStats?.inventory;
+    if (inventory) {
+        const inventorySummary = buildInventorySummary(inventory);
+        userStatsInfo += `${userName}'s Inventory:\n${inventorySummary}\n\n`;
+    }
+
+    // Add classic stats/attributes
+    if (extensionSettings.classicStats) {
+        const stats = extensionSettings.classicStats;
+        userStatsInfo += `${userName}'s Attributes: `;
+        const showLevel = extensionSettings.trackerConfig?.userStats?.showLevel !== false;
+        const levelStr = showLevel ? `, LVL ${extensionSettings.level}` : '';
+        userStatsInfo += `STR ${stats.str}, DEX ${stats.dex}, CON ${stats.con}, INT ${stats.int}, WIS ${stats.wis}, CHA ${stats.cha}${levelStr}\n\n`;
+    }
+
+    // Add present characters info for party members
+    let partyInfo = '';
+    if (committedTrackerData.characterThoughts) {
+        partyInfo += `Present Characters (potential party members):\n${committedTrackerData.characterThoughts}\n\n`;
+    }
+
+    // Close history and add combat initialization instruction
+    let initInstruction = `</history>\n\n`;
+
+    // Wrap RPG Companion panel data in context tags
+    initInstruction += `Here is some additional tracked context for the scene:\n`;
+    initInstruction += `<context>\n`;
+    initInstruction += userStatsInfo;
+    initInstruction += partyInfo;
+    initInstruction += `</context>\n\n`;
+
+    initInstruction += `The combat starts now.\n\n`;
+    initInstruction += `Based on everything above, generate the initial combat state. Analyze who is in the party fighting alongside ${userName} (if anyone), and who the enemies are. Replace placeholders in [brackets] and X with actual values. Return ONLY a JSON object with the following structure:\n\n`;
+    initInstruction += `FORMAT:\n`;
+    initInstruction += `{\n`;
+    initInstruction += `  "party": [\n`;
+    initInstruction += `    {\n`;
+    initInstruction += `      "name": "${userName}",\n`;
+    initInstruction += `      "hp": X,\n`;
+    initInstruction += `      "maxHp": X,\n`;
+    initInstruction += `      "attacks": [\n`;
+    initInstruction += `        {"name": "Attack", "type": "single-target|AoE|both"},\n`;
+    initInstruction += `        {"name": "Skill1", "type": "single-target|AoE|both"}\n`;
+    initInstruction += `      ],\n`;
+    initInstruction += `      "items": ["Item Name x3", "Another Item x1"],\n`;
+    initInstruction += `      "statuses": [],\n`;
+    initInstruction += `      "isPlayer": true\n`;
+    initInstruction += `    }\n`;
+    initInstruction += `    // Add other party members here if they exist in the context, changing isPlayer to false for them.\n`;
+    initInstruction += `  ],\n`;
+    initInstruction += `  "enemies": [\n`;
+    initInstruction += `    {\n`;
+    initInstruction += `      "name": "Enemy Name",\n`;
+    initInstruction += `      "hp": X,\n`;
+    initInstruction += `      "maxHp": X,\n`;
+    initInstruction += `      "attacks": [\n`;
+    initInstruction += `        {"name": "Attack1", "type": "single-target|AoE|both"},\n`;
+    initInstruction += `        {"name": "Attack2", "type": "single-target|AoE|both"}\n`;
+    initInstruction += `      ],\n`;
+    initInstruction += `      "statuses": [],\n`;
+    initInstruction += `      "description": "Brief enemy description",\n`;
+    initInstruction += `      "sprite": "emoji or brief visual description"\n`;
+    initInstruction += `    }\n`;
+    initInstruction += `    // Add all enemies participating in this combat\n`;
+    initInstruction += `  ],\n`;
+    initInstruction += `  "environment": "Brief description of the combat environment",\n`;
+    initInstruction += `  "styleNotes": {\n`;
+    initInstruction += `    "environmentType": "forest|dungeon|desert|cave|city|ruins|snow|water|castle|wasteland|plains|mountains|swamp|volcanic|spaceship|mansion",\n`;
+    initInstruction += `    "atmosphere": "bright|dark|foggy|stormy|calm|eerie|chaotic|peaceful",\n`;
+    initInstruction += `    "timeOfDay": "dawn|day|dusk|night|twilight",\n`;
+    initInstruction += `    "weather": "clear|rainy|snowy|windy|stormy|overcast"\n`;
+    initInstruction += `  }\n`;
+    initInstruction += `}\n\n`;
+    initInstruction += `IMPORTANT NOTES:\n`;
+    initInstruction += `- For attacks array: Each attack must be an object with "name" and "type" properties\n`;
+    initInstruction += `  - "single-target": Can only target one character (enemy or ally)\n`;
+    initInstruction += `  - "AoE": Area of Effect - targets all enemies, but some AoE attacks (like storms, explosions) can also harm allies if the attack is indiscriminate\n`;
+    initInstruction += `  - "both": Player can choose to target a single enemy OR use as AoE\n`;
+    initInstruction += `- For items array: Include quantities using format "Item Name xN" (e.g., "Health Potion x3", "Bomb x1")\n`;
+    initInstruction += `  - If only one item exists, you can use "Item Name x1" or just "Item Name"\n`;
+    initInstruction += `  - Items will be consumed when used - the quantity will decrease in future turns\n`;
+    initInstruction += `- Statuses array: May start empty, but don't have to if characters applied them before the combat\n`;
+    initInstruction += `  - Each status has a format: {"name": "Status Name", "emoji": "💀", "duration": X}\n`;
+    initInstruction += `  - Examples: Poisoned (🧪), Burning (🔥), Blessed (✨), Stunned (💫), Weakened (⬇️), Strengthened (⬆️)\n\n`;
+    initInstruction += `The styleNotes object will be used to visually style the combat window - choose ONE value from each category that best fits the environment described in the chat history.\n\n`;
+    initInstruction += `Use the user's current stats, inventory, and skills to populate the party data. For ${userName}'s attacks array, include their available skills. For items, include usable items from their inventory WITH QUANTITIES (e.g., "Health Potion x3"). Set HP based on their current Health stat if available.\n\n`;
+    initInstruction += `Ensure all party members and enemies have realistic HP values based on the setting and their descriptions. Return ONLY the JSON object, no other text.`;
+
+    // Only add the instruction if it has meaningful content
+    if (initInstruction.trim()) {
+        messages.push({
+            role: 'user',
+            content: initInstruction.trim()
+        });
+    }
+
+    // Validate that we have at least one message with content
+    if (messages.length === 0 || messages.every(m => !m.content || !m.content.trim())) {
+        throw new Error('Unable to build encounter prompt - no valid content available');
+    }
+
+    return messages;
+}
+
+/**
+ * Builds a combat action prompt
+ * This is sent when the user takes an action in combat
+ * @param {string} action - The action taken by the user
+ * @param {object} combatStats - Current combat statistics
+ * @returns {Array} Message array for the API
+ */
+export async function buildCombatActionPrompt(action, combatStats) {
+    const context = getContext();
+    const userName = context.name1;
+    const depth = extensionSettings.encounterSettings?.historyDepth || 8;
+
+    // Get narrative style from settings
+    const narrativeStyle = extensionSettings.encounterSettings?.combatNarrative || {};
+    const tense = narrativeStyle.tense || 'present';
+    const person = narrativeStyle.person || 'third';
+    const narration = narrativeStyle.narration || 'omniscient';
+    const pov = narrativeStyle.pov || 'narrator';
+
+    const messages = [];
+
+    // Build system message with setting info
+    let systemMessage = `You are the game master managing this combat encounter. You must not play as ${userName} - only describe what happens as a result of their actions/dialogues and control NPCs/enemies.\n\n`;
+
+    // Add setting information
+    systemMessage += `Here is some information for you about the setting:\n`;
+    systemMessage += `<setting>\n`;
+
+    // Get world info
+    let worldInfoAdded = false;
+    try {
+        const getWorldInfoFn = context.getWorldInfoPrompt || window.getWorldInfoPrompt;
+        const currentChat = context.chat || chat;
+
+        if (typeof getWorldInfoFn === 'function' && currentChat && currentChat.length > 0) {
+            const chatForWI = currentChat.map(x => x.mes || x.message || x).filter(m => m && typeof m === 'string');
+            const result = await getWorldInfoFn(chatForWI, 8000, false);
+            const worldInfoString = result?.worldInfoString || result;
+
+            if (worldInfoString && typeof worldInfoString === 'string' && worldInfoString.trim()) {
+                systemMessage += worldInfoString.trim();
+                worldInfoAdded = true;
+            }
+        }
+    } catch (e) {
+        console.warn('[RPG Companion] Failed to get world info for combat action:', e);
+    }
+
+    if (!worldInfoAdded && context.activatedWorldInfo && Array.isArray(context.activatedWorldInfo) && context.activatedWorldInfo.length > 0) {
+        context.activatedWorldInfo.forEach((entry) => {
+            if (entry && entry.content) {
+                systemMessage += `${entry.content}\n\n`;
+                worldInfoAdded = true;
+            }
+        });
+    }
+
+    if (!worldInfoAdded) {
+        systemMessage += 'No world information available.';
+    }
+
+    systemMessage += `\n</setting>\n\n`;
+
+    // Add character information
+    const charactersInfo = await getCharactersInfo();
+    if (charactersInfo) {
+        systemMessage += `Here is the information available to you about the characters:\n`;
+        systemMessage += `<characters>\n${charactersInfo}</characters>\n\n`;
+    }
+
+    // Add persona info
+    if (context.name1) {
+        systemMessage += `The protagonist is:\n`;
+        systemMessage += `<persona>\n`;
+
+        // Use substituteParams to get {{persona}} like in initial encounter
+        try {
+            const personaText = substituteParams('{{persona}}');
+            if (personaText && personaText !== '{{persona}}') {
+                systemMessage += personaText;
+            } else {
+                systemMessage += `Name: ${context.name1}\n`;
+                if (extensionSettings.userStats?.personaDescription) {
+                    systemMessage += `${extensionSettings.userStats.personaDescription}\n`;
+                }
+            }
+        } catch (e) {
+            systemMessage += `Name: ${context.name1}\n`;
+            if (extensionSettings.userStats?.personaDescription) {
+                systemMessage += `${extensionSettings.userStats.personaDescription}\n`;
+            }
+        }
+
+        // Add ONLY classic stats/attributes if enabled
+        if (extensionSettings.classicStats) {
+            const stats = extensionSettings.classicStats;
+            const config = extensionSettings.trackerConfig?.userStats;
+            const rpgAttributes = (config?.rpgAttributes && config.rpgAttributes.length > 0) ? config.rpgAttributes : [
+                { id: 'str', name: 'STR', enabled: true },
+                { id: 'dex', name: 'DEX', enabled: true },
+                { id: 'con', name: 'CON', enabled: true },
+                { id: 'int', name: 'INT', enabled: true },
+                { id: 'wis', name: 'WIS', enabled: true },
+                { id: 'cha', name: 'CHA', enabled: true }
+            ];
+            const enabledAttributes = rpgAttributes.filter(attr => attr && attr.enabled && attr.name && attr.id);
+            const attributeStrings = enabledAttributes.map(attr => `${attr.name} ${stats[attr.id] || 10}`);
+            systemMessage += `\nAttributes: ${attributeStrings.join(', ')}, LVL ${extensionSettings.level}\n`;
+        }
+
+        systemMessage += `</persona>\n\n`;
+    }
+
+    messages.push({
+        role: 'system',
+        content: systemMessage
+    });
+
+    // Add recent chat history for context - append as user/assistant messages like initial encounter
+    const currentChat = context.chat || chat;
+    if (currentChat && currentChat.length > 0) {
+        const recentMessages = currentChat.slice(-depth);
+
+        for (const message of recentMessages) {
+            const content = message.mes?.trim();
+            // Skip empty messages
+            if (content) {
+                messages.push({
+                    role: message.is_user ? 'user' : 'assistant',
+                    content: content
+                });
+            }
+        }
+    }
+
+    // Add combat log as plain text (previous actions)
+    if (currentEncounter.encounterLog && currentEncounter.encounterLog.length > 0) {
+        let combatHistory = 'Previous Combat Actions:\n';
+        currentEncounter.encounterLog.forEach(entry => {
+            combatHistory += `- ${entry.action}\n`;
+            if (entry.result) {
+                combatHistory += `  ${entry.result}\n`;
+            }
+        });
+
+        messages.push({
+            role: 'user',
+            content: combatHistory
+        });
+    }
+
+    // Add current combat state with FULL information (but tell AI not to regenerate static parts)
+    let stateMessage = `Current Combat State:\n`;
+    stateMessage += `Environment: ${combatStats.environment || 'Unknown location'}\n\n`;
+
+    stateMessage += `Party Members:\n`;
+    combatStats.party.forEach(member => {
+        stateMessage += `- ${member.name}${member.isPlayer ? ' (Player)' : ''}: ${member.hp}/${member.maxHp} HP\n`;
+
+        // For the player, use playerActions if available, otherwise fall back to member data
+        if (member.isPlayer && currentEncounter.playerActions) {
+            if (currentEncounter.playerActions.attacks && currentEncounter.playerActions.attacks.length > 0) {
+                stateMessage += `  Attacks: ${currentEncounter.playerActions.attacks.map(a => typeof a === 'string' ? a : a.name).join(', ')}\n`;
+            }
+            if (currentEncounter.playerActions.items && currentEncounter.playerActions.items.length > 0) {
+                stateMessage += `  Items: ${currentEncounter.playerActions.items.join(', ')}\n`;
+            }
+        } else {
+            // For non-player party members, use their own data
+            if (member.attacks && member.attacks.length > 0) {
+                stateMessage += `  Attacks: ${member.attacks.map(a => typeof a === 'string' ? a : a.name).join(', ')}\n`;
+            }
+            if (member.items && member.items.length > 0) {
+                stateMessage += `  Items: ${member.items.join(', ')}\n`;
+            }
+        }
+
+        if (member.statuses && member.statuses.length > 0) {
+            const validStatuses = member.statuses.filter(s => s && (s.emoji || s.name));
+            if (validStatuses.length > 0) {
+                stateMessage += `  Status Effects: ${validStatuses.map(s => `${s.emoji || ''} ${s.name || ''}`.trim()).join(', ')}\n`;
+            }
+        }
+    });
+
+    stateMessage += `\nEnemies:\n`;
+    combatStats.enemies.forEach(enemy => {
+        stateMessage += `- ${enemy.name} (${enemy.sprite || ''}): ${enemy.hp}/${enemy.maxHp} HP\n`;
+        if (enemy.description) {
+            stateMessage += `  ${enemy.description}\n`;
+        }
+        if (enemy.attacks && enemy.attacks.length > 0) {
+            stateMessage += `  Attacks: ${enemy.attacks.map(a => typeof a === 'string' ? a : a.name).join(', ')}\n`;
+        }
+        if (enemy.statuses && enemy.statuses.length > 0) {
+            const validStatuses = enemy.statuses.filter(s => s && (s.emoji || s.name));
+            if (validStatuses.length > 0) {
+                stateMessage += `  Status Effects: ${validStatuses.map(s => `${s.emoji || ''} ${s.name || ''}`.trim()).join(', ')}\n`;
+            }
+        }
+    });
+
+    stateMessage += `\n${userName}'s Action: ${action}\n\n`;
+    stateMessage += `Respond with the exact JSON object as below, containing ONLY these specified values. Remember to consider the user's party and their moves. DO NOT regenerate character descriptions, sprites, or environment.\n\n`;
+    stateMessage += `IMPORTANT - Update ${userName}'s attacks and items arrays based on what happens in combat:\n`;
+    stateMessage += `- ${userName}'s action is already specified above - do NOT regenerate it. Only update ${userName}'s attacks/items arrays if their action consumed resources (used item, lost ability, etc.).\n`;
+    stateMessage += `- If they use an item, decrement its quantity ("Health Potion x3" becomes "Health Potion x2"). If quantity reaches 0, remove the item entirely.\n`;
+    stateMessage += `- If they gain or lose an ability due to status effects, add or remove it from their attacks array.\n`;
+    stateMessage += `  Examples: Disarmed → remove weapon attacks. Bound → remove all attacks or set to []. Freed → restore attacks.\n`;
+    stateMessage += `- If they pick up a weapon/item during combat, add it to their items or attacks array.\n`;
+    stateMessage += `- If environmental changes enable new actions (near water → "Splash Attack"), add them. If they disable actions (fire goes out → remove "Ignite"), remove them.\n`;
+    stateMessage += `- Status effects should persist and decrease duration each turn. Remove statuses when duration reaches 0.\n\n`;
+    stateMessage += `FORMAT:\n`;
+    stateMessage += `{\n`;
+    stateMessage += `  "combatStats": {\n`;
+    stateMessage += `    "party": [\n`;
+    stateMessage += `      {\n`;
+    stateMessage += `        "name": "Name",\n`;
+    stateMessage += `        "hp": X,\n`;
+    stateMessage += `        "maxHp": X,\n`;
+    stateMessage += `        "statuses": [{"name": "Status", "emoji": "💀", "duration": X}],\n`;
+    stateMessage += `        "isPlayer": true|false\n`;
+    stateMessage += `      }\n`;
+    stateMessage += `    ],\n`;
+    stateMessage += `    "enemies": [\n`;
+    stateMessage += `      {\n`;
+    stateMessage += `        "name": "Name",\n`;
+    stateMessage += `        "hp": X,\n`;
+    stateMessage += `        "maxHp": X,\n`;
+    stateMessage += `        "statuses": [{"name": "Status", "emoji": "💀", "duration": X}]\n`;
+    stateMessage += `      }\n`;
+    stateMessage += `    ]\n`;
+    stateMessage += `  },\n`;
+    stateMessage += `  "playerActions": {\n`;
+    stateMessage += `    "attacks": [{"name": "Attack", "type": "single-target|AoE|both"}],\n`;
+    stateMessage += `    "items": ["Item Name x3", "Another Item x1"]\n`;
+    stateMessage += `  },\n`;
+    stateMessage += `  "enemyActions": [{ "enemyName": "Name", "action": "what they do", "target": "target" }],\n`;
+    stateMessage += `  "partyActions": [{ "memberName": "Name", "action": "what they do", "target": "target" }],\n`;
+    stateMessage += `  "narrative": "The roleplay description of what happens"\n`;
+    stateMessage += `}\n\n`;
+    stateMessage += `If all enemies are defeated or escape: add "combatEnd": true, "result": "victory". If all party defeated: add "combatEnd": true, "result": "defeat". It's also possible for the encounter to be interrupted by external interference (e.g., an explosion knocks everyone out, sudden environmental catastrophe, third party intervention, etc.). If this occurs, add "combatEnd": true, "result": "interrupted". Each status (if applied) has a format: {"name": "Status Name", "emoji": "💀", "duration": X}.\n`;
+    stateMessage += `Scale combat difficulty appropriately: Powerful entities (gods, dragons, legendary creatures) should be formidable challenges requiring multiple rounds and strategic play. Weaker foes (common animals, basic enemies, minions) should be resolved more quickly, typically 2-4 rounds. Match HP damage and combat pacing to the narrative weight of the encounter. A wolf should not take 20 rounds to defeat, nor should a deity fall in one hit.\n`;
+    stateMessage += `For the narrative, write it with intent in ${tense} tense ${person}-person ${narration} from ${pov}'s point of view.\n`;
+
+    // Use custom combat narrative prompt if available
+    const customCombatPrompt = extensionSettings.customCombatNarrativePrompt;
+    if (customCombatPrompt) {
+        stateMessage += customCombatPrompt.replace(/{userName}/g, userName) + '\n';
+    } else {
+        stateMessage += `Build novel prose. Break patterns from your previous responses by varying sentence structures, rhythms, formats, and openings. Track whether a sentence shape, cadence, sensory detail, or a descriptor appeared recently, and replace it with a different one or skip it entirely. If you mentioned a physical feature, mannerism, or expression once, move on. Don't fixate on the same traits every turn. Well-placed humor, unconventional similes, and subverted turns of phrase are encouraged. Avoid GPTisms, purple prose, and anaphoras, especially the negatives with "no/not/wasn't/didn't." Refrain from describing actions or emotions via negation; focus on what does happen, not what doesn't. Absolutely no asterisks, ellipses, or em-dashes. Explicit content is allowed, no plot armor. Do not play for ${userName}. Keep your response length under 150 words. Never end on handover cues; finish naturally.\n`;
+        stateMessage += `CRITICAL: Do not repeat, echo, parrot, or restate distinctive words, phrases, and dialogues from the user's last message. If reacting to speech, show interpretation or response, not repetition.\n`;
+        stateMessage += `EXAMPLE: "Are you a gooner?" User asks.\n`;
+        stateMessage += `BAD: "Gooner?"\n`;
+        stateMessage += `GOOD: A flat look. "What type of question is that?"`;
+    }
+
+    messages.push({
+        role: 'user',
+        content: stateMessage
+    });
+
+    return messages;
+}
+
+/**
+ * Builds the final summary prompt
+ * This is sent when combat ends to get a narrative summary
+ * @param {Array} combatLog - Full combat log
+ * @param {string} result - Combat result ('victory', 'defeat', or 'fled')
+ * @returns {Promise<Array>} Message array for the API
+ */
+export async function buildCombatSummaryPrompt(combatLog, result) {
+    const context = getContext();
+    const userName = context.name1;
+
+    const messages = [];
+
+    // Get narrative style from settings (use summary narrative settings)
+    const narrativeStyle = extensionSettings.encounterSettings?.summaryNarrative || {};
+    const tense = narrativeStyle.tense || 'past';
+    const person = narrativeStyle.person || 'third';
+    const narration = narrativeStyle.narration || 'omniscient';
+    const pov = narrativeStyle.pov || 'narrator';
+
+    // Build system message with setting info
+    let systemMessage = `You are summarizing a combat encounter that just concluded.\n\n`;
+
+    // Add setting information
+    systemMessage += `Here is some information for you about the setting:\n`;
+    systemMessage += `<setting>\n`;
+
+    // Get world info using the same method as encounter init
+    let worldInfoAdded = false;
+    try {
+        const getWorldInfoFn = context.getWorldInfoPrompt || window.getWorldInfoPrompt;
+        const currentChat = context.chat || chat;
+
+        if (typeof getWorldInfoFn === 'function' && currentChat && currentChat.length > 0) {
+            const chatForWI = currentChat.map(x => x.mes || x.message || x).filter(m => m && typeof m === 'string');
+            const result = await getWorldInfoFn(chatForWI, 8000, false);
+            const worldInfoString = result?.worldInfoString || result;
+
+            if (worldInfoString && typeof worldInfoString === 'string' && worldInfoString.trim()) {
+                systemMessage += worldInfoString.trim();
+                worldInfoAdded = true;
+            }
+        }
+    } catch (e) {
+        console.warn('[RPG Companion] Failed to get world info for summary:', e);
+    }
+
+    // Fallback to activatedWorldInfo
+    if (!worldInfoAdded && context.activatedWorldInfo && Array.isArray(context.activatedWorldInfo) && context.activatedWorldInfo.length > 0) {
+        context.activatedWorldInfo.forEach((entry) => {
+            if (entry && entry.content) {
+                systemMessage += `${entry.content}\n\n`;
+                worldInfoAdded = true;
+            }
+        });
+    }
+
+    if (!worldInfoAdded) {
+        systemMessage += 'No world information available.';
+    }
+
+    systemMessage += `\n</setting>\n\n`;
+
+    // Add character information
+    const charactersInfo = await getCharactersInfo();
+    if (charactersInfo) {
+        systemMessage += `Here is the information available to you about the characters:\n`;
+        systemMessage += `<characters>\n${charactersInfo}</characters>\n\n`;
+    }
+
+    // Add persona information
+    systemMessage += `Here are details about ${userName}:\n`;
+    systemMessage += `<persona>\n`;
+
+    try {
+        const personaText = substituteParams('{{persona}}');
+        if (personaText && personaText !== '{{persona}}') {
+            systemMessage += personaText;
+        } else {
+            systemMessage += 'No persona information available.';
+        }
+    } catch (e) {
+        systemMessage += 'No persona information available.';
+    }
+
+    systemMessage += `\n</persona>\n\n`;
+
+    // Add the message that triggered the encounter
+    if (currentEncounter.encounterStartMessage) {
+        systemMessage += `Here is the last message before combat started:\n`;
+        systemMessage += `<trigger>\n${currentEncounter.encounterStartMessage}\n</trigger>\n\n`;
+    }
+
+    messages.push({
+        role: 'system',
+        content: systemMessage
+    });
+
+    let summaryMessage = `Combat has ended with result: ${result}\n\n`;
+    summaryMessage += `Full Combat Log:\n`;
+
+    combatLog.forEach((entry, index) => {
+        summaryMessage += `\nRound ${index + 1}:\n`;
+        summaryMessage += `${entry.action}\n`;
+        summaryMessage += `${entry.result}\n`;
+    });
+
+    summaryMessage += `\n\nProvide a narrative summary of the entire fight in a way that fits the style from the chat history. Start with [FIGHT CONCLUDED] on the first line, then provide the description.\n\n`;
+    summaryMessage += `Write with intent in ${tense} tense ${person}-person ${narration} from ${pov}'s point of view.\n`;
+    summaryMessage += `Build novel prose. Break patterns from your previous responses by varying sentence structures, rhythms, formats, and openings. If you last started with a narration, begin this one with dialogue; if with an action, switch to an internal thought. Track whether a sentence shape, cadence, sensory detail, or a descriptor appeared recently, and replace it with a different one or skip it entirely. If you mentioned a physical feature, mannerism, or expression once, move on. Don't fixate on the same traits every turn. Well-placed humor, unconventional similes, and subverted turns of phrase are encouraged. Avoid GPTisms, purple prose, and anaphoras, especially the negatives with "no/not/wasn't/didn't." Refrain from describing actions or emotions via negation; focus on what does happen, not what doesn't. Minimize asterisks, ellipses, and em-dashes. Explicit content is allowed. Never end on handover cues; finish naturally.\n\n`;
+    summaryMessage += `Dialogue Guidelines:\n`;
+    summaryMessage += `- Include ALL dialogue lines spoken by enemies and NPC party members during the encounter in direct quotes.\n`;
+    summaryMessage += `- Never quote ${userName} directly. Express their actions and dialogue using ONLY indirect speech (e.g., "${userName} swung their sword" or "${userName} asked for help").\n\n`;
+
+    // If in Together mode and trackers are enabled, add tracker update instructions
+    if (extensionSettings.generationMode === 'together' && (extensionSettings.showUserStats || extensionSettings.showInfoBox || extensionSettings.showCharacterThoughts)) {
+        summaryMessage += `\n--- TRACKER UPDATE ---\n\n`;
+        summaryMessage += `After the [FIGHT CONCLUDED] summary, update the RPG trackers to reflect ${userName}'s state AFTER the combat encounter. `;
+        summaryMessage += `Account for any injuries sustained, resources used, emotional state changes, or other consequences of the battle.\n\n`;
+
+        // Include pre-combat tracker state if available
+        if (committedTrackerData.userStats || committedTrackerData.infoBox || committedTrackerData.characterThoughts) {
+            summaryMessage += `Pre-combat tracker state:\n`;
+            summaryMessage += `<previous>\n`;
+
+            if (committedTrackerData.userStats) {
+                const statsJSON = typeof committedTrackerData.userStats === 'object'
+                    ? JSON.stringify(committedTrackerData.userStats, null, 2)
+                    : committedTrackerData.userStats;
+                summaryMessage += statsJSON + '\n';
+            }
+
+            if (committedTrackerData.infoBox) {
+                const infoBoxJSON = typeof committedTrackerData.infoBox === 'object'
+                    ? JSON.stringify(committedTrackerData.infoBox, null, 2)
+                    : committedTrackerData.infoBox;
+                summaryMessage += infoBoxJSON + '\n';
+            }
+
+            if (committedTrackerData.characterThoughts) {
+                const charactersJSON = typeof committedTrackerData.characterThoughts === 'object'
+                    ? JSON.stringify(committedTrackerData.characterThoughts, null, 2)
+                    : committedTrackerData.characterThoughts;
+                summaryMessage += charactersJSON + '\n';
+            }
+
+            summaryMessage += `</previous>\n\n`;
+        }
+
+        // Add tracker instructions and example
+        const trackerInstructions = generateTrackerInstructions(false, false, true);
+        summaryMessage += trackerInstructions;
+
+        const trackerExample = generateTrackerExample();
+        if (trackerExample) {
+            summaryMessage += `\n${trackerExample}`;
+        }
+    }
+
+    messages.push({
+        role: 'user',
+        content: summaryMessage
+    });
+
+    return messages;
+}
+
+/**
+ * Parses JSON response from the AI, handling code blocks
+ * @param {string} response - The AI response
+ * @returns {object|null} Parsed JSON object or null if parsing fails
+ */
+export function parseEncounterJSON(response) {
+    try {
+        // Ensure response is a string
+        if (!response || typeof response !== 'string') {
+            console.error('[RPG Companion] parseEncounterJSON received non-string input:', typeof response);
+            return null;
+        }
+
+        // Remove code blocks if present
+        let cleaned = response.trim();
+
+        // Remove ```json, ```markdown, and ``` markers (more comprehensive)
+        cleaned = cleaned.replace(/```(?:json|markdown)?\s*/gi, '');
+
+        // Remove any remaining backticks
+        cleaned = cleaned.replace(/`/g, '');
+
+        // Find the first { and last }
+        const firstBrace = cleaned.indexOf('{');
+        const lastBrace = cleaned.lastIndexOf('}');
+
+        if (firstBrace !== -1 && lastBrace !== -1) {
+            cleaned = cleaned.substring(firstBrace, lastBrace + 1);
+        } else {
+            console.error('[RPG Companion] No JSON object found in response');
+            return null;
+        }
+
+        // Try to parse directly first
+        try {
+            return JSON.parse(cleaned);
+        } catch (initialError) {
+            // If direct parsing fails, try JSON repair
+            console.warn('[RPG Companion] Initial parse failed, attempting JSON repair...');
+            const repaired = repairJSON(cleaned);
+
+            if (repaired) {
+                // console.log('[RPG Companion] ✓ Successfully repaired encounter JSON');
+                return repaired;
+            }
+
+            // If repair also failed, throw the original error
+            throw initialError;
+        }
+    } catch (error) {
+        console.error('[RPG Companion] Failed to parse encounter JSON:', error);
+        console.error('[RPG Companion] Response was:', response);
+        return null;
+    }
+}

src/systems/generation/injector.js

@@ -4,14 +4,13 @@
  */
 
 import { getContext } from '../../../../../../extensions.js';
-import { setExtensionPrompt, extension_prompt_types, extension_prompt_roles } from '../../../../../../../script.js';
+import { extension_prompt_types, extension_prompt_roles, setExtensionPrompt, eventSource, event_types } from '../../../../../../../script.js';
 import {
     extensionSettings,
     committedTrackerData,
     lastGeneratedData,
     isGenerating,
-    lastActionWasSwipe,
-    setLastActionWasSwipe
+    lastActionWasSwipe
 } from '../../core/state.js';
 import { evaluateSuppression } from './suppression.js';
 import { parseUserStats } from './parser.js';
@@ -19,8 +18,528 @@ import {
     generateTrackerExample,
     generateTrackerInstructions,
     generateContextualSummary,
-    DEFAULT_HTML_PROMPT
+    formatHistoricalTrackerData,
+    DEFAULT_HTML_PROMPT,
+    DEFAULT_DIALOGUE_COLORING_PROMPT,
+    DEFAULT_DECEPTION_PROMPT,
+    DEFAULT_OMNISCIENCE_FILTER_PROMPT,
+    DEFAULT_CYOA_PROMPT,
+    DEFAULT_SPOTIFY_PROMPT,
+    DEFAULT_NARRATOR_PROMPT,
+    DEFAULT_CONTEXT_INSTRUCTIONS_PROMPT,
+    SPOTIFY_FORMAT_INSTRUCTION
 } from './promptBuilder.js';
+import { restoreCheckpointOnLoad } from '../features/chapterCheckpoint.js';
+
+// Track suppression state for event handler
+let currentSuppressionState = false;
+
+// Type imports
+/** @typedef {import('../../types/inventory.js').InventoryV2} InventoryV2 */
+
+// Track last chat length we committed at to prevent duplicate commits from streaming
+let lastCommittedChatLength = -1;
+
+// Store context map for prompt injection (used by event handlers)
+let pendingContextMap = new Map();
+
+// Flag to track if injection already happened in BEFORE_COMBINE
+let historyInjectionDone = false;
+
+/**
+ * Builds a map of historical context data from ST chat messages with rpg_companion_swipes data.
+ * Returns a map keyed by message index with formatted context strings.
+ * The index stored depends on the injection position setting.
+ *
+ * @returns {Map<number, string>} Map of target message index to formatted context string
+ */
+function buildHistoricalContextMap() {
+    const historyPersistence = extensionSettings.historyPersistence;
+    if (!historyPersistence || !historyPersistence.enabled) {
+        return new Map();
+    }
+
+    const context = getContext();
+    const chat = context.chat;
+    if (!chat || chat.length < 2) {
+        return new Map();
+    }
+
+    const trackerConfig = extensionSettings.trackerConfig;
+    const userName = context.name1;
+    const position = historyPersistence.injectionPosition || 'assistant_message_end';
+    const contextMap = new Map();
+
+    // Determine how many messages to include (0 = all available)
+    const messageCount = historyPersistence.messageCount || 0;
+    const maxMessages = messageCount === 0 ? chat.length : Math.min(messageCount, chat.length);
+
+    // Find the last assistant message - this is the one that gets current context via setExtensionPrompt
+    // We should NOT add historical context to it when injecting into assistant messages
+    // But when injecting into user messages, we DO need to process it to get context for the preceding user message
+    let lastAssistantIndex = -1;
+    for (let i = chat.length - 1; i >= 0; i--) {
+        if (!chat[i].is_user && !chat[i].is_system) {
+            lastAssistantIndex = i;
+            break;
+        }
+    }
+
+    // Iterate through messages to find those with tracker data
+    // For user_message_end: start from the last assistant message (we need its context for the preceding user message)
+    // For assistant_message_end: start from before the last assistant message (it gets current context via setExtensionPrompt)
+    let processedCount = 0;
+    const startIndex = position === 'user_message_end'
+        ? lastAssistantIndex
+        : (lastAssistantIndex > 0 ? lastAssistantIndex - 1 : chat.length - 2);
+
+    for (let i = startIndex; i >= 0 && (messageCount === 0 || processedCount < maxMessages); i--) {
+        const message = chat[i];
+
+        // Skip system messages
+        if (message.is_system) {
+            continue;
+        }
+
+        // Only assistant messages have rpg_companion_swipes data
+        if (message.is_user) {
+            continue;
+        }
+
+        // Get the rpg_companion_swipes data for current swipe
+        // Data can be in two places:
+        // 1. message.extra.rpg_companion_swipes (current session, before save)
+        // 2. message.swipe_info[swipeId].extra.rpg_companion_swipes (loaded from file)
+        const currentSwipeId = message.swipe_id || 0;
+        let swipeData = message.extra?.rpg_companion_swipes;
+
+        // If not in message.extra, check swipe_info
+        if (!swipeData && message.swipe_info && message.swipe_info[currentSwipeId]) {
+            swipeData = message.swipe_info[currentSwipeId].extra?.rpg_companion_swipes;
+        }
+
+        if (!swipeData) {
+            continue;
+        }
+
+        const trackerData = swipeData[currentSwipeId];
+        if (!trackerData) {
+            continue;
+        }
+
+        // Format the historical tracker data using the shared function
+        const formattedContext = formatHistoricalTrackerData(trackerData, trackerConfig, userName);
+        if (!formattedContext) {
+            continue;
+        }
+
+        // Build the context wrapper
+        const preamble = historyPersistence.contextPreamble || 'Context for that moment:';
+        const wrappedContext = `\n${preamble}\n${formattedContext}`;
+
+        // Determine which message index to store based on injection position
+        let targetIndex = i; // Default: the assistant message itself
+
+        if (position === 'user_message_end') {
+            // Find the preceding user message before this assistant message
+            // This is the user message that prompted this assistant response
+            for (let j = i - 1; j >= 0; j--) {
+                if (chat[j].is_user && !chat[j].is_system) {
+                    targetIndex = j;
+                    break;
+                }
+            }
+            // If no user message found before, skip this one
+            if (targetIndex === i) {
+                continue;
+            }
+        }
+        // For assistant_message_end, extra_user_message, extra_assistant_message:
+        // We inject into the assistant message itself (for now - extra messages handled differently)
+
+        // Store the context keyed by target index
+        // If multiple assistant messages map to the same user message, append
+        if (contextMap.has(targetIndex)) {
+            contextMap.set(targetIndex, contextMap.get(targetIndex) + wrappedContext);
+        } else {
+            contextMap.set(targetIndex, wrappedContext);
+        }
+
+        processedCount++;
+    }
+
+    return contextMap;
+}
+
+/**
+ * Prepares historical context for injection into prompts.
+ * This builds the context map and stores it for use by prompt event handlers.
+ * Does NOT modify the original chat messages.
+ */
+function prepareHistoricalContextInjection() {
+    const historyPersistence = extensionSettings.historyPersistence;
+    if (!historyPersistence || !historyPersistence.enabled) {
+        pendingContextMap = new Map();
+        return;
+    }
+
+    if (currentSuppressionState || !extensionSettings.enabled) {
+        pendingContextMap = new Map();
+        return;
+    }
+
+    const context = getContext();
+    const chat = context.chat;
+    if (!chat || chat.length < 2) {
+        pendingContextMap = new Map();
+        historyInjectionDone = false;
+        return;
+    }
+
+    // Build and store the context map for use by prompt handlers
+    pendingContextMap = buildHistoricalContextMap();
+    historyInjectionDone = false; // Reset flag for new generation
+}
+
+/**
+ * Finds the best match position for message content in the prompt.
+ * Tries full content first, then progressively smaller suffixes.
+ *
+ * @param {string} prompt - The prompt to search in
+ * @param {string} messageContent - The message content to find
+ * @returns {{start: number, end: number}|null} - Position info or null if not found
+ */
+function findMessageInPrompt(prompt, messageContent) {
+    if (!messageContent || !prompt) {
+        return null;
+    }
+
+    // Try to find the full content first
+    let searchIndex = prompt.lastIndexOf(messageContent);
+
+    if (searchIndex !== -1) {
+        return { start: searchIndex, end: searchIndex + messageContent.length };
+    }
+
+    // If full content not found, try last N characters with progressively smaller chunks
+    // This handles cases where messages are truncated in the prompt
+    const searchLengths = [500, 300, 200, 100, 50];
+
+    for (const len of searchLengths) {
+        if (messageContent.length <= len) {
+            continue;
+        }
+
+        const searchContent = messageContent.slice(-len);
+        searchIndex = prompt.lastIndexOf(searchContent);
+
+        if (searchIndex !== -1) {
+            return { start: searchIndex, end: searchIndex + searchContent.length };
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Injects historical context into a text completion prompt string.
+ * Searches for message content in the prompt and appends context after matches.
+ *
+ * @param {string} prompt - The text completion prompt
+ * @returns {string} - The modified prompt with injected context
+ */
+function injectContextIntoTextPrompt(prompt) {
+    if (pendingContextMap.size === 0) {
+        return prompt;
+    }
+
+    const context = getContext();
+    const chat = context.chat;
+    let modifiedPrompt = prompt;
+    let injectedCount = 0;
+
+    // Sort by message index descending so we inject from end to start
+    // This prevents position shifts from affecting earlier injections
+    const sortedEntries = Array.from(pendingContextMap.entries()).sort((a, b) => b[0] - a[0]);
+
+    // Process each message that needs context injection
+    for (const [msgIdx, ctxContent] of sortedEntries) {
+        const message = chat[msgIdx];
+        if (!message || typeof message.mes !== 'string') {
+            continue;
+        }
+
+        // Find the message content in the prompt
+        const position = findMessageInPrompt(modifiedPrompt, message.mes);
+
+        if (!position) {
+            // Message not found in prompt (might be truncated or not included)
+            console.debug(`[RPG Companion] Could not find message ${msgIdx} in prompt for context injection`);
+            continue;
+        }
+
+        // Insert the context after the message content
+        modifiedPrompt = modifiedPrompt.slice(0, position.end) + ctxContent + modifiedPrompt.slice(position.end);
+        injectedCount++;
+    }
+
+    if (injectedCount > 0) {
+        console.log(`[RPG Companion] Injected historical context into ${injectedCount} positions in text prompt`);
+    }
+
+    return modifiedPrompt;
+}
+
+/**
+ * Injects historical context into a chat completion message array.
+ * Modifies the content of messages in the array directly.
+ *
+ * @param {Array} chatMessages - The chat completion message array
+ * @returns {Array} - The modified message array with injected context
+ */
+function injectContextIntoChatPrompt(chatMessages) {
+    if (pendingContextMap.size === 0 || !Array.isArray(chatMessages)) {
+        return chatMessages;
+    }
+
+    const context = getContext();
+    const chat = context.chat;
+    let injectedCount = 0;
+
+    // Process each message that needs context injection
+    for (const [msgIdx, ctxContent] of pendingContextMap) {
+        const originalMessage = chat[msgIdx];
+        if (!originalMessage || typeof originalMessage.mes !== 'string') {
+            continue;
+        }
+
+        const messageContent = originalMessage.mes;
+
+        // Find this message in the chat completion array by matching content
+        // Try full content first, then progressively smaller suffixes
+        let found = false;
+
+        for (const promptMsg of chatMessages) {
+            if (!promptMsg.content || typeof promptMsg.content !== 'string') {
+                continue;
+            }
+
+            // Try full content match
+            if (promptMsg.content.includes(messageContent)) {
+                promptMsg.content = promptMsg.content + ctxContent;
+                injectedCount++;
+                found = true;
+                break;
+            }
+
+            // Try suffix matches for truncated messages
+            const searchLengths = [500, 300, 200, 100, 50];
+            for (const len of searchLengths) {
+                if (messageContent.length <= len) {
+                    continue;
+                }
+
+                const searchContent = messageContent.slice(-len);
+                if (promptMsg.content.includes(searchContent)) {
+                    promptMsg.content = promptMsg.content + ctxContent;
+                    injectedCount++;
+                    found = true;
+                    break;
+                }
+            }
+
+            if (found) {
+                break;
+            }
+        }
+
+        if (!found) {
+            console.debug(`[RPG Companion] Could not find message ${msgIdx} in chat prompt for context injection`);
+        }
+    }
+
+    if (injectedCount > 0) {
+        console.log(`[RPG Companion] Injected historical context into ${injectedCount} messages in chat prompt`);
+    }
+
+    return chatMessages;
+}
+
+/**
+ * Injects historical context into finalMesSend message array (text completion).
+ * Iterates through chat and finalMesSend in order, matching by content to skip injected messages.
+ *
+ * @param {Array} finalMesSend - The array of message objects {message: string, extensionPrompts: []}
+ * @returns {number} - Number of injections made
+ */
+function injectContextIntoFinalMesSend(finalMesSend) {
+    if (pendingContextMap.size === 0 || !Array.isArray(finalMesSend) || finalMesSend.length === 0) {
+        return 0;
+    }
+
+    const context = getContext();
+    const chat = context.chat;
+    if (!chat || chat.length === 0) {
+        return 0;
+    }
+
+    let injectedCount = 0;
+
+    // Build a map from chat index to finalMesSend index by matching content in order
+    // This handles injected messages (author's note, OOC, etc.) that exist in finalMesSend but not in chat
+    const chatToMesSendMap = new Map();
+    let mesSendIdx = 0;
+
+    for (let chatIdx = 0; chatIdx < chat.length && mesSendIdx < finalMesSend.length; chatIdx++) {
+        const chatMsg = chat[chatIdx];
+        if (!chatMsg || chatMsg.is_system) {
+            continue;
+        }
+
+        const chatContent = chatMsg.mes || '';
+
+        // Look for this chat message in finalMesSend starting from current position
+        // Skip any finalMesSend entries that don't match (they're injected content)
+        while (mesSendIdx < finalMesSend.length) {
+            const mesSendObj = finalMesSend[mesSendIdx];
+            if (!mesSendObj || !mesSendObj.message) {
+                mesSendIdx++;
+                continue;
+            }
+
+            // Check if this finalMesSend message contains the chat content
+            // Use a substring match since instruct formatting adds prefixes/suffixes
+            // Match with sufficient content (first 50 chars or full message if shorter)
+            const matchContent = chatContent.length > 50
+                ? chatContent.substring(0, 50)
+                : chatContent;
+
+            if (matchContent && mesSendObj.message.includes(matchContent)) {
+                // Found a match - record the mapping
+                chatToMesSendMap.set(chatIdx, mesSendIdx);
+                mesSendIdx++;
+                break;
+            }
+
+            // This finalMesSend entry doesn't match - it's injected content, skip it
+            mesSendIdx++;
+        }
+    }
+
+    // Now inject context using the map
+    for (const [chatIdx, ctxContent] of pendingContextMap) {
+        const targetMesSendIdx = chatToMesSendMap.get(chatIdx);
+
+        if (targetMesSendIdx === undefined) {
+            console.debug(`[RPG Companion] Chat message ${chatIdx} not found in finalMesSend mapping`);
+            continue;
+        }
+
+        const mesSendObj = finalMesSend[targetMesSendIdx];
+        if (!mesSendObj || !mesSendObj.message) {
+            continue;
+        }
+
+        // Append context to this message
+        mesSendObj.message = mesSendObj.message + ctxContent;
+        injectedCount++;
+        console.debug(`[RPG Companion] Injected context for chat[${chatIdx}] into finalMesSend[${targetMesSendIdx}]`);
+    }
+
+    return injectedCount;
+}
+
+/**
+ * Event handler for GENERATE_BEFORE_COMBINE_PROMPTS (text completion).
+ * Injects historical context into the finalMesSend array before prompt combination.
+ * This is more reliable than post-combine string searching.
+ *
+ * @param {Object} eventData - Event data with finalMesSend and other properties
+ */
+function onGenerateBeforeCombinePrompts(eventData) {
+    if (!eventData || !Array.isArray(eventData.finalMesSend)) {
+        return;
+    }
+
+    // Skip for OpenAI (uses chat completion)
+    if (eventData.api === 'openai') {
+        return;
+    }
+
+    // Only inject if we have pending context
+    if (pendingContextMap.size === 0) {
+        return;
+    }
+
+    const injectedCount = injectContextIntoFinalMesSend(eventData.finalMesSend);
+    if (injectedCount > 0) {
+        console.log(`[RPG Companion] Injected historical context into ${injectedCount} messages in finalMesSend`);
+        historyInjectionDone = true; // Mark as done to prevent double injection
+    }
+}
+
+/**
+ * Event handler for GENERATE_AFTER_COMBINE_PROMPTS (text completion).
+ * This is now a backup/fallback - primary injection happens in BEFORE_COMBINE.
+ * Also fixes newline spacing after </context> tag.
+ *
+ * @param {Object} eventData - Event data with prompt property
+ */
+function onGenerateAfterCombinePrompts(eventData) {
+    if (!eventData || typeof eventData.prompt !== 'string') {
+        return;
+    }
+
+    if (eventData.dryRun) {
+        return;
+    }
+
+    let didInjectHistory = false;
+
+    // Inject historical context if available and not already done
+    if (!historyInjectionDone && pendingContextMap.size > 0) {
+        // Fallback injection for edge cases where BEFORE_COMBINE didn't work
+        console.log('[RPG Companion] Using fallback string-based injection (AFTER_COMBINE)');
+        eventData.prompt = injectContextIntoTextPrompt(eventData.prompt);
+        didInjectHistory = true;
+    }
+
+    // Always fix newlines around context tags (whether we just injected or not)
+    eventData.prompt = eventData.prompt.replace(/<context>/g, '\n<context>');
+    eventData.prompt = eventData.prompt.replace(/<\/context>/g, '</context>\n');
+}
+
+/**
+ * Event handler for CHAT_COMPLETION_PROMPT_READY.
+ * Injects historical context into the chat message array.
+ * Also fixes newline spacing around <context> tags.
+ *
+ * @param {Object} eventData - Event data with chat property
+ */
+function onChatCompletionPromptReady(eventData) {
+    if (!eventData || !Array.isArray(eventData.chat)) {
+        return;
+    }
+
+    if (eventData.dryRun) {
+        return;
+    }
+
+    // Inject historical context if we have pending context
+    if (pendingContextMap.size > 0) {
+        eventData.chat = injectContextIntoChatPrompt(eventData.chat);
+        // DON'T clear pendingContextMap here - let it persist for other generations
+        // (e.g., prewarm extensions). It will be cleared on GENERATION_ENDED.
+    }
+
+    // Fix newlines around context tags for all messages
+    for (const message of eventData.chat) {
+        if (message.content && typeof message.content === 'string') {
+            message.content = message.content.replace(/<context>/g, '\n<context>');
+            message.content = message.content.replace(/<\/context>/g, '</context>\n');
+        }
+    }
+}
 
 /**
  * Event handler for generation start.
@@ -28,8 +547,15 @@ import {
  *
  * @param {string} type - Event type
  * @param {Object} data - Event data
+ * @param {boolean} dryRun - If true, this is a dry run (page reload, prompt preview, etc.) - skip all logic
  */
-export function onGenerationStarted(type, data) {
+export async function onGenerationStarted(type, data, dryRun) {
+    // Skip dry runs (page reload, prompt manager preview, etc.)
+    if (dryRun) {
+        // console.log('[RPG Companion] Skipping onGenerationStarted: dry run detected');
+        return;
+    }
+
     // console.log('[RPG Companion] onGenerationStarted called');
     // console.log('[RPG Companion] enabled:', extensionSettings.enabled);
     // console.log('[RPG Companion] generationMode:', extensionSettings.generationMode);
@@ -37,12 +563,19 @@ export function onGenerationStarted(type, data) {
     // console.log('[RPG Companion] Committed Prompt:', committedTrackerData);
 
     // Skip tracker injection for image generation requests
-    if (data?.quietImage) {
-        // console.log('[RPG Companion] Detected image generation (quietImage=true), skipping tracker injection');
+    if (data?.quietImage || data?.quiet_image || data?.isImageGeneration) {
+        // console.log('[RPG Companion] Detected image generation, skipping tracker injection');
         return;
     }
 
     if (!extensionSettings.enabled) {
+        // Extension is disabled - clear any existing prompts to ensure nothing is injected
+        setExtensionPrompt('rpg-companion-inject', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-example', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-dialogue-coloring', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-context', '', extension_prompt_types.IN_CHAT, 1, false);
         return;
     }
 
@@ -66,35 +599,94 @@ export function onGenerationStarted(type, data) {
         setExtensionPrompt('rpg-companion-inject', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-example', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-context', '', extension_prompt_types.IN_CHAT, 1, false);
     }
-    const lastMessage = chat && chat.length > 0 ? chat[chat.length - 1] : null;
 
-    // For SEPARATE mode only: Check if we need to commit extension data
+    // Ensure checkpoint is applied before generation
+    await restoreCheckpointOnLoad();
+
+    const currentChatLength = chat ? chat.length : 0;
+
+    // For TOGETHER mode: Commit when user sends message (before first generation)
+    if (extensionSettings.generationMode === 'together') {
+        // By the time onGenerationStarted fires, ST has already added the placeholder AI message
+        // So we check the second-to-last message to see if user just sent a message
+        const secondToLastMessage = chat && chat.length > 1 ? chat[chat.length - 2] : null;
+        const isUserMessage = secondToLastMessage && secondToLastMessage.is_user;
+
+        // Commit if:
+        // 1. Second-to-last message is from USER (user just sent message)
+        // 2. Not a swipe (lastActionWasSwipe = false)
+        // 3. Haven't already committed for this chat length (prevent streaming duplicates)
+        const shouldCommit = isUserMessage && !lastActionWasSwipe && currentChatLength !== lastCommittedChatLength;
+
+        if (shouldCommit) {
+            // console.log('[RPG Companion] 📝 TOGETHER MODE COMMIT: User sent message - committing data from BEFORE user message');
+            // console.log('[RPG Companion]   Chat length:', currentChatLength, 'Last committed:', lastCommittedChatLength);
+            // console.log('[RPG Companion]   BEFORE: committedTrackerData =', {
+            //     userStats: committedTrackerData.userStats ? `${committedTrackerData.userStats.substring(0, 50)}...` : 'null',
+            //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+            //     characterThoughts: committedTrackerData.characterThoughts ? `${committedTrackerData.characterThoughts.substring(0, 100)}...` : 'null'
+            // // });
+            // console.log('[RPG Companion]   BEFORE: lastGeneratedData =', {
+            //     userStats: lastGeneratedData.userStats ? `${lastGeneratedData.userStats.substring(0, 50)}...` : 'null',
+            //     infoBox: lastGeneratedData.infoBox ? 'exists' : 'null',
+            //     characterThoughts: lastGeneratedData.characterThoughts ? `${lastGeneratedData.characterThoughts.substring(0, 100)}...` : 'null'
+            // });
+
+            // Commit displayed data (from before user sent message)
+            committedTrackerData.userStats = lastGeneratedData.userStats;
+            committedTrackerData.infoBox = lastGeneratedData.infoBox;
+            committedTrackerData.characterThoughts = lastGeneratedData.characterThoughts;
+
+            // Track chat length to prevent duplicate commits
+            lastCommittedChatLength = currentChatLength;
+
+            // console.log('[RPG Companion]   AFTER: committedTrackerData =', {
+            //     userStats: committedTrackerData.userStats ? `${committedTrackerData.userStats.substring(0, 50)}...` : 'null',
+            //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+            //     characterThoughts: committedTrackerData.characterThoughts ? `${committedTrackerData.characterThoughts.substring(0, 100)}...` : 'null'
+            // });
+        } else if (lastActionWasSwipe) {
+            // console.log('[RPG Companion] ⏭️ Skipping commit: swipe (using previous committed data)');
+        } else if (!isUserMessage) {
+            // console.log('[RPG Companion] ⏭️ Skipping commit: second-to-last message is not user message (likely swipe or continuation)');
+        }
+
+        // console.log('[RPG Companion] 📦 TOGETHER MODE: Injecting committed tracker data into prompt');
+        // console.log('[RPG Companion]   committedTrackerData =', {
+        //     userStats: committedTrackerData.userStats ? `${committedTrackerData.userStats.substring(0, 50)}...` : 'null',
+        //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+        //     characterThoughts: committedTrackerData.characterThoughts ? `${committedTrackerData.characterThoughts.substring(0, 100)}...` : 'null'
+        // });
+    }
+
+    // For SEPARATE and EXTERNAL modes: Check if we need to commit extension data
     // BUT: Only do this for the MAIN generation, not the tracker update generation
     // If isGenerating is true, this is the tracker update generation (second call), so skip flag logic
     // console.log('[RPG Companion DEBUG] Before generating:', lastGeneratedData.characterThoughts, ' , committed - ', committedTrackerData.characterThoughts);
-    if (extensionSettings.generationMode === 'separate' && !isGenerating) {
+    if ((extensionSettings.generationMode === 'separate' || extensionSettings.generationMode === 'external') && !isGenerating) {
         if (!lastActionWasSwipe) {
             // User sent a new message - commit lastGeneratedData before generation
             // console.log('[RPG Companion] 📝 COMMIT: New message - committing lastGeneratedData');
             // console.log('[RPG Companion]   BEFORE commit - committedTrackerData:', {
-            //     userStats: committedTrackerData.userStats ? 'exists' : 'null',
-            //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
-            //     characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
-            // });
+            //      userStats: committedTrackerData.userStats ? 'exists' : 'null',
+            //      infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+            //      characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
+            // // });
             // console.log('[RPG Companion]   BEFORE commit - lastGeneratedData:', {
-            //     userStats: lastGeneratedData.userStats ? 'exists' : 'null',
-            //     infoBox: lastGeneratedData.infoBox ? 'exists' : 'null',
-            //     characterThoughts: lastGeneratedData.characterThoughts ? 'exists' : 'null'
+            //      userStats: lastGeneratedData.userStats ? 'exists' : 'null',
+            //      infoBox: lastGeneratedData.infoBox ? 'exists' : 'null',
+            //      characterThoughts: lastGeneratedData.characterThoughts ? 'exists' : 'null'
             // });
             committedTrackerData.userStats = lastGeneratedData.userStats;
             committedTrackerData.infoBox = lastGeneratedData.infoBox;
             committedTrackerData.characterThoughts = lastGeneratedData.characterThoughts;
             // console.log('[RPG Companion]   AFTER commit - committedTrackerData:', {
-            //     userStats: committedTrackerData.userStats ? 'exists' : 'null',
-            //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
-            //     characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
+            //      userStats: committedTrackerData.userStats ? 'exists' : 'null',
+            //      infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+            //      characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
             // });
 
             // Reset flag after committing (ready for next cycle)
@@ -102,58 +694,14 @@ export function onGenerationStarted(type, data) {
         } else {
             // console.log('[RPG Companion] 🔄 SWIPE: Using existing committedTrackerData (no commit)');
             // console.log('[RPG Companion]   committedTrackerData:', {
-            //     userStats: committedTrackerData.userStats ? 'exists' : 'null',
-            //     infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
-            //     characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
+            //      userStats: committedTrackerData.userStats ? 'exists' : 'null',
+            //      infoBox: committedTrackerData.infoBox ? 'exists' : 'null',
+            //      characterThoughts: committedTrackerData.characterThoughts ? 'exists' : 'null'
             // });
             // Reset flag after using it (swipe generation complete, ready for next action)
         }
     }
 
-    // For TOGETHER mode: Check if we need to commit extension data
-    // Only commit when user sends a new message (not on swipes)
-    if (extensionSettings.generationMode === 'together') {
-        if (!lastActionWasSwipe) {
-            // User sent a new message - commit data from the last assistant message they replied to
-            // This ensures swipes use consistent data from before the first swipe
-            console.log('[RPG Companion] 📝 TOGETHER MODE COMMIT: New message - committing from last assistant message');
-
-            // Find the last assistant message (before the user's new message)
-            const chat = getContext().chat;
-            let foundAssistantMessage = false;
-
-            for (let i = chat.length - 1; i >= 0; i--) {
-                const message = chat[i];
-                if (!message.is_user) {
-                    // Found last assistant message - commit its stored tracker data
-                    if (message.extra && message.extra.rpg_companion_swipes) {
-                        const swipeId = message.swipe_id || 0;
-                        const swipeData = message.extra.rpg_companion_swipes[swipeId];
-
-                        if (swipeData) {
-                            committedTrackerData.userStats = swipeData.userStats || null;
-                            committedTrackerData.infoBox = swipeData.infoBox || null;
-                            committedTrackerData.characterThoughts = swipeData.characterThoughts || null;
-                            foundAssistantMessage = true;
-                            console.log('[RPG Companion] ✓ Committed tracker data from message swipe', swipeId);
-                        }
-                    }
-                    break;
-                }
-            }
-
-            // Fallback: if no stored data found, use lastGeneratedData (for first message)
-            if (!foundAssistantMessage) {
-                committedTrackerData.userStats = lastGeneratedData.userStats;
-                committedTrackerData.infoBox = lastGeneratedData.infoBox;
-                committedTrackerData.characterThoughts = lastGeneratedData.characterThoughts;
-                console.log('[RPG Companion] ⚠ No stored message data found, using lastGeneratedData as fallback');
-            }
-        } else {
-            console.log('[RPG Companion] 🔄 TOGETHER MODE SWIPE: Using existing committedTrackerData (no commit)');
-        }
-    }
-
     // Use the committed tracker data as source for generation
     // console.log('[RPG Companion] Using committedTrackerData for generation');
     // console.log('[RPG Companion] committedTrackerData.userStats:', committedTrackerData.userStats);
@@ -167,7 +715,10 @@ export function onGenerationStarted(type, data) {
 
     if (extensionSettings.generationMode === 'together') {
         // console.log('[RPG Companion] In together mode, generating prompts...');
-        const example = generateTrackerExample();
+        const exampleRaw = generateTrackerExample();
+        // Wrap example in ```json``` code blocks for consistency with format instructions
+        // Add only 1 newline after the closing ``` (ST adds its own newline when injecting)
+        const example = exampleRaw ? `\`\`\`json\n${exampleRaw}\n\`\`\`\n` : null;
         // Don't include HTML prompt in instructions - inject it separately to avoid duplication on swipes
         const instructions = generateTrackerInstructions(false, true);
 
@@ -217,7 +768,7 @@ export function onGenerationStarted(type, data) {
         if (extensionSettings.enableHtmlPrompt && !shouldSuppress) {
             // Use custom HTML prompt if set, otherwise use default
             const htmlPromptText = extensionSettings.customHtmlPrompt || DEFAULT_HTML_PROMPT;
-            const htmlPrompt = `\n${htmlPromptText}`;
+            const htmlPrompt = `\n- ${htmlPromptText}\n`;
 
             setExtensionPrompt('rpg-companion-html', htmlPrompt, extension_prompt_types.IN_CHAT, 0, false);
             // console.log('[RPG Companion] Injected HTML prompt at depth 0 for together mode');
@@ -225,24 +776,92 @@ export function onGenerationStarted(type, data) {
             // Clear HTML prompt if disabled
             setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
         }
-    } else if (extensionSettings.generationMode === 'separate') {
-        // In SEPARATE mode, inject the contextual summary for main roleplay generation
+
+        // Inject Dialogue Coloring prompt separately at depth 0 if enabled
+        if (extensionSettings.enableDialogueColoring && !shouldSuppress) {
+            // Use custom Dialogue Coloring prompt if set, otherwise use default
+            const dialogueColoringPromptText = extensionSettings.customDialogueColoringPrompt || DEFAULT_DIALOGUE_COLORING_PROMPT;
+            const dialogueColoringPrompt = `\n- ${dialogueColoringPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-dialogue-coloring', dialogueColoringPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Dialogue Coloring prompt at depth 0 for together mode');
+        } else {
+            // Clear Dialogue Coloring prompt if disabled
+            setExtensionPrompt('rpg-companion-dialogue-coloring', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Deception System prompt separately at depth 0 if enabled
+        if (extensionSettings.enableDeceptionSystem && !shouldSuppress) {
+            // Use custom Deception prompt if set, otherwise use default
+            const deceptionPromptText = extensionSettings.customDeceptionPrompt || DEFAULT_DECEPTION_PROMPT;
+            const deceptionPrompt = `\n- ${deceptionPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-deception', deceptionPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Deception System prompt at depth 0 for together mode');
+        } else {
+            // Clear Deception System prompt if disabled
+            setExtensionPrompt('rpg-companion-deception', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Omniscience Filter prompt separately at depth 0 if enabled
+        if (extensionSettings.enableOmniscienceFilter && !shouldSuppress) {
+            // Use custom Omniscience Filter prompt if set, otherwise use default
+            const omnisciencePromptText = extensionSettings.customOmnisciencePrompt || DEFAULT_OMNISCIENCE_FILTER_PROMPT;
+            const omnisciencePrompt = `\n${omnisciencePromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-omniscience', omnisciencePrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Omniscience Filter prompt at depth 0 for together mode');
+        } else {
+            // Clear Omniscience Filter prompt if disabled
+            setExtensionPrompt('rpg-companion-omniscience', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Spotify prompt separately at depth 0 if enabled
+        if (extensionSettings.enableSpotifyMusic && !shouldSuppress) {
+            // Use custom Spotify prompt if set, otherwise use default
+            const spotifyPromptText = extensionSettings.customSpotifyPrompt || DEFAULT_SPOTIFY_PROMPT;
+            const spotifyPrompt = `\n- ${spotifyPromptText} ${SPOTIFY_FORMAT_INSTRUCTION}\n`;
+
+            setExtensionPrompt('rpg-companion-spotify', spotifyPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Spotify prompt at depth 0 for together mode');
+        } else {
+            // Clear Spotify prompt if disabled
+            setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject CYOA prompt separately at depth 0 if enabled (injected last to appear last in prompt)
+        if (extensionSettings.enableCYOA && !shouldSuppress) {
+            // Use custom CYOA prompt if set, otherwise use default
+            const cyoaPromptText = extensionSettings.customCYOAPrompt || DEFAULT_CYOA_PROMPT;
+            const cyoaPrompt = `\n- ${cyoaPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-zzz-cyoa', cyoaPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected CYOA prompt at depth 0 for together mode');
+        } else {
+            // Clear CYOA prompt if disabled
+            setExtensionPrompt('rpg-companion-zzz-cyoa', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+    } else if (extensionSettings.generationMode === 'separate' || extensionSettings.generationMode === 'external') {
+        // In SEPARATE and EXTERNAL modes, inject the contextual summary for main roleplay generation
         const contextSummary = generateContextualSummary();
 
         if (contextSummary) {
-            const wrappedContext = `\nHere is context information about the current scene, and what follows is the last message in the chat history:
+            // Use custom context instructions prompt if set, otherwise use default
+            const contextInstructionsText = extensionSettings.customContextInstructionsPrompt || DEFAULT_CONTEXT_INSTRUCTIONS_PROMPT;
+
+            const wrappedContext = `
 <context>
 ${contextSummary}
-
-Ensure these details naturally reflect and influence the narrative. Character behavior, dialogue, and story events should acknowledge these conditions when relevant, such as fatigue affecting performance, low hygiene influencing social interactions, environmental factors shaping the scene, or a character's emotional state coloring their responses.
-</context>\n\n`;
+${contextInstructionsText}
+</context>`;
 
             // Inject context at depth 1 (before last user message) as SYSTEM
             // Skip when a guided generation injection is present to avoid conflicting instructions
             if (!shouldSuppress) {
                 setExtensionPrompt('rpg-companion-context', wrappedContext, extension_prompt_types.IN_CHAT, 1, false);
             }
-            // console.log('[RPG Companion] Injected contextual summary for separate mode:', contextSummary);
+            // console.log('[RPG Companion] Injected contextual summary for separate/external mode:', contextSummary);
         } else {
             // Clear if no data yet
             setExtensionPrompt('rpg-companion-context', '', extension_prompt_types.IN_CHAT, 1, false);
@@ -252,15 +871,80 @@ Ensure these details naturally reflect and influence the narrative. Character be
         if (extensionSettings.enableHtmlPrompt && !shouldSuppress) {
             // Use custom HTML prompt if set, otherwise use default
             const htmlPromptText = extensionSettings.customHtmlPrompt || DEFAULT_HTML_PROMPT;
-            const htmlPrompt = `\n${htmlPromptText}`;
+            const htmlPrompt = `\n- ${htmlPromptText}\n`;
 
             setExtensionPrompt('rpg-companion-html', htmlPrompt, extension_prompt_types.IN_CHAT, 0, false);
-            // console.log('[RPG Companion] Injected HTML prompt at depth 0 for separate mode');
+            // console.log('[RPG Companion] Injected HTML prompt at depth 0 for separate/external mode');
         } else {
             // Clear HTML prompt if disabled
             setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
         }
 
+        // Inject Dialogue Coloring prompt separately at depth 0 if enabled
+        if (extensionSettings.enableDialogueColoring && !shouldSuppress) {
+            // Use custom Dialogue Coloring prompt if set, otherwise use default
+            const dialogueColoringPromptText = extensionSettings.customDialogueColoringPrompt || DEFAULT_DIALOGUE_COLORING_PROMPT;
+            const dialogueColoringPrompt = `\n- ${dialogueColoringPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-dialogue-coloring', dialogueColoringPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Dialogue Coloring prompt at depth 0 for separate/external mode');
+        } else {
+            // Clear Dialogue Coloring prompt if disabled
+            setExtensionPrompt('rpg-companion-dialogue-coloring', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Deception System prompt separately at depth 0 if enabled
+        if (extensionSettings.enableDeceptionSystem && !shouldSuppress) {
+            // Use custom Deception prompt if set, otherwise use default
+            const deceptionPromptText = extensionSettings.customDeceptionPrompt || DEFAULT_DECEPTION_PROMPT;
+            const deceptionPrompt = `\n- ${deceptionPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-deception', deceptionPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Deception System prompt at depth 0 for separate/external mode');
+        } else {
+            // Clear Deception System prompt if disabled
+            setExtensionPrompt('rpg-companion-deception', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Omniscience Filter prompt separately at depth 0 if enabled
+        if (extensionSettings.enableOmniscienceFilter && !shouldSuppress) {
+            // Use custom Omniscience Filter prompt if set, otherwise use default
+            const omnisciencePromptText = extensionSettings.customOmnisciencePrompt || DEFAULT_OMNISCIENCE_FILTER_PROMPT;
+            const omnisciencePrompt = `\n${omnisciencePromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-omniscience', omnisciencePrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Omniscience Filter prompt at depth 0 for separate/external mode');
+        } else {
+            // Clear Omniscience Filter prompt if disabled
+            setExtensionPrompt('rpg-companion-omniscience', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject Spotify prompt separately at depth 0 if enabled
+        if (extensionSettings.enableSpotifyMusic && !shouldSuppress) {
+            // Use custom Spotify prompt if set, otherwise use default
+            const spotifyPromptText = extensionSettings.customSpotifyPrompt || DEFAULT_SPOTIFY_PROMPT;
+            const spotifyPrompt = `\n- ${spotifyPromptText} ${SPOTIFY_FORMAT_INSTRUCTION}\n`;
+
+            setExtensionPrompt('rpg-companion-spotify', spotifyPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected Spotify prompt at depth 0 for separate/external mode');
+        } else {
+            // Clear Spotify prompt if disabled
+            setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
+        // Inject CYOA prompt separately at depth 0 if enabled (injected last to appear last in prompt)
+        if (extensionSettings.enableCYOA && !shouldSuppress) {
+            // Use custom CYOA prompt if set, otherwise use default
+            const cyoaPromptText = extensionSettings.customCYOAPrompt || DEFAULT_CYOA_PROMPT;
+            const cyoaPrompt = `\n- ${cyoaPromptText}\n`;
+
+            setExtensionPrompt('rpg-companion-zzz-cyoa', cyoaPrompt, extension_prompt_types.IN_CHAT, 0, false);
+            // console.log('[RPG Companion] Injected CYOA prompt at depth 0 for separate/external mode');
+        } else {
+            // Clear CYOA prompt if disabled
+            setExtensionPrompt('rpg-companion-zzz-cyoa', '', extension_prompt_types.IN_CHAT, 0, false);
+        }
+
         // Clear together mode injections
         setExtensionPrompt('rpg-companion-inject', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-example', '', extension_prompt_types.IN_CHAT, 0, false);
@@ -269,5 +953,41 @@ Ensure these details naturally reflect and influence the narrative. Character be
         setExtensionPrompt('rpg-companion-inject', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-example', '', extension_prompt_types.IN_CHAT, 0, false);
         setExtensionPrompt('rpg-companion-context', '', extension_prompt_types.IN_CHAT, 1, false);
+        setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-dialogue-coloring', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-deception', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-omniscience', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-zzz-cyoa', '', extension_prompt_types.IN_CHAT, 0, false);
+        setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
     }
+
+    // Set suppression state for the historical context injection
+    currentSuppressionState = shouldSuppress;
+
+    // Prepare historical context for injection into prompts
+    // This builds the context map but does NOT modify original chat messages
+    // The persistent event listeners will inject it into all prompts until cleared
+    prepareHistoricalContextInjection();
 }
+
+/**
+ * Initialize the history injection event listeners.
+ * These are persistent listeners that inject context into ALL generations
+ * while pendingContextMap has data. Should be called once at extension init.
+ */
+export function initHistoryInjectionListeners() {
+    // Register persistent listeners for prompt injection
+    // These check pendingContextMap and only inject if there's data
+
+    // Primary: BEFORE_COMBINE for text completion (more reliable - modifies message objects)
+    eventSource.on(event_types.GENERATE_BEFORE_COMBINE_PROMPTS, onGenerateBeforeCombinePrompts);
+
+    // Fallback: AFTER_COMBINE for text completion (string-based injection)
+    eventSource.on(event_types.GENERATE_AFTER_COMBINE_PROMPTS, onGenerateAfterCombinePrompts);
+
+    // Chat completion (OpenAI, etc.)
+    eventSource.on(event_types.CHAT_COMPLETION_PROMPT_READY, onChatCompletionPromptReady);
+
+    console.log('[RPG Companion] History injection listeners initialized');
+}
+

src/systems/generation/inventoryParser.js

@@ -28,6 +28,7 @@ export function extractInventoryData(statsText) {
     const result = {
         version: 2,
         onPerson: "None",
+        clothing: "None",
         stored: {},
         assets: "None"
     };
@@ -48,6 +49,14 @@ export function extractInventoryData(statsText) {
             continue;
         }
 
+        // Parse "Clothing: ..." line
+        const clothingMatch = trimmed.match(/^Clothing:\s*(.+)$/i);
+        if (clothingMatch) {
+            result.clothing = clothingMatch[1].trim() || "None";
+            foundAnyInventoryData = true;
+            continue;
+        }
+
         // Parse "Stored - [Location]: ..." lines
         const storedMatch = trimmed.match(/^Stored\s*-\s*([^:]+):\s*(.+)$/i);
         if (storedMatch) {
@@ -122,6 +131,7 @@ export function extractInventory(statsText) {
         return {
             version: 2,
             onPerson: v1Data,
+            clothing: "None",
             stored: {},
             assets: "None"
         };

src/systems/generation/jsonPromptHelpers.js

@@ -0,0 +1,249 @@
+/**
+ * JSON Prompt Builder Helpers
+ * Helper functions for building JSON format tracker prompts
+ */
+
+import { extensionSettings, committedTrackerData } from '../../core/state.js';
+import { getContext } from '../../../../../../extensions.js';
+import { getWeatherKeywordsAsPromptString } from '../ui/weatherEffects.js';
+import { i18n } from '../../core/i18n.js';
+
+/**
+ * Converts a field name to snake_case for use as JSON key
+ * Example: "Test Tracker" -> "test_tracker"
+ * @param {string} name - Field name to convert
+ * @returns {string} snake_case version
+ */
+function toSnakeCase(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
+
+/**
+ * Extracts the base name (before parentheses) and converts to snake_case for use as JSON key.
+ * Parenthetical content is treated as a description/hint, not part of the key.
+ * Example: "Conditions (up to 5 traits)" -> "conditions"
+ * Example: "Status Effects" -> "status_effects"
+ * @param {string} name - Field name, possibly with parenthetical description
+ * @returns {string} snake_case key from the base name only
+ */
+function toFieldKey(name) {
+    const baseName = name.replace(/\s*\(.*\)\s*$/, '').trim();
+    return toSnakeCase(baseName);
+}
+
+/**
+ * Builds User Stats JSON format instruction
+ * @returns {string} JSON format instruction for user stats
+ */
+export function buildUserStatsJSONInstruction() {
+    const userName = getContext().name1;
+    const trackerConfig = extensionSettings.trackerConfig;
+    const userStatsConfig = trackerConfig?.userStats;
+    const enabledStats = userStatsConfig?.customStats?.filter(s => s && s.enabled && s.name) || [];
+    const displayMode = userStatsConfig?.statsDisplayMode || 'percentage';
+
+    let instruction = '{\n';
+    instruction += '  "stats": [\n';
+
+    // Add stats dynamically
+    for (let i = 0; i < enabledStats.length; i++) {
+        const stat = enabledStats[i];
+        const comma = i < enabledStats.length - 1 ? ',' : '';
+        if (displayMode === 'number') {
+            const maxValue = stat.maxValue || 100;
+            instruction += `    {"id": "${stat.id}", "name": "${stat.name}", "value": X}${comma}  // 0 to ${maxValue}\n`;
+        } else {
+            instruction += `    {"id": "${stat.id}", "name": "${stat.name}", "value": X}${comma}  // 0 to 100 (percentage)\n`;
+        }
+    }
+
+    instruction += '  ],\n';
+
+    // Status section
+    if (userStatsConfig?.statusSection?.enabled) {
+        instruction += '  "status": {\n';
+        if (userStatsConfig.statusSection.showMoodEmoji) {
+            instruction += '    "mood": "Mood Emoji"';
+        }
+        // Add all custom status fields
+        const customFields = userStatsConfig.statusSection.customFields || [];
+        if (customFields.length > 0) {
+            for (let i = 0; i < customFields.length; i++) {
+                const fieldName = customFields[i].toLowerCase();
+                const fieldKey = toFieldKey(fieldName);
+                const comma = (i === customFields.length - 1 && !userStatsConfig.statusSection.showMoodEmoji) ? '' : (userStatsConfig.statusSection.showMoodEmoji || i < customFields.length - 1 ? ',\n' : '\n');
+                if (i === 0 && userStatsConfig.statusSection.showMoodEmoji) {
+                    instruction += ',\n';
+                }
+                instruction += `    "${fieldKey}": "[${fieldName}]"${comma}`;
+            }
+        }
+        if (!userStatsConfig.statusSection.showMoodEmoji && customFields.length > 0) {
+            instruction += '\n';
+        }
+        instruction += '  },\n';
+    }
+
+    // Skills section
+    if (userStatsConfig?.skillsSection?.enabled) {
+        instruction += '  "skills": [\n';
+        instruction += '    {"name": "Skill1"},\n';
+        instruction += '    {"name": "Skill2"}\n';
+        instruction += '  ],\n';
+    }
+
+    // Inventory section
+    if (extensionSettings.showInventory) {
+        instruction += '  "inventory": {\n';
+        instruction += '    "onPerson": [\n';
+        instruction += '      {"name": "Item1", "quantity": X},\n';
+        instruction += '      {"name": "Item2", "quantity": X}\n';
+        instruction += '    ],\n';
+        instruction += '    "clothing": [\n';
+        instruction += '      {"name": "Clothing1"}\n';
+        instruction += '    ],\n';
+        instruction += '    "stored": {\n';
+        instruction += '      "Location1": [\n';
+        instruction += '        {"name": "Item", "quantity": X}\n';
+        instruction += '      ]\n';
+        instruction += '    },\n';
+        instruction += '    "assets": [\n';
+        instruction += '      {"name": "Asset1", "location": "Location"}\n';
+        instruction += '    ]\n';
+        instruction += '  },\n';
+    }
+
+    // Quests section
+    instruction += '  "quests": {\n';
+    instruction += '    "main": {"title": "Quest title"},\n';
+    instruction += '    "optional": [\n';
+    instruction += '      {"title": "Quest1"},\n';
+    instruction += '      {"title": "Quest2"}\n';
+    instruction += '    ]\n';
+    instruction += '  }\n';
+    instruction += '}';
+
+    return instruction;
+}
+
+/**
+ * Builds Info Box JSON format instruction
+ * @returns {string} JSON format instruction for info box
+ */
+export function buildInfoBoxJSONInstruction() {
+    const infoBoxConfig = extensionSettings.trackerConfig?.infoBox;
+    const widgets = infoBoxConfig?.widgets || {};
+
+    let instruction = '{\n';
+    let hasFields = false;
+
+    if (widgets.date?.enabled) {
+        const dateFormat = widgets.date.format || 'Weekday, Month, Year';
+        instruction += `  "date": {"value": "${dateFormat}"}`;
+        hasFields = true;
+    }
+
+    if (widgets.weather?.enabled) {
+        // Get valid weather keywords for the current language to guide LLM generation
+        const currentLang = i18n.currentLanguage || 'en';
+        const weatherHint = getWeatherKeywordsAsPromptString(currentLang);
+        instruction += (hasFields ? ',\n' : '') + `  "weather": {"emoji": "Weather Emoji", "forecast": "Forecast"}  // ${weatherHint}`;
+        hasFields = true;
+    }
+
+    if (widgets.temperature?.enabled) {
+        const unit = widgets.temperature.unit === 'F' ? 'F' : 'C';
+        instruction += (hasFields ? ',\n' : '') + `  "temperature": {"value": X, "unit": "${unit}"}`;
+        hasFields = true;
+    }
+
+    if (widgets.time?.enabled) {
+        instruction += (hasFields ? ',\n' : '') + '  "time": {"start": "TimeStart", "end": "TimeEnd"}';
+        hasFields = true;
+    }
+
+    if (widgets.location?.enabled) {
+        instruction += (hasFields ? ',\n' : '') + '  "location": {"value": "Location"}';
+        hasFields = true;
+    }
+
+    if (widgets.recentEvents?.enabled) {
+        instruction += (hasFields ? ',\n' : '') + '  "recentEvents": ["Event1", "Event2", "Event3"]';
+        hasFields = true;
+    }
+
+    instruction += '\n}';
+    return instruction;
+}
+
+/**
+ * Builds Present Characters JSON format instruction
+ * @returns {string} JSON format instruction for present characters
+ */
+export function buildCharactersJSONInstruction() {
+    const userName = getContext().name1;
+    const presentCharsConfig = extensionSettings.trackerConfig?.presentCharacters;
+    const enabledFields = presentCharsConfig?.customFields?.filter(f => f && f.enabled && f.name) || [];
+    const relationshipsEnabled = presentCharsConfig?.relationships?.enabled !== false;
+    const thoughtsConfig = presentCharsConfig?.thoughts;
+    const characterStats = presentCharsConfig?.characterStats;
+    const enabledCharStats = characterStats?.enabled && characterStats?.customStats?.filter(s => s && s.enabled && s.name) || [];
+
+    let instruction = '[\n';
+    instruction += '  {\n';
+    instruction += '    "name": "CharacterName",\n';
+    instruction += '    "emoji": "Character Emoji"';
+
+    // Details fields
+    if (enabledFields.length > 0) {
+        instruction += ',\n    "details": {\n';
+        for (let i = 0; i < enabledFields.length; i++) {
+            const field = enabledFields[i];
+            const fieldKey = toSnakeCase(field.name);
+            const comma = i < enabledFields.length - 1 ? ',' : '';
+            instruction += `      "${fieldKey}": "${field.description}"${comma}\n`;
+        }
+        instruction += '    }';
+    }
+
+    // Relationship
+    if (relationshipsEnabled) {
+        const relationshipFields = presentCharsConfig?.relationshipFields || [];
+        const options = relationshipFields.join('/');
+        instruction += ',\n    "relationship": {"status": "(choose one: ' + options + ')"}';
+    }
+
+    // Stats
+    if (enabledCharStats.length > 0) {
+        instruction += ',\n    "stats": [\n';
+        for (let i = 0; i < enabledCharStats.length; i++) {
+            const stat = enabledCharStats[i];
+            const comma = i < enabledCharStats.length - 1 ? ',' : '';
+            instruction += `      {"name": "${stat.name}", "value": X}${comma}\n`;
+        }
+        instruction += '    ]';
+    }
+
+    // Thoughts
+    if (thoughtsConfig?.enabled) {
+        const thoughtsDescription = thoughtsConfig.description || 'Internal monologue';
+        instruction += `,\n    "thoughts": {"content": "${thoughtsDescription}"}`;
+    }
+
+    instruction += '\n  }\n';
+    instruction += ']';
+
+    return instruction;
+}
+
+/**
+ * Adds lock information to instruction text
+ * @param {string} baseInstruction - Base instruction text
+ * @returns {string} Instruction with lock information added
+ */
+export function addLockInstruction(baseInstruction) {
+    return baseInstruction + '\n\nIMPORTANT: If an item, stat, quest, or field has "locked": true in its object, you MUST NOT change its value. Keep it exactly as it appears in the previous trackers. Only unlocked items can be modified. The "locked" field should ONLY be included if the item is actually locked - omit it for unlocked items.';
+}

src/systems/generation/lockManager.js

@@ -0,0 +1,466 @@
+/**
+ * Lock Manager
+ * Handles applying and removing locks for tracker items
+ * Locks prevent AI from modifying specific values
+ */
+
+import { extensionSettings } from '../../core/state.js';
+import { repairJSON } from '../../utils/jsonRepair.js';
+
+/**
+ * Apply locks to tracker data before sending to AI.
+ * Adds "locked": true to locked items in JSON format.
+ *
+ * @param {string} trackerData - JSON string of tracker data
+ * @param {string} trackerType - Type of tracker ('userStats', 'infoBox', 'characters')
+ * @returns {string} Tracker data with locks applied
+ */
+export function applyLocks(trackerData, trackerType) {
+    if (!trackerData) return trackerData;
+
+    // Try to parse as JSON
+    const parsed = repairJSON(trackerData);
+    if (!parsed) {
+        // Not JSON format, return as-is (text format doesn't support locks)
+        return trackerData;
+    }
+
+    // Get locked items for this tracker type
+    const lockedItems = extensionSettings.lockedItems?.[trackerType] || {};
+
+    // Apply locks based on tracker type
+    switch (trackerType) {
+        case 'userStats':
+            return applyUserStatsLocks(parsed, lockedItems);
+        case 'infoBox':
+            return applyInfoBoxLocks(parsed, lockedItems);
+        case 'characters':
+            return applyCharactersLocks(parsed, lockedItems);
+        default:
+            return trackerData;
+    }
+}
+
+/**
+ * Apply locks to User Stats tracker
+ * @param {Object} data - Parsed user stats data
+ * @param {Object} lockedItems - Locked items configuration
+ * @returns {string} JSON string with locks applied
+ */
+function applyUserStatsLocks(data, lockedItems) {
+    // Lock individual stats within stats object
+    if (data.stats && lockedItems.stats) {
+        // Handle both section lock and individual stat locks
+        const isStatsLocked = lockedItems.stats === true;
+        if (isStatsLocked) {
+            // Lock entire stats section
+            for (const statName in data.stats) {
+                data.stats[statName] = {
+                    value: data.stats[statName].value || data.stats[statName],
+                    locked: true
+                };
+            }
+        } else {
+            // Lock individual stats
+            for (const statName in lockedItems.stats) {
+                if (lockedItems.stats[statName] && data.stats[statName] !== undefined) {
+                    data.stats[statName] = {
+                        value: data.stats[statName].value || data.stats[statName],
+                        locked: true
+                    };
+                }
+            }
+        }
+    }
+
+    // Lock status field
+    if (data.status && lockedItems.status) {
+        data.status = {
+            ...data.status,
+            locked: true
+        };
+    }
+
+    // Lock individual skills
+    if (data.skills && lockedItems.skills) {
+        if (Array.isArray(data.skills)) {
+            data.skills = data.skills.map(skill => {
+                if (typeof skill === 'string') {
+                    if (lockedItems.skills[skill]) {
+                        return { name: skill, locked: true };
+                    }
+                    return skill;
+                } else if (skill.name && lockedItems.skills[skill.name]) {
+                    return { ...skill, locked: true };
+                }
+                return skill;
+            });
+        }
+    }
+
+    // Lock inventory items - match by item name instead of index
+    if (data.inventory && lockedItems.inventory) {
+        // Helper function to apply locks based on item name
+        const applyInventoryLocks = (items, category) => {
+            if (!Array.isArray(items)) return items;
+            if (!lockedItems.inventory[category]) return items;
+
+            return items.map((item) => {
+                // Get item name (handle both string and object formats)
+                const itemName = typeof item === 'string' ? item : (item.item || item.name || '');
+
+                // Check if this specific item name is locked
+                if (lockedItems.inventory[category][itemName]) {
+                    return typeof item === 'string'
+                        ? { item, locked: true }
+                        : { ...item, locked: true };
+                }
+                return item;
+            });
+        };
+
+        // Apply locks to onPerson items
+        if (data.inventory.onPerson) {
+            data.inventory.onPerson = applyInventoryLocks(data.inventory.onPerson, 'onPerson');
+        }
+
+        // Apply locks to clothing items
+        if (data.inventory.clothing) {
+            data.inventory.clothing = applyInventoryLocks(data.inventory.clothing, 'clothing');
+        }
+
+        // Apply locks to assets
+        if (data.inventory.assets) {
+            data.inventory.assets = applyInventoryLocks(data.inventory.assets, 'assets');
+        }
+
+        // Apply locks to stored items - match by item name
+        if (data.inventory.stored && lockedItems.inventory.stored) {
+            for (const location in data.inventory.stored) {
+                if (Array.isArray(data.inventory.stored[location]) && lockedItems.inventory.stored[location]) {
+                    data.inventory.stored[location] = data.inventory.stored[location].map((item) => {
+                        const itemName = typeof item === 'string' ? item : (item.item || item.name || '');
+                        if (lockedItems.inventory.stored[location][itemName]) {
+                            return typeof item === 'string'
+                                ? { item, locked: true }
+                                : { ...item, locked: true };
+                        }
+                        return item;
+                    });
+                }
+            }
+        }
+    }
+
+    // Lock individual quests - handle paths like "quests.main" and "quests.optional[0]"
+    if (data.quests && lockedItems.quests) {
+        // Check if main quest is locked (entire section)
+        if (data.quests.main && lockedItems.quests.main === true) {
+            data.quests.main = { value: data.quests.main, locked: true };
+        }
+
+        // Check individual optional quests
+        if (data.quests.optional && Array.isArray(data.quests.optional)) {
+            data.quests.optional = data.quests.optional.map((quest, index) => {
+                const bracketPath = `optional[${index}]`;
+                if (lockedItems.quests[bracketPath]) {
+                    return typeof quest === 'string'
+                        ? { title: quest, locked: true }
+                        : { ...quest, locked: true };
+                }
+                return quest;
+            });
+        }
+    }
+
+    return JSON.stringify(data, null, 2);
+}
+
+/**
+ * Apply locks to Info Box tracker
+ * @param {Object} data - Parsed info box data
+ * @param {Object} lockedItems - Locked items configuration
+ * @returns {string} JSON string with locks applied
+ */
+function applyInfoBoxLocks(data, lockedItems) {
+    if (lockedItems.date && data.date) {
+        data.date = { ...data.date, locked: true };
+    }
+
+    if (lockedItems.weather && data.weather) {
+        data.weather = { ...data.weather, locked: true };
+    }
+
+    if (lockedItems.temperature && data.temperature) {
+        data.temperature = { ...data.temperature, locked: true };
+    }
+
+    if (lockedItems.time && data.time) {
+        data.time = { ...data.time, locked: true };
+    }
+
+    if (lockedItems.location && data.location) {
+        data.location = { ...data.location, locked: true };
+    }
+
+    if (lockedItems.recentEvents && data.recentEvents) {
+        data.recentEvents = { ...data.recentEvents, locked: true };
+    }
+
+    return JSON.stringify(data, null, 2);
+}
+
+/**
+ * Apply locks to Characters tracker
+ * @param {Object} data - Parsed characters data
+ * @param {Object} lockedItems - Locked items configuration
+ * @returns {string} JSON string with locks applied
+ */
+function applyCharactersLocks(data, lockedItems) {
+    // console.log('[Lock Manager] applyCharactersLocks called');
+    // console.log('[Lock Manager] Locked items:', JSON.stringify(lockedItems, null, 2));
+    // console.log('[Lock Manager] Input data:', JSON.stringify(data, null, 2));
+
+    // Handle both array format and object format
+    let characters = Array.isArray(data) ? data : (data.characters || []);
+
+    characters = characters.map((char, index) => {
+        const charName = char.name || char.characterName;
+
+        // Check if entire character is locked (index-based)
+        if (lockedItems[index] === true) {
+            // console.log('[Lock Manager] Locking entire character by index:', index);
+            return { ...char, locked: true };
+        }
+
+        // Check if character name exists in locked items (could be nested object for field locks or boolean for full lock)
+        const charLocks = lockedItems[charName];
+
+        if (charLocks === true) {
+            // Entire character is locked
+            // console.log('[Lock Manager] Locking entire character:', charName);
+            return { ...char, locked: true };
+        } else if (charLocks && typeof charLocks === 'object') {
+            // Character has field-level locks
+            const modifiedChar = { ...char };
+
+            for (const fieldName in charLocks) {
+                if (charLocks[fieldName] === true) {
+                    // Check both the original field name and snake_case version
+                    // (AI returns snake_case, but locks are stored with original configured names)
+                    // Use the same conversion as toSnakeCase in thoughts.js
+                    const snakeCaseFieldName = fieldName
+                        .toLowerCase()
+                        .replace(/[^a-z0-9]+/g, '_')
+                        .replace(/^_+|_+$/g, '');
+
+                    let locked = false;
+
+                    // Check at root level first (backward compatibility)
+                    if (modifiedChar[fieldName] !== undefined) {
+                        // console.log('[Lock Manager] Applying lock to field:', `${charName}.${fieldName}`);
+                        modifiedChar[fieldName] = {
+                            value: modifiedChar[fieldName],
+                            locked: true
+                        };
+                        locked = true;
+                    } else if (modifiedChar[snakeCaseFieldName] !== undefined) {
+                        // console.log('[Lock Manager] Applying lock to snake_case field:', `${charName}.${snakeCaseFieldName} (from ${fieldName})`);
+                        modifiedChar[snakeCaseFieldName] = {
+                            value: modifiedChar[snakeCaseFieldName],
+                            locked: true
+                        };
+                        locked = true;
+                    }
+
+                    // Check in nested objects (details, relationship, thoughts)
+                    if (!locked && modifiedChar.details) {
+                        if (modifiedChar.details[fieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to details field:', `${charName}.details.${fieldName}`);
+                            if (!modifiedChar.details || typeof modifiedChar.details !== 'object') {
+                                modifiedChar.details = {};
+                            } else {
+                                modifiedChar.details = { ...modifiedChar.details };
+                            }
+                            modifiedChar.details[fieldName] = {
+                                value: modifiedChar.details[fieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        } else if (modifiedChar.details[snakeCaseFieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to details snake_case field:', `${charName}.details.${snakeCaseFieldName} (from ${fieldName})`);
+                            if (!modifiedChar.details || typeof modifiedChar.details !== 'object') {
+                                modifiedChar.details = {};
+                            } else {
+                                modifiedChar.details = { ...modifiedChar.details };
+                            }
+                            modifiedChar.details[snakeCaseFieldName] = {
+                                value: modifiedChar.details[snakeCaseFieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        }
+                    }
+
+                    // Check in relationship object
+                    if (!locked && modifiedChar.relationship) {
+                        if (modifiedChar.relationship[fieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to relationship field:', `${charName}.relationship.${fieldName}`);
+                            modifiedChar.relationship = { ...modifiedChar.relationship };
+                            modifiedChar.relationship[fieldName] = {
+                                value: modifiedChar.relationship[fieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        } else if (modifiedChar.relationship[snakeCaseFieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to relationship snake_case field:', `${charName}.relationship.${snakeCaseFieldName} (from ${fieldName})`);
+                            modifiedChar.relationship = { ...modifiedChar.relationship };
+                            modifiedChar.relationship[snakeCaseFieldName] = {
+                                value: modifiedChar.relationship[snakeCaseFieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        }
+                    }
+
+                    // Check in thoughts object
+                    if (!locked && modifiedChar.thoughts) {
+                        if (modifiedChar.thoughts[fieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to thoughts field:', `${charName}.thoughts.${fieldName}`);
+                            modifiedChar.thoughts = { ...modifiedChar.thoughts };
+                            modifiedChar.thoughts[fieldName] = {
+                                value: modifiedChar.thoughts[fieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        } else if (modifiedChar.thoughts[snakeCaseFieldName] !== undefined) {
+                            // console.log('[Lock Manager] Applying lock to thoughts snake_case field:', `${charName}.thoughts.${snakeCaseFieldName} (from ${fieldName})`);
+                            modifiedChar.thoughts = { ...modifiedChar.thoughts };
+                            modifiedChar.thoughts[snakeCaseFieldName] = {
+                                value: modifiedChar.thoughts[snakeCaseFieldName],
+                                locked: true
+                            };
+                            locked = true;
+                        }
+                    }
+                }
+            }
+
+            return modifiedChar;
+        }
+
+        // No locks for this character
+        return char;
+    });
+
+    const result = Array.isArray(data)
+        ? JSON.stringify(characters, null, 2)
+        : JSON.stringify({ ...data, characters }, null, 2);
+
+    // console.log('[Lock Manager] Output data:', result);
+    return result;
+}
+
+/**
+ * Remove locks from tracker data received from AI.
+ * Strips "locked": true from all items to clean up the data.
+ *
+ * @param {string} trackerData - JSON string of tracker data
+ * @returns {string} Tracker data with locks removed
+ */
+export function removeLocks(trackerData) {
+    if (!trackerData) return trackerData;
+
+    // Try to parse as JSON
+    const parsed = repairJSON(trackerData);
+    if (!parsed) {
+        // Not JSON format, return as-is
+        return trackerData;
+    }
+
+    // Recursively remove all "locked" properties
+    const cleaned = removeLockedProperties(parsed);
+
+    return JSON.stringify(cleaned, null, 2);
+}
+
+/**
+ * Recursively remove "locked" properties from an object
+ * @param {*} obj - Object to clean
+ * @returns {*} Object with locked properties removed
+ */
+function removeLockedProperties(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(item => removeLockedProperties(item));
+    } else if (obj !== null && typeof obj === 'object') {
+        const cleaned = {};
+        for (const key in obj) {
+            if (key !== 'locked') {
+                cleaned[key] = removeLockedProperties(obj[key]);
+            }
+        }
+        return cleaned;
+    }
+    return obj;
+}
+
+/**
+ * Check if a specific item is locked
+ * @param {string} trackerType - Type of tracker
+ * @param {string} itemPath - Path to the item (e.g., 'stats.Health', 'quests.main.0')
+ * @returns {boolean} Whether the item is locked
+ */
+export function isItemLocked(trackerType, itemPath) {
+    const lockedItems = extensionSettings.lockedItems?.[trackerType];
+    if (!lockedItems) return false;
+
+    const parts = itemPath.split('.');
+    let current = lockedItems;
+
+    for (const part of parts) {
+        if (current[part] === undefined) return false;
+        current = current[part];
+    }
+
+    return !!current;
+}
+
+/**
+ * Toggle lock state for a specific item
+ * @param {string} trackerType - Type of tracker
+ * @param {string} itemPath - Path to the item
+ * @param {boolean} locked - New lock state
+ */
+export function setItemLock(trackerType, itemPath, locked) {
+    // console.log('[Lock Manager] setItemLock called:', { trackerType, itemPath, locked });
+
+    if (!extensionSettings.lockedItems) {
+        extensionSettings.lockedItems = {};
+    }
+
+    if (!extensionSettings.lockedItems[trackerType]) {
+        extensionSettings.lockedItems[trackerType] = {};
+    }
+
+    const parts = itemPath.split('.');
+    let current = extensionSettings.lockedItems[trackerType];
+
+    // Navigate to parent of target
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!current[part]) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+
+    // Set or remove lock
+    const finalKey = parts[parts.length - 1];
+    if (locked) {
+        current[finalKey] = true;
+    } else {
+        delete current[finalKey];
+    }
+
+    // console.log('[Lock Manager] Locked items after set:', JSON.stringify(extensionSettings.lockedItems, null, 2));
+}

src/systems/generation/parser.js

@@ -1,11 +1,27 @@
 /**
  * Parser Module
  * Handles parsing of AI responses to extract tracker data
+ * Supports both legacy text format and new v3 JSON format
  */
 
 import { extensionSettings, FEATURE_FLAGS, addDebugLog } from '../../core/state.js';
 import { saveSettings } from '../../core/persistence.js';
 import { extractInventory } from './inventoryParser.js';
+import { repairJSON } from '../../utils/jsonRepair.js';
+
+/**
+ * Extracts the base name (before parentheses) and converts to snake_case for use as JSON key.
+ * Example: "Conditions (up to 5 traits)" -> "conditions"
+ * @param {string} name - Field name, possibly with parenthetical description
+ * @returns {string} snake_case key from the base name only
+ */
+function toFieldKey(name) {
+    const baseName = name.replace(/\s*\(.*\)\s*$/, '').trim();
+    return baseName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
 
 /**
  * Helper to separate emoji from text in a string
@@ -127,7 +143,7 @@ function stripBrackets(text) {
  * Helper to log to both console and debug logs array
  */
 function debugLog(message, data = null) {
-    console.log(message, data || '');
+    // console.log(message, data || '');
     if (extensionSettings.debugMode) {
         addDebugLog(message, data);
     }
@@ -159,6 +175,256 @@ export function parseResponse(responseText) {
     cleanedResponse = cleanedResponse.replace(/<thinking>[\s\S]*?<\/thinking>/gi, '');
     debugLog('[RPG Parser] Removed thinking tags, new length:', cleanedResponse.length + ' chars');
 
+    // Remove "FORMAT:" markers that the model might accidentally output
+    cleanedResponse = cleanedResponse.replace(/FORMAT:\s*/gi, '');
+    debugLog('[RPG Parser] Removed FORMAT: markers, new length:', cleanedResponse.length + ' chars');
+
+    // First, try to extract raw JSON objects (v3 format)
+    // Note: Prompts now instruct models to use ```json``` code blocks, but we extract
+    // from any JSON found using brace-matching for maximum compatibility
+    // Use brace-matching to find complete JSON objects
+    const extractedObjects = [];
+    let i = 0;
+    while (i < cleanedResponse.length) {
+        if (cleanedResponse[i] === '{') {
+            // Found opening brace, find matching closing brace
+            let depth = 1;
+            let j = i + 1;
+            let inString = false;
+            let escapeNext = false;
+
+            while (j < cleanedResponse.length && depth > 0) {
+                const char = cleanedResponse[j];
+
+                if (escapeNext) {
+                    escapeNext = false;
+                } else if (char === '\\') {
+                    escapeNext = true;
+                } else if (char === '"') {
+                    inString = !inString;
+                } else if (!inString) {
+                    if (char === '{') depth++;
+                    else if (char === '}') depth--;
+                }
+                j++;
+            }
+
+            if (depth === 0) {
+                // Found complete JSON object
+                const jsonContent = cleanedResponse.substring(i, j).trim();
+                if (jsonContent) {
+                    extractedObjects.push(jsonContent);
+                }
+                i = j;
+            } else {
+                i++;
+            }
+        } else {
+            i++;
+        }
+    }
+
+    if (extractedObjects.length > 0) {
+        // console.log(`[RPG Parser] ✓ Found ${extractedObjects.length} raw JSON objects (v3 format)`);
+        debugLog(`[RPG Parser] ✓ Found ${extractedObjects.length} raw JSON objects (v3 format)`);
+
+        // First, try to parse as unified JSON structure (new v3.1 format)
+        if (extractedObjects.length === 1) {
+            const parsed = repairJSON(extractedObjects[0]);
+            if (parsed && (parsed.userStats || parsed.infoBox || parsed.characters)) {
+                // console.log('[RPG Parser] ✓ Detected unified JSON structure (v3.1 format)');
+
+                if (parsed.userStats) {
+                    result.userStats = JSON.stringify(parsed.userStats);
+                    // console.log('[RPG Parser] ✓ Extracted userStats from unified structure');
+                }
+                if (parsed.infoBox) {
+                    result.infoBox = JSON.stringify(parsed.infoBox);
+                    // console.log('[RPG Parser] ✓ Extracted infoBox from unified structure');
+                }
+                if (parsed.characters) {
+                    result.characterThoughts = JSON.stringify(parsed.characters);
+                    // console.log('[RPG Parser] ✓ Extracted characters from unified structure');
+                }
+
+                if (result.userStats || result.infoBox || result.characterThoughts) {
+                    // console.log('[RPG Parser] ✓ Returning unified JSON parse results');
+                    debugLog('[RPG Parser] Returning unified JSON parse results');
+                    return result;
+                }
+            }
+        }
+
+        // Fall back to parsing multiple separate JSON objects (legacy v3.0 format)
+        for (let idx = 0; idx < extractedObjects.length; idx++) {
+            const jsonContent = extractedObjects[idx];
+            // console.log(`[RPG Parser] Parsing object ${idx + 1}:`, jsonContent.substring(0, 100) + '...');
+            // console.log(`[RPG Parser] Full object ${idx + 1} length:`, jsonContent.length);
+
+            const parsed = repairJSON(jsonContent);
+
+            if (parsed) {
+                // console.log(`[RPG Parser] Object ${idx + 1} parsed successfully, keys:`, Object.keys(parsed));
+
+                // Check if object is wrapped (e.g., {"userStats": {...}})
+                // Unwrap single-key objects that match our tracker types
+                let unwrapped = parsed;
+                if (Object.keys(parsed).length === 1) {
+                    const key = Object.keys(parsed)[0];
+                    if (key === 'userStats' || key === 'infoBox' || key === 'characters') {
+                        unwrapped = parsed[key];
+                        // console.log(`[RPG Parser] ✓ Unwrapped ${key} object`);
+                    }
+                }
+
+                // Detect tracker type by checking for top-level fields
+                if (unwrapped.stats || unwrapped.status || unwrapped.skills || unwrapped.inventory || unwrapped.quests) {
+                    result.userStats = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to User Stats');
+                    debugLog('[RPG Parser] ✓ Extracted raw JSON User Stats');
+                } else if (unwrapped.date || unwrapped.location || unwrapped.weather || unwrapped.temperature || unwrapped.time) {
+                    result.infoBox = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to Info Box');
+                    debugLog('[RPG Parser] ✓ Extracted raw JSON Info Box');
+                } else if (unwrapped.characters || Array.isArray(unwrapped)) {
+                    result.characterThoughts = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to Characters');
+                    debugLog('[RPG Parser] ✓ Extracted raw JSON Characters');
+                } else {
+                    console.warn('[RPG Parser] ⚠️ Could not categorize object with keys:', Object.keys(parsed));
+                }
+            } else {
+                console.error('[RPG Parser] ✗ Failed to parse raw JSON object', idx + 1);
+            }
+        }
+
+        if (result.userStats || result.infoBox || result.characterThoughts) {
+            // console.log('[RPG Parser] ✓ Returning raw JSON parse results:', {
+            //     hasUserStats: !!result.userStats,
+            //     hasInfoBox: !!result.infoBox,
+            //     hasCharacters: !!result.characterThoughts
+            // });
+            debugLog('[RPG Parser] Returning raw JSON parse results');
+            return result;
+        } else {
+            console.warn('[RPG Parser] ⚠️ No tracker data extracted from', extractedObjects.length, 'objects');
+        }
+    }
+
+    // Check for JSON code blocks (legacy v3 format with ```json fences)
+    // Look for ```json code blocks which indicate JSON format
+    const jsonBlockRegex = /```json\s*\n([\s\S]*?)```/g;
+    const jsonMatches = [...cleanedResponse.matchAll(jsonBlockRegex)];
+
+    if (jsonMatches.length > 0) {
+        // console.log('[RPG Parser] ✓ Found', jsonMatches.length, 'JSON code blocks (v3 format with fences)');
+        debugLog('[RPG Parser] ✓ Found JSON code blocks (v3 format), parsing as JSON');
+
+        for (let idx = 0; idx < jsonMatches.length; idx++) {
+            const match = jsonMatches[idx];
+            const jsonContent = match[1].trim();
+
+            if (!jsonContent) continue;
+
+            // console.log(`[RPG Parser] Parsing JSON block ${idx + 1}:`, jsonContent.substring(0, 100) + '...');
+
+            const parsed = repairJSON(jsonContent);
+
+            if (parsed) {
+                // console.log(`[RPG Parser] JSON block ${idx + 1} parsed successfully, keys:`, Object.keys(parsed));
+
+                // Detect tracker type by checking for top-level fields
+                if (parsed.stats || parsed.status || parsed.skills || parsed.inventory || parsed.quests) {
+                    result.userStats = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to User Stats');
+                    debugLog('[RPG Parser] ✓ Extracted JSON User Stats');
+                } else if (parsed.date || parsed.location || parsed.weather || parsed.temperature || parsed.time) {
+                    result.infoBox = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to Info Box');
+                    debugLog('[RPG Parser] ✓ Extracted JSON Info Box');
+                } else if (parsed.characters || Array.isArray(parsed)) {
+                    result.characterThoughts = jsonContent;
+                    // console.log('[RPG Parser] ✓ Assigned to Characters');
+                    debugLog('[RPG Parser] ✓ Extracted JSON Characters');
+                } else {
+                    console.warn('[RPG Parser] ⚠️ Could not categorize JSON block with keys:', Object.keys(parsed));
+                }
+            } else {
+                console.error('[RPG Parser] ✗ Failed to parse JSON code block', idx + 1);
+                debugLog('[RPG Parser] ✗ Failed to parse JSON block, will try text fallback');
+            }
+        }
+
+        // If we found at least one valid JSON block, return the result
+        // Mixed formats (some JSON, some text) will still work
+        if (result.userStats || result.infoBox || result.characterThoughts) {
+            // console.log('[RPG Parser] ✓ Returning JSON code block parse results:', {
+            //     hasUserStats: !!result.userStats,
+            //     hasInfoBox: !!result.infoBox,
+            //     hasCharacters: !!result.characterThoughts
+            // });
+            debugLog('[RPG Parser] Returning JSON parse results');
+            return result;
+        } else {
+            console.warn('[RPG Parser] ⚠️ No tracker data extracted from', jsonMatches.length, 'JSON blocks');
+        }
+    }
+
+    // Check if response uses XML <trackers> tags (hybrid format)
+    const xmlMatch = cleanedResponse.match(/<trackers>([\s\S]*?)<\/trackers>/i);
+    if (xmlMatch) {
+        debugLog('[RPG Parser] ✓ Found XML <trackers> tags, using XML parser');
+        const trackersContent = xmlMatch[1].trim();
+
+        // Try to parse JSON blocks within XML first
+        const xmlJsonMatches = [...trackersContent.matchAll(jsonBlockRegex)];
+        if (xmlJsonMatches.length > 0) {
+            debugLog('[RPG Parser] Found JSON blocks within XML tags');
+            for (const match of xmlJsonMatches) {
+                const jsonContent = match[1].trim();
+
+                if (!jsonContent) continue;
+
+                const parsed = repairJSON(jsonContent);
+
+                if (parsed) {
+                    if (parsed.type === 'userStats' || parsed.stats) {
+                        result.userStats = jsonContent;
+                    } else if (parsed.type === 'infoBox' || parsed.date || parsed.location) {
+                        result.infoBox = jsonContent;
+                    } else if (parsed.type === 'characters' || parsed.characters || Array.isArray(parsed)) {
+                        result.characterThoughts = jsonContent;
+                    }
+                }
+            }
+        } else {
+            // Fallback to text extraction from XML content (legacy v2 text format)
+            const statsMatch = trackersContent.match(/(User )?Stats\s*\n\s*---[\s\S]*?(?=\n\s*\n\s*(Info Box|Present Characters)|$)/i);
+            if (statsMatch) {
+                result.userStats = stripBrackets(statsMatch[0].trim());
+                debugLog('[RPG Parser] ✓ Extracted Stats from XML (text format)');
+            }
+
+            const infoBoxMatch = trackersContent.match(/Info Box\s*\n\s*---[\s\S]*?(?=\n\s*\n\s*Present Characters|$)/i);
+            if (infoBoxMatch) {
+                result.infoBox = stripBrackets(infoBoxMatch[0].trim());
+                debugLog('[RPG Parser] ✓ Extracted Info Box from XML (text format)');
+            }
+
+            const charactersMatch = trackersContent.match(/Present Characters\s*\n\s*---[\s\S]*$/i);
+            if (charactersMatch) {
+                result.characterThoughts = stripBrackets(charactersMatch[0].trim());
+                debugLog('[RPG Parser] ✓ Extracted Present Characters from XML (text format)');
+            }
+        }
+
+        debugLog('[RPG Parser] Parsed from XML:', result);
+        return result;
+    }
+
+    // Fallback to markdown code block parsing (old text format or mixed format)
+    debugLog('[RPG Parser] No XML tags found, using code block parser');
+
     // Extract code blocks
     const codeBlockRegex = /```([^`]+)```/g;
     const matches = [...cleanedResponse.matchAll(codeBlockRegex)];
@@ -256,8 +522,14 @@ export function parseResponse(responseText) {
     debugLog('[RPG Parser] Found Characters:', !!result.characterThoughts);
     debugLog('[RPG Parser] =======================================================');
 
+    // Check if we found at least one section - if not, mark as parsing failure
+    if (!result.userStats && !result.infoBox && !result.characterThoughts) {
+        result.parsingFailed = true;
+        console.error('[RPG Parser] ❌ No tracker data found in response - parsing failed');
+    }
+
     return result;
-}
+} // End parseResponse
 
 /**
  * Parses user stats from the text and updates the extensionSettings.
@@ -271,6 +543,133 @@ export function parseUserStats(statsText) {
     debugLog('[RPG Parser] Stats text preview:', statsText.substring(0, 200));
 
     try {
+        // Check if this is v3 JSON format - try to parse it first
+        let statsData = null;
+        const trimmed = statsText.trim();
+        if (trimmed && (trimmed.startsWith('{') || trimmed.startsWith('['))) {
+            statsData = repairJSON(statsText);
+            if (statsData) {
+                debugLog('[RPG Parser] ✓ Parsed as v3 JSON format');
+
+                // Extract stats from v3 JSON structure
+                if (statsData.stats && Array.isArray(statsData.stats)) {
+                    // console.log('[RPG Parser] ✓ Extracting stats array, count:', statsData.stats.length);
+                    statsData.stats.forEach(stat => {
+                        if (stat.id && typeof stat.value !== 'undefined') {
+                            extensionSettings.userStats[stat.id] = stat.value;
+                            // console.log(`[RPG Parser] ✓ Set ${stat.id} = ${stat.value}`);
+                        }
+                    });
+                }
+
+                // Extract status
+                if (statsData.status) {
+                    // console.log('[RPG Parser] ✓ Extracting status:', statsData.status);
+                    if (statsData.status.mood) {
+                        extensionSettings.userStats.mood = statsData.status.mood;
+                        // console.log('[RPG Parser] ✓ Set mood =', statsData.status.mood);
+                    }
+                    // Extract all custom status fields
+                    const trackerConfig = extensionSettings.trackerConfig;
+                    const customFields = trackerConfig?.userStats?.statusSection?.customFields || [];
+                    for (const fieldName of customFields) {
+                        const fieldKey = toFieldKey(fieldName);
+                        // Try the base key first (e.g., "conditions"), then fall back to full lowercase name
+                        const value = statsData.status[fieldKey] || statsData.status[fieldName.toLowerCase()];
+                        if (value) {
+                            extensionSettings.userStats[fieldKey] = value;
+                            // console.log(`[RPG Parser] ✓ Set ${fieldKey} =`, value);
+                        }
+                    }
+                }
+
+                // Extract inventory (convert v3 array format to v2 string format)
+                if (statsData.inventory) {
+                    const inv = statsData.inventory;
+
+                    // Convert arrays of {name, quantity} objects to comma-separated strings
+                    const convertItems = (items) => {
+                        if (!items || !Array.isArray(items)) return '';
+                        return items.map(item => {
+                            if (typeof item === 'object' && item.name) {
+                                // Include quantity if > 1
+                                return item.quantity && item.quantity > 1
+                                    ? `${item.quantity}x ${item.name}`
+                                    : item.name;
+                            }
+                            return String(item);
+                        }).join(', ');
+                    };
+
+                    // Convert stored object {location: [items]} to {location: "item1, item2"}
+                    const convertStoredInventory = (stored) => {
+                        if (!stored || typeof stored !== 'object' || Array.isArray(stored)) return {};
+                        const result = {};
+                        for (const [location, items] of Object.entries(stored)) {
+                            if (Array.isArray(items)) {
+                                result[location] = convertItems(items);
+                            } else if (typeof items === 'string') {
+                                result[location] = items;
+                            } else {
+                                result[location] = '';
+                            }
+                        }
+                        return result;
+                    };
+
+                    extensionSettings.userStats.inventory = {
+                        onPerson: convertItems(inv.onPerson),
+                        clothing: convertItems(inv.clothing),
+                        stored: convertStoredInventory(inv.stored),
+                        assets: convertItems(inv.assets)
+                    };
+                    // console.log('[RPG Parser] ✓ Converted v3 inventory:', extensionSettings.userStats.inventory);
+                }
+
+                // Extract quests (convert v3 object format to v2 string format)
+                if (statsData.quests) {
+                    // Convert quest objects to strings
+                    const convertQuest = (quest) => {
+                        if (!quest) return '';
+                        if (typeof quest === 'string') return quest;
+                        if (typeof quest === 'object') {
+                            // Check for locked format: {value, locked}
+                            // Recursively extract value if it's nested
+                            let extracted = quest;
+                            while (typeof extracted === 'object' && extracted.value !== undefined) {
+                                extracted = extracted.value;
+                            }
+                            if (typeof extracted === 'string') return extracted;
+                            // v3 format: {title, description, status}
+                            return quest.title || quest.description || JSON.stringify(quest);
+                        }
+                        return String(quest);
+                    };
+
+                    extensionSettings.quests = {
+                        main: convertQuest(statsData.quests.main),
+                        optional: Array.isArray(statsData.quests.optional)
+                            ? statsData.quests.optional.map(convertQuest)
+                            : []
+                    };
+                    // console.log('[RPG Parser] ✓ Converted v3 quests:', extensionSettings.quests);
+                }
+
+                // Extract skills if present (store as object, not JSON string)
+                if (statsData.skills && Array.isArray(statsData.skills)) {
+                    extensionSettings.userStats.skills = statsData.skills;
+                    // console.log('[RPG Parser] ✓ Set skills:', extensionSettings.userStats.skills);
+                }
+
+                debugLog('[RPG Parser] ✓ Successfully extracted v3 JSON data');
+                saveSettings();
+                return; // Done processing v3 format
+            }
+        }
+
+        // Fall back to v2 text format parsing if JSON parsing failed
+        debugLog('[RPG Parser] Falling back to v2 text format parsing');
+
         // Get custom stat configuration
         const trackerConfig = extensionSettings.trackerConfig;
         const customStats = trackerConfig?.userStats?.customStats || [];
@@ -317,6 +716,7 @@ export function parseUserStats(statsText) {
         const statusConfig = trackerConfig?.userStats?.statusSection;
         if (statusConfig?.enabled) {
             let moodMatch = null;
+            const customFields = statusConfig.customFields || [];
 
             // Try Status: format
             const statusMatch = statsText.match(/Status:\s*(.+)/i);
@@ -329,14 +729,30 @@ export function parseUserStats(statsText) {
                     if (emoji) {
                         extensionSettings.userStats.mood = emoji;
                         // Remaining text contains custom status fields
-                        if (text) {
-                            extensionSettings.userStats.conditions = text;
+                        if (text && customFields.length > 0) {
+                            // For first custom field, use the remaining text
+                            const firstFieldKey = customFields[0].toLowerCase();
+                            extensionSettings.userStats[firstFieldKey] = text;
                         }
                         moodMatch = true;
                     }
                 } else {
-                    // No mood emoji, whole status is conditions
-                    extensionSettings.userStats.conditions = statusContent;
+                    // No mood emoji, whole status goes to first custom field
+                    if (customFields.length > 0) {
+                        const firstFieldKey = customFields[0].toLowerCase();
+                        extensionSettings.userStats[firstFieldKey] = statusContent;
+                    }
+                    moodMatch = true;
+                }
+            }
+
+            // Try to extract individual custom status fields by name
+            for (const fieldName of customFields) {
+                const fieldKey = fieldName.toLowerCase();
+                const fieldRegex = new RegExp(`${fieldName}:\\s*(.+?)(?:,|$)`, 'i');
+                const fieldMatch = statsText.match(fieldRegex);
+                if (fieldMatch) {
+                    extensionSettings.userStats[fieldKey] = fieldMatch[1].trim();
                     moodMatch = true;
                 }
             }
@@ -344,7 +760,10 @@ export function parseUserStats(statsText) {
             debugLog('[RPG Parser] Status match:', {
                 found: !!moodMatch,
                 mood: extensionSettings.userStats.mood,
-                conditions: extensionSettings.userStats.conditions
+                customFields: customFields.map(f => ({
+                    name: f,
+                    value: extensionSettings.userStats[f.toLowerCase()]
+                }))
             });
         }
 

src/systems/integration/sillytavern.js

@@ -4,7 +4,7 @@
  */
 
 import { getContext } from '../../../../../../extensions.js';
-import { chat, user_avatar, setExtensionPrompt, extension_prompt_types, updateMessageBlock } from '../../../../../../../script.js';
+import { chat, user_avatar, setExtensionPrompt, extension_prompt_types, saveChatDebounced } from '../../../../../../../script.js';
 
 // Core modules
 import {
@@ -13,16 +13,24 @@ import {
     committedTrackerData,
     lastActionWasSwipe,
     isPlotProgression,
+    isAwaitingNewMessage,
     setLastActionWasSwipe,
     setIsPlotProgression,
+    setIsGenerating,
+    setIsAwaitingNewMessage,
     updateLastGeneratedData,
-    updateCommittedTrackerData
+    updateCommittedTrackerData,
+    $musicPlayerContainer
 } from '../../core/state.js';
-import { saveChatData, loadChatData } from '../../core/persistence.js';
+import { saveChatData, loadChatData, autoSwitchPresetForEntity } from '../../core/persistence.js';
+import { i18n } from '../../core/i18n.js';
 
 // Generation & Parsing
 import { parseResponse, parseUserStats } from '../generation/parser.js';
+import { parseAndStoreSpotifyUrl, convertToEmbedUrl } from '../features/musicPlayer.js';
 import { updateRPGData } from '../generation/apiClient.js';
+import { removeLocks } from '../generation/lockManager.js';
+import { onGenerationStarted, initHistoryInjectionListeners } from '../generation/injector.js';
 
 // Rendering
 import { renderUserStats } from '../rendering/userStats.js';
@@ -30,10 +38,19 @@ import { renderInfoBox } from '../rendering/infoBox.js';
 import { renderThoughts, updateChatThoughts } from '../rendering/thoughts.js';
 import { renderInventory } from '../rendering/inventory.js';
 import { renderQuests } from '../rendering/quests.js';
+import { renderMusicPlayer } from '../rendering/musicPlayer.js';
 
 // Utils
 import { getSafeThumbnailUrl } from '../../utils/avatars.js';
 
+// UI
+import { setFabLoadingState, updateFabWidgets } from '../ui/mobile.js';
+import { updateStripWidgets } from '../ui/desktop.js';
+
+// Chapter checkpoint
+import { updateAllCheckpointIndicators } from '../ui/checkpointUI.js';
+import { restoreCheckpointOnLoad } from '../features/chapterCheckpoint.js';
+
 /**
  * Commits the tracker data from the last assistant message to be used as source for next generation.
  * This should be called when the user has replied to a message, ensuring all swipes of the next
@@ -73,27 +90,43 @@ export function commitTrackerData() {
 /**
  * Event handler for when the user sends a message.
  * Sets the flag to indicate this is NOT a swipe.
- * In separate mode with auto-update disabled, commits the displayed tracker data.
+ * In together mode, commits displayed data (only for real messages, not streaming placeholders).
  */
 export function onMessageSent() {
     if (!extensionSettings.enabled) return;
 
-    // User sent a new message - NOT a swipe
-    setLastActionWasSwipe(false);
     // console.log('[RPG Companion] 🟢 EVENT: onMessageSent - lastActionWasSwipe =', lastActionWasSwipe);
 
-    // In separate mode with auto-update disabled, commit displayed tracker when user sends a message
+    // Check if this is a streaming placeholder message (content = "...")
+    // When streaming is on, ST sends a "..." placeholder before generation starts
+    const context = getContext();
+    const chat = context.chat;
+    const lastMessage = chat && chat.length > 0 ? chat[chat.length - 1] : null;
+
+    if (lastMessage && lastMessage.mes === '...') {
+        // console.log('[RPG Companion] 🟢 Ignoring onMessageSent: streaming placeholder message');
+        return;
+    }
+
+    // console.log('[RPG Companion] 🟢 EVENT: onMessageSent (after placeholder check)');
+    // console.log('[RPG Companion] 🟢 NOTE: lastActionWasSwipe will be reset in onMessageReceived after generation completes');
+
+    // Set flag to indicate we're expecting a new message from generation
+    // This allows auto-update to distinguish between new generations and loading chat history
+    setIsAwaitingNewMessage(true);
+
+    // Note: FAB spinning is NOT shown for together mode since no extra API request is made
+    // The RPG data comes embedded in the main response
+    // FAB spinning is handled by apiClient.js for separate/external modes when updateRPGData() is called
+
+    // For separate mode with auto-update disabled, commit displayed tracker
     if (extensionSettings.generationMode === 'separate' && !extensionSettings.autoUpdate) {
-        // Commit whatever is currently displayed in lastGeneratedData
         if (lastGeneratedData.userStats || lastGeneratedData.infoBox || lastGeneratedData.characterThoughts) {
             committedTrackerData.userStats = lastGeneratedData.userStats;
             committedTrackerData.infoBox = lastGeneratedData.infoBox;
             committedTrackerData.characterThoughts = lastGeneratedData.characterThoughts;
 
-            // Save to chat metadata
-            saveChatData();
-
-            // console.log('[RPG Companion] 💾 Committed displayed tracker on user message (auto-update disabled)');
+            // console.log('[RPG Companion] 💾 SEPARATE MODE: Committed displayed tracker (auto-update disabled)');
         }
     }
 }
@@ -102,22 +135,44 @@ export function onMessageSent() {
  * Event handler for when a message is generated.
  */
 export async function onMessageReceived(data) {
+    // console.log('[RPG Companion] onMessageReceived called, lastActionWasSwipe:', lastActionWasSwipe);
+
     if (!extensionSettings.enabled) {
         return;
     }
 
+    // Reset swipe flag after generation completes
+    // This ensures next user message (whether from original or swipe) triggers commit
+    setLastActionWasSwipe(false);
+    // console.log('[RPG Companion] 🟢 Reset lastActionWasSwipe = false (generation completed)');
+
     if (extensionSettings.generationMode === 'together') {
         // In together mode, parse the response to extract RPG data
-        // The message should be in chat[chat.length - 1]
+        // Commit happens in onMessageSent (when user sends message, before generation)
         const lastMessage = chat[chat.length - 1];
         if (lastMessage && !lastMessage.is_user) {
             const responseText = lastMessage.mes;
-            // console.log('[RPG Companion] Parsing together mode response:', responseText);
-
             const parsedData = parseResponse(responseText);
-            // console.log('[RPG Companion] Parsed data:', parsedData);
 
-            // Update stored data
+            // Note: Don't show parsing error here - this event fires when loading chat history too
+            // Error notification is handled in apiClient.js for fresh generations only
+
+            // Remove locks from parsed data (JSON format only, text format is unaffected)
+            if (parsedData.userStats) {
+                parsedData.userStats = removeLocks(parsedData.userStats);
+            }
+            if (parsedData.infoBox) {
+                parsedData.infoBox = removeLocks(parsedData.infoBox);
+            }
+            if (parsedData.characterThoughts) {
+                parsedData.characterThoughts = removeLocks(parsedData.characterThoughts);
+            }
+
+            // Parse and store Spotify URL if feature is enabled
+            parseAndStoreSpotifyUrl(responseText);
+
+            // Update display data with newly parsed response
+            // console.log('[RPG Companion] 📝 TOGETHER MODE: Updating lastGeneratedData with parsed response');
             if (parsedData.userStats) {
                 lastGeneratedData.userStats = parsedData.userStats;
                 parseUserStats(parsedData.userStats);
@@ -146,19 +201,12 @@ export async function onMessageReceived(data) {
 
             // console.log('[RPG Companion] Stored RPG data for swipe', currentSwipeId);
 
-            // If there's no committed data yet (first time generating), automatically commit
-            if (!committedTrackerData.userStats && !committedTrackerData.infoBox && !committedTrackerData.characterThoughts) {
-                committedTrackerData.userStats = parsedData.userStats;
-                committedTrackerData.infoBox = parsedData.infoBox;
-                committedTrackerData.characterThoughts = parsedData.characterThoughts;
-                // console.log('[RPG Companion] 🔆 FIRST TIME: Auto-committed tracker data');
-            } else {
-                // console.log('[RPG Companion] Data will be committed when user replies');
-            }
-
             // Remove the tracker code blocks from the visible message
             let cleanedMessage = responseText;
-            // Remove all code blocks that contain tracker data
+
+            // Note: JSON code blocks are hidden from display by regex script (but preserved in message data)
+
+            // Remove old text format code blocks (legacy support)
             cleanedMessage = cleanedMessage.replace(/```[^`]*?Stats\s*\n\s*---[^`]*?```\s*/gi, '');
             cleanedMessage = cleanedMessage.replace(/```[^`]*?Info Box\s*\n\s*---[^`]*?```\s*/gi, '');
             cleanedMessage = cleanedMessage.replace(/```[^`]*?Present Characters\s*\n\s*---[^`]*?```\s*/gi, '');
@@ -166,6 +214,8 @@ export async function onMessageReceived(data) {
             cleanedMessage = cleanedMessage.replace(/^\s*---\s*$/gm, '');
             // Clean up multiple consecutive newlines
             cleanedMessage = cleanedMessage.replace(/\n{3,}/g, '\n\n');
+            // Note: <trackers> XML tags are automatically hidden by SillyTavern
+            // Note: <Song - Artist/> tags are also automatically hidden by SillyTavern
 
             // Update the message in chat history
             lastMessage.mes = cleanedMessage.trim();
@@ -181,6 +231,11 @@ export async function onMessageReceived(data) {
             renderThoughts();
             renderInventory();
             renderQuests();
+            renderMusicPlayer($musicPlayerContainer[0]);
+
+            // Update FAB widgets and strip widgets with newly parsed data
+            updateFabWidgets();
+            updateStripWidgets();
 
             // Then update the DOM to reflect the cleaned message
             // Using updateMessageBlock to perform macro substitutions + regex formatting
@@ -192,13 +247,38 @@ export async function onMessageReceived(data) {
             // Save to chat metadata
             saveChatData();
         }
-    } else if (extensionSettings.generationMode === 'separate' && extensionSettings.autoUpdate) {
-        // In separate mode with auto-update, trigger update after message
-        setTimeout(async () => {
-            await updateRPGData(renderUserStats, renderInfoBox, renderThoughts, renderInventory);
-        }, 500);
+    } else if (extensionSettings.generationMode === 'separate' || extensionSettings.generationMode === 'external') {
+        // In separate/external mode, also parse Spotify URLs from the main roleplay response
+        const lastMessage = chat[chat.length - 1];
+        if (lastMessage && !lastMessage.is_user) {
+            const responseText = lastMessage.mes;
+
+            // Parse and store Spotify URL
+            const foundSpotifyUrl = parseAndStoreSpotifyUrl(responseText);
+
+            // No need to clean message - SillyTavern auto-hides <Song - Artist/> tags
+            if (foundSpotifyUrl && extensionSettings.enableSpotifyMusic) {
+                // Just render the music player
+                renderMusicPlayer($musicPlayerContainer[0]);
+            }
+        }
+
+        // Trigger auto-update if enabled (for both separate and external modes)
+        // Only trigger if this is a newly generated message, not loading chat history
+        if (extensionSettings.autoUpdate && isAwaitingNewMessage) {
+            setTimeout(async () => {
+                await updateRPGData(renderUserStats, renderInfoBox, renderThoughts, renderInventory);
+                // Update FAB widgets and strip widgets after separate/external mode update completes
+                setFabLoadingState(false);
+                updateFabWidgets();
+                updateStripWidgets();
+            }, 500);
+        }
     }
 
+    // Reset the awaiting flag after processing the message
+    setIsAwaitingNewMessage(false);
+
     // Reset the swipe flag after generation completes
     // This ensures that if the user swiped → auto-reply generated → flag is now cleared
     // so the next user message will be treated as a new message (not a swipe)
@@ -213,6 +293,14 @@ export async function onMessageReceived(data) {
         setIsPlotProgression(false);
         // console.log('[RPG Companion] Plot progression generation completed');
     }
+
+    // Stop FAB loading state and update widgets
+    setFabLoadingState(false);
+    updateFabWidgets();
+    updateStripWidgets();
+
+    // Re-apply checkpoint in case SillyTavern unhid messages during generation
+    await restoreCheckpointOnLoad();
 }
 
 /**
@@ -226,6 +314,12 @@ export function onCharacterChanged() {
     $(window).off('resize.thoughtPanel');
     $(document).off('click.thoughtPanel');
 
+    // Auto-switch to the preset associated with this character/group (if any)
+    const presetSwitched = autoSwitchPresetForEntity();
+    // if (presetSwitched) {
+    //     console.log('[RPG Companion] Auto-switched preset for character');
+    // }
+
     // Load chat-specific data when switching chats
     loadChatData();
 
@@ -240,9 +334,17 @@ export function onCharacterChanged() {
     renderThoughts();
     renderInventory();
     renderQuests();
+    renderMusicPlayer($musicPlayerContainer[0]);
+
+    // Update FAB widgets and strip widgets with loaded data
+    updateFabWidgets();
+    updateStripWidgets();
 
     // Update chat thought overlays
     updateChatThoughts();
+
+    // Update checkpoint indicators for the loaded chat
+    updateAllCheckpointIndicators();
 }
 
 /**
@@ -254,11 +356,12 @@ export function onMessageSwiped(messageIndex) {
         return;
     }
 
-    // console.log('[RPG Companion] Message swiped at index:', messageIndex);
+    // console.log('[RPG Companion] 🔵 EVENT: onMessageSwiped at index:', messageIndex);
 
     // Get the message that was swiped
     const message = chat[messageIndex];
     if (!message || message.is_user) {
+        // console.log('[RPG Companion] 🔵 Ignoring swipe - message is user or undefined');
         return;
     }
 
@@ -274,44 +377,50 @@ export function onMessageSwiped(messageIndex) {
     if (!isExistingSwipe) {
         // This is a NEW swipe that will trigger generation
         setLastActionWasSwipe(true);
-        // console.log('[RPG Companion] 🔵 EVENT: onMessageSwiped (NEW generation) - lastActionWasSwipe =', lastActionWasSwipe);
+        setIsAwaitingNewMessage(true);
+        // console.log('[RPG Companion] 🔵 NEW swipe detected - Set lastActionWasSwipe = true');
     } else {
         // This is navigating to an EXISTING swipe - don't change the flag
-        // console.log('[RPG Companion] 🔵 EVENT: onMessageSwiped (existing swipe navigation) - lastActionWasSwipe unchanged =', lastActionWasSwipe);
+        // console.log('[RPG Companion] 🔵 EXISTING swipe navigation - lastActionWasSwipe unchanged =', lastActionWasSwipe);
     }
 
     // console.log('[RPG Companion] Loading data for swipe', currentSwipeId);
 
-    // Load RPG data for this swipe into lastGeneratedData (for display only)
-    // This updates what the user sees, but does NOT commit it
-    // Committed data will be updated when/if the user replies to this swipe
+    // IMPORTANT: onMessageSwiped is for DISPLAY only!
+    // lastGeneratedData is for DISPLAY, committedTrackerData is for GENERATION
+    // It's safe to load swipe data into lastGeneratedData - it won't be committed due to !lastActionWasSwipe check
     if (message.extra && message.extra.rpg_companion_swipes && message.extra.rpg_companion_swipes[currentSwipeId]) {
         const swipeData = message.extra.rpg_companion_swipes[currentSwipeId];
 
-        // Update display data
+        // Load swipe data into lastGeneratedData for display (both modes)
         lastGeneratedData.userStats = swipeData.userStats || null;
         lastGeneratedData.infoBox = swipeData.infoBox || null;
-        lastGeneratedData.characterThoughts = swipeData.characterThoughts || null;
 
-        // Parse user stats if available
-        if (swipeData.userStats) {
-            parseUserStats(swipeData.userStats);
+        // Normalize characterThoughts to string format (for backward compatibility with old object format)
+        if (swipeData.characterThoughts && typeof swipeData.characterThoughts === 'object') {
+            lastGeneratedData.characterThoughts = JSON.stringify(swipeData.characterThoughts, null, 2);
+        } else {
+            lastGeneratedData.characterThoughts = swipeData.characterThoughts || null;
         }
 
-        // console.log('[RPG Companion] Loaded RPG data for swipe', currentSwipeId, '(display only, NOT committed)');
-        // console.log('[RPG Companion] committedTrackerData unchanged - will be updated if user replies to this swipe');
+        // DON'T parse user stats when loading swipe data
+        // This would overwrite manually edited fields (like Conditions) with old swipe data
+        // The lastGeneratedData is loaded for display purposes only
+        // parseUserStats() updates extensionSettings.userStats which should only be modified
+        // by new generations or manual edits, not by swipe navigation
+
+        // console.log('[RPG Companion] 🔄 Loaded swipe data into lastGeneratedData for display:', currentSwipeId);
     } else {
-        // No data for this swipe - keep existing lastGeneratedData (don't clear it)
-        // This ensures the display remains consistent and data is available for next commit
-        // console.log('[RPG Companion] No RPG data for swipe', currentSwipeId, '- keeping existing lastGeneratedData');
+        // console.log('[RPG Companion] ℹ️ No stored data for swipe:', currentSwipeId);
     }
 
-    // Re-render the panels (display only - committedTrackerData unchanged)
+    // Re-render the panels
     renderUserStats();
     renderInfoBox();
     renderThoughts();
     renderInventory();
     renderQuests();
+    renderMusicPlayer($musicPlayerContainer[0]);
 
     // Update chat thought overlays
     updateChatThoughts();
@@ -358,7 +467,32 @@ export function clearExtensionPrompts() {
     setExtensionPrompt('rpg-companion-inject', '', extension_prompt_types.IN_CHAT, 0, false);
     setExtensionPrompt('rpg-companion-example', '', extension_prompt_types.IN_CHAT, 0, false);
     setExtensionPrompt('rpg-companion-html', '', extension_prompt_types.IN_CHAT, 0, false);
+    setExtensionPrompt('rpg-companion-dialogue-coloring', '', extension_prompt_types.IN_CHAT, 0, false);
+    setExtensionPrompt('rpg-companion-spotify', '', extension_prompt_types.IN_CHAT, 0, false);
     setExtensionPrompt('rpg-companion-context', '', extension_prompt_types.IN_CHAT, 1, false);
     // Note: rpg-companion-plot is not cleared here since it's passed via quiet_prompt option
     // console.log('[RPG Companion] Cleared all extension prompts');
 }
+
+/**
+ * Event handler for when generation stops or ends
+ * Re-applies checkpoint if SillyTavern unhid messages
+ */
+export async function onGenerationEnded() {
+    // console.log('[RPG Companion] 🏁 onGenerationEnded called');
+
+    // Note: isGenerating flag is cleared in onMessageReceived after parsing (together mode)
+    // or in apiClient.js after separate generation completes (separate mode)
+
+    // SillyTavern may auto-unhide messages when generation stops
+    // Re-apply checkpoint if one exists
+    await restoreCheckpointOnLoad();
+}
+
+/**
+ * Initialize history injection event listeners.
+ * Should be called once during extension initialization.
+ */
+export function initHistoryInjection() {
+    initHistoryInjectionListeners();
+}

src/systems/interaction/inventoryActions.js

@@ -39,15 +39,56 @@ let openForms = {
 
 /**
  * Updates lastGeneratedData.userStats AND committedTrackerData.userStats to include
- * current inventory in text format.
+ * current inventory.
+ * Maintains JSON format if current data is JSON, otherwise uses text format.
  * This ensures manual edits are immediately visible to AI in next generation.
  */
 function updateLastGeneratedDataInventory() {
-    // Rebuild the userStats text format using custom stat names
-    const statsText = buildUserStatsText();
+    // Check if current data is in JSON format
+    const currentData = lastGeneratedData.userStats || committedTrackerData.userStats;
+    if (currentData) {
+        const trimmed = currentData.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            // Maintain JSON format
+            try {
+                const jsonData = JSON.parse(currentData);
+                if (jsonData && typeof jsonData === 'object') {
+                    // Update inventory in JSON
+                    const stats = extensionSettings.userStats;
 
-    // Update BOTH lastGeneratedData AND committedTrackerData
-    // This makes manual edits immediately visible to AI
+                    // Convert inventory back to v3 format (arrays of {name, quantity})
+                    const convertToV3Items = (itemString) => {
+                        if (!itemString) return [];
+                        const items = itemString.split(',').map(s => s.trim()).filter(s => s);
+                        return items.map(item => {
+                            const qtyMatch = item.match(/^(\d+)x\s+(.+)$/);
+                            if (qtyMatch) {
+                                return { name: qtyMatch[2].trim(), quantity: parseInt(qtyMatch[1]) };
+                            }
+                            return { name: item, quantity: 1 };
+                        });
+                    };
+
+                    jsonData.inventory = {
+                        onPerson: convertToV3Items(stats.inventory.onPerson),
+                        clothing: convertToV3Items(stats.inventory.clothing),
+                        stored: stats.inventory.stored || {},
+                        assets: convertToV3Items(stats.inventory.assets)
+                    };
+
+                    const updatedJSON = JSON.stringify(jsonData, null, 2);
+                    lastGeneratedData.userStats = updatedJSON;
+                    committedTrackerData.userStats = updatedJSON;
+                    return;
+                }
+            } catch (e) {
+                console.warn('[RPG Companion] Failed to parse JSON, falling back to text format:', e);
+            }
+        }
+    }
+
+    // Fall back to text format
+    const statsText = buildUserStatsText();
     lastGeneratedData.userStats = statsText;
     committedTrackerData.userStats = statsText;
 }

src/systems/interaction/inventoryEdit.js

@@ -79,15 +79,58 @@ export function updateInventoryItem(field, index, newName, location) {
 
 /**
  * Updates lastGeneratedData.userStats AND committedTrackerData.userStats to include
- * current inventory in text format.
+ * current inventory.
+ * Maintains JSON format if current data is JSON, otherwise uses text format.
  * This ensures manual edits are immediately visible to AI in next generation.
  * @private
  */
 function updateLastGeneratedDataInventory() {
+    // Check if current data is in JSON format
+    const currentData = lastGeneratedData.userStats || committedTrackerData.userStats;
+    if (currentData) {
+        const trimmed = currentData.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            // Maintain JSON format
+            try {
+                const jsonData = JSON.parse(currentData);
+                if (jsonData && typeof jsonData === 'object') {
+                    // Update inventory in JSON
+                    const stats = extensionSettings.userStats;
+
+                    // Convert inventory back to v3 format (arrays of {name, quantity})
+                    const convertToV3Items = (itemString) => {
+                        if (!itemString) return [];
+                        const items = itemString.split(',').map(s => s.trim()).filter(s => s);
+                        return items.map(item => {
+                            const qtyMatch = item.match(/^(\d+)x\s+(.+)$/);
+                            if (qtyMatch) {
+                                return { name: qtyMatch[2].trim(), quantity: parseInt(qtyMatch[1]) };
+                            }
+                            return { name: item, quantity: 1 };
+                        });
+                    };
+
+                    jsonData.inventory = {
+                        onPerson: convertToV3Items(stats.inventory.onPerson),
+                        clothing: convertToV3Items(stats.inventory.clothing),
+                        stored: stats.inventory.stored || {},
+                        assets: convertToV3Items(stats.inventory.assets)
+                    };
+
+                    const updatedJSON = JSON.stringify(jsonData, null, 2);
+                    lastGeneratedData.userStats = updatedJSON;
+                    committedTrackerData.userStats = updatedJSON;
+                    return;
+                }
+            } catch (e) {
+                console.warn('[RPG Companion] Failed to parse JSON, falling back to text format:', e);
+            }
+        }
+    }
+
+    // Fall back to text format
     const stats = extensionSettings.userStats;
     const inventorySummary = buildInventorySummary(stats.inventory);
-
-    // Rebuild the userStats text format
     const statsText =
         `Health: ${stats.health}%\n` +
         `Satiety: ${stats.satiety}%\n` +
@@ -96,9 +139,6 @@ function updateLastGeneratedDataInventory() {
         `Arousal: ${stats.arousal}%\n` +
         `${stats.mood}: ${stats.conditions}\n` +
         `${inventorySummary}`;
-
-    // Update BOTH lastGeneratedData AND committedTrackerData
-    // This makes manual edits immediately visible to AI
     lastGeneratedData.userStats = statsText;
     committedTrackerData.userStats = statsText;
 }

src/systems/rendering/characterStateRenderer.js

@@ -1,373 +0,0 @@
-/**
- * Character State Rendering Module
- * Displays character state information in the UI
- */
-
-import { getCharacterState } from '../../core/characterState.js';
-
-/**
- * Renders the character's emotional state section
- * @param {Object} $container - jQuery container element
- */
-export function renderEmotionalState($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const charName = charState.characterName || 'Character';
-
-    let html = `<div class="rpg-character-emotions">`;
-    html += `<h4>${charName}'s Emotional State</h4>`;
-
-    // Get active emotional states (>10 intensity)
-    const activeEmotions = Object.entries(charState.secondaryStates)
-        .filter(([key, value]) => value > 10)
-        .sort((a, b) => b[1] - a[1]) // Sort by intensity
-        .slice(0, 8); // Show top 8
-
-    if (activeEmotions.length > 0) {
-        html += `<div class="rpg-emotion-list">`;
-        for (const [emotion, value] of activeEmotions) {
-            const emotionLabel = formatEmotionName(emotion);
-            const emotionColor = getEmotionColor(emotion, value);
-            const barWidth = value;
-
-            html += `<div class="rpg-emotion-item">`;
-            html += `<span class="rpg-emotion-label">${emotionLabel}</span>`;
-            html += `<div class="rpg-stat-bar-container">`;
-            html += `<div class="rpg-stat-bar" style="width: ${barWidth}%; background-color: ${emotionColor};"></div>`;
-            html += `</div>`;
-            html += `<span class="rpg-emotion-value">${value}</span>`;
-            html += `</div>`;
-        }
-        html += `</div>`;
-    } else {
-        html += `<p class="rpg-neutral-state">Emotionally neutral</p>`;
-    }
-
-    html += `</div>`;
-
-    $container.html(html);
-}
-
-/**
- * Renders the character's physical condition section
- * @param {Object} $container - jQuery container element
- */
-export function renderPhysicalCondition($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const stats = charState.physicalStats;
-
-    let html = `<div class="rpg-physical-condition">`;
-    html += `<h4>Physical Condition</h4>`;
-    html += `<div class="rpg-physical-stats">`;
-
-    const displayStats = [
-        { key: 'health', label: 'Health', icon: '❤️' },
-        { key: 'energy', label: 'Energy', icon: '⚡' },
-        { key: 'hunger', label: 'Hunger', icon: '🍽️' },
-        { key: 'arousal', label: 'Arousal', icon: '🔥' }
-    ];
-
-    for (const stat of displayStats) {
-        const value = stats[stat.key] !== undefined ? stats[stat.key] : 50;
-        const color = getStatColor(stat.key, value);
-
-        html += `<div class="rpg-physical-stat-item">`;
-        html += `<span class="rpg-stat-icon">${stat.icon}</span>`;
-        html += `<span class="rpg-stat-label">${stat.label}</span>`;
-        html += `<div class="rpg-stat-bar-container">`;
-        html += `<div class="rpg-stat-bar" style="width: ${value}%; background-color: ${color};"></div>`;
-        html += `</div>`;
-        html += `<span class="rpg-stat-value">${value}%</span>`;
-        html += `</div>`;
-    }
-
-    html += `</div>`;
-    html += `</div>`;
-
-    $container.html(html);
-}
-
-/**
- * Renders the character's relationships section
- * @param {Object} $container - jQuery container element
- */
-export function renderRelationships($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const charName = charState.characterName || 'Character';
-    const relationships = charState.relationships;
-
-    let html = `<div class="rpg-relationships">`;
-    html += `<h4>${charName}'s Relationships</h4>`;
-
-    const relationshipEntries = Object.entries(relationships);
-
-    if (relationshipEntries.length > 0) {
-        html += `<div class="rpg-relationship-list">`;
-
-        for (const [npcName, relData] of relationshipEntries) {
-            // Only show relationships with some significance
-            if (relData.trust < 20 && relData.love < 10 && relData.attraction < 10) {
-                continue;
-            }
-
-            html += `<div class="rpg-relationship-card">`;
-            html += `<div class="rpg-relationship-header">`;
-            html += `<strong>${npcName}</strong>`;
-            html += `<span class="rpg-relationship-status">${relData.relationshipStatus || 'Acquaintance'}</span>`;
-            html += `</div>`;
-
-            // Show key stats
-            html += `<div class="rpg-relationship-stats">`;
-            if (relData.trust > 20) {
-                html += `<span class="rpg-rel-stat">Trust: ${relData.trust}</span>`;
-            }
-            if (relData.love > 10) {
-                html += `<span class="rpg-rel-stat">Love: ${relData.love}❤️</span>`;
-            }
-            if (relData.attraction > 10) {
-                html += `<span class="rpg-rel-stat">Attraction: ${relData.attraction}✨</span>`;
-            }
-            html += `</div>`;
-
-            // Show current thoughts
-            if (relData.currentThoughts) {
-                html += `<div class="rpg-relationship-thoughts">`;
-                html += `<em>"${relData.currentThoughts}"</em>`;
-                html += `</div>`;
-            }
-
-            html += `</div>`;
-        }
-
-        html += `</div>`;
-    } else {
-        html += `<p class="rpg-no-relationships">No significant relationships yet</p>`;
-    }
-
-    html += `</div>`;
-
-    $container.html(html);
-}
-
-/**
- * Renders the character's internal thoughts section
- * @param {Object} $container - jQuery container element
- */
-export function renderInternalThoughts($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const charName = charState.characterName || 'Character';
-    const thoughts = charState.thoughts;
-
-    let html = `<div class="rpg-internal-thoughts">`;
-    html += `<h4>${charName}'s Thoughts</h4>`;
-
-    if (thoughts.internalMonologue) {
-        html += `<div class="rpg-thought-bubble">`;
-        html += `<p>"${thoughts.internalMonologue}"</p>`;
-        html += `</div>`;
-    } else {
-        html += `<p class="rpg-no-thoughts"><em>No current thoughts</em></p>`;
-    }
-
-    html += `</div>`;
-
-    $container.html(html);
-}
-
-/**
- * Renders the character's current context (location, time, etc.)
- * @param {Object} $container - jQuery container element
- */
-export function renderContext($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const context = charState.contextInfo;
-
-    let html = `<div class="rpg-context">`;
-    html += `<h4>Current Scene</h4>`;
-    html += `<div class="rpg-context-info">`;
-
-    if (context.location) {
-        html += `<div class="rpg-context-item">`;
-        html += `<span class="rpg-context-icon">📍</span>`;
-        html += `<span class="rpg-context-label">Location:</span>`;
-        html += `<span class="rpg-context-value">${context.location}</span>`;
-        html += `</div>`;
-    }
-
-    if (context.timeOfDay) {
-        html += `<div class="rpg-context-item">`;
-        html += `<span class="rpg-context-icon">🕐</span>`;
-        html += `<span class="rpg-context-label">Time:</span>`;
-        html += `<span class="rpg-context-value">${context.timeOfDay}</span>`;
-        html += `</div>`;
-    }
-
-    if (context.presentCharacters && context.presentCharacters.length > 0) {
-        html += `<div class="rpg-context-item">`;
-        html += `<span class="rpg-context-icon">👥</span>`;
-        html += `<span class="rpg-context-label">Present:</span>`;
-        html += `<span class="rpg-context-value">${context.presentCharacters.join(', ')}</span>`;
-        html += `</div>`;
-    }
-
-    html += `</div>`;
-    html += `</div>`;
-
-    $container.html(html);
-}
-
-/**
- * Renders a comprehensive character state overview
- * @param {Object} $container - jQuery container element
- */
-export function renderCharacterStateOverview($container) {
-    if (!$container || !$container.length) return;
-
-    const charState = getCharacterState();
-    const charName = charState.characterName || 'Character';
-
-    let html = `<div class="rpg-character-overview">`;
-    html += `<h3>📊 ${charName}'s State</h3>`;
-
-    // Create tabbed sections
-    html += `<div class="rpg-character-tabs">`;
-    html += `<button class="rpg-tab-btn active" data-tab="emotions">Emotions</button>`;
-    html += `<button class="rpg-tab-btn" data-tab="physical">Physical</button>`;
-    html += `<button class="rpg-tab-btn" data-tab="relationships">Relationships</button>`;
-    html += `<button class="rpg-tab-btn" data-tab="thoughts">Thoughts</button>`;
-    html += `<button class="rpg-tab-btn" data-tab="context">Context</button>`;
-    html += `</div>`;
-
-    // Tab contents
-    html += `<div class="rpg-tab-content">`;
-    html += `<div id="rpg-tab-emotions" class="rpg-tab-pane active"></div>`;
-    html += `<div id="rpg-tab-physical" class="rpg-tab-pane"></div>`;
-    html += `<div id="rpg-tab-relationships" class="rpg-tab-pane"></div>`;
-    html += `<div id="rpg-tab-thoughts" class="rpg-tab-pane"></div>`;
-    html += `<div id="rpg-tab-context" class="rpg-tab-pane"></div>`;
-    html += `</div>`;
-
-    html += `</div>`;
-
-    $container.html(html);
-
-    // Render individual sections
-    renderEmotionalState($('#rpg-tab-emotions'));
-    renderPhysicalCondition($('#rpg-tab-physical'));
-    renderRelationships($('#rpg-tab-relationships'));
-    renderInternalThoughts($('#rpg-tab-thoughts'));
-    renderContext($('#rpg-tab-context'));
-
-    // Set up tab switching
-    setupTabs();
-}
-
-/**
- * Sets up tab switching functionality
- */
-function setupTabs() {
-    $('.rpg-tab-btn').off('click').on('click', function() {
-        const tabName = $(this).data('tab');
-
-        // Update active button
-        $('.rpg-tab-btn').removeClass('active');
-        $(this).addClass('active');
-
-        // Update active pane
-        $('.rpg-tab-pane').removeClass('active');
-        $(`#rpg-tab-${tabName}`).addClass('active');
-    });
-}
-
-/**
- * Helper function to format emotion names for display
- * @param {string} emotion - Raw emotion key
- * @returns {string} Formatted emotion name
- */
-function formatEmotionName(emotion) {
-    // Convert camelCase to Title Case
-    return emotion
-        .replace(/([A-Z])/g, ' $1')
-        .replace(/^./, str => str.toUpperCase())
-        .trim();
-}
-
-/**
- * Helper function to get color for an emotion based on its type and intensity
- * @param {string} emotion - Emotion type
- * @param {number} value - Emotion intensity (0-100)
- * @returns {string} CSS color
- */
-function getEmotionColor(emotion, value) {
-    const intensity = value / 100;
-
-    // Color mappings for different emotions
-    const emotionColors = {
-        happy: `rgba(76, 175, 80, ${0.5 + intensity * 0.5})`, // Green
-        sad: `rgba(96, 125, 139, ${0.5 + intensity * 0.5})`, // Blue-grey
-        angry: `rgba(244, 67, 54, ${0.5 + intensity * 0.5})`, // Red
-        anxious: `rgba(255, 152, 0, ${0.5 + intensity * 0.5})`, // Orange
-        horny: `rgba(233, 30, 99, ${0.5 + intensity * 0.5})`, // Pink
-        confident: `rgba(63, 81, 181, ${0.5 + intensity * 0.5})`, // Indigo
-        scared: `rgba(121, 85, 72, ${0.5 + intensity * 0.5})`, // Brown
-        playful: `rgba(255, 193, 7, ${0.5 + intensity * 0.5})` // Amber
-    };
-
-    return emotionColors[emotion] || `rgba(158, 158, 158, ${0.5 + intensity * 0.5})`;
-}
-
-/**
- * Helper function to get color for a physical stat
- * @param {string} statKey - Stat key
- * @param {number} value - Stat value (0-100)
- * @returns {string} CSS color
- */
-function getStatColor(statKey, value) {
-    // For most stats, green is high, red is low
-    // For hunger and arousal, yellow/orange might be more appropriate
-
-    if (statKey === 'hunger') {
-        if (value < 30) return '#4CAF50'; // Green (not hungry)
-        if (value < 60) return '#FFC107'; // Yellow (getting hungry)
-        return '#F44336'; // Red (very hungry)
-    }
-
-    if (statKey === 'arousal') {
-        if (value < 30) return '#9E9E9E'; // Grey (low)
-        if (value < 70) return '#E91E63'; // Pink (moderate)
-        return '#880E4F'; // Dark pink (high)
-    }
-
-    // Default: green for high, red for low
-    if (value > 70) return '#4CAF50'; // Green
-    if (value > 40) return '#FFC107'; // Yellow
-    return '#F44336'; // Red
-}
-
-/**
- * Updates character state display
- * Call this after parsing an LLM response to update the UI
- */
-export function updateCharacterStateDisplay() {
-    console.log('[Character State Renderer] 🎭 updateCharacterStateDisplay called');
-
-    // Find the main container
-    const $mainContainer = $('#rpg-character-state-container');
-    console.log('[Character State Renderer] Container found:', $mainContainer && $mainContainer.length > 0);
-
-    if ($mainContainer && $mainContainer.length) {
-        console.log('[Character State Renderer] ✅ Rendering character state overview');
-        renderCharacterStateOverview($mainContainer);
-    } else {
-        console.warn('[Character State Renderer] ❌ Container #rpg-character-state-container not found in DOM');
-    }
-}

src/systems/rendering/infoBox.js

@@ -12,6 +12,26 @@ import {
 } from '../../core/state.js';
 import { saveChatData } from '../../core/persistence.js';
 import { i18n } from '../../core/i18n.js';
+import { isItemLocked } from '../generation/lockManager.js';
+import { repairJSON } from '../../utils/jsonRepair.js';
+import { updateFabWidgets } from '../ui/mobile.js';
+
+/**
+ * Helper to generate lock icon HTML if setting is enabled
+ * @param {string} tracker - Tracker name
+ * @param {string} path - Item path
+ * @returns {string} Lock icon HTML or empty string
+ */
+function getLockIconHtml(tracker, path) {
+    const showLockIcons = extensionSettings.showLockIcons ?? true;
+    if (!showLockIcons) return '';
+
+    const isLocked = isItemLocked(tracker, path);
+    const lockIcon = isLocked ? '🔒' : '🔓';
+    const lockTitle = isLocked ? 'Locked' : 'Unlocked';
+    const lockedClass = isLocked ? ' locked' : '';
+    return `<span class="rpg-section-lock-icon${lockedClass}" data-tracker="${tracker}" data-path="${path}" title="${lockTitle}">${lockIcon}</span>`;
+}
 
 /**
  * Helper to separate emoji from text in a string
@@ -56,41 +76,36 @@ function separateEmojiFromText(str) {
  * Includes event listeners for editable fields.
  */
 export function renderInfoBox() {
-    if (!extensionSettings.showInfoBox || !$infoBoxContainer) {
-        return;
-    }
+    // console.log('[RPG InfoBox Render] ==================== RENDERING INFO BOX ====================');
+    // console.log('[RPG InfoBox Render] showInfoBox setting:', extensionSettings.showInfoBox);
+    // console.log('[RPG InfoBox Render] Container exists:', !!$infoBoxContainer);
 
-    // Add updating class for animation
-    if (extensionSettings.enableAnimations) {
-        $infoBoxContainer.addClass('rpg-content-updating');
+    if (!extensionSettings.showInfoBox || !$infoBoxContainer) {
+        // console.log('[RPG InfoBox Render] Exiting: showInfoBox or container is false');
+        return;
     }
 
     // Use committedTrackerData as fallback if lastGeneratedData is empty (e.g., after page refresh)
     const infoBoxData = lastGeneratedData.infoBox || committedTrackerData.infoBox;
+    // console.log('[RPG InfoBox Render] infoBoxData length:', infoBoxData ? infoBoxData.length : 'null');
+    // console.log('[RPG InfoBox Render] infoBoxData preview:', infoBoxData ? infoBoxData.substring(0, 200) : 'null');
 
-    // If no data yet, show placeholder
+    // If no data yet, hide the container (e.g., after cache clear)
     if (!infoBoxData) {
-        const placeholderHtml = `
-            <div class="rpg-dashboard rpg-dashboard-row-1">
-                <div class="rpg-dashboard-widget rpg-placeholder-widget">
-                    <div class="rpg-placeholder-text" data-i18n-key="infobox.noData.title">${i18n.getTranslation('infobox.noData.title')}</div>
-                    <div class="rpg-placeholder-hint" data-i18n-key="infobox.noData.instruction">${i18n.getTranslation('infobox.noData.instruction')}</div>
-                </div>
-            </div>
-        `;
-        $infoBoxContainer.html(placeholderHtml);
-        if (extensionSettings.enableAnimations) {
-            setTimeout(() => $infoBoxContainer.removeClass('rpg-content-updating'), 500);
-        }
+        // console.log('[RPG InfoBox Render] No data, hiding container');
+        $infoBoxContainer.empty().hide();
         return;
     }
 
+    // Show container and add updating class for animation
+    $infoBoxContainer.show();
+    if (extensionSettings.enableAnimations) {
+        $infoBoxContainer.addClass('rpg-content-updating');
+    }
+
     // console.log('[RPG Companion] renderInfoBox called with data:', infoBoxData);
 
-    // Parse the info box data
-    const lines = infoBoxData.split('\n');
-    // console.log('[RPG Companion] Info Box split into lines:', lines);
-    const data = {
+    let data = {
         date: '',
         weekday: '',
         month: '',
@@ -105,6 +120,45 @@ export function renderInfoBox() {
         characters: []
     };
 
+    // Check if data is v3 JSON format
+    const trimmed = infoBoxData.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        const jsonData = repairJSON(infoBoxData);
+        if (jsonData) {
+            // Extract from v3 JSON structure
+            data.weatherEmoji = jsonData.weather?.emoji || '';
+            data.weatherForecast = jsonData.weather?.forecast || '';
+            data.temperature = jsonData.temperature ? `${jsonData.temperature.value}°${jsonData.temperature.unit}` : '';
+            data.tempValue = jsonData.temperature?.value || 0;
+            data.timeStart = jsonData.time?.start || '';
+            data.timeEnd = jsonData.time?.end || '';
+            data.location = jsonData.location?.value || '';
+
+            // Parse date string to extract weekday, month, year
+            if (jsonData.date?.value) {
+                data.date = jsonData.date.value;
+                // Expected format: "Tuesday, October 17th, 2023"
+                const dateParts = data.date.split(',').map(p => p.trim());
+                data.weekday = dateParts[0] || '';
+                data.month = dateParts[1] || '';
+                data.year = dateParts[2] || '';
+            }
+
+            // Skip to rendering
+        } else {
+            // JSON parsing failed, fall back to text parsing
+            parseTextFormat();
+        }
+    } else {
+        // Text format
+        parseTextFormat();
+    }
+
+    function parseTextFormat() {
+        // Parse the info box data
+        const lines = infoBoxData.split('\n');
+        // console.log('[RPG Companion] Info Box split into lines:', lines);
+
     // Track which fields we've already parsed to avoid duplicates from mixed formats
     const parsedFields = {
         date: false,
@@ -205,10 +259,10 @@ export function renderInfoBox() {
                     data.weatherEmoji = emoji;
                     data.weatherForecast = text;
                 } else if (weatherStr.includes(',')) {
-                    // Fallback to comma split if emoji detection failed
-                    const weatherParts = weatherStr.split(',').map(p => p.trim());
-                    data.weatherEmoji = weatherParts[0] || '';
-                    data.weatherForecast = weatherParts[1] || '';
+                    // Fallback to comma split if emoji detection failed - split only on FIRST comma
+                    const firstCommaIndex = weatherStr.indexOf(',');
+                    data.weatherEmoji = weatherStr.substring(0, firstCommaIndex).trim();
+                    data.weatherForecast = weatherStr.substring(firstCommaIndex + 1).trim();
                 } else {
                     // No clear separation - assume it's all forecast text
                     data.weatherEmoji = '🌤️'; // Default emoji
@@ -270,6 +324,7 @@ export function renderInfoBox() {
     //     timeStart: data.timeStart,
     //     location: data.location
     // });
+    }
 
     // Get tracker configuration
     const config = extensionSettings.trackerConfig?.infoBox;
@@ -303,10 +358,13 @@ export function renderInfoBox() {
             weekdayDisplay = weekdayDisplay;
         }
 
+        const dateLockIconHtml = getLockIconHtml('infoBox', 'date');
+
         row1Widgets.push(`
             <div class="rpg-dashboard-widget rpg-calendar-widget">
+                ${dateLockIconHtml}
                 <div class="rpg-calendar-top rpg-editable" contenteditable="true" data-field="month" data-full-value="${data.month || ''}" title="Click to edit">${monthDisplay}</div>
-                <div class="rpg-calendar-day rpg-editable" contenteditable="true" data-field="weekday" data-full-value="${data.weekday || ''}" title="Click to edit">${weekdayDisplay}</div>
+                <div class="rpg-calendar-day" title="Click to edit"><span class="rpg-calendar-day-text rpg-editable" contenteditable="true" data-field="weekday" data-full-value="${data.weekday || ''}">${weekdayDisplay}</span></div>
                 <div class="rpg-calendar-year rpg-editable" contenteditable="true" data-field="year" data-full-value="${data.year || ''}" title="Click to edit">${yearDisplay}</div>
             </div>
         `);
@@ -316,8 +374,11 @@ export function renderInfoBox() {
     if (config?.widgets?.weather?.enabled) {
         const weatherEmoji = data.weatherEmoji || '🌤️';
         const weatherForecast = data.weatherForecast || 'Weather';
+        const weatherLockIconHtml = getLockIconHtml('infoBox', 'weather');
+
         row1Widgets.push(`
             <div class="rpg-dashboard-widget rpg-weather-widget">
+                ${weatherLockIconHtml}
                 <div class="rpg-weather-icon rpg-editable" contenteditable="true" data-field="weatherEmoji" title="Click to edit emoji">${weatherEmoji}</div>
                 <div class="rpg-weather-forecast rpg-editable" contenteditable="true" data-field="weatherForecast" title="Click to edit">${weatherForecast}</div>
             </div>
@@ -357,8 +418,11 @@ export function renderInfoBox() {
         const tempInCelsius = preferredUnit === 'F' ? Math.round((tempValue - 32) * 5/9) : tempValue;
         const tempPercent = Math.min(100, Math.max(0, ((tempInCelsius + 20) / 60) * 100));
         const tempColor = tempInCelsius < 10 ? '#4a90e2' : tempInCelsius < 25 ? '#67c23a' : '#e94560';
+        const tempLockIconHtml = getLockIconHtml('infoBox', 'temperature');
+
         row1Widgets.push(`
             <div class="rpg-dashboard-widget rpg-temp-widget">
+                ${tempLockIconHtml}
                 <div class="rpg-thermometer">
                     <div class="rpg-thermometer-bulb"></div>
                     <div class="rpg-thermometer-tube">
@@ -372,9 +436,12 @@ export function renderInfoBox() {
 
     // Time widget - show if enabled
     if (config?.widgets?.time?.enabled) {
-        const timeDisplay = data.timeEnd || data.timeStart || '12:00';
-        // Parse time for clock hands
-        const timeMatch = timeDisplay.match(/(\d+):(\d+)/);
+        // Get both start and end times
+        const timeStartDisplay = data.timeStart || '12:00';
+        const timeEndDisplay = data.timeEnd || data.timeStart || '12:00';
+
+        // Parse end time for clock hands (use end time for visual display)
+        const timeMatch = timeEndDisplay.match(/(\d+):(\d+)/);
         let hourAngle = 0;
         let minuteAngle = 0;
         if (timeMatch) {
@@ -383,8 +450,12 @@ export function renderInfoBox() {
             hourAngle = (hours % 12) * 30 + minutes * 0.5; // 30° per hour + 0.5° per minute
             minuteAngle = minutes * 6; // 6° per minute
         }
+
+        const timeLockIconHtml = getLockIconHtml('infoBox', 'time');
+
         row1Widgets.push(`
             <div class="rpg-dashboard-widget rpg-clock-widget">
+                ${timeLockIconHtml}
                 <div class="rpg-clock">
                     <div class="rpg-clock-face">
                         <div class="rpg-clock-hour" style="transform: rotate(${hourAngle}deg)"></div>
@@ -392,7 +463,11 @@ export function renderInfoBox() {
                         <div class="rpg-clock-center"></div>
                     </div>
                 </div>
-                <div class="rpg-time-value rpg-editable" contenteditable="true" data-field="timeStart" title="Click to edit">${timeDisplay}</div>
+                <div class="rpg-time-range">
+                    <div class="rpg-time-value rpg-editable" contenteditable="true" data-field="timeStart" title="Click to edit start time">${timeStartDisplay}</div>
+                    <span class="rpg-time-separator">→</span>
+                    <div class="rpg-time-value rpg-editable" contenteditable="true" data-field="timeEnd" title="Click to edit end time">${timeEndDisplay}</div>
+                </div>
             </div>
         `);
     }
@@ -407,9 +482,12 @@ export function renderInfoBox() {
     // Row 2: Location widget (full width) - show if enabled
     if (config?.widgets?.location?.enabled) {
         const locationDisplay = data.location || 'Location';
+        const locationLockIconHtml = getLockIconHtml('infoBox', 'location');
+
         html += `
             <div class="rpg-dashboard rpg-dashboard-row-2">
                 <div class="rpg-dashboard-widget rpg-location-widget">
+                    ${locationLockIconHtml}
                     <div class="rpg-map-bg">
                         <div class="rpg-map-marker">📍</div>
                     </div>
@@ -421,14 +499,26 @@ export function renderInfoBox() {
 
     // Row 3: Recent Events widget (notebook style) - show if enabled
     if (config?.widgets?.recentEvents?.enabled) {
-        // Parse Recent Events from infoBox string
+        // Parse Recent Events from infoBox (supports both JSON and text formats)
         let recentEvents = [];
-        if (committedTrackerData.infoBox) {
-            const recentEventsLine = committedTrackerData.infoBox.split('\n').find(line => line.startsWith('Recent Events:'));
-            if (recentEventsLine) {
-                const eventsString = recentEventsLine.replace('Recent Events:', '').trim();
-                if (eventsString) {
-                    recentEvents = eventsString.split(',').map(e => e.trim()).filter(e => e);
+        if (infoBoxData) {
+            // Try JSON format first
+            try {
+                const parsed = typeof infoBoxData === 'string'
+                    ? JSON.parse(infoBoxData)
+                    : infoBoxData;
+
+                if (parsed && Array.isArray(parsed.recentEvents)) {
+                    recentEvents = parsed.recentEvents;
+                }
+            } catch (e) {
+                // Fall back to old text format
+                const recentEventsLine = infoBoxData.split('\n').find(line => line.startsWith('Recent Events:'));
+                if (recentEventsLine) {
+                    const eventsString = recentEventsLine.replace('Recent Events:', '').trim();
+                    if (eventsString) {
+                        recentEvents = eventsString.split(',').map(e => e.trim()).filter(e => e);
+                    }
                 }
             }
         }
@@ -440,9 +530,12 @@ export function renderInfoBox() {
             validEvents.push('Click to add event');
         }
 
+        const eventsLockIconHtml = getLockIconHtml('infoBox', 'recentEvents');
+
         html += `
             <div class="rpg-dashboard rpg-dashboard-row-3">
                 <div class="rpg-dashboard-widget rpg-events-widget">
+                    ${eventsLockIconHtml}
                     <div class="rpg-notebook-header">
                         <div class="rpg-notebook-ring"></div>
                         <div class="rpg-notebook-ring"></div>
@@ -484,6 +577,19 @@ export function renderInfoBox() {
 
     $infoBoxContainer.html(html);
 
+    // Add dynamic text scaling for location field
+    const updateLocationTextSize = ($element) => {
+        const text = $element.text();
+        const charCount = text.length;
+        $element.css('--char-count', Math.min(charCount, 100));
+    };
+
+    // Initial size update for location
+    const $locationText = $infoBoxContainer.find('[data-field="location"]');
+    if ($locationText.length) {
+        updateLocationTextSize($locationText);
+    }
+
     // Add event handlers for editable Info Box fields
     $infoBoxContainer.find('.rpg-editable').on('blur', function() {
         const $this = $(this);
@@ -501,12 +607,25 @@ export function renderInfoBox() {
             }
         }
 
+        // Update location text size dynamically
+        if (field === 'location') {
+            updateLocationTextSize($this);
+        }
+
         // Handle recent events separately
         if (field === 'event1' || field === 'event2' || field === 'event3') {
             updateRecentEvent(field, value);
         } else {
             updateInfoBoxField(field, value);
         }
+
+        // Update FAB widgets to reflect changes
+        updateFabWidgets();
+    });
+
+    // Update location size on input as well (real-time)
+    $infoBoxContainer.find('[data-field="location"]').on('input', function() {
+        updateLocationTextSize($(this));
     });
 
     // For date fields, show full value on focus
@@ -517,10 +636,39 @@ export function renderInfoBox() {
         }
     });
 
+    // Add event handler for lock icons (support both click and touch)
+    $infoBoxContainer.find('.rpg-section-lock-icon').on('click touchend', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        const $lockIcon = $(this);
+        const tracker = $lockIcon.data('tracker');
+        const path = $lockIcon.data('path');
+
+        // Import lockManager dynamically to avoid circular dependencies
+        import('../generation/lockManager.js').then(({ setItemLock, isItemLocked }) => {
+            const isLocked = isItemLocked(tracker, path);
+            const newLockState = !isLocked;
+            setItemLock(tracker, path, newLockState);
+
+            // Update icon
+            $lockIcon.text(newLockState ? '🔒' : '🔓');
+            $lockIcon.attr('title', newLockState ? 'Locked - AI cannot change this' : 'Unlocked - AI can change this');
+            $lockIcon.toggleClass('locked', newLockState);
+
+            // Save settings to persist lock state
+            saveSettings();
+        });
+    });
+
     // Remove updating class after animation
     if (extensionSettings.enableAnimations) {
         setTimeout(() => $infoBoxContainer.removeClass('rpg-content-updating'), 500);
     }
+
+    // Update weather effect after rendering
+    if (window.RPGCompanion?.updateWeatherEffect) {
+        window.RPGCompanion.updateWeatherEffect();
+    }
 }
 
 /**
@@ -536,6 +684,64 @@ export function updateInfoBoxField(field, value) {
         lastGeneratedData.infoBox = 'Info Box\n---\n';
     }
 
+    // Check if data is in v3 JSON format
+    const trimmed = lastGeneratedData.infoBox.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        // Handle v3 JSON format
+        const jsonData = repairJSON(lastGeneratedData.infoBox);
+        if (jsonData) {
+            // Update the appropriate field based on v3 structure
+            if (field === 'weatherEmoji') {
+                if (!jsonData.weather) jsonData.weather = {};
+                jsonData.weather.emoji = value;
+            } else if (field === 'weatherForecast') {
+                if (!jsonData.weather) jsonData.weather = {};
+                jsonData.weather.forecast = value;
+            } else if (field === 'temperature') {
+                // Parse temperature value and unit
+                const tempMatch = value.match(/(-?\d+)\s*°?\s*([CF]?)/i);
+                if (tempMatch) {
+                    if (!jsonData.temperature) jsonData.temperature = {};
+                    jsonData.temperature.value = parseInt(tempMatch[1]);
+                    jsonData.temperature.unit = (tempMatch[2] || 'C').toUpperCase();
+                }
+            } else if (field === 'timeStart') {
+                if (!jsonData.time) jsonData.time = {};
+                jsonData.time.start = value;
+            } else if (field === 'timeEnd') {
+                if (!jsonData.time) jsonData.time = {};
+                jsonData.time.end = value;
+            } else if (field === 'location') {
+                if (!jsonData.location) jsonData.location = {};
+                jsonData.location.value = value;
+            } else if (field === 'weekday' || field === 'month' || field === 'year') {
+                // Update date components
+                if (!jsonData.date) jsonData.date = {};
+                let currentDate = jsonData.date.value || '';
+                const dateParts = currentDate.split(',').map(p => p.trim());
+
+                if (field === 'weekday') {
+                    dateParts[0] = value;
+                } else if (field === 'month') {
+                    dateParts[1] = value;
+                } else if (field === 'year') {
+                    dateParts[2] = value;
+                }
+
+                jsonData.date.value = dateParts.filter(p => p).join(', ');
+            }
+
+            // Save back as JSON
+            lastGeneratedData.infoBox = JSON.stringify(jsonData, null, 2);
+            committedTrackerData.infoBox = lastGeneratedData.infoBox;
+            saveChatData();
+            renderInfoBox();
+            // console.log('[RPG Companion] Updated info box field (v3 JSON):', { field, value });
+            return;
+        }
+    }
+
+    // Fall back to text format handling
     // Reconstruct the Info Box text with updated field
     const lines = lastGeneratedData.infoBox.split('\n');
     let dateLineFound = false;
@@ -608,14 +814,16 @@ export function updateInfoBoxField(field, value) {
             if (line.startsWith('Weather:')) {
                 // New format: Weather: emoji, forecast
                 const weatherContent = line.replace('Weather:', '').trim();
-                const parts = weatherContent.split(',').map(p => p.trim());
-                const forecast = parts[1] || 'Weather';
+                // Split only on first comma to get emoji and rest
+                const firstCommaIndex = weatherContent.indexOf(',');
+                const forecast = firstCommaIndex > 0 ? weatherContent.substring(firstCommaIndex + 1).trim() : 'Weather';
                 return `Weather: ${value}, ${forecast}`;
             } else {
                 // Legacy format: emoji: forecast
-                const parts = line.split(':');
-                if (parts.length >= 2) {
-                    return `${value}: ${parts.slice(1).join(':').trim()}`;
+                const firstColonIndex = line.indexOf(':');
+                if (firstColonIndex >= 0) {
+                    const forecast = line.substring(firstColonIndex + 1).trim();
+                    return `${value}: ${forecast}`;
                 }
             }
         } else if (field === 'weatherForecast' && index === weatherLineIndex) {
@@ -623,14 +831,16 @@ export function updateInfoBoxField(field, value) {
             if (line.startsWith('Weather:')) {
                 // New format: Weather: emoji, forecast
                 const weatherContent = line.replace('Weather:', '').trim();
-                const parts = weatherContent.split(',').map(p => p.trim());
-                const emoji = parts[0] || '🌤️';
+                // Split only on first comma to get emoji and rest
+                const firstCommaIndex = weatherContent.indexOf(',');
+                const emoji = firstCommaIndex > 0 ? weatherContent.substring(0, firstCommaIndex).trim() : '🌤️';
                 return `Weather: ${emoji}, ${value}`;
             } else {
                 // Legacy format: emoji: forecast
-                const parts = line.split(':');
-                if (parts.length >= 2) {
-                    return `${parts[0].trim()}: ${value}`;
+                const firstColonIndex = line.indexOf(':');
+                if (firstColonIndex >= 0) {
+                    const emoji = line.substring(0, firstColonIndex).trim();
+                    return `${emoji}: ${value}`;
                 }
             }
         } else if (field === 'temperature' && (line.includes('🌡️:') || line.startsWith('Temperature:'))) {
@@ -874,6 +1084,12 @@ function updateRecentEvent(field, value) {
 
         saveChatData();
         renderInfoBox();
-        console.log(`[RPG Companion] Updated recent event ${field}:`, value);
+
+        // Update weather effect after rendering
+        if (window.RPGCompanion?.updateWeatherEffect) {
+            window.RPGCompanion.updateWeatherEffect();
+        }
+
+        // console.log(`[RPG Companion] Updated recent event ${field}:`, value);
     }
 }

src/systems/rendering/inventory.js

@@ -4,14 +4,32 @@
  */
 
 import { extensionSettings, $inventoryContainer } from '../../core/state.js';
+import { saveSettings } from '../../core/persistence.js';
 import { getInventoryRenderOptions, restoreFormStates } from '../interaction/inventoryActions.js';
 import { updateInventoryItem } from '../interaction/inventoryEdit.js';
 import { parseItems } from '../../utils/itemParser.js';
-import { i18n } from '../../core/i18n.js';
+import { isItemLocked, setItemLock } from '../generation/lockManager.js';
 
 // Type imports
 /** @typedef {import('../../types/inventory.js').InventoryV2} InventoryV2 */
 
+/**
+ * Helper to generate lock icon HTML if setting is enabled
+ * @param {string} tracker - Tracker name
+ * @param {string} path - Item path
+ * @returns {string} Lock icon HTML or empty string
+ */
+function getLockIconHtml(tracker, path) {
+    const showLockIcons = extensionSettings.showLockIcons ?? true;
+    if (!showLockIcons) return '';
+
+    const isLocked = isItemLocked(tracker, path);
+    const lockIcon = isLocked ? '🔒' : '🔓';
+    const lockTitle = isLocked ? 'Locked' : 'Unlocked';
+    const lockedClass = isLocked ? ' locked' : '';
+    return `<span class="rpg-section-lock-icon${lockedClass}" data-tracker="${tracker}" data-path="${path}" title="${lockTitle}">${lockIcon}</span>`;
+}
+
 /**
  * Converts a location name to a safe ID for use in HTML element IDs.
  * Must match the logic used in inventoryActions.js.
@@ -24,21 +42,24 @@ export function getLocationId(locationName) {
 }
 
 /**
- * Renders the inventory sub-tab navigation (On Person, Stored, Assets)
- * @param {string} activeTab - Currently active sub-tab ('onPerson', 'stored', 'assets')
+ * Renders the inventory sub-tab navigation (On Person, Clothing, Stored, Assets)
+ * @param {string} activeTab - Currently active sub-tab ('onPerson', 'clothing', 'stored', 'assets')
  * @returns {string} HTML for sub-tab navigation
  */
 export function renderInventorySubTabs(activeTab = 'onPerson') {
     return `
         <div class="rpg-inventory-subtabs">
-            <button class="rpg-inventory-subtab ${activeTab === 'onPerson' ? 'active' : ''}" data-tab="onPerson" data-i18n-key="inventory.section.onPerson">
-                ${i18n.getTranslation('inventory.section.onPerson')}
+            <button class="rpg-inventory-subtab ${activeTab === 'onPerson' ? 'active' : ''}" data-tab="onPerson">
+                On Person
             </button>
-            <button class="rpg-inventory-subtab ${activeTab === 'stored' ? 'active' : ''}" data-tab="stored" data-i18n-key="inventory.section.stored">
-                ${i18n.getTranslation('inventory.section.stored')}
+            <button class="rpg-inventory-subtab ${activeTab === 'clothing' ? 'active' : ''}" data-tab="clothing">
+                Clothing
             </button>
-            <button class="rpg-inventory-subtab ${activeTab === 'assets' ? 'active' : ''}" data-tab="assets" data-i18n-key="inventory.section.assets">
-                ${i18n.getTranslation('inventory.section.assets')}
+            <button class="rpg-inventory-subtab ${activeTab === 'stored' ? 'active' : ''}" data-tab="stored">
+                Stored
+            </button>
+            <button class="rpg-inventory-subtab ${activeTab === 'assets' ? 'active' : ''}" data-tab="assets">
+                Assets
             </button>
         </div>
     `;
@@ -55,28 +76,34 @@ export function renderOnPersonView(onPersonItems, viewMode = 'list') {
 
     let itemsHtml = '';
     if (items.length === 0) {
-        itemsHtml = `<div class="rpg-inventory-empty" data-i18n-key="inventory.onPerson.empty">${i18n.getTranslation('inventory.onPerson.empty')}</div>`;
+        itemsHtml = '<div class="rpg-inventory-empty">No items carried</div>';
     } else {
         if (viewMode === 'grid') {
             // Grid view: card-style items
-            itemsHtml = items.map((item, index) => `
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.onPerson.${item}`);
+                return `
                 <div class="rpg-item-card" data-field="onPerson" data-index="${index}">
+                    ${lockIconHtml}
                     <button class="rpg-item-remove" data-action="remove-item" data-field="onPerson" data-index="${index}" title="Remove item">
                         <i class="fa-solid fa-times"></i>
                     </button>
                     <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="onPerson" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
                 </div>
-            `).join('');
+            `}).join('');
         } else {
             // List view: full-width rows
-            itemsHtml = items.map((item, index) => `
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.onPerson.${item}`);
+                return `
                 <div class="rpg-item-row" data-field="onPerson" data-index="${index}">
+                    ${lockIconHtml}
                     <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="onPerson" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
                     <button class="rpg-item-remove" data-action="remove-item" data-field="onPerson" data-index="${index}" title="Remove item">
                         <i class="fa-solid fa-times"></i>
                     </button>
                 </div>
-            `).join('');
+            `}).join('');
         }
     }
 
@@ -85,30 +112,112 @@ export function renderOnPersonView(onPersonItems, viewMode = 'list') {
     return `
         <div class="rpg-inventory-section" data-section="onPerson">
             <div class="rpg-inventory-header">
-                <h4 data-i18n-key="inventory.onPerson.title">${i18n.getTranslation('inventory.onPerson.title')}</h4>
+                <h4>Items Currently Carried</h4>
                 <div class="rpg-inventory-header-actions">
                     <div class="rpg-view-toggle">
-                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="onPerson" data-view="list" title="${i18n.getTranslation('global.listView')}">
+                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="onPerson" data-view="list" title="List view">
                             <i class="fa-solid fa-list"></i>
                         </button>
-                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="onPerson" data-view="grid" title="${i18n.getTranslation('global.gridView')}">
+                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="onPerson" data-view="grid" title="Grid view">
                             <i class="fa-solid fa-th"></i>
                         </button>
                     </div>
                     <button class="rpg-inventory-add-btn" data-action="add-item" data-field="onPerson" title="Add new item">
-                        <i class="fa-solid fa-plus"></i> <span data-i18n-key="inventory.onPerson.addItemButton">${i18n.getTranslation('inventory.onPerson.addItemButton')}</span>
+                        <i class="fa-solid fa-plus"></i> Add Item
                     </button>
                 </div>
             </div>
             <div class="rpg-inventory-content">
                 <div class="rpg-inline-form" id="rpg-add-item-form-onPerson" style="display: none;">
-                    <input type="text" class="rpg-inline-input" id="rpg-new-item-onPerson" placeholder="${i18n.getTranslation('inventory.onPerson.addItemPlaceholder')}" data-i18n-placeholder-key="inventory.onPerson.addItemPlaceholder" />
+                    <input type="text" class="rpg-inline-input" id="rpg-new-item-onPerson" placeholder="Enter item name..." />
                     <div class="rpg-inline-buttons">
                         <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-item" data-field="onPerson">
-                            <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                            <i class="fa-solid fa-times"></i> Cancel
                         </button>
                         <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-item" data-field="onPerson">
-                            <i class="fa-solid fa-check"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                            <i class="fa-solid fa-check"></i> Add
+                        </button>
+                    </div>
+                </div>
+                <div class="rpg-item-list ${listViewClass}">
+                    ${itemsHtml}
+                </div>
+            </div>
+        </div>
+    `;
+}
+
+/**
+ * Renders the "Clothing" inventory view with list or grid display
+ * @param {string} clothingItems - Current clothing items (comma-separated string)
+ * @param {string} viewMode - View mode ('list' or 'grid')
+ * @returns {string} HTML for clothing view with items and add button
+ */
+export function renderClothingView(clothingItems, viewMode = 'list') {
+    const items = parseItems(clothingItems);
+
+    let itemsHtml = '';
+    if (items.length === 0) {
+        itemsHtml = '<div class="rpg-inventory-empty">No clothing worn</div>';
+    } else {
+        if (viewMode === 'grid') {
+            // Grid view: card-style items
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.clothing.${item}`);
+                return `
+                <div class="rpg-item-card" data-field="clothing" data-index="${index}">
+                    ${lockIconHtml}
+                    <button class="rpg-item-remove" data-action="remove-item" data-field="clothing" data-index="${index}" title="Remove item">
+                        <i class="fa-solid fa-times"></i>
+                    </button>
+                    <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="clothing" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
+                </div>
+            `}).join('');
+        } else {
+            // List view: full-width rows
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.clothing.${item}`);
+                return `
+                <div class="rpg-item-row" data-field="clothing" data-index="${index}">
+                    ${lockIconHtml}
+                    <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="clothing" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
+                    <button class="rpg-item-remove" data-action="remove-item" data-field="clothing" data-index="${index}" title="Remove item">
+                        <i class="fa-solid fa-times"></i>
+                    </button>
+                </div>
+            `}).join('');
+        }
+    }
+
+    const listViewClass = viewMode === 'list' ? 'rpg-item-list-view' : 'rpg-item-grid-view';
+
+    return `
+        <div class="rpg-inventory-section" data-section="clothing">
+            <div class="rpg-inventory-header">
+                <h4>Clothing Worn</h4>
+                <div class="rpg-inventory-header-actions">
+                    <div class="rpg-view-toggle">
+                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="clothing" data-view="list" title="List view">
+                            <i class="fa-solid fa-list"></i>
+                        </button>
+                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="clothing" data-view="grid" title="Grid view">
+                            <i class="fa-solid fa-th"></i>
+                        </button>
+                    </div>
+                    <button class="rpg-inventory-add-btn" data-action="add-item" data-field="clothing" title="Add new clothing item">
+                        <i class="fa-solid fa-plus"></i> Add Clothing
+                    </button>
+                </div>
+            </div>
+            <div class="rpg-inventory-content">
+                <div class="rpg-inline-form" id="rpg-add-item-form-clothing" style="display: none;">
+                    <input type="text" class="rpg-inline-input" id="rpg-new-item-clothing" placeholder="Enter clothing item..." />
+                    <div class="rpg-inline-buttons">
+                        <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-item" data-field="clothing">
+                            <i class="fa-solid fa-times"></i> Cancel
+                        </button>
+                        <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-item" data-field="clothing">
+                            <i class="fa-solid fa-check"></i> Add
                         </button>
                     </div>
                 </div>
@@ -133,30 +242,30 @@ export function renderStoredView(stored, collapsedLocations = [], viewMode = 'li
     let html = `
         <div class="rpg-inventory-section" data-section="stored">
             <div class="rpg-inventory-header">
-                <h4 data-i18n-key="inventory.stored.title">${i18n.getTranslation('inventory.stored.title')}</h4>
+                <h4>Storage Locations</h4>
                 <div class="rpg-inventory-header-actions">
                     <div class="rpg-view-toggle">
-                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="stored" data-view="list" title="${i18n.getTranslation('global.listView')}">
+                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="stored" data-view="list" title="List view">
                             <i class="fa-solid fa-list"></i>
                         </button>
-                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="stored" data-view="grid" title="${i18n.getTranslation('global.gridView')}">
+                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="stored" data-view="grid" title="Grid view">
                             <i class="fa-solid fa-th"></i>
                         </button>
                     </div>
                     <button class="rpg-inventory-add-btn" data-action="add-location" title="Add new storage location">
-                        <i class="fa-solid fa-plus"></i> <span data-i18n-key="inventory.stored.addLocationButton">${i18n.getTranslation('inventory.stored.addLocationButton')}</span>
+                        <i class="fa-solid fa-plus"></i> Add Location
                     </button>
                 </div>
             </div>
             <div class="rpg-inventory-content">
                 <div class="rpg-inline-form" id="rpg-add-location-form" style="display: none;">
-                    <input type="text" class="rpg-inline-input" id="rpg-new-location-name" placeholder="${i18n.getTranslation('inventory.stored.addLocationPlaceholder')}" data-i18n-placeholder-key="inventory.stored.addLocationPlaceholder" />
+                    <input type="text" class="rpg-inline-input" id="rpg-new-location-name" placeholder="Enter location name..." />
                     <div class="rpg-inline-buttons">
                         <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-location">
-                            <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                            <i class="fa-solid fa-times"></i> Cancel
                         </button>
                         <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-location">
-                            <i class="fa-solid fa-check"></i> <span data-i18n-key="inventory.stored.saveButton">${i18n.getTranslation('inventory.stored.saveButton')}</span>
+                            <i class="fa-solid fa-check"></i> Save
                         </button>
                     </div>
                 </div>
@@ -164,8 +273,8 @@ export function renderStoredView(stored, collapsedLocations = [], viewMode = 'li
 
     if (locations.length === 0) {
         html += `
-                <div class="rpg-inventory-empty" data-i18n-key="inventory.stored.empty">
-                    ${i18n.getTranslation('inventory.stored.empty')}
+                <div class="rpg-inventory-empty">
+                    No storage locations yet. Click "Add Location" to create one.
                 </div>
         `;
     } else {
@@ -177,28 +286,34 @@ export function renderStoredView(stored, collapsedLocations = [], viewMode = 'li
 
             let itemsHtml = '';
             if (items.length === 0) {
-                itemsHtml = `<div class="rpg-inventory-empty" data-i18n-key="inventory.stored.noItems">${i18n.getTranslation('inventory.stored.noItems')}</div>`;
+                itemsHtml = '<div class="rpg-inventory-empty">No items stored here</div>';
             } else {
                 if (viewMode === 'grid') {
                     // Grid view: card-style items
-                    itemsHtml = items.map((item, index) => `
+                    itemsHtml = items.map((item, index) => {
+                        const lockIconHtml = getLockIconHtml('userStats', `inventory.stored.${location}.${item}`);
+                        return `
                         <div class="rpg-item-card" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}">
+                            ${lockIconHtml}
                             <button class="rpg-item-remove" data-action="remove-item" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}" title="Remove item">
                                 <i class="fa-solid fa-times"></i>
                             </button>
                             <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
                         </div>
-                    `).join('');
+                    `}).join('');
                 } else {
                     // List view: full-width rows
-                    itemsHtml = items.map((item, index) => `
+                    itemsHtml = items.map((item, index) => {
+                        const lockIconHtml = getLockIconHtml('userStats', `inventory.stored.${location}.${item}`);
+                        return `
                         <div class="rpg-item-row" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}">
+                            ${lockIconHtml}
                             <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
                             <button class="rpg-item-remove" data-action="remove-item" data-field="stored" data-location="${escapeHtml(location)}" data-index="${index}" title="Remove item">
                                 <i class="fa-solid fa-times"></i>
                             </button>
                         </div>
-                    `).join('');
+                    `}).join('');
                 }
             }
 
@@ -219,13 +334,13 @@ export function renderStoredView(stored, collapsedLocations = [], viewMode = 'li
                     </div>
                     <div class="rpg-storage-content" ${isCollapsed ? 'style="display:none;"' : ''}>
                         <div class="rpg-inline-form" id="rpg-add-item-form-stored-${locationId}" style="display: none;">
-                            <input type="text" class="rpg-inline-input rpg-location-item-input" data-location="${escapeHtml(location)}" placeholder="${i18n.getTranslation('inventory.stored.addItemToLocationPlaceholder')}" data-i18n-placeholder-key="inventory.stored.addItemToLocationPlaceholder" />
+                            <input type="text" class="rpg-inline-input rpg-location-item-input" data-location="${escapeHtml(location)}" placeholder="Enter item name..." />
                             <div class="rpg-inline-buttons">
                                 <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-item" data-field="stored" data-location="${escapeHtml(location)}">
-                                    <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                                    <i class="fa-solid fa-times"></i> Cancel
                                 </button>
                                 <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-item" data-field="stored" data-location="${escapeHtml(location)}">
-                                    <i class="fa-solid fa-check"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                                    <i class="fa-solid fa-check"></i> Add
                                 </button>
                             </div>
                         </div>
@@ -234,18 +349,18 @@ export function renderStoredView(stored, collapsedLocations = [], viewMode = 'li
                         </div>
                         <div class="rpg-storage-add-item-container">
                             <button class="rpg-inventory-add-btn" data-action="add-item" data-field="stored" data-location="${escapeHtml(location)}" title="Add item to this location">
-                                <i class="fa-solid fa-plus"></i> <span data-i18n-key="inventory.stored.addItemButton">${i18n.getTranslation('inventory.stored.addItemButton')}</span>
+                                <i class="fa-solid fa-plus"></i> Add Item
                             </button>
                         </div>
                     </div>
                     <div class="rpg-inline-confirmation" id="rpg-remove-confirm-${locationId}" style="display: none;">
-                        <p>${i18n.getTranslation('inventory.stored.confirmRemoveLocationMessage', { location: escapeHtml(location) })}</p>
+                        <p>Remove "${escapeHtml(location)}"? This will delete all items stored there.</p>
                         <div class="rpg-inline-buttons">
                             <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-remove-location" data-location="${escapeHtml(location)}">
-                                <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                                <i class="fa-solid fa-times"></i> Cancel
                             </button>
                             <button class="rpg-inline-btn rpg-inline-confirm" data-action="confirm-remove-location" data-location="${escapeHtml(location)}">
-                                <i class="fa-solid fa-check"></i> <span data-i18n-key="inventory.stored.confirmRemoveLocationConfirmButton">${i18n.getTranslation('inventory.stored.confirmRemoveLocationConfirmButton')}</span>
+                                <i class="fa-solid fa-check"></i> Confirm
                             </button>
                         </div>
                     </div>
@@ -273,28 +388,34 @@ export function renderAssetsView(assets, viewMode = 'list') {
 
     let itemsHtml = '';
     if (items.length === 0) {
-        itemsHtml = `<div class="rpg-inventory-empty" data-i18n-key="inventory.assets.empty">${i18n.getTranslation('inventory.assets.empty')}</div>`;
+        itemsHtml = '<div class="rpg-inventory-empty">No assets owned</div>';
     } else {
         if (viewMode === 'grid') {
             // Grid view: card-style items
-            itemsHtml = items.map((item, index) => `
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.assets.${item}`);
+                return `
                 <div class="rpg-item-card" data-field="assets" data-index="${index}">
+                    ${lockIconHtml}
                     <button class="rpg-item-remove" data-action="remove-item" data-field="assets" data-index="${index}" title="Remove asset">
                         <i class="fa-solid fa-times"></i>
                     </button>
                     <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="assets" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
                 </div>
-            `).join('');
+            `}).join('');
         } else {
             // List view: full-width rows
-            itemsHtml = items.map((item, index) => `
+            itemsHtml = items.map((item, index) => {
+                const lockIconHtml = getLockIconHtml('userStats', `inventory.assets.${item}`);
+                return `
                 <div class="rpg-item-row" data-field="assets" data-index="${index}">
+                    ${lockIconHtml}
                     <span class="rpg-item-name rpg-editable" contenteditable="true" data-field="assets" data-index="${index}" title="Click to edit">${escapeHtml(item)}</span>
-                    <button class="rpg-item-remove" data-action="remove-item" data-field="assets" data-index="${index}" title="${i18n.getTranslation('inventory.assets.removeAssetTitle')}">
+                    <button class="rpg-item-remove" data-action="remove-item" data-field="assets" data-index="${index}" title="Remove asset">
                         <i class="fa-solid fa-times"></i>
                     </button>
                 </div>
-            `).join('');
+            `}).join('');
         }
     }
 
@@ -303,30 +424,30 @@ export function renderAssetsView(assets, viewMode = 'list') {
     return `
         <div class="rpg-inventory-section" data-section="assets">
             <div class="rpg-inventory-header">
-                <h4 data-i18n-key="inventory.assets.title">${i18n.getTranslation('inventory.assets.title')}</h4>
+                <h4>Vehicles, Property & Major Possessions</h4>
                 <div class="rpg-inventory-header-actions">
                     <div class="rpg-view-toggle">
-                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="assets" data-view="list" title="${i18n.getTranslation('global.listView')}">
+                        <button class="rpg-view-btn ${viewMode === 'list' ? 'active' : ''}" data-action="switch-view" data-field="assets" data-view="list" title="List view">
                             <i class="fa-solid fa-list"></i>
                         </button>
-                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="assets" data-view="grid" title="${i18n.getTranslation('global.gridView')}">
+                        <button class="rpg-view-btn ${viewMode === 'grid' ? 'active' : ''}" data-action="switch-view" data-field="assets" data-view="grid" title="Grid view">
                             <i class="fa-solid fa-th"></i>
                         </button>
                     </div>
                     <button class="rpg-inventory-add-btn" data-action="add-item" data-field="assets" title="Add new asset">
-                        <i class="fa-solid fa-plus"></i> <span data-i18n-key="inventory.assets.addAssetButton">${i18n.getTranslation('inventory.assets.addAssetButton')}</span>
+                        <i class="fa-solid fa-plus"></i> Add Asset
                     </button>
                 </div>
             </div>
             <div class="rpg-inventory-content">
                 <div class="rpg-inline-form" id="rpg-add-item-form-assets" style="display: none;">
-                    <input type="text" class="rpg-inline-input" id="rpg-new-item-assets" placeholder="${i18n.getTranslation('inventory.assets.addAssetPlaceholder')}" data-i18n-placeholder-key="inventory.assets.addAssetPlaceholder" />
+                    <input type="text" class="rpg-inline-input" id="rpg-new-item-assets" placeholder="Enter asset name..." />
                     <div class="rpg-inline-buttons">
                         <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-item" data-field="assets">
-                            <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                            <i class="fa-solid fa-times"></i> Cancel
                         </button>
                         <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-item" data-field="assets">
-                            <i class="fa-solid fa-check"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                            <i class="fa-solid fa-check"></i> Add
                         </button>
                     </div>
                 </div>
@@ -335,7 +456,8 @@ export function renderAssetsView(assets, viewMode = 'list') {
                 </div>
                 <div class="rpg-inventory-hint">
                     <i class="fa-solid fa-info-circle"></i>
-                    <span data-i18n-key="inventory.assets.description">${i18n.getTranslation('inventory.assets.description')}</span>
+                    Assets include vehicles (cars, motorcycles), property (homes, apartments),
+                    and major equipment (workshop tools, special items).
                 </div>
             </div>
         </div>
@@ -397,6 +519,7 @@ function generateInventoryHTML(inventory, options = {}) {
     // Get view modes from settings (default to 'list')
     const viewModes = extensionSettings.inventoryViewModes || {
         onPerson: 'list',
+        clothing: 'list',
         stored: 'list',
         assets: 'list'
     };
@@ -406,6 +529,9 @@ function generateInventoryHTML(inventory, options = {}) {
         case 'onPerson':
             html += renderOnPersonView(v2Inventory.onPerson, viewModes.onPerson);
             break;
+        case 'clothing':
+            html += renderClothingView(v2Inventory.clothing, viewModes.clothing);
+            break;
         case 'stored':
             html += renderStoredView(v2Inventory.stored, collapsedLocations, viewModes.stored);
             break;
@@ -476,6 +602,31 @@ export function renderInventory() {
         const newName = $(this).text().trim();
         updateInventoryItem(field, index, newName, location);
     });
+
+    // Add event listener for section lock icon clicks (support both click and touch)
+    $inventoryContainer.find('.rpg-section-lock-icon').on('click touchend', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        const $icon = $(this);
+        const trackerType = $icon.data('tracker');
+        const itemPath = $icon.data('path');
+        const currentlyLocked = isItemLocked(trackerType, itemPath);
+
+        // Toggle lock state
+        setItemLock(trackerType, itemPath, !currentlyLocked);
+
+        // Update icon
+        const newIcon = !currentlyLocked ? '🔒' : '🔓';
+        const newTitle = !currentlyLocked ? 'Locked' : 'Unlocked';
+        $icon.text(newIcon);
+        $icon.attr('title', newTitle);
+
+        // Toggle 'locked' class for persistent visibility
+        $icon.toggleClass('locked', !currentlyLocked);
+
+        // Save settings
+        saveSettings();
+    });
 }
 
 /**

src/systems/rendering/musicPlayer.js

@@ -0,0 +1,150 @@
+/**
+ * Music Player Rendering Module
+ * Handles UI rendering for Spotify music player widget
+ */
+
+import { extensionSettings, committedTrackerData } from '../../core/state.js';
+import { i18n } from '../../core/i18n.js';
+
+/**
+ * Creates a Spotify deep link URL that opens the Spotify app
+ * Uses spotify:search: protocol for app, falls back to web URL
+ * @param {Object} songData - Object with {song, artist, searchQuery}
+ * @returns {Object} Object with appUrl and webUrl
+ */
+function createSpotifyUrls(songData) {
+    if (!songData || !songData.searchQuery) {
+        return { appUrl: '', webUrl: '' };
+    }
+
+    const encodedQuery = encodeURIComponent(songData.searchQuery);
+
+    return {
+        // Spotify app protocol - opens directly in Spotify app on desktop/mobile
+        appUrl: `spotify:search:${encodedQuery}`,
+        // Web fallback - opens Spotify web player search
+        webUrl: `https://open.spotify.com/search/${encodedQuery}`
+    };
+}
+
+/**
+ * Opens Spotify with the given song
+ * Tries app protocol first, falls back to web
+ * @param {Object} songData - Song data object
+ */
+function openInSpotify(songData) {
+    const urls = createSpotifyUrls(songData);
+
+    // Try to open in Spotify app first
+    // On mobile, this will open the Spotify app if installed
+    // On desktop, this will open Spotify desktop app if installed
+    window.location.href = urls.appUrl;
+
+    // Fallback: If app doesn't open within 2 seconds, open web version
+    // This handles cases where Spotify app isn't installed
+    setTimeout(() => {
+        // Check if we're still on the same page (app didn't open)
+        // Note: This is a best-effort fallback
+        if (document.hasFocus()) {
+            window.open(urls.webUrl, '_blank');
+        }
+    }, 1500);
+}
+
+/**
+ * Renders the Spotify music player as a mini player widget above chat input
+ * @param {HTMLElement} container - Container element to render into
+ */
+export function renderMusicPlayer(container) {
+    // console.log('[RPG Companion] Music Player: renderMusicPlayer called');
+
+    // Remove old chat-attached player if it exists
+    $('#rpg-chat-music-player').remove();
+
+    // console.log('[RPG Companion] Music Player: enableSpotifyMusic =', extensionSettings.enableSpotifyMusic);
+
+    if (!extensionSettings.enableSpotifyMusic) {
+        // console.warn('[RPG Companion] Music Player: Spotify music is disabled');
+        return;
+    }
+
+    const songData = committedTrackerData.spotifyUrl;
+    // console.log('[RPG Companion] Music Player: Rendering with song:', songData);
+
+    if (!songData || !songData.displayText) {
+        // No song - don't show anything
+        return;
+    }
+
+    // Create the mini music player widget
+    const musicPlayerHtml = `
+        <div id="rpg-chat-music-player" class="rpg-music-widget">
+            <div class="rpg-music-widget-content">
+                <div class="rpg-music-widget-icon">
+                    <i class="fa-brands fa-spotify"></i>
+                </div>
+                <div class="rpg-music-widget-info">
+                    <div class="rpg-music-widget-title" title="${songData.song}">${songData.song}</div>
+                    <div class="rpg-music-widget-artist" title="${songData.artist}">${songData.artist}</div>
+                </div>
+                <button class="rpg-music-widget-play" title="Play in Spotify">
+                    <i class="fa-solid fa-play"></i>
+                </button>
+                <button class="rpg-music-widget-close" title="Dismiss">
+                    <i class="fa-solid fa-times"></i>
+                </button>
+            </div>
+        </div>
+    `;
+
+    // Find the chat form container and insert widget before (above) it
+    const $chatForm = $('#send_form');
+
+    // console.log('[RPG Companion] Music Player: Found #send_form:', $chatForm.length > 0);
+
+    if ($chatForm.length === 0) {
+        console.error('[RPG Companion] Music Player: Could not find #send_form - cannot render widget!');
+        return;
+    }
+
+    // Insert widget inside (at top of) the chat form
+    // console.log('[RPG Companion] Music Player: Prepending widget to #send_form');
+    $chatForm.prepend(musicPlayerHtml);
+
+    // console.log('[RPG Companion] Music Player: Widget inserted, checking if visible...');
+    const $widget = $('#rpg-chat-music-player');
+    // console.log('[RPG Companion] Music Player: Widget exists:', $widget.length > 0);
+    if ($widget.length > 0) {
+        // console.log('[RPG Companion] Music Player: Widget position:', $widget.offset());
+        // console.log('[RPG Companion] Music Player: Widget dimensions:', { width: $widget.width(), height: $widget.height() });
+        // console.log('[RPG Companion] Music Player: Widget CSS display:', $widget.css('display'));
+        // console.log('[RPG Companion] Music Player: Widget CSS visibility:', $widget.css('visibility'));
+    }
+
+    // Bind play button click
+    $('#rpg-chat-music-player .rpg-music-widget-play').on('click', function(e) {
+        e.stopPropagation();
+        openInSpotify(songData);
+    });
+
+    // Bind close button click
+    $('#rpg-chat-music-player .rpg-music-widget-close').on('click', function(e) {
+        e.stopPropagation();
+        $('#rpg-chat-music-player').fadeOut(200, function() {
+            $(this).remove();
+        });
+    });
+
+    // Clicking anywhere else on the widget also opens Spotify
+    $('#rpg-chat-music-player .rpg-music-widget-content').on('click', function() {
+        openInSpotify(songData);
+    });
+}
+
+/**
+ * Updates the music player display
+ * @param {HTMLElement} container - Container element
+ */
+export function updateMusicPlayer(container) {
+    renderMusicPlayer(container);
+}

src/systems/rendering/quests.js

@@ -3,9 +3,51 @@
  * Handles UI rendering for quests system (main and optional quests)
  */
 
-import { extensionSettings, $questsContainer } from '../../core/state.js';
-import { saveSettings } from '../../core/persistence.js';
-import { i18n } from '../../core/i18n.js';
+import { extensionSettings, $questsContainer, committedTrackerData, lastGeneratedData } from '../../core/state.js';
+import { saveSettings, saveChatData } from '../../core/persistence.js';
+import { isItemLocked, setItemLock } from '../generation/lockManager.js';
+
+/**
+ * Syncs the current extensionSettings.quests to committedTrackerData.userStats
+ * This ensures quest changes made via UI are reflected in the data sent to AI
+ */
+function syncQuestsToCommittedData() {
+    const currentData = committedTrackerData.userStats || lastGeneratedData.userStats;
+    if (!currentData) return;
+
+    const trimmed = currentData.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            const jsonData = JSON.parse(currentData);
+            if (jsonData && typeof jsonData === 'object') {
+                // Update quests in the JSON data
+                jsonData.quests = extensionSettings.quests || { main: 'None', optional: [] };
+                const updatedJSON = JSON.stringify(jsonData, null, 2);
+                committedTrackerData.userStats = updatedJSON;
+                lastGeneratedData.userStats = updatedJSON;
+            }
+        } catch (e) {
+            console.warn('[RPG Quests] Failed to sync quests to committed data:', e);
+        }
+    }
+}
+
+/**
+ * Helper to generate lock icon HTML if setting is enabled
+ * @param {string} tracker - Tracker name
+ * @param {string} path - Item path
+ * @returns {string} Lock icon HTML or empty string
+ */
+function getLockIconHtml(tracker, path) {
+    const showLockIcons = extensionSettings.showLockIcons ?? true;
+    if (!showLockIcons) return '';
+
+    const isLocked = isItemLocked(tracker, path);
+    const lockIcon = isLocked ? '🔒' : '🔓';
+    const lockTitle = isLocked ? 'Locked' : 'Unlocked';
+    const lockedClass = isLocked ? ' locked' : '';
+    return `<span class="rpg-section-lock-icon${lockedClass}" data-tracker="${tracker}" data-path="${path}" title="${lockTitle}">${lockIcon}</span>`;
+}
 
 /**
  * HTML escape helper
@@ -26,11 +68,11 @@ function escapeHtml(text) {
 export function renderQuestsSubTabs(activeTab = 'main') {
     return `
         <div class="rpg-quests-subtabs">
-            <button class="rpg-quests-subtab ${activeTab === 'main' ? 'active' : ''}" data-tab="main" data-i18n-key="quests.section.main">
-                ${i18n.getTranslation('quests.section.main')}
+            <button class="rpg-quests-subtab ${activeTab === 'main' ? 'active' : ''}" data-tab="main">
+                Main Quest
             </button>
-            <button class="rpg-quests-subtab ${activeTab === 'optional' ? 'active' : ''}" data-tab="optional" data-i18n-key="quests.section.optional">
-                ${i18n.getTranslation('quests.section.optional')}
+            <button class="rpg-quests-subtab ${activeTab === 'optional' ? 'active' : ''}" data-tab="optional">
+                Optional Quests
             </button>
         </div>
     `;
@@ -48,9 +90,9 @@ export function renderMainQuestView(mainQuest) {
     return `
         <div class="rpg-quest-section">
             <div class="rpg-quest-header">
-                <h3 class="rpg-quest-section-title" data-i18n-key="quests.main.title">${i18n.getTranslation('quests.main.title')}</h3>
-                ${!hasQuest ? `<button class="rpg-add-quest-btn" data-action="add-quest" data-field="main" title="${i18n.getTranslation('quests.main.addQuestTitle')}">
-                    <i class="fa-solid fa-plus"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                <h3 class="rpg-quest-section-title">Main Quests</h3>
+                ${!hasQuest ? `<button class="rpg-add-quest-btn" data-action="add-quest" data-field="main" title="Add main quests">
+                    <i class="fa-solid fa-plus"></i> Add Quest
                 </button>` : ''}
             </div>
             <div class="rpg-quest-content">
@@ -59,14 +101,15 @@ export function renderMainQuestView(mainQuest) {
                         <input type="text" class="rpg-inline-input" id="rpg-edit-quest-main" value="${escapeHtml(questDisplay)}" />
                         <div class="rpg-inline-buttons">
                             <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-edit-quest" data-field="main">
-                                <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                                <i class="fa-solid fa-times"></i> Cancel
                             </button>
                             <button class="rpg-inline-btn rpg-inline-save" data-action="save-edit-quest" data-field="main">
-                                <i class="fa-solid fa-check"></i> <span data-i18n-key="global.save">${i18n.getTranslation('global.save')}</span>
+                                <i class="fa-solid fa-check"></i> Save
                             </button>
                         </div>
                     </div>
                     <div class="rpg-quest-item" data-field="main">
+                        ${getLockIconHtml('userStats', 'quests.main')}
                         <div class="rpg-quest-title">${escapeHtml(questDisplay)}</div>
                         <div class="rpg-quest-actions">
                             <button class="rpg-quest-edit" data-action="edit-quest" data-field="main" title="Edit quest">
@@ -79,22 +122,22 @@ export function renderMainQuestView(mainQuest) {
                     </div>
                 ` : `
                     <div class="rpg-inline-form" id="rpg-add-quest-form-main" style="display: none;">
-                        <input type="text" class="rpg-inline-input" id="rpg-new-quest-main" placeholder="${i18n.getTranslation('quests.main.addQuestPlaceholder')}" data-i18n-placeholder-key="quests.main.addQuestPlaceholder" />
+                        <input type="text" class="rpg-inline-input" id="rpg-new-quest-main" placeholder="Enter main quests title..." />
                         <div class="rpg-inline-actions">
                             <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-quest" data-field="main">
-                                <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                                <i class="fa-solid fa-times"></i> Cancel
                             </button>
                             <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-quest" data-field="main">
-                                <i class="fa-solid fa-check"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                                <i class="fa-solid fa-check"></i> Add
                             </button>
                         </div>
                     </div>
-                    <div class="rpg-quest-empty" data-i18n-key="quests.main.empty">${i18n.getTranslation('quests.main.empty')}</div>
+                    <div class="rpg-quest-empty">No active main quests</div>
                 `}
             </div>
             <div class="rpg-quest-hint">
                 <i class="fa-solid fa-lightbulb"></i>
-                <span data-i18n-key="quests.main.hint">${i18n.getTranslation('quests.main.hint')}</span>
+                The main quests represent your primary objective in the story.
             </div>
         </div>
     `;
@@ -110,10 +153,12 @@ export function renderOptionalQuestsView(optionalQuests) {
 
     let questsHtml = '';
     if (quests.length === 0) {
-        questsHtml = `<div class="rpg-quest-empty" data-i18n-key="quests.optional.empty">${i18n.getTranslation('quests.optional.empty')}</div>`;
+        questsHtml = '<div class="rpg-quest-empty">No active optional quests</div>';
     } else {
-        questsHtml = quests.map((quest, index) => `
+        questsHtml = quests.map((quest, index) => {
+            return `
             <div class="rpg-quest-item" data-field="optional" data-index="${index}">
+                ${getLockIconHtml('userStats', `quests.optional[${index}]`)}
                 <div class="rpg-quest-title rpg-editable" contenteditable="true" data-field="optional" data-index="${index}" title="Click to edit">${escapeHtml(quest)}</div>
                 <div class="rpg-quest-actions">
                     <button class="rpg-quest-remove" data-action="remove-quest" data-field="optional" data-index="${index}" title="Complete/Remove quest">
@@ -121,26 +166,26 @@ export function renderOptionalQuestsView(optionalQuests) {
                     </button>
                 </div>
             </div>
-        `).join('');
+        `}).join('');
     }
 
     return `
         <div class="rpg-quest-section">
             <div class="rpg-quest-header">
-                <h3 class="rpg-quest-section-title" data-i18n-key="quests.optional.title">${i18n.getTranslation('quests.optional.title')}</h3>
-                <button class="rpg-add-quest-btn" data-action="add-quest" data-field="optional" title="${i18n.getTranslation('quests.optional.addQuestTitle')}">
-                    <i class="fa-solid fa-plus"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                <h3 class="rpg-quest-section-title">Optional Quests</h3>
+                <button class="rpg-add-quest-btn" data-action="add-quest" data-field="optional" title="Add optional quest">
+                    <i class="fa-solid fa-plus"></i> Add Quest
                 </button>
             </div>
             <div class="rpg-quest-content">
                 <div class="rpg-inline-form" id="rpg-add-quest-form-optional" style="display: none;">
-                    <input type="text" class="rpg-inline-input" id="rpg-new-quest-optional" placeholder="${i18n.getTranslation('quests.optional.addQuestPlaceholder')}" data-i18n-placeholder-key="quests.optional.addQuestPlaceholder" />
+                    <input type="text" class="rpg-inline-input" id="rpg-new-quest-optional" placeholder="Enter optional quest title..." />
                     <div class="rpg-inline-buttons">
                         <button class="rpg-inline-btn rpg-inline-cancel" data-action="cancel-add-quest" data-field="optional">
-                            <i class="fa-solid fa-times"></i> <span data-i18n-key="global.cancel">${i18n.getTranslation('global.cancel')}</span>
+                            <i class="fa-solid fa-times"></i> Cancel
                         </button>
                         <button class="rpg-inline-btn rpg-inline-save" data-action="save-add-quest" data-field="optional">
-                            <i class="fa-solid fa-check"></i> <span data-i18n-key="global.add">${i18n.getTranslation('global.add')}</span>
+                            <i class="fa-solid fa-check"></i> Add
                         </button>
                     </div>
                 </div>
@@ -149,7 +194,7 @@ export function renderOptionalQuestsView(optionalQuests) {
                 </div>
                 <div class="rpg-quest-hint">
                     <i class="fa-solid fa-info-circle"></i>
-                    <span data-i18n-key="quests.optional.hint">${i18n.getTranslation('quests.optional.hint')}</span>
+                    Optional quests are side objectives that complement your main story.
                 </div>
             </div>
         </div>
@@ -167,8 +212,12 @@ export function renderQuests() {
     // Get current sub-tab from container or default to 'main'
     const activeSubTab = $questsContainer.data('active-subtab') || 'main';
 
-    // Get quests data
-    const mainQuest = extensionSettings.quests.main || 'None';
+    // Get quests data - extract value if it's a locked object
+    let mainQuest = extensionSettings.quests.main || 'None';
+    // Recursively extract value if it's nested objects
+    while (typeof mainQuest === 'object' && mainQuest.value !== undefined) {
+        mainQuest = mainQuest.value;
+    }
     const optionalQuests = extensionSettings.quests.optional || [];
 
     // Build HTML
@@ -230,7 +279,10 @@ function attachQuestEventHandlers() {
                 }
                 extensionSettings.quests.optional.push(questTitle);
             }
+            // Sync quest changes to committedTrackerData so AI sees the addition
+            syncQuestsToCommittedData();
             saveSettings();
+            saveChatData();
             renderQuests();
         }
     });
@@ -258,7 +310,10 @@ function attachQuestEventHandlers() {
 
         if (questTitle) {
             extensionSettings.quests.main = questTitle;
+            // Sync quest changes to committedTrackerData so AI sees the edit
+            syncQuestsToCommittedData();
             saveSettings();
+            saveChatData();
             renderQuests();
         }
     });
@@ -273,7 +328,10 @@ function attachQuestEventHandlers() {
         } else {
             extensionSettings.quests.optional.splice(index, 1);
         }
+        // Sync quest changes to committedTrackerData so AI sees the removal
+        syncQuestsToCommittedData();
         saveSettings();
+        saveChatData();
         renderQuests();
     });
 
@@ -286,7 +344,10 @@ function attachQuestEventHandlers() {
 
         if (newTitle && field === 'optional' && index !== undefined) {
             extensionSettings.quests.optional[index] = newTitle;
+            // Sync quest changes to committedTrackerData so AI sees the edit
+            syncQuestsToCommittedData();
             saveSettings();
+            saveChatData();
         }
     });
 
@@ -304,4 +365,29 @@ function attachQuestEventHandlers() {
             }
         }
     });
+
+    // Add event listener for section lock icon clicks (support both click and touch)
+    $questsContainer.find('.rpg-section-lock-icon').on('click touchend', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        const $icon = $(this);
+        const trackerType = $icon.data('tracker');
+        const itemPath = $icon.data('path');
+        const currentlyLocked = isItemLocked(trackerType, itemPath);
+
+        // Toggle lock state
+        setItemLock(trackerType, itemPath, !currentlyLocked);
+
+        // Update icon
+        const newIcon = !currentlyLocked ? '🔒' : '🔓';
+        const newTitle = !currentlyLocked ? 'Locked' : 'Unlocked';
+        $icon.text(newIcon);
+        $icon.attr('title', newTitle);
+
+        // Toggle 'locked' class for persistent visibility
+        $icon.toggleClass('locked', !currentlyLocked);
+
+        // Save settings
+        saveSettings();
+    });
 }

src/systems/rendering/userStats.js

@@ -19,6 +19,23 @@ import {
 } from '../../core/persistence.js';
 import { getSafeThumbnailUrl } from '../../utils/avatars.js';
 import { buildInventorySummary } from '../generation/promptBuilder.js';
+import { isItemLocked, setItemLock } from '../generation/lockManager.js';
+import { updateFabWidgets } from '../ui/mobile.js';
+import { getStatBarColors } from '../ui/theme.js';
+
+/**
+ * Extracts the base name (before parentheses) and converts to snake_case for use as JSON key.
+ * Example: "Conditions (up to 5 traits)" -> "conditions"
+ * @param {string} name - Field name, possibly with parenthetical description
+ * @returns {string} snake_case key from the base name only
+ */
+function toFieldKey(name) {
+    const baseName = name.replace(/\s*\(.*\)\s*$/, '').trim();
+    return baseName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
 
 /**
  * Builds the user stats text string using custom stat names
@@ -67,6 +84,113 @@ export function buildUserStatsText() {
     return text.trim();
 }
 
+/**
+ * Updates lastGeneratedData.userStats and committedTrackerData.userStats
+ * Maintains JSON format if current data is JSON, otherwise uses text format.
+ * @private
+ */
+function updateUserStatsData() {
+    // Check if current data is in JSON format
+    const currentData = lastGeneratedData.userStats || committedTrackerData.userStats;
+    if (currentData) {
+        const trimmed = currentData.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            // Maintain JSON format
+            try {
+                const jsonData = JSON.parse(currentData);
+                if (jsonData && typeof jsonData === 'object') {
+                    const stats = extensionSettings.userStats;
+                    const config = extensionSettings.trackerConfig?.userStats || {};
+                    const enabledStats = config.customStats?.filter(stat => stat && stat.enabled && stat.name && stat.id) || [];
+
+                    // Build stats array - include all stats from extensionSettings, not just enabled ones
+                    // This preserves custom stats that AI might have added or that user has disabled
+                    const statsArray = [];
+                    const processedIds = new Set();
+
+                    // First, add all enabled stats from config (maintains order)
+                    enabledStats.forEach(stat => {
+                        statsArray.push({
+                            id: stat.id,
+                            name: stat.name,
+                            value: stats[stat.id] !== undefined ? stats[stat.id] : 100
+                        });
+                        processedIds.add(stat.id);
+                    });
+
+                    // Then, add any other numeric stats from extensionSettings that aren't in config
+                    // (these could be custom stats the AI added or disabled stats)
+                    const customFields = config.statusSection?.customFields || [];
+                    const excludeFields = new Set(['mood', ...customFields.map(f => toFieldKey(f)), 'inventory', 'skills', 'level']);
+                    Object.entries(stats).forEach(([key, value]) => {
+                        if (!processedIds.has(key) && !excludeFields.has(key) && typeof value === 'number') {
+                            statsArray.push({
+                                id: key,
+                                name: key.charAt(0).toUpperCase() + key.slice(1),
+                                value: value
+                            });
+                        }
+                    });
+
+                    jsonData.stats = statsArray;
+
+                    // Update status - include all custom status fields
+                    jsonData.status = {
+                        mood: stats.mood || '😐'
+                    };
+
+                    // Add all custom status fields
+                    for (const fieldName of customFields) {
+                        const fieldKey = toFieldKey(fieldName);
+                        jsonData.status[fieldKey] = stats[fieldKey] || 'None';
+                    }
+
+                    // Update inventory (convert to v3 format)
+                    const convertToV3Items = (itemString) => {
+                        if (!itemString) return [];
+                        const items = itemString.split(',').map(s => s.trim()).filter(s => s);
+                        return items.map(item => {
+                            const qtyMatch = item.match(/^(\\d+)x\\s+(.+)$/);
+                            if (qtyMatch) {
+                                return { name: qtyMatch[2].trim(), quantity: parseInt(qtyMatch[1]) };
+                            }
+                            return { name: item, quantity: 1 };
+                        });
+                    };
+
+                    jsonData.inventory = {
+                        onPerson: convertToV3Items(stats.inventory?.onPerson),
+                        clothing: convertToV3Items(stats.inventory?.clothing),
+                        stored: stats.inventory?.stored || {},
+                        assets: convertToV3Items(stats.inventory?.assets)
+                    };
+
+                    // Update quests
+                    jsonData.quests = extensionSettings.quests || { main: '', optional: [] };
+
+                    // Update skills if present
+                    if (stats.skills) {
+                        jsonData.skills = Array.isArray(stats.skills) ? stats.skills :
+                            stats.skills.split(',').map(s => s.trim()).filter(s => s);
+                    }
+
+                    const updatedJSON = JSON.stringify(jsonData, null, 2);
+                    lastGeneratedData.userStats = updatedJSON;
+                    committedTrackerData.userStats = updatedJSON;
+                    return;
+                }
+            } catch (e) {
+                console.warn('[RPG Companion] Failed to parse JSON, falling back to text format:', e);
+            }
+        }
+    }
+
+    // Fall back to text format
+    const statsText = buildUserStatsText();
+    lastGeneratedData.userStats = statsText;
+    committedTrackerData.userStats = statsText;
+}
+
 /**
  * Renders the user stats panel with health bars, mood, inventory, and classic stats.
  * Includes event listeners for editable fields.
@@ -77,7 +201,36 @@ export function renderUserStats() {
         return;
     }
 
+    // Don't render if no data exists (e.g., after cache clear)
+    // Check both lastGeneratedData and committedTrackerData
+    // console.log('[RPG UserStats Render] Checking data:', {
+    //     hasLastGenerated: !!lastGeneratedData.userStats,
+    //     hasCommitted: !!committedTrackerData.userStats,
+    //     lastGeneratedPreview: lastGeneratedData.userStats ? lastGeneratedData.userStats.substring(0, 100) : 'null',
+    //     committedPreview: committedTrackerData.userStats ? committedTrackerData.userStats.substring(0, 100) : 'null'
+    // });
+
+    if (!lastGeneratedData.userStats && !committedTrackerData.userStats) {
+        // Always render to the #rpg-user-stats container (mobile layout just moves it around in DOM)
+        $userStatsContainer.html('<div class="rpg-inventory-empty">No statuses generated yet</div>');
+        return;
+    }
+
+    // Use lastGeneratedData if available, otherwise fall back to committed data
+    if (!lastGeneratedData.userStats && committedTrackerData.userStats) {
+        lastGeneratedData.userStats = committedTrackerData.userStats;
+    }
+
     const stats = extensionSettings.userStats;
+    // console.log('[RPG UserStats Render] Current extensionSettings.userStats:', {
+    //     health: stats.health,
+    //     satiety: stats.satiety,
+    //     energy: stats.energy,
+    //     hygiene: stats.hygiene,
+    //     arousal: stats.arousal,
+    //     mood: stats.mood,
+    //     conditions: stats.conditions
+    // });
     const config = extensionSettings.trackerConfig?.userStats || {
         customStats: [
             { id: 'health', name: 'Health', enabled: true },
@@ -113,35 +266,65 @@ export function renderUserStats() {
         }
     }
 
-    // Create gradient from low to high color
-    const gradient = `linear-gradient(to right, ${extensionSettings.statBarColorLow}, ${extensionSettings.statBarColorHigh})`;
+    // Create gradient from low to high color with opacity
+    const colors = getStatBarColors();
+    const gradient = `linear-gradient(to right, ${colors.low}, ${colors.high})`;
 
-    let html = '<div class="rpg-stats-content"><div class="rpg-stats-left">';
+    // Check if stats bars section is locked
+    const isStatsLocked = isItemLocked('userStats', 'stats');
+    const lockIcon = isStatsLocked ? '🔒' : '🔓';
+    const lockTitle = isStatsLocked ? 'Locked - AI cannot change stats' : 'Unlocked - AI can change stats';
+    const lockedClass = isStatsLocked ? ' locked' : '';
+
+    let html = '<div class="rpg-stats-content">';
+    html += '<div class="rpg-stats-left">';
 
     // User info row
+    const showLevel = extensionSettings.trackerConfig?.userStats?.showLevel !== false;
     html += `
         <div class="rpg-user-info-row">
             <img src="${userPortrait}" alt="${userName}" class="rpg-user-portrait" onerror="this.style.opacity='0.5';this.onerror=null;" />
             <span class="rpg-user-name">${userName}</span>
-            <span style="opacity: 0.5;">|</span>
+            ${showLevel ? `<span style="opacity: 0.5;">|</span>
             <span class="rpg-level-label">LVL</span>
-            <span class="rpg-level-value rpg-editable" contenteditable="true" data-field="level" title="Click to edit level">${extensionSettings.level}</span>
+            <span class="rpg-level-value rpg-editable" contenteditable="true" data-field="level" title="Click to edit level">${extensionSettings.level}</span>` : ''}
         </div>
     `;
 
     // Dynamic stats grid - only show enabled stats
+    const showLockIcons = extensionSettings.showLockIcons ?? true;
+    if (showLockIcons) {
+        html += `<span class="rpg-section-lock-icon${lockedClass}" data-tracker="userStats" data-path="stats" title="${lockTitle}">${lockIcon}</span>`;
+    }
     html += '<div class="rpg-stats-grid">';
     const enabledStats = config.customStats.filter(stat => stat && stat.enabled && stat.name && stat.id);
+    const displayMode = config.statsDisplayMode || 'percentage';
 
     for (const stat of enabledStats) {
         const value = stats[stat.id] !== undefined ? stats[stat.id] : 100;
+        const maxValue = stat.maxValue || 100;
+
+        // Calculate percentage for bar fill
+        let percentage;
+        let displayValue;
+
+        if (displayMode === 'number') {
+            // In number mode, value is already the number (0 to maxValue)
+            percentage = maxValue > 0 ? (value / maxValue) * 100 : 100;
+            displayValue = `${value}/${maxValue}`;
+        } else {
+            // In percentage mode, value is 0-100
+            percentage = value;
+            displayValue = `${value}%`;
+        }
+
         html += `
             <div class="rpg-stat-row">
                 <span class="rpg-stat-label rpg-editable-stat-name" contenteditable="true" data-field="${stat.id}" title="Click to edit stat name">${stat.name}:</span>
                 <div class="rpg-stat-bar" style="background: ${gradient}">
-                    <div class="rpg-stat-fill" style="width: ${100 - value}%"></div>
+                    <div class="rpg-stat-fill" style="width: ${100 - percentage}%"></div>
                 </div>
-                <span class="rpg-stat-value rpg-editable-stat" contenteditable="true" data-field="${stat.id}" title="Click to edit">${value}%</span>
+                <span class="rpg-stat-value rpg-editable-stat" contenteditable="true" data-field="${stat.id}" data-max="${maxValue}" data-mode="${displayMode}" title="Click to edit">${displayValue}</span>
             </div>
         `;
     }
@@ -149,7 +332,14 @@ export function renderUserStats() {
 
     // Status section (conditionally rendered)
     if (config.statusSection.enabled) {
+        const isMoodLocked = isItemLocked('userStats', 'status');
+        const moodLockIcon = isMoodLocked ? '🔒' : '🔓';
+        const moodLockTitle = isMoodLocked ? 'Locked - AI cannot change mood' : 'Unlocked - AI can change mood';
+        const moodLockedClass = isMoodLocked ? ' locked' : '';
         html += '<div class="rpg-mood">';
+        if (showLockIcons) {
+            html += `<span class="rpg-section-lock-icon${moodLockedClass}" data-tracker="userStats" data-path="status" title="${moodLockTitle}">${moodLockIcon}</span>`;
+        }
 
         if (config.statusSection.showMoodEmoji) {
             html += `<div class="rpg-mood-emoji rpg-editable" contenteditable="true" data-field="mood" title="Click to edit emoji">${stats.mood}</div>`;
@@ -157,9 +347,18 @@ export function renderUserStats() {
 
         // Render custom status fields
         if (config.statusSection.customFields && config.statusSection.customFields.length > 0) {
-            // For now, use first field as "conditions" for backward compatibility
-            const conditionsValue = stats.conditions || 'None';
-            html += `<div class="rpg-mood-conditions rpg-editable" contenteditable="true" data-field="conditions" title="Click to edit conditions">${conditionsValue}</div>`;
+            for (const fieldName of config.statusSection.customFields) {
+                const fieldKey = toFieldKey(fieldName);
+                let fieldValue = stats[fieldKey] || 'None';
+                // Handle array format (from JSON)
+                if (Array.isArray(fieldValue)) {
+                    fieldValue = fieldValue.join(', ') || 'None';
+                } else if (typeof fieldValue === 'string') {
+                    // Strip brackets if present (from JSON array format)
+                    fieldValue = fieldValue.replace(/^\[|\]$/g, '').trim();
+                }
+                html += `<div class="rpg-mood-conditions rpg-editable" contenteditable="true" data-field="${fieldKey}" title="Click to edit ${fieldName}">${fieldValue}</div>`;
+            }
         }
 
         html += '</div>';
@@ -167,9 +366,24 @@ export function renderUserStats() {
 
     // Skills section (conditionally rendered)
     if (config.skillsSection.enabled) {
-        const skillsValue = stats.skills || 'None';
+        const isSkillsLocked = isItemLocked('userStats', 'skills');
+        const skillsLockIcon = isSkillsLocked ? '🔒' : '🔓';
+        const skillsLockTitle = isSkillsLocked ? 'Locked - AI cannot change skills' : 'Unlocked - AI can change skills';
+        const skillsLockedClass = isSkillsLocked ? ' locked' : '';
+        let skillsValue = 'None';
+        // Handle JSON array format: [{name: "Art"}, {name: "Coding"}]
+        if (Array.isArray(stats.skills)) {
+            skillsValue = stats.skills.map(s => s.name || s).join(', ') || 'None';
+        } else if (stats.skills) {
+            skillsValue = stats.skills;
+        }
+        html += `
+            <div class="rpg-skills-section">`;
+        if (showLockIcons) {
+            html += `
+                <span class="rpg-section-lock-icon${skillsLockedClass}" data-tracker="userStats" data-path="skills" title="${skillsLockTitle}">${skillsLockIcon}</span>`;
+        }
         html += `
-            <div class="rpg-skills-section">
                 <span class="rpg-skills-label">${config.skillsSection.label}:</span>
                 <div class="rpg-skills-value rpg-editable" contenteditable="true" data-field="skills" title="Click to edit skills">${skillsValue}</div>
             </div>
@@ -225,37 +439,56 @@ export function renderUserStats() {
 
     html += '</div>'; // Close rpg-stats-content
 
+    // console.log('[RPG UserStats Render] Generated HTML length:', html.length);
+    // console.log('[RPG UserStats Render] HTML preview:', html.substring(0, 300));
+    // console.log('[RPG UserStats Render] Container exists:', !!$userStatsContainer, '$userStatsContainer length:', $userStatsContainer?.length);
+
+    // Always render to the #rpg-user-stats container (mobile layout just moves it around in DOM)
     $userStatsContainer.html(html);
+    // console.log('[RPG UserStats Render] ✓ HTML rendered to #rpg-user-stats container');
 
     // Add event listeners for editable stat values
     $('.rpg-editable-stat').on('blur', function() {
         const field = $(this).data('field');
-        const textValue = $(this).text().replace('%', '').trim();
-        let value = parseInt(textValue);
+        const mode = $(this).data('mode');
+        const maxValue = parseInt($(this).data('max')) || 100;
+        const textValue = $(this).text().trim();
+        let value;
 
-        // Validate and clamp value between 0 and 100
-        if (isNaN(value)) {
-            value = 0;
+        if (mode === 'number') {
+            // In number mode, parse "X/MAX" or just "X"
+            const parts = textValue.split('/');
+            value = parseInt(parts[0]);
+
+            // Validate and clamp value between 0 and maxValue
+            if (isNaN(value)) {
+                value = 0;
+            }
+            value = Math.max(0, Math.min(maxValue, value));
+        } else {
+            // In percentage mode, parse "X%" or just "X"
+            value = parseInt(textValue.replace('%', ''));
+
+            // Validate and clamp value between 0 and 100
+            if (isNaN(value)) {
+                value = 0;
+            }
+            value = Math.max(0, Math.min(100, value));
         }
-        value = Math.max(0, Math.min(100, value));
 
         // Update the setting
         extensionSettings.userStats[field] = value;
 
-        // Rebuild userStats text with custom stat names
-        const statsText = buildUserStatsText();
-
-        // Update BOTH lastGeneratedData AND committedTrackerData
-        // This makes manual edits immediately visible to AI
-        lastGeneratedData.userStats = statsText;
-        committedTrackerData.userStats = statsText;
+        // Update userStats data (maintains JSON or text format)
+        updateUserStatsData();
 
         saveSettings();
         saveChatData();
         updateMessageSwipeData();
 
-        // Re-render to update the bar
+        // Re-render to update the bar and FAB widgets
         renderUserStats();
+        updateFabWidgets();
     });
 
     // Add event listeners for mood/conditions editing
@@ -263,13 +496,8 @@ export function renderUserStats() {
         const value = $(this).text().trim();
         extensionSettings.userStats.mood = value || '😐';
 
-        // Rebuild userStats text with custom stat names
-        const statsText = buildUserStatsText();
-
-        // Update BOTH lastGeneratedData AND committedTrackerData
-        // This makes manual edits immediately visible to AI
-        lastGeneratedData.userStats = statsText;
-        committedTrackerData.userStats = statsText;
+        // Update userStats data (maintains JSON or text format)
+        updateUserStatsData();
 
         saveSettings();
         saveChatData();
@@ -278,15 +506,11 @@ export function renderUserStats() {
 
     $('.rpg-mood-conditions.rpg-editable').on('blur', function() {
         const value = $(this).text().trim();
-        extensionSettings.userStats.conditions = value || 'None';
+        const fieldKey = $(this).data('field');
+        extensionSettings.userStats[fieldKey] = value || 'None';
 
-        // Rebuild userStats text with custom stat names
-        const statsText = buildUserStatsText();
-
-        // Update BOTH lastGeneratedData AND committedTrackerData
-        // This makes manual edits immediately visible to AI
-        lastGeneratedData.userStats = statsText;
-        committedTrackerData.userStats = statsText;
+        // Update userStats data (maintains JSON or text format)
+        updateUserStatsData();
 
         saveSettings();
         saveChatData();
@@ -298,12 +522,8 @@ export function renderUserStats() {
         const value = $(this).text().trim();
         extensionSettings.userStats.skills = value || 'None';
 
-        // Rebuild userStats text
-        const statsText = buildUserStatsText();
-
-        // Update BOTH lastGeneratedData AND committedTrackerData
-        lastGeneratedData.userStats = statsText;
-        committedTrackerData.userStats = statsText;
+        // Update userStats data (maintains JSON or text format)
+        updateUserStatsData();
 
         saveSettings();
         saveChatData();
@@ -359,4 +579,29 @@ export function renderUserStats() {
             $(this).blur();
         }
     });
+
+// Add event listener for section lock icon clicks (support both click and touch)
+    $('.rpg-section-lock-icon').on('click touchend', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        const $icon = $(this);
+        const trackerType = $icon.data('tracker');
+        const itemPath = $icon.data('path');
+        const currentlyLocked = isItemLocked(trackerType, itemPath);
+
+        // Toggle lock state
+        setItemLock(trackerType, itemPath, !currentlyLocked);
+
+        // Update icon
+        const newIcon = !currentlyLocked ? '🔒' : '🔓';
+        const newTitle = !currentlyLocked ? 'Locked - AI cannot change this section' : 'Unlocked - AI can change this section';
+        $icon.text(newIcon);
+        $icon.attr('title', newTitle);
+
+        // Toggle 'locked' class for persistent visibility
+        $icon.toggleClass('locked', !currentlyLocked);
+
+        // Save settings
+        saveSettings();
+    });
 }

src/systems/ui/checkpointUI.js

@@ -0,0 +1,369 @@
+/**
+ * Chapter Checkpoint UI Module
+ * Adds UI elements for chapter checkpoint functionality
+ */
+
+import { getContext } from '../../../../../../extensions.js';
+import { i18n } from '../../core/i18n.js';
+import {
+    setChapterCheckpoint,
+    clearChapterCheckpoint,
+    isCheckpointMessage
+} from '../features/chapterCheckpoint.js';
+
+/**
+ * Adds the chapter checkpoint button to a message's extra menu
+ * @param {number} messageId - The message index
+ * @param {HTMLElement} menu - The message menu element
+ * @param {boolean} isExpanded - Whether this is for expanded message actions
+ */
+export function addCheckpointButtonToMessage(messageId, menu, isExpanded = false) {
+    if (!menu) return;
+
+    const isCheckpoint = isCheckpointMessage(messageId);
+
+    // Create the menu item
+    const menuItem = document.createElement('div');
+    // Use different classes for expanded vs dropdown menu
+    if (isExpanded) {
+        menuItem.className = 'mes_button';
+        menuItem.setAttribute('tabindex', '0');
+    } else {
+        menuItem.className = 'extraMesButtonsHint list-group-item flex-container flexGap5';
+    }
+
+    const translationKey = isCheckpoint ? 'checkpoint.clearChapterStart' : 'checkpoint.setChapterStart';
+    menuItem.setAttribute('data-i18n', translationKey);
+    menuItem.title = isCheckpoint
+        ? 'Clear Chapter Start'
+        : 'Set Chapter Start — When bookmarked, this message will count as the first message in the chat history, skipping earlier ones.';
+
+    // Icon only (no text label)
+    const icon = document.createElement('i');
+    icon.className = isCheckpoint ? 'fa-solid fa-bookmark' : 'fa-regular fa-bookmark';
+    icon.style.color = isCheckpoint ? '#4a9eff' : '';
+
+    menuItem.appendChild(icon);
+
+    // Click handler
+    menuItem.addEventListener('click', (e) => {
+        e.stopPropagation();
+
+        const wasCheckpoint = isCheckpointMessage(messageId);
+
+        if (wasCheckpoint) {
+            clearChapterCheckpoint();
+        } else {
+            setChapterCheckpoint(messageId);
+        }
+
+        // Update this button immediately
+        const newIsCheckpoint = isCheckpointMessage(messageId);
+        icon.className = newIsCheckpoint ? 'fa-solid fa-bookmark' : 'fa-regular fa-bookmark';
+        icon.style.color = newIsCheckpoint ? '#4a9eff' : '';
+        menuItem.title = newIsCheckpoint
+            ? 'Clear Chapter Start'
+            : 'Set Chapter Start: When bookmarked, this message will count as the first message in the chat history, skipping earlier ones';
+        const newTranslationKey = newIsCheckpoint ? 'checkpoint.clearChapterStart' : 'checkpoint.setChapterStart';
+        menuItem.setAttribute('data-i18n', newTranslationKey);
+
+        // Update indicators in all messages
+        updateAllCheckpointIndicators();
+    });
+
+    return menuItem;
+}
+
+/**
+ * Adds visual indicators to messages that are checkpoints
+ * @param {number} messageId - The message index
+ * @param {HTMLElement} messageBlock - The message DOM element
+ */
+export function addCheckpointIndicator(messageId, messageBlock) {
+    if (!messageBlock) return;
+
+    const isCheckpoint = isCheckpointMessage(messageId);
+
+    // Remove existing indicator if present
+    const existingIndicator = messageBlock.querySelector('.rpg-checkpoint-indicator');
+    if (existingIndicator) {
+        existingIndicator.remove();
+    }
+
+    if (!isCheckpoint) return;
+
+    // Add checkpoint indicator
+    const indicator = document.createElement('div');
+    indicator.className = 'rpg-checkpoint-indicator';
+    const indicatorText = i18n.getTranslation('checkpoint.indicator') || 'Chapter Start';
+    const tooltipText = i18n.getTranslation('checkpoint.tooltip') || 'Messages before this point are excluded from context';
+    indicator.innerHTML = `
+        <i class="fa-solid fa-bookmark"></i>
+        <span>${indicatorText}</span>
+    `;
+    indicator.title = tooltipText;
+
+    // Insert at the beginning of the message
+    const mesText = messageBlock.querySelector('.mes_text');
+    if (mesText && mesText.parentNode) {
+        mesText.parentNode.insertBefore(indicator, mesText);
+    }
+}
+
+/**
+ * Updates checkpoint indicators for all messages
+ */
+export function updateAllCheckpointIndicators() {
+    const context = getContext();
+    const chat = context.chat;
+
+    if (!chat) return;
+
+    // First, remove ALL checkpoint buttons from everywhere
+    document.querySelectorAll('.rpg-checkpoint-button, .rpg-checkpoint-button-expanded').forEach(btn => btn.remove());
+
+    // Update all message blocks
+    const messageBlocks = document.querySelectorAll('.mes');
+    messageBlocks.forEach((block) => {
+        // Get the actual message ID from the mesid attribute
+        const messageId = Number(block.getAttribute('mesid'));
+
+        if (isNaN(messageId)) return;
+
+        addCheckpointIndicator(messageId, block);
+
+        // Re-add buttons based on current mode
+        processExpandedButton(block);
+
+        const dropdownMenu = block.querySelector('.extraMesButtons');
+        if (dropdownMenu) {
+            processExtraMesButtons(dropdownMenu);
+        }
+    });
+}
+
+/**
+ * Removes all checkpoint UI elements
+ */
+export function cleanupCheckpointUI() {
+    // Remove all checkpoint buttons
+    document.querySelectorAll('.rpg-checkpoint-button, .rpg-checkpoint-button-expanded').forEach(btn => btn.remove());
+
+    // Remove all checkpoint indicators (banner)
+    document.querySelectorAll('.rpg-checkpoint-indicator').forEach(indicator => indicator.remove());
+}
+
+/**
+ * Initializes the chapter checkpoint UI
+ */
+export function initChapterCheckpointUI() {
+    // Listen for checkpoint changes
+    document.addEventListener('rpg-companion-checkpoint-changed', () => {
+        updateAllCheckpointIndicators();
+    });
+
+    // Listen for expandMessageActions class changes on body
+    const bodyObserver = new MutationObserver((mutations) => {
+        mutations.forEach((mutation) => {
+            if (mutation.type === 'attributes' && mutation.attributeName === 'class') {
+                // The expandMessageActions class was toggled, refresh all buttons
+                updateAllCheckpointIndicators();
+            }
+        });
+    });
+    bodyObserver.observe(document.body, { attributes: true, attributeFilter: ['class'] });
+
+    // Listen for chat changes to update indicators
+    const context = getContext();
+    if (context && context.eventSource) {
+        // Update checkpoint indicators when messages are rendered
+        const observer = new MutationObserver((mutations) => {
+            let shouldUpdate = false;
+            mutations.forEach((mutation) => {
+                mutation.addedNodes.forEach((node) => {
+                    if (node.nodeType === Node.ELEMENT_NODE &&
+                        node.classList && node.classList.contains('mes')) {
+                        shouldUpdate = true;
+                    }
+                });
+            });
+
+            if (shouldUpdate) {
+                // Debounce updates to avoid excessive re-rendering
+                clearTimeout(window.rpgCheckpointUpdateTimeout);
+                window.rpgCheckpointUpdateTimeout = setTimeout(() => {
+                    updateAllCheckpointIndicators();
+                }, 100);
+            }
+        });
+
+        const chatContainer = document.getElementById('chat');
+        if (chatContainer) {
+            observer.observe(chatContainer, {
+                childList: true,
+                subtree: false
+            });
+        }
+    }
+
+    // Update indicators on initialization
+    updateAllCheckpointIndicators();
+}
+
+/**
+ * Injects checkpoint button into message menus
+ * This should be called when SillyTavern renders message menus
+ */
+export function injectCheckpointButton() {
+    // Observer for dropdown menus and message blocks
+    const observer = new MutationObserver((mutations) => {
+        mutations.forEach((mutation) => {
+            // Check for added nodes
+            mutation.addedNodes.forEach((node) => {
+                if (node.nodeType === Node.ELEMENT_NODE) {
+                    // Check if extraMesButtons container was added (dropdown menu)
+                    if (node.classList && node.classList.contains('extraMesButtons')) {
+                        processExtraMesButtons(node);
+                    }
+
+                    // Check if message block was added (for expanded buttons)
+                    if (node.classList && node.classList.contains('mes')) {
+                        processExpandedButton(node);
+                    }
+
+                    // Also check if any exist within added subtree
+                    if (node.querySelector) {
+                        const extraButtons = node.querySelectorAll('.extraMesButtons');
+                        extraButtons.forEach(processExtraMesButtons);
+
+                        const messageBlocks = node.querySelectorAll('.mes');
+                        messageBlocks.forEach(processExpandedButton);
+                    }
+                }
+            });
+
+            // Check if nodes were added TO an extraMesButtons container
+            if (mutation.target && mutation.target.classList &&
+                mutation.target.classList.contains('extraMesButtons')) {
+                processExtraMesButtons(mutation.target);
+            }
+        });
+    });
+
+    // Observe the chat container
+    const chatContainer = document.getElementById('chat');
+    if (chatContainer) {
+        observer.observe(chatContainer, {
+            childList: true,
+            subtree: true
+        });
+
+        // Process any existing dropdown menus and messages on initialization
+        // Use setTimeout to ensure styles are computed
+        setTimeout(() => {
+            const existingDropdownMenus = chatContainer.querySelectorAll('.extraMesButtons');
+            existingDropdownMenus.forEach(processExtraMesButtons);
+
+            const existingMessages = chatContainer.querySelectorAll('.mes');
+            existingMessages.forEach(processExpandedButton);
+        }, 100);
+    }
+}
+
+/**
+ * Process an extraMesButtons container to add checkpoint button (dropdown menu)
+ * @param {HTMLElement} menu - The extraMesButtons container
+ */
+function processExtraMesButtons(menu) {
+    if (!menu) return;
+
+    // Find the message block
+    const messageBlock = menu.closest('.mes');
+    if (!messageBlock) return;
+
+    // Get the message ID from the mesid attribute (SillyTavern's standard way)
+    const messageId = Number(messageBlock.getAttribute('mesid'));
+
+    if (isNaN(messageId)) return;
+
+    // Check if expanded mode is active - if so, skip dropdown
+    if (document.body.classList.contains('expandMessageActions')) {
+        return; // Expanded mode is ON, button will be added to mes_buttons instead
+    }
+
+    // Check if button already exists in this container
+    if (menu.querySelector('.rpg-checkpoint-button')) return;
+
+    // Add checkpoint button to dropdown menu
+    const checkpointBtn = addCheckpointButtonToMessage(messageId, menu, false);
+    if (checkpointBtn) {
+        checkpointBtn.classList.add('rpg-checkpoint-button');
+        menu.appendChild(checkpointBtn);
+    }
+}
+
+/**
+ * Process a message block to add expanded checkpoint button
+ * @param {HTMLElement} messageBlock - The message block element
+ */
+function processExpandedButton(messageBlock) {
+    if (!messageBlock) return;
+
+    const mesButtons = messageBlock.querySelector('.mes_buttons');
+    if (!mesButtons) return;
+
+    // Only add if expanded mode is ON (check body class)
+    if (!document.body.classList.contains('expandMessageActions')) {
+        return; // Expanded mode is OFF, button will be in dropdown instead
+    }
+
+    const messageId = Number(messageBlock.getAttribute('mesid'));
+    if (isNaN(messageId)) return;
+
+    // Check if button already exists in this container
+    if (mesButtons.querySelector('.rpg-checkpoint-button-expanded')) return;
+
+    // Add checkpoint button as separate mes_button
+    const checkpointBtn = addCheckpointButtonToMessage(messageId, mesButtons, true);
+    if (checkpointBtn) {
+        checkpointBtn.classList.add('rpg-checkpoint-button-expanded');
+
+        // Insert before the edit button if it exists, otherwise append
+        const editButton = mesButtons.querySelector('.mes_edit');
+        if (editButton) {
+            mesButtons.insertBefore(checkpointBtn, editButton);
+        } else {
+            mesButtons.appendChild(checkpointBtn);
+        }
+    }
+}
+
+
+/**
+ * Update the checkpoint button in an existing menu
+ * @param {HTMLElement} menu - The extraMesButtons or mes_buttons container
+ * @param {number} messageId - The message index
+ */
+function updateCheckpointButtonInMenu(menu, messageId) {
+    if (!menu) return;
+
+    // Find the checkpoint button (either dropdown or expanded)
+    const existingButton = menu.querySelector('.rpg-checkpoint-button, .rpg-checkpoint-button-expanded');
+    if (!existingButton) return;
+
+    const isCheckpoint = isCheckpointMessage(messageId);
+
+    // Update icon
+    const icon = existingButton.querySelector('i');
+    if (icon) {
+        icon.className = isCheckpoint ? 'fa-solid fa-bookmark' : 'fa-regular fa-bookmark';
+        icon.style.color = isCheckpoint ? '#4a9eff' : '';
+    }
+
+    // Update tooltip
+    existingButton.title = isCheckpoint
+        ? 'Clear Chapter Start'
+        : 'Set Chapter Start — When bookmarked, this message will count as the first message in the chat history, skipping earlier ones.';
+    const translationKey = isCheckpoint ? 'checkpoint.clearChapterStart' : 'checkpoint.setChapterStart';
+    existingButton.setAttribute('data-i18n', translationKey);
+}

src/systems/ui/debug.js

@@ -1,220 +0,0 @@
-/**
- * Debug UI Module
- * Provides mobile-friendly debug log viewer for troubleshooting parsing issues
- */
-
-import { extensionSettings, getDebugLogs, clearDebugLogs } from '../../core/state.js';
-
-/**
- * Creates and injects the debug panel into the page
- * Note: Debug toggle button is created in index.js, not here
- */
-export function createDebugPanel() {
-    // Remove existing debug panel if any
-    $('#rpg-debug-panel').remove();
-
-    // Create debug panel HTML
-    const debugPanelHtml = `
-        <div id="rpg-debug-panel" class="rpg-debug-panel">
-            <div class="rpg-debug-header">
-                <h3>🔍 Debug Logs</h3>
-                <div class="rpg-debug-actions">
-                    <button id="rpg-debug-copy" title="Copy logs to clipboard">
-                        <i class="fa-solid fa-copy"></i>
-                    </button>
-                    <button id="rpg-debug-clear" title="Clear logs">
-                        <i class="fa-solid fa-trash"></i>
-                    </button>
-                    <button id="rpg-debug-close" title="Close debug panel">
-                        <i class="fa-solid fa-xmark"></i>
-                    </button>
-                </div>
-            </div>
-            <div id="rpg-debug-logs" class="rpg-debug-logs"></div>
-        </div>
-    `;
-
-    // Append to body
-    $('body').append(debugPanelHtml);
-
-    // Set up event handlers
-    setupDebugEventHandlers();
-
-    // Initial log render
-    renderDebugLogs();
-}
-
-/**
- * Closes the debug panel with proper animation (mobile or desktop)
- */
-function closeDebugPanel() {
-    const $panel = $('#rpg-debug-panel');
-    const isMobile = window.innerWidth <= 1000;
-
-    if (isMobile) {
-        // Mobile: animate slide-out to right
-        $panel.removeClass('rpg-mobile-open').addClass('rpg-mobile-closing');
-
-        // Wait for animation to complete before hiding
-        $panel.one('animationend', function() {
-            $panel.removeClass('rpg-mobile-closing');
-            $('.rpg-mobile-overlay').remove();
-        });
-    } else {
-        // Desktop: simple slide-down
-        $panel.removeClass('rpg-debug-open');
-    }
-}
-
-/**
- * Sets up event handlers for debug panel using event delegation for mobile compatibility
- */
-function setupDebugEventHandlers() {
-    // Use event delegation for better mobile compatibility and reliability with dynamic elements
-    // Remove any existing handlers first to prevent duplicates
-    $(document).off('click.rpgDebug');
-
-    // Toggle button
-    $(document).on('click.rpgDebug', '#rpg-debug-toggle', function() {
-        const $debugToggle = $(this);
-
-        // Skip if we just finished dragging
-        if ($debugToggle.data('just-dragged')) {
-            console.log('[RPG Debug] Click blocked - just finished dragging');
-            return;
-        }
-
-        const $panel = $('#rpg-debug-panel');
-        const isMobile = window.innerWidth <= 1000;
-
-        if (isMobile) {
-            // Mobile: use rpg-mobile-open class with slide-from-right animation
-            const isOpen = $panel.hasClass('rpg-mobile-open');
-
-            if (isOpen) {
-                // Close with animation
-                closeDebugPanel();
-            } else {
-                // Open with animation
-                $panel.addClass('rpg-mobile-open');
-                renderDebugLogs();
-
-                // Create overlay for mobile
-                const $overlay = $('<div class="rpg-mobile-overlay"></div>');
-                $('body').append($overlay);
-
-                // Close when clicking overlay
-                $overlay.on('click', function() {
-                    closeDebugPanel();
-                });
-            }
-        } else {
-            // Desktop: use rpg-debug-open class with slide-from-bottom animation
-            $panel.toggleClass('rpg-debug-open');
-            renderDebugLogs();
-        }
-    });
-
-    // Close button
-    $(document).on('click.rpgDebug', '#rpg-debug-close', function(e) {
-        e.preventDefault();
-        e.stopPropagation();
-        closeDebugPanel();
-    });
-
-    // Copy button
-    $(document).on('click.rpgDebug', '#rpg-debug-copy', function() {
-        const logs = getDebugLogs();
-        const logsText = logs.map(log => {
-            let text = `[${log.timestamp}] ${log.message}`;
-            if (log.data) {
-                text += `\n${log.data}`;
-            }
-            return text;
-        }).join('\n\n');
-
-        navigator.clipboard.writeText(logsText).then(() => {
-            // Show feedback
-            const $btn = $(this);
-            const $icon = $btn.find('i');
-            $icon.removeClass('fa-copy').addClass('fa-check');
-            setTimeout(() => {
-                $icon.removeClass('fa-check').addClass('fa-copy');
-            }, 1500);
-        }).catch(err => {
-            console.error('Failed to copy logs:', err);
-            alert('Failed to copy logs. Please use browser console instead.');
-        });
-    });
-
-    // Clear button
-    $(document).on('click.rpgDebug', '#rpg-debug-clear', function() {
-        if (confirm('Clear all debug logs?')) {
-            clearDebugLogs();
-            renderDebugLogs();
-        }
-    });
-}
-
-/**
- * Renders debug logs to the panel
- */
-function renderDebugLogs() {
-    const logs = getDebugLogs();
-    const $logsContainer = $('#rpg-debug-logs');
-
-    if (logs.length === 0) {
-        $logsContainer.html('<div class="rpg-debug-empty">No logs yet. Logs will appear when parser runs.</div>');
-        return;
-    }
-
-    // Build logs HTML
-    const logsHtml = logs.map(log => {
-        let html = `<div class="rpg-debug-entry">`;
-        html += `<span class="rpg-debug-time">[${log.timestamp}]</span> `;
-        html += `<span class="rpg-debug-message">${escapeHtml(log.message)}</span>`;
-        if (log.data) {
-            html += `<pre class="rpg-debug-data">${escapeHtml(log.data)}</pre>`;
-        }
-        html += `</div>`;
-        return html;
-    }).join('');
-
-    $logsContainer.html(logsHtml);
-
-    // Auto-scroll to bottom
-    $logsContainer[0].scrollTop = $logsContainer[0].scrollHeight;
-}
-
-/**
- * Escapes HTML to prevent XSS
- */
-function escapeHtml(text) {
-    const div = document.createElement('div');
-    div.textContent = text;
-    return div.innerHTML;
-}
-
-/**
- * Shows or hides debug UI based on debug mode setting
- * Note: Debug toggle button always exists in DOM (created in index.js)
- */
-export function updateDebugUIVisibility() {
-    const $debugToggle = $('#rpg-debug-toggle');
-
-    if (extensionSettings.debugMode) {
-        // Show debug toggle button
-        $debugToggle.css('display', 'flex');
-
-        // Create debug panel if it doesn't exist
-        if ($('#rpg-debug-panel').length === 0) {
-            createDebugPanel();
-        }
-    } else {
-        // Hide debug toggle button
-        $debugToggle.css('display', 'none');
-
-        // Remove debug panel
-        $('#rpg-debug-panel').remove();
-    }
-}

src/systems/ui/desktop.js

@@ -1,9 +1,277 @@
 /**
  * Desktop UI Module
- * Handles desktop-specific UI functionality: tab navigation
+ * Handles desktop-specific UI functionality: tab navigation and strip widgets
  */
 
 import { i18n } from '../../core/i18n.js';
+import { extensionSettings, lastGeneratedData, committedTrackerData } from '../../core/state.js';
+import { hexToRgba } from './theme.js';
+
+/**
+ * Helper to parse time string and calculate clock hand angles
+ */
+function parseTimeForClock(timeStr) {
+    const timeMatch = timeStr.match(/(\d+):(\d+)/);
+    if (timeMatch) {
+        const hours = parseInt(timeMatch[1]);
+        const minutes = parseInt(timeMatch[2]);
+        const hourAngle = (hours % 12) * 30 + minutes * 0.5; // 30° per hour + 0.5° per minute
+        const minuteAngle = minutes * 6; // 6° per minute
+        return { hourAngle, minuteAngle };
+    }
+    return { hourAngle: 0, minuteAngle: 0 };
+}
+
+/**
+ * Updates the desktop strip widgets display based on current tracker data and settings.
+ * Strip widgets are shown vertically in the collapsed panel strip.
+ */
+export function updateStripWidgets() {
+    const $panel = $('#rpg-companion-panel');
+    const $container = $('#rpg-strip-widget-container');
+
+    if ($panel.length === 0 || $container.length === 0) return;
+
+    // Check if strip widgets are enabled
+    const widgetSettings = extensionSettings.desktopStripWidgets;
+    if (!widgetSettings || !widgetSettings.enabled) {
+        $panel.removeClass('rpg-strip-widgets-enabled');
+        $container.find('.rpg-strip-widget').removeClass('rpg-strip-widget-visible');
+        return;
+    }
+
+    // Add enabled class to panel for CSS styling (wider collapsed width)
+    $panel.addClass('rpg-strip-widgets-enabled');
+
+    // Get tracker data - use imported state directly
+    const infoBox = lastGeneratedData?.infoBox || committedTrackerData?.infoBox;
+
+    // Parse infoBox if it's a string
+    let infoData = null;
+    if (infoBox) {
+        try {
+            infoData = typeof infoBox === 'string' ? JSON.parse(infoBox) : infoBox;
+        } catch (e) {
+            console.warn('[RPG Strip Widgets] Failed to parse infoBox:', e);
+        }
+    }
+
+    // Weather Icon Widget (with description)
+    const $weatherWidget = $container.find('.rpg-strip-widget-weather');
+    if (widgetSettings.weatherIcon?.enabled && infoData?.weather?.emoji) {
+        $weatherWidget.find('.rpg-strip-widget-icon').text(infoData.weather.emoji);
+        // Show weather description truncated
+        const forecast = infoData.weather.forecast || '';
+        const displayForecast = forecast.length > 12 ? forecast.substring(0, 10) + '…' : forecast;
+        $weatherWidget.find('.rpg-strip-widget-desc').text(displayForecast);
+        $weatherWidget.attr('title', forecast || 'Weather');
+        $weatherWidget.addClass('rpg-strip-widget-visible');
+    } else {
+        $weatherWidget.removeClass('rpg-strip-widget-visible');
+    }
+
+    // Clock Widget with animated face
+    const $clockWidget = $container.find('.rpg-strip-widget-clock');
+    if (widgetSettings.clock?.enabled && infoData?.time) {
+        const timeStr = infoData.time.end || infoData.time.value || infoData.time.start || '';
+        if (timeStr) {
+            // Update clock hands
+            const { hourAngle, minuteAngle } = parseTimeForClock(timeStr);
+            $clockWidget.find('.rpg-strip-clock-hour').css('transform', `rotate(${hourAngle}deg)`);
+            $clockWidget.find('.rpg-strip-clock-minute').css('transform', `rotate(${minuteAngle}deg)`);
+            $clockWidget.find('.rpg-strip-widget-value').text(timeStr);
+            $clockWidget.attr('title', `Time: ${timeStr}`);
+            $clockWidget.addClass('rpg-strip-widget-visible');
+        } else {
+            $clockWidget.removeClass('rpg-strip-widget-visible');
+        }
+    } else {
+        $clockWidget.removeClass('rpg-strip-widget-visible');
+    }
+
+    // Date Widget
+    const $dateWidget = $container.find('.rpg-strip-widget-date');
+    if (widgetSettings.date?.enabled && infoData?.date?.value) {
+        const dateVal = infoData.date.value;
+        // Truncate long dates for display
+        const displayDate = dateVal.length > 20 ? dateVal.substring(0, 18) + '…' : dateVal;
+        $dateWidget.find('.rpg-strip-widget-value').text(displayDate);
+        $dateWidget.attr('title', dateVal);
+        $dateWidget.addClass('rpg-strip-widget-visible');
+    } else {
+        $dateWidget.removeClass('rpg-strip-widget-visible');
+    }
+
+    // Location Widget
+    const $locationWidget = $container.find('.rpg-strip-widget-location');
+    if (widgetSettings.location?.enabled && infoData?.location?.value) {
+        const loc = infoData.location.value;
+        // Truncate long locations for display
+        const displayLoc = loc.length > 15 ? loc.substring(0, 13) + '…' : loc;
+        $locationWidget.find('.rpg-strip-widget-value').text(displayLoc);
+        $locationWidget.attr('title', loc);
+        $locationWidget.addClass('rpg-strip-widget-visible');
+    } else {
+        $locationWidget.removeClass('rpg-strip-widget-visible');
+    }
+
+    // Stats Widget - get from lastGeneratedData or committedTrackerData first, fallback to extensionSettings
+    const $statsWidget = $container.find('.rpg-strip-widget-stats');
+    if (widgetSettings.stats?.enabled) {
+        let allStats = [];
+
+        // Try to get stats from tracker data first (most current)
+        const userStatsData = lastGeneratedData?.userStats || committedTrackerData?.userStats;
+        if (userStatsData) {
+            try {
+                const parsedStats = typeof userStatsData === 'string' ? JSON.parse(userStatsData) : userStatsData;
+                if (parsedStats?.stats) {
+                    allStats = parsedStats.stats;
+                }
+            } catch (e) {
+                console.warn('[RPG Strip Widgets] Failed to parse tracker userStats:', e);
+            }
+        }
+
+        // Fallback to extensionSettings.userStats
+        if (allStats.length === 0 && extensionSettings.userStats) {
+            try {
+                const userStatsJson = extensionSettings.userStats;
+                const parsedUserStats = typeof userStatsJson === 'string' ? JSON.parse(userStatsJson) : userStatsJson;
+                if (parsedUserStats?.stats) {
+                    allStats = parsedUserStats.stats;
+                }
+            } catch (e) {
+                console.warn('[RPG Strip Widgets] Failed to parse extensionSettings.userStats:', e);
+            }
+        }
+
+        if (allStats.length > 0) {
+            // Get enabled stats from trackerConfig
+            const configuredStats = extensionSettings.trackerConfig?.userStats?.customStats || [];
+            const enabledStatMap = new Map();
+            configuredStats.forEach(s => {
+                if (s.enabled !== false) {
+                    enabledStatMap.set(s.id?.toLowerCase(), true);
+                    enabledStatMap.set(s.name?.toLowerCase(), true);
+                }
+            });
+
+            const $statsList = $statsWidget.find('.rpg-strip-stats-list');
+            $statsList.empty();
+
+            allStats.forEach(stat => {
+                // Filter by config if available - but if no config, show all
+                if (configuredStats.length > 0) {
+                    const statId = stat.id?.toLowerCase();
+                    const statName = stat.name?.toLowerCase();
+                    if (!enabledStatMap.has(statId) && !enabledStatMap.has(statName)) return;
+                }
+
+                const value = typeof stat.value === 'number' ? stat.value : parseInt(stat.value) || 0;
+                const color = getStatColor(value);
+                const abbr = stat.name.substring(0, 3).toUpperCase();
+
+                const $item = $(`<div class="rpg-strip-stat-item" title="${stat.name}: ${value}">
+                    <span class="rpg-strip-stat-name">${abbr}</span>
+                    <span class="rpg-strip-stat-value" style="color: ${color};">${value}</span>
+                </div>`);
+                $statsList.append($item);
+            });
+
+            if ($statsList.children().length > 0) {
+                $statsWidget.addClass('rpg-strip-widget-visible');
+            } else {
+                $statsWidget.removeClass('rpg-strip-widget-visible');
+            }
+        } else {
+            $statsWidget.removeClass('rpg-strip-widget-visible');
+        }
+    } else {
+        $statsWidget.removeClass('rpg-strip-widget-visible');
+    }
+
+    // Attributes Widget
+    const $attrsWidget = $container.find('.rpg-strip-widget-attributes');
+    if (widgetSettings.attributes?.enabled) {
+        const showRPGAttributes = extensionSettings.trackerConfig?.userStats?.showRPGAttributes !== false;
+
+        if (showRPGAttributes && extensionSettings.classicStats) {
+            // Get enabled attributes from trackerConfig
+            const configuredAttrs = extensionSettings.trackerConfig?.userStats?.rpgAttributes || [];
+            const enabledAttrIds = configuredAttrs.filter(a => a.enabled !== false).map(a => a.id);
+
+            const attrs = extensionSettings.classicStats;
+            const $attrsGrid = $attrsWidget.find('.rpg-strip-attributes-grid');
+            $attrsGrid.empty();
+
+            Object.entries(attrs).forEach(([key, value]) => {
+                // Filter by config if available
+                if (enabledAttrIds.length > 0 && !enabledAttrIds.includes(key.toLowerCase())) {
+                    return;
+                }
+
+                const $item = $(`<div class="rpg-strip-attr-item" title="${key.toUpperCase()}: ${value}">
+                    <span class="rpg-strip-attr-name">${key.toUpperCase()}</span>
+                    <span class="rpg-strip-attr-value">${value}</span>
+                </div>`);
+                $attrsGrid.append($item);
+            });
+
+            if ($attrsGrid.children().length > 0) {
+                $attrsWidget.addClass('rpg-strip-widget-visible');
+            } else {
+                $attrsWidget.removeClass('rpg-strip-widget-visible');
+            }
+        } else {
+            $attrsWidget.removeClass('rpg-strip-widget-visible');
+        }
+    } else {
+        $attrsWidget.removeClass('rpg-strip-widget-visible');
+    }
+}
+
+/**
+ * Gets a color interpolated between low and high based on stat value (0-100).
+ * @param {number} value - The stat value (0-100)
+ * @returns {string} CSS color value
+ */
+function getStatColor(value) {
+    const lowColor = extensionSettings.statBarColorLow || '#cc3333';
+    const lowOpacity = extensionSettings.statBarColorLowOpacity ?? 100;
+    const highColor = extensionSettings.statBarColorHigh || '#33cc66';
+    const highOpacity = extensionSettings.statBarColorHighOpacity ?? 100;
+
+    // Simple linear interpolation between low and high colors
+    const percent = Math.min(100, Math.max(0, value)) / 100;
+
+    // Parse colors
+    const lowRGB = hexToRgb(lowColor);
+    const highRGB = hexToRgb(highColor);
+
+    if (!lowRGB || !highRGB) return value > 50 ? hexToRgba(highColor, highOpacity) : hexToRgba(lowColor, lowOpacity);
+
+    const r = Math.round(lowRGB.r + (highRGB.r - lowRGB.r) * percent);
+    const g = Math.round(lowRGB.g + (highRGB.g - lowRGB.g) * percent);
+    const b = Math.round(lowRGB.b + (highRGB.b - lowRGB.b) * percent);
+    const a = (lowOpacity + (highOpacity - lowOpacity) * percent) / 100;
+
+    return `rgba(${r}, ${g}, ${b}, ${a})`;
+}
+
+/**
+ * Converts a hex color to RGB object.
+ * @param {string} hex - Hex color string (e.g., "#cc3333")
+ * @returns {{r: number, g: number, b: number}|null}
+ */
+function hexToRgb(hex) {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result ? {
+        r: parseInt(result[1], 16),
+        g: parseInt(result[2], 16),
+        b: parseInt(result[3], 16)
+    } : null;
+}
 
 /**
  * Sets up desktop tab navigation for organizing content.
@@ -31,23 +299,40 @@ export function setupDesktopTabs() {
         return;
     }
 
-    // Create tab navigation
-    const $tabNav = $(`
-        <div class="rpg-tabs-nav">
-            <button class="rpg-tab-btn active" data-tab="status">
-                <i class="fa-solid fa-chart-simple"></i>
-                <span data-i18n-key="global.status">Status</span>
-            </button>
+    // Build tab navigation dynamically based on enabled settings
+    const tabButtons = [];
+    const hasInventory = $inventory.length > 0 && extensionSettings.showInventory;
+    const hasQuests = $quests.length > 0 && extensionSettings.showQuests;
+
+    // Status tab (always present if any status content exists)
+    tabButtons.push(`
+        <button class="rpg-tab-btn active" data-tab="status">
+            <i class="fa-solid fa-chart-simple"></i>
+            <span data-i18n-key="global.status">Status</span>
+        </button>
+    `);
+
+    // Inventory tab (only if enabled in settings)
+    if (hasInventory) {
+        tabButtons.push(`
             <button class="rpg-tab-btn" data-tab="inventory">
                 <i class="fa-solid fa-box"></i>
                 <span data-i18n-key="global.inventory">Inventory</span>
             </button>
+        `);
+    }
+
+    // Quests tab (only if enabled in settings)
+    if (hasQuests) {
+        tabButtons.push(`
             <button class="rpg-tab-btn" data-tab="quests">
                 <i class="fa-solid fa-scroll"></i>
                 <span data-i18n-key="global.quests">Quests</span>
             </button>
-        </div>
-    `);
+        `);
+    }
+
+    const $tabNav = $(`<div class="rpg-tabs-nav">${tabButtons.join('')}</div>`);
 
     // Create tab content containers
     const $statusTab = $('<div class="rpg-tab-content active" data-tab-content="status"></div>');
@@ -57,23 +342,29 @@ export function setupDesktopTabs() {
     // Move sections into their respective tabs (detach to preserve event handlers)
     if ($userStats.length > 0) {
         $statusTab.append($userStats.detach());
-        $userStats.show();
+        if (extensionSettings.showUserStats) $userStats.show();
     }
     if ($infoBox.length > 0) {
         $statusTab.append($infoBox.detach());
-        $infoBox.show();
+        // Only show if enabled and has data
+        if (extensionSettings.showInfoBox) {
+            const infoBoxData = window.lastGeneratedData?.infoBox || window.committedTrackerData?.infoBox;
+            if (infoBoxData) $infoBox.show();
+        }
     }
     if ($thoughts.length > 0) {
         $statusTab.append($thoughts.detach());
-        $thoughts.show();
+        if (extensionSettings.showCharacterThoughts) $thoughts.show();
     }
     if ($inventory.length > 0) {
         $inventoryTab.append($inventory.detach());
-        $inventory.show();
+        // Only show if enabled (will be part of tab structure)
+        if (hasInventory) $inventory.show();
     }
     if ($quests.length > 0) {
         $questsTab.append($quests.detach());
-        $quests.show();
+        // Only show if enabled (will be part of tab structure)
+        if (hasQuests) $quests.show();
     }
 
     // Hide dividers on desktop tabs (tabs separate content naturally)
@@ -83,6 +374,9 @@ export function setupDesktopTabs() {
     const $tabsContainer = $('<div class="rpg-tabs-container"></div>');
     $tabsContainer.append($tabNav);
     $tabsContainer.append($statusTab);
+
+    // Always append inventory and quests tabs to preserve the elements
+    // But they'll only show if enabled (via tab button visibility)
     $tabsContainer.append($inventoryTab);
     $tabsContainer.append($questsTab);
 
@@ -103,7 +397,7 @@ export function setupDesktopTabs() {
         $(`.rpg-tab-content[data-tab-content="${tabName}"]`).addClass('active');
     });
 
-    console.log('[RPG Desktop] Desktop tabs initialized');
+
 }
 
 /**
@@ -145,12 +439,14 @@ export function removeDesktopTabs() {
         $contentBox.append($quests);
     }
 
-    // Show sections and dividers
-    $userStats.show();
-    $infoBox.show();
-    $thoughts.show();
-    $inventory.show();
+    // Show/hide sections based on settings (respect visibility settings)
+    if (extensionSettings.showUserStats) $userStats.show();
+    if (extensionSettings.showInfoBox) {
+        const infoBoxData = window.lastGeneratedData?.infoBox || window.committedTrackerData?.infoBox;
+        if (infoBoxData) $infoBox.show();
+    }
+    if (extensionSettings.showCharacterThoughts) $thoughts.show();
+    if (extensionSettings.showInventory) $inventory.show();
+    if (extensionSettings.showQuests) $quests.show();
     $('.rpg-divider').show();
-
-    console.log('[RPG Desktop] Desktop tabs removed');
 }

src/systems/ui/layout.js

@@ -9,15 +9,51 @@ import {
     $userStatsContainer,
     $infoBoxContainer,
     $thoughtsContainer,
-    $inventoryContainer
+    $inventoryContainer,
+    $questsContainer,
+    $musicPlayerContainer,
+    setInventoryContainer,
+    setQuestsContainer,
+    lastGeneratedData,
+    committedTrackerData
 } from '../../core/state.js';
 import { i18n } from '../../core/i18n.js';
+import { setupMobileTabs, removeMobileTabs } from './mobile.js';
+import { setupDesktopTabs, removeDesktopTabs, updateStripWidgets } from './desktop.js';
 
 /**
  * Toggles the visibility of plot buttons based on settings.
  */
 export function togglePlotButtons() {
-    if (extensionSettings.enablePlotButtons && extensionSettings.enabled) {
+    if (!extensionSettings.enabled) {
+        $('#rpg-plot-buttons').hide();
+        return;
+    }
+
+    // Show/hide randomized plot button based on enableRandomizedPlot setting
+    if (extensionSettings.enableRandomizedPlot) {
+        $('#rpg-plot-random').show();
+    } else {
+        $('#rpg-plot-random').hide();
+    }
+
+    // Show/hide natural plot button based on enableNaturalPlot setting
+    if (extensionSettings.enableNaturalPlot) {
+        $('#rpg-plot-natural').show();
+    } else {
+        $('#rpg-plot-natural').hide();
+    }
+
+    // Show/hide encounter button independently based on encounter settings
+    if (extensionSettings.encounterSettings?.enabled) {
+        $('#rpg-encounter-button').show();
+    } else {
+        $('#rpg-encounter-button').hide();
+    }
+
+    // Show the container if at least one button is visible
+    const shouldShowContainer = extensionSettings.enableRandomizedPlot || extensionSettings.enableNaturalPlot || extensionSettings.encounterSettings?.enabled;
+    if (shouldShowContainer) {
         $('#rpg-plot-buttons').show();
     } else {
         $('#rpg-plot-buttons').hide();
@@ -52,19 +88,34 @@ export function updateCollapseToggleIcon() {
     const isMobile = window.innerWidth <= 1000;
 
     if (isMobile) {
-        // Mobile: slides from right, use same icon logic as desktop right panel
+        // Mobile: icon direction based on panel position and open state
         const isOpen = $panel.hasClass('rpg-mobile-open');
-        console.log('[RPG Mobile] updateCollapseToggleIcon:', {
-            isMobile: true,
-            isOpen,
-            settingIcon: isOpen ? 'chevron-left' : 'chevron-right'
-        });
-        if (isOpen) {
-            // Panel open - chevron points left (to close/slide back right)
-            $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-right').addClass('fa-chevron-left');
+        const isLeftPanel = $panel.hasClass('rpg-position-left');
+
+        // console.log('[RPG Mobile] updateCollapseToggleIcon:', {
+        //     isMobile: true,
+        //     isOpen,
+        //     isLeftPanel,
+        //     settingIcon: isOpen ? (isLeftPanel ? 'chevron-left' : 'chevron-right') : (isLeftPanel ? 'chevron-right' : 'chevron-left')
+        // });
+
+        if (isLeftPanel) {
+            if (isOpen) {
+                // Left panel open - chevron points left (panel will slide left to close)
+                $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-right').addClass('fa-chevron-left');
+            } else {
+                // Left panel closed - chevron points left (panel is hidden on left)
+                $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-right').addClass('fa-chevron-left');
+            }
         } else {
-            // Panel closed - chevron points right (to open/slide in from right)
-            $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-left').addClass('fa-chevron-right');
+            // Right panel (default)
+            if (isOpen) {
+                // Right panel open - chevron points right (panel will slide right to close)
+                $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-left').addClass('fa-chevron-right');
+            } else {
+                // Right panel closed - chevron points right (panel is hidden on right)
+                $icon.removeClass('fa-chevron-down fa-chevron-up fa-chevron-left').addClass('fa-chevron-right');
+            }
         }
     } else {
         // Desktop: icon direction based on panel position and collapsed state
@@ -106,44 +157,44 @@ export function setupCollapseToggle() {
         // On mobile: button toggles panel open/closed (same as desktop behavior)
         if (isMobile) {
             const isOpen = $panel.hasClass('rpg-mobile-open');
-            console.log('[RPG Mobile] Collapse toggle clicked. Current state:', {
-                isOpen,
-                panelClasses: $panel.attr('class'),
-                inlineStyles: $panel.attr('style'),
-                panelPosition: {
-                    top: $panel.css('top'),
-                    bottom: $panel.css('bottom'),
-                    transform: $panel.css('transform'),
-                    visibility: $panel.css('visibility')
-                }
-            });
+            // console.log('[RPG Mobile] Collapse toggle clicked. Current state:', {
+            //     isOpen,
+            //     panelClasses: $panel.attr('class'),
+            //     inlineStyles: $panel.attr('style'),
+            //     panelPosition: {
+            //         top: $panel.css('top'),
+            //         bottom: $panel.css('bottom'),
+            //         transform: $panel.css('transform'),
+            //         visibility: $panel.css('visibility')
+            //     }
+            // });
 
             if (isOpen) {
                 // Close panel with animation
-                console.log('[RPG Mobile] Closing panel');
+                // console.log('[RPG Mobile] Closing panel');
                 closeMobilePanelWithAnimation();
             } else {
                 // Open panel
-                console.log('[RPG Mobile] Opening panel');
+                // console.log('[RPG Mobile] Opening panel');
                 $panel.addClass('rpg-mobile-open');
                 const $overlay = $('<div class="rpg-mobile-overlay"></div>');
                 $('body').append($overlay);
 
                 // Debug: Check state after animation should complete
                 setTimeout(() => {
-                    console.log('[RPG Mobile] 500ms after opening:', {
-                        panelClasses: $panel.attr('class'),
-                        hasOpenClass: $panel.hasClass('rpg-mobile-open'),
-                        visibility: $panel.css('visibility'),
-                        transform: $panel.css('transform'),
-                        display: $panel.css('display'),
-                        opacity: $panel.css('opacity')
-                    });
+                    // console.log('[RPG Mobile] 500ms after opening:', {
+                    //     panelClasses: $panel.attr('class'),
+                    //     hasOpenClass: $panel.hasClass('rpg-mobile-open'),
+                    //     visibility: $panel.css('visibility'),
+                    //     transform: $panel.css('transform'),
+                    //     display: $panel.css('display'),
+                    //     opacity: $panel.css('opacity')
+                    // });
                 }, 500);
 
                 // Close when clicking overlay
                 $overlay.on('click', function() {
-                    console.log('[RPG Mobile] Overlay clicked - closing panel');
+                    // console.log('[RPG Mobile] Overlay clicked - closing panel');
                     closeMobilePanelWithAnimation();
                     updateCollapseToggleIcon();
                 });
@@ -152,20 +203,20 @@ export function setupCollapseToggle() {
             // Update icon to reflect new state
             updateCollapseToggleIcon();
 
-            console.log('[RPG Mobile] After toggle:', {
-                panelClasses: $panel.attr('class'),
-                inlineStyles: $panel.attr('style'),
-                panelPosition: {
-                    top: $panel.css('top'),
-                    bottom: $panel.css('bottom'),
-                    transform: $panel.css('transform'),
-                    visibility: $panel.css('visibility')
-                },
-                gameContainer: {
-                    opacity: $('.rpg-game-container').css('opacity'),
-                    visibility: $('.rpg-game-container').css('visibility')
-                }
-            });
+            // console.log('[RPG Mobile] After toggle:', {
+            //     panelClasses: $panel.attr('class'),
+            //     inlineStyles: $panel.attr('style'),
+            //     panelPosition: {
+            //         top: $panel.css('top'),
+            //         bottom: $panel.css('bottom'),
+            //         transform: $panel.css('transform'),
+            //         visibility: $panel.css('visibility')
+            //     },
+            //     gameContainer: {
+            //         opacity: $('.rpg-game-container').css('opacity'),
+            //         visibility: $('.rpg-game-container').css('visibility')
+            //     }
+            // });
             return;
         }
 
@@ -192,6 +243,9 @@ export function setupCollapseToggle() {
             } else if ($panel.hasClass('rpg-position-left')) {
                 $icon.removeClass('fa-chevron-left').addClass('fa-chevron-right');
             }
+
+            // Update strip widgets when collapsing (they show in collapsed state)
+            updateStripWidgets();
         }
     });
 
@@ -208,14 +262,11 @@ export function updatePanelVisibility() {
         togglePlotButtons(); // Update plot button visibility
         $('#rpg-mobile-toggle').show(); // Show mobile FAB toggle
         $('#rpg-collapse-toggle').show(); // Show collapse toggle
-        // Debug toggle visibility is controlled by debugMode setting in debug.js
     } else {
         $panelContainer.hide();
         $('#rpg-plot-buttons').hide(); // Hide plot buttons when disabled
         $('#rpg-mobile-toggle').hide(); // Hide mobile FAB toggle
         $('#rpg-collapse-toggle').hide(); // Hide collapse toggle
-        $('#rpg-debug-toggle').hide(); // Hide debug toggle button when extension disabled
-        $('#rpg-debug-panel').remove(); // Remove debug panel when extension disabled
     }
 }
 
@@ -223,29 +274,131 @@ export function updatePanelVisibility() {
  * Updates the visibility of individual sections.
  */
 export function updateSectionVisibility() {
+    // Refresh container references first (in case they were detached during tab operations)
+    setInventoryContainer($('#rpg-inventory'));
+    setQuestsContainer($('#rpg-quests'));
+
     // Show/hide sections based on settings
-    $userStatsContainer.toggle(extensionSettings.showUserStats);
-    $infoBoxContainer.toggle(extensionSettings.showInfoBox);
-    $thoughtsContainer.toggle(extensionSettings.showCharacterThoughts);
-    if ($inventoryContainer) {
-        $inventoryContainer.toggle(extensionSettings.showInventory);
+    // Use explicit .show()/.hide() instead of .toggle() to ensure proper state on reload
+    if (extensionSettings.showUserStats) {
+        $userStatsContainer.show();
+    } else {
+        $userStatsContainer.hide();
+    }
+
+    if (extensionSettings.showInfoBox) {
+        // Only show if there's data to display
+        const infoBoxData = lastGeneratedData.infoBox || committedTrackerData.infoBox;
+        if (infoBoxData) {
+            $infoBoxContainer.show();
+        } else {
+            $infoBoxContainer.hide();
+        }
+    } else {
+        $infoBoxContainer.hide();
+    }
+
+    if (extensionSettings.showCharacterThoughts) {
+        $thoughtsContainer.show();
+    } else {
+        $thoughtsContainer.hide();
+    }
+
+    // Use direct DOM selectors for inventory and quests to avoid stale references
+    if (extensionSettings.showInventory) {
+        $('#rpg-inventory').show();
+    } else {
+        $('#rpg-inventory').hide();
+    }
+
+    if (extensionSettings.showQuests) {
+        $('#rpg-quests').show();
+    } else {
+        $('#rpg-quests').hide();
+    }
+
+    if ($musicPlayerContainer) {
+        if (extensionSettings.enableSpotifyMusic) {
+            $musicPlayerContainer.show();
+        } else {
+            $musicPlayerContainer.hide();
+        }
     }
 
     // Show/hide dividers intelligently
     // Divider after User Stats: shown if User Stats is visible AND at least one section after it is visible
     const showDividerAfterStats = extensionSettings.showUserStats &&
-        (extensionSettings.showInfoBox || extensionSettings.showCharacterThoughts || extensionSettings.showInventory);
-    $('#rpg-divider-stats').toggle(showDividerAfterStats);
+        (extensionSettings.showInfoBox || extensionSettings.showCharacterThoughts || extensionSettings.showInventory || extensionSettings.showQuests || extensionSettings.enableSpotifyMusic);
+    if (showDividerAfterStats) {
+        $('#rpg-divider-stats').show();
+    } else {
+        $('#rpg-divider-stats').hide();
+    }
 
     // Divider after Info Box: shown if Info Box is visible AND at least one section after it is visible
     const showDividerAfterInfo = extensionSettings.showInfoBox &&
-        (extensionSettings.showCharacterThoughts || extensionSettings.showInventory);
-    $('#rpg-divider-info').toggle(showDividerAfterInfo);
+        (extensionSettings.showCharacterThoughts || extensionSettings.showInventory || extensionSettings.showQuests);
+    if (showDividerAfterInfo) {
+        $('#rpg-divider-info').show();
+    } else {
+        $('#rpg-divider-info').hide();
+    }
 
-    // Divider after Thoughts: shown if Thoughts is visible AND Inventory is visible
+    // Divider after Thoughts: shown if Thoughts is visible AND at least one section after it is visible
     const showDividerAfterThoughts = extensionSettings.showCharacterThoughts &&
-        extensionSettings.showInventory;
-    $('#rpg-divider-thoughts').toggle(showDividerAfterThoughts);
+        (extensionSettings.showInventory || extensionSettings.showQuests || extensionSettings.enableSpotifyMusic);
+    if (showDividerAfterThoughts) {
+        $('#rpg-divider-thoughts').show();
+    } else {
+        $('#rpg-divider-thoughts').hide();
+    }
+
+    // Divider after Inventory: shown if Inventory is visible AND (Quests or Music) is visible
+    const showDividerAfterInventory = extensionSettings.showInventory && (extensionSettings.showQuests || extensionSettings.enableSpotifyMusic);
+    if (showDividerAfterInventory) {
+        $('#rpg-divider-inventory').show();
+    } else {
+        $('#rpg-divider-inventory').hide();
+    }
+
+    // Divider after Quests: shown if Quests is visible AND Music is visible
+    const showDividerAfterQuests = extensionSettings.showQuests && extensionSettings.enableSpotifyMusic;
+    if (showDividerAfterQuests) {
+        $('#rpg-divider-quests').show();
+    } else {
+        $('#rpg-divider-quests').hide();
+    }
+
+    // Rebuild tabs to reflect visibility changes for inventory and quests
+    const isMobile = window.innerWidth <= 1000;
+    const hasMobileTabs = $('.rpg-mobile-container').length > 0;
+    const hasDesktopTabs = $('.rpg-tabs-nav').length > 0;
+
+    // Only rebuild if tabs currently exist
+    if (hasMobileTabs || hasDesktopTabs) {
+        // Remove existing tabs
+        if (hasMobileTabs) {
+            removeMobileTabs();
+            // Force remove any lingering mobile tab elements (but not the content sections!)
+            $('.rpg-mobile-container').remove();
+            $('.rpg-mobile-tabs').remove();
+        } else {
+            removeDesktopTabs();
+            // Force remove any lingering desktop tab structure (but not the content sections!)
+            // The removeDesktopTabs() function already detached and restored the sections
+        }
+
+        // Rebuild tabs immediately
+        if (isMobile) {
+            setupMobileTabs();
+        } else {
+            setupDesktopTabs();
+        }
+
+        // Refresh container references
+        setInventoryContainer($('#rpg-inventory'));
+        setQuestsContainer($('#rpg-quests'));
+    }
 }
 
 /**
@@ -258,16 +411,19 @@ export function applyPanelPosition() {
 
     // Remove all position classes
     $panelContainer.removeClass('rpg-position-left rpg-position-right rpg-position-top');
+    $('body').removeClass('rpg-panel-position-left rpg-panel-position-right rpg-panel-position-top');
 
-    // On mobile, don't apply desktop position classes
+    // Add the appropriate position class
+    $panelContainer.addClass(`rpg-position-${extensionSettings.panelPosition}`);
+
+    // On mobile, also add body class for mobile-specific CSS
     if (isMobile) {
+        $('body').addClass(`rpg-panel-position-${extensionSettings.panelPosition}`);
+        updateCollapseToggleIcon();
         return;
     }
 
-    // Desktop: Add the appropriate position class
-    $panelContainer.addClass(`rpg-position-${extensionSettings.panelPosition}`);
-
-    // Update collapse toggle icon direction for new position
+    // Desktop: Update collapse toggle icon direction for new position
     updateCollapseToggleIcon();
 }
 
@@ -278,8 +434,26 @@ export function updateGenerationModeUI() {
     if (extensionSettings.generationMode === 'together') {
         // In "together" mode, manual update button is hidden
         $('#rpg-manual-update').hide();
-    } else {
+        $('#rpg-strip-refresh').hide();
+        $('#rpg-external-api-settings').slideUp(200);
+        $('#rpg-separate-mode-settings').slideUp(200);
+        // Hide auto-update toggle (not applicable in together mode)
+        $('#rpg-auto-update-container').slideUp(200);
+    } else if (extensionSettings.generationMode === 'separate') {
         // In "separate" mode, manual update button is visible
         $('#rpg-manual-update').show();
+        $('#rpg-strip-refresh').show();
+        $('#rpg-external-api-settings').slideUp(200);
+        $('#rpg-separate-mode-settings').slideDown(200);
+        // Show auto-update toggle
+        $('#rpg-auto-update-container').slideDown(200);
+    } else if (extensionSettings.generationMode === 'external') {
+        // In "external" mode, manual update button is visible AND both settings are shown
+        $('#rpg-manual-update').show();
+        $('#rpg-strip-refresh').show();
+        $('#rpg-external-api-settings').slideDown(200);
+        $('#rpg-separate-mode-settings').slideDown(200);
+        // Show auto-update toggle for external mode too
+        $('#rpg-auto-update-container').slideDown(200);
     }
 }

src/systems/ui/mobile.js

@@ -3,11 +3,12 @@
  * Handles mobile-specific UI functionality: FAB dragging, tabs, keyboard handling
  */
 
-import { extensionSettings } from '../../core/state.js';
+import { extensionSettings, committedTrackerData, lastGeneratedData } from '../../core/state.js';
 import { saveSettings } from '../../core/persistence.js';
 import { closeMobilePanelWithAnimation, updateCollapseToggleIcon } from './layout.js';
 import { setupDesktopTabs, removeDesktopTabs } from './desktop.js';
 import { i18n } from '../../core/i18n.js';
+import { hexToRgba } from './theme.js';
 
 /**
  * Updates the text labels of the mobile navigation tabs based on the current language.
@@ -55,13 +56,13 @@ export function setupMobileToggle() {
     const $overlay = $('<div class="rpg-mobile-overlay"></div>');
 
     // DIAGNOSTIC: Check if elements exist and log setup state
-    console.log('[RPG Mobile] ========================================');
-    console.log('[RPG Mobile] setupMobileToggle called');
-    console.log('[RPG Mobile] Button exists:', $mobileToggle.length > 0, 'jQuery object:', $mobileToggle);
-    console.log('[RPG Mobile] Panel exists:', $panel.length > 0);
-    console.log('[RPG Mobile] Window width:', window.innerWidth);
-    console.log('[RPG Mobile] Is mobile viewport (<=1000):', window.innerWidth <= 1000);
-    console.log('[RPG Mobile] ========================================');
+    // console.log('[RPG Mobile] ========================================');
+    // console.log('[RPG Mobile] setupMobileToggle called');
+    // console.log('[RPG Mobile] Button exists:', $mobileToggle.length > 0, 'jQuery object:', $mobileToggle);
+    // console.log('[RPG Mobile] Panel exists:', $panel.length > 0);
+    // console.log('[RPG Mobile] Window width:', window.innerWidth);
+    // console.log('[RPG Mobile] Is mobile viewport (<=1000):', window.innerWidth <= 1000);
+    // console.log('[RPG Mobile] ========================================');
 
     if ($mobileToggle.length === 0) {
         console.error('[RPG Mobile] ERROR: Mobile toggle button not found in DOM!');
@@ -72,7 +73,7 @@ export function setupMobileToggle() {
     // Load and apply saved FAB position
     if (extensionSettings.mobileFabPosition) {
         const pos = extensionSettings.mobileFabPosition;
-        console.log('[RPG Mobile] Loading saved FAB position:', pos);
+        // console.log('[RPG Mobile] Loading saved FAB position:', pos);
 
         // Apply saved position
         if (pos.top) $mobileToggle.css('top', pos.top);
@@ -106,6 +107,14 @@ export function setupMobileToggle() {
                 right: 'auto',
                 bottom: 'auto'
             });
+            // Also update widget container position during drag
+            const $container = $('#rpg-fab-widget-container');
+            if ($container.length > 0) {
+                $container.css({
+                    top: pendingY + 'px',
+                    left: pendingX + 'px'
+                });
+            }
             pendingX = null;
             pendingY = null;
         }
@@ -250,10 +259,13 @@ export function setupMobileToggle() {
             extensionSettings.mobileFabPosition = newPosition;
             saveSettings();
 
-            console.log('[RPG Mobile] Saved new FAB position (mouse):', newPosition);
+            // console.log('[RPG Mobile] Saved new FAB position (mouse):', newPosition);
 
             // Constrain to viewport bounds (now that position is saved)
-            setTimeout(() => constrainFabToViewport(), 10);
+            setTimeout(() => {
+                constrainFabToViewport();
+                updateFabWidgetPosition(); // Update widget container position
+            }, 10);
 
             // Re-enable transitions with smooth animation
             setTimeout(() => {
@@ -291,10 +303,13 @@ export function setupMobileToggle() {
             extensionSettings.mobileFabPosition = newPosition;
             saveSettings();
 
-            console.log('[RPG Mobile] Saved new FAB position:', newPosition);
+            // console.log('[RPG Mobile] Saved new FAB position:', newPosition);
 
             // Constrain to viewport bounds (now that position is saved)
-            setTimeout(() => constrainFabToViewport(), 10);
+            setTimeout(() => {
+                constrainFabToViewport();
+                updateFabWidgetPosition(); // Update widget container position
+            }, 10);
 
             // Re-enable transitions with smooth animation
             setTimeout(() => {
@@ -304,7 +319,7 @@ export function setupMobileToggle() {
             isDragging = false;
         } else {
             // Was a tap - toggle panel
-            console.log('[RPG Mobile] Quick tap detected - toggling panel');
+            // console.log('[RPG Mobile] Quick tap detected - toggling panel');
 
             if ($panel.hasClass('rpg-mobile-open')) {
                 // Close panel with animation
@@ -327,28 +342,28 @@ export function setupMobileToggle() {
     $mobileToggle.on('click', function(e) {
         // Skip if we just finished dragging
         if ($mobileToggle.data('just-dragged')) {
-            console.log('[RPG Mobile] Click blocked - just finished dragging');
+            // console.log('[RPG Mobile] Click blocked - just finished dragging');
             return;
         }
 
-        console.log('[RPG Mobile] >>> CLICK EVENT FIRED <<<', {
-            windowWidth: window.innerWidth,
-            isMobileViewport: window.innerWidth <= 1000,
-            panelOpen: $panel.hasClass('rpg-mobile-open')
-        });
+        // console.log('[RPG Mobile] >>> CLICK EVENT FIRED <<<', {
+        //     windowWidth: window.innerWidth,
+        //     isMobileViewport: window.innerWidth <= 1000,
+        //     panelOpen: $panel.hasClass('rpg-mobile-open')
+        // });
 
         // Work on both mobile and desktop (removed viewport check)
         if ($panel.hasClass('rpg-mobile-open')) {
-            console.log('[RPG Mobile] Click: Closing panel');
+            // console.log('[RPG Mobile] Click: Closing panel');
             closeMobilePanelWithAnimation();
         } else {
-            console.log('[RPG Mobile] Click: Opening panel');
+            // console.log('[RPG Mobile] Click: Opening panel');
             $panel.addClass('rpg-mobile-open');
             $('body').append($overlay);
             $mobileToggle.addClass('active');
 
             $overlay.on('click', function() {
-                console.log('[RPG Mobile] Overlay clicked - closing panel');
+                // console.log('[RPG Mobile] Overlay clicked - closing panel');
                 closeMobilePanelWithAnimation();
             });
         }
@@ -367,7 +382,7 @@ export function setupMobileToggle() {
 
         // Transitioning from desktop to mobile - handle immediately for smooth transition
         if (!wasMobile && isMobile) {
-            console.log('[RPG Mobile] Transitioning desktop -> mobile');
+            // console.log('[RPG Mobile] Transitioning desktop -> mobile');
 
             // Show mobile toggle button
             $mobileToggle.show();
@@ -375,8 +390,12 @@ export function setupMobileToggle() {
             // Remove desktop tabs first
             removeDesktopTabs();
 
-            // Remove desktop positioning classes
+            // Apply mobile positioning based on panelPosition setting
             $panel.removeClass('rpg-position-right rpg-position-left rpg-position-top');
+            $('body').removeClass('rpg-panel-position-right rpg-panel-position-left rpg-panel-position-top');
+            const position = extensionSettings.panelPosition || 'right';
+            $panel.addClass('rpg-position-' + position);
+            $('body').addClass('rpg-panel-position-' + position);
 
             // Clear collapsed state - mobile doesn't use collapse
             $panel.removeClass('rpg-collapsed');
@@ -387,16 +406,16 @@ export function setupMobileToggle() {
             // Clear any inline styles that might be overriding CSS
             $panel.attr('style', '');
 
-            console.log('[RPG Mobile] After cleanup:', {
-                panelClasses: $panel.attr('class'),
-                inlineStyles: $panel.attr('style'),
-                panelPosition: {
-                    top: $panel.css('top'),
-                    bottom: $panel.css('bottom'),
-                    transform: $panel.css('transform'),
-                    visibility: $panel.css('visibility')
-                }
-            });
+            // console.log('[RPG Mobile] After cleanup:', {
+            //     panelClasses: $panel.attr('class'),
+            //     inlineStyles: $panel.attr('style'),
+            //     panelPosition: {
+            //         top: $panel.css('top'),
+            //         bottom: $panel.css('bottom'),
+            //         transform: $panel.css('transform'),
+            //         visibility: $panel.css('visibility')
+            //     }
+            // });
 
             // Set up mobile tabs IMMEDIATELY (no debounce delay)
             setupMobileTabs();
@@ -424,7 +443,8 @@ export function setupMobileToggle() {
                 // Hide mobile toggle button on desktop
                 $mobileToggle.hide();
 
-                // Restore desktop positioning class
+                // Restore desktop positioning class and remove body mobile classes
+                $('body').removeClass('rpg-panel-position-right rpg-panel-position-left rpg-panel-position-top');
                 const position = extensionSettings.panelPosition || 'right';
                 $panel.addClass('rpg-position-' + position);
 
@@ -457,17 +477,14 @@ export function setupMobileToggle() {
         // Clear any inline styles
         $panel.attr('style', '');
 
-        console.log('[RPG Mobile] Initial load on mobile viewport:', {
-            panelClasses: $panel.attr('class'),
-            inlineStyles: $panel.attr('style'),
-            panelPosition: {
-                top: $panel.css('top'),
-                bottom: $panel.css('top'),
-                transform: $panel.css('transform'),
-                visibility: $panel.css('visibility')
-            }
-        });
-        setupMobileTabs();
+        // console.log('[RPG Mobile] Initial load on mobile viewport:', {
+        //     panelClasses: $panel.attr('class'),
+        //     inlineStyles: $panel.attr('style'),
+        //     panelPosition: {
+        //         top: $panel.css('top'),
+        //         bottom: $panel.css('top'),
+        //         transform: $panel.css('transform'),
+        //         visibility: $panel.css('visibility')\n        //     }\n        // });\n        setupMobileTabs();
         // Set initial icon for mobile
         updateCollapseToggleIcon();
         // Show mobile toggle on mobile viewport
@@ -486,7 +503,7 @@ export function setupMobileToggle() {
 export function constrainFabToViewport() {
     // Only constrain if user has set a custom position
     if (!extensionSettings.mobileFabPosition) {
-        console.log('[RPG Mobile] Skipping viewport constraint - using CSS defaults');
+        // console.log('[RPG Mobile] Skipping viewport constraint - using CSS defaults');
         return;
     }
 
@@ -495,7 +512,7 @@ export function constrainFabToViewport() {
 
     // Skip if button is not visible
     if (!$mobileToggle.is(':visible')) {
-        console.log('[RPG Mobile] Skipping viewport constraint - button not visible');
+        // console.log('[RPG Mobile] Skipping viewport constraint - button not visible');
         return;
     }
 
@@ -525,12 +542,12 @@ export function constrainFabToViewport() {
 
     // Only update if position changed
     if (newX !== currentX || newY !== currentY) {
-        console.log('[RPG Mobile] Constraining FAB to viewport:', {
-            old: { x: currentX, y: currentY },
-            new: { x: newX, y: newY },
-            viewport: { width: window.innerWidth, height: window.innerHeight },
-            topBarHeight
-        });
+        // console.log('[RPG Mobile] Constraining FAB to viewport:', {
+        //     old: { x: currentX, y: currentY },
+        //     new: { x: newX, y: newY },
+        //     viewport: { width: window.innerWidth, height: window.innerHeight },
+        //     topBarHeight
+        // });
 
         // Apply new position
         $mobileToggle.css({
@@ -561,6 +578,14 @@ export function setupMobileTabs() {
     if ($('.rpg-mobile-tabs').length > 0) return;
 
     const $panel = $('#rpg-companion-panel');
+
+    // Apply mobile positioning based on panelPosition setting
+    $panel.removeClass('rpg-position-right rpg-position-left rpg-position-top');
+    $('body').removeClass('rpg-panel-position-right rpg-panel-position-left rpg-panel-position-top');
+    const position = extensionSettings.panelPosition || 'right';
+    $panel.addClass('rpg-position-' + position);
+    $('body').addClass('rpg-panel-position-' + position);
+
     const $contentBox = $panel.find('.rpg-content-box');
 
     // Get existing sections
@@ -579,8 +604,8 @@ export function setupMobileTabs() {
     const tabs = [];
     const hasStats = $userStats.length > 0;
     const hasInfo = $infoBox.length > 0 || $thoughts.length > 0;
-    const hasInventory = $inventory.length > 0;
-    const hasQuests = $quests.length > 0;
+    const hasInventory = $inventory.length > 0 && extensionSettings.showInventory;
+    const hasQuests = $quests.length > 0 && extensionSettings.showQuests;
 
     // Tab 1: Stats (User Stats only)
     if (hasStats) {
@@ -624,7 +649,9 @@ export function setupMobileTabs() {
     // Info tab: Info Box + Character Thoughts
     if ($infoBox.length > 0) {
         $infoTab.append($infoBox.detach());
-        $infoBox.show();
+        // Only show if has data
+        const infoBoxData = window.lastGeneratedData?.infoBox || window.committedTrackerData?.infoBox;
+        if (infoBoxData) $infoBox.show();
     }
     if ($thoughts.length > 0) {
         $infoTab.append($thoughts.detach());
@@ -650,12 +677,12 @@ export function setupMobileTabs() {
     const $mobileContainer = $('<div class="rpg-mobile-container"></div>');
     $mobileContainer.append($tabNav);
 
-    // Only append tab content wrappers that have content
-    if (hasStats) $mobileContainer.append($statsTab);
-    if (hasInfo) $mobileContainer.append($infoTab);
-    if (hasInventory) $mobileContainer.append($inventoryTab);
-    if (hasQuests) $mobileContainer.append($questsTab);
-    if (hasInventory) $mobileContainer.append($inventoryTab);
+    // Always append all tab content wrappers to preserve elements
+    // Tab buttons control visibility
+    $mobileContainer.append($statsTab);
+    $mobileContainer.append($infoTab);
+    $mobileContainer.append($inventoryTab);
+    $mobileContainer.append($questsTab);
 
     // Insert mobile tab structure at the beginning of content box
     $contentBox.prepend($mobileContainer);
@@ -712,11 +739,15 @@ export function removeMobileTabs() {
         $contentBox.prepend($userStats);
     }
 
-    // Show sections and dividers
-    $userStats.show();
-    $infoBox.show();
-    $thoughts.show();
-    $inventory.show();
+    // Show/hide sections based on settings (respect visibility settings)
+    if (extensionSettings.showUserStats) $userStats.show();
+    if (extensionSettings.showInfoBox) {
+        const infoBoxData = window.lastGeneratedData?.infoBox || window.committedTrackerData?.infoBox;
+        if (infoBoxData) $infoBox.show();
+    }
+    if (extensionSettings.showCharacterThoughts) $thoughts.show();
+    if (extensionSettings.showInventory) $inventory.show();
+    if (extensionSettings.showQuests) $quests.show();
     $('.rpg-divider').show();
 }
 
@@ -763,12 +794,17 @@ export function setupMobileKeyboardHandling() {
 /**
  * Handles focus on contenteditable fields to ensure they're visible when keyboard appears.
  * Uses smooth scrolling to bring focused field into view with proper padding.
+ * Only applies on mobile viewports where virtual keyboard can obscure content.
  */
 export function setupContentEditableScrolling() {
     const $panel = $('#rpg-companion-panel');
 
     // Use event delegation for all contenteditable fields
     $panel.on('focusin', '[contenteditable="true"]', function(e) {
+        // Only apply scrolling behavior on mobile (where virtual keyboard appears)
+        const isMobile = window.innerWidth <= 1000;
+        if (!isMobile) return;
+
         const $field = $(this);
 
         // Small delay to let keyboard animate in
@@ -797,12 +833,12 @@ export function setupRefreshButtonDrag() {
         return;
     }
 
-    console.log('[RPG Mobile] setupRefreshButtonDrag called');
+    // console.log('[RPG Mobile] setupRefreshButtonDrag called');
 
     // Load and apply saved position
     if (extensionSettings.mobileRefreshPosition) {
         const pos = extensionSettings.mobileRefreshPosition;
-        console.log('[RPG Mobile] Loading saved refresh button position:', pos);
+        // console.log('[RPG Mobile] Loading saved refresh button position:', pos);
 
         // Apply saved position
         if (pos.top) $refreshBtn.css('top', pos.top);
@@ -1012,12 +1048,12 @@ export function setupDebugButtonDrag() {
         return;
     }
 
-    console.log('[RPG Mobile] setupDebugButtonDrag called');
+    // console.log('[RPG Mobile] setupDebugButtonDrag called');
 
     // Load and apply saved position
     if (extensionSettings.debugFabPosition) {
         const pos = extensionSettings.debugFabPosition;
-        console.log('[RPG Mobile] Loading saved debug button position:', pos);
+        // console.log('[RPG Mobile] Loading saved debug button position:', pos);
 
         // Apply saved position
         if (pos.top) $debugBtn.css('top', pos.top);
@@ -1214,3 +1250,393 @@ export function setupDebugButtonDrag() {
         isDragging = false;
     });
 }
+
+// ============================================
+// FAB WIDGETS - Info display around FAB button
+// ============================================
+
+/**
+ * Updates the FAB widgets display based on current tracker data and settings.
+ * Widgets are positioned in 8 positions around the FAB (N, NE, E, SE, S, SW, W, NW).
+ */
+export function updateFabWidgets() {
+    const $fab = $('#rpg-mobile-toggle');
+    if ($fab.length === 0) return;
+
+    // Remove existing widget container and clean up event listeners
+    $('#rpg-fab-widget-container').remove();
+    $(document).off('click.fabWidgets touchstart.fabWidgets');
+
+    // Check if widgets are enabled
+    const widgetSettings = extensionSettings.mobileFabWidgets;
+    if (!widgetSettings || !widgetSettings.enabled) return;
+
+    // Don't show widgets on desktop or when panel is open
+    if (window.innerWidth > 1000) return;
+
+    // Get tracker data - prefer lastGeneratedData (most recent) over committedTrackerData
+    const infoBox = lastGeneratedData?.infoBox || committedTrackerData?.infoBox;
+    const userStats = lastGeneratedData?.userStats || committedTrackerData?.userStats;
+
+    // Parse infoBox if it's a string
+    let infoData = null;
+    if (infoBox) {
+        try {
+            infoData = typeof infoBox === 'string' ? JSON.parse(infoBox) : infoBox;
+        } catch (e) {
+            console.warn('[RPG FAB Widgets] Failed to parse infoBox:', e);
+        }
+    }
+
+    // Parse userStats if it's a string
+    let statsData = null;
+    if (userStats) {
+        try {
+            statsData = typeof userStats === 'string' ? JSON.parse(userStats) : userStats;
+        } catch (e) {
+            console.warn('[RPG FAB Widgets] Failed to parse userStats:', e);
+        }
+    }
+
+    // Create widget container positioned at FAB location
+    const fabOffset = $fab.offset();
+    const fabWidth = $fab.outerWidth();
+    const fabHeight = $fab.outerHeight();
+
+    const $container = $('<div id="rpg-fab-widget-container" class="rpg-fab-widget-container"></div>');
+    $container.css({
+        top: fabOffset.top + 'px',
+        left: fabOffset.left + 'px',
+        width: fabWidth + 'px',
+        height: fabHeight + 'px'
+    });
+
+    // Build widgets based on settings - auto-assign positions sequentially
+    const widgets = [];
+
+    // Collect enabled widgets in display priority order
+    // Large widgets (Stats, Attributes) go to West/Northwest
+    // Small widgets spread around other positions
+
+    // Weather Icon (small)
+    if (widgetSettings.weatherIcon?.enabled && infoData?.weather?.emoji) {
+        widgets.push({
+            type: 'small',
+            html: `<div class="rpg-fab-widget rpg-fab-widget-weather-icon" title="Weather">${infoData.weather.emoji}</div>`
+        });
+    }
+
+    // Weather Description (small)
+    if (widgetSettings.weatherDesc?.enabled && infoData?.weather?.forecast) {
+        const desc = infoData.weather.forecast.length > 15 ? infoData.weather.forecast.substring(0, 13) + '…' : infoData.weather.forecast;
+        widgets.push({
+            type: 'small',
+            html: `<div class="rpg-fab-widget rpg-fab-widget-weather-desc" title="${infoData.weather.forecast}">${desc}</div>`
+        });
+    }
+
+    // Helper to create expandable text widget HTML
+    const createExpandableText = (fullText, maxLen, emoji) => {
+        if (fullText.length <= maxLen) {
+            return `${emoji} ${fullText}`;
+        }
+        const truncated = fullText.substring(0, maxLen - 2) + '…';
+        return `${emoji} <span class="rpg-truncated">${truncated}</span><span class="rpg-full-text">${fullText}</span>`;
+    };
+
+    // Check if text needs truncation for data attribute
+    const needsExpand = (text, maxLen) => text.length > maxLen;
+
+    // Helper to parse time string and calculate clock hand angles
+    const parseTimeForClock = (timeStr) => {
+        const timeMatch = timeStr.match(/(\d+):(\d+)/);
+        if (timeMatch) {
+            const hours = parseInt(timeMatch[1]);
+            const minutes = parseInt(timeMatch[2]);
+            const hourAngle = (hours % 12) * 30 + minutes * 0.5; // 30° per hour + 0.5° per minute
+            const minuteAngle = minutes * 6; // 6° per minute
+            return { hourAngle, minuteAngle };
+        }
+        return { hourAngle: 0, minuteAngle: 0 };
+    };
+
+    // Clock/Time (bottom position with animated clock face)
+    if (widgetSettings.clock?.enabled && infoData?.time) {
+        const timeStr = infoData.time.end || infoData.time.value || infoData.time.start || '';
+        if (timeStr) {
+            const { hourAngle, minuteAngle } = parseTimeForClock(timeStr);
+            widgets.push({
+                type: 'bottom', // Special type for bottom position
+                html: `<div class="rpg-fab-widget rpg-fab-widget-clock" title="${timeStr}">
+                    <div class="rpg-fab-clock-face">
+                        <div class="rpg-fab-clock-hour" style="transform: rotate(${hourAngle}deg)"></div>
+                        <div class="rpg-fab-clock-minute" style="transform: rotate(${minuteAngle}deg)"></div>
+                        <div class="rpg-fab-clock-center"></div>
+                    </div>
+                    <span class="rpg-fab-clock-time">${timeStr}</span>
+                </div>`
+            });
+        }
+    }
+
+    // Date (small)
+    if (widgetSettings.date?.enabled && infoData?.date?.value) {
+        const dateVal = infoData.date.value;
+        const expandAttr = needsExpand(dateVal, 12) ? ' data-full-text="true"' : '';
+        widgets.push({
+            type: 'small',
+            html: `<div class="rpg-fab-widget rpg-fab-widget-date"${expandAttr} title="${dateVal}">${createExpandableText(dateVal, 12, '📅')}</div>`
+        });
+    }
+
+    // Location (small)
+    if (widgetSettings.location?.enabled && infoData?.location?.value) {
+        const loc = infoData.location.value;
+        const expandAttr = needsExpand(loc, 14) ? ' data-full-text="true"' : '';
+        widgets.push({
+            type: 'small',
+            html: `<div class="rpg-fab-widget rpg-fab-widget-location"${expandAttr} title="${loc}">${createExpandableText(loc, 14, '📍')}</div>`
+        });
+    }
+
+    // Stats (large - goes to West) - respects trackerConfig.userStats.customStats
+    // Use extensionSettings.userStats as primary source (contains all stats), fallback to committedTrackerData
+    let allStats = [];
+    try {
+        const userStatsJson = extensionSettings.userStats;
+        const parsedUserStats = typeof userStatsJson === 'string' ? JSON.parse(userStatsJson) : userStatsJson;
+        if (parsedUserStats?.stats) {
+            allStats = parsedUserStats.stats;
+        }
+    } catch (e) {
+        console.warn('[RPG FAB Widgets] Failed to parse extensionSettings.userStats:', e);
+    }
+    // Fallback to statsData if extensionSettings.userStats is empty
+    if (allStats.length === 0 && statsData?.stats) {
+        allStats = statsData.stats;
+    }
+
+    if (widgetSettings.stats?.enabled && allStats.length > 0) {
+        // Get enabled stats from trackerConfig - match by id (lowercase)
+        const configuredStats = extensionSettings.trackerConfig?.userStats?.customStats || [];
+        const enabledStatMap = new Map();
+        configuredStats.forEach(s => {
+            if (s.enabled !== false) {
+                enabledStatMap.set(s.id?.toLowerCase(), true);
+                enabledStatMap.set(s.name?.toLowerCase(), true);
+            }
+        });
+
+        const statsHtml = allStats
+            .filter(s => {
+                // If no config, show all stats
+                if (configuredStats.length === 0) return true;
+                // Check if stat is enabled in trackerConfig (match by id or name, case-insensitive)
+                const statId = s.id?.toLowerCase();
+                const statName = s.name?.toLowerCase();
+                return enabledStatMap.has(statId) || enabledStatMap.has(statName);
+            })
+            .map(stat => {
+                const value = typeof stat.value === 'number' ? stat.value : parseInt(stat.value) || 0;
+                const color = getStatColor(value);
+                const abbr = stat.name.substring(0, 3).toUpperCase();
+                return `<span class="rpg-fab-widget-stat-item" title="${stat.name}: ${value}" style="color: ${color};">${abbr}:${value}</span>`;
+            })
+            .join('');
+
+        if (statsHtml) {
+            widgets.push({
+                type: 'large',
+                preferredPos: 6, // West
+                html: `<div class="rpg-fab-widget rpg-fab-widget-stats"><div class="rpg-fab-widget-stats-row">${statsHtml}</div></div>`
+            });
+        }
+    }
+
+    // RPG Attributes (large - goes to Northwest) - respects trackerConfig.userStats.rpgAttributes
+    if (widgetSettings.attributes?.enabled) {
+        // Check if RPG attributes are enabled in trackerConfig
+        const showRPGAttributes = extensionSettings.trackerConfig?.userStats?.showRPGAttributes !== false;
+
+        if (showRPGAttributes && extensionSettings.classicStats) {
+            // Get enabled attributes from trackerConfig
+            const configuredAttrs = extensionSettings.trackerConfig?.userStats?.rpgAttributes || [];
+            const enabledAttrIds = configuredAttrs.filter(a => a.enabled !== false).map(a => a.id);
+
+            const attrs = extensionSettings.classicStats;
+            const attrItems = Object.entries(attrs)
+                .filter(([key]) => {
+                    // Check if attribute is enabled in trackerConfig
+                    if (enabledAttrIds.length > 0) {
+                        return enabledAttrIds.includes(key.toLowerCase());
+                    }
+                    return true;
+                })
+                .map(([key, value]) => `<div class="rpg-fab-widget-attr-item"><span class="rpg-fab-widget-attr-name">${key.toUpperCase()}</span><span class="rpg-fab-widget-attr-value">${value}</span></div>`)
+                .join('');
+
+            if (attrItems) {
+                widgets.push({
+                    type: 'large',
+                    preferredPos: 7, // Northwest
+                    html: `<div class="rpg-fab-widget rpg-fab-widget-attributes" title="Attributes"><div class="rpg-fab-widget-attr-grid">${attrItems}</div></div>`
+                });
+            }
+        }
+    }
+
+    // Auto-assign positions intelligently
+    // Large widgets get their preferred positions first (West=6, Northwest=7)
+    // Bottom widgets get position 4 (South)
+    // Small widgets fill remaining positions clockwise from North (0)
+    const usedPositions = new Set();
+    const positionedWidgets = [];
+
+    // Position order for small widgets: N(0), NE(1), E(2), SE(3), SW(5) - skip S(4) for bottom/clock
+    const smallPositionOrder = [0, 1, 2, 3, 5];
+    let smallPosIndex = 0;
+
+    // Check if only one large widget exists (for centering)
+    const largeWidgets = widgets.filter(w => w.type === 'large');
+    const singleLargeWidget = largeWidgets.length === 1;
+
+    // First: assign bottom widgets to position 4 (South)
+    widgets.filter(w => w.type === 'bottom').forEach(w => {
+        const pos = 4; // South position
+        usedPositions.add(pos);
+        const finalHtml = w.html.replace('class="rpg-fab-widget', `class="rpg-fab-widget rpg-fab-widget-pos-${pos}`);
+        positionedWidgets.push({ position: pos, html: finalHtml });
+    });
+
+    // Second: assign large widgets to their preferred positions
+    largeWidgets.forEach(w => {
+        let pos = w.preferredPos;
+        // If preferred position is taken, find next available from large positions
+        if (usedPositions.has(pos)) {
+            pos = pos === 6 ? 7 : 6; // Try the other large position
+        }
+        usedPositions.add(pos);
+        // Add centered class if this is the only large widget
+        const centeredClass = singleLargeWidget ? ' rpg-fab-widget-centered' : '';
+        const finalHtml = w.html.replace('class="rpg-fab-widget', `class="rpg-fab-widget rpg-fab-widget-pos-${pos}${centeredClass}`);
+        positionedWidgets.push({ position: pos, html: finalHtml });
+    });
+
+    // Third: assign small widgets to remaining positions
+    widgets.filter(w => w.type === 'small').forEach(w => {
+        // Find next available position from small position order
+        while (smallPosIndex < smallPositionOrder.length && usedPositions.has(smallPositionOrder[smallPosIndex])) {
+            smallPosIndex++;
+        }
+        const pos = smallPosIndex < smallPositionOrder.length ? smallPositionOrder[smallPosIndex] : (smallPosIndex % 8);
+        usedPositions.add(pos);
+        smallPosIndex++;
+        const finalHtml = w.html.replace('class="rpg-fab-widget', `class="rpg-fab-widget rpg-fab-widget-pos-${pos}`);
+        positionedWidgets.push({ position: pos, html: finalHtml });
+    });
+
+    // Add widgets to container
+    positionedWidgets.forEach(w => $container.append(w.html));
+
+    // Append container to body
+    if (positionedWidgets.length > 0) {
+        $('body').append($container);
+
+        // Add mobile tap handler for expandable widgets
+        $container.find('.rpg-fab-widget[data-full-text]').on('click touchstart', function(e) {
+            e.stopPropagation();
+            const $this = $(this);
+            const wasExpanded = $this.hasClass('expanded');
+
+            // Collapse all other expanded widgets
+            $container.find('.rpg-fab-widget.expanded').removeClass('expanded');
+
+            // Toggle this one
+            if (!wasExpanded) {
+                $this.addClass('expanded');
+            }
+        });
+
+        // Collapse on tap outside
+        $(document).on('click.fabWidgets touchstart.fabWidgets', function(e) {
+            if (!$(e.target).closest('.rpg-fab-widget').length) {
+                $container.find('.rpg-fab-widget.expanded').removeClass('expanded');
+            }
+        });
+    }
+}
+
+/**
+ * Gets a color for a stat value (0-100) using a gradient from low to high.
+ * @param {number} value - The stat value (0-100)
+ * @returns {string} CSS color value
+ */
+function getStatColor(value) {
+    const lowColor = extensionSettings.statBarColorLow || '#cc3333';
+    const lowOpacity = extensionSettings.statBarColorLowOpacity ?? 100;
+    const highColor = extensionSettings.statBarColorHigh || '#33cc66';
+    const highOpacity = extensionSettings.statBarColorHighOpacity ?? 100;
+
+    // Simple linear interpolation between low and high colors
+    const percent = Math.min(100, Math.max(0, value)) / 100;
+
+    // Parse colors
+    const lowRGB = hexToRgb(lowColor);
+    const highRGB = hexToRgb(highColor);
+
+    if (!lowRGB || !highRGB) return value > 50 ? hexToRgba(highColor, highOpacity) : hexToRgba(lowColor, lowOpacity);
+
+    const r = Math.round(lowRGB.r + (highRGB.r - lowRGB.r) * percent);
+    const g = Math.round(lowRGB.g + (highRGB.g - lowRGB.g) * percent);
+    const b = Math.round(lowRGB.b + (highRGB.b - lowRGB.b) * percent);
+    const a = (lowOpacity + (highOpacity - lowOpacity) * percent) / 100;
+
+    return `rgba(${r}, ${g}, ${b}, ${a})`;
+}
+
+/**
+ * Converts a hex color to RGB object.
+ * @param {string} hex - Hex color string (e.g., "#cc3333")
+ * @returns {{r: number, g: number, b: number}|null}
+ */
+function hexToRgb(hex) {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result ? {
+        r: parseInt(result[1], 16),
+        g: parseInt(result[2], 16),
+        b: parseInt(result[3], 16)
+    } : null;
+}
+
+/**
+ * Updates the FAB widget container position to match FAB button position.
+ * Call this after FAB is dragged.
+ */
+export function updateFabWidgetPosition() {
+    const $fab = $('#rpg-mobile-toggle');
+    const $container = $('#rpg-fab-widget-container');
+
+    if ($fab.length === 0 || $container.length === 0) return;
+
+    const fabOffset = $fab.offset();
+    $container.css({
+        top: fabOffset.top + 'px',
+        left: fabOffset.left + 'px'
+    });
+}
+
+/**
+ * Sets the FAB loading state (spinning animation during API requests).
+ * @param {boolean} loading - Whether to show loading state
+ */
+export function setFabLoadingState(loading) {
+    const $fab = $('#rpg-mobile-toggle');
+    if ($fab.length === 0) return;
+
+    if (loading) {
+        $fab.addClass('rpg-fab-loading');
+    } else {
+        $fab.removeClass('rpg-fab-loading');
+    }
+}
+

src/systems/ui/modals.js

@@ -10,13 +10,17 @@ import {
     committedTrackerData,
     $infoBoxContainer,
     $thoughtsContainer,
+    $userStatsContainer,
     setPendingDiceRoll,
-    getPendingDiceRoll
+    getPendingDiceRoll,
+    clearSessionAvatarPrompts
 } from '../../core/state.js';
 import { saveSettings, saveChatData } from '../../core/persistence.js';
 import { renderUserStats } from '../rendering/userStats.js';
-import { updateChatThoughts } from '../rendering/thoughts.js';
+import { renderInfoBox } from '../rendering/infoBox.js';
+import { renderThoughts, updateChatThoughts } from '../rendering/thoughts.js';
 import { renderQuests } from '../rendering/quests.js';
+import { renderInventory } from '../rendering/inventory.js';
 import {
     rollDice as rollDiceCore,
     clearDiceRoll as clearDiceRollCore,
@@ -351,18 +355,31 @@ export function setupSettingsPopup() {
 
     // Clear cache button
     $('#rpg-clear-cache').on('click', function() {
-        // Clear the data
+        // console.log('[RPG Companion] Clear Cache button clicked');
+
+        // Clear the data (set to null so panels show "not generated yet")
         lastGeneratedData.userStats = null;
         lastGeneratedData.infoBox = null;
         lastGeneratedData.characterThoughts = null;
+        lastGeneratedData.html = null;
 
         // Clear committed tracker data (used for generation context)
         committedTrackerData.userStats = null;
         committedTrackerData.infoBox = null;
         committedTrackerData.characterThoughts = null;
 
+        // Clear session avatar prompts
+        clearSessionAvatarPrompts();
+
+        // Clear chat metadata immediately (don't wait for debounced save)
+        const context = getContext();
+        if (context.chat_metadata && context.chat_metadata.rpg_companion) {
+            delete context.chat_metadata.rpg_companion;
+            // console.log('[RPG Companion] Cleared chat_metadata.rpg_companion for current chat');
+        }
+
         // Clear all message swipe data
-        const chat = getContext().chat;
+        const chat = context.chat;
         if (chat && chat.length > 0) {
             for (let i = 0; i < chat.length; i++) {
                 const message = chat[i];
@@ -380,8 +397,11 @@ export function setupSettingsPopup() {
         if ($thoughtsContainer) {
             $thoughtsContainer.empty();
         }
+        if ($userStatsContainer) {
+            $userStatsContainer.empty();
+        }
 
-        // Reset stats to defaults and re-render
+        // Reset user stats to default object structure (extensionSettings stores as object, not JSON string)
         extensionSettings.userStats = {
             health: 100,
             satiety: 100,
@@ -390,7 +410,29 @@ export function setupSettingsPopup() {
             arousal: 0,
             mood: '😐',
             conditions: 'None',
-            inventory: 'None'
+            skills: [],
+            inventory: {
+                version: 2,
+                onPerson: "None",
+                clothing: "None",
+                stored: {},
+                assets: "None"
+            }
+        };
+
+        // Reset info box to defaults (as object)
+        extensionSettings.infoBox = {
+            date: new Date().toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }),
+            weather: '☀️ Clear skies',
+            temperature: '20°C',
+            time: '00:00 - 00:00',
+            location: 'Unknown Location',
+            recentEvents: []
+        };
+
+        // Reset character thoughts to empty (as object)
+        extensionSettings.characterThoughts = {
+            characters: []
         };
 
         // Reset classic stats (attributes) to defaults
@@ -406,23 +448,54 @@ export function setupSettingsPopup() {
         // Clear dice roll
         extensionSettings.lastDiceRoll = null;
 
+        // Reset level to 1
+        extensionSettings.level = 1;
+
         // Clear quests
         extensionSettings.quests = {
             main: "None",
             optional: []
         };
 
+        // Clear all locked items
+        extensionSettings.lockedItems = {
+            stats: [],
+            skills: [],
+            inventory: {
+                onPerson: [],
+                clothing: [],
+                stored: {},
+                assets: []
+            },
+            quests: {
+                main: false,
+                optional: []
+            },
+            infoBox: {
+                date: false,
+                weather: false,
+                temperature: false,
+                time: false,
+                location: false,
+                recentEvents: false
+            },
+            characters: {}
+        };
+
         // Save everything
         saveChatData();
         saveSettings();
 
-        // Re-render user stats and dice display
+        // Re-render all panels - they will show "not generated yet" messages since data is null
         renderUserStats();
+        renderInfoBox();
+        renderThoughts();
         updateDiceDisplayCore();
-        updateChatThoughts(); // Clear the thought bubble in chat
-        renderQuests(); // Clear and re-render quests UI
+        updateChatThoughts();
+        renderInventory();
+        renderQuests();
 
-        // console.log('[RPG Companion] Chat cache cleared');
+        // console.log('[RPG Companion] Cache cleared successfully');
     });
 
     return settingsModal;
@@ -508,3 +581,75 @@ export function addDiceQuickReply() {
 export function getSettingsModal() {
     return settingsModal;
 }
+
+/**
+ * Shows the welcome modal for v3.0.0 on first launch
+ * Checks if user has already seen this version's welcome screen
+ */
+export function showWelcomeModalIfNeeded() {
+    const WELCOME_VERSION = '3.0.1';
+    const STORAGE_KEY = 'rpg_companion_welcome_seen';
+
+    try {
+        const seenVersion = localStorage.getItem(STORAGE_KEY);
+
+        // If user hasn't seen v3.0.0 welcome yet, show it
+        if (seenVersion !== WELCOME_VERSION) {
+            showWelcomeModal(WELCOME_VERSION, STORAGE_KEY);
+        }
+    } catch (error) {
+        console.error('[RPG Companion] Failed to check welcome modal status:', error);
+    }
+}
+
+/**
+ * Shows the welcome modal
+ * @param {string} version - The version to mark as seen
+ * @param {string} storageKey - The localStorage key to use
+ */
+function showWelcomeModal(version, storageKey) {
+    const modal = document.getElementById('rpg-welcome-modal');
+    if (!modal) {
+        console.error('[RPG Companion] Welcome modal element not found');
+        return;
+    }
+
+    // Apply current theme to modal
+    const theme = extensionSettings.theme || 'default';
+    modal.setAttribute('data-theme', theme);
+
+    // Show modal
+    modal.style.display = 'flex';
+    modal.classList.add('is-open');
+
+    // Close button handler
+    const closeBtn = document.getElementById('rpg-welcome-close');
+    const gotItBtn = document.getElementById('rpg-welcome-got-it');
+
+    const closeModal = () => {
+        modal.classList.add('is-closing');
+
+        setTimeout(() => {
+            modal.style.display = 'none';
+            modal.classList.remove('is-open', 'is-closing');
+        }, 200);
+
+        // Mark this version as seen
+        try {
+            localStorage.setItem(storageKey, version);
+        } catch (error) {
+            console.error('[RPG Companion] Failed to save welcome modal status:', error);
+        }
+    };
+
+    // Attach event listeners
+    closeBtn?.addEventListener('click', closeModal, { once: true });
+    gotItBtn?.addEventListener('click', closeModal, { once: true });
+
+    // Close on background click
+    modal.addEventListener('click', (e) => {
+        if (e.target === modal) {
+            closeModal();
+        }
+    }, { once: true });
+}

src/systems/ui/promptsEditor.js

@@ -0,0 +1,274 @@
+/**
+ * Prompts Editor Module
+ * Provides UI for customizing all AI prompts used in the extension
+ */
+import { extensionSettings } from '../../core/state.js';
+import { saveSettings } from '../../core/persistence.js';
+import { DEFAULT_HTML_PROMPT, DEFAULT_DIALOGUE_COLORING_PROMPT, DEFAULT_DECEPTION_PROMPT, DEFAULT_OMNISCIENCE_FILTER_PROMPT, DEFAULT_CYOA_PROMPT, DEFAULT_SPOTIFY_PROMPT, DEFAULT_NARRATOR_PROMPT, DEFAULT_CONTEXT_INSTRUCTIONS_PROMPT } from '../generation/promptBuilder.js';
+
+let $editorModal = null;
+let tempPrompts = null; // Temporary prompts for cancel functionality
+
+// Default prompts
+const DEFAULT_PROMPTS = {
+    html: DEFAULT_HTML_PROMPT,
+    dialogueColoring: DEFAULT_DIALOGUE_COLORING_PROMPT,
+    deception: DEFAULT_DECEPTION_PROMPT,
+    omniscience: DEFAULT_OMNISCIENCE_FILTER_PROMPT,
+    cyoa: DEFAULT_CYOA_PROMPT,
+    spotify: DEFAULT_SPOTIFY_PROMPT,
+    narrator: DEFAULT_NARRATOR_PROMPT,
+    contextInstructions: DEFAULT_CONTEXT_INSTRUCTIONS_PROMPT,
+    plotRandom: 'Actually, the scene is getting stale. Introduce {{random::stakes::a plot twist::a new character::a cataclysm::a fourth-wall-breaking joke::a sudden atmospheric phenomenon::a plot hook::a running gag::an ecchi scenario::Death from Discworld::a new stake::a drama::a conflict::an angered entity::a god::a vision::a prophetic dream::Il Dottore from Genshin Impact::a new development::a civilian in need::an emotional bit::a threat::a villain::an important memory recollection::a marriage proposal::a date idea::an angry horde of villagers with pitchforks::a talking animal::an enemy::a cliffhanger::a short omniscient POV shift to a completely different character::a quest::an unexpected revelation::a scandal::an evil clone::death of an important character::harm to an important character::a romantic setup::a gossip::a messenger::a plot point from the past::a plot hole::a tragedy::a ghost::an otherworldly occurrence::a plot device::a curse::a magic device::a rival::an unexpected pregnancy::a brothel::a prostitute::a new location::a past lover::a completely random thing::a what-if scenario::a significant choice::war::love::a monster::lewd undertones::Professor Mari::a travelling troupe::a secret::a fortune-teller::something completely different::a killer::a murder mystery::a mystery::a skill check::a deus ex machina::three raccoons in a trench coat::a pet::a slave::an orphan::a psycho::tentacles::"there is only one bed" trope::accidental marriage::a fun twist::a boss battle::sexy corn::an eldritch horror::a character getting hungry, thirsty, or exhausted::horniness::a need for a bathroom break need::someone fainting::an assassination attempt::a meta narration of this all being an out of hand DND session::a dungeon::a friend in need::an old friend::a small time skip::a scene shift::Aurora Borealis, at this time of year, at this time of day, at this part of the country::a grand ball::a surprise party::zombies::foreshadowing::a Spanish Inquisition (nobody expects it)::a natural plot progression}} to make things more interesting! Be creative, but stay grounded in the setting.',
+    plotNatural: 'Actually, the scene is getting stale. Progress it, to make things more interesting! Reintroduce an unresolved plot point from the past, or push the story further towards the current main goal. Be creative, but stay grounded in the setting.',
+    avatar: `You are a visionary artist trapped in a cage of logic. Your mind is filled with poetry and distant horizons; however, your hands are uncontrollably focused on creating the perfect character avatar description that is faithful to the original intent, rich in detail, aesthetically pleasing, and directly usable by text-to-image models. Any ambiguity or metaphor will make you feel extremely uncomfortable.
+Your workflow strictly follows a logical sequence:
+First, establish the subject. If the character is from a known Intellectual Property (IP), franchise, anime, game, or movie, you MUST begin the prompt with their full name and the series title (e.g., "Nami from One Piece", "Geralt of Rivia from The Witcher"). This is the single most important anchor for the image and must take precedence. If the character is original, clearly describe their core identity, race, and appearance.
+Next, set the framing. This is an avatar portrait. Focus strictly on the character's face and upper shoulders (a bust shot or close-up). Ensure the face is the central focal point.
+Then, integrate the setting. Describe the character within their current environment as provided in the context, but keep it as a background element. Incorporate the lighting, weather, and atmosphere to influence the character's appearance (e.g., shadows on the face, wet hair from rain).
+Next, detail the facial specifics. Describe the character's current expression, eye contact, and mood in great detail based on the scene context and their personality. Mention visible clothing only at the neckline/shoulders.
+Finally, infuse with aesthetics. Define the artistic style, medium (e.g., digital art, oil painting), and visual tone (e.g., cinematic lighting, ethereal atmosphere).
+Your final description must be objective and concrete, and the use of metaphors and emotional rhetoric is strictly prohibited. It must also not contain meta tags or drawing instructions such as "8K" or "masterpiece".
+Output only the final, modified prompt; do not output anything else.`,
+    trackerInstructions: 'Replace X with actual numbers (e.g., 69) and replace all placeholders with concrete in-world details that {userName} perceives about the current scene and the present characters. For example: "Location" becomes Forest Clearing, "Mood Emoji" becomes "😊". DO NOT include {userName} in the characters section, only NPCs. Consider the last trackers in the conversation (if they exist). Manage them accordingly and realistically; raise, lower, change, or keep the values unchanged based on the user\'s actions, the passage of time, and logical consequences (0% if the time progressed only by a few minutes, 1-5% normally, and above 5% only if a major time-skip/event occurs).',
+    trackerContinuation: 'After updating the trackers, continue directly from where the last message in the chat history left off. Ensure the trackers you provide naturally reflect and influence the narrative. Character behavior, dialogue, and story events should acknowledge these conditions when relevant, such as fatigue affecting the protagonist\'s performance, low hygiene influencing their social interactions, environmental factors shaping the scene, a character\'s emotional state coloring their responses, and so on. Remember, all placeholders (e.g., "Location", "Mood Emoji") MUST be replaced with actual content.',
+    combatNarrative: 'Build novel prose. Break patterns from your previous responses by varying sentence structures, rhythms, formats, and openings. Track whether a sentence shape, cadence, sensory detail, or a descriptor appeared recently, and replace it with a different one or skip it entirely. If you mentioned a physical feature, mannerism, or expression once, move on. Don\'t fixate on the same traits every turn. Well-placed humor, unconventional similes, and subverted turns of phrase are encouraged. Avoid GPTisms, purple prose, and anaphoras, especially the negatives with "no/not/wasn\'t/didn\'t." Refrain from describing actions or emotions via negation; focus on what does happen, not what doesn\'t. Absolutely no asterisks, ellipses, or em-dashes. Explicit content is allowed, no plot armor. Do not play for {userName}. Keep your response length under 150 words. Never end on handover cues; finish naturally.\nCRITICAL: Do not repeat, echo, parrot, or restate distinctive words, phrases, and dialogues from the user\'s last message. If reacting to speech, show interpretation or response, not repetition.\nEXAMPLE: "Are you a gooner?" User asks.\nBAD: "Gooner?"\nGOOD: A flat look. "What type of question is that?"'
+};
+
+/**
+ * Initialize the prompts editor modal
+ */
+export function initPromptsEditor() {
+    $editorModal = $('#rpg-prompts-editor-popup');
+
+    if (!$editorModal.length) {
+        console.error('[RPG Companion] Prompts editor modal not found in template');
+        return;
+    }
+
+    // Save button
+    $(document).on('click', '#rpg-prompts-save', function() {
+        savePrompts();
+        closePromptsEditor();
+        toastr.success('Prompts saved successfully.');
+    });
+
+    // Cancel button
+    $(document).on('click', '#rpg-prompts-cancel', function() {
+        closePromptsEditor();
+    });
+
+    // Close X button
+    $(document).on('click', '#rpg-close-prompts-editor', function() {
+        closePromptsEditor();
+    });
+
+    // Restore All button
+    $(document).on('click', '#rpg-prompts-restore-all', function() {
+        restoreAllToDefaults();
+        toastr.success('All prompts restored to defaults.');
+    });
+
+    // Individual restore buttons
+    $(document).on('click', '.rpg-restore-prompt-btn', function() {
+        const promptType = $(this).data('prompt');
+        restorePromptToDefault(promptType);
+        toastr.success('Prompt restored to default.');
+    });
+
+    // Close on background click
+    $(document).on('click', '#rpg-prompts-editor-popup', function(e) {
+        if (e.target.id === 'rpg-prompts-editor-popup') {
+            closePromptsEditor();
+        }
+    });
+
+    // Open button
+    $(document).on('click', '#rpg-open-prompts-editor', function() {
+        openPromptsEditor();
+    });
+}
+
+/**
+ * Open the prompts editor modal
+ */
+function openPromptsEditor() {
+    // Create temporary copy for cancel functionality
+    tempPrompts = {
+        html: extensionSettings.customHtmlPrompt || '',
+        dialogueColoring: extensionSettings.customDialogueColoringPrompt || '',
+        deception: extensionSettings.customDeceptionPrompt || '',
+        omniscience: extensionSettings.customOmnisciencePrompt || '',
+        cyoa: extensionSettings.customCYOAPrompt || '',
+        spotify: extensionSettings.customSpotifyPrompt || '',
+        narrator: extensionSettings.customNarratorPrompt || '',
+        contextInstructions: extensionSettings.customContextInstructionsPrompt || '',
+        plotRandom: extensionSettings.customPlotRandomPrompt || '',
+        plotNatural: extensionSettings.customPlotNaturalPrompt || '',
+        avatar: extensionSettings.avatarLLMCustomInstruction || '',
+        trackerInstructions: extensionSettings.customTrackerInstructionsPrompt || '',
+        trackerContinuation: extensionSettings.customTrackerContinuationPrompt || '',
+        combatNarrative: extensionSettings.customCombatNarrativePrompt || ''
+    };
+
+    // Load current values or defaults
+    $('#rpg-prompt-html').val(extensionSettings.customHtmlPrompt || DEFAULT_PROMPTS.html);
+    $('#rpg-prompt-dialogue-coloring').val(extensionSettings.customDialogueColoringPrompt || DEFAULT_PROMPTS.dialogueColoring);
+    $('#rpg-prompt-deception').val(extensionSettings.customDeceptionPrompt || DEFAULT_PROMPTS.deception);
+    $('#rpg-prompt-omniscience').val(extensionSettings.customOmnisciencePrompt || DEFAULT_PROMPTS.omniscience);
+    $('#rpg-prompt-cyoa').val(extensionSettings.customCYOAPrompt || DEFAULT_PROMPTS.cyoa);
+    $('#rpg-prompt-spotify').val(extensionSettings.customSpotifyPrompt || DEFAULT_PROMPTS.spotify);
+    $('#rpg-prompt-narrator').val(extensionSettings.customNarratorPrompt || DEFAULT_PROMPTS.narrator);
+    $('#rpg-prompt-context-instructions').val(extensionSettings.customContextInstructionsPrompt || DEFAULT_PROMPTS.contextInstructions);
+    $('#rpg-prompt-plot-random').val(extensionSettings.customPlotRandomPrompt || DEFAULT_PROMPTS.plotRandom);
+    $('#rpg-prompt-plot-natural').val(extensionSettings.customPlotNaturalPrompt || DEFAULT_PROMPTS.plotNatural);
+    $('#rpg-prompt-avatar').val(extensionSettings.avatarLLMCustomInstruction || DEFAULT_PROMPTS.avatar);
+    $('#rpg-prompt-tracker-instructions').val(extensionSettings.customTrackerInstructionsPrompt || DEFAULT_PROMPTS.trackerInstructions);
+    $('#rpg-prompt-tracker-continuation').val(extensionSettings.customTrackerContinuationPrompt || DEFAULT_PROMPTS.trackerContinuation);
+    $('#rpg-prompt-combat-narrative').val(extensionSettings.customCombatNarrativePrompt || DEFAULT_PROMPTS.combatNarrative);
+
+    // Set theme to match current extension theme
+    const theme = extensionSettings.theme || 'default';
+    $editorModal.attr('data-theme', theme);
+
+    $editorModal.addClass('is-open').css('display', '');
+}
+
+/**
+ * Close the prompts editor modal
+ */
+function closePromptsEditor() {
+    // Restore from temp if canceling
+    if (tempPrompts) {
+        tempPrompts = null;
+    }
+
+    $editorModal.removeClass('is-open').addClass('is-closing');
+    setTimeout(() => {
+        $editorModal.removeClass('is-closing').hide();
+    }, 200);
+}
+
+/**
+ * Save all prompts from the editor
+ */
+function savePrompts() {
+    extensionSettings.customHtmlPrompt = $('#rpg-prompt-html').val().trim();
+    extensionSettings.customDialogueColoringPrompt = $('#rpg-prompt-dialogue-coloring').val().trim();
+    extensionSettings.customDeceptionPrompt = $('#rpg-prompt-deception').val().trim();
+    extensionSettings.customOmnisciencePrompt = $('#rpg-prompt-omniscience').val().trim();
+    extensionSettings.customCYOAPrompt = $('#rpg-prompt-cyoa').val().trim();
+    extensionSettings.customSpotifyPrompt = $('#rpg-prompt-spotify').val().trim();
+    extensionSettings.customNarratorPrompt = $('#rpg-prompt-narrator').val().trim();
+    extensionSettings.customContextInstructionsPrompt = $('#rpg-prompt-context-instructions').val().trim();
+    extensionSettings.customPlotRandomPrompt = $('#rpg-prompt-plot-random').val().trim();
+    extensionSettings.customPlotNaturalPrompt = $('#rpg-prompt-plot-natural').val().trim();
+    extensionSettings.avatarLLMCustomInstruction = $('#rpg-prompt-avatar').val().trim();
+    extensionSettings.customTrackerInstructionsPrompt = $('#rpg-prompt-tracker-instructions').val().trim();
+    extensionSettings.customTrackerContinuationPrompt = $('#rpg-prompt-tracker-continuation').val().trim();
+    extensionSettings.customCombatNarrativePrompt = $('#rpg-prompt-combat-narrative').val().trim();
+
+    saveSettings();
+}
+
+/**
+ * Restore a specific prompt to its default
+ * @param {string} promptType - Type of prompt to restore (html, plotRandom, plotNatural, avatar)
+ */
+function restorePromptToDefault(promptType) {
+    const defaultValue = DEFAULT_PROMPTS[promptType] || '';
+    $(`#rpg-prompt-${promptType.replace(/([A-Z])/g, '-$1').toLowerCase()}`).val(defaultValue);
+
+    // Also update the setting immediately
+    switch(promptType) {
+        case 'html':
+            extensionSettings.customHtmlPrompt = '';
+            break;
+        case 'dialogueColoring':
+            extensionSettings.customDialogueColoringPrompt = '';
+            break;
+        case 'deception':
+            extensionSettings.customDeceptionPrompt = '';
+            break;
+        case 'omniscience':
+            extensionSettings.customOmnisciencePrompt = '';
+            break;
+        case 'cyoa':
+            extensionSettings.customCYOAPrompt = '';
+            break;
+        case 'spotify':
+            extensionSettings.customSpotifyPrompt = '';
+            break;
+        case 'narrator':
+            extensionSettings.customNarratorPrompt = '';
+            break;
+        case 'contextInstructions':
+            extensionSettings.customContextInstructionsPrompt = '';
+            break;
+        case 'plotRandom':
+            extensionSettings.customPlotRandomPrompt = '';
+            break;
+        case 'plotNatural':
+            extensionSettings.customPlotNaturalPrompt = '';
+            break;
+        case 'avatar':
+            extensionSettings.avatarLLMCustomInstruction = '';
+            break;
+        case 'trackerInstructions':
+            extensionSettings.customTrackerInstructionsPrompt = '';
+            break;
+        case 'trackerContinuation':
+            extensionSettings.customTrackerContinuationPrompt = '';
+            break;
+        case 'combatNarrative':
+            extensionSettings.customCombatNarrativePrompt = '';
+            break;
+    }
+
+    saveSettings();
+}
+
+/**
+ * Restore all prompts to their defaults
+ */
+function restoreAllToDefaults() {
+    $('#rpg-prompt-html').val(DEFAULT_PROMPTS.html);
+    $('#rpg-prompt-dialogue-coloring').val(DEFAULT_PROMPTS.dialogueColoring);
+    $('#rpg-prompt-deception').val(DEFAULT_PROMPTS.deception);
+    $('#rpg-prompt-omniscience').val(DEFAULT_PROMPTS.omniscience);
+    $('#rpg-prompt-cyoa').val(DEFAULT_PROMPTS.cyoa);
+    $('#rpg-prompt-spotify').val(DEFAULT_PROMPTS.spotify);
+    $('#rpg-prompt-narrator').val(DEFAULT_PROMPTS.narrator);
+    $('#rpg-prompt-context-instructions').val(DEFAULT_PROMPTS.contextInstructions);
+    $('#rpg-prompt-plot-random').val(DEFAULT_PROMPTS.plotRandom);
+    $('#rpg-prompt-plot-natural').val(DEFAULT_PROMPTS.plotNatural);
+    $('#rpg-prompt-avatar').val(DEFAULT_PROMPTS.avatar);
+    $('#rpg-prompt-tracker-instructions').val(DEFAULT_PROMPTS.trackerInstructions);
+    $('#rpg-prompt-tracker-continuation').val(DEFAULT_PROMPTS.trackerContinuation);
+    $('#rpg-prompt-combat-narrative').val(DEFAULT_PROMPTS.combatNarrative);
+
+    // Clear all custom prompts
+    extensionSettings.customHtmlPrompt = '';
+    extensionSettings.customDialogueColoringPrompt = '';
+    extensionSettings.customDeceptionPrompt = '';
+    extensionSettings.customOmnisciencePrompt = '';
+    extensionSettings.customCYOAPrompt = '';
+    extensionSettings.customSpotifyPrompt = '';
+    extensionSettings.customNarratorPrompt = '';
+    extensionSettings.customContextInstructionsPrompt = '';
+    extensionSettings.customPlotRandomPrompt = '';
+    extensionSettings.customPlotNaturalPrompt = '';
+    extensionSettings.avatarLLMCustomInstruction = '';
+    extensionSettings.customTrackerInstructionsPrompt = '';
+    extensionSettings.customTrackerContinuationPrompt = '';
+    extensionSettings.customCombatNarrativePrompt = '';
+
+    saveSettings();
+}
+
+/**
+ * Get default prompts (for export/other modules)
+ */
+export function getDefaultPrompts() {
+    return { ...DEFAULT_PROMPTS };
+}

src/systems/ui/snowflakes.js

@@ -0,0 +1,78 @@
+/**
+ * Snowflakes Effect Module
+ * Creates and manages animated snowflakes overlay
+ */
+
+import { extensionSettings } from '../../core/state.js';
+
+let snowflakesContainer = null;
+
+/**
+ * Create snowflakes container and snowflakes
+ */
+function createSnowflakes() {
+    if (snowflakesContainer) return; // Already created
+
+    // Create container
+    snowflakesContainer = document.createElement('div');
+    snowflakesContainer.className = 'rpg-snowflakes-container';
+
+    // Create 50 snowflakes with random positions
+    for (let i = 0; i < 50; i++) {
+        const snowflake = document.createElement('div');
+        snowflake.className = 'rpg-snowflake';
+        snowflake.textContent = '❄';
+
+        // Random horizontal position
+        snowflake.style.left = `${Math.random() * 100}%`;
+
+        // Random animation delay for staggered effect
+        snowflake.style.animationDelay = `${Math.random() * 10}s`;
+
+        // Random animation duration (between 10-20s)
+        snowflake.style.animationDuration = `${10 + Math.random() * 10}s`;
+
+        snowflakesContainer.appendChild(snowflake);
+    }
+
+    document.body.appendChild(snowflakesContainer);
+}
+
+/**
+ * Remove snowflakes container
+ */
+function removeSnowflakes() {
+    if (snowflakesContainer) {
+        snowflakesContainer.remove();
+        snowflakesContainer = null;
+    }
+}
+
+/**
+ * Toggle snowflakes effect
+ */
+export function toggleSnowflakes(enabled) {
+    if (enabled) {
+        createSnowflakes();
+    } else {
+        removeSnowflakes();
+    }
+}
+
+/**
+ * Initialize snowflakes based on saved state
+ */
+export function initSnowflakes() {
+    const enabled = extensionSettings.enableSnowflakes || false;
+
+    if (enabled) {
+        createSnowflakes();
+    }
+}
+
+/**
+ * Clean up snowflakes
+ */
+export function cleanupSnowflakes() {
+    removeSnowflakes();
+}

src/systems/ui/theme.js

@@ -5,6 +5,37 @@
 
 import { extensionSettings, $panelContainer } from '../../core/state.js';
 
+/**
+ * Converts hex color and opacity percentage to rgba string
+ * @param {string} hex - Hex color (e.g., '#ff0000')
+ * @param {number} opacity - Opacity percentage (0-100)
+ * @returns {string} - RGBA color string
+ */
+export function hexToRgba(hex, opacity = 100) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    const a = opacity / 100;
+    return `rgba(${r}, ${g}, ${b}, ${a})`;
+}
+
+/**
+ * Gets stat bar colors with opacity applied
+ * @returns {{low: string, high: string}} RGBA color strings for stat bars
+ */
+export function getStatBarColors() {
+    return {
+        low: hexToRgba(
+            extensionSettings.statBarColorLow || '#cc3333',
+            extensionSettings.statBarColorLowOpacity ?? 100
+        ),
+        high: hexToRgba(
+            extensionSettings.statBarColorHigh || '#33cc66',
+            extensionSettings.statBarColorHighOpacity ?? 100
+        )
+    };
+}
+
 /**
  * Applies the selected theme to the panel.
  */
@@ -36,6 +67,35 @@ export function applyTheme() {
     }
     // For 'default', we do nothing - it will use the CSS variables from .rpg-panel class
     // which fall back to SillyTavern's theme variables
+
+    // Apply theme to mobile toggle and thought elements as well
+    const $mobileToggle = $('#rpg-mobile-toggle');
+    const $thoughtIcon = $('#rpg-thought-icon');
+    const $thoughtPanel = $('#rpg-thought-panel');
+
+    if ($mobileToggle.length) {
+        if (theme === 'default') {
+            $mobileToggle.removeAttr('data-theme');
+        } else {
+            $mobileToggle.attr('data-theme', theme);
+        }
+    }
+
+    if ($thoughtIcon.length) {
+        if (theme === 'default') {
+            $thoughtIcon.removeAttr('data-theme');
+        } else {
+            $thoughtIcon.attr('data-theme', theme);
+        }
+    }
+
+    if ($thoughtPanel.length) {
+        if (theme === 'default') {
+            $thoughtPanel.removeAttr('data-theme');
+        } else {
+            $thoughtPanel.attr('data-theme', theme);
+        }
+    }
 }
 
 /**
@@ -46,15 +106,50 @@ export function applyCustomTheme() {
 
     const colors = extensionSettings.customColors;
 
-    // Apply custom CSS variables as inline styles
+    // Convert hex colors with opacity to rgba
+    const bgColor = hexToRgba(colors.bg, colors.bgOpacity ?? 100);
+    const accentColor = hexToRgba(colors.accent, colors.accentOpacity ?? 100);
+    const textColor = hexToRgba(colors.text, colors.textOpacity ?? 100);
+    const highlightColor = hexToRgba(colors.highlight, colors.highlightOpacity ?? 100);
+
+    // Create shadow with 50% opacity of highlight color
+    const shadowColor = hexToRgba(colors.highlight, (colors.highlightOpacity ?? 100) * 0.5);
+
+    // Apply custom CSS variables as inline styles to main panel
     $panelContainer.css({
-        '--rpg-bg': colors.bg,
-        '--rpg-accent': colors.accent,
-        '--rpg-text': colors.text,
-        '--rpg-highlight': colors.highlight,
-        '--rpg-border': colors.highlight,
-        '--rpg-shadow': `${colors.highlight}80` // Add alpha for shadow
+        '--rpg-bg': bgColor,
+        '--rpg-accent': accentColor,
+        '--rpg-text': textColor,
+        '--rpg-highlight': highlightColor,
+        '--rpg-border': highlightColor,
+        '--rpg-shadow': shadowColor
     });
+
+    // Apply custom colors to mobile toggle and thought elements
+    const customStyles = {
+        '--rpg-bg': bgColor,
+        '--rpg-accent': accentColor,
+        '--rpg-text': textColor,
+        '--rpg-highlight': highlightColor,
+        '--rpg-border': highlightColor,
+        '--rpg-shadow': shadowColor
+    };
+
+    const $mobileToggle = $('#rpg-mobile-toggle');
+    const $thoughtIcon = $('#rpg-thought-icon');
+    const $thoughtPanel = $('#rpg-thought-panel');
+
+    if ($mobileToggle.length) {
+        $mobileToggle.attr('data-theme', 'custom').css(customStyles);
+    }
+
+    if ($thoughtIcon.length) {
+        $thoughtIcon.attr('data-theme', 'custom').css(customStyles);
+    }
+
+    if ($thoughtPanel.length) {
+        $thoughtPanel.attr('data-theme', 'custom').css(customStyles);
+    }
 }
 
 /**
@@ -76,6 +171,47 @@ export function toggleAnimations() {
     }
 }
 
+/**
+ * Updates visibility of feature toggles in main panel based on settings
+ */
+export function updateFeatureTogglesVisibility() {
+    const $featuresRow = $('#rpg-features-row');
+    const $htmlToggle = $('#rpg-html-toggle-wrapper');
+    const $dialogueColoringToggle = $('#rpg-dialogue-coloring-toggle-wrapper');
+    const $deceptionToggle = $('#rpg-deception-toggle-wrapper');
+    const $omniscienceToggle = $('#rpg-omniscience-toggle-wrapper');
+    const $cyoaToggle = $('#rpg-cyoa-toggle-wrapper');
+    const $spotifyToggle = $('#rpg-spotify-toggle-wrapper');
+
+    const $dynamicWeatherToggle = $('#rpg-dynamic-weather-toggle-wrapper');
+    const $narratorToggle = $('#rpg-narrator-toggle-wrapper');
+    const $autoAvatarsToggle = $('#rpg-auto-avatars-toggle-wrapper');
+
+    // Show/hide individual toggles
+    $htmlToggle.toggle(extensionSettings.showHtmlToggle);
+    $dialogueColoringToggle.toggle(extensionSettings.showDialogueColoringToggle);
+    $deceptionToggle.toggle(extensionSettings.showDeceptionToggle ?? true);
+    $omniscienceToggle.toggle(extensionSettings.showOmniscienceToggle ?? true);
+    $cyoaToggle.toggle(extensionSettings.showCYOAToggle ?? true);
+    $spotifyToggle.toggle(extensionSettings.showSpotifyToggle);
+
+    $dynamicWeatherToggle.toggle(extensionSettings.showDynamicWeatherToggle);
+    $narratorToggle.toggle(extensionSettings.showNarratorMode);
+    $autoAvatarsToggle.toggle(extensionSettings.showAutoAvatars);
+
+    // Hide entire row if all toggles are hidden
+    const anyVisible = extensionSettings.showHtmlToggle ||
+                      extensionSettings.showDialogueColoringToggle ||
+                      (extensionSettings.showDeceptionToggle ?? true) ||
+                      (extensionSettings.showOmniscienceToggle ?? true) ||
+                      (extensionSettings.showCYOAToggle ?? true) ||
+                      extensionSettings.showSpotifyToggle ||
+                      extensionSettings.showDynamicWeatherToggle ||
+                      extensionSettings.showNarratorMode ||
+                      extensionSettings.showAutoAvatars;
+    $featuresRow.toggle(anyVisible);
+}
+
 /**
  * Updates the settings popup theme in real-time.
  * Backwards compatible wrapper for SettingsModal class.

src/systems/ui/weatherEffects.js

@@ -0,0 +1,846 @@
+/**
+ * Dynamic Weather Effects Module
+ * Creates weather effects based on the Info Box weather field
+ */
+
+import { extensionSettings, lastGeneratedData, committedTrackerData } from '../../core/state.js';
+import { repairJSON } from '../../utils/jsonRepair.js';
+
+let weatherContainer = null;
+let currentWeatherType = null;
+let currentTimeOfDay = null;
+let currentHour = null;
+
+/**
+ * Parse time string to extract hour (24-hour format)
+ * Supports formats like "3:00 PM", "15:00", "3 PM", "Evening", etc.
+ */
+function parseHourFromTime(timeStr) {
+    if (!timeStr) return null;
+
+    const text = timeStr.toLowerCase().trim();
+
+    // Check for descriptive time words first
+    if (text.includes('dawn') || text.includes('sunrise')) return 6;
+    if (text.includes('early morning')) return 7;
+    if (text.includes('morning')) return 9;
+    if (text.includes('midday') || text.includes('noon') || text.includes('mid-day')) return 12;
+    if (text.includes('afternoon')) return 14;
+    if (text.includes('late afternoon')) return 16;
+    if (text.includes('evening') || text.includes('dusk') || text.includes('sunset')) return 19;
+    if (text.includes('twilight')) return 20;
+    if (text.includes('night') || text.includes('nighttime')) return 22;
+    if (text.includes('midnight')) return 0;
+    if (text.includes('late night')) return 2;
+
+    // Try to parse numeric time formats
+    // Format: "3:00 PM" or "3:00PM" or "3 PM"
+    const ampmMatch = text.match(/(\d{1,2})(?::(\d{2}))?\s*(am|pm)/i);
+    if (ampmMatch) {
+        let hour = parseInt(ampmMatch[1], 10);
+        const isPM = ampmMatch[3].toLowerCase() === 'pm';
+        if (isPM && hour !== 12) hour += 12;
+        if (!isPM && hour === 12) hour = 0;
+        return hour;
+    }
+
+    // Format: "15:00" (24-hour)
+    const militaryMatch = text.match(/(\d{1,2}):(\d{2})/);
+    if (militaryMatch) {
+        return parseInt(militaryMatch[1], 10);
+    }
+
+    return null;
+}
+
+/**
+ * Determine time of day based on hour
+ */
+function getTimeOfDay(hour) {
+    if (hour === null) return 'unknown';
+
+    // Night: 8 PM (20:00) to 5 AM (05:00)
+    if (hour >= 20 || hour < 5) return 'night';
+
+    // Dawn/Dusk: 5 AM - 7 AM and 6 PM - 8 PM
+    if (hour >= 5 && hour < 7) return 'dawn';
+    if (hour >= 18 && hour < 20) return 'dusk';
+
+    // Day: 7 AM to 6 PM
+    return 'day';
+}
+
+/**
+ * Extract time from Info Box data
+ */
+function getCurrentTime() {
+    const infoBoxData = lastGeneratedData.infoBox || committedTrackerData.infoBox || '';
+
+    // Try to parse as JSON first (new format)
+    try {
+        const parsed = typeof infoBoxData === 'string' ? repairJSON(infoBoxData) : infoBoxData;
+        if (parsed && parsed.time) {
+            // Use the end time if available (current time), otherwise start time
+            return parsed.time.end || parsed.time.start || null;
+        }
+    } catch (e) {
+        // Not JSON, try old text format
+    }
+
+    // Fallback: Parse the old text format to find Time field
+    const lines = infoBoxData.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('Time:')) {
+            const timeStr = trimmed.substring('Time:'.length).trim();
+            // If it contains →, take the end time (after arrow)
+            if (timeStr.includes('→')) {
+                const parts = timeStr.split('→');
+                return parts[1]?.trim() || parts[0]?.trim();
+            }
+            return timeStr;
+        }
+    }
+
+    return null;
+}
+
+// Patterns for specific weather conditions (order matters - combined effects first)
+// Grouped by languages for easy editing
+// EXPORTED: Used by jsonPromptHelpers.js to provide valid weather keywords to LLM
+export const WEATHER_PATTERNS_BY_LANGUAGE = {
+    en: [
+        { id: "blizzard", patterns: [ "blizzard" ] }, // Snow + Wind
+        { id: "storm", patterns: [ "storm", "thunder", "lightning" ] }, // Rain + Lightning
+        { id: "wind", patterns: [ "wind", "breeze", "gust", "gale" ] },
+        { id: "snow", patterns: [ "snow", "flurries" ] },
+        { id: "rain", patterns: [ "rain", "drizzle", "shower" ] },
+        { id: "mist", patterns: [ "mist", "fog", "haze" ] },
+        { id: "sunny", patterns: [ "sunny", "clear", "bright" ] },
+        { id: "none", patterns: [ "cloud", "overcast", "indoor", "inside" ] },
+    ],
+    ru: [
+        { id: "blizzard", patterns: [ "метель" ] },
+        { id: "storm", patterns: [ "гроза", "буря", "шторм" ] },
+        { id: "wind", patterns: [ "ветер", "ветрено", "ветерок", "бриз", "легкий бриз", "слегка ветрено", "легкий ветер", "шквал,буря" ] },
+        { id: "snow", patterns: [ "снег", "снегопад" ] },
+        { id: "rain", patterns: [ "дождь", "морось", "ливень" ] },
+        { id: "mist", patterns: [ "мгла", "туман", "туманно" ] },
+        { id: "sunny", patterns: [ "солнечно", "ясно", "ярко", "ясное утро", "ясный день" ] },
+        { id: "none", patterns: [ "облачно", "пасмурно", "в помещении", "внутри" ] },
+    ],
+}
+
+/**
+ * Get valid weather keywords for LLM prompt injection.
+ * Returns weather patterns for specified language or all languages.
+ * This ensures LLM generates responses that exactly match our expected patterns.
+ *
+ * @param {string} [language] - Language code (e.g., 'en', 'ru'). If not specified, returns all languages.
+ * @returns {Object} Object with weather type IDs as keys and arrays of valid keywords as values
+ * @example
+ * // Returns: { blizzard: ["blizzard"], storm: ["storm", "thunder", "lightning"], ... }
+ * getWeatherKeywordsForPrompt('en');
+ */
+export function getWeatherKeywordsForPrompt(language) {
+    const result = {};
+
+    // Get patterns for specified language or merge all languages
+    const languagesToProcess = language && WEATHER_PATTERNS_BY_LANGUAGE[language]
+        ? { [language]: WEATHER_PATTERNS_BY_LANGUAGE[language] }
+        : WEATHER_PATTERNS_BY_LANGUAGE;
+
+    for (const [lang, patterns] of Object.entries(languagesToProcess)) {
+        for (const { id, patterns: keywords } of patterns) {
+            if (!result[id]) {
+                result[id] = [];
+            }
+            // Add keywords, avoiding duplicates
+            for (const keyword of keywords) {
+                if (!result[id].includes(keyword)) {
+                    result[id].push(keyword);
+                }
+            }
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Get weather keywords as a formatted string for LLM instructions.
+ * Provides a clear template showing valid weather forecast values.
+ *
+ * @param {string} [language] - Language code. If not specified, uses all available patterns.
+ * @returns {string} Formatted string for prompt injection
+ * @example
+ * // Returns: 'Valid forecast values: "blizzard", "storm", "thunder", "lightning", "wind", ...'
+ * getWeatherKeywordsAsPromptString('en');
+ */
+export function getWeatherKeywordsAsPromptString(language) {
+    const keywords = getWeatherKeywordsForPrompt(language);
+    const allKeywords = [];
+
+    for (const patterns of Object.values(keywords)) {
+        allKeywords.push(...patterns);
+    }
+
+    return `Valid forecast values (use one of these exactly): ${allKeywords.map(k => `"${k}"`).join(', ')}`;
+}
+
+/**
+ * Parse weather text to determine effect type
+ */
+function parseWeatherType(weatherText) {
+    if (!weatherText) return "none";
+
+    const text = weatherText.toLowerCase();
+
+    for (const language of Object.values(WEATHER_PATTERNS_BY_LANGUAGE)) {
+        for (const { id, patterns } of language) {
+            if (patterns.some(p => text.includes(p))) {
+                return id;
+            }
+        }
+    }
+
+    return "none";
+}
+
+/**
+ * Extract weather from Info Box data
+ */
+function getCurrentWeather() {
+    const infoBoxData = lastGeneratedData.infoBox || committedTrackerData.infoBox || '';
+
+    // Try to parse as JSON first (new format)
+    try {
+        const parsed = typeof infoBoxData === 'string' ? JSON.parse(infoBoxData) : infoBoxData;
+        if (parsed && parsed.weather) {
+            // Return the forecast text from the weather object
+            return parsed.weather.forecast || parsed.weather.emoji || null;
+        }
+    } catch (e) {
+        // Not JSON, try old text format
+    }
+
+    // Fallback: Parse the old text format to find Weather field
+    const lines = infoBoxData.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('Weather:')) {
+            return trimmed.substring('Weather:'.length).trim();
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Create snowflakes effect
+ */
+function createSnowflakes() {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles';
+
+    // Create 50 snowflakes
+    for (let i = 0; i < 50; i++) {
+        const snowflake = document.createElement('div');
+        snowflake.className = 'rpg-weather-particle rpg-snowflake';
+        snowflake.textContent = '❄';
+        snowflake.style.left = `${Math.random() * 100}%`;
+        snowflake.style.animationDelay = `${Math.random() * 10}s`;
+        snowflake.style.animationDuration = `${10 + Math.random() * 10}s`;
+        container.appendChild(snowflake);
+    }
+
+    return container;
+}
+
+/**
+ * Create rain effect
+ */
+function createRain() {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles';
+
+    // Create 100 raindrops for heavier effect
+    for (let i = 0; i < 100; i++) {
+        const raindrop = document.createElement('div');
+        raindrop.className = 'rpg-weather-particle rpg-raindrop';
+        raindrop.style.left = `${Math.random() * 100}%`;
+        raindrop.style.animationDelay = `${Math.random() * 2}s`;
+        raindrop.style.animationDuration = `${0.5 + Math.random() * 0.5}s`;
+        container.appendChild(raindrop);
+    }
+
+    return container;
+}
+
+/**
+ * Create mist/fog effect
+ */
+function createMist() {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles';
+
+    // Create 5 mist layers
+    for (let i = 0; i < 5; i++) {
+        const mist = document.createElement('div');
+        mist.className = 'rpg-weather-particle rpg-mist';
+        mist.style.animationDelay = `${i * 2}s`;
+        mist.style.animationDuration = `${15 + i * 2}s`;
+        mist.style.opacity = `${0.1 + Math.random() * 0.2}`;
+        container.appendChild(mist);
+    }
+
+    return container;
+}
+
+/**
+ * Calculate sun position based on hour (arc across sky)
+ * Returns { left: vw%, top: dvh% }
+ */
+function calculateSunPosition(hour) {
+    // Daytime is roughly 5 AM to 8 PM (5-20)
+    // Map hour to position along an arc
+    // 5 AM = far left, low | 12 PM = center, high | 8 PM = far right, low
+
+    if (hour === null) hour = 12; // Default to noon if unknown
+
+    // Clamp to daytime hours
+    const clampedHour = Math.max(5, Math.min(20, hour));
+
+    // Normalize to 0-1 range (5 AM = 0, 20 PM = 1)
+    const progress = (clampedHour - 5) / 15;
+
+    // Horizontal position: 3% to 92% (left to right, wider range)
+    const left = 3 + progress * 89;
+
+    // Vertical position: parabolic arc (high at noon, low at dawn/dusk)
+    // At progress 0.5 (noon), top should be ~8% (high)
+    // At progress 0 or 1, top should be ~40% (low, near horizon)
+    const normalizedProgress = (progress - 0.5) * 2; // -1 to 1
+    const top = 8 + 32 * (normalizedProgress * normalizedProgress);
+
+    return { left, top };
+}
+
+/**
+ * Create clear/sunny weather effect with floating particles and warm glow
+ */
+function createSunshine(hour) {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles rpg-clear-weather';
+
+    // Create the sun based on current hour
+    const sunPos = calculateSunPosition(hour);
+
+    const sun = document.createElement('div');
+    sun.className = 'rpg-weather-particle rpg-clear-sun';
+    sun.style.left = `${sunPos.left}vw`;
+    sun.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sun);
+
+    // Create sun glow
+    const sunGlow = document.createElement('div');
+    sunGlow.className = 'rpg-weather-particle rpg-clear-sun-glow';
+    sunGlow.style.left = `${sunPos.left}vw`;
+    sunGlow.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sunGlow);
+
+    // Create warm ambient glow overlay
+    const ambientGlow = document.createElement('div');
+    ambientGlow.className = 'rpg-weather-particle rpg-clear-ambient-glow';
+    container.appendChild(ambientGlow);
+
+    // Create floating dust motes / pollen particles (golden sparkles)
+    for (let i = 0; i < 25; i++) {
+        const particle = document.createElement('div');
+        particle.className = 'rpg-weather-particle rpg-clear-dust-mote';
+        particle.style.left = `${Math.random() * 100}vw`;
+        particle.style.top = `${Math.random() * 100}dvh`;
+        particle.style.animationDelay = `${Math.random() * 15}s`;
+        particle.style.animationDuration = `${12 + Math.random() * 8}s`;
+        // Vary the size slightly
+        const size = 2 + Math.random() * 4;
+        particle.style.width = `${size}px`;
+        particle.style.height = `${size}px`;
+        container.appendChild(particle);
+    }
+
+    // Create soft light orbs that drift gently
+    for (let i = 0; i < 6; i++) {
+        const orb = document.createElement('div');
+        orb.className = 'rpg-weather-particle rpg-clear-light-orb';
+        orb.style.left = `${10 + Math.random() * 80}vw`;
+        orb.style.top = `${10 + Math.random() * 80}dvh`;
+        orb.style.animationDelay = `${i * 2}s`;
+        orb.style.animationDuration = `${20 + Math.random() * 10}s`;
+        // Vary the size
+        const size = 80 + Math.random() * 120;
+        orb.style.width = `${size}px`;
+        orb.style.height = `${size}px`;
+        container.appendChild(orb);
+    }
+
+    // Create lens flare effect in corner
+    const lensFlare = document.createElement('div');
+    lensFlare.className = 'rpg-weather-particle rpg-clear-lens-flare';
+    container.appendChild(lensFlare);
+
+    return container;
+}
+
+/**
+ * Create sunrise effect (dawn - warm orange/pink sky gradient with low sun)
+ */
+function createSunrise(hour) {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles rpg-sunrise-weather';
+
+    // Create sunrise gradient overlay
+    const sunriseOverlay = document.createElement('div');
+    sunriseOverlay.className = 'rpg-weather-particle rpg-sunrise-overlay';
+    container.appendChild(sunriseOverlay);
+
+    // Calculate sun position (rising from left horizon)
+    const sunPos = calculateSunPosition(hour);
+
+    // Create the rising sun
+    const sun = document.createElement('div');
+    sun.className = 'rpg-weather-particle rpg-clear-sun rpg-sunrise-sun';
+    sun.style.left = `${sunPos.left}vw`;
+    sun.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sun);
+
+    // Create sun glow (more orange during sunrise)
+    const sunGlow = document.createElement('div');
+    sunGlow.className = 'rpg-weather-particle rpg-clear-sun-glow rpg-sunrise-glow';
+    sunGlow.style.left = `${sunPos.left}vw`;
+    sunGlow.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sunGlow);
+
+    // Create horizon glow
+    const horizonGlow = document.createElement('div');
+    horizonGlow.className = 'rpg-weather-particle rpg-sunrise-horizon-glow';
+    container.appendChild(horizonGlow);
+
+    // Add some fading stars (still visible at dawn)
+    for (let i = 0; i < 15; i++) {
+        const star = document.createElement('div');
+        star.className = 'rpg-weather-particle rpg-night-star rpg-sunrise-fading-star';
+        star.style.left = `${Math.random() * 100}vw`;
+        star.style.top = `${Math.random() * 40}dvh`;
+        star.style.animationDelay = `${Math.random() * 3}s`;
+        const size = 1 + Math.random() * 1.5;
+        star.style.width = `${size}px`;
+        star.style.height = `${size}px`;
+        container.appendChild(star);
+    }
+
+    // Add some golden dust motes
+    for (let i = 0; i < 12; i++) {
+        const particle = document.createElement('div');
+        particle.className = 'rpg-weather-particle rpg-clear-dust-mote';
+        particle.style.left = `${Math.random() * 100}vw`;
+        particle.style.top = `${Math.random() * 100}dvh`;
+        particle.style.animationDelay = `${Math.random() * 15}s`;
+        particle.style.animationDuration = `${12 + Math.random() * 8}s`;
+        const size = 2 + Math.random() * 3;
+        particle.style.width = `${size}px`;
+        particle.style.height = `${size}px`;
+        container.appendChild(particle);
+    }
+
+    return container;
+}
+
+/**
+ * Create sunset effect (dusk - warm red/purple sky gradient with low sun)
+ */
+function createSunset(hour) {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles rpg-sunset-weather';
+
+    // Create sunset gradient overlay
+    const sunsetOverlay = document.createElement('div');
+    sunsetOverlay.className = 'rpg-weather-particle rpg-sunset-overlay';
+    container.appendChild(sunsetOverlay);
+
+    // Calculate sun position (setting on right horizon)
+    const sunPos = calculateSunPosition(hour);
+
+    // Create the setting sun
+    const sun = document.createElement('div');
+    sun.className = 'rpg-weather-particle rpg-clear-sun rpg-sunset-sun';
+    sun.style.left = `${sunPos.left}vw`;
+    sun.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sun);
+
+    // Create sun glow (more red during sunset)
+    const sunGlow = document.createElement('div');
+    sunGlow.className = 'rpg-weather-particle rpg-clear-sun-glow rpg-sunset-glow';
+    sunGlow.style.left = `${sunPos.left}vw`;
+    sunGlow.style.top = `${sunPos.top}dvh`;
+    container.appendChild(sunGlow);
+
+    // Create horizon glow
+    const horizonGlow = document.createElement('div');
+    horizonGlow.className = 'rpg-weather-particle rpg-sunset-horizon-glow';
+    container.appendChild(horizonGlow);
+
+    // Add some early stars (appearing at dusk)
+    for (let i = 0; i < 20; i++) {
+        const star = document.createElement('div');
+        star.className = 'rpg-weather-particle rpg-night-star rpg-sunset-emerging-star';
+        star.style.left = `${Math.random() * 100}vw`;
+        star.style.top = `${Math.random() * 50}dvh`;
+        star.style.animationDelay = `${Math.random() * 5}s`;
+        const size = 1 + Math.random() * 1.5;
+        star.style.width = `${size}px`;
+        star.style.height = `${size}px`;
+        container.appendChild(star);
+    }
+
+    // Add some golden/pink dust motes
+    for (let i = 0; i < 12; i++) {
+        const particle = document.createElement('div');
+        particle.className = 'rpg-weather-particle rpg-clear-dust-mote rpg-sunset-dust';
+        particle.style.left = `${Math.random() * 100}vw`;
+        particle.style.top = `${Math.random() * 100}dvh`;
+        particle.style.animationDelay = `${Math.random() * 15}s`;
+        particle.style.animationDuration = `${12 + Math.random() * 8}s`;
+        const size = 2 + Math.random() * 3;
+        particle.style.width = `${size}px`;
+        particle.style.height = `${size}px`;
+        container.appendChild(particle);
+    }
+
+    return container;
+}
+
+/**
+ * Create clear nighttime weather effect with moon, stars, and fireflies
+ */
+function createNighttime(hour) {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles rpg-night-weather';
+
+    // Create dark blue ambient overlay
+    const nightOverlay = document.createElement('div');
+    nightOverlay.className = 'rpg-weather-particle rpg-night-overlay';
+    container.appendChild(nightOverlay);
+
+    // Calculate moon position based on hour
+    const moonPos = calculateMoonPosition(hour);
+
+    // Create the moon
+    const moon = document.createElement('div');
+    moon.className = 'rpg-weather-particle rpg-night-moon';
+    moon.style.left = `${moonPos.left}vw`;
+    moon.style.top = `${moonPos.top}dvh`;
+    container.appendChild(moon);
+
+    // Create moon glow
+    const moonGlow = document.createElement('div');
+    moonGlow.className = 'rpg-weather-particle rpg-night-moon-glow';
+    moonGlow.style.left = `${moonPos.left - 3}vw`;
+    moonGlow.style.top = `${moonPos.top - 3}dvh`;
+    container.appendChild(moonGlow);
+
+    // Create twinkling stars
+    for (let i = 0; i < 60; i++) {
+        const star = document.createElement('div');
+        star.className = 'rpg-weather-particle rpg-night-star';
+        star.style.left = `${Math.random() * 100}vw`;
+        star.style.top = `${Math.random() * 60}dvh`; // Stars mostly in upper portion
+        star.style.animationDelay = `${Math.random() * 5}s`;
+        star.style.animationDuration = `${2 + Math.random() * 3}s`;
+        // Vary the size
+        const size = 1 + Math.random() * 2;
+        star.style.width = `${size}px`;
+        star.style.height = `${size}px`;
+        container.appendChild(star);
+    }
+
+    // Create a few brighter stars
+    for (let i = 0; i < 8; i++) {
+        const brightStar = document.createElement('div');
+        brightStar.className = 'rpg-weather-particle rpg-night-star rpg-night-star-bright';
+        brightStar.style.left = `${Math.random() * 100}vw`;
+        brightStar.style.top = `${Math.random() * 50}dvh`;
+        brightStar.style.animationDelay = `${Math.random() * 4}s`;
+        brightStar.style.animationDuration = `${3 + Math.random() * 2}s`;
+        container.appendChild(brightStar);
+    }
+
+    // Create fireflies / floating light particles
+    for (let i = 0; i < 15; i++) {
+        const firefly = document.createElement('div');
+        firefly.className = 'rpg-weather-particle rpg-night-firefly';
+        firefly.style.left = `${Math.random() * 100}vw`;
+        firefly.style.top = `${40 + Math.random() * 55}dvh`; // Fireflies in lower portion
+        firefly.style.animationDelay = `${Math.random() * 10}s`;
+        firefly.style.animationDuration = `${8 + Math.random() * 7}s`;
+        container.appendChild(firefly);
+    }
+
+    // Create subtle shooting star occasionally
+    const shootingStar = document.createElement('div');
+    shootingStar.className = 'rpg-weather-particle rpg-night-shooting-star';
+    container.appendChild(shootingStar);
+
+    return container;
+}
+
+/**
+ * Create lightning flash effect
+ */
+function createLightning() {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles';
+
+    // Create lightning flash overlay
+    const flash = document.createElement('div');
+    flash.className = 'rpg-weather-particle rpg-lightning';
+    container.appendChild(flash);
+
+    return container;
+}
+
+/**
+ * Create wind effect
+ */
+function createWind() {
+    const container = document.createElement('div');
+    container.className = 'rpg-weather-particles';
+
+    // Create 30 wind streaks
+    for (let i = 0; i < 30; i++) {
+        const streak = document.createElement('div');
+        streak.className = 'rpg-weather-particle rpg-wind-streak';
+        streak.style.top = `${Math.random() * 100}%`;
+        streak.style.animationDelay = `${Math.random() * 5}s`;
+        streak.style.animationDuration = `${1.5 + Math.random() * 1}s`;
+        container.appendChild(streak);
+    }
+
+    return container;
+}
+
+/**
+ * Calculate moon position based on hour (arc across sky at night)
+ * Returns { left: vw%, top: dvh% }
+ */
+function calculateMoonPosition(hour) {
+    // Nighttime is roughly 8 PM to 5 AM (20-5)
+    // Map hour to position along an arc
+    // 8 PM = far left, low | midnight = center-left, high | 5 AM = far right, low
+
+    if (hour === null) hour = 0; // Default to midnight if unknown
+
+    // Normalize night hours to 0-1 range
+    // 20 (8 PM) = 0, 0 (midnight) = ~0.44, 5 (5 AM) = 1
+    let progress;
+    if (hour >= 20) {
+        // 8 PM to midnight: 20-24 maps to 0-0.44
+        progress = (hour - 20) / 9;
+    } else {
+        // Midnight to 5 AM: 0-5 maps to 0.44-1
+        progress = (hour + 4) / 9;
+    }
+
+    // Horizontal position: 10% to 80% (left to right)
+    const left = 10 + progress * 70;
+
+    // Vertical position: parabolic arc (high at ~2 AM, low at dusk/dawn)
+    // Peak should be around progress 0.67 (~2 AM)
+    const peakProgress = 0.5;
+    const normalizedProgress = (progress - peakProgress) * 2; // -1 to 1
+    const top = 8 + 25 * (normalizedProgress * normalizedProgress);
+
+    return { left, top };
+}
+
+/**
+ * Update sun/moon position without recreating the whole effect
+ */
+function updateCelestialPosition(hour) {
+    if (!weatherContainer) return false;
+
+    // Update sun position if it exists
+    const sun = weatherContainer.querySelector('.rpg-clear-sun');
+    const sunGlow = weatherContainer.querySelector('.rpg-clear-sun-glow');
+
+    if (sun && sunGlow) {
+        const sunPos = calculateSunPosition(hour);
+        sun.style.left = `${sunPos.left}vw`;
+        sun.style.top = `${sunPos.top}dvh`;
+        sunGlow.style.left = `${sunPos.left}vw`;
+        sunGlow.style.top = `${sunPos.top}dvh`;
+        return true;
+    }
+
+    // Update moon position if it exists
+    const moon = weatherContainer.querySelector('.rpg-night-moon');
+    const moonGlow = weatherContainer.querySelector('.rpg-night-moon-glow');
+
+    if (moon && moonGlow) {
+        const moonPos = calculateMoonPosition(hour);
+        moon.style.left = `${moonPos.left}vw`;
+        moon.style.top = `${moonPos.top}dvh`;
+        moonGlow.style.left = `${moonPos.left - 3}vw`;
+        moonGlow.style.top = `${moonPos.top - 3}dvh`;
+        return true;
+    }
+
+    return false;
+}
+
+/**
+ * Remove current weather effect
+ */
+function removeWeatherEffect() {
+    if (weatherContainer) {
+        weatherContainer.remove();
+        weatherContainer = null;
+        currentWeatherType = null;
+        currentTimeOfDay = null;
+        currentHour = null;
+    }
+}
+
+/**
+ * Update weather effect based on current weather and time
+ */
+export function updateWeatherEffect() {
+    // Check if dynamic weather is enabled
+    if (!extensionSettings.enableDynamicWeather) {
+        removeWeatherEffect();
+        return;
+    }
+
+    const weather = getCurrentWeather();
+    const weatherType = parseWeatherType(weather);
+
+    // Get current time of day
+    const timeStr = getCurrentTime();
+    const hour = parseHourFromTime(timeStr);
+    const timeOfDay = getTimeOfDay(hour);
+
+    // If only the hour changed (same weather and time of day), just update celestial position
+    if (weatherType === currentWeatherType && timeOfDay === currentTimeOfDay && hour !== currentHour) {
+        if (updateCelestialPosition(hour)) {
+            currentHour = hour;
+            return; // Successfully updated position without recreating
+        }
+    }
+
+    // Don't recreate if nothing has changed
+    if (weatherType === currentWeatherType && timeOfDay === currentTimeOfDay && hour === currentHour) {
+        return;
+    }
+
+    // Remove existing effect
+    removeWeatherEffect();
+
+    // Create new effect based on weather type
+    if (weatherType === 'none') {
+        return; // No effect
+    }
+
+    currentWeatherType = weatherType;
+    currentTimeOfDay = timeOfDay;
+    currentHour = hour;
+
+    switch (weatherType) {
+        case 'snow':
+            weatherContainer = createSnowflakes();
+            break;
+        case 'rain':
+            weatherContainer = createRain();
+            break;
+        case 'mist':
+            weatherContainer = createMist();
+            break;
+        case 'sunny':
+            // Use appropriate effect based on time of day
+            if (timeOfDay === 'night') {
+                weatherContainer = createNighttime(hour);
+            } else if (timeOfDay === 'dawn') {
+                weatherContainer = createSunrise(hour);
+            } else if (timeOfDay === 'dusk') {
+                weatherContainer = createSunset(hour);
+            } else {
+                weatherContainer = createSunshine(hour);
+            }
+            break;
+        case 'wind':
+            weatherContainer = createWind();
+            break;
+        case 'storm': {
+            // Storm = Rain + Lightning (combined effects)
+            const rainContainer = createRain();
+            const lightningContainer = createLightning();
+            // Merge both containers
+            weatherContainer = document.createElement('div');
+            weatherContainer.className = 'rpg-weather-particles';
+            weatherContainer.appendChild(rainContainer);
+            weatherContainer.appendChild(lightningContainer);
+            break;
+        }
+        case 'blizzard': {
+            // Blizzard = Snow + Wind (combined effects)
+            const snowContainer = createSnowflakes();
+            const windContainer = createWind();
+            // Merge both containers
+            weatherContainer = document.createElement('div');
+            weatherContainer.className = 'rpg-weather-particles';
+            weatherContainer.appendChild(snowContainer);
+            weatherContainer.appendChild(windContainer);
+            break;
+        }
+    }
+
+    if (weatherContainer) {
+        // Apply z-index based on background/foreground settings
+        if (extensionSettings.weatherForeground) {
+            weatherContainer.style.zIndex = '9998'; // In front of chat
+            weatherContainer.classList.add('rpg-weather-foreground');
+        } else if (extensionSettings.weatherBackground) {
+            weatherContainer.style.zIndex = '1'; // Behind chat (default)
+            weatherContainer.classList.remove('rpg-weather-foreground');
+        } else {
+            // Both disabled - don't show weather
+            return;
+        }
+
+        document.body.appendChild(weatherContainer);
+    }
+}
+
+/**
+ * Initialize weather effects
+ */
+export function initWeatherEffects() {
+    updateWeatherEffect();
+}
+
+/**
+ * Toggle dynamic weather effects
+ */
+export function toggleDynamicWeather(enabled) {
+    if (enabled) {
+        updateWeatherEffect();
+    } else {
+        removeWeatherEffect();
+    }
+}
+
+/**
+ * Clean up weather effects
+ */
+export function cleanupWeatherEffects() {
+    removeWeatherEffect();
+}

src/types/inventory.js

@@ -8,6 +8,7 @@
  * @typedef {Object} InventoryV2
  * @property {number} version - Schema version (always 2)
  * @property {string} onPerson - Items currently carried/worn by the character (plaintext list)
+ * @property {string} clothing - Clothing and armor currently worn (plaintext list)
  * @property {Object.<string, string>} stored - Items stored at named locations (location name → plaintext list)
  * @property {string} assets - Character's vehicles, property, and major possessions (plaintext list)
  */

src/utils/itemParser.js

@@ -17,6 +17,7 @@ import { sanitizeItemName, MAX_ITEMS_PER_SECTION } from './security.js';
  * - Strips list markers: -, •, 1., 2., etc.
  * - Collapses newlines inside parentheses to spaces
  * - Only splits on commas OUTSIDE parentheses (preserves commas in descriptions)
+ * - Preserves commas in numbers (decimal separators like 4443,445)
  * - Gracefully handles unmatched parentheses
  *
  * @param {string} itemString - Item string from AI (various formats supported)
@@ -35,6 +36,10 @@ import { sanitizeItemName, MAX_ITEMS_PER_SECTION } from './security.js';
  * parseItems("Potato (Cursed, Sexy, Your Mum & Dick, Etc), Sword")
  * // → ["Potato (Cursed, Sexy, Your Mum & Dick, Etc)", "Sword"]
  *
+ * // Decimal commas in numbers (preserved)
+ * parseItems("4443,445 gold coins, Sword, 1,234,567 credits")
+ * // → ["4443,445 gold coins", "Sword", "1,234,567 credits"]
+ *
  * // Markdown formatting (stripped)
  * parseItems("**Sword** (equipped), *Shield*") // ["Sword (equipped)", "Shield"]
  *
@@ -125,7 +130,7 @@ export function parseItems(itemString) {
     // STEP 5: Normalize whitespace
     processed = processed.replace(/\s+/g, ' ');
 
-    // STEP 6: Smart comma splitting (only split on commas OUTSIDE parentheses)
+    // STEP 6: Smart comma splitting (only split on commas OUTSIDE parentheses and NOT in numbers)
     // Also handles list markers, quotes, and security validation per-item
     const items = [];
     let currentItem = '';
@@ -146,22 +151,32 @@ export function parseItems(itemString) {
             }
             currentItem += char;
         } else if (char === ',' && parenDepth === 0) {
-            // Comma outside parentheses - this is a separator
-            const cleaned = cleanSingleItem(currentItem);
-            if (cleaned) {
-                // Security check: validate and sanitize item name
-                const sanitized = sanitizeItemName(cleaned);
-                if (sanitized) {
-                    items.push(sanitized);
-                }
+            // Check if this comma is between digits (decimal separator like 4443,445)
+            const prevChar = i > 0 ? processed[i - 1] : '';
+            const nextChar = i < processed.length - 1 ? processed[i + 1] : '';
+            const isDecimalComma = /\d/.test(prevChar) && /\d/.test(nextChar);
 
-                // DoS protection: enforce max items limit
-                if (items.length >= MAX_ITEMS_PER_SECTION) {
-                    console.warn(`[RPG Companion] Reached max items limit (${MAX_ITEMS_PER_SECTION}), truncating list`);
-                    return items;
+            if (isDecimalComma) {
+                // This is a decimal comma, not a separator - keep it
+                currentItem += char;
+            } else {
+                // Comma outside parentheses and not in a number - this is a separator
+                const cleaned = cleanSingleItem(currentItem);
+                if (cleaned) {
+                    // Security check: validate and sanitize item name
+                    const sanitized = sanitizeItemName(cleaned);
+                    if (sanitized) {
+                        items.push(sanitized);
+                    }
+
+                    // DoS protection: enforce max items limit
+                    if (items.length >= MAX_ITEMS_PER_SECTION) {
+                        console.warn(`[RPG Companion] Reached max items limit (${MAX_ITEMS_PER_SECTION}), truncating list`);
+                        return items;
+                    }
                 }
+                currentItem = ''; // Start new item
             }
-            currentItem = ''; // Start new item
         } else {
             currentItem += char;
         }

src/utils/jsonMigration.js

@@ -0,0 +1,433 @@
+/**
+ * JSON Migration Module
+ * Migrates committed tracker data from v2 text format to v3 JSON format
+ */
+
+import { committedTrackerData, extensionSettings, updateCommittedTrackerData, updateExtensionSettings } from '../core/state.js';
+import { saveSettings, saveChatData } from '../core/persistence.js';
+
+/**
+ * Helper to separate emoji from text in a string
+ * @param {string} str - String potentially containing emoji followed by text
+ * @returns {{emoji: string, text: string}} Separated emoji and text
+ */
+function separateEmojiFromText(str) {
+    if (!str) return { emoji: '', text: '' };
+
+    str = str.trim();
+
+    // Regex to match emoji at the start
+    const emojiRegex = /^[\u{1F300}-\u{1F9FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}\u{1F000}-\u{1F02F}\u{1F0A0}-\u{1F0FF}\u{1F100}-\u{1F64F}\u{1F680}-\u{1F6FF}\u{1F910}-\u{1F96B}\u{1F980}-\u{1F9E0}\u{FE00}-\u{FE0F}\u{200D}\u{20E3}]+/u;
+    const emojiMatch = str.match(emojiRegex);
+
+    if (emojiMatch) {
+        const emoji = emojiMatch[0];
+        let text = str.substring(emoji.length).trim();
+        // Remove leading comma or space
+        text = text.replace(/^[,\s]+/, '');
+        return { emoji, text };
+    }
+
+    // Check if there's a comma separator anyway
+    const commaParts = str.split(',');
+    if (commaParts.length >= 2) {
+        return {
+            emoji: commaParts[0].trim(),
+            text: commaParts.slice(1).join(',').trim()
+        };
+    }
+
+    // No clear separation - return original as text
+    return { emoji: '', text: str };
+}
+
+/**
+ * Parses item text to JSON format
+ * Handles "3x Item Name" or "Item Name" formats
+ * @param {string} itemsText - Comma-separated items string
+ * @returns {Array<{name: string, quantity?: number}>} Array of item objects
+ */
+function parseItemsToJSON(itemsText) {
+    if (!itemsText || itemsText.trim() === '' || itemsText.toLowerCase() === 'none') {
+        return [];
+    }
+
+    const items = itemsText.split(',').map(s => s.trim()).filter(s => s);
+    return items.map(item => {
+        // Parse "3x Health Potion" format
+        const qtyMatch = item.match(/^(\d+)x\s*(.+)/i);
+        if (qtyMatch) {
+            return {
+                name: qtyMatch[2].trim(),
+                quantity: parseInt(qtyMatch[1])
+            };
+        }
+        return { name: item, quantity: 1 };
+    });
+}
+
+/**
+ * Migrates User Stats from v2 text format to v3 JSON format
+ * @param {string} textData - V2 text format user stats
+ * @returns {object} V3 JSON format user stats
+ */
+export function migrateUserStatsToJSON(textData) {
+    if (!textData || typeof textData !== 'string') {
+        return null;
+    }
+
+    const lines = textData.split('\n');
+    const result = {
+        version: 3,
+        stats: [],
+        status: {},
+        skills: [],
+        inventory: {
+            onPerson: [],
+            clothing: [],
+            stored: {},
+            assets: []
+        },
+        quests: {
+            main: null,
+            optional: []
+        }
+    };
+
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed === '---' || trimmed.startsWith('```')) continue;
+
+        // Parse "- StatName: X%" format
+        const statMatch = trimmed.match(/^-\s*([^:]+):\s*(\d+)%/);
+        if (statMatch) {
+            const name = statMatch[1].trim();
+            const id = name.toLowerCase().replace(/\s+/g, '_').replace(/[^a-z0-9_]/g, '');
+            result.stats.push({
+                id: id,
+                name: name,
+                value: parseInt(statMatch[2])
+            });
+            continue;
+        }
+
+        // Parse "Status: emoji, text" or "Status: text" format
+        const statusMatch = trimmed.match(/^Status:\s*(.+)/i);
+        if (statusMatch) {
+            const { emoji, text } = separateEmojiFromText(statusMatch[1]);
+            if (emoji) result.status.mood = emoji;
+            if (text) result.status.conditions = text;
+            continue;
+        }
+
+        // Parse "Skills: skill1, skill2" format
+        const skillsMatch = trimmed.match(/^Skills:\s*(.+)/i);
+        if (skillsMatch) {
+            const skillsText = skillsMatch[1].trim();
+            if (skillsText && skillsText.toLowerCase() !== 'none') {
+                const skills = skillsText.split(',').map(s => s.trim()).filter(s => s);
+                result.skills = skills.map(name => ({ name }));
+            }
+            continue;
+        }
+
+        // Parse inventory lines
+        const onPersonMatch = trimmed.match(/^On Person:\s*(.+)/i);
+        if (onPersonMatch) {
+            result.inventory.onPerson = parseItemsToJSON(onPersonMatch[1]);
+            continue;
+        }
+
+        const clothingMatch = trimmed.match(/^Clothing:\s*(.+)/i);
+        if (clothingMatch) {
+            result.inventory.clothing = parseItemsToJSON(clothingMatch[1]);
+            continue;
+        }
+
+        const storedMatch = trimmed.match(/^Stored\s*-\s*([^:]+):\s*(.+)/i);
+        if (storedMatch) {
+            const location = storedMatch[1].trim();
+            result.inventory.stored[location] = parseItemsToJSON(storedMatch[2]);
+            continue;
+        }
+
+        const assetsMatch = trimmed.match(/^Assets:\s*(.+)/i);
+        if (assetsMatch) {
+            const assetsText = assetsMatch[1].trim();
+            if (assetsText && assetsText.toLowerCase() !== 'none') {
+                result.inventory.assets = assetsText.split(',').map(s => s.trim()).filter(s => s).map(name => ({ name }));
+            }
+            continue;
+        }
+
+        // Parse quest lines
+        const mainQuestMatch = trimmed.match(/^Main Quests?:\s*(.+)/i);
+        if (mainQuestMatch) {
+            const questText = mainQuestMatch[1].trim();
+            if (questText && questText.toLowerCase() !== 'none') {
+                result.quests.main = { title: questText };
+            }
+            continue;
+        }
+
+        const optionalQuestsMatch = trimmed.match(/^Optional Quests?:\s*(.+)/i);
+        if (optionalQuestsMatch) {
+            const questsText = optionalQuestsMatch[1].trim();
+            if (questsText && questsText.toLowerCase() !== 'none') {
+                const quests = questsText.split(',').map(s => s.trim()).filter(s => s);
+                result.quests.optional = quests.map(title => ({ title }));
+            }
+            continue;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Migrates Info Box from v2 text format to v3 JSON format
+ * @param {string} textData - V2 text format info box
+ * @returns {object} V3 JSON format info box
+ */
+export function migrateInfoBoxToJSON(textData) {
+    if (!textData || typeof textData !== 'string') {
+        return null;
+    }
+
+    const lines = textData.split('\n');
+    const result = {
+        version: 3
+    };
+
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed === '---' || trimmed.startsWith('```') || trimmed.toLowerCase() === 'info box') continue;
+
+        // Parse "Date: value" format
+        const dateMatch = trimmed.match(/^Date:\s*(.+)/i);
+        if (dateMatch) {
+            result.date = { value: dateMatch[1].trim() };
+            continue;
+        }
+
+        // Parse "Weather: emoji, text" or "Weather: text" format
+        const weatherMatch = trimmed.match(/^Weather:\s*(.+)/i);
+        if (weatherMatch) {
+            const { emoji, text } = separateEmojiFromText(weatherMatch[1]);
+            result.weather = {
+                emoji: emoji || '',
+                forecast: text || weatherMatch[1].trim()
+            };
+            continue;
+        }
+
+        // Parse "Temperature: X°C" or "Temperature: X°F" format
+        const tempMatch = trimmed.match(/^Temperature:\s*(\d+)\s*°?([CF])?/i);
+        if (tempMatch) {
+            result.temperature = {
+                value: parseInt(tempMatch[1]),
+                unit: tempMatch[2] ? tempMatch[2].toUpperCase() : 'C'
+            };
+            continue;
+        }
+
+        // Parse "Time: start → end" format
+        const timeMatch = trimmed.match(/^Time:\s*(.+?)\s*→\s*(.+)/i);
+        if (timeMatch) {
+            result.time = {
+                start: timeMatch[1].trim(),
+                end: timeMatch[2].trim()
+            };
+            continue;
+        }
+
+        // Parse "Location: value" format
+        const locationMatch = trimmed.match(/^Location:\s*(.+)/i);
+        if (locationMatch) {
+            result.location = { value: locationMatch[1].trim() };
+            continue;
+        }
+
+        // Parse "Recent Events: event1, event2, event3" format
+        const eventsMatch = trimmed.match(/^Recent Events:\s*(.+)/i);
+        if (eventsMatch) {
+            const eventsText = eventsMatch[1].trim();
+            if (eventsText && eventsText.toLowerCase() !== 'none') {
+                result.recentEvents = eventsText.split(',').map(s => s.trim()).filter(s => s);
+            }
+            continue;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Migrates Present Characters from v2 text format to v3 JSON format
+ * @param {string} textData - V2 text format present characters
+ * @returns {object} V3 JSON format present characters
+ */
+export function migrateCharactersToJSON(textData) {
+    if (!textData || typeof textData !== 'string') {
+        return null;
+    }
+
+    const result = {
+        version: 3,
+        characters: []
+    };
+
+    // Split by character blocks (marked by "- Name")
+    const blocks = ('\n' + textData).split(/\n-\s+/);
+
+    for (const block of blocks) {
+        if (!block.trim()) continue;
+
+        const lines = block.trim().split('\n');
+        if (lines.length === 0) continue;
+
+        const character = {
+            name: lines[0].trim()
+        };
+
+        // Parse subsequent lines for this character
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line) continue;
+
+            // Parse "Details: emoji | field1 | field2" format
+            const detailsMatch = line.match(/^Details:\s*(.+)/i);
+            if (detailsMatch) {
+                const detailsText = detailsMatch[1].trim();
+                const parts = detailsText.split('|').map(s => s.trim());
+
+                const { emoji } = separateEmojiFromText(parts[0] || '');
+                if (emoji) character.emoji = emoji;
+
+                character.details = {};
+                for (let j = 1; j < parts.length; j++) {
+                    const fieldName = `field${j}`;
+                    character.details[fieldName] = parts[j];
+                }
+                continue;
+            }
+
+            // Parse "Relationship: status" format
+            const relationshipMatch = line.match(/^Relationship:\s*(.+)/i);
+            if (relationshipMatch) {
+                character.relationship = { status: relationshipMatch[1].trim() };
+                continue;
+            }
+
+            // Parse "Stats: stat1: X% | stat2: Y%" format
+            const statsMatch = line.match(/^Stats:\s*(.+)/i);
+            if (statsMatch) {
+                const statsText = statsMatch[1].trim();
+                const statParts = statsText.split('|').map(s => s.trim());
+                character.stats = [];
+
+                for (const statPart of statParts) {
+                    const statValueMatch = statPart.match(/^([^:]+):\s*(\d+)%/);
+                    if (statValueMatch) {
+                        character.stats.push({
+                            name: statValueMatch[1].trim(),
+                            value: parseInt(statValueMatch[2])
+                        });
+                    }
+                }
+                continue;
+            }
+
+            // Parse "Thoughts: content" format
+            const thoughtsMatch = line.match(/^Thoughts:\s*(.+)/i);
+            if (thoughtsMatch) {
+                character.thoughts = { content: thoughtsMatch[1].trim() };
+                continue;
+            }
+        }
+
+        result.characters.push(character);
+    }
+
+    return result;
+}
+
+/**
+ * Main migration function - migrates all committed tracker data to v3 JSON format
+ * @returns {Promise<void>}
+ */
+export async function migrateToV3JSON() {
+    // console.log('[RPG Migration] Starting migration to v3 JSON format...');
+
+    const migrated = {
+        userStats: null,
+        infoBox: null,
+        characterThoughts: null
+    };
+
+    // Migrate User Stats
+    if (committedTrackerData.userStats && typeof committedTrackerData.userStats === 'string') {
+        // console.log('[RPG Migration] Migrating User Stats...');
+        migrated.userStats = migrateUserStatsToJSON(committedTrackerData.userStats);
+        if (migrated.userStats) {
+            // console.log('[RPG Migration] ✓ User Stats migrated');
+        }
+    }
+
+    // Migrate Info Box
+    if (committedTrackerData.infoBox && typeof committedTrackerData.infoBox === 'string') {
+        // console.log('[RPG Migration] Migrating Info Box...');
+        migrated.infoBox = migrateInfoBoxToJSON(committedTrackerData.infoBox);
+        if (migrated.infoBox) {
+            // console.log('[RPG Migration] ✓ Info Box migrated');
+        }
+    }
+
+    // Migrate Present Characters
+    if (committedTrackerData.characterThoughts && typeof committedTrackerData.characterThoughts === 'string') {
+        // console.log('[RPG Migration] Migrating Present Characters...');
+        migrated.characterThoughts = migrateCharactersToJSON(committedTrackerData.characterThoughts);
+        if (migrated.characterThoughts) {
+            // console.log('[RPG Migration] ✓ Present Characters migrated');
+        }
+    }
+
+    // Update committed data
+    updateCommittedTrackerData(migrated);
+
+    // Initialize lockedItems if not present
+    if (!extensionSettings.lockedItems) {
+        // console.log('[RPG Migration] Initializing lockedItems structure...');
+        updateExtensionSettings({
+            lockedItems: {
+                stats: [],
+                skills: [],
+                inventory: {
+                    onPerson: [],
+                    clothing: [],
+                    stored: {},
+                    assets: []
+                },
+                quests: {
+                    main: false,
+                    optional: []
+                },
+                infoBox: {
+                    date: false,
+                    weather: false,
+                    temperature: false,
+                    time: false,
+                    location: false,
+                    recentEvents: false
+                },
+                characters: {}
+            }
+        });
+    }
+
+    // Save migrated data
+    await saveChatData();
+    await saveSettings();
+
+    // console.log('[RPG Migration] ✅ Migration to v3 JSON format complete');
+}

src/utils/jsonRepair.js

@@ -0,0 +1,225 @@
+/**
+ * JSON Repair Utilities
+ * Handles parsing and repairing malformed JSON from AI responses
+ */
+
+/**
+ * Repairs malformed JSON from AI responses
+ * Handles common AI mistakes like trailing commas, missing commas, wrong quotes, etc.
+ *
+ * @param {string} jsonString - Potentially malformed JSON string
+ * @returns {object|null} Repaired JSON object or null if repair fails
+ */
+export function repairJSON(jsonString) {
+    if (typeof jsonString !== 'string') {
+        console.warn('[RPG JSON Repair] Invalid input type:', typeof jsonString);
+        return null;
+    }
+
+    let cleaned = jsonString.trim();
+
+    if (!cleaned) {
+        return null;
+    }
+
+    // Remove markdown code fences
+    cleaned = cleaned.replace(/```json\s*/gi, '');
+    cleaned = cleaned.replace(/```\s*/g, '');
+
+    // Remove thinking tags (model's internal reasoning)
+    cleaned = cleaned.replace(/<think>[\s\S]*?<\/think>/gi, '');
+    cleaned = cleaned.replace(/<thinking>[\s\S]*?<\/thinking>/gi, '');
+
+    // Fix common JSON errors:
+
+    // 1. Trailing commas before closing brackets
+    cleaned = cleaned.replace(/,(\s*[}\]])/g, '$1');
+
+    // 2. Missing commas between properties - DISABLED because it corrupts valid JSON
+    // Modern AI models send properly formatted JSON, so this aggressive repair is not needed
+    // cleaned = cleaned.replace(/("\s*:\s*(?:"[^"]*"|[^,}\]]+))(\s+")/g, '$1,$2');
+
+    // 3. Single quotes to double quotes - DISABLED because it corrupts apostrophes in text
+    // Apostrophes in strings like "Zandik's Office" would become "Zandik"s Office" (invalid JSON)
+    // Modern AI models already use double quotes for JSON strings
+    // cleaned = cleaned.replace(/'/g, '"');
+
+    // 4. Unquoted keys - DISABLED because it corrupts valid JSON string values
+    // The AI models already send properly quoted JSON, so this is not needed
+    // cleaned = cleaned.replace(/(\{|,)\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:/g, '$1"$2":');
+
+    // 5. Remove JavaScript comments
+    cleaned = cleaned.replace(/\/\/.*$/gm, '');
+    cleaned = cleaned.replace(/\/\*[\s\S]*?\*\//g, '');
+
+    // Attempt 1: Standard JSON.parse
+    try {
+        return JSON.parse(cleaned);
+    } catch (e) {
+    }
+
+    // Attempt 2: Extract JSON object between first { and last }
+    const objectMatch = cleaned.match(/\{[\s\S]*\}/);
+    if (objectMatch) {
+        try {
+            return JSON.parse(objectMatch[0]);
+        } catch (e) {
+            // Silent fail, try next method
+        }
+    }
+
+    // Attempt 3: Try to extract JSON array between first [ and last ]
+    const arrayMatch = cleaned.match(/\[[\s\S]*\]/);
+    if (arrayMatch) {
+        try {
+            return JSON.parse(arrayMatch[0]);
+        } catch (e) {
+            // Silent fail, try next method
+        }
+    }
+
+    // Attempt 4: Use Function constructor (safer than eval, still controlled)
+    // Only as last resort for trusted AI output
+    try {
+        const fn = new Function(`"use strict"; return (${cleaned});`);
+        const result = fn();
+        // Validate it's actually an object or array
+        if (result && (typeof result === 'object')) {
+            // console.log('[RPG JSON Repair] ✓ Repaired using Function constructor');
+            return result;
+        }
+    } catch (e) {
+        console.error('[RPG JSON Repair] ✗ All repair attempts failed:', e.message);
+    }
+
+    return null;
+}
+
+/**
+ * Validates JSON structure matches expected schema for a tracker type
+ *
+ * @param {object} data - Parsed JSON data to validate
+ * @param {string} type - Type of tracker ('userStats', 'infoBox', 'characters')
+ * @returns {boolean} True if valid, false otherwise
+ */
+export function validateJSONSchema(data, type) {
+    if (!data || typeof data !== 'object') {
+        return false;
+    }
+
+    try {
+        switch (type) {
+            case 'userStats':
+                return Array.isArray(data.stats) &&
+                       data.stats.every(s =>
+                           s &&
+                           typeof s === 'object' &&
+                           s.id &&
+                           s.name &&
+                           typeof s.value === 'number'
+                       );
+
+            case 'infoBox':
+                return (data.date || data.weather || data.time || data.location || data.temperature || data.recentEvents);
+
+            case 'characters':
+                return Array.isArray(data.characters) &&
+                       data.characters.every(c => c && c.name);
+
+            default:
+                console.warn('[RPG JSON Validation] Unknown tracker type:', type);
+                return false;
+        }
+    } catch (e) {
+        console.error('[RPG JSON Validation] Error during validation:', e);
+        return false;
+    }
+}
+
+/**
+ * Extracts JSON from text that may contain other content
+ * Looks for JSON blocks within ```json fences or standalone JSON objects
+ *
+ * @param {string} text - Text potentially containing JSON
+ * @returns {string|null} Extracted JSON string or null
+ */
+export function extractJSONFromText(text) {
+    if (!text || typeof text !== 'string') {
+        return null;
+    }
+
+    // Try to extract from ```json code fence
+    const fenceMatch = text.match(/```json\s*([\s\S]*?)```/i);
+    if (fenceMatch && fenceMatch[1]) {
+        const trimmed = fenceMatch[1].trim();
+        if (trimmed) return trimmed;
+    }
+
+    // Try to extract from ``` code fence (without json label)
+    const genericFenceMatch = text.match(/```\s*([\s\S]*?)```/);
+    if (genericFenceMatch && genericFenceMatch[1]) {
+        const content = genericFenceMatch[1].trim();
+        // Check if it looks like JSON (starts with { or [)
+        if (content && (content.startsWith('{') || content.startsWith('['))) {
+            return content;
+        }
+    }
+
+    // Try to find standalone JSON object
+    const objectMatch = text.match(/\{[\s\S]*\}/);
+    if (objectMatch && objectMatch[0].trim()) {
+        return objectMatch[0];
+    }
+
+    // Try to find standalone JSON array
+    const arrayMatch = text.match(/\[[\s\S]*\]/);
+    if (arrayMatch && arrayMatch[0].trim()) {
+        return arrayMatch[0];
+    }
+
+    return null;
+}
+
+/**
+ * Safely parses JSON with automatic repair attempts
+ * Combines extraction, repair, and validation in one call
+ *
+ * @param {string} text - Text containing JSON (with or without code fences)
+ * @param {string} expectedType - Expected tracker type for validation ('userStats', 'infoBox', 'characters')
+ * @returns {{data: object|null, success: boolean, error: string|null}} Result object
+ */
+export function safeParseJSON(text, expectedType = null) {
+    const result = {
+        data: null,
+        success: false,
+        error: null
+    };
+
+    // Extract JSON from text
+    const jsonString = extractJSONFromText(text);
+    if (!jsonString) {
+        result.error = 'No JSON found in text';
+        return result;
+    }
+
+    // Attempt to repair and parse
+    const parsed = repairJSON(jsonString);
+    if (!parsed) {
+        result.error = 'Failed to parse JSON after repair attempts';
+        return result;
+    }
+
+    // Validate schema if type specified
+    if (expectedType) {
+        const valid = validateJSONSchema(parsed, expectedType);
+        if (!valid) {
+            result.error = `JSON does not match expected schema for type: ${expectedType}`;
+            result.data = parsed; // Return data anyway, might be partially useful
+            return result;
+        }
+    }
+
+    result.data = parsed;
+    result.success = true;
+    return result;
+}

src/utils/migration.js

@@ -15,6 +15,7 @@
 const DEFAULT_INVENTORY_V2 = {
     version: 2,
     onPerson: "None",
+    clothing: "None",
     stored: {},
     assets: "None"
 };
@@ -27,8 +28,36 @@ const DEFAULT_INVENTORY_V2 = {
  * @returns {MigrationResult} Migration result with v2 inventory and metadata
  */
 export function migrateInventory(inventory) {
-    // Case 1: Already v2 format (has version property and is an object)
+    // Case 1: v2 format missing version property (parser output)
+    // Parser returns v2 structure but without the version tag
+    if (inventory && typeof inventory === 'object' &&
+        'onPerson' in inventory && 'clothing' in inventory &&
+        'stored' in inventory && 'assets' in inventory &&
+        !('version' in inventory)) {
+        // console.log('[RPG Companion Migration] v2 inventory missing version tag, adding it');
+        return {
+            inventory: {
+                version: 2,
+                ...inventory
+            },
+            migrated: true,
+            source: 'parser-output'
+        };
+    }
+
+    // Case 2: Already v2 format (has version property and is an object)
     if (inventory && typeof inventory === 'object' && inventory.version === 2) {
+        // Check if clothing field exists (v2.1 upgrade)
+        if (!inventory.hasOwnProperty('clothing')) {
+            // console.log('[RPG Companion Migration] Upgrading v2 inventory to v2.1 (adding clothing field)');
+            inventory.clothing = "None";
+            return {
+                inventory: inventory,
+                migrated: true,
+                source: 'v2-upgrade'
+            };
+        }
+
         // console.log('[RPG Companion Migration] Inventory already v2, no migration needed');
         return {
             inventory: inventory,
@@ -37,7 +66,7 @@ export function migrateInventory(inventory) {
         };
     }
 
-    // Case 2: null or undefined → use defaults
+    // Case 3: null or undefined → use defaults
     if (inventory === null || inventory === undefined) {
         // console.log('[RPG Companion Migration] Inventory is null/undefined, using defaults');
         return {
@@ -47,7 +76,7 @@ export function migrateInventory(inventory) {
         };
     }
 
-    // Case 3: v1 string format → migrate to v2
+    // Case 4: v1 string format → migrate to v2
     if (typeof inventory === 'string') {
         // Check if it's an empty/default string
         const trimmed = inventory.trim();
@@ -66,6 +95,7 @@ export function migrateInventory(inventory) {
             inventory: {
                 version: 2,
                 onPerson: inventory,
+                clothing: "None",
                 stored: {},
                 assets: "None"
             },

src/utils/responseExtractor.js

@@ -0,0 +1,122 @@
+/**
+ * Response Extractor Utility
+ *
+ * Handles extraction of text content from various API response formats.
+ * Fixes the "No message generated" error caused by Claude models with
+ * extended thinking, where the API response `content` field is an array
+ * of content blocks instead of a single string.
+ *
+ * Also provides a safe wrapper around SillyTavern's `generateRaw` that
+ * intercepts the raw fetch response as a fallback.
+ */
+
+import { generateRaw } from '../../../../../../../script.js';
+
+/**
+ * Extracts text from any API response shape (Anthropic content-block arrays,
+ * OpenAI choices, plain strings, etc.).
+ *
+ * @param {*} response - The raw API response (string, array, or object)
+ * @returns {string} The extracted text content
+ */
+export function extractTextFromResponse(response) {
+    if (!response) return '';
+    if (typeof response === 'string') return response;
+
+    // Response itself is an array of content blocks (Anthropic extended thinking)
+    if (Array.isArray(response)) {
+        const texts = response
+            .filter(b => b && b.type === 'text' && typeof b.text === 'string')
+            .map(b => b.text);
+        if (texts.length > 0) return texts.join('\n');
+
+        const strings = response.filter(item => typeof item === 'string');
+        if (strings.length > 0) return strings.join('\n');
+
+        return JSON.stringify(response);
+    }
+
+    // response.content (string or Anthropic content array)
+    if (response.content !== undefined && response.content !== null) {
+        if (typeof response.content === 'string') return response.content;
+        if (Array.isArray(response.content)) {
+            const texts = response.content
+                .filter(b => b && b.type === 'text' && typeof b.text === 'string')
+                .map(b => b.text);
+            if (texts.length > 0) return texts.join('\n');
+        }
+    }
+
+    // OpenAI choices format
+    if (response.choices?.[0]?.message?.content) {
+        const c = response.choices[0].message.content;
+        if (typeof c === 'string') return c;
+        if (Array.isArray(c)) {
+            const texts = c
+                .filter(b => b && b.type === 'text' && typeof b.text === 'string')
+                .map(b => b.text);
+            if (texts.length > 0) return texts.join('\n');
+        }
+    }
+
+    // Other common fields
+    if (typeof response.text === 'string') return response.text;
+    if (typeof response.message === 'string') return response.message;
+    if (response.message?.content && typeof response.message.content === 'string') {
+        return response.message.content;
+    }
+
+    return JSON.stringify(response);
+}
+
+/**
+ * Safe wrapper around SillyTavern's `generateRaw`.
+ *
+ * Temporarily intercepts `window.fetch` to capture the raw API response.
+ * If `generateRaw` throws "No message generated" (e.g. because the first
+ * content block from Claude extended thinking is empty), we extract the
+ * real text from the captured raw data ourselves.
+ *
+ * @param {object} options - Options passed directly to `generateRaw`
+ * @param {Array<{role: string, content: string}>} options.prompt - Message array
+ * @param {boolean} [options.quietToLoud] - Whether to use quiet-to-loud mode
+ * @returns {Promise<string>} The generated text
+ */
+export async function safeGenerateRaw(options) {
+    let capturedRawData = null;
+    const originalFetch = window.fetch;
+
+    window.fetch = async function (...args) {
+        const response = await originalFetch.apply(this, args);
+        try {
+            const url = typeof args[0] === 'string' ? args[0] : args[0]?.url || '';
+            if (url.includes('/api/backends/chat-completions/generate') ||
+                (url.includes('/api/backends/') && url.includes('/generate'))) {
+                const clone = response.clone();
+                capturedRawData = await clone.json();
+            }
+        } catch (e) {
+            /* ignore clone/parse errors */
+        }
+        return response;
+    };
+
+    try {
+        const result = await generateRaw(options);
+        return result;
+    } catch (genErr) {
+        if (genErr.message?.includes('No message generated') && capturedRawData) {
+            console.warn(
+                '[RPG Companion] generateRaw failed (likely extended thinking). Extracting from raw API data.',
+            );
+            const extracted = extractTextFromResponse(capturedRawData);
+            if (!extracted || !extracted.trim()) {
+                throw new Error('Could not extract text from API response');
+            }
+            return extracted;
+        }
+        throw genErr; // Re-throw non-related errors
+    } finally {
+        window.fetch = originalFetch; // ALWAYS restore original fetch
+    }
+}