Merge branch 'feature/v1.5.5'

Adds three embedded WAV files as additional notification sound choices
(ids 17-19) alongside the existing 16 game sounds. Playback via NAudio
WaveOutEvent/WinMM, which works correctly on Wine/Linux.

.github/forge-posts/v1.5.2.md

@@ -0,0 +1,10 @@
+---
+subtitle: "First-Run Wizard — neu in 4 Steps, Roleplay-Profil neu"
+versionsnatur: "UX-Patch"
+---
+- **Vier Steps statt Single-Page.** Der First-Run-Wizard öffnet jetzt in vier Bühnen: Willkommen → Privacy-Profil → Power-Settings → Fertig. Pagination-Dots in Forge-Bronze oben rechts, Back/Skip/Next im Footer. Standardgröße 720×480 (Min 600×400) und der Fuchs-Banner sitzt als zugeklappter TreeNode oben in Step 1, damit die Einleitung im Fokus bleibt.
+- **Neues Privacy-Profil „Roleplay".** Datensparsamkeit plus Sagen und beide Emote-Typen für Story-Logs. Schreien und Rufen bleiben außen vor, Public-Distance-Lärm von Fremden ist kein Story-Inhalt. Aufbewahrung: Sagen 30 Tage, Emotes 90 Tage. Privacy-Picker wird zum 2×2-Grid, Casual bleibt mit ★-Marker als Empfehlung.
+- **Power-Settings sichtbar.** Bislang versteckte Defaults bekommen eine eigene Bühne: Vorherige Session laden, Filter inkl. alter Messages, N Tell-Messages vorladen, Compact-Density, Prettier-Timestamps und Theme-Picker für die 10 Built-in-Themes. Keine neuen Settings, nur das Bestehende sauber sichtbar.
+- **Staged-Commit und Test-Hint auf der Fertig-Bühne.** Auswahl wird erst beim Klick auf „Fertig ✓" geschrieben. „Später entscheiden" oder X-Close lässt die bestehende Config unangetastet, ein nicht angefasster Step behält die alten Werte. Direkt darunter sichtbar: „Tipp /tell <Spielername>", plus die aktuelle Preload-Zahl aus Step 3 als Hinweis auf den Auto-Tell-Tab-Spawn.
+- **Bestehende User sehen den neuen Wizard einmal.** Wer schon v1.5.1 hatte, bekommt den Multi-Step-Flow beim ersten v1.5.2-Boot aufgepoppt. Neues Config-Feld `WizardLastShownVersion` triggert das einmalig pro Wizard-Rework; Skip oder Finish reicht und danach öffnet er nicht mehr automatisch.
+- **Unter der Haube.** Pure-Helper-Tests für alle vier Profile-Sets in der Build-Suite (zwölf neue Facts), plus ein WizardStateSmokeStep für `/xlperf`. Migration v17 bleibt, nur ein optionales Config-Feld kommt dazu.

.github/forge-posts/v1.5.3.md

@@ -0,0 +1,9 @@
+---
+subtitle: "24 Sprachen, Inter Light statt Exo 2, HITCH 74 → 20 ms"
+versionsnatur: "Localisation + Font-Stack"
+---
+- **24 wählbare UI-Sprachen.** Aus dem ursprünglich nur als FR-Lokalisierung geplanten Cycle ist eine breite Welle geworden: Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Italian, Japanese, Korean, Norsk bokmål, Polish, Portuguese (BR), Portuguese (PT), Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian, Simplified Chinese, Traditional Chinese. Dropdown sortiert alphabetisch nach Endonym, „None" oben angepinnt. Nicht-native Übersetzungen sind AI-assisted und für Community-Review im Forge-Discord markiert.
+- **Inter Light statt Exo 2 als bundled Schrift.** Plus NotoSansCjkRegular als dritte Merge-Schicht. Damit deckt der Stack Latin Extended-A/B, Greek polytonic, Cyrillic Supplement und CJK (inkl. Hangul, Simplified-Han nach Reform) ab — die nicht-vanilla-FFXIV-Sprachen waren mit Exo 2 nicht lesbar.
+- **HITCH 74 → ~20 ms als Side-Effect.** Der UiBuilder-First-Frame-Lag lag seit v1.4.x stabil bei 74 ms; v1.5.1 wollte ihn in Richtung 7 ms ziehen, fiel als „Hypothese zu optimistisch" durch. Echter Grund: `Plugin.cs:937` push'te `RegularFont` nur wenn `FontsEnabled` true war — die „Mitgelieferte Schrift verwenden"-Logik setzte `FontsEnabled = false` mit, der bundled-Pfad war die ganze v1.5.x-Reihe tot, FFXIVs Axis-Font übernahm und kostete ~50 ms extra. Fix routet `RegularFont` jetzt auch über `UseHellionFont`. Median ~20 ms im 5-Reload-Stresstest (17.9-23.6 ms, Linux/Wine; Windows-Baseline steht aus).
+- **Glyph-Ranges aktivieren sich automatisch beim Sprachwechsel** plus eine One-Shot-Migration für User die schon eine non-Latin-Sprache eingestellt hatten. Neue WarningText unter dem Sprach-Dropdown weist darauf hin, dass FFXIVs Chat-Engine offiziell nur EN/DE/FR/JA-Glyphen rendert — andere Schriften können in der Game-Eingabe Garbled-Output zeigen.
+- **Unter der Haube.** Drei-Layer-Font-Stack, zwei neue ExtraGlyphRanges-Flags (`LatinExtended`, `Greek`), `LanguageOverride`-Enum wächst um zehn Locales plus drei reaktivierte (Italian, Korean, Norwegian mit `nb`). Append-only damit User-Configs stabil bleiben. Migration v17 bleibt.

.github/forge-posts/v1.5.4.md

@@ -0,0 +1,9 @@
+---
+subtitle: "Theme-Crossfade, Quick-Picker, Hover-Animationen"
+versionsnatur: "Polish & Motion"
+---
+- **Theme-Crossfade.** Theme-Wechsel blenden jetzt sanft über rund 300 ms ineinander, statt hart umzuschalten. Alle Hellion-Flächen gleiten mit: Sidebar, Titel, Buttons, Tabs, Scrollbar, Trennlinien. Der Fenster-Hintergrund snappt bewusst weiter, damit das Per-Window-Deckkraft-Setting aus Dalamuds Pinning-Menü unangetastet bleibt.
+- **Header-Quick-Picker.** Neuer Paletten-Button links vom Zahnrad im Chat-Header. Ein Klick öffnet ein kompaktes Popup mit zwei Sektionen: alle Built-in- und Custom-Themes sowie alle Tabs. Der aktive Eintrag trägt ein Häkchen, ein Klick wechselt ohne das Popup zu schließen. So lassen sich mehrere Wechsel hintereinander erledigen, ohne den Umweg über die Einstellungen.
+- **Sanfte Hover-Animationen.** Sidebar-Icons faden bei Hover sanft von gedimmt auf volle Deckkraft. Card-Mode-Trennlinien heben sich beim Überfahren einer Zeile für den ganzen Tab dezent ab. Beides framerate-unabhängig gerechnet, also auch bei Wine-Stall-Frames stabil.
+- **Bewegung reduzieren.** Neuer Toggle im Tab für Theme und Layout. Er deaktiviert Crossfade, Hover-Animationen und das Pulsieren ungelesener Tabs für alle, die eine statische Oberfläche bevorzugen.
+- Drei P3-Items plus der Accessibility-Toggle, kein Schema-Bump, keine Migration. Eine kleine Polish-Welle vor den größeren Cycles.

.github/forge-posts/v1.5.5.md

@@ -0,0 +1,11 @@
+---
+subtitle: "Backlog-Sync Tab-Features"
+versionsnatur: "Bundle-Patch (Hälfte 1 von 2)"
+---
+- **Fehlgeschlagener Tell.** Geht ein gesendeter Tell nicht durch (Empfänger offline, in einer Instanz oder blockiert), erscheint jetzt ein Warn-Toast statt dass die Systemmeldung durchrauscht. Abschaltbar in den Einstellungen unter Chat.
+- **Ton pro Tab.** Jeder Chat-Tab kann einen Benachrichtigungston spielen, wenn eine Nachricht eintrifft, während ein anderer Tab aktiv ist. Zur Wahl stehen die 16 Spiel-Chat-Sounds oder drei mitgelieferte Hellion-Sounds, mit einem Vorhör-Knopf. Standardmäßig aus, hört auf den globalen Sound-Schalter.
+- **Tab umbenennen.** Das Umbenennen-Feld im Rechtsklick-Menü fokussiert sich beim Öffnen von selbst und nimmt jetzt bis zu 512 Zeichen.
+- **Sprung ans Ende.** In der Chat-Kopfleiste erscheint ein Knopf, sobald man vom aktuellen Ende weggescrollt ist. Ein Klick springt zurück zur jüngsten Nachricht.
+- **Karten- und Item-Links.** Kartenmarkierung und verlinktes Item lassen sich aus dem Rechtsklick-Menü der Chat-Eingabe einfügen.
+- **Fuchs-Banner.** Das Hellion-Forge-Fuchs-Motiv im Einrichtungs-Assistenten und im Informations-Tab ist jetzt ein echtes Bild statt ASCII-Kunst.
+- Schema-Bump auf v18, rein additiv.

HellionChat/Branding/FoxBannerTexture.cs

@@ -0,0 +1,22 @@
+using Dalamud.Interface.Textures;
+
+namespace HellionChat.Branding;
+
+// UI sibling of HellionForgeAscii.FoxMini: the embedded Hellion Forge fox
+// banner PNG. Uses ITextureProvider.GetFromManifestResource, a "Get" shared
+// texture, so Dalamud owns the cache and lifetime. No manual dispose, no async
+// handling in the plugin. Static to mirror HellionForgeAscii (zero injectable
+// deps; Plugin.TextureProvider is a static [PluginService]).
+internal static class FoxBannerTexture
+{
+    private const string ResourceName = "HellionChat.Branding.fox-banner.png";
+
+    // Resolved fresh on every access. Dalamud keeps the shared texture cached
+    // internally and decodes it asynchronously, so GetWrapOrDefault() returns
+    // null for the first few frames until the decode finishes.
+    public static ISharedImmediateTexture Shared =>
+        Plugin.TextureProvider.GetFromManifestResource(
+            typeof(FoxBannerTexture).Assembly,
+            ResourceName
+        );
+}

HellionChat/Branding/HellionForgeAscii.cs

@@ -1,25 +1,18 @@
 namespace HellionChat.Branding;
 
-// Lazy-loaded provenance art that ships embedded with the DLL. Two
+// Lazy-loaded ASCII art that ships embedded with the DLL.
-// variants:
 //
-//   - FoxBanner: the full-size silhouette with "Hellion Forge" inside
-//     the body — rendered in the first-run wizard and the Information
-//     tab as a small "about the makers" anchor.
 //   - FoxMini: the four-line fox-head + curly-tail that gets stitched
 //     into the DI-logger bootstrap line so an xllog reader sees the
 //     same signature on every plugin load.
 //
-// Both files live as embedded resources under HellionChat.Branding.* so
+// The file lives as an embedded resource under HellionChat.Branding.* so
-// the plugin DLL is self-contained — no on-disk asset lookup that could
+// the plugin DLL is self-contained; no on-disk asset lookup that could
 // silently miss after a partial deploy.
 internal static class HellionForgeAscii
 {
-    private static string? _foxBanner;
     private static string? _foxMini;
 
-    public static string FoxBanner => _foxBanner ??= Load("HellionChat.Branding.fox-banner.txt");
-
     public static string FoxMini => _foxMini ??= Load("HellionChat.Branding.fox-mini.txt");
 
     private static string Load(string resourceName)

HellionChat/Configuration.cs

@@ -34,7 +34,7 @@ public class ConfigKeyBind
 [Serializable]
 public class Configuration : IPluginConfiguration
 {
-    private const int LatestVersion = 17;
+    private const int LatestVersion = 18;
 
     public int Version { get; set; } = LatestVersion;
 
@@ -100,6 +100,15 @@ public class Configuration : IPluginConfiguration
     public Dictionary<ChatType, int> RetentionPerChannelDays = [];
     public DateTimeOffset RetentionLastRunAt = DateTimeOffset.MinValue;
     public bool FirstRunCompleted;
+
+    // Tracks which plugin version last surfaced the first-run wizard.
+    // When the running version is newer than this, Plugin.LoadAsync
+    // re-opens the wizard once so existing users see major UX reworks
+    // (e.g. the v1.5.2 multi-step rewrite). Skip path and Finish both
+    // set FirstRunCompleted = true on close, so the wizard only fires
+    // once per version bump even if the user dismisses it.
+    public string WizardLastShownVersion = string.Empty;
+
     public bool UseHellionFont = true;
     public bool ShowHonorificTitleInHeader = true;
 
@@ -178,6 +187,9 @@ public class Configuration : IPluginConfiguration
     public bool CollapseKeepUniqueLinks;
     public bool SymbolPickerEnabled = true;
     public bool PlaySounds = true;
+
+    // Toast when a tell the user sent could not be delivered.
+    public bool NotifyFailedTell = true;
     public bool KeepInputFocus = true;
     public int MaxLinesToRender = 2_500; // 1-10000
     public bool Use24HourClock = true;
@@ -273,6 +285,7 @@ public class Configuration : IPluginConfiguration
         CollapseKeepUniqueLinks = other.CollapseKeepUniqueLinks;
         SymbolPickerEnabled = other.SymbolPickerEnabled;
         PlaySounds = other.PlaySounds;
+        NotifyFailedTell = other.NotifyFailedTell;
         KeepInputFocus = other.KeepInputFocus;
         MaxLinesToRender = other.MaxLinesToRender;
         Use24HourClock = other.Use24HourClock;
@@ -336,6 +349,7 @@ public class Configuration : IPluginConfiguration
         RetentionLastRunAt = other.RetentionLastRunAt;
 
         FirstRunCompleted = other.FirstRunCompleted;
+        WizardLastShownVersion = other.WizardLastShownVersion;
         UseHellionFont = other.UseHellionFont;
         ShowHonorificTitleInHeader = other.ShowHonorificTitleInHeader;
         ShowHonorificGlow = other.ShowHonorificGlow;
@@ -433,6 +447,10 @@ public class Tab
     public bool AllSenderMessages;
     public TellTarget TellTarget = TellTarget.Empty();
 
+    // Per-tab notification sound for messages arriving in an inactive tab.
+    public bool EnableNotificationSound;
+    public uint NotificationSoundId = 1;
+
     [NonSerialized]
     public uint Unread;
 
@@ -475,6 +493,17 @@ public class Tab
     [NonSerialized]
     internal string? _cachedTellIcon;
 
+    // PM-3 hover-lerp state. Default 0f means "not hovered". Sidebar
+    // path animates per tab; card-mode-border path is tab-aggregate
+    // (any card-row hover ramps the alpha for all cards in this tab).
+    // Lerp speed lives in the render loop, not here, so the same field
+    // serves both sites at the same animation curve.
+    [NonSerialized]
+    internal float _hoverAlpha;
+
+    [NonSerialized]
+    internal float _cardHoverAlpha;
+
     public bool Matches(Message message)
     {
         if (!message.Matches(SelectedChannels, ExtraChatAll, ExtraChatChannels))
@@ -540,6 +569,8 @@ public class Tab
             IsPinned = IsPinned,
             AllSenderMessages = AllSenderMessages,
             TellTarget = TellTarget.Clone(),
+            EnableNotificationSound = EnableNotificationSound,
+            NotificationSoundId = NotificationSoundId,
             IsGreeted = IsGreeted,
         };
     }
@@ -823,17 +854,27 @@ public enum LanguageOverride
     French,
     German,
     Greek,
-
-    // Italian,
     Japanese,
-
-    // Korean,
-    // Norwegian,
     PortugueseBrazil,
     Romanian,
     Russian,
     Spanish,
     Swedish,
+
+    // v1.5.3: Crowdin-heritage activated and Forge-maintained additions.
+    // Append-only to preserve serialized integer values of existing user configs.
+    Italian,
+    Korean,
+    Norwegian,
+    Catalan,
+    Czech,
+    Danish,
+    Finnish,
+    Hungarian,
+    Polish,
+    PortuguesePortugal,
+    Turkish,
+    Ukrainian,
 }
 
 public static class LanguageOverrideExt
@@ -849,15 +890,24 @@ public static class LanguageOverrideExt
             LanguageOverride.French => "Français",
             LanguageOverride.German => "Deutsch",
             LanguageOverride.Greek => "Ελληνικά",
-            // LanguageOverride.Italian => "Italiano",
+            LanguageOverride.Italian => "Italiano",
             LanguageOverride.Japanese => "日本語",
-            // LanguageOverride.Korean => "한국어 (Korean)",
+            LanguageOverride.Korean => "한국어",
-            // LanguageOverride.Norwegian => "Norsk",
+            LanguageOverride.Norwegian => "Norsk bokmål",
             LanguageOverride.PortugueseBrazil => "Português do Brasil",
             LanguageOverride.Romanian => "Română",
             LanguageOverride.Russian => "Русский",
             LanguageOverride.Spanish => "Español",
             LanguageOverride.Swedish => "Svenska",
+            LanguageOverride.Catalan => "Català",
+            LanguageOverride.Czech => "Čeština",
+            LanguageOverride.Danish => "Dansk",
+            LanguageOverride.Finnish => "Suomi",
+            LanguageOverride.Hungarian => "Magyar",
+            LanguageOverride.Polish => "Polski",
+            LanguageOverride.PortuguesePortugal => "Português (Portugal)",
+            LanguageOverride.Turkish => "Türkçe",
+            LanguageOverride.Ukrainian => "Українська",
             _ => throw new ArgumentOutOfRangeException(nameof(mode), mode, null),
         };
 
@@ -872,17 +922,47 @@ public static class LanguageOverrideExt
             LanguageOverride.French => "fr",
             LanguageOverride.German => "de",
             LanguageOverride.Greek => "el",
-            // LanguageOverride.Italian => "it",
+            LanguageOverride.Italian => "it",
             LanguageOverride.Japanese => "ja",
-            // LanguageOverride.Korean => "ko",
+            LanguageOverride.Korean => "ko",
-            // LanguageOverride.Norwegian => "no",
+            LanguageOverride.Norwegian => "nb",
             LanguageOverride.PortugueseBrazil => "pt-br",
             LanguageOverride.Romanian => "ro",
             LanguageOverride.Russian => "ru",
             LanguageOverride.Spanish => "es",
             LanguageOverride.Swedish => "sv",
+            LanguageOverride.Catalan => "ca",
+            LanguageOverride.Czech => "cs",
+            LanguageOverride.Danish => "da",
+            LanguageOverride.Finnish => "fi",
+            LanguageOverride.Hungarian => "hu",
+            LanguageOverride.Polish => "pl",
+            LanguageOverride.PortuguesePortugal => "pt-pt",
+            LanguageOverride.Turkish => "tr",
+            LanguageOverride.Ukrainian => "uk",
             _ => throw new ArgumentOutOfRangeException(nameof(mode), mode, null),
         };
+
+    // Maps a language to the ExtraGlyphRanges flag required for full UI
+    // rendering in that locale. The settings save path ORs this into
+    // Mutable.ExtraGlyphRanges so users do not need to know which range
+    // to tick manually. Returns 0 for locales fully covered by the default
+    // ImGui glyph range (Latin-1) or by the separate Japanese font handle.
+    public static ExtraGlyphRanges RequiredGlyphRanges(this LanguageOverride mode) =>
+        mode switch
+        {
+            LanguageOverride.Korean => ExtraGlyphRanges.Korean,
+            LanguageOverride.ChineseSimplified => ExtraGlyphRanges.ChineseSimplifiedCommon,
+            LanguageOverride.ChineseTraditional => ExtraGlyphRanges.ChineseFull,
+            LanguageOverride.Ukrainian => ExtraGlyphRanges.Cyrillic,
+            LanguageOverride.Greek => ExtraGlyphRanges.Greek,
+            LanguageOverride.Czech
+            or LanguageOverride.Polish
+            or LanguageOverride.Romanian
+            or LanguageOverride.Hungarian
+            or LanguageOverride.Turkish => ExtraGlyphRanges.LatinExtended,
+            _ => 0,
+        };
 }
 
 [Serializable]
@@ -896,10 +976,23 @@ public enum ExtraGlyphRanges
     Korean = 1 << 4,
     Thai = 1 << 5,
     Vietnamese = 1 << 6,
+
+    // v1.5.3: Custom ranges for languages with Latin Extended-A glyphs (Czech,
+    // Polish, Romanian, Turkish, Hungarian) and Greek polytonic accents.
+    LatinExtended = 1 << 7,
+    Greek = 1 << 8,
 }
 
 public static class ExtraGlyphRangesExt
 {
+    // Custom (start, end) inclusive pair lists for ranges that ImGui does
+    // not ship a built-in helper for. SetUpRanges() feeds these into
+    // ImFontGlyphRangesBuilder.AddChar via the `chars` parameter of
+    // BuildRange so we avoid the lifetime/pinning question that the native
+    // GetGlyphRanges*-pointer pathway papers over.
+    internal static readonly ushort[] LatinExtendedPairs = { 0x0100, 0x024F };
+    internal static readonly ushort[] GreekPairs = { 0x0370, 0x03FF, 0x1F00, 0x1FFF };
+
     public static string Name(this ExtraGlyphRanges ranges) =>
         ranges switch
         {
@@ -911,6 +1004,8 @@ public static class ExtraGlyphRangesExt
             ExtraGlyphRanges.Korean => Language.ExtraGlyphRanges_Korean_Name,
             ExtraGlyphRanges.Thai => Language.ExtraGlyphRanges_Thai_Name,
             ExtraGlyphRanges.Vietnamese => Language.ExtraGlyphRanges_Vietnamese_Name,
+            ExtraGlyphRanges.LatinExtended => Language.ExtraGlyphRanges_LatinExtended_Name,
+            ExtraGlyphRanges.Greek => Language.ExtraGlyphRanges_Greek_Name,
             _ => throw new ArgumentOutOfRangeException(nameof(ranges), ranges, null),
         };
 
@@ -925,6 +1020,10 @@ public static class ExtraGlyphRangesExt
             ExtraGlyphRanges.Korean => (nint)ImGui.GetIO().Fonts.GetGlyphRangesKorean(),
             ExtraGlyphRanges.Thai => (nint)ImGui.GetIO().Fonts.GetGlyphRangesThai(),
             ExtraGlyphRanges.Vietnamese => (nint)ImGui.GetIO().Fonts.GetGlyphRangesVietnamese(),
+            // LatinExtended and Greek are applied via builder.AddChar in
+            // FontManager.SetUpRanges, not through a native pointer range.
+            ExtraGlyphRanges.LatinExtended => 0,
+            ExtraGlyphRanges.Greek => 0,
             _ => throw new ArgumentOutOfRangeException(nameof(ranges), ranges, null),
         };
 }

HellionChat/FontManager.cs

@@ -9,7 +9,7 @@ using Dalamud.Plugin;
 
 namespace HellionChat;
 
-// Two LogProxy sites live in static methods (TryGetHellionFontBytes,
+// Two LogProxy sites live in static methods (TryGetBundledFontBytes,
 // AddFontWithFallback); a ctor-injected ILogger would not be reachable
 // from those scopes, so the class stays on Plugin.LogProxy.
 //
@@ -62,8 +62,8 @@ public sealed class FontManager : IDisposable
         90f,
     ];
 
-    // Hellion font bytes (Exo 2, OFL-1.1); lazily loaded from manifest resources
+    // Bundled UI font bytes (Inter Light, OFL-1.1); lazily loaded from manifest resources
-    private static byte[]? HellionFontBytes;
+    private static byte[]? BundledFontBytes;
 
     public FontManager(IDalamudPluginInterface pluginInterface)
     {
@@ -122,7 +122,7 @@ public sealed class FontManager : IDisposable
             e.OnPreBuild(tk =>
             {
                 // UseHellionFont swaps the source font but keeps the size
-                // selector tied to FontSizeV2 (the Hellion font ships as
+                // selector tied to FontSizeV2 (the bundled font ships as
                 // a single weight).
                 var basePt = Plugin.Config.UseHellionFont
                     ? Plugin.Config.FontSizeV2
@@ -130,15 +130,28 @@ public sealed class FontManager : IDisposable
                 var config = new SafeFontConfig { SizePt = basePt, GlyphRanges = Ranges };
                 // Missing embedded resource falls back to the configured
                 // system font instead of taking the whole UiBuilder down.
-                var hellionBytes = Plugin.Config.UseHellionFont ? TryGetHellionFontBytes() : null;
+                var bundledBytes = Plugin.Config.UseHellionFont ? TryGetBundledFontBytes() : null;
-                config.MergeFont = hellionBytes is not null
+                config.MergeFont = bundledBytes is not null
-                    ? tk.AddFontFromMemory(hellionBytes, config, "Hellion-Exo2")
+                    ? tk.AddFontFromMemory(bundledBytes, config, "Inter-Light")
                     : AddFontWithFallback(tk, Plugin.Config.GlobalFontV2.FontId, config, "global");
 
                 config.SizePt = Plugin.Config.JapaneseFontV2.SizePt;
                 config.GlyphRanges = JpRange;
                 AddFontWithFallback(tk, Plugin.Config.JapaneseFontV2.FontId, config, "japanese");
 
+                // v1.5.3: NotoSansCjk fallback covers Hangul, Simplified-Chinese
+                // -specific Han (e.g. 简) and other CJK glyphs that the primary
+                // (Inter Light / global font) and the FFXIV Japanese font do not
+                // ship. Merged last so earlier fonts win for shared codepoints.
+                config.SizePt = basePt;
+                config.GlyphRanges = Ranges;
+                AddFontWithFallback(
+                    tk,
+                    new DalamudAssetFontAndFamilyId(DalamudAsset.NotoSansCjkRegular),
+                    config,
+                    "noto-cjk-fallback"
+                );
+
                 config.SizePt = Plugin.Config.SymbolsFontSizeV2;
                 tk.AddGameSymbol(config);
 
@@ -166,6 +179,16 @@ public sealed class FontManager : IDisposable
                 config.GlyphRanges = JpRange;
                 AddFontWithFallback(tk, Plugin.Config.JapaneseFontV2.FontId, config, "japanese");
 
+                // v1.5.3: NotoSansCjk fallback (see BuildRegularFontHandle).
+                config.SizePt = Plugin.Config.ItalicFontV2.SizePt;
+                config.GlyphRanges = Ranges;
+                AddFontWithFallback(
+                    tk,
+                    new DalamudAssetFontAndFamilyId(DalamudAsset.NotoSansCjkRegular),
+                    config,
+                    "noto-cjk-fallback"
+                );
+
                 config.SizePt = Plugin.Config.SymbolsFontSizeV2;
                 tk.AddGameSymbol(config);
 
@@ -187,26 +210,26 @@ public sealed class FontManager : IDisposable
     // happen on a signed release build, but a broken csproj or hand-rolled
     // dev build can land here. Caller falls back to the system font path
     // so the plugin still loads instead of crashing the whole UiBuilder.
-    private static byte[]? TryGetHellionFontBytes()
+    private static byte[]? TryGetBundledFontBytes()
     {
-        if (HellionFontBytes is not null)
+        if (BundledFontBytes is not null)
-            return HellionFontBytes;
+            return BundledFontBytes;
 
         using var stream = typeof(FontManager).Assembly.GetManifestResourceStream(
-            "HellionFont.ttf"
+            "Inter-Light.ttf"
         );
         if (stream is null)
         {
             Plugin.LogProxy.Warning(
-                "Hellion font resource missing — falling back to system default font."
+                "Bundled Inter Light font resource missing, falling back to system default font."
             );
             return null;
         }
 
         using var ms = new MemoryStream();
         stream.CopyTo(ms);
-        HellionFontBytes = ms.ToArray();
+        BundledFontBytes = ms.ToArray();
-        return HellionFontBytes;
+        return BundledFontBytes;
     }
 
     private unsafe void SetUpRanges()
@@ -239,6 +262,18 @@ public sealed class FontManager : IDisposable
             builder.AddText("Œœ");
             builder.AddText("ĂăÂâÎîȘșȚț");
 
+            // v1.5.3: language-dropdown endonyms. The dropdown renders
+            // with the currently active font range; without these glyphs
+            // a user on an English UI cannot read non-Latin language names
+            // before switching. Auto-activation in Settings.Apply then
+            // pulls in the full ExtraGlyphRange for the chosen locale.
+            builder.AddText(
+                "Català Čeština Dansk Deutsch Ελληνικά English Español Suomi"
+                    + " Français Magyar Italiano 日本語 한국어 Norsk bokmål Nederlands"
+                    + " Polski Português Brasil (Portugal) Română Русский Svenska"
+                    + " Türkçe Українська 简体中文 繁體中文"
+            );
+
             // "Enclosed Alphanumerics" (partial) https://www.compart.com/en/unicode/block/U+2460
             for (var i = 0x2460; i <= 0x24B5; i++)
                 builder.AddChar((char)i);
@@ -248,11 +283,32 @@ public sealed class FontManager : IDisposable
         }
 
         var ranges = new List<nint> { (nint)ImGui.GetIO().Fonts.GetGlyphRangesDefault() };
+        var customChars = new List<ushort>();
         foreach (var extraRange in Enum.GetValues<ExtraGlyphRanges>())
-            if (Plugin.Config.ExtraGlyphRanges.HasFlag(extraRange))
+        {
-                ranges.Add(extraRange.Range());
+            if (!Plugin.Config.ExtraGlyphRanges.HasFlag(extraRange))
+                continue;
 
-        Ranges = BuildRange(null, ranges.ToArray());
+            // LatinExtended and Greek use AddChar pairs because they have no
+            // built-in ImGui range helper; everything else points to a native
+            // ImGui glyph-range table.
+            switch (extraRange)
+            {
+                case ExtraGlyphRanges.LatinExtended:
+                    customChars.AddRange(ExtraGlyphRangesExt.LatinExtendedPairs);
+                    break;
+                case ExtraGlyphRanges.Greek:
+                    customChars.AddRange(ExtraGlyphRangesExt.GreekPairs);
+                    break;
+                default:
+                    var ptr = extraRange.Range();
+                    if (ptr != 0)
+                        ranges.Add(ptr);
+                    break;
+            }
+        }
+
+        Ranges = BuildRange(customChars.Count > 0 ? customChars : null, ranges.ToArray());
         JpRange = BuildRange(GlyphRangesJapanese.GlyphRanges);
     }
 

HellionChat/HellionChat.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Dalamud.NET.Sdk/15.0.0">
     <PropertyGroup>
         <!-- Independent versioning; see yaml changelog for upstream Chat 2 base -->
-        <Version>1.5.1</Version>
+        <Version>1.5.5</Version>
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>
         <!-- Use lock file to pin exact versions -->
@@ -26,6 +26,11 @@
         <!-- SQLitePCLRaw override for CVE-2025-6965, CVE-2025-7709 (SQLite >= 3.50.3) -->
         <PackageReference Include="SQLitePCLRaw.lib.e_sqlite3" Version="3.50.3" />
         <PackageReference Include="morelinq" Version="4.4.0" />
+        <!-- NAudio.WinMM 2.2.1 MIT - WaveOutEvent/WinMM path is Wine-safe (WaveOut works under Wine,
+             Media-Foundation-based codecs do not). Using the sub-package avoids pulling in
+             NAudio.WinForms (which requires WindowsDesktop and does not build on Linux hosts).
+             WaveOutEvent and WaveFileReader both live in NAudio.WinMM + NAudio.Core. -->
+        <PackageReference Include="NAudio.WinMM" Version="2.2.1" />
         <PackageReference Include="Pidgin" Version="[3.5.1, 4.0.0)" />
         <PackageReference Include="SixLabors.ImageSharp" Version="[3.1.12, 4.0.0)" />
     </ItemGroup>
@@ -50,16 +55,26 @@
         </EmbeddedResource>
     </ItemGroup>
 
-    <!-- Embedded resources: Hellion font (Exo 2, OFL-1.1) + manifest resource -->
+    <!-- Embedded resources: bundled UI font (Inter Light, OFL-1.1) + manifest resource -->
     <ItemGroup>
-        <EmbeddedResource Include="Resources\HellionFont.ttf">
+        <EmbeddedResource Include="Resources\Inter-Light.ttf">
-            <LogicalName>HellionFont.ttf</LogicalName>
+            <LogicalName>Inter-Light.ttf</LogicalName>
         </EmbeddedResource>
-        <EmbeddedResource Include="Resources\HellionFont-OFL.txt">
+        <EmbeddedResource Include="Resources\Inter-OFL.txt">
-            <LogicalName>HellionFont-OFL.txt</LogicalName>
+            <LogicalName>Inter-OFL.txt</LogicalName>
         </EmbeddedResource>
-        <EmbeddedResource Include="Resources\Branding\fox-banner.txt">
+        <EmbeddedResource Include="Resources\Branding\fox-banner.png">
-            <LogicalName>HellionChat.Branding.fox-banner.txt</LogicalName>
+            <LogicalName>HellionChat.Branding.fox-banner.png</LogicalName>
+        </EmbeddedResource>
+        <!-- Bundled custom notification sounds, Mono 44.1 kHz 16-bit PCM WAV (Wine-safe) -->
+        <EmbeddedResource Include="Resources\Sounds\notification-1.wav">
+            <LogicalName>HellionChat.Sounds.notification-1.wav</LogicalName>
+        </EmbeddedResource>
+        <EmbeddedResource Include="Resources\Sounds\notification-2.wav">
+            <LogicalName>HellionChat.Sounds.notification-2.wav</LogicalName>
+        </EmbeddedResource>
+        <EmbeddedResource Include="Resources\Sounds\notification-3.wav">
+            <LogicalName>HellionChat.Sounds.notification-3.wav</LogicalName>
         </EmbeddedResource>
         <EmbeddedResource Include="Resources\Branding\fox-mini.txt">
             <LogicalName>HellionChat.Branding.fox-mini.txt</LogicalName>

HellionChat/HellionChat.yaml

@@ -15,8 +15,8 @@ description: |-
     - Per-channel retention with a daily background sweep
     - Retroactive cleanup (Ctrl+Shift confirm)
     - Export to Markdown, JSON or CSV
-    - First-run wizard with three preset profiles
+    - First-run wizard with four preset profiles
-    - Bilingual UI (EN/DE) with live language switching
+    - Multi-language UI (24 locales) with live language switching
     - Own config and database — no shared state with other plugins
 
     Based on Chat 2 by Infi and Anna (EUPL-1.2).
@@ -35,181 +35,179 @@ tags:
     - Replacement
     - Privacy
 changelog: |-
-    **v1.5.1 — FontAtlas Refactor and Hellion Forge Signature (2026-05-17)**
+    **v1.5.5 — Upstream-Sync Tab-Features (2026-05-21)**
 
-    Hybrid FontManager refactor plus an embedded provenance mark.
+    A backlog-sync cycle: inherited tab-feature items plus a new fox
-
+    banner image and custom notification sounds.
-    What changes under the hood:
-
-    - FontManager handle creation moves into the ctor inside a single
-      atlas.SuppressAutoRebuild() block. The font atlas now builds once
-      per plugin load instead of four to five times — less CPU and GPU
-      pressure in the first seconds after a reload, less atlas texture
-      memory churn.
-    - Hybrid property model: Axis, AxisItalic and FontAwesome become
-      init-only handles. RegularFont and ItalicFont stay mutable because
-      the eight font settings still need to replace them at runtime —
-      that path is funnelled through RebuildDelegateFonts() now and
-      runs without a plugin reload.
-    - FontAwesome reuses Dalamud's UiBuilder.IconFontFixedWidthHandle
-      instead of building its own atlas slot. One delegate-build step
-      less in the ctor.
-    - BuildFontsAsync and BuildFonts are removed; the live mutation
-      path is RebuildDelegateFonts() now.
-    - Two FontManager self-test steps registered with /xlperf: ctor
-      smoke (every handle non-null after Phase-1 resolve, no atlas
-      load-exception) and push smoke (Push() returns without throwing).
-
-    Honorific full-gradient port (originally the v1.5.1 main item) was
-    dropped: Honorific 3.2 exposes no IPC for the rendered gradient
-    frame, and an in-plugin port of the colour palette was declined.
-    The integration stays at the v1.4.7 glow-only shape.
 
     User-visible:
 
-    - Hellion Forge signature: a small fox-head ASCII silhouette is
+    - Failed tells now raise a warning toast when a message you sent
-      emitted to /xllog on every plugin load, and a full fox banner
+      could not be delivered (recipient offline, in an instance, or
-      with "Hellion Forge" set inside the body is available as a
+      blocking you). Toggle in Settings, Chat tab.
-      folded TreeNode in the First-Run Wizard and Settings ->
+    - Per-tab notification sound: each tab can play a sound when a
-      Information tab. Drawn by Julia Moon, embedded in the plugin DLL.
+      message arrives while you are looking at a different tab. Pick
-    - No settings changes, no migration. v17 stays.
+      one of the 16 game chat sounds or one of three bundled Hellion
+      sounds, with a preview button to hear it. Off by default,
+      respects the global sound toggle.
+    - The tab rename field in the right-click menu now focuses
+      itself when the menu opens and accepts up to 512 characters,
+      matching the settings-tab rename.
+    - A jump-to-latest button appears in the chat log header while
+      you are scrolled up from the live end.
+    - Map flags and item links can be inserted into the chat input
+      from its right-click menu.
+    - The Hellion Forge fox banner in the first-run wizard and the
+      Information tab is now a real image instead of ASCII art.
 
-    Note on performance: the cross-plugin baseline target from v1.5.0
+    Schema bumped to v18 (additive fields only, no data migration).
-    (matching Lightless and XIVInstantMessenger at ~7 ms HITCH) did
-    not land this cycle. HITCH stays around 80 ms because the cost is
-    in the UiBuilder first-frame render path, not in the atlas build
-    (which this cycle did reduce from 4-5 builds per load to 1). A
-    first-frame render investigation is reserved for a later cycle.
 
     Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
 
     ---
 
-    **v1.5.0 — DI Foundation and Service Refactor (2026-05-17)**
+    **v1.5.4 — Polish and Motion (2026-05-20)**
 
-    Major architecture cycle. The plugin bootstrap moves to a
+    A polish cycle: smoother theme switching, faster theme and tab
-    generic-host DI container (Microsoft.Extensions.Hosting +
+    access, and subtle hover motion. Three P3 items plus an
-    IServiceCollection) modelled on Lightless Sync. Service logging
+    accessibility toggle.
-    moves from a static Plugin.LogProxy locator to typed
-    Microsoft.Extensions.Logging.ILogger<T> via constructor injection,
-    bridged over Dalamud's IPluginLog by a custom DalamudLogger trio.
-
-    What changes under the hood:
-
-    - 18 instance-class services migrate to ILogger<T> via constructor
-      injection across four slices: data layer (MessageStore,
-      MessageManager, AutoTellTabsService), IPC and integrations
-      (HonorificService, IpcManager, TypingIpc, ExtraChat, the three
-      GameFunctions classes), UI window layer (ChatLogWindow,
-      DbViewer, Popout, three settings tabs), and root (Commands,
-      ThemeRegistry, PayloadHandler).
-    - Plugin.LogProxy stays in place for the eight buckets ctor
-      injection cannot reach: static helpers (EmoteCache,
-      AutoTranslate, MemoryUtil, WrapperUtil), Dalamud-reflected
-      types (Configuration), the Message data class, and instance
-      classes that only log from static methods (FontManager, one
-      GameFunctions site).
-    - Plugin.cs finishes at 1012 lines — virtually identical to the
-      pre-cycle 1013. The new Phase-1 host build and Plugin.X bridge
-      wiring trade out exactly the service and window allocations
-      that previously lived in LoadAsync.
-    - Cross-plugin baseline confirms no performance penalty against
-      Chat 2: HellionChat first-frame HITCH 77 ms median, Chat 2
-      74 ms median. Lightless and XIVInstantMessenger sit around
-      7 ms by deferring their font-atlas build past Finished
-      loading — that pattern is the v1.5.1 follow-up.
 
     User-visible:
 
-    - Slash-command insert fix: pasting a slash command into the
+    - Theme switches now crossfade smoothly over ~300 ms across every
-      chat input (Friend List "/tell" action, plugin-driven inserts
+      Hellion-rendered surface — sidebar, title, buttons, tabs,
-      from Artisan, AllaganTools etc.) now replaces the existing
+      scrollbar, separators. The window background snaps deliberately
-      input instead of concatenating. Cherry-picked from ChatTwo
+      so the per-window opacity override from Dalamud's pinning menu
-      upstream ee7768ac with namespace adaptation.
+      stays untouched.
+    - New header quick-picker: a palette button left of the cog opens
+      a compact popup with two sections — every built-in and custom
+      theme, and every tab. The active entry carries a check glyph;
+      clicking another switches without closing the popup.
+    - Sidebar icons ease their opacity on hover, and card-mode message
+      borders highlight per tab while the cursor is over their rows.
+      Framerate-independent, so a stalled Wine frame cannot overshoot
+      the animation.
+    - New "Reduce motion" toggle in Theme & Layout disables the
+      crossfade, the hover animations and the unread-tab pulse for
+      users who prefer a static UI.
 
-    Migration v17 stays (no schema bump).
+    Under the hood:
+
+    - Two pure-helper lerp paths (ThemeAbgrCacheLerp, FrameLerp) with
+      xUnit coverage in the Build Suite, plus a ColourUtil.ApplyAlpha
+      alpha modulator. Two new /xlperf self-test steps pin the
+      crossfade and quick-picker contracts.
+
+    No schema bump, no migration. Migration v17 stays.
 
     Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
 
     ---
 
-    **v1.4.10 — Symbol-Picker and Tell-History Fix (2026-05-16)**
+    **v1.5.3 — Localisation Wave + Bundled-Font Overhaul (2026-05-19)**
 
-    Eleventh and final sub-patch of the v1.4.x polish-sweep series.
+    Multi-language pass plus a long-standing first-frame HITCH lands
-    Symbol picker for the chat input, a tell-history reload fix for
+    as a side effect of a font-stack rewrite.
-    users with many active partners, and a closing cleanup sweep
-    before v1.5.0 picks up the DI-container adoption.
 
-    - Symbol picker: a small smile-icon button left of the channel
+    User-visible:
-      indicator opens a popup with two tabs. The first lists all 161
+
-      FFXIV PUA glyphs (Dalamud's SeIconChar enum); the second
+    - 24 selectable UI languages (was 2). Catalan, Czech, Danish,
-      carries 97 server-verified BMP symbols (latin marks, currency,
+      Dutch, English, Finnish, French, German, Greek, Hungarian,
-      the full Greek alphabet, geometric shapes, suits, notes) —
+      Italian, Japanese, Korean, Norsk bokmål, Polish, Portuguese
-      every one of them round-tripped through /echo and /say in a
+      (BR + PT), Romanian, Russian, Spanish, Swedish, Turkish,
-      four-round probe so the in-channel render matches what the
+      Ukrainian, Simplified + Traditional Chinese. Sorted by endonym,
-      picker shows. Click drops the glyph at the caret, multi-insert
+      "None" pinned first. Non-native locales are AI-assisted and
-      keeps the popup open, and a recent-used strip floats the last
+      flagged for native-speaker review via the Forge Discord.
-      sixteen picks across both tabs. Toggle in Settings → Chat →
+    - Bundled Inter Light replaces Exo 2 (SIL OFL 1.1, 343 KB). The
-      Message behaviour, default on.
+      Inter font ships Latin Extended-A/B, Greek polytonic and
-    - Pinned auto-tell tabs reload their full history again: a
+      Cyrillic Supplement coverage; NotoSansCjkRegular joins as a
-      hidden 500-row scan cap in PreloadHistory used to override the
+      third merge layer for Hangul and Simplified-Han glyphs the
-      user-configurable AutoTellTabsHistoryPreload setting, so
+      FFXIV Japanese game font does not ship.
-      less-frequent pinned partners (rare /tell sessions in an
+    - First-frame HITCH dropped from ~74 ms (v1.5.2 baseline that
-      otherwise busy week) lost their backlog. The cap is removed;
+      held since v1.4.x) to a median of ~20 ms (5-reload sample
-      the (Receiver, Date) index keeps SQL fast, the client-side
+      17.9-23.6 ms, Linux/Wine). The bundled-font path silently
-      loop still respects your setting as the upper bound.
+      fell back to the FFXIV Axis font for the entire v1.5.x series
-    - Slash-command teardown: /hellion, /hellionView,
+      because of an early-return in the draw loop. The fix that
-      /hellionDebugger (and #if DEBUG /hellionSeString) wrappers are
+      routes RegularFont through draw also lands the defer-pattern
-      now cached as private fields. Plugin teardown detaches the
+      win the v1.5.1 cycle was reaching for.
-      live registration instead of re-Register'ing with identical
+    - ExtraGlyphRanges auto-activates on language change. Korean,
-      args — closes a latent maintenance hazard from v1.4.9.
+      ChineseFull and the two new flags (LatinExtended, Greek) toggle
-    - v1.4.x polish-sweep wraps up here. The ImGuiListClipper render
+      on without a manual visit to Fonts and Colours.
-      refactor that was on the v1.4.10 reserve list got dropped
+    - New WarningText under the language dropdown notes FFXIV's
-      after cross-platform smoke showed the scroll rubber-band is a
+      chat input only fully supports EN/DE/FR/JA character sets.
-      Wine / Linux render-pipeline quirk, not universal — Windows
+      Other languages render in HellionChat but may garble when
-      users never saw it. It will get its own platform-targeted
+      typed into in-game chat.
-      spike in a later patch. Next major cycle is v1.5.0 with the
+
-      DI-container adoption (Microsoft.Extensions.Hosting +
+    Under the hood:
-      ILogger<T>) modelled on Lightless.
+
-    - Migration v17 stays (no schema bump).
+    - Three-layer font stack: Inter Light primary, FFXIV
+      JapaneseFont merge 1 for kana/kanji style, NotoSansCjkRegular
+      merge 2 for everything else CJK.
+    - LanguageOverride enum gains ten locales plus three previously
+      commented out (Italian, Korean, Norwegian as `nb`). New
+      values append to the enum so existing config integers stay
+      stable across update.
+    - Crowdin gap closed: four post-sync ChatTwo keys backfilled
+      into 13 legacy locales with per-key AI markers.
+    - Plugin.LoadAsync runs a one-shot migration that ORs in the
+      matching ExtraGlyphRanges flag for users already on a
+      non-default language. Settings.Apply auto-activates on
+      change going forward.
+    - Em-dash sweep across the EN source and 18 translations to the
+      house style. Russian and Ukrainian keep the typographic norm.
+
+    Migration v17 stays. UseHellionFont users transition from Exo 2
+    to Inter Light transparently on first reload.
 
     Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
 
     ---
 
-    **v1.4.9 — Plugin-Load Render Polish (2026-05-15)**
+    **v1.5.2 — First-Run Wizard Rework (2026-05-18)**
 
-    Tenth sub-patch of the v1.4.x polish-sweep series. First-frame
+    UX patch. The first-run wizard becomes a four-step flow with a
-    render cost drops from ~127 ms median to ~76 ms median,
+    new Roleplay privacy profile and a power-settings step that
-    comfortably under Dalamud's 100 ms HITCH warning threshold.
+    surfaces previously-hidden defaults. Existing v1.5.1 users see
+    the new wizard once on first v1.5.2 boot.
 
-    - First-frame defer: six non-essential rendering sections inside
+    What changes user-visible:
-      ChatLogWindow skip their first Draw and run one frame later
+
-      (bottom status bar, channel-name SeString chunks, window bounds
+    - Wizard navigation: Welcome → Privacy profile → Power settings
-      check, v0.6.1 hint banner, autocomplete, input-preview
+      → Done. Forge-Bronze pagination dots, dedicated stage for the
-      calculation). User-visible delay is ~17 ms at 60 fps, hidden
+      power settings so they are no longer buried in Settings.
-      inside the post-reload font-atlas build window.
+    - Fourth privacy profile "Roleplay": Privacy-First plus Say and
-    - Slash-command centralisation: /hellion, /hellionView,
+      both emote types, with a 30-day window for Say and a 90-day
-      /hellionSeString and /hellionDebugger are registered in
+      window for emotes. Shout, Yell and Novice Network stay out.
-      LoadAsync instead of inside the corresponding window
+    - Privacy picker becomes a 2x2 grid. Casual stays the
-      constructors. The plugin-manager Open and configuration buttons
+      recommended option with a ★ marker.
-      hang on the same path.
+    - Power-settings step covers Load Previous Session, Filter
-    - Plugin-load profiling logs stay on at Information level
+      Include Previous Sessions, Auto-Tell-Tabs History Preload,
-      (MessageStore connect/migrate, FilterAllTabs, auto-translate
+      Compact Density, Prettier Timestamps and a built-in theme
-      warmup) as a regression tripwire — a future load past 100 ms
+      picker. All six map to existing Configuration fields — no new
-      will show up in /xllog without a Debug filter.
+      settings introduced.
-    - ChatTwo IPC compatibility layer: HellionChat now mirrors
+    - Staged commit: the wizard only writes to Config on the Finish
-      ChatTwo's full IPC surface (GetChatInputState,
+      step. Decide-later or X-close at any point leaves the existing
-      ChatInputStateChanged, Register, Unregister, Available,
+      config untouched.
-      Invoke) under the ChatTwo.* namespace in addition to our
+    - Inline test hint on the done step: "type /tell <Player Name>
-      existing HellionChat.* provider gates. Third-party
+      into chat" surfaces the auto-tell-tab spawn mechanism.
-      integrations that historically only subscribe to ChatTwo's
+    - Window starts at 720x480 (was 900x560) and can shrink to
-      IPC — for example Artisan's and AllaganTools' context-menu
+      600x400; Step 1 keeps the fox banner in a folded TreeNode so
-      hooks — keep working without requiring a code change on their
+      the onboarding copy stays primary.
-      side. Conflict detection prevents ChatTwo from loading in
+    - Existing users get the new wizard surfaced once on first boot
-      parallel with HellionChat, so there is no slot-collision risk
+      after the update via the new WizardLastShownVersion config
-      at runtime.
+      field. Future cycles bump the constant only when the wizard
-    - Migration v17 stays (no schema bump).
+      itself changes shape.
+
+    Under the hood:
+
+    - WizardStateSmokeStep added to /xlperf alongside the FontManager
+      and ThemeSwitch self-tests.
+    - Twelve new pure-helper xUnit Facts in the Build Suite cover
+      all four privacy profile sets and their retention overrides.
+
+    Migration v17 stays (no schema bump). The Configuration grows
+    one optional string field (WizardLastShownVersion) which
+    defaults to empty for legacy users.
 
     Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
 

HellionChat/Infrastructure/Hosting/InitHostedServices.cs

@@ -1,4 +1,5 @@
 using Dalamud.Plugin;
+using HellionChat.Integrations;
 using HellionChat.Ipc;
 using HellionChat.Themes;
 using Microsoft.Extensions.Hosting;
@@ -19,7 +20,7 @@ internal sealed class ThemeRegistryInitHostedService(ThemeRegistry registry) : I
         // warm cache; otherwise the first Switch falls through to the built-in
         // default when Config.Theme points at a custom slug.
         foreach (var _ in registry.AllCustom()) { }
-        registry.Switch(Plugin.Config.Theme);
+        registry.SwitchSilent(Plugin.Config.Theme);
         return Task.CompletedTask;
     }
 
@@ -85,3 +86,18 @@ internal sealed class AutoTellTabsServiceInitHostedService(AutoTellTabsService s
 
     public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
 }
+
+// Eager-resolve trigger: resolving FailedTellNotifier in this adapter's ctor
+// enables its game hook during host startup. StartAsync itself is a no-op.
+internal sealed class FailedTellNotifierInitHostedService(FailedTellNotifier notifier)
+    : IHostedService
+{
+    // No-op adapter: the ctor dependency above is the actual eager-resolve
+    // trigger. Field kept to match the IpcManager/TypingIpc/ExtraChat no-op
+    // adapters and to avoid the CS9113 unread-parameter warning.
+    private readonly FailedTellNotifier _notifier = notifier;
+
+    public Task StartAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+}

HellionChat/Integrations/CustomAudioPlayer.cs

@@ -0,0 +1,146 @@
+using System;
+using System.IO;
+using Microsoft.Extensions.Logging;
+using NAudio.Wave;
+
+namespace HellionChat.Integrations;
+
+// Plays the three bundled WAV notification sounds via NAudio WaveOutEvent.
+// WaveOutEvent/WinMM is the correct backend for FFXIV on Wine: it works
+// without Media Foundation (which Wine does not support for MP3/AAC).
+//
+// Volume is fixed at 0.8. No per-user slider in this iteration so we can
+// ship quickly and gather feedback before adding UX complexity.
+internal sealed class CustomAudioPlayer : IDisposable
+{
+    // Sound bytes are read once at construction so each Play() wraps a fresh
+    // MemoryStream rather than re-reading the manifest stream (which becomes
+    // unreadable after the first read and would require Seek support).
+    private readonly byte[][] _soundData;
+    private readonly ILogger<CustomAudioPlayer> _logger;
+
+    private WaveOutEvent? _outputDevice;
+    private WaveFileReader? _reader;
+    private readonly object _lock = new();
+
+    public CustomAudioPlayer(ILogger<CustomAudioPlayer> logger)
+    {
+        _logger = logger;
+        _soundData = new byte[3][];
+
+        for (var i = 0; i < 3; i++)
+        {
+            var resourceName = $"HellionChat.Sounds.notification-{i + 1}.wav";
+            using var stream = typeof(CustomAudioPlayer).Assembly.GetManifestResourceStream(
+                resourceName
+            );
+            if (stream is null)
+            {
+                _logger.LogWarning(
+                    "Embedded sound resource not found: {Resource}. "
+                        + "Custom sound {Index} will be silent.",
+                    resourceName,
+                    i + 1
+                );
+                _soundData[i] = Array.Empty<byte>();
+                continue;
+            }
+
+            using var ms = new MemoryStream();
+            stream.CopyTo(ms);
+            _soundData[i] = ms.ToArray();
+        }
+    }
+
+    // customIndex is 1, 2, or 3, matching the sound file suffix.
+    // Stops any currently playing sound before starting the new one.
+    // NAudio playback runs on its own thread; this method returns immediately.
+    public void Play(int customIndex)
+    {
+        if (customIndex < 1 || customIndex > 3)
+        {
+            _logger.LogWarning(
+                "CustomAudioPlayer.Play called with out-of-range index {Index}",
+                customIndex
+            );
+            return;
+        }
+
+        var data = _soundData[customIndex - 1];
+        if (data.Length == 0)
+        {
+            _logger.LogWarning(
+                "Sound data for index {Index} is empty; skipping playback",
+                customIndex
+            );
+            return;
+        }
+
+        lock (_lock)
+        {
+            try
+            {
+                StopCurrent();
+
+                var ms = new MemoryStream(data, writable: false);
+                _reader = new WaveFileReader(ms);
+
+                _outputDevice = new WaveOutEvent();
+                // Init opens the device and creates the WinMM handle. Volume
+                // must be set after Init, otherwise waveOutSetVolume fails with
+                // InvalidHandle.
+                _outputDevice.Init(_reader);
+                _outputDevice.Volume = 0.8f;
+                _outputDevice.Play();
+            }
+            catch (Exception ex)
+            {
+                _logger.LogWarning(
+                    ex,
+                    "Failed to play custom notification sound {Index}",
+                    customIndex
+                );
+                StopCurrent();
+            }
+        }
+    }
+
+    // Stops and tears down the active WaveOutEvent + WaveFileReader without
+    // throwing. Called on Play (to interrupt previous sound) and from Dispose.
+    // Guards Stop() with a PlaybackState check because waveOutReset blocks even
+    // when playback already finished; under Wine this can stall the WinMM
+    // callback thread if many sounds arrive in quick succession.
+    private void StopCurrent()
+    {
+        try
+        {
+            if (_outputDevice?.PlaybackState == PlaybackState.Playing)
+                _outputDevice.Stop();
+            _outputDevice?.Dispose();
+            _outputDevice = null;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Exception while stopping current WaveOutEvent");
+        }
+
+        try
+        {
+            _reader?.Dispose();
+            _reader = null;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Exception while disposing WaveFileReader");
+        }
+    }
+
+    // At plugin unload the PendingMessageThread is already cancelled and the
+    // draw loop is gone, so _lock is uncontended here. Calling StopCurrent
+    // outside the lock avoids holding it across the blocking waveOutReset /
+    // WaveOutEvent.Dispose, which can freeze on Wine during unload.
+    public void Dispose()
+    {
+        StopCurrent();
+    }
+}

HellionChat/Integrations/FailedTellNotifier.cs

@@ -0,0 +1,74 @@
+using System;
+using Dalamud.Hooking;
+using Dalamud.Interface.ImGuiNotification;
+using FFXIVClientStructs.FFXIV.Client.System.String;
+using FFXIVClientStructs.FFXIV.Client.UI.Misc;
+using HellionChat._Helpers;
+using HellionChat.Resources;
+using HellionChat.Util;
+using Microsoft.Extensions.Logging;
+
+namespace HellionChat.Integrations;
+
+// A minimal, failed-tell-specific game hook. A locale-robust "tell failed"
+// signal is not reachable over the processed message stream (Message carries
+// no LogMessage row id, ChatCode 60 is too broad). This hooks the one
+// ShowLogMessageString overload and toasts on a pinned id set. It is NOT the
+// broad ad-block hook layer.
+internal sealed class FailedTellNotifier : IDisposable
+{
+    private readonly ILogger<FailedTellNotifier> _logger;
+    private readonly Hook<RaptureLogModule.Delegates.ShowLogMessageString>? _hook;
+
+    public unsafe FailedTellNotifier(ILogger<FailedTellNotifier> logger)
+    {
+        _logger = logger;
+
+        // Creating/enabling a hook is safe off the framework thread (the
+        // ctor runs during host startup on the framework thread,
+        // eager-resolved via FailedTellNotifierInitHostedService).
+        _hook =
+            Plugin.GameInteropProvider.HookFromAddress<RaptureLogModule.Delegates.ShowLogMessageString>(
+                RaptureLogModule.MemberFunctionPointers.ShowLogMessageString,
+                ShowLogMessageStringDetour
+            );
+        _hook.Enable();
+    }
+
+    private unsafe void ShowLogMessageStringDetour(
+        RaptureLogModule* module,
+        uint logMessageId,
+        Utf8String* value
+    )
+    {
+        try
+        {
+            if (
+                FailedTellMatcher.ShouldNotify(
+                    logMessageId,
+                    Plugin.Config.NotifyFailedTell,
+                    FailedTellMatcher.FailedTellLogMessageIds
+                )
+            )
+            {
+                var recipient = value is null ? string.Empty : value->ToString();
+                var content = string.IsNullOrEmpty(recipient)
+                    ? HellionStrings.FailedTell_Notification_Generic
+                    : string.Format(HellionStrings.FailedTell_Notification_Named, recipient);
+                WrapperUtil.AddNotification(content, NotificationType.Warning);
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "FailedTellNotifier detour threw");
+        }
+
+        _hook!.Original(module, logMessageId, value);
+    }
+
+    public void Dispose()
+    {
+        _hook?.Disable();
+        _hook?.Dispose();
+    }
+}

HellionChat/MessageManager.cs

@@ -7,7 +7,9 @@ using Dalamud.Game.Text.SeStringHandling;
 using Dalamud.Hooking;
 using Dalamud.Interface.ImGuiNotification;
 using Dalamud.Plugin.Services;
+using FFXIVClientStructs.FFXIV.Client.UI;
 using FFXIVClientStructs.FFXIV.Client.UI.Misc;
+using HellionChat._Helpers;
 using HellionChat.Code;
 using HellionChat.Resources;
 using HellionChat.Util;
@@ -330,6 +332,7 @@ internal class MessageManager : IAsyncDisposable
             Store.UpsertMessage(message);
 
         var currentMatches = Plugin.CurrentTab.Matches(message);
+        uint? notificationSound = null;
         foreach (var tab in Plugin.Config.Tabs)
         {
             var unread = !(
@@ -337,7 +340,49 @@ internal class MessageManager : IAsyncDisposable
             );
 
             if (tab.Matches(message))
+            {
                 tab.AddMessage(message, unread);
+
+                // Per-tab notification sound. Fire once for the first inactive
+                // tab that wants it, keeping a message matching several
+                // background tabs from stacking sounds.
+                // TEST-MIRROR: ../_Helpers/TabSoundDecision.cs
+                if (
+                    notificationSound is null
+                    && TabSoundDecision.ShouldPlay(
+                        Plugin.CurrentTab == tab,
+                        tab.EnableNotificationSound,
+                        Plugin.Config.PlaySounds
+                    )
+                )
+                {
+                    notificationSound = tab.NotificationSoundId;
+                }
+            }
+        }
+
+        if (notificationSound is { } soundId)
+        {
+            if (soundId is >= 1 and <= 16)
+            {
+                // ProcessMessage runs on the PendingMessageThread worker; the native
+                // UIGlobals.PlaySoundEffect must be marshalled onto the framework
+                // thread (reference_dalamud_framework_thread).
+                Plugin.Framework.RunOnFrameworkThread(() =>
+                {
+                    unsafe
+                    {
+                        UIGlobals.PlaySoundEffect(soundId);
+                    }
+                });
+            }
+            else if (soundId >= 17)
+            {
+                // Custom bundled sounds (ids 17-19) go through NAudio WaveOutEvent.
+                // NAudio manages its own playback thread, so no framework marshalling needed.
+                Plugin.CustomAudioPlayer.Play((int)soundId - 16);
+            }
+            // soundId == 0 (hand-edited config) falls through: plays nothing.
         }
 
         MessageProcessed?.Invoke(message);

HellionChat/Plugin.cs

@@ -115,6 +115,7 @@ public sealed class Plugin : IAsyncDalamudPlugin
     internal Themes.ThemeRegistry ThemeRegistry { get; private set; } = null!;
     internal Ui.StatusBar StatusBar { get; private set; } = null!;
     internal Integrations.HonorificService HonorificService { get; private set; } = null!;
+    internal Integrations.CustomAudioPlayer CustomAudioPlayer { get; private set; } = null!;
 
     // Platform indirection over Dalamud.Utility.Util. Wired in Phase-1 ctor so
     // any service allocated in LoadAsync can read Plugin.PlatformUtil.
@@ -198,10 +199,12 @@ public sealed class Plugin : IAsyncDalamudPlugin
         // point (MigrateFromChatTwoLayout, LanguageChanged, ImGuiUtil.Initialize)
         // do not touch either static, so the brief null-window is safe.
 
-        // Schema gate: v1.4.x requires config v16+. Users on older schemas
+        // Schema gate: v1.4.x+ requires config v16+. Users on older schemas
-        // must install v1.4.2 first to run the migration chain. v17 adds
+        // must install v1.4.2 first to run the migration chain. v18 adds the
-        // Tab.IsPinned (additive, no data migration needed) so v16 configs
+        // per-tab EnableNotificationSound + NotificationSoundId fields and the
-        // load cleanly and get their Version stamp bumped after the gate.
+        // top-level NotifyFailedTell flag, all additive with defaults, so
+        // v16/v17 configs load cleanly and get their Version stamp bumped
+        // after the gate.
         if (Config.Version < 16)
         {
             throw new InvalidOperationException(
@@ -209,13 +212,24 @@ public sealed class Plugin : IAsyncDalamudPlugin
                     + "Please install v1.4.2 first to migrate the configuration, then upgrade to v1.4.10."
             );
         }
-        Config.Version = 17;
+        Config.Version = 18;
 
         // Unpinned TempTabs are session-only and dropped on every load. Pinned
         // TempTabs survive reload — Jin's tester feedback (v1.4.7).
         Config.Tabs.RemoveAll(TabLifecycleHelpers.ShouldStripOnLoad);
 
         LanguageChanged(Interface.UiLanguage);
+
+        // v1.5.3 migration: Settings.Apply auto-activates the matching
+        // ExtraGlyphRanges flag on a language CHANGE; a config that already
+        // has e.g. Czech selected from a previous version never goes through
+        // that path. ORing in the required flag here lets the first atlas
+        // build pick it up, so an upgrade from v1.5.2 renders correctly
+        // without forcing the user to toggle the language twice.
+        var requiredRanges = Config.LanguageOverride.RequiredGlyphRanges();
+        if (requiredRanges != 0 && !Config.ExtraGlyphRanges.HasFlag(requiredRanges))
+            Config.ExtraGlyphRanges |= requiredRanges;
+
         ImGuiUtil.Initialize(this);
 
         DeferredSaveFrames = -1;
@@ -273,6 +287,7 @@ public sealed class Plugin : IAsyncDalamudPlugin
         TypingIpc = _host.Services.GetRequiredService<TypingIpc>();
         ExtraChat = _host.Services.GetRequiredService<ExtraChat>();
         HonorificService = _host.Services.GetRequiredService<Integrations.HonorificService>();
+        CustomAudioPlayer = _host.Services.GetRequiredService<Integrations.CustomAudioPlayer>();
         StatusBar = _host.Services.GetRequiredService<Ui.StatusBar>();
         MessageManager = _host.Services.GetRequiredService<MessageManager>();
         AutoTellTabsService = _host.Services.GetRequiredService<AutoTellTabsService>();
@@ -319,10 +334,27 @@ public sealed class Plugin : IAsyncDalamudPlugin
 
             SelfTestRegistry.RegisterTestSteps([
                 new SelfTests.ThemeSwitchSelfTestStep(this),
+                new SelfTests.ThemeCrossfadeSelfTestStep(this),
                 new SelfTests.FontManagerCtorSmokeStep(this),
                 new SelfTests.FontPushSmokeStep(this),
+                new SelfTests.WizardStateSmokeStep(this),
+                new SelfTests.QuickPickerSelfTestStep(this),
+                new SelfTests.FoxBannerTextureSmokeStep(this),
             ]);
 
+            // Re-surface the wizard for existing users when a major UX
+            // rework ships. The constant tracks the most recent version
+            // whose wizard should be shown once; bump it in future cycles
+            // that reshape the onboarding flow. Saved immediately so a
+            // pre-Finish crash doesn't loop the prompt forever.
+            const string WizardReshowVersion = "1.5.2";
+            if (Config.WizardLastShownVersion != WizardReshowVersion)
+            {
+                Config.FirstRunCompleted = false;
+                Config.WizardLastShownVersion = WizardReshowVersion;
+                SaveConfig();
+            }
+
             if (!Config.FirstRunCompleted)
                 FirstRunWizard.IsOpen = true;
 
@@ -887,6 +919,7 @@ public sealed class Plugin : IAsyncDalamudPlugin
         // Theme engine is always active; Classic is a theme, not a disabled state.
         using IDisposable _style = HellionStyle.PushGlobal(
             ThemeRegistry.Active,
+            ThemeRegistry,
             Config.WindowOpacity
         );
 
@@ -920,7 +953,12 @@ public sealed class Plugin : IAsyncDalamudPlugin
         // RegularFont is nullable only because the live rebuild path
         // disposes it before reassigning; both ends of that swap happen on
         // this same draw thread, so it cannot be null here.
-        using ((Config.FontsEnabled ? FontManager.RegularFont! : FontManager.Axis).Push())
+        // v1.5.3 fix: also push RegularFont when the bundled Inter Light is
+        // selected. Without this, UseHellionFont=true silently fell back to
+        // the FFXIV Axis font because FontsAndColours forces FontsEnabled
+        // off in that branch, and the bundled font never made it into draw.
+        var useRegularFont = Config.FontsEnabled || Config.UseHellionFont;
+        using ((useRegularFont ? FontManager.RegularFont! : FontManager.Axis).Push())
             WindowSystem.Draw();
 
         ChatLogWindow.FinalizeFrame();

HellionChat/PluginHostFactory.cs

@@ -107,6 +107,12 @@ internal static class PluginHostFactory
             sp.GetRequiredService<ILogger<Integrations.HonorificService>>(),
             sp.GetRequiredService<IFramework>()
         ));
+        services.AddSingleton(sp => new Integrations.FailedTellNotifier(
+            sp.GetRequiredService<ILogger<Integrations.FailedTellNotifier>>()
+        ));
+        services.AddSingleton(sp => new Integrations.CustomAudioPlayer(
+            sp.GetRequiredService<ILogger<Integrations.CustomAudioPlayer>>()
+        ));
 
         services.AddSingleton(sp => new MessageManager(
             sp.GetRequiredService<Plugin>(),
@@ -172,6 +178,11 @@ internal static class PluginHostFactory
         services.AddHostedService(sp => new AutoTellTabsServiceInitHostedService(
             sp.GetRequiredService<AutoTellTabsService>()
         ));
+        services.AddHostedService(
+            sp => new Infrastructure.Hosting.FailedTellNotifierInitHostedService(
+                sp.GetRequiredService<Integrations.FailedTellNotifier>()
+            )
+        );
     }
 }
 

HellionChat/Privacy/PrivacyDefaults.cs

@@ -114,4 +114,29 @@ internal static class PrivacyDefaults
             [ChatType.StandardEmote] = 1,
             [ChatType.NoviceNetwork] = 1,
         };
+
+    // Roleplay: Privacy-First + Say + both emote types. Public-distance
+    // channels (Shout, Yell) stay out — they are public-noise from
+    // strangers, not story content. Novice Network also stays out;
+    // it is not RP-adjacent and would dilute the profile's intent.
+    internal static readonly IReadOnlySet<ChatType> RoleplayWhitelist = new HashSet<ChatType>(
+        PrivacyFirstWhitelist
+    )
+    {
+        ChatType.Say,
+        ChatType.CustomEmote,
+        ChatType.StandardEmote,
+    };
+
+    // RP sessions function as story logs: Say + emotes need a longer
+    // window than Casual's 1-day public-chat window. 30 days for Say
+    // keeps in-character dialogue scrollable across multiple sessions,
+    // 90 days for emotes mirrors the Privacy-First conversation default.
+    internal static readonly IReadOnlyDictionary<ChatType, int> RoleplayRetentionOverrides =
+        new Dictionary<ChatType, int>
+        {
+            [ChatType.Say] = 30,
+            [ChatType.CustomEmote] = 90,
+            [ChatType.StandardEmote] = 90,
+        };
 }

HellionChat/Resources/Branding/fox-banner.txt

@@ -1,68 +0,0 @@
-                                   .:;+xXXX$$$$$$$$XXx+;:
-.X$+                        .;+X$$$$$$$$$$$$$$$$$$$$$$$$$$$x:
-;$xx$$X+:...    .....::+X$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$;.
-X$;  .:+xXXX$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X:
-$$;              :++xX$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X;
-$$x.             .+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X.
-x$$;           ;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X+;::::::;x$$$$$:
-:$$$;            .+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X+:.              .+$$$$$$$$$X+;;:
- ;$$$+.   :X$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X;:                   :$$$$$$$$$$$$$$$$X;.
- .+$$$X:   ..;X$$$$$$$$$$$$$$$$$$$$$$$$$$X;..                     :$$$$$$$$$$$$$$$$$$$$X:
-   ;$$$$$X+::::+X$$$$$$$$$$$$$$$$$$$$$X;.                        .$$$$$$$$$$$$$$$$$$$$$$$X;
-     +$$$$$$$$$$$$$$$$$$$$$$$$$$$$X+:  Hellion Forge             x$$$$$$$$$$$$$$$$$$$$$$$$$X:
-      .;x$$$$$$$$$$$$$$$$$$$$$x;:                               .X$$$$$$$$$$$$$$$$$$$$$$$$$$$+
-          .;+$$$$$$$$$$X+;:..                                   .X$$$$$$$$$$$$$$$$$$$$$$$$$$$$+
-                                                                .X$$$$$$$$$$$$$$$$$$$$$$$$$$$$$;
-                                                                .X$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                 x$$$$$$$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                 ;$$$$$$xx$$$$$$$$$$$$$$$$$$$$$x
-                                                                 .$$$$$$x+$$$$$$$$$$$$$$$$$$$$$x
-                                                               :+X$$$$$$X;$$$$$$$$$$$$$$$$$$$$$$:
-                                                              ;$$$$$$$$$$;$$$$$$$$$$$$$$$$$$$$$$X.
-                                                              +$$$$$$$$$$;x$$$$$$$$$$$$$$$$$$$$$$+
-                                                               x$$$$$$$$$$:$$$$$$$$$$$$$$$$$$$$$$X:
-                                                               .X$$$$$$$$$.:$$$$$$$$$$$$$$$$$$$$$$;
-                                                                :X$$X;;;;: .$$$$$$$$$$$$$$$$$$$$$$X.
-                                                                 .$$$$X    .$$$$$$$$$$$$$$$$$$$$$$$:
-                                                                  .$$$$+   .X$$$$$$$$$$$$$$$$$$$$$$;
-                                                                   ;$$$$:  .X$$$$$$$$$$$$$$$$$$$$$$x
-                                                                   :X$$$+  .$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                    +$$$x  :$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                    ;$$X:  $$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                          x$$$$$$$$$$$$$$$$$$$$$$$$X
-                                                                         +$$$$$$$$$$$$$$$$$$$$$$$$$+
-                                                                       .+$$$$$$$$$$$$$$$$$$$$$$$$$$;
-                                                                   .  ;$$$$$$$$$$$$$$$$$$$$$$$$$$$$:
-                                                                 :X$x$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
-                                                              .XX$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+
-                                                             ;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+$;
-                                                    ..     ++X$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$:+$:
-                                                   :$$+.  ;$$$$$$$$$$$$$$X$$$$$$$$$$$$$$$$$$$$$;:$$+
-                                                  .x+X$X: X$$$$$$$$$$x::;:;$$$$$$$$$$$$$$$$$$X: ;$X.
-                                                  :X.x$$$:.::::::;x+:X$$$$;$$$$$$$$$$$$$$$$$$:  :X;
-                                                  :x.x$$$$$$$$$$$$$$$$$;;$:$$$$$$$$$$$$$$$$$:  :$+
-                                                  :Xx$$$$$$$$$$$$$$$$$: ;X;$$$$$$$$$$$$$$$$: .+$$;
-                                                  ;$$$$$$$$$$$$$$$$$$; .X+X$$$$$$$$$$$$$$$+  .+$+.
-                                                 +$$$$$$$$$$$$$$$$$$$$$$$;+$$$$$$$$$$$$$$X: .+X:
-                                                +$$$$$$$$$$$$$$$$$$$$$$$$$+:$$$$$$$$$$$$$+.+$+.
-                                               ;$$$$$$$$$$$$$$$$$$$$$$$$$$$X;$$$$$$$$$$$$$$X:
-                                               +X: .:X$$$$$$$$x+++x$$$$$$$$;:X$$$$$$$$$$$X:
-                                               :x.;$;+$$$$$:.       :X$$$$X   :$$$$$$$$$$X:
-                                                ;x  :X$$$; .x$$x      X$$;  .:+.$$$$$$$$$$x
-                                                 xx.X$$X:              X$;.:$X:.X$$$$$$$$$:
-                                                 +$$$$X.               ;$;:::  .$$$$$$$$$:
-                                                 ;$$$;        :+X$$$$XX$;      X$$$$$$$$:
-                                                ;$$X:    .:x$x$$$$$X.         x$$$$$$$$:
-                                              :X$X:    :+x;  :$$$$$:         +$$$$$$$X:
-                                              :++$X+xXX;.    +$$$$.         +$$$$$$$+.
-                                                  ...       .X$$$X.        +$$$$$$$:
-                                                             ;$$$$;      .X$$$$$$x.
-                                                              ;$$X;     :X$$$$$$;
-                                                                       ;$$$$$$x.
-                                                                     .X$$$$$$;
-                                                                    ;$$$$$$+
-                                                                   +$$$$$;
-                                                                 :X$$$$;.
-                                                                ;$$$$+.
-                                                               .x$$$X:
-                                                               .+$$X;

HellionChat/Resources/HellionStrings.Designer.cs

@@ -116,6 +116,38 @@ internal class HellionStrings
     internal static string Wizard_Reopen_Button => Get(nameof(Wizard_Reopen_Button));
     internal static string Wizard_Cancel_Label => Get(nameof(Wizard_Cancel_Label));
     internal static string Wizard_Cancel_Tooltip => Get(nameof(Wizard_Cancel_Tooltip));
+    internal static string Wizard_Step1_Title => Get(nameof(Wizard_Step1_Title));
+    internal static string Wizard_Step1_Subtitle => Get(nameof(Wizard_Step1_Subtitle));
+    internal static string Wizard_Step1_Footer_Hint => Get(nameof(Wizard_Step1_Footer_Hint));
+    internal static string Wizard_Step1_Skip_Label => Get(nameof(Wizard_Step1_Skip_Label));
+    internal static string Wizard_Step1_Skip_Tooltip => Get(nameof(Wizard_Step1_Skip_Tooltip));
+    internal static string Wizard_Step2_Title => Get(nameof(Wizard_Step2_Title));
+    internal static string Wizard_Step2_RecommendedFooter => Get(nameof(Wizard_Step2_RecommendedFooter));
+    internal static string Wizard_Profile_Roleplay_Heading => Get(nameof(Wizard_Profile_Roleplay_Heading));
+    internal static string Wizard_Profile_Roleplay_Description => Get(nameof(Wizard_Profile_Roleplay_Description));
+    internal static string Wizard_Profile_Roleplay_Apply => Get(nameof(Wizard_Profile_Roleplay_Apply));
+    internal static string Wizard_Nav_Back => Get(nameof(Wizard_Nav_Back));
+    internal static string Wizard_Nav_Next => Get(nameof(Wizard_Nav_Next));
+    internal static string Wizard_Nav_Finish => Get(nameof(Wizard_Nav_Finish));
+    internal static string Wizard_Step3_Title => Get(nameof(Wizard_Step3_Title));
+    internal static string Wizard_Step3_Section_History => Get(nameof(Wizard_Step3_Section_History));
+    internal static string Wizard_Step3_Section_TellTabs => Get(nameof(Wizard_Step3_Section_TellTabs));
+    internal static string Wizard_Step3_Section_Visual => Get(nameof(Wizard_Step3_Section_Visual));
+    internal static string Wizard_Step3_LoadPreviousSession_Label => Get(nameof(Wizard_Step3_LoadPreviousSession_Label));
+    internal static string Wizard_Step3_FilterIncludePreviousSessions_Label => Get(nameof(Wizard_Step3_FilterIncludePreviousSessions_Label));
+    internal static string Wizard_Step3_AutoTellTabsHistoryPreload_Label => Get(nameof(Wizard_Step3_AutoTellTabsHistoryPreload_Label));
+    internal static string Wizard_Step3_UseCompactDensity_Label => Get(nameof(Wizard_Step3_UseCompactDensity_Label));
+    internal static string Wizard_Step3_PrettierTimestamps_Label => Get(nameof(Wizard_Step3_PrettierTimestamps_Label));
+    internal static string Wizard_Step3_Theme_Label => Get(nameof(Wizard_Step3_Theme_Label));
+    internal static string Wizard_Step4_Title => Get(nameof(Wizard_Step4_Title));
+    internal static string Wizard_Step4_SummaryHeading => Get(nameof(Wizard_Step4_SummaryHeading));
+    internal static string Wizard_Step4_Summary_Profile => Get(nameof(Wizard_Step4_Summary_Profile));
+    internal static string Wizard_Step4_Summary_History => Get(nameof(Wizard_Step4_Summary_History));
+    internal static string Wizard_Step4_Summary_TellTabs => Get(nameof(Wizard_Step4_Summary_TellTabs));
+    internal static string Wizard_Step4_Summary_Visual => Get(nameof(Wizard_Step4_Summary_Visual));
+    internal static string Wizard_Step4_Summary_Unchanged => Get(nameof(Wizard_Step4_Summary_Unchanged));
+    internal static string Wizard_Step4_TestHint => Get(nameof(Wizard_Step4_TestHint));
+    internal static string Wizard_Step4_SettingsHint => Get(nameof(Wizard_Step4_SettingsHint));
 
     internal static string Export_Heading => Get(nameof(Export_Heading));
     internal static string Export_Help => Get(nameof(Export_Help));
@@ -251,6 +283,7 @@ internal class HellionStrings
     internal static string Settings_General_Audio_Heading => Get(nameof(Settings_General_Audio_Heading));
     internal static string Settings_General_Performance_Heading => Get(nameof(Settings_General_Performance_Heading));
     internal static string Settings_General_Language_Heading => Get(nameof(Settings_General_Language_Heading));
+    internal static string Settings_Language_FFXIVCoverage_Warning => Get(nameof(Settings_Language_FFXIVCoverage_Warning));
 
     // Hellion Chat — Appearance-Tab section headings
     internal static string Settings_Appearance_Theme_Heading => Get(nameof(Settings_Appearance_Theme_Heading));
@@ -411,4 +444,29 @@ internal class HellionStrings
     internal static string DbViewer_FullTextToggle => Get(nameof(DbViewer_FullTextToggle));
     internal static string DbViewer_FullTextToggle_Hint_Indexing => Get(nameof(DbViewer_FullTextToggle_Hint_Indexing));
     internal static string DbViewer_FullTextToggle_Hint_PhraseMode => Get(nameof(DbViewer_FullTextToggle_Hint_PhraseMode));
+
+    // Hellion Chat — v1.5.4 header quick-picker + reduce-motion toggle
+    internal static string Settings_QuickPicker_Tooltip => Get(nameof(Settings_QuickPicker_Tooltip));
+    internal static string Settings_QuickPicker_Themes_Header => Get(nameof(Settings_QuickPicker_Themes_Header));
+    internal static string Settings_QuickPicker_Tabs_Header => Get(nameof(Settings_QuickPicker_Tabs_Header));
+    internal static string Settings_ThemeAndLayout_ReduceMotion_Name => Get(nameof(Settings_ThemeAndLayout_ReduceMotion_Name));
+    internal static string Settings_ThemeAndLayout_ReduceMotion_Description => Get(nameof(Settings_ThemeAndLayout_ReduceMotion_Description));
+
+    // Failed-tell notification
+    internal static string FailedTell_Notification_Generic => Get(nameof(FailedTell_Notification_Generic));
+    internal static string FailedTell_Notification_Named => Get(nameof(FailedTell_Notification_Named));
+    internal static string Settings_Chat_NotifyFailedTell_Name => Get(nameof(Settings_Chat_NotifyFailedTell_Name));
+    internal static string Settings_Chat_NotifyFailedTell_Description => Get(nameof(Settings_Chat_NotifyFailedTell_Description));
+
+    // Per-tab notification sound
+    internal static string Tabs_NotificationSound_Enable_Name => Get(nameof(Tabs_NotificationSound_Enable_Name));
+    internal static string Tabs_NotificationSound_Description => Get(nameof(Tabs_NotificationSound_Description));
+    internal static string Tabs_NotificationSound_Option => Get(nameof(Tabs_NotificationSound_Option));
+    internal static string Tabs_NotificationSound_Preview => Get(nameof(Tabs_NotificationSound_Preview));
+    internal static string Tabs_NotificationSound_CustomOption => Get(nameof(Tabs_NotificationSound_CustomOption));
+
+    // Scroll-to-bottom and item/flag linking
+    internal static string ChatLog_ScrollToBottom_Tooltip => Get(nameof(ChatLog_ScrollToBottom_Tooltip));
+    internal static string ChatLog_Insert_MapFlag => Get(nameof(ChatLog_Insert_MapFlag));
+    internal static string ChatLog_Insert_ItemLink => Get(nameof(ChatLog_Insert_ItemLink));
 }

HellionChat/Resources/HellionStrings.de.resx

@@ -223,11 +223,107 @@
     <value>Wizard erneut zeigen</value>
   </data>
   <data name="Wizard_Cancel_Label" xml:space="preserve">
-    <value>Später — Defaults behalten</value>
+    <value>Später: Defaults behalten</value>
   </data>
   <data name="Wizard_Cancel_Tooltip" xml:space="preserve">
     <value>Schließt den Wizard ohne Profil-Auswahl. Die Plugin-Defaults bleiben aktiv und der Wizard erscheint beim nächsten Plugin-Reload erneut.</value>
   </data>
+  <data name="Wizard_Step1_Title" xml:space="preserve">
+    <value>Willkommen bei Hellion Chat</value>
+  </data>
+  <data name="Wizard_Step1_Subtitle" xml:space="preserve">
+    <value>Ein Chat 2 Fork von Hellion Forge mit DSGVO-konformen Defaults, brand-konsistentem Look und Quality-of-Life-Verbesserungen.</value>
+  </data>
+  <data name="Wizard_Step1_Footer_Hint" xml:space="preserve">
+    <value>3 kurze Schritte. Du kannst alles später unter Einstellungen → Hellion Chat ändern.</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Label" xml:space="preserve">
+    <value>Später entscheiden</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Tooltip" xml:space="preserve">
+    <value>Assistenten schließen. Die Plugin-Standardwerte bleiben aktiv. Du kannst den Assistenten über Einstellungen → Hellion Chat erneut öffnen.</value>
+  </data>
+  <data name="Wizard_Step2_Title" xml:space="preserve">
+    <value>Was darf gespeichert werden?</value>
+  </data>
+  <data name="Wizard_Step2_RecommendedFooter" xml:space="preserve">
+    <value>★ = empfohlen für die meisten Spieler.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Heading" xml:space="preserve">
+    <value>Roleplay</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Description" xml:space="preserve">
+    <value>Wie Datensparsamkeit, plus Sagen und beide Emote-Typen für deine Story-Logs. Schreien und Rufen bleiben außen vor. Public-Distance-Lärm von Fremden ist kein Story-Inhalt. Aufbewahrung: Sagen 30 Tage, Emotes 90 Tage.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Apply" xml:space="preserve">
+    <value>Roleplay übernehmen</value>
+  </data>
+  <data name="Wizard_Nav_Back" xml:space="preserve">
+    <value>‹ Zurück</value>
+  </data>
+  <data name="Wizard_Nav_Next" xml:space="preserve">
+    <value>Weiter ›</value>
+  </data>
+  <data name="Wizard_Nav_Finish" xml:space="preserve">
+    <value>Fertig ✓</value>
+  </data>
+  <data name="Wizard_Step3_Title" xml:space="preserve">
+    <value>Versteckte Defaults</value>
+  </data>
+  <data name="Wizard_Step3_Section_History" xml:space="preserve">
+    <value>Verlauf</value>
+  </data>
+  <data name="Wizard_Step3_Section_TellTabs" xml:space="preserve">
+    <value>Tell-Tabs</value>
+  </data>
+  <data name="Wizard_Step3_Section_Visual" xml:space="preserve">
+    <value>Optik</value>
+  </data>
+  <data name="Wizard_Step3_LoadPreviousSession_Label" xml:space="preserve">
+    <value>Vorherige Session beim Start laden</value>
+  </data>
+  <data name="Wizard_Step3_FilterIncludePreviousSessions_Label" xml:space="preserve">
+    <value>Filter auch auf alte Messages anwenden</value>
+  </data>
+  <data name="Wizard_Step3_AutoTellTabsHistoryPreload_Label" xml:space="preserve">
+    <value>N Tell-Messages beim Öffnen eines Auto-Tabs vorladen</value>
+  </data>
+  <data name="Wizard_Step3_UseCompactDensity_Label" xml:space="preserve">
+    <value>Kompakter Density-Modus</value>
+  </data>
+  <data name="Wizard_Step3_PrettierTimestamps_Label" xml:space="preserve">
+    <value>Schönere Timestamps (relative Zeit)</value>
+  </data>
+  <data name="Wizard_Step3_Theme_Label" xml:space="preserve">
+    <value>Theme</value>
+  </data>
+  <data name="Wizard_Step4_Title" xml:space="preserve">
+    <value>Du bist startklar</value>
+  </data>
+  <data name="Wizard_Step4_SummaryHeading" xml:space="preserve">
+    <value>Deine Konfiguration</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Profile" xml:space="preserve">
+    <value>Profil: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_History" xml:space="preserve">
+    <value>Verlauf: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_TellTabs" xml:space="preserve">
+    <value>Tell-Tabs: {0} Messages vorladen</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Visual" xml:space="preserve">
+    <value>Optik: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Unchanged" xml:space="preserve">
+    <value>(unverändert)</value>
+  </data>
+  <data name="Wizard_Step4_TestHint" xml:space="preserve">
+    <value>💡 Probier's aus: Tipp /tell &lt;Spielername&gt; in den Chat. Hellion Chat öffnet automatisch einen eigenen Tab für die Unterhaltung und lädt die letzten {0} Messages mit.</value>
+  </data>
+  <data name="Wizard_Step4_SettingsHint" xml:space="preserve">
+    <value>Einstellungen → Hellion Chat zum späteren Anpassen</value>
+  </data>
   <data name="Export_Heading" xml:space="preserve">
     <value>Export (DSGVO Art. 15 — Auskunftsrecht)</value>
   </data>
@@ -289,10 +385,10 @@
     <value>Wie deckend die Plugin-Fenster sind. Niedrigere Werte lassen das Spiel durchscheinen, Form-Felder und Dialoge bleiben oben drauf deckend und gut lesbar.</value>
   </data>
   <data name="Theme_UseHellionFont_Name" xml:space="preserve">
-    <value>Mitgelieferte Hellion-Schrift (Exo 2) verwenden</value>
+    <value>Mitgelieferte Inter Light verwenden</value>
   </data>
   <data name="Theme_UseHellionFont_Description" xml:space="preserve">
-    <value>Rendert Chat und UI in Exo 2 (SIL Open Font License 1.1), die mit dem Plugin ausgeliefert wird. Deaktivieren, um auf die unter Einstellungen → Schrift gewählte Schriftart zurückzufallen.</value>
+    <value>Stellt Chat und UI in Inter Light (SIL Open Font License 1.1) dar, die mit dem Plugin geliefert wird. Deaktivieren, um zur Schrift aus Einstellungen → Schriftart zurückzukehren.</value>
   </data>
 
   <data name="About_Maintainer_Heading" xml:space="preserve">
@@ -399,7 +495,7 @@
     <value>Maximal {0} angepinnte Tell-Tabs erreicht. Erst einen lösen oder dauerhaft behalten.</value>
   </data>
   <data name="PinTab_PinnedTooltip" xml:space="preserve">
-    <value>Angepinnt — überlebt Relog.</value>
+    <value>Angepinnt: überlebt Relog.</value>
   </data>
   <data name="PinTab_PinTooltip" xml:space="preserve">
     <value>Angepinnte Tabs überleben Relog und behalten die Bindung an die Tell-Person.</value>
@@ -440,7 +536,7 @@
     <value>„Als begrüßt markieren"-Button anzeigen</value>
   </data>
   <data name="ChatLog_AutoTellTabs_GreetedToggle_Description" xml:space="preserve">
-    <value>Fügt neben jedem Auto-Tell-Tab einen Klick-Button hinzu, um einen Gesprächspartner als bereits begrüßt zu markieren — der Tab-Name wird dann gedimmt. Nützlich für Club-Greeter, die parallel viele Konversationen führen. Standardmäßig aus.</value>
+    <value>Fügt neben jedem Auto-Tell-Tab einen Klick-Button hinzu, um einen Gesprächspartner als bereits begrüßt zu markieren: der Tab-Name wird dann gedimmt. Nützlich für Club-Greeter, die parallel viele Konversationen führen. Standardmäßig aus.</value>
   </data>
   <data name="ChatLog_AutoTellTabs_OpenAsPopout_Name" xml:space="preserve">
     <value>Neue /tell-Tabs direkt als Pop-Out öffnen</value>
@@ -809,7 +905,7 @@
     <value>Fenster-Transparenz</value>
   </data>
   <data name="Settings_ThemeAndLayout_WindowOpacity_Description" xml:space="preserve">
-    <value>Wie durchsichtig der Fensterhintergrund ist. Niedrigere Werte lassen mehr vom Spiel durchscheinen. Tipp: Dalamud's Per-Window-Menü (Hamburger in der Titelleiste) bietet pro Fenster eigene Overrides für Deckkraft, Hintergrund-Blur, Durchklick und Anpinnen — die haben Vorrang über diesen Slider für das jeweilige Fenster.</value>
+    <value>Wie durchsichtig der Fensterhintergrund ist. Niedrigere Werte lassen mehr vom Spiel durchscheinen. Tipp: Dalamud's Per-Window-Menü (Hamburger in der Titelleiste) bietet pro Fenster eigene Overrides für Deckkraft, Hintergrund-Blur, Durchklick und Anpinnen: die haben Vorrang über diesen Slider für das jeweilige Fenster.</value>
   </data>
   <data name="Settings_FontsAndColours_Fonts_Heading" xml:space="preserve">
     <value>Schriftarten</value>
@@ -934,4 +1030,22 @@
   <data name="DbViewer_FullTextToggle_Hint_PhraseMode" xml:space="preserve">
     <value>Sucht nach der exakten Wortfolge. Mehrere Wörter werden nur gefunden, wenn sie zusammen und in dieser Reihenfolge stehen. Wer rohe FTS5-MATCH-Syntax nutzen will, setzt eigene Anführungszeichen um den Suchbegriff.</value>
   </data>
+  <data name="Settings_Language_FFXIVCoverage_Warning" xml:space="preserve">
+    <value>HellionChat zeigt alle 24 Sprachen, aber FFXIVs Chat-Eingabe unterstützt nur EN, DE, FR und JA vollständig. Andere Schriften können beim Tippen in den Spiel-Chat oder beim Senden von Nachrichten als unleserliche Zeichen erscheinen.</value>
+  </data>
+  <data name="Settings_QuickPicker_Tooltip" xml:space="preserve">
+    <value>Schnellauswahl für Themes und Tabs</value>
+  </data>
+  <data name="Settings_QuickPicker_Themes_Header" xml:space="preserve">
+    <value>Themes</value>
+  </data>
+  <data name="Settings_QuickPicker_Tabs_Header" xml:space="preserve">
+    <value>Tabs</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Name" xml:space="preserve">
+    <value>Bewegung reduzieren</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Description" xml:space="preserve">
+    <value>Deaktiviert die Theme-Überblendung, die Hover-Animationen von Seitenleiste und Karten sowie das Pulsieren ungelesener Tabs. Theme-Wechsel und Hover-Zustände greifen dann sofort.</value>
+  </data>
 </root>

HellionChat/Resources/HellionStrings.resx

@@ -19,7 +19,7 @@
     <value>Enable privacy filter</value>
   </data>
   <data name="Privacy_FilterEnabled_Description" xml:space="preserve">
-    <value>When enabled, only messages from allowed channels are written to the database. When disabled, the default behaviour applies — everything except battle logs is stored.</value>
+    <value>When enabled, only messages from allowed channels are written to the database. When disabled, the default behaviour applies. Everything except battle logs is stored.</value>
   </data>
   <data name="Privacy_FilterEnabled_StorageOnly_Help" xml:space="preserve">
     <value>The filter only controls what is written to the local database. The chat log still shows every message live; excluded channels are simply no longer stored. If you also want to remove channels from the visible display, use the normal chat-tab filters in the game.</value>
@@ -82,7 +82,7 @@
     <value>The manual run uses your SAVED retention policy, not the slider values above. Click Save first if you want the run to apply your current changes.</value>
   </data>
   <data name="Cleanup_Preview_Stale" xml:space="preserve">
-    <value>Preview is stale — your whitelist has changed since the last refresh. Click Refresh to recalculate.</value>
+    <value>Preview is stale: your whitelist has changed since the last refresh. Click Refresh to recalculate.</value>
   </data>
   <data name="Cleanup_RefreshPreview" xml:space="preserve">
     <value>Refresh preview</value>
@@ -133,7 +133,7 @@
     <value>Automatically delete messages past their channel retention window</value>
   </data>
   <data name="Retention_Enabled_Description" xml:space="preserve">
-    <value>When enabled, messages older than the configured window are deleted on each plugin start (at most once every 24 hours). Default is OFF — the plugin never deletes anything without your explicit consent.</value>
+    <value>When enabled, messages older than the configured window are deleted on each plugin start (at most once every 24 hours). Default is OFF. The plugin never deletes anything without your explicit consent.</value>
   </data>
   <data name="Retention_Default_Label" xml:space="preserve">
     <value>Default retention (days, 0 = never)</value>
@@ -223,11 +223,107 @@
     <value>Show wizard again</value>
   </data>
   <data name="Wizard_Cancel_Label" xml:space="preserve">
-    <value>Later — keep defaults</value>
+    <value>Later: keep defaults</value>
   </data>
   <data name="Wizard_Cancel_Tooltip" xml:space="preserve">
     <value>Close the wizard without selecting a profile. The plugin defaults stay active and the wizard returns on next plugin load.</value>
   </data>
+  <data name="Wizard_Step1_Title" xml:space="preserve">
+    <value>Welcome to Hellion Chat</value>
+  </data>
+  <data name="Wizard_Step1_Subtitle" xml:space="preserve">
+    <value>A Chat 2 fork from Hellion Forge with privacy-aware defaults, brand-consistent visuals, and a few quality-of-life touches.</value>
+  </data>
+  <data name="Wizard_Step1_Footer_Hint" xml:space="preserve">
+    <value>Three short steps. You can change everything later under Settings → Hellion Chat.</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Label" xml:space="preserve">
+    <value>Decide later</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Tooltip" xml:space="preserve">
+    <value>Close the wizard. The plugin defaults stay active. You can reopen the wizard from Settings → Hellion Chat.</value>
+  </data>
+  <data name="Wizard_Step2_Title" xml:space="preserve">
+    <value>What gets stored?</value>
+  </data>
+  <data name="Wizard_Step2_RecommendedFooter" xml:space="preserve">
+    <value>★ = recommended for most players.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Heading" xml:space="preserve">
+    <value>Roleplay</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Description" xml:space="preserve">
+    <value>Like Privacy First, plus Say and both emote types for your story logs. Shout and Yell stay out. Public-distance noise from strangers is not story content. Retention: Say 30 days, emotes 90 days.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Apply" xml:space="preserve">
+    <value>Apply roleplay</value>
+  </data>
+  <data name="Wizard_Nav_Back" xml:space="preserve">
+    <value>‹ Back</value>
+  </data>
+  <data name="Wizard_Nav_Next" xml:space="preserve">
+    <value>Next ›</value>
+  </data>
+  <data name="Wizard_Nav_Finish" xml:space="preserve">
+    <value>Finish ✓</value>
+  </data>
+  <data name="Wizard_Step3_Title" xml:space="preserve">
+    <value>Hidden defaults</value>
+  </data>
+  <data name="Wizard_Step3_Section_History" xml:space="preserve">
+    <value>History</value>
+  </data>
+  <data name="Wizard_Step3_Section_TellTabs" xml:space="preserve">
+    <value>Tell tabs</value>
+  </data>
+  <data name="Wizard_Step3_Section_Visual" xml:space="preserve">
+    <value>Visual</value>
+  </data>
+  <data name="Wizard_Step3_LoadPreviousSession_Label" xml:space="preserve">
+    <value>Load previous session on startup</value>
+  </data>
+  <data name="Wizard_Step3_FilterIncludePreviousSessions_Label" xml:space="preserve">
+    <value>Apply filters to messages from previous sessions</value>
+  </data>
+  <data name="Wizard_Step3_AutoTellTabsHistoryPreload_Label" xml:space="preserve">
+    <value>Preload N tell messages when an auto-tab opens</value>
+  </data>
+  <data name="Wizard_Step3_UseCompactDensity_Label" xml:space="preserve">
+    <value>Compact density</value>
+  </data>
+  <data name="Wizard_Step3_PrettierTimestamps_Label" xml:space="preserve">
+    <value>Prettier timestamps (relative time)</value>
+  </data>
+  <data name="Wizard_Step3_Theme_Label" xml:space="preserve">
+    <value>Theme</value>
+  </data>
+  <data name="Wizard_Step4_Title" xml:space="preserve">
+    <value>You're all set</value>
+  </data>
+  <data name="Wizard_Step4_SummaryHeading" xml:space="preserve">
+    <value>Your configuration</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Profile" xml:space="preserve">
+    <value>Profile: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_History" xml:space="preserve">
+    <value>History: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_TellTabs" xml:space="preserve">
+    <value>Tell tabs: preload {0} messages</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Visual" xml:space="preserve">
+    <value>Visual: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Unchanged" xml:space="preserve">
+    <value>(unchanged)</value>
+  </data>
+  <data name="Wizard_Step4_TestHint" xml:space="preserve">
+    <value>💡 Try it: type /tell &lt;Player Name&gt; into chat. Hellion Chat opens a dedicated tab for the conversation and preloads the last {0} messages.</value>
+  </data>
+  <data name="Wizard_Step4_SettingsHint" xml:space="preserve">
+    <value>Settings → Hellion Chat to fine-tune later</value>
+  </data>
   <data name="Export_Heading" xml:space="preserve">
     <value>Export (GDPR Art. 15 — Right of access)</value>
   </data>
@@ -289,10 +385,10 @@
     <value>How opaque the plugin windows are. Lower values let the game show through; form fields and dialogs stay fully opaque and readable on top.</value>
   </data>
   <data name="Theme_UseHellionFont_Name" xml:space="preserve">
-    <value>Use bundled Hellion font (Exo 2)</value>
+    <value>Use bundled Inter Light</value>
   </data>
   <data name="Theme_UseHellionFont_Description" xml:space="preserve">
-    <value>Renders chat and UI in Exo 2 (SIL Open Font License 1.1), which ships with the plugin. Disable to fall back to the font selected under Settings → Font.</value>
+    <value>Renders chat and UI in Inter Light (SIL Open Font License 1.1), which ships with the plugin. Disable to fall back to the font selected under Settings → Font.</value>
   </data>
 
   <data name="About_Maintainer_Heading" xml:space="preserve">
@@ -325,7 +421,7 @@
     <value>Hellion Chat is a fork of Chat 2 by Infi and Anna (ascclemens). The chat-replacement window, IPC integration, render engine, and the entire storage core all come from the original.</value>
   </data>
   <data name="About_BuiltOn_P2" xml:space="preserve">
-    <value>The web interface is the only major piece I removed. It is built for remote access to the chat from a second device — a different focus from the smaller default footprint this fork pursues. Adapting it to these defaults would have required significant rework, so removing it was the clean path for this particular fork.</value>
+    <value>The web interface is the only major piece I removed. It is built for remote access to the chat from a second device: a different focus from the smaller default footprint this fork pursues. Adapting it to these defaults would have required significant rework, so removing it was the clean path for this particular fork.</value>
   </data>
   <data name="About_BuiltOn_Upstream_Label" xml:space="preserve">
     <value>Upstream repository:</value>
@@ -393,7 +489,7 @@
     <value>Promote to permanent</value>
   </data>
   <data name="PinTab_PromoteTooltip" xml:space="preserve">
-    <value>Turns this TempTell into a regular tab. The tell binding to the partner is dropped — the tab will catch messages by its channel filters from now on. For "tab survives relog while staying bound to this partner", use Pin Tab instead.</value>
+    <value>Turns this TempTell into a regular tab. The tell binding to the partner is dropped. The tab will catch messages by its channel filters from now on. For "tab survives relog while staying bound to this partner", use Pin Tab instead.</value>
   </data>
   <data name="PinTab_PinTooltip" xml:space="preserve">
     <value>Pinned tabs survive relog and stay bound to this conversation partner.</value>
@@ -411,7 +507,7 @@
     <value>Maximum of {0} pinned tell tabs reached. Unpin one first, or use Promote to permanent.</value>
   </data>
   <data name="PinTab_PinnedTooltip" xml:space="preserve">
-    <value>Pinned — survives relog.</value>
+    <value>Pinned: survives relog.</value>
   </data>
 
   <!-- Hellion Chat — Auto-Tell-Tabs (Chat settings tab) -->
@@ -440,7 +536,7 @@
     <value>Show "Mark as greeted" button</value>
   </data>
   <data name="ChatLog_AutoTellTabs_GreetedToggle_Description" xml:space="preserve">
-    <value>Adds a click button next to each auto-tell tab to mark a conversation partner as already greeted — the tab name is then dimmed. Useful for club greeters managing many conversations in parallel. Off by default.</value>
+    <value>Adds a click button next to each auto-tell tab to mark a conversation partner as already greeted. The tab name is then dimmed. Useful for club greeters managing many conversations in parallel. Off by default.</value>
   </data>
   <data name="ChatLog_AutoTellTabs_OpenAsPopout_Name" xml:space="preserve">
     <value>Open new /tell tabs directly as pop-outs</value>
@@ -809,7 +905,7 @@
     <value>Window transparency</value>
   </data>
   <data name="Settings_ThemeAndLayout_WindowOpacity_Description" xml:space="preserve">
-    <value>How transparent the window background is. Lower values let more of the game show through. Tip: Dalamud's per-window menu (hamburger in the title bar) offers per-window overrides for opacity, background blur, click-through, and pinning — those take precedence over this slider for the respective window.</value>
+    <value>How transparent the window background is. Lower values let more of the game show through. Tip: Dalamud's per-window menu (hamburger in the title bar) offers per-window overrides for opacity, background blur, click-through, and pinning. Those take precedence over this slider for the respective window.</value>
   </data>
   <data name="Settings_FontsAndColours_Fonts_Heading" xml:space="preserve">
     <value>Fonts</value>
@@ -934,4 +1030,64 @@
   <data name="DbViewer_FullTextToggle_Hint_PhraseMode" xml:space="preserve">
     <value>Searches for the exact phrase. Multi-word queries match only when the words appear together in order. To use raw FTS5 MATCH syntax, wrap your term in double quotes yourself.</value>
   </data>
+  <data name="Settings_Language_FFXIVCoverage_Warning" xml:space="preserve">
+    <value>HellionChat renders all 24 languages, but FFXIV's chat input only fully supports EN, DE, FR and JA. Other scripts may display as garbled characters when typed into the in-game chat or sent as messages.</value>
+  </data>
+  <data name="Settings_QuickPicker_Tooltip" xml:space="preserve">
+    <value>Quick picker for themes and tabs</value>
+  </data>
+  <data name="Settings_QuickPicker_Themes_Header" xml:space="preserve">
+    <value>Themes</value>
+  </data>
+  <data name="Settings_QuickPicker_Tabs_Header" xml:space="preserve">
+    <value>Tabs</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Name" xml:space="preserve">
+    <value>Reduce motion</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Description" xml:space="preserve">
+    <value>Disables the theme crossfade, the sidebar and card-row hover animations, and the unread-tab pulse. Theme switches and hover states apply instantly instead.</value>
+  </data>
+
+  <!-- Failed-tell notification -->
+  <data name="FailedTell_Notification_Generic" xml:space="preserve">
+    <value>A tell could not be delivered.</value>
+  </data>
+  <data name="FailedTell_Notification_Named" xml:space="preserve">
+    <value>Tell to {0} could not be delivered.</value>
+  </data>
+  <data name="Settings_Chat_NotifyFailedTell_Name" xml:space="preserve">
+    <value>Notify on failed tell</value>
+  </data>
+  <data name="Settings_Chat_NotifyFailedTell_Description" xml:space="preserve">
+    <value>Show a toast when a tell you sent could not be delivered (recipient offline, in an instance, or blocking you).</value>
+  </data>
+
+  <!-- Per-tab notification sound -->
+  <data name="Tabs_NotificationSound_Enable_Name" xml:space="preserve">
+    <value>Notification sound</value>
+  </data>
+  <data name="Tabs_NotificationSound_Description" xml:space="preserve">
+    <value>Play a sound when a message arrives in this tab while you are looking at a different tab. Respects the global sound toggle.</value>
+  </data>
+  <data name="Tabs_NotificationSound_Option" xml:space="preserve">
+    <value>Sound</value>
+  </data>
+  <data name="Tabs_NotificationSound_Preview" xml:space="preserve">
+    <value>Preview the selected sound</value>
+  </data>
+  <data name="Tabs_NotificationSound_CustomOption" xml:space="preserve">
+    <value>Hellion sound</value>
+  </data>
+
+  <!-- Scroll-to-bottom and item/flag linking -->
+  <data name="ChatLog_ScrollToBottom_Tooltip" xml:space="preserve">
+    <value>Jump to the latest message</value>
+  </data>
+  <data name="ChatLog_Insert_MapFlag" xml:space="preserve">
+    <value>Insert map flag &lt;flag&gt;</value>
+  </data>
+  <data name="ChatLog_Insert_ItemLink" xml:space="preserve">
+    <value>Insert linked item &lt;item&gt;</value>
+  </data>
 </root>

HellionChat/Resources/Inter-OFL.txt

@@ -1,93 +1,93 @@
-Copyright 2013 The Exo 2 Project Authors (https://github.com/googlefonts/Exo-2.0)
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
-
+
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
+This license is copied below, and is also available with a FAQ at:
-https://openfontlicense.org
+https://openfontlicense.org
-
+
-
+
------------------------------------------------------------
+-----------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
------------------------------------------------------------
+-----------------------------------------------------------
-
+
-PREAMBLE
+PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
+The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
+development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
+efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
+open framework in which fonts may be shared and improved in partnership
-with others.
+with others.
-
+
-The OFL allows the licensed fonts to be used, studied, modified and
+The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
+redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded, 
+fonts, including any derivative works, can be bundled, embedded, 
-redistributed and/or sold with any software provided that any reserved
+redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
+names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
+however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
+requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
+to any document created using the fonts or their derivatives.
-
+
-DEFINITIONS
+DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
+"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
+Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
+include source files, build scripts and documentation.
-
+
-"Reserved Font Name" refers to any names specified as such after the
+"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
+copyright statement(s).
-
+
-"Original Version" refers to the collection of Font Software components as
+"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
+distributed by the Copyright Holder(s).
-
+
-"Modified Version" refers to any derivative made by adding to, deleting,
+"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting -- in part or in whole -- any of the components of the
+or substituting -- in part or in whole -- any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
+Original Version, by changing formats or by porting the Font Software to a
-new environment.
+new environment.
-
+
-"Author" refers to any designer, engineer, programmer, technical
+"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
+writer or other person who contributed to the Font Software.
-
+
-PERMISSION & CONDITIONS
+PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
+Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
+redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
+Software, subject to the following conditions:
-
+
-1) Neither the Font Software nor any of its individual components,
+1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
+in Original or Modified Versions, may be sold by itself.
-
+
-2) Original or Modified Versions of the Font Software may be bundled,
+2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
+redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
+contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
+included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
+in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
+binary files as long as those fields can be easily viewed by the user.
-
+
-3) No Modified Version of the Font Software may use the Reserved Font
+3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
+Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
+Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
+presented to the users.
-
+
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
+Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
+Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
+Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
+permission.
-
+
-5) The Font Software, modified or unmodified, in part or in whole,
+5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
+must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
+distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
+remain under this license does not apply to any document created
-using the Font Software.
+using the Font Software.
-
+
-TERMINATION
+TERMINATION
-This license becomes null and void if any of the above conditions are
+This license becomes null and void if any of the above conditions are
-not met.
+not met.
-
+
-DISCLAIMER
+DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.
+OTHER DEALINGS IN THE FONT SOFTWARE.

HellionChat/Resources/Language.Designer.cs

@@ -1859,7 +1859,25 @@ namespace HellionChat.Resources {
                 return ResourceManager.GetString("ExtraGlyphRanges_Vietnamese_Name", resourceCulture);
             }
         }
-        
+
+        /// <summary>
+        ///   Looks up a localized string similar to Latin Extended.
+        /// </summary>
+        internal static string ExtraGlyphRanges_LatinExtended_Name {
+            get {
+                return ResourceManager.GetString("ExtraGlyphRanges_LatinExtended_Name", resourceCulture);
+            }
+        }
+
+        /// <summary>
+        ///   Looks up a localized string similar to Greek.
+        /// </summary>
+        internal static string ExtraGlyphRanges_Greek_Name {
+            get {
+                return ResourceManager.GetString("ExtraGlyphRanges_Greek_Name", resourceCulture);
+            }
+        }
+
         /// <summary>
         ///   Looks up a localized string similar to Pick a folder location for export..
         /// </summary>

HellionChat/Resources/Language.ca.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Tenyeix el selector de canal amb el color del canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>El botó selector de canal al costat del camp d'entrada es tenyeix amb el color del canal actiu. Coincideix amb la tonalitat del text d'entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Amaga mentre el menú New Game+ estigui obert</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Amaga el xat mentre el menú New Game+ estigui obert. En tancar el menú, el xat torna a aparèixer.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Llatí estès</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grec</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.de.resx

@@ -1,4 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
+<!--
+  Language.de.resx — Hellion Forge maintainer-extended translation
+
+  Locale:      de (German)
+  Maintainer:  Hellion Forge / Hellion Online Media
+  Status:      Native-speaker maintained
+  Review:      Continuous (native maintainer)
+
+  Hellion Forge maintains this file with native-speaker quality,
+  including the keys post-dating the last upstream Chat 2 Crowdin sync.
+
+  Corrections welcome via the Hellion Forge Discord:
+  https://discord.gg/X9V7Kcv5gR
+-->
 <root>
   <!--
       Microsoft ResX Schema
@@ -1481,4 +1495,10 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latein erweitert</value>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Griechisch</value>
+  </data>
 </root>

HellionChat/Resources/Language.es.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Teñir el selector de canal con el color del canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>El botón selector de canal junto al campo de entrada se tiñe con el color del canal activo. Coincide con el tinte del texto de entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ocultar mientras el menú New Game+ esté abierto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Oculta el chat mientras el menú New Game+ esté abierto. Al cerrar el menú, el chat se muestra de nuevo.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latín extendido</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Griego</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.fr.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Teinter le sélecteur de canal avec la couleur du canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Le bouton sélecteur de canal à côté du champ de saisie est teinté avec la couleur du canal actif. Correspond à la teinte du texte de saisie.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Masquer pendant que le menu New Game+ est ouvert</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Masque le chat pendant que le menu New Game+ est ouvert. Fermer le menu réaffiche le chat.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latin étendu</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grec</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.it.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colora il selettore di canale con il colore del canale</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Il pulsante selettore di canale accanto al campo di input viene colorato con il colore del canale attivo. Corrisponde alla colorazione del testo di input.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Nascondi mentre il menu New Game+ è aperto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Nasconde la chat mentre il menu New Game+ è aperto. Chiudendo il menu, la chat riappare.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latino esteso</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greco</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.ja.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>チャンネルセレクターをチャンネル色で着色する</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>入力フィールドの隣のチャンネルセレクターボタンが、現在アクティブなチャンネルの色で着色されます。入力テキスト自体の色合いと一致します。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>ニューゲーム+メニューが開いている間は非表示</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>ニューゲーム+メニューが開いている間、チャットを非表示にします。メニューを閉じるとチャットが再表示されます。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拡張ラテン</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>ギリシャ語</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.ko.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>채널 선택기를 채널 색상으로 채색</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>입력 필드 옆의 채널 선택기 버튼이 현재 활성 채널 색상으로 채색됩니다. 입력 텍스트 자체의 색조와 일치합니다.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>뉴게임+ 메뉴가 열려 있는 동안 숨김</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>뉴게임+ 메뉴가 열려 있는 동안 채팅을 숨깁니다. 메뉴를 닫으면 채팅이 다시 표시됩니다.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>확장 라틴</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>그리스어</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.nl.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Kanaalkiezer kleuren met kanaalkleur</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>De kanaalkiezerknop naast het invoerveld krijgt de kleur van het actieve kanaal. Komt overeen met de tint van de invoertekst zelf.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Verbergen terwijl het New Game+ menu open is</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Verberg de chat terwijl het New Game+ menu open is. Het sluiten van het menu toont de chat weer.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latijn uitgebreid</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grieks</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.pt-BR.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colorir o seletor de canal com a cor do canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>O botão seletor de canal ao lado do campo de entrada é colorido com a cor do canal ativo. Combina com a coloração do próprio texto de entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ocultar enquanto o menu New Game+ estiver aberto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Oculta o chat enquanto o menu New Game+ estiver aberto. Fechar o menu mostra o chat novamente.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latim estendido</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grego</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.resx

@@ -1478,4 +1478,10 @@ Your old database can still be recovered, please contact the plugin author for h
     <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latin Extended</value>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greek</value>
+  </data>
 </root>

HellionChat/Resources/Language.ro.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colorează selectorul de canal cu culoarea canalului</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Butonul selector de canal de lângă câmpul de intrare este colorat cu culoarea canalului activ. Se potrivește cu nuanța textului de intrare.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ascunde cât timp meniul New Game+ este deschis</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Ascunde chatul cât timp meniul New Game+ este deschis. Închiderea meniului afișează chatul din nou.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latină extinsă</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greacă</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.ru.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Окрашивать кнопку выбора канала в цвет канала</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Кнопка выбора канала рядом с полем ввода окрашивается в цвет активного канала. Совпадает с окраской самого текста ввода.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Скрывать, пока открыто меню New Game+</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Скрывать чат, пока открыто меню New Game+. При закрытии меню чат снова отображается.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Расширенная латиница</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Греческий</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.sv.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Färga kanalväljaren med kanalens färg</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Kanalväljarknappen bredvid inmatningsfältet färgas med den aktiva kanalens färg. Matchar färgningen av själva inmatningstexten.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Dölj medan New Game+ menyn är öppen</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Dölj chatten medan New Game+ menyn är öppen. När menyn stängs visas chatten igen.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Utökat latin</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grekiska</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.zh-Hans.resx

@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>用频道颜色为频道选择器染色</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>输入框旁边的频道选择器按钮将以当前活动频道的颜色着色。与输入文本本身的着色相匹配。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>在新游戏+菜单打开时隐藏</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>在新游戏+菜单打开时隐藏聊天。关闭菜单时聊天会再次显示。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拉丁文扩展</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>希腊语</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/Resources/Language.zh-Hant.resx

@@ -1467,4 +1467,28 @@ Your old database can still be recovered, please contact the plugin author for h
   <data name="ChatExport_Initial" xml:space="preserve">
         <value>Loading logs ...</value>
     </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>用頻道顏色為頻道選擇器染色</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>輸入框旁邊的頻道選擇器按鈕將以當前活動頻道的顏色著色。與輸入文字本身的著色相匹配。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>在新遊戲+選單開啟時隱藏</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>在新遊戲+選單開啟時隱藏聊天。關閉選單時聊天會再次顯示。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拉丁文擴展</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>希臘文</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>

HellionChat/SelfTests/FoxBannerTextureSmokeStep.cs

@@ -0,0 +1,47 @@
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Branding;
+
+namespace HellionChat.SelfTests;
+
+// Verifies the embedded fox-banner PNG decodes into a usable texture. The load
+// is async, so the step returns Waiting until Dalamud finishes the decode and
+// the self-test runner re-polls. A decode or resource error is a build defect
+// and fails the step hard. The resource lives in the DLL, it cannot be a
+// runtime miss.
+internal sealed class FoxBannerTextureSmokeStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    public FoxBannerTextureSmokeStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - Fox banner texture smoke";
+
+    public SelfTestStepResult RunStep()
+    {
+        if (!FoxBannerTexture.Shared.TryGetWrap(out var wrap, out var ex))
+        {
+            if (ex is not null)
+            {
+                ImGui.Text($"Fox banner load failed: {ex.Message}");
+                return SelfTestStepResult.Fail;
+            }
+
+            ImGui.Text("Fox banner still loading...");
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (wrap.Size.X <= 0 || wrap.Size.Y <= 0)
+        {
+            ImGui.Text($"Fox banner has degenerate size {wrap.Size}");
+            return SelfTestStepResult.Fail;
+        }
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp() { }
+}

HellionChat/SelfTests/QuickPickerSelfTestStep.cs

@@ -0,0 +1,64 @@
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Resources;
+
+namespace HellionChat.SelfTests;
+
+// Verifies the v1.5.4 PM-2 quick-picker plumbing without rendering:
+// resource strings resolve, the theme registry yields the expected
+// minimum built-in count, and Config.Tabs is populated.
+internal sealed class QuickPickerSelfTestStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    public QuickPickerSelfTestStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - Quick picker plumbing";
+
+    public SelfTestStepResult RunStep()
+    {
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Tooltip))
+        {
+            ImGui.Text("Settings_QuickPicker_Tooltip is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Themes_Header))
+        {
+            ImGui.Text("Settings_QuickPicker_Themes_Header is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Tabs_Header))
+        {
+            ImGui.Text("Settings_QuickPicker_Tabs_Header is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is null)
+        {
+            ImGui.Text("ThemeRegistry not resolved.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var builtIns = registry.AllBuiltIns().ToList();
+        if (builtIns.Count < 10)
+        {
+            ImGui.Text($"Expected at least 10 built-in themes, found {builtIns.Count}.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var tabs = Plugin.Config.Tabs;
+        if (tabs is null || tabs.Count == 0)
+        {
+            ImGui.Text("Config.Tabs is empty.");
+            return SelfTestStepResult.Fail;
+        }
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp() { }
+}

HellionChat/SelfTests/ThemeCrossfadeSelfTestStep.cs

@@ -0,0 +1,216 @@
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Themes;
+
+namespace HellionChat.SelfTests;
+
+// Verifies the v1.5.4 PM-1 crossfade contract: switching the active
+// theme arms TryGetActiveCrossfade for ~300ms, then the registry
+// returns to direct AbgrCache reads. A second switch within 100ms
+// keeps the lerped path active (no identity-snap). CleanUp restores
+// the initial theme so /xlperf stays idempotent.
+internal sealed class ThemeCrossfadeSelfTestStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    private string? initialSlug;
+    private string? targetSlug;
+    private string? midSwitchSlug;
+    private long armedAtTickMs = long.MinValue;
+    private long midArmedAtTickMs = long.MinValue;
+    private bool sawCrossfade;
+    private bool sawMidCrossfadeSwitch;
+    private bool sawCrossfadeEnd;
+    private bool restoredInitial;
+
+    public ThemeCrossfadeSelfTestStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - Theme crossfade";
+
+    public SelfTestStepResult RunStep()
+    {
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is null)
+            return SelfTestStepResult.Fail;
+
+        if (this.initialSlug is null)
+        {
+            this.initialSlug = registry.Active.Slug;
+            this.targetSlug = PickDifferentSlug(registry, this.initialSlug);
+            if (this.targetSlug is null)
+            {
+                ImGui.Text("Need at least two themes available; only one built-in found.");
+                return SelfTestStepResult.Fail;
+            }
+
+            registry.Switch(this.targetSlug);
+            this.armedAtTickMs = Environment.TickCount64;
+            ImGui.Text($"Crossfade armed: {this.initialSlug} -> {this.targetSlug}");
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawCrossfade)
+        {
+            if (registry.TryGetActiveCrossfade(out _))
+            {
+                this.sawCrossfade = true;
+                this.midArmedAtTickMs = Environment.TickCount64;
+                ImGui.Text("Crossfade observed mid-window, arming mid-switch test...");
+                return SelfTestStepResult.Waiting;
+            }
+
+            // If the window already closed before we observed it, that
+            // is acceptable only on extremely slow frame paths; accept
+            // it as "saw the start" if more than 300ms have elapsed.
+            // Skip the mid-crossfade-switch phase in that case -- the
+            // lerped path is no longer active, so a second switch would
+            // re-arm a fresh crossfade and not exercise PM-1b's
+            // mid-flight-origin override.
+            if (Environment.TickCount64 - this.armedAtTickMs > 300)
+            {
+                this.sawCrossfade = true;
+                this.sawMidCrossfadeSwitch = true;
+                this.sawCrossfadeEnd = true;
+                ImGui.Text("Crossfade window closed before observation; accepting.");
+                return SelfTestStepResult.Waiting;
+            }
+
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawMidCrossfadeSwitch)
+        {
+            // PM-Test-3 mid-crossfade-switch phase: within ~100ms of the
+            // first observed crossfade, fire a second Switch to a THIRD
+            // theme. ArmCrossfade must compose the current lerped state
+            // as the new origin -- TryGetActiveCrossfade still returns
+            // true (lerped path stays active, no identity-snap) and the
+            // lerped value is neither the identity-from nor the
+            // identity-to of the new switch (origin shifted to the
+            // mid-flight cache, target is the third theme).
+            if (Environment.TickCount64 - this.midArmedAtTickMs < 100)
+            {
+                this.midSwitchSlug = PickDifferentSlug(
+                    registry,
+                    [this.initialSlug!, this.targetSlug!]
+                );
+                if (this.midSwitchSlug is null)
+                {
+                    // Only two themes available -- mid-switch phase cannot
+                    // exercise the lerped-origin path. Accept and move on
+                    // (the v1.5.3 baseline ships >=10 built-ins, so this
+                    // branch is defensive).
+                    this.sawMidCrossfadeSwitch = true;
+                    ImGui.Text("Only two themes available; skipping mid-switch assert.");
+                    return SelfTestStepResult.Waiting;
+                }
+
+                var fromCache = registry.Active.AbgrCache;
+                registry.Switch(this.midSwitchSlug);
+                var toCache = registry.Active.AbgrCache;
+
+                if (!registry.TryGetActiveCrossfade(out var midLerped))
+                {
+                    ImGui.Text("Mid-switch failed: TryGetActiveCrossfade returned false.");
+                    return SelfTestStepResult.Fail;
+                }
+
+                // Lerped value must be neither the new identity-from
+                // (target cache of the first switch) nor the new
+                // identity-to (third theme cache) -- it must originate
+                // from the mid-flight composed snapshot.
+                if (midLerped.Equals(fromCache) || midLerped.Equals(toCache))
+                {
+                    ImGui.Text("Mid-switch failed: lerped value is an identity snap.");
+                    return SelfTestStepResult.Fail;
+                }
+
+                this.sawMidCrossfadeSwitch = true;
+                ImGui.Text(
+                    $"Mid-switch armed: {this.targetSlug} -> {this.midSwitchSlug} (lerped origin)."
+                );
+                return SelfTestStepResult.Waiting;
+            }
+
+            // Window for mid-switch already elapsed; accept and continue.
+            this.sawMidCrossfadeSwitch = true;
+            ImGui.Text("Mid-switch window elapsed before fire; accepting.");
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawCrossfadeEnd)
+        {
+            if (!registry.TryGetActiveCrossfade(out _))
+            {
+                this.sawCrossfadeEnd = true;
+                ImGui.Text("Crossfade window closed cleanly.");
+                return SelfTestStepResult.Waiting;
+            }
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.restoredInitial)
+        {
+            registry.Switch(this.initialSlug);
+            this.restoredInitial = true;
+            ImGui.Text($"Restored: {this.initialSlug}");
+            return SelfTestStepResult.Waiting;
+        }
+
+        // Wait for the restore-crossfade to also conclude before
+        // declaring Pass, so /xlperf does not flicker out mid-fade.
+        if (registry.TryGetActiveCrossfade(out _))
+            return SelfTestStepResult.Waiting;
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp()
+    {
+        // Best-effort: if anything went sideways, snap back to the
+        // initial slug. Switch is idempotent on same-slug.
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is not null && this.initialSlug is not null)
+        {
+            registry.Switch(this.initialSlug);
+        }
+
+        this.initialSlug = null;
+        this.targetSlug = null;
+        this.midSwitchSlug = null;
+        this.armedAtTickMs = long.MinValue;
+        this.midArmedAtTickMs = long.MinValue;
+        this.sawCrossfade = false;
+        this.sawMidCrossfadeSwitch = false;
+        this.sawCrossfadeEnd = false;
+        this.restoredInitial = false;
+    }
+
+    private static string? PickDifferentSlug(ThemeRegistry registry, string activeSlug) =>
+        PickDifferentSlug(registry, [activeSlug]);
+
+    private static string? PickDifferentSlug(
+        ThemeRegistry registry,
+        IReadOnlyCollection<string> excludeSlugs
+    )
+    {
+        foreach (var theme in registry.AllBuiltIns())
+        {
+            var match = false;
+            foreach (var excluded in excludeSlugs)
+            {
+                if (string.Equals(theme.Slug, excluded, StringComparison.OrdinalIgnoreCase))
+                {
+                    match = true;
+                    break;
+                }
+            }
+            if (!match)
+                return theme.Slug;
+        }
+        return null;
+    }
+}

HellionChat/SelfTests/WizardStateSmokeStep.cs

@@ -0,0 +1,135 @@
+using System.Collections.Generic;
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Code;
+using HellionChat.Ui;
+
+namespace HellionChat.SelfTests;
+
+// Drives the FirstRunWizard state machine through every step and
+// commits a no-op pending state (Variant 1), then re-runs picking
+// Roleplay on Step 2 and skipping Step 3 (Variant 2). Verifies
+// that the staged-commit path does not throw under any combination
+// of Pending* values and that CommitPending leaves Config in a
+// readable shape. Variant 2's Roleplay commit would normally
+// mutate the six PrivacyFilter / Retention fields ApplyRoleplay
+// touches, so the step snapshots them before Variant 2 runs and
+// CleanUp() restores them — the self-test stays idempotent across
+// repeated /xlperf runs and does not overwrite an active privacy
+// profile.
+internal sealed class WizardStateSmokeStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    // Snapshot slots for the six Configuration fields ApplyRoleplay
+    // writes in Variant 2. Populated right before Variant 2 mutates
+    // Config, consumed by CleanUp(). Reference-typed snapshots
+    // (HashSet, Dictionary) capture the existing slot by reference,
+    // which is safe because ApplyRoleplay reassigns the slot with
+    // a fresh instance instead of mutating in place.
+    private bool? snapshotPrivacyFilterEnabled;
+    private HashSet<ChatType>? snapshotPrivacyPersistChannels;
+    private bool? snapshotPrivacyPersistUnknownChannels;
+    private bool? snapshotRetentionEnabled;
+    private int? snapshotRetentionDefaultDays;
+    private Dictionary<ChatType, int>? snapshotRetentionPerChannelDays;
+
+    public WizardStateSmokeStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - FirstRunWizard state smoke";
+
+    public SelfTestStepResult RunStep()
+    {
+        var wizard = this.plugin.FirstRunWizard;
+        if (wizard is null)
+        {
+            ImGui.Text("Plugin.FirstRunWizard is null");
+            return SelfTestStepResult.Fail;
+        }
+
+        try
+        {
+            // Variant 1: no-op CommitPending. Walks the state machine and
+            // verifies the empty-pending write-back path does not throw.
+            wizard.TestOnly_AdvanceTo(1);
+            wizard.TestOnly_AdvanceTo(2);
+            wizard.TestOnly_AdvanceTo(3);
+            wizard.TestOnly_AdvanceTo(4);
+            wizard.CommitPending();
+
+            // Variant 2: skip Step 3 explicitly. Picks Roleplay on Step 2,
+            // jumps straight to Step 4 (no Step-3 entry → no seed for
+            // LoadPreviousSession / FilterIncludePreviousSessions), commits,
+            // and asserts the two coupled history toggles remained on their
+            // pre-test value. Pins the null-semantics from Spec Z.176 so a
+            // regression in CommitPending that started writing seeded
+            // recommendations unconditionally would surface here.
+            // CommitPending → ApplyRoleplay overwrites six privacy /
+            // retention fields, so snapshot them first and let CleanUp
+            // restore them after the assert. Keeps /xlperf idempotent.
+            this.snapshotPrivacyFilterEnabled = Plugin.Config.PrivacyFilterEnabled;
+            this.snapshotPrivacyPersistChannels = Plugin.Config.PrivacyPersistChannels;
+            this.snapshotPrivacyPersistUnknownChannels = Plugin
+                .Config
+                .PrivacyPersistUnknownChannels;
+            this.snapshotRetentionEnabled = Plugin.Config.RetentionEnabled;
+            this.snapshotRetentionDefaultDays = Plugin.Config.RetentionDefaultDays;
+            this.snapshotRetentionPerChannelDays = Plugin.Config.RetentionPerChannelDays;
+
+            var loadPrevBefore = Plugin.Config.LoadPreviousSession;
+            var filterPrevBefore = Plugin.Config.FilterIncludePreviousSessions;
+            wizard.TestOnly_AdvanceTo(2);
+            wizard.TestOnly_SetPendingProfile(FirstRunWizard.PrivacyProfile.Roleplay);
+            wizard.TestOnly_AdvanceTo(4);
+            wizard.CommitPending();
+            if (Plugin.Config.LoadPreviousSession != loadPrevBefore)
+            {
+                ImGui.Text("Skip-Step-3 path overwrote LoadPreviousSession");
+                return SelfTestStepResult.Fail;
+            }
+            if (Plugin.Config.FilterIncludePreviousSessions != filterPrevBefore)
+            {
+                ImGui.Text("Skip-Step-3 path overwrote FilterIncludePreviousSessions");
+                return SelfTestStepResult.Fail;
+            }
+        }
+        catch (Exception ex)
+        {
+            ImGui.Text($"Wizard state smoke threw: {ex.GetType().Name}: {ex.Message}");
+            return SelfTestStepResult.Fail;
+        }
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp()
+    {
+        // Restore the six Variant-2 snapshots so back-to-back /xlperf
+        // runs don't drift the active privacy profile. If Variant 2
+        // never ran (Variant 1 threw early), the slots stay null and
+        // restore is a no-op. After restore the slots are nulled so a
+        // future RunStep starts fresh.
+        if (this.snapshotPrivacyFilterEnabled is { } privacyFilter)
+            Plugin.Config.PrivacyFilterEnabled = privacyFilter;
+        if (this.snapshotPrivacyPersistChannels is { } persistChannels)
+            Plugin.Config.PrivacyPersistChannels = persistChannels;
+        if (this.snapshotPrivacyPersistUnknownChannels is { } persistUnknown)
+            Plugin.Config.PrivacyPersistUnknownChannels = persistUnknown;
+        if (this.snapshotRetentionEnabled is { } retentionEnabled)
+            Plugin.Config.RetentionEnabled = retentionEnabled;
+        if (this.snapshotRetentionDefaultDays is { } retentionDays)
+            Plugin.Config.RetentionDefaultDays = retentionDays;
+        if (this.snapshotRetentionPerChannelDays is { } retentionPolicy)
+            Plugin.Config.RetentionPerChannelDays = retentionPolicy;
+
+        this.snapshotPrivacyFilterEnabled = null;
+        this.snapshotPrivacyPersistChannels = null;
+        this.snapshotPrivacyPersistUnknownChannels = null;
+        this.snapshotRetentionEnabled = null;
+        this.snapshotRetentionDefaultDays = null;
+        this.snapshotRetentionPerChannelDays = null;
+    }
+}

HellionChat/Themes/ThemeAbgrCacheLerp.cs

@@ -0,0 +1,61 @@
+namespace HellionChat.Themes;
+
+// Per-slot ABGR byte-lerp between two ThemeAbgrCache value-records.
+// Pattern anchor: imgui.cpp:2820-2828 ImAlphaBlendColors -- decompose
+// each byte, lerp via Math.Round, recompose. Stack-allocated output
+// (readonly record struct), no heap pressure inside the crossfade
+// window. t is clamped to [0, 1] so float drift cannot overshoot.
+internal static class ThemeAbgrCacheLerp
+{
+    public static ThemeAbgrCache Lerp(ThemeAbgrCache from, ThemeAbgrCache to, float t)
+    {
+        t = Math.Clamp(t, 0f, 1f);
+
+        return new ThemeAbgrCache(
+            PrimaryDark: LerpAbgr(from.PrimaryDark, to.PrimaryDark, t),
+            Primary: LerpAbgr(from.Primary, to.Primary, t),
+            PrimaryLight: LerpAbgr(from.PrimaryLight, to.PrimaryLight, t),
+            PrimaryGlow: LerpAbgr(from.PrimaryGlow, to.PrimaryGlow, t),
+            AccentDark: LerpAbgr(from.AccentDark, to.AccentDark, t),
+            Accent: LerpAbgr(from.Accent, to.Accent, t),
+            AccentLight: LerpAbgr(from.AccentLight, to.AccentLight, t),
+            Identity: LerpAbgr(from.Identity, to.Identity, t),
+            WindowBg: LerpAbgr(from.WindowBg, to.WindowBg, t),
+            ChildBg: LerpAbgr(from.ChildBg, to.ChildBg, t),
+            FrameBg: LerpAbgr(from.FrameBg, to.FrameBg, t),
+            Surface: LerpAbgr(from.Surface, to.Surface, t),
+            SurfaceHover: LerpAbgr(from.SurfaceHover, to.SurfaceHover, t),
+            Border: LerpAbgr(from.Border, to.Border, t),
+            TextPrimary: LerpAbgr(from.TextPrimary, to.TextPrimary, t),
+            TextMuted: LerpAbgr(from.TextMuted, to.TextMuted, t),
+            TextDim: LerpAbgr(from.TextDim, to.TextDim, t),
+            StatusSuccess: LerpAbgr(from.StatusSuccess, to.StatusSuccess, t),
+            StatusDanger: LerpAbgr(from.StatusDanger, to.StatusDanger, t),
+            StatusWarning: LerpAbgr(from.StatusWarning, to.StatusWarning, t),
+            StatusInfo: LerpAbgr(from.StatusInfo, to.StatusInfo, t)
+        );
+    }
+
+    private static uint LerpAbgr(uint from, uint to, float t)
+    {
+        var ra = (byte)(from & 0xFFu);
+        var ga = (byte)((from >> 8) & 0xFFu);
+        var ba = (byte)((from >> 16) & 0xFFu);
+        var aa = (byte)((from >> 24) & 0xFFu);
+
+        var rb = (byte)(to & 0xFFu);
+        var gb = (byte)((to >> 8) & 0xFFu);
+        var bb = (byte)((to >> 16) & 0xFFu);
+        var ab = (byte)((to >> 24) & 0xFFu);
+
+        // Math.Round (default ToEven) matches ColourUtil.ApplyAlpha so a
+        // crossfade-into-hover transition does not produce a one-byte
+        // jump at the midpoint between the two paths.
+        var r = (byte)Math.Round(ra + (rb - ra) * t);
+        var g = (byte)Math.Round(ga + (gb - ga) * t);
+        var b = (byte)Math.Round(ba + (bb - ba) * t);
+        var a = (byte)Math.Round(aa + (ab - aa) * t);
+
+        return ((uint)a << 24) | ((uint)b << 16) | ((uint)g << 8) | r;
+    }
+}

HellionChat/Themes/ThemeRegistry.cs

@@ -32,6 +32,16 @@ public sealed class ThemeRegistry
     private long _lastActiveStampCheckMs = -ActiveStampPollIntervalMs;
     private DateTime _lastActiveStamp = DateTime.MinValue;
 
+    // PM-1 crossfade state. Switch() captures the previous AbgrCache as a
+    // VALUE-COPY (not a Theme reference) -- the built-in singletons share
+    // their RecomputeAbgrCache identity, so a reference would mutate
+    // alongside the new active. _crossfadeStartTickMs == long.MinValue
+    // means "no crossfade armed yet"; the field stays MinValue after
+    // SwitchSilent so the plugin-load init-path does not trigger a fade.
+    private ThemeAbgrCache? _previousAbgrSnapshot;
+    private long _crossfadeStartTickMs = long.MinValue;
+    private const int CrossfadeDurationMs = 300;
+
     public ThemeRegistry(string? customThemesDir = null, ILogger<ThemeRegistry>? logger = null)
     {
         _logger = logger;
@@ -87,6 +97,13 @@ public sealed class ThemeRegistry
     // a state where _active and Get(_active.Slug) disagree.
     public void Switch(string slug)
     {
+        // Same-slug switch is a no-op -- avoids a 300ms identity-crossfade
+        // when the user re-selects the active theme in the picker.
+        if (string.Equals(_active.Slug, slug, StringComparison.OrdinalIgnoreCase))
+            return;
+
+        ArmCrossfade();
+
         if (_builtIns.TryGetValue(slug, out var builtin))
         {
             _active = builtin;
@@ -115,6 +132,84 @@ public sealed class ThemeRegistry
         _activeCustomPath = null;
     }
 
+    // SwitchSilent is the plugin-load init path -- identical to Switch
+    // but does NOT arm the crossfade state. Called from
+    // ThemeRegistryInitHostedService.StartAsync so opening the plugin
+    // does not produce a 300ms fade from the default theme to the user's
+    // saved theme.
+    public void SwitchSilent(string slug)
+    {
+        if (string.Equals(_active.Slug, slug, StringComparison.OrdinalIgnoreCase))
+            return;
+
+        if (_builtIns.TryGetValue(slug, out var builtin))
+        {
+            _active = builtin;
+            _active.RecomputeAbgrCache();
+            _activeCustomPath = null;
+            return;
+        }
+
+        var customTheme = LoadCustomBySlug(slug, out var customPath);
+        if (customTheme is not null)
+        {
+            _active = customTheme;
+            _active.RecomputeAbgrCache();
+            _activeCustomPath = customPath;
+            _lastActiveStamp = DateTime.MinValue;
+            return;
+        }
+
+        _active = _builtIns[DefaultSlug];
+        _active.RecomputeAbgrCache();
+        _activeCustomPath = null;
+    }
+
+    // Captures the AbgrCache snapshot that PushGlobal should fade FROM.
+    // If a crossfade is already mid-flight (second Switch within 300ms),
+    // the current lerped state replaces the snapshot -- the next fade
+    // starts from where we currently are, not from the original "from".
+    private void ArmCrossfade()
+    {
+        var now = Environment.TickCount64;
+        ThemeAbgrCache snapshot;
+        if (
+            _previousAbgrSnapshot.HasValue
+            && _crossfadeStartTickMs != long.MinValue
+            && now - _crossfadeStartTickMs < CrossfadeDurationMs
+        )
+        {
+            var t = (float)(now - _crossfadeStartTickMs) / CrossfadeDurationMs;
+            snapshot = ThemeAbgrCacheLerp.Lerp(_previousAbgrSnapshot.Value, _active.AbgrCache, t);
+        }
+        else
+        {
+            snapshot = _active.AbgrCache;
+        }
+
+        _previousAbgrSnapshot = snapshot;
+        _crossfadeStartTickMs = now;
+    }
+
+    // Returns the lerped AbgrCache while the crossfade is active.
+    // PushGlobal reads this once per frame; outside the 300ms window
+    // it short-circuits via the TickCount64 delta so the per-frame
+    // overhead is a couple of integer comparisons.
+    public bool TryGetActiveCrossfade(out ThemeAbgrCache lerped)
+    {
+        lerped = default;
+        if (_crossfadeStartTickMs == long.MinValue || !_previousAbgrSnapshot.HasValue)
+            return false;
+
+        var elapsed = Environment.TickCount64 - _crossfadeStartTickMs;
+        if (elapsed >= CrossfadeDurationMs)
+            return false;
+
+        var t = (float)elapsed / CrossfadeDurationMs;
+        lerped = ThemeAbgrCacheLerp.Lerp(_previousAbgrSnapshot.Value, _active.AbgrCache, t);
+        return true;
+    }
+
     // 1Hz-throttled disk-stat on the currently active custom theme file.
     // When the file's LastWriteTime moves forward (editor save), reload the
     // theme via Get() so the user sees the edit immediately without

HellionChat/Ui/ChatLogWindow.cs

@@ -14,6 +14,7 @@ using Dalamud.Interface.Utility.Raii;
 using Dalamud.Interface.Windowing;
 using Dalamud.Memory;
 using FFXIVClientStructs.FFXIV.Client.UI;
+using FFXIVClientStructs.FFXIV.Client.UI.Agent;
 using HellionChat.Code;
 using HellionChat.GameFunctions;
 using HellionChat.GameFunctions.Types;
@@ -472,6 +473,105 @@ public sealed class ChatLogWindow : Window
         ChangeTab(newIndex);
     }
 
+    // PM-2b v1.5.4 header quick-picker. Two scrollable sections -- every
+    // built-in plus custom theme, and every tab. Clicking a theme arms
+    // the PM-1 crossfade via ThemeRegistry.Switch; clicking a tab routes
+    // through ChangeTab so LastActivityTime stays consistent with the
+    // sidebar and top-bar click paths. DontClosePopups keeps the popup
+    // open so the user can hop between entries without re-opening it.
+    private void DrawQuickPickerPopup()
+    {
+        using var popup = ImRaii.Popup("##hellion-quick-picker");
+        if (!popup.Success)
+            return;
+
+        ImGui.TextUnformatted(HellionStrings.Settings_QuickPicker_Themes_Header);
+        ImGui.Separator();
+
+        var activeSlug = Plugin.ThemeRegistry.Active.Slug;
+        var allThemes = Plugin
+            .ThemeRegistry.AllBuiltIns()
+            .Concat(Plugin.ThemeRegistry.AllCustom())
+            .ToList();
+
+        using (
+            var scroll = ImRaii.Child(
+                "##hellion-quick-picker-themes",
+                new Vector2(220f, Math.Min(allThemes.Count * 22f, 200f))
+            )
+        )
+        {
+            if (scroll.Success)
+            {
+                foreach (var theme in allThemes)
+                {
+                    var isActive = string.Equals(
+                        theme.Slug,
+                        activeSlug,
+                        StringComparison.OrdinalIgnoreCase
+                    );
+                    DrawQuickPickerGlyph(isActive);
+                    if (
+                        ImGui.Selectable(
+                            $"{theme.Name}##quick-theme-{theme.Slug}",
+                            isActive,
+                            ImGuiSelectableFlags.DontClosePopups
+                        ) && !isActive
+                    )
+                        Plugin.ThemeRegistry.Switch(theme.Slug);
+                }
+            }
+        }
+
+        ImGui.Spacing();
+        ImGui.TextUnformatted(HellionStrings.Settings_QuickPicker_Tabs_Header);
+        ImGui.Separator();
+
+        var tabs = Plugin.Config.Tabs;
+        var activeTabIndex = Plugin.LastTab;
+        using (
+            var scroll = ImRaii.Child(
+                "##hellion-quick-picker-tabs",
+                new Vector2(220f, Math.Min(tabs.Count * 22f, 200f))
+            )
+        )
+        {
+            if (scroll.Success)
+            {
+                for (var i = 0; i < tabs.Count; i++)
+                {
+                    var isActive = i == activeTabIndex;
+                    DrawQuickPickerGlyph(isActive);
+                    if (
+                        ImGui.Selectable(
+                            $"{tabs[i].Name}##quick-tab-{i}",
+                            isActive,
+                            ImGuiSelectableFlags.DontClosePopups
+                        ) && !isActive
+                    )
+                        ChangeTab(i);
+                }
+            }
+        }
+    }
+
+    // Leading check-glyph slot for a quick-picker row. Active rows get a
+    // FontAwesome check; inactive rows get a same-width blank so the
+    // labels stay aligned. The glyph font push stays on its own line so
+    // it never bleeds into the body-font Selectable label.
+    private void DrawQuickPickerGlyph(bool isActive)
+    {
+        using (Plugin.FontManager.FontAwesome.Push())
+        {
+            var check = FontAwesomeIcon.Check.ToIconString();
+            if (isActive)
+                ImGui.TextUnformatted(check);
+            else
+                ImGui.Dummy(new Vector2(ImGui.CalcTextSize(check).X, ImGui.GetTextLineHeight()));
+        }
+        ImGui.SameLine();
+    }
+
     private void TabSwitched(Tab newTab, Tab previousTab)
     {
         // Use the fixed channel if set by the user. Otherwise, if the new tab
@@ -677,6 +777,14 @@ public sealed class ChatLogWindow : Window
     // (~17ms at 60fps) late, invisible inside the post-reload Atlas-Build.
     private bool _firstFrameDone;
 
+    // Set when the user clicks the scroll-to-bottom button; the next
+    // frame's scroll-snap check forces a jump to the live end.
+    private bool _scrollToBottomRequested;
+
+    // Cached each frame inside the ##chat2-messages child. True when the
+    // user has scrolled up enough that the toolbar button should be shown.
+    private bool _childScrolledUp;
+
     public override void Draw()
     {
         DrewThisFrame = true;
@@ -903,7 +1011,15 @@ public sealed class ChatLogWindow : Window
         var buttonWidth = afterIcon.X - beforeIcon.X;
         var showNovice = Plugin.Config.ShowNoviceNetwork && GameFunctions.GameFunctions.IsMentor();
         var buttonsRight = (showNovice ? 1 : 0) + (Plugin.Config.ShowHideButton ? 1 : 0);
-        var inputWidth = ImGui.GetContentRegionAvail().X - buttonWidth * (1 + buttonsRight);
+        // Right-side buttons: quick-picker palette + cog (always present)
+        // plus the optional hide / novice buttons. Each slot costs the
+        // measured button width AND one ItemSpacing for the SameLine gap
+        // in front of it -- leaving the spacing term out overflows the
+        // header row by one gap per button (v1.5.4 quick-picker fix).
+        var rightButtonCount = 2 + buttonsRight;
+        var inputWidth =
+            ImGui.GetContentRegionAvail().X
+            - rightButtonCount * (buttonWidth + ImGui.GetStyle().ItemSpacing.X);
 
         var normalColor = ImGui.GetColorU32(ImGuiCol.Text);
         var push = inputColour != null;
@@ -1007,12 +1123,57 @@ public sealed class ChatLogWindow : Window
                     using var pushedColor = ImRaii.PushColor(ImGuiCol.Text, normalColor);
                     if (ImGui.Selectable(Language.ChatLog_HideChat))
                         UserHide();
+
+                    // Insert game text-macro tokens. The game expands <flag>/<item> at
+                    // send time, so inserting literal token text is enough. Each entry is
+                    // disabled when its precondition is unmet (no map flag, no linked item)
+                    // so the inserted token cannot expand to nothing.
+                    unsafe
+                    {
+                        // Null-check before deref: pointers can be null during zone transitions.
+                        var agentMap = AgentMap.Instance();
+                        var flagSet = agentMap != null && agentMap->FlagMarkerCount > 0;
+                        using (ImRaii.Disabled(!flagSet))
+                        {
+                            if (ImGui.Selectable(HellionStrings.ChatLog_Insert_MapFlag))
+                            {
+                                Chat += "<flag>";
+                                Activate = true;
+                                ActivatePos = Chat.Length;
+                            }
+                        }
+
+                        var agentChat = AgentChatLog.Instance();
+                        var itemSet = agentChat != null && agentChat->LinkedItem.ItemId != 0;
+                        using (ImRaii.Disabled(!itemSet))
+                        {
+                            if (ImGui.Selectable(HellionStrings.ChatLog_Insert_ItemLink))
+                            {
+                                Chat += "<item>";
+                                Activate = true;
+                                ActivatePos = Chat.Length;
+                            }
+                        }
+                    }
                 }
             }
         }
 
         ImGui.SameLine();
 
+        if (
+            ImGuiUtil.IconButton(
+                FontAwesomeIcon.Palette,
+                tooltip: HellionStrings.Settings_QuickPicker_Tooltip,
+                width: (int)buttonWidth
+            )
+        )
+            ImGui.OpenPopup("##hellion-quick-picker");
+
+        DrawQuickPickerPopup();
+
+        ImGui.SameLine();
+
         if (ImGuiUtil.IconButton(FontAwesomeIcon.Cog, width: (int)buttonWidth))
             Plugin.SettingsWindow.Toggle();
 
@@ -1420,17 +1581,32 @@ public sealed class ChatLogWindow : Window
         Tab tab,
         PayloadHandler handler,
         float childHeight,
-        bool switchedTab
+        bool switchedTab,
+        bool updateScrollState = true
     )
     {
-        using var child = ImRaii.Child("##chat2-messages", new Vector2(-1, childHeight));
+        using (var child = ImRaii.Child("##chat2-messages", new Vector2(-1, childHeight)))
-        if (!child.Success)
+        {
-            return;
+            if (child.Success)
+            {
+                if (tab.DisplayTimestamp && Plugin.Config.PrettierTimestamps)
+                    DrawLogTableStyle(tab, handler, switchedTab);
+                else
+                    DrawLogNormalStyle(tab, handler, switchedTab);
 
-        if (tab.DisplayTimestamp && Plugin.Config.PrettierTimestamps)
+                // Cached for the header toolbar's scroll-to-bottom button, which is
-            DrawLogTableStyle(tab, handler, switchedTab);
+                // drawn one frame later. GetScrollMaxY / GetScrollY here refer to
-        else
+                // the child's scroll context. Pop-out windows pass updateScrollState:
-            DrawLogNormalStyle(tab, handler, switchedTab);
+                // false so they do not overwrite the main window's cached state.
+                if (updateScrollState)
+                    _childScrolledUp = ImGui.GetScrollMaxY() - ImGui.GetScrollY() > 1f;
+            }
+            else
+            {
+                if (updateScrollState)
+                    _childScrolledUp = false;
+            }
+        }
     }
 
     private void DrawLogNormalStyle(Tab tab, PayloadHandler handler, bool switchedTab)
@@ -1438,8 +1614,9 @@ public sealed class ChatLogWindow : Window
         using (ImRaii.PushStyle(ImGuiStyleVar.ItemSpacing, Vector2.Zero))
             DrawMessages(tab, handler, false);
 
-        if (switchedTab || ImGui.GetScrollY() >= ImGui.GetScrollMaxY())
+        if (switchedTab || _scrollToBottomRequested || ImGui.GetScrollY() >= ImGui.GetScrollMaxY())
             ImGui.SetScrollHereY(1f);
+        _scrollToBottomRequested = false;
 
         handler.Draw();
     }
@@ -1468,8 +1645,13 @@ public sealed class ChatLogWindow : Window
                 // Custom styles can have cellPadding that go above 4, which GetScrollY isn't respecting
                 var cellPaddingOffset =
                     !compact && oldCellPadding.Y > 4f ? oldCellPadding.Y - 4f : 0f;
-                if (switchedTab || ImGui.GetScrollY() + cellPaddingOffset >= ImGui.GetScrollMaxY())
+                if (
+                    switchedTab
+                    || _scrollToBottomRequested
+                    || ImGui.GetScrollY() + cellPaddingOffset >= ImGui.GetScrollMaxY()
+                )
                     ImGui.SetScrollHereY(1f);
+                _scrollToBottomRequested = false;
 
                 handler.Draw();
             }
@@ -1505,15 +1687,19 @@ public sealed class ChatLogWindow : Window
             var maxLines = Plugin.Config.MaxLinesToRender;
             var startLine = messages.Count > maxLines ? messages.Count - maxLines : 0;
 
-            // Card-mode pre-loop: theme/drawList/winLeft/winRight/border are invariant
+            // Card-mode pre-loop: theme/drawList/winLeft/winRight are
-            // per DrawMessages call; only cursorY moves per row.
+            // invariant per DrawMessages call. borderColorAbgr used to be
+            // hoisted here too, but PM-3d (v1.5.4) modulates it by
+            // tab._cardHoverAlpha per row, so it moves into the AddLine
+            // call below. anyCardHovered aggregates the row-hover state
+            // across all card-rows; the lerp runs once at the loop end so
+            // the next frame paints with the updated alpha.
             var theme = Plugin.ThemeRegistry.Active;
             var drawList = ImGui.GetWindowDrawList();
             var winLeft = ImGui.GetWindowPos().X;
             var winRight = winLeft + ImGui.GetWindowSize().X;
-            var borderColorAbgr = ColourUtil.RgbaToAbgr(
+            var baseBorderRgba = (theme.Colors.Border & 0xFFFFFF00u) | 0x33u;
-                (theme.Colors.Border & 0xFFFFFF00u) | 0x33u
+            var anyCardHovered = false;
-            );
 
             for (var i = startLine; i < messages.Count; i++)
             {
@@ -1669,6 +1855,8 @@ public sealed class ChatLogWindow : Window
                 var useCard = !Plugin.Config.UseCompactDensity;
                 if (useCard)
                 {
+                    var rowStartY = ImGui.GetCursorScreenPos().Y;
+
                     if (message.Sender.Count > 0)
                     {
                         var senderColor =
@@ -1692,9 +1880,18 @@ public sealed class ChatLogWindow : Window
                     else
                         DrawChunks(message.Content, true, handler, lineWidth);
 
-                    // Border bottom as card separator. Alpha reduced to 0x33 for subtlety.
+                    // Border bottom as card separator. Base alpha 0x33;
+                    // PM-3d lifts it by up to ~+0x70 while any row in this
+                    // tab is hovered. _cardHoverAlpha lerps at the loop
+                    // end, so the one-frame lag is invisible at 10f speed.
                     {
                         var rowEndY = ImGui.GetCursorScreenPos().Y;
+                        var hoverBoost = 0.45f * tab._cardHoverAlpha;
+                        var alphaByte = (uint)
+                            Math.Clamp((int)(0x33u + hoverBoost * 255f), 0x33, 0xCC);
+                        var borderColorAbgr = ColourUtil.RgbaToAbgr(
+                            (baseBorderRgba & 0xFFFFFF00u) | alphaByte
+                        );
                         drawList.AddLine(
                             new Vector2(winLeft + 4, rowEndY - 1),
                             new Vector2(winRight - 4, rowEndY - 1),
@@ -1702,6 +1899,17 @@ public sealed class ChatLogWindow : Window
                             1f
                         );
                         ImGui.Dummy(new Vector2(0, 2));
+
+                        // Whole-row hover test. IsItemHovered would only see
+                        // the 2px Dummy above, so hit-test the row rect from
+                        // its start Y down to the separator line instead.
+                        if (
+                            ImGui.IsMouseHoveringRect(
+                                new Vector2(winLeft, rowStartY),
+                                new Vector2(winRight, rowEndY)
+                            )
+                        )
+                            anyCardHovered = true;
                     }
                 }
                 else
@@ -1726,6 +1934,20 @@ public sealed class ChatLogWindow : Window
 
                 message.IsVisible[tab.Identifier] = ImGui.IsItemVisible();
             }
+
+            // PM-3d: update the per-tab card-hover lerp once per
+            // DrawMessages call. ReduceMotion snaps to the target;
+            // otherwise the border alpha eases toward it over a few
+            // frames the next time the rows paint.
+            var cardTarget = anyCardHovered ? 1f : 0f;
+            tab._cardHoverAlpha = Plugin.Config.ReduceMotion
+                ? cardTarget
+                : FrameLerp.Smooth(
+                    tab._cardHoverAlpha,
+                    cardTarget,
+                    speed: 10f,
+                    deltaTime: ImGui.GetIO().DeltaTime
+                );
         }
         catch (ApplicationException)
         {
@@ -1976,7 +2198,19 @@ public sealed class ChatLogWindow : Window
                             ColourUtil.RgbaToAbgr(theme.Colors.Surface)
                         )
                     )
-                    using (ImRaii.PushColor(ImGuiCol.Text, ColourUtil.RgbaToAbgr(iconColor)))
+                    // PM-3c: icon alpha eases from 40% (dim) to 100% on
+                    // hover. _hoverAlpha lerps at the end of this block,
+                    // so the colour for frame N uses frame N-1's value --
+                    // a sub-frame lag that is invisible at 10f speed.
+                    using (
+                        ImRaii.PushColor(
+                            ImGuiCol.Text,
+                            ColourUtil.ApplyAlpha(
+                                ColourUtil.RgbaToAbgr(iconColor),
+                                0.4f + 0.6f * tab._hoverAlpha
+                            )
+                        )
+                    )
                     using (Plugin.FontManager.FontAwesome.Push())
                     {
                         // Button stretches with the configured sidebar width so a
@@ -1988,6 +2222,19 @@ public sealed class ChatLogWindow : Window
                         );
                     }
 
+                    // PM-3c hover-lerp: ramp _hoverAlpha toward 1 while the
+                    // icon button is hovered, back to 0 otherwise.
+                    // ReduceMotion snaps so the dim/full states stay binary.
+                    var hoverTarget = ImGui.IsItemHovered() ? 1f : 0f;
+                    tab._hoverAlpha = Plugin.Config.ReduceMotion
+                        ? hoverTarget
+                        : FrameLerp.Smooth(
+                            tab._hoverAlpha,
+                            hoverTarget,
+                            speed: 10f,
+                            deltaTime: ImGui.GetIO().DeltaTime
+                        );
+
                     if (isCurrentTab)
                     {
                         // Vertical accent pill on the left window edge, 3px wide, half tab height,
@@ -2114,14 +2361,50 @@ public sealed class ChatLogWindow : Window
         Plugin.WantedTab = null;
     }
 
-    // DrawChatHeaderToolbar: renders the pop-out button for the active tab.
+    // DrawChatHeaderToolbar: renders the honorific title slot, the optional
-    // v1.3.0 also renders the optional Honorific title slot left of it.
+    // scroll-to-bottom button, and the pop-out button for the active tab.
     private void DrawChatHeaderToolbar(Tab tab)
     {
         DrawHonorificTitleSlot();
+        DrawScrollToBottomToolbarButton();
         DrawPopOutButton(tab);
     }
 
+    // Draws an arrow-down button in the toolbar when the user has scrolled up
+    // from the live end of the chat log. Clicking it requests a snap to bottom.
+    //
+    // _childScrolledUp is set at the end of DrawMessageLog, which runs AFTER
+    // DrawChatHeaderToolbar in the same frame. So this button always reflects the
+    // previous frame's scroll state, a one-frame lag that is imperceptible in use.
+    //
+    // Both this button and DrawPopOutButton use SetCursorPosX with absolute
+    // positioning (cursorX + GetContentRegionAvail().X - N * iconWidth). Because
+    // each call computes its own target X from the right edge, they are independent
+    // of each other and of what the cursor position happens to be at call time.
+    // The pop-out button lands at rightEdge - iconWidth regardless of call order.
+    private void DrawScrollToBottomToolbarButton()
+    {
+        if (!_childScrolledUp)
+            return;
+
+        var avail = ImGui.GetContentRegionAvail().X;
+        var iconWidth = ImGui.GetFrameHeight();
+        var spacing = ImGui.GetStyle().ItemSpacing.X;
+        ImGui.SetCursorPosX(ImGui.GetCursorPosX() + avail - 2 * iconWidth - spacing);
+
+        if (
+            ImGuiUtil.IconButton(
+                FontAwesomeIcon.ArrowDown,
+                tooltip: HellionStrings.ChatLog_ScrollToBottom_Tooltip
+            )
+        )
+            _scrollToBottomRequested = true;
+
+        // Keep the pop-out button on the same toolbar row. Without this the
+        // button item ends the line and the pop-out drops to the next row.
+        ImGui.SameLine();
+    }
+
     private void DrawPopOutButton(Tab tab)
     {
         var avail = ImGui.GetContentRegionAvail().X;
@@ -2173,7 +2456,13 @@ public sealed class ChatLogWindow : Window
             crownWidth = ImGui.CalcTextSize(FontAwesomeIcon.Crown.ToIconString()).X;
         }
 
-        var maxTitleWidth = avail - iconWidth - gapBeforeButton - crownWidth - gapAfterCrown;
+        // When the scroll button is also present it occupies iconWidth + ItemSpacing.X
+        // to the left of the pop-out button, so shrink the title budget accordingly.
+        var scrollButtonReserve = _childScrolledUp
+            ? iconWidth + ImGui.GetStyle().ItemSpacing.X
+            : 0f;
+        var maxTitleWidth =
+            avail - iconWidth - scrollButtonReserve - gapBeforeButton - crownWidth - gapAfterCrown;
         if (maxTitleWidth <= 0)
         {
             return;
@@ -2299,8 +2588,13 @@ public sealed class ChatLogWindow : Window
         var anyChanged = false;
         var tabs = Plugin.Config.Tabs;
 
+        // Focus the rename field on the frame the context menu opens so the
+        // user can type immediately. Buffer raised 128 -> 512 to match the
+        // settings-tab rename (Ui/SettingsTabs/Tabs.cs). One name limit, not two.
+        if (ImGui.IsWindowAppearing())
+            ImGui.SetKeyboardFocusHere();
         ImGui.SetNextItemWidth(250f * ImGuiHelpers.GlobalScale);
-        if (ImGui.InputText("##tab-name", ref tab.Name, 128))
+        if (ImGui.InputText("##tab-name", ref tab.Name, 512))
             anyChanged = true;
 
         if (ImGuiUtil.IconButton(FontAwesomeIcon.TrashAlt, tooltip: Language.ChatLog_Tabs_Delete))

HellionChat/Ui/FirstRunWizard.cs

@@ -1,18 +1,41 @@
+using System.Globalization;
 using System.Numerics;
 using Dalamud.Bindings.ImGui;
+using Dalamud.Interface.Utility;
 using Dalamud.Interface.Utility.Raii;
 using Dalamud.Interface.Windowing;
 using HellionChat.Branding;
 using HellionChat.Code;
 using HellionChat.Privacy;
 using HellionChat.Resources;
+using HellionChat.Themes;
 using HellionChat.Util;
 
 namespace HellionChat.Ui;
 
+// Multi-step first-run wizard. public sealed because Plugin.cs has a
+// public-typed property on this class — narrowing to internal would
+// be a build break across the assembly boundary. State lives in a
+// nested WizardState record; every step writes nullable Pending*
+// fields, and CommitPending() applies only the non-null ones so
+// users who skip a step never get their existing config overwritten.
 public sealed class FirstRunWizard : Window
 {
+    // Forge-Bronze (#C2410C). The same constant lives in ThemeRegistry
+    // and the forge-announce workflow; pinning it locally keeps the
+    // wizard render path free of registry lookups during draw.
+    private static readonly Vector4 ForgeBronze = new(0xC2 / 255f, 0x41 / 255f, 0x0C / 255f, 1f);
+    private static readonly Vector4 ForgeBronzeDim = new(
+        0xC2 / 255f,
+        0x41 / 255f,
+        0x0C / 255f,
+        0.3f
+    );
+
+    private const int TotalSteps = 4;
+
     private readonly Plugin Plugin;
+    private readonly WizardState _state = new();
 
     internal FirstRunWizard(Plugin plugin)
         : base($"{HellionStrings.Wizard_Title}###hellion-firstrun")
@@ -21,10 +44,10 @@ public sealed class FirstRunWizard : Window
 
         Flags = ImGuiWindowFlags.NoCollapse | ImGuiWindowFlags.NoDocking;
         SizeCondition = ImGuiCond.Appearing;
-        Size = new Vector2(900, 560);
+        Size = new Vector2(720, 480);
         SizeConstraints = new WindowSizeConstraints
         {
-            MinimumSize = new Vector2(720, 480),
+            MinimumSize = new Vector2(600, 400),
             MaximumSize = new Vector2(float.MaxValue, float.MaxValue),
         };
     }
@@ -32,138 +55,553 @@ public sealed class FirstRunWizard : Window
     public override void OnClose()
     {
         // OnClose fires on explicit X-click and on plugin dispose. We never
-        // implicitly accept the defaults here — the explicit "Later" button
+        // implicitly accept the defaults here — both the explicit "Decide
-        // does that. If the user hasn't picked a profile yet, the wizard
+        // later" footer link and a successful "Finish ✓" set FirstRunCompleted
-        // reopens on the next plugin load.
+        // = true, so the wizard does not reopen on the next plugin load
+        // regardless of which path the user took.
     }
 
     public override void Draw()
     {
-        DrawHellionForgeAnchor();
+        DrawPagination();
         ImGui.Spacing();
         ImGui.Separator();
         ImGui.Spacing();
 
-        ImGui.TextWrapped(HellionStrings.Wizard_Intro);
+        switch (_state.CurrentStep)
-        ImGui.Spacing();
-        ImGui.Separator();
-        ImGui.Spacing();
-
-        var avail = ImGui.GetContentRegionAvail();
-        var cardWidth = (avail.X - ImGui.GetStyle().ItemSpacing.X * 2) / 3f;
-        // Reserve room for the footer separator + cancel button below the cards.
-        var footerReserve =
-            ImGui.GetStyle().ItemSpacing.Y * 3
-            + ImGui.GetTextLineHeight()
-            + ImGui.GetFrameHeightWithSpacing();
-        var cardHeight = avail.Y - footerReserve;
-
-        DrawCard(
-            "privacy-first",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Description,
-            null,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Apply,
-            ApplyPrivacyFirst
-        );
-
-        ImGui.SameLine();
-
-        DrawCard(
-            "casual",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_Casual_Heading,
-            HellionStrings.Wizard_Profile_Casual_Description,
-            null,
-            HellionStrings.Wizard_Profile_Casual_Apply,
-            ApplyCasual
-        );
-
-        ImGui.SameLine();
-
-        DrawCard(
-            "full-history",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_FullHistory_Heading,
-            HellionStrings.Wizard_Profile_FullHistory_Description,
-            HellionStrings.Wizard_Profile_FullHistory_GdprWarning,
-            HellionStrings.Wizard_Profile_FullHistory_Apply,
-            ApplyFullHistory
-        );
-
-        ImGui.Spacing();
-        ImGui.Separator();
-        ImGui.Spacing();
-
-        if (ImGui.Button(HellionStrings.Wizard_Cancel_Label))
         {
-            Plugin.Config.FirstRunCompleted = true;
+            case 1:
-            Plugin.SaveConfig();
+                DrawStepWelcome();
-            IsOpen = false;
+                break;
+            case 2:
+                DrawStepPrivacy();
+                break;
+            case 3:
+                DrawStepPowerSettings();
+                break;
+            case 4:
+                DrawStepDone();
+                break;
+            default:
+                _state.CurrentStep = 1;
+                DrawStepWelcome();
+                break;
         }
-
-        if (ImGui.IsItemHovered())
-            ImGuiUtil.Tooltip(HellionStrings.Wizard_Cancel_Tooltip);
     }
 
-    private void DrawCard(
+    private void DrawPagination()
-        string id,
+    {
-        float width,
+        var draw = ImGui.GetWindowDrawList();
-        float height,
+        var avail = ImGui.GetContentRegionAvail();
+        var cursor = ImGui.GetCursorScreenPos();
+        const float radius = 5f;
+        const float spacing = 16f;
+        var totalWidth = (TotalSteps - 1) * spacing;
+        var startX = cursor.X + avail.X - totalWidth - radius;
+
+        for (var i = 0; i < TotalSteps; i++)
+        {
+            var color = (i + 1) == _state.CurrentStep ? ForgeBronze : ForgeBronzeDim;
+            var packed = ImGui.GetColorU32(color);
+            draw.AddCircleFilled(
+                new Vector2(startX + i * spacing, cursor.Y + radius),
+                radius,
+                packed
+            );
+        }
+
+        // Reserve vertical space the circles consumed so the next widget starts below them.
+        ImGui.Dummy(new Vector2(0, radius * 2));
+    }
+
+    private void DrawFooter(bool showBack, bool showSkip, string primaryLabel, Action onPrimary)
+    {
+        var spacing = ImGui.GetStyle().ItemSpacing.Y;
+        var primaryWidth =
+            ImGui.CalcTextSize(primaryLabel).X + ImGui.GetStyle().FramePadding.X * 2 + 16f;
+        var avail = ImGui.GetContentRegionAvail();
+
+        // Push the footer to the bottom of the window so step contents
+        // above can size themselves with GetContentRegionAvail().
+        var lineHeight = ImGui.GetFrameHeightWithSpacing();
+        var pushDown = avail.Y - lineHeight - spacing;
+        if (pushDown > 0)
+            ImGui.Dummy(new Vector2(0, pushDown));
+
+        ImGui.Separator();
+        ImGui.Spacing();
+
+        if (showBack)
+        {
+            if (ImGui.Button(HellionStrings.Wizard_Nav_Back))
+                _state.CurrentStep = Math.Max(1, _state.CurrentStep - 1);
+            ImGui.SameLine();
+        }
+
+        if (showSkip)
+        {
+            if (ImGui.Button(HellionStrings.Wizard_Step1_Skip_Label))
+            {
+                // Skip path = matches today's Cancel path: mark first-run
+                // complete, save, close. No CommitPending — the user said
+                // 'decide later', so existing config stays as-is.
+                Plugin.Config.FirstRunCompleted = true;
+                Plugin.SaveConfig();
+                IsOpen = false;
+            }
+            if (ImGui.IsItemHovered())
+                ImGuiUtil.Tooltip(HellionStrings.Wizard_Step1_Skip_Tooltip);
+        }
+
+        // Right-align the primary action button.
+        var rightX = ImGui.GetCursorPosX() + ImGui.GetContentRegionAvail().X - primaryWidth;
+        if (rightX > ImGui.GetCursorPosX())
+            ImGui.SameLine(rightX);
+
+        using (ImRaii.PushColor(ImGuiCol.Button, ForgeBronze))
+        using (ImRaii.PushColor(ImGuiCol.ButtonHovered, ForgeBronze))
+        using (ImRaii.PushColor(ImGuiCol.ButtonActive, ForgeBronze))
+        {
+            if (ImGui.Button($"{primaryLabel}##wizard-primary"))
+                onPrimary();
+        }
+    }
+
+    private void DrawStepWelcome()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step1_Title);
+        ImGui.Spacing();
+
+        // Fox-banner image: the embedded Hellion Forge fox artwork. The card
+        // behind the image gives the dark fox enough contrast against the
+        // plugin's dark UI so the logo reads clearly at a glance.
+        var banner = FoxBannerTexture.Shared.GetWrapOrDefault();
+        if (banner is not null)
+        {
+            const uint CardColor = 0xFFE8E8E8; // off-white fill so the dark fox pops
+            var imgHeight = 170f * ImGuiHelpers.GlobalScale;
+            var imgWidth = imgHeight * banner.Size.X / banner.Size.Y;
+            var pad = 14f * ImGuiHelpers.GlobalScale;
+            var cardWidth = imgWidth + pad * 2f;
+            var cardHeight = imgHeight + pad * 2f;
+            var rounding = 8f * ImGuiHelpers.GlobalScale;
+
+            // Centre the card in the content region. Clamp to zero so the card
+            // never shifts left of the window edge on very narrow windows.
+            var offsetX = Math.Max(0f, (ImGui.GetContentRegionAvail().X - cardWidth) * 0.5f);
+            var cardOrigin = ImGui.GetCursorScreenPos() + new Vector2(offsetX, 0f);
+
+            // Draw the rounded card behind the image, then place the image on top.
+            ImGui
+                .GetWindowDrawList()
+                .AddRectFilled(
+                    cardOrigin,
+                    cardOrigin + new Vector2(cardWidth, cardHeight),
+                    CardColor,
+                    rounding
+                );
+            ImGui.SetCursorScreenPos(cardOrigin + new Vector2(pad, pad));
+            ImGui.Image(banner.Handle, new Vector2(imgWidth, imgHeight));
+
+            // Advance the layout cursor past the full card so the content below
+            // starts at the right position and does not overlap the card.
+            ImGui.SetCursorScreenPos(cardOrigin);
+            ImGui.Dummy(new Vector2(cardWidth, cardHeight));
+        }
+
+        ImGui.Spacing();
+        ImGui.TextWrapped(HellionStrings.Wizard_Step1_Subtitle);
+        ImGui.Spacing();
+        ImGui.TextWrapped(HellionStrings.Wizard_Step1_Footer_Hint);
+
+        DrawFooter(
+            showBack: false,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 2
+        );
+    }
+
+    private void DrawStepPrivacy()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step2_Title);
+        ImGui.Spacing();
+
+        // Reserve footer height (separator + spacing + button row) so the
+        // 2x2 grid uses the rest of the window.
+        var footerReserve =
+            ImGui.GetFrameHeightWithSpacing()
+            + ImGui.GetStyle().ItemSpacing.Y * 3
+            + ImGui.GetTextLineHeight();
+        var grid = ImGui.GetContentRegionAvail();
+        var cardWidth = (grid.X - ImGui.GetStyle().ItemSpacing.X) / 2f;
+        var cardHeight = (grid.Y - footerReserve - ImGui.GetStyle().ItemSpacing.Y) / 2f;
+
+        // Top row.
+        DrawProfileCard(
+            PrivacyProfile.PrivacyFirst,
+            "🔒",
+            HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
+            HellionStrings.Wizard_Profile_PrivacyFirst_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+        ImGui.SameLine();
+        DrawProfileCard(
+            PrivacyProfile.Casual,
+            "💬",
+            HellionStrings.Wizard_Profile_Casual_Heading,
+            HellionStrings.Wizard_Profile_Casual_Description,
+            recommended: true,
+            cardWidth,
+            cardHeight
+        );
+
+        // Bottom row.
+        DrawProfileCard(
+            PrivacyProfile.Roleplay,
+            "🎭",
+            HellionStrings.Wizard_Profile_Roleplay_Heading,
+            HellionStrings.Wizard_Profile_Roleplay_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+        ImGui.SameLine();
+        DrawProfileCard(
+            PrivacyProfile.FullHistory,
+            "📚",
+            HellionStrings.Wizard_Profile_FullHistory_Heading,
+            HellionStrings.Wizard_Profile_FullHistory_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+
+        ImGui.Spacing();
+        ImGui.TextDisabled(HellionStrings.Wizard_Step2_RecommendedFooter);
+
+        DrawFooter(
+            showBack: true,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 3
+        );
+    }
+
+    private void DrawProfileCard(
+        PrivacyProfile profile,
+        string emoji,
         string heading,
         string description,
-        string? warning,
+        bool recommended,
-        string buttonLabel,
+        float width,
-        Action onApply
+        float height
     )
     {
-        using var child = ImRaii.Child($"##wizard-card-{id}", new Vector2(width, height), true);
+        var isSelected = _state.PendingProfile == profile;
+        // GetStyleColorVec4 returns a pointer to the live style entry in
+        // Dalamud.Bindings.ImGui, which would require unsafe. Use the U32
+        // packed-colour overload of PushColor for the default branch so we
+        // can stay in safe code while still matching the current border.
+        var borderColor = isSelected
+            ? ImGui.GetColorU32(ForgeBronze)
+            : ImGui.GetColorU32(ImGuiCol.Border);
+
+        using var _border = ImRaii.PushColor(ImGuiCol.Border, borderColor);
+        using var child = ImRaii.Child(
+            $"##profile-card-{profile}",
+            new Vector2(width, height),
+            true
+        );
         if (!child.Success)
             return;
 
-        ImGui.TextUnformatted(heading);
+        // InvisibleButton over the full card area, then SetCursorScreenPos
+        // back to draw the heading/description content on top. Selectable
+        // would be semantically wrong here — the card is a standalone
+        // choice tile, not a list-item inside a list/menu. The button
+        // takes the click for the entire card area, and IsItemHovered()
+        // on it (if we wire one up later) would naturally cover the full
+        // tile. Visual feedback comes from the border colour above.
+        var startPos = ImGui.GetCursorScreenPos();
+        var cardArea = ImGui.GetContentRegionAvail();
+        if (ImGui.InvisibleButton($"##profile-hit-{profile}", cardArea))
+            _state.PendingProfile = profile;
+
+        ImGui.SetCursorScreenPos(startPos);
+
+        ImGui.TextUnformatted($"{emoji}  {heading}{(recommended ? "  ★" : string.Empty)}");
+        ImGui.Spacing();
+        ImGui.Separator();
+        ImGui.Spacing();
+        ImGui.TextWrapped(description);
+    }
+
+    private void DrawStepPowerSettings()
+    {
+        // Seed only the two recommendation fields here. Other fields remain
+        // null until the user touches the corresponding control.
+        // Spec FR-4: the wizard explicitly recommends LoadPreviousSession =
+        // true and FilterIncludePreviousSessions = true (Config defaults are
+        // false). The other four fields (AutoTellTabsHistoryPreload,
+        // UseCompactDensity, PrettierTimestamps, Theme) follow the generic
+        // null-semantics from Spec Z.176: a null pending means the user did
+        // not touch that control, so CommitPending must not write back. They
+        // are read live from Plugin.Config below for the ImGui ref-binding
+        // but never seeded into Pending* without a user gesture.
+        _state.PendingLoadPreviousSession ??= true;
+        _state.PendingFilterIncludePreviousSessions ??= true;
+
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Title);
+        ImGui.Spacing();
+
+        // History section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_History);
+
+        var loadPrev = _state.PendingLoadPreviousSession ?? true;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_LoadPreviousSession_Label, ref loadPrev))
+        {
+            _state.PendingLoadPreviousSession = loadPrev;
+            // Mirror the DataManagement coupling: turning load-previous on
+            // also turns filter-include on (otherwise old messages bypass
+            // the filter chain), and turning filter-include off forces
+            // load-previous off. Same idiom as Ui/SettingsTabs/DataManagement.cs:182-200.
+            if (loadPrev)
+                _state.PendingFilterIncludePreviousSessions = true;
+        }
+
+        var filterPrev = _state.PendingFilterIncludePreviousSessions ?? true;
+        if (
+            ImGui.Checkbox(
+                HellionStrings.Wizard_Step3_FilterIncludePreviousSessions_Label,
+                ref filterPrev
+            )
+        )
+        {
+            _state.PendingFilterIncludePreviousSessions = filterPrev;
+            if (!filterPrev)
+                _state.PendingLoadPreviousSession = false;
+        }
+
+        ImGui.Spacing();
+
+        // Tell-Tabs section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_TellTabs);
+
+        var preload =
+            _state.PendingAutoTellTabsHistoryPreload ?? Plugin.Config.AutoTellTabsHistoryPreload;
+        if (
+            ImGui.SliderInt(
+                HellionStrings.Wizard_Step3_AutoTellTabsHistoryPreload_Label,
+                ref preload,
+                0,
+                100
+            )
+        )
+            _state.PendingAutoTellTabsHistoryPreload = preload;
+
+        ImGui.Spacing();
+
+        // Visual section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_Visual);
+
+        var compact = _state.PendingUseCompactDensity ?? Plugin.Config.UseCompactDensity;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_UseCompactDensity_Label, ref compact))
+            _state.PendingUseCompactDensity = compact;
+
+        var pretty = _state.PendingPrettierTimestamps ?? Plugin.Config.PrettierTimestamps;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_PrettierTimestamps_Label, ref pretty))
+            _state.PendingPrettierTimestamps = pretty;
+
+        // Theme dropdown — built-ins only. Custom themes are power-user
+        // territory and would clutter the first-run flow.
+        var currentSlug = _state.PendingTheme ?? Plugin.Config.Theme;
+        var builtIns = Plugin.ThemeRegistry.AllBuiltIns().ToList();
+        var currentIndex = builtIns.FindIndex(t =>
+            string.Equals(t.Slug, currentSlug, StringComparison.OrdinalIgnoreCase)
+        );
+        if (currentIndex < 0)
+            currentIndex = 0;
+
+        using (
+            var combo = ImRaii.Combo(
+                HellionStrings.Wizard_Step3_Theme_Label,
+                builtIns[currentIndex].Name
+            )
+        )
+        {
+            if (combo.Success)
+            {
+                for (var i = 0; i < builtIns.Count; i++)
+                {
+                    var isSelected = i == currentIndex;
+                    if (ImGui.Selectable(builtIns[i].Name, isSelected))
+                        _state.PendingTheme = builtIns[i].Slug;
+                    if (isSelected)
+                        ImGui.SetItemDefaultFocus();
+                }
+            }
+        }
+
+        DrawFooter(
+            showBack: true,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 4
+        );
+    }
+
+    private void DrawStepDone()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step4_Title);
+        ImGui.Spacing();
+
+        // ✓ symbol, centred-ish via dummy padding.
+        var checkmark = "✓";
+        var checkSize = ImGui.CalcTextSize(checkmark);
+        var avail = ImGui.GetContentRegionAvail();
+        ImGui.Dummy(new Vector2((avail.X - checkSize.X) * 0.5f, 0));
+        ImGui.SameLine();
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(checkmark);
+
         ImGui.Spacing();
         ImGui.Separator();
         ImGui.Spacing();
 
-        ImGui.TextWrapped(description);
+        // Summary card.
-
+        using (var summary = ImRaii.Child("##wizard-summary", new Vector2(-1, 130), true))
-        if (warning is not null)
         {
-            ImGui.Spacing();
+            if (summary.Success)
-            ImGuiUtil.WarningText(warning);
+            {
+                ImGui.TextUnformatted(HellionStrings.Wizard_Step4_SummaryHeading);
+                ImGui.Spacing();
+                ImGui.Separator();
+                ImGui.Spacing();
+
+                var profileLabel = _state.PendingProfile switch
+                {
+                    PrivacyProfile.PrivacyFirst =>
+                        HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
+                    PrivacyProfile.Casual => HellionStrings.Wizard_Profile_Casual_Heading,
+                    PrivacyProfile.Roleplay => HellionStrings.Wizard_Profile_Roleplay_Heading,
+                    PrivacyProfile.FullHistory => HellionStrings.Wizard_Profile_FullHistory_Heading,
+                    _ => HellionStrings.Wizard_Step4_Summary_Unchanged,
+                };
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_Profile, profileLabel)
+                );
+
+                var historyLabel =
+                    (_state.PendingLoadPreviousSession ?? false)
+                        ? HellionStrings.Wizard_Step3_LoadPreviousSession_Label
+                        : HellionStrings.Wizard_Step4_Summary_Unchanged;
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_History, historyLabel)
+                );
+
+                var preloadValue =
+                    _state.PendingAutoTellTabsHistoryPreload
+                    ?? Plugin.Config.AutoTellTabsHistoryPreload;
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_TellTabs, preloadValue)
+                );
+
+                var compact = _state.PendingUseCompactDensity ?? Plugin.Config.UseCompactDensity;
+                var pretty = _state.PendingPrettierTimestamps ?? Plugin.Config.PrettierTimestamps;
+                var themeSlug = _state.PendingTheme ?? Plugin.Config.Theme;
+                var themeName = Plugin.ThemeRegistry.Get(themeSlug).Name;
+                var visualParts = new List<string>();
+                if (compact)
+                    visualParts.Add(HellionStrings.Wizard_Step3_UseCompactDensity_Label);
+                if (pretty)
+                    visualParts.Add(HellionStrings.Wizard_Step3_PrettierTimestamps_Label);
+                visualParts.Add(themeName);
+                ImGui.TextWrapped(
+                    string.Format(
+                        HellionStrings.Wizard_Step4_Summary_Visual,
+                        string.Join(", ", visualParts)
+                    )
+                );
+            }
         }
 
-        // Push the button to the bottom of the card.
+        ImGui.Spacing();
-        var lineHeight = ImGui.GetFrameHeightWithSpacing();
-        var remaining = ImGui.GetContentRegionAvail().Y - lineHeight;
-        if (remaining > 0)
-            ImGui.Dummy(new Vector2(0, remaining));
 
-        if (ImGui.Button($"{buttonLabel}##{id}", new Vector2(-1, 0)))
+        // Inline FR-3 hint with placeholder for preload count.
-        {
+        var preloadForHint =
-            onApply();
+            _state.PendingAutoTellTabsHistoryPreload ?? Plugin.Config.AutoTellTabsHistoryPreload;
-            Plugin.Config.FirstRunCompleted = true;
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
-            Plugin.SaveConfig();
+            ImGui.TextWrapped(string.Format(HellionStrings.Wizard_Step4_TestHint, preloadForHint));
-            IsOpen = false;
+
-        }
+        ImGui.Spacing();
+        ImGui.TextDisabled(HellionStrings.Wizard_Step4_SettingsHint);
+
+        DrawFooter(
+            showBack: true,
+            showSkip: false,
+            HellionStrings.Wizard_Nav_Finish,
+            () =>
+            {
+                CommitPending();
+                Plugin.Config.FirstRunCompleted = true;
+                Plugin.SaveConfig();
+                IsOpen = false;
+            }
+        );
     }
 
-    // Collapsible because the full silhouette is taller than the wizard
+    // Writes only non-null pending values back to Config. A null pending
-    // window — folded by default so the privacy cards stay the primary
+    // means the user did not touch that step's control, so the existing
-    // focus, expandable for whoever wants the "about the makers" anchor.
+    // Config value is preserved. Theme switch goes through ThemeRegistry
-    private void DrawHellionForgeAnchor()
+    // so the active palette updates live for the rest of the session.
+    internal void CommitPending()
     {
-        using var tree = ImRaii.TreeNode("Hellion Forge");
+        switch (_state.PendingProfile)
-        if (!tree.Success)
+        {
-            return;
+            case PrivacyProfile.PrivacyFirst:
+                ApplyPrivacyFirst();
+                break;
+            case PrivacyProfile.Casual:
+                ApplyCasual();
+                break;
+            case PrivacyProfile.Roleplay:
+                ApplyRoleplay();
+                break;
+            case PrivacyProfile.FullHistory:
+                ApplyFullHistory();
+                break;
+        }
 
-        using (Plugin.Interface.UiBuilder.MonoFontHandle.Push())
+        if (_state.PendingLoadPreviousSession.HasValue)
-            ImGui.TextUnformatted(HellionForgeAscii.FoxBanner);
+            Plugin.Config.LoadPreviousSession = _state.PendingLoadPreviousSession.Value;
+
+        if (_state.PendingFilterIncludePreviousSessions.HasValue)
+            Plugin.Config.FilterIncludePreviousSessions = _state
+                .PendingFilterIncludePreviousSessions
+                .Value;
+
+        if (_state.PendingAutoTellTabsHistoryPreload.HasValue)
+            Plugin.Config.AutoTellTabsHistoryPreload = _state
+                .PendingAutoTellTabsHistoryPreload
+                .Value;
+
+        if (_state.PendingUseCompactDensity.HasValue)
+            Plugin.Config.UseCompactDensity = _state.PendingUseCompactDensity.Value;
+
+        if (_state.PendingPrettierTimestamps.HasValue)
+            Plugin.Config.PrettierTimestamps = _state.PendingPrettierTimestamps.Value;
+
+        if (!string.IsNullOrWhiteSpace(_state.PendingTheme))
+        {
+            Plugin.Config.Theme = _state.PendingTheme;
+            Plugin.ThemeRegistry.Switch(_state.PendingTheme);
+        }
     }
 
     private void ApplyPrivacyFirst()
@@ -194,6 +632,20 @@ public sealed class FirstRunWizard : Window
         Plugin.Config.RetentionPerChannelDays = policy;
     }
 
+    private void ApplyRoleplay()
+    {
+        Plugin.Config.PrivacyFilterEnabled = true;
+        Plugin.Config.PrivacyPersistChannels = [.. PrivacyDefaults.RoleplayWhitelist];
+        Plugin.Config.PrivacyPersistUnknownChannels = false;
+
+        Plugin.Config.RetentionEnabled = true;
+        Plugin.Config.RetentionDefaultDays = 30;
+        var policy = PrivacyDefaults.DefaultRetentionDays.ToDictionary(p => p.Key, p => p.Value);
+        foreach (var (type, days) in PrivacyDefaults.RoleplayRetentionOverrides)
+            policy[type] = days;
+        Plugin.Config.RetentionPerChannelDays = policy;
+    }
+
     private void ApplyFullHistory()
     {
         // Full history = upstream Chat 2 behavior. Filter off, retention off,
@@ -205,4 +657,34 @@ public sealed class FirstRunWizard : Window
         Plugin.Config.RetentionEnabled = false;
         Plugin.Config.RetentionPerChannelDays.Clear();
     }
+
+    // Test-only entry point so SelfTests/WizardStateSmokeStep can advance
+    // the state machine without spawning ImGui input events.
+    internal void TestOnly_AdvanceTo(int step) =>
+        _state.CurrentStep = Math.Clamp(step, 1, TotalSteps);
+
+    // Test-only setter so the smoke-test can pin a profile selection
+    // without driving the ImGui card-click path.
+    internal void TestOnly_SetPendingProfile(PrivacyProfile profile) =>
+        _state.PendingProfile = profile;
+
+    internal enum PrivacyProfile
+    {
+        PrivacyFirst,
+        Casual,
+        Roleplay,
+        FullHistory,
+    }
+
+    private sealed class WizardState
+    {
+        public int CurrentStep { get; set; } = 1;
+        public PrivacyProfile? PendingProfile { get; set; }
+        public bool? PendingLoadPreviousSession { get; set; }
+        public bool? PendingFilterIncludePreviousSessions { get; set; }
+        public int? PendingAutoTellTabsHistoryPreload { get; set; }
+        public bool? PendingUseCompactDensity { get; set; }
+        public bool? PendingPrettierTimestamps { get; set; }
+        public string? PendingTheme { get; set; }
+    }
 }

HellionChat/Ui/HellionStyle.cs

@@ -33,11 +33,31 @@ internal static class HellionStyle
 
     // Global color and style stack pushed once per frame.
     // windowOpacity: window background alpha (0.5-1.0).
-    internal static IDisposable PushGlobal(Theme theme, float windowOpacity = 1.0f)
+    internal static IDisposable PushGlobal(
+        Theme theme,
+        ThemeRegistry registry,
+        float windowOpacity = 1.0f
+    )
     {
         var c = theme.Colors;
         var l = theme.Layout;
-        var a = theme.AbgrCache;
+
+        // Crossfade: PM-1 reads a lerped snapshot during the 300ms window
+        // following a Switch (TryGetActiveCrossfade returns false outside
+        // the window or while ReduceMotion is on). Only the ABGR-slot path
+        // crossfades -- WindowBg/ChildBg RGBA stays bound to the user's
+        // per-window opacity override and must not fade. See
+        // feedback_dalamud_pinning_override.
+        ThemeAbgrCache a;
+        if (!Plugin.Config.ReduceMotion && registry.TryGetActiveCrossfade(out var lerped))
+        {
+            a = lerped;
+        }
+        else
+        {
+            a = theme.AbgrCache;
+        }
+
         var stack = new StackHandle();
 
         var alphaByte = (uint)Math.Clamp((int)(windowOpacity * 255f), 0x55, 0xFF);

HellionChat/Ui/Popout.cs

@@ -118,7 +118,7 @@ internal class Popout : Window
 
         var handler = ChatLogWindow.HandlerLender.Borrow();
         var logHeight = ImGui.GetContentRegionAvail().Y - inputBarHeight - hintBannerHeight;
-        ChatLogWindow.DrawMessageLog(Tab, handler, logHeight, false);
+        ChatLogWindow.DrawMessageLog(Tab, handler, logHeight, false, updateScrollState: false);
 
         if (inputEnabled && InputBar != null)
         {

HellionChat/Ui/Settings.cs

@@ -201,6 +201,18 @@ public sealed class SettingsWindow : Dalamud.Interface.Windowing.Window
 
         var hideChanged = !Mutable.HideChat && Mutable.HideChat != Plugin.Config.HideChat;
         var languageChanged = Mutable.LanguageOverride != Plugin.Config.LanguageOverride;
+
+        // v1.5.3: Auto-enable the ExtraGlyphRanges flag matching the new
+        // locale so non-Latin scripts render immediately. Without this,
+        // a user switching to Korean would see "===" until they manually
+        // tick the Korean range in Fonts & Colours.
+        if (languageChanged)
+        {
+            var required = Mutable.LanguageOverride.RequiredGlyphRanges();
+            if (required != 0)
+                Mutable.ExtraGlyphRanges |= required;
+        }
+
         var fontChanged =
             Mutable.GlobalFontV2 != Plugin.Config.GlobalFontV2
             || Mutable.JapaneseFontV2 != Plugin.Config.JapaneseFontV2

HellionChat/Ui/SettingsTabs/Chat.cs

@@ -145,6 +145,12 @@ internal sealed class Chat : ISettingsTab
                 ref Mutable.SymbolPickerEnabled
             );
             ImGuiUtil.HelpMarker(HellionStrings.Settings_Chat_SymbolPicker_Enable_Description);
+
+            ImGui.Checkbox(
+                HellionStrings.Settings_Chat_NotifyFailedTell_Name,
+                ref Mutable.NotifyFailedTell
+            );
+            ImGuiUtil.HelpMarker(HellionStrings.Settings_Chat_NotifyFailedTell_Description);
         }
     }
 

HellionChat/Ui/SettingsTabs/FontsAndColours.cs

@@ -54,28 +54,23 @@ internal sealed class FontsAndColours : ISettingsTab
 
             if (Mutable.UseHellionFont)
             {
+                // Bundled-font path: only the base font size matters; the
+                // global / japanese / italic chooser pickers do not apply.
                 ImGuiUtil.FontSizeCombo(Language.Options_FontSize_Name, ref Mutable.FontSizeV2);
                 ImGui.Spacing();
-
+            }
-                ImGuiUtil.FontSizeCombo(
+            else
-                    Language.Options_SymbolsFontSize_Name,
+            {
-                    ref Mutable.SymbolsFontSizeV2
+                ImGui.Checkbox(Language.Options_FontsEnabled, ref Mutable.FontsEnabled);
-                );
-                ImGuiUtil.HelpMarker(Language.Options_SymbolsFontSize_Description);
-
                 ImGui.Spacing();
-                return;
             }
 
-            ImGui.Checkbox(Language.Options_FontsEnabled, ref Mutable.FontsEnabled);
-            ImGui.Spacing();
-
             var unused = false;
-            if (!Mutable.FontsEnabled)
+            if (!Mutable.UseHellionFont && !Mutable.FontsEnabled)
             {
                 ImGuiUtil.FontSizeCombo(Language.Options_FontSize_Name, ref Mutable.FontSizeV2);
             }
-            else
+            else if (!Mutable.UseHellionFont)
             {
                 var globalChooser = ImGuiUtil.FontChooser(
                     Language.Options_Font_Name,
@@ -164,23 +159,25 @@ internal sealed class FontsAndColours : ISettingsTab
                     string.Format(Language.Options_Italic_Description, Plugin.PluginName)
                 );
                 ImGui.Spacing();
+            }
 
-                if (ImGui.CollapsingHeader(Language.Options_ExtraGlyphs_Name))
+            // v1.5.3: ExtraGlyphRanges is an atlas-wide property and stays
+            // reachable regardless of UseHellionFont / FontsEnabled state so
+            // users can verify or override the auto-activation on language change.
+            ImGui.Spacing();
+            if (ImGui.CollapsingHeader(Language.Options_ExtraGlyphs_Name))
+            {
+                ImGuiUtil.HelpMarker(
+                    string.Format(Language.Options_ExtraGlyphs_Description, Plugin.PluginName)
+                );
+
+                var range = (int)Mutable.ExtraGlyphRanges;
+                foreach (var extra in Enum.GetValues<ExtraGlyphRanges>())
                 {
-                    ImGuiUtil.HelpMarker(
+                    ImGui.CheckboxFlags(extra.Name(), ref range, (int)extra);
-                        string.Format(Language.Options_ExtraGlyphs_Description, Plugin.PluginName)
-                    );
-
-                    var range = (int)Mutable.ExtraGlyphRanges;
-                    foreach (var extra in Enum.GetValues<ExtraGlyphRanges>())
-                    {
-                        ImGui.CheckboxFlags(extra.Name(), ref range, (int)extra);
-                    }
-
-                    Mutable.ExtraGlyphRanges = (ExtraGlyphRanges)range;
                 }
 
-                ImGui.Spacing();
+                Mutable.ExtraGlyphRanges = (ExtraGlyphRanges)range;
             }
 
             ImGuiUtil.FontSizeCombo(

HellionChat/Ui/SettingsTabs/General.cs

@@ -139,7 +139,12 @@ internal sealed class General : ISettingsTab
             {
                 if (combo.Success)
                 {
-                    foreach (var language in Enum.GetValues<LanguageOverride>())
+                    // None pinned first, then alphabetical by endonym so source order
+                    // (append-only for serialisation safety) is not visible to users.
+                    var sortedLanguages = Enum.GetValues<LanguageOverride>()
+                        .OrderBy(l => l == LanguageOverride.None ? 0 : 1)
+                        .ThenBy(l => l.Name(), StringComparer.InvariantCulture);
+                    foreach (var language in sortedLanguages)
                     {
                         if (ImGui.Selectable(language.Name()))
                         {
@@ -151,6 +156,9 @@ internal sealed class General : ISettingsTab
             ImGuiUtil.HelpMarker(
                 string.Format(Language.Options_Language_Description, Plugin.PluginName)
             );
+            // v1.5.3: HellionChat's font stack covers 24 languages but FFXIV's
+            // engine only supports EN/DE/FR/JA for chat input/sending.
+            ImGuiUtil.WarningText(HellionStrings.Settings_Language_FFXIVCoverage_Warning);
             ImGui.Spacing();
 
             using (

HellionChat/Ui/SettingsTabs/Information.cs

@@ -1,3 +1,4 @@
+using System.Numerics;
 using Dalamud.Bindings.ImGui;
 using Dalamud.Interface;
 using Dalamud.Interface.Colors;
@@ -68,18 +69,38 @@ internal sealed class Information : ISettingsTab
         DrawChangelogSection();
     }
 
-    // Provenance anchor — folded by default so the tab opens to the
-    // version-info section as before. Expands to show the full Hellion
-    // Forge silhouette in monospace.
     private void DrawHellionForgeSection()
     {
-        using var tree = ImRaii.TreeNode("Hellion Forge");
+        var banner = FoxBannerTexture.Shared.GetWrapOrDefault();
-        if (!tree.Success)
+        if (banner is null)
             return;
 
-        using (ImRaii.PushIndent(ImGui.GetStyle().IndentSpacing, false))
+        const uint CardColor = 0xFFE8E8E8; // off-white fill so the dark fox pops
-        using (Plugin.Interface.UiBuilder.MonoFontHandle.Push())
+        var imgHeight = 170f * ImGuiHelpers.GlobalScale;
-            ImGui.TextUnformatted(HellionForgeAscii.FoxBanner);
+        var imgWidth = imgHeight * banner.Size.X / banner.Size.Y;
+        var pad = 14f * ImGuiHelpers.GlobalScale;
+        var cardWidth = imgWidth + pad * 2f;
+        var cardHeight = imgHeight + pad * 2f;
+        var rounding = 8f * ImGuiHelpers.GlobalScale;
+
+        // Left-aligned: card origin stays at the current layout cursor position.
+        var cardOrigin = ImGui.GetCursorScreenPos();
+
+        // Draw the rounded card behind the image, then place the image on top.
+        ImGui
+            .GetWindowDrawList()
+            .AddRectFilled(
+                cardOrigin,
+                cardOrigin + new Vector2(cardWidth, cardHeight),
+                CardColor,
+                rounding
+            );
+        ImGui.SetCursorScreenPos(cardOrigin + new Vector2(pad, pad));
+        ImGui.Image(banner.Handle, new Vector2(imgWidth, imgHeight));
+
+        // Advance the layout cursor past the full card so content below does not overlap.
+        ImGui.SetCursorScreenPos(cardOrigin);
+        ImGui.Dummy(new Vector2(cardWidth, cardHeight));
     }
 
     private void DrawVersionInfoSection()

HellionChat/Ui/SettingsTabs/Tabs.cs

@@ -2,6 +2,7 @@ using Dalamud.Bindings.ImGui;
 using Dalamud.Game.ClientState.Objects.SubKinds;
 using Dalamud.Interface;
 using Dalamud.Interface.Utility.Raii;
+using FFXIVClientStructs.FFXIV.Client.UI;
 using HellionChat.Code;
 using HellionChat.Resources;
 using HellionChat.Util;
@@ -165,6 +166,78 @@ internal sealed class Tabs : ISettingsTab
             }
 
             ImGui.Checkbox(Language.Options_Tabs_ShowTimestamps, ref tab.DisplayTimestamp);
+            ImGui.Checkbox(
+                HellionStrings.Tabs_NotificationSound_Enable_Name,
+                ref tab.EnableNotificationSound
+            );
+            ImGuiUtil.HelpMarker(HellionStrings.Tabs_NotificationSound_Description);
+            if (tab.EnableNotificationSound)
+            {
+                using var indent = ImRaii.PushIndent(10.0f);
+                // Build a readable preview label for the currently selected sound.
+                var soundPreview =
+                    tab.NotificationSoundId <= 16
+                        ? $"{HellionStrings.Tabs_NotificationSound_Option} {tab.NotificationSoundId}"
+                        : $"{HellionStrings.Tabs_NotificationSound_CustomOption} {tab.NotificationSoundId - 16}";
+                using (var combo = ImRaii.Combo($"##notif-sound-{i}", soundPreview))
+                {
+                    if (combo.Success)
+                    {
+                        for (uint s = 1; s <= 16; s++)
+                        {
+                            if (
+                                ImGui.Selectable(
+                                    $"{HellionStrings.Tabs_NotificationSound_Option} {s}",
+                                    tab.NotificationSoundId == s
+                                )
+                            )
+                                tab.NotificationSoundId = s;
+                        }
+
+                        ImGui.Separator();
+
+                        // Bundled custom sounds (ids 17-19).
+                        for (uint n = 1; n <= 3; n++)
+                        {
+                            var customId = 16 + n;
+                            if (
+                                ImGui.Selectable(
+                                    $"{HellionStrings.Tabs_NotificationSound_CustomOption} {n}",
+                                    tab.NotificationSoundId == customId
+                                )
+                            )
+                                tab.NotificationSoundId = customId;
+                        }
+                    }
+                }
+
+                // Let the user hear the currently selected sound without waiting
+                // for a real message to arrive in this tab.
+                ImGui.SameLine();
+                if (
+                    ImGuiUtil.IconButton(
+                        FontAwesomeIcon.Play,
+                        tooltip: HellionStrings.Tabs_NotificationSound_Preview
+                    )
+                )
+                {
+                    var previewId = tab.NotificationSoundId;
+                    if (previewId <= 16)
+                    {
+                        Plugin.Framework.RunOnFrameworkThread(() =>
+                        {
+                            unsafe
+                            {
+                                UIGlobals.PlaySoundEffect(previewId);
+                            }
+                        });
+                    }
+                    else
+                    {
+                        Plugin.CustomAudioPlayer.Play((int)previewId - 16);
+                    }
+                }
+            }
             ImGui.Checkbox(Language.Options_Tabs_PopOut, ref tab.PopOut);
             if (tab.PopOut)
             {

HellionChat/Ui/SettingsTabs/ThemeAndLayout.cs

@@ -295,6 +295,20 @@ internal sealed class ThemeAndLayout : ISettingsTab
                 Mutable.WindowOpacity = opacityPercent / 100f;
             }
             ImGuiUtil.HelpMarker(HellionStrings.Settings_ThemeAndLayout_WindowOpacity_Description);
+
+            ImGui.Spacing();
+            ImGui.Separator();
+            ImGui.Spacing();
+
+            // Master accessibility toggle for the v1.5.4 motion work: the
+            // theme crossfade, the sidebar/card hover lerps and the
+            // unread-tab pulse all read Config.ReduceMotion and snap
+            // instantly when it is on.
+            ImGui.Checkbox(
+                HellionStrings.Settings_ThemeAndLayout_ReduceMotion_Name,
+                ref Mutable.ReduceMotion
+            );
+            ImGuiUtil.HelpMarker(HellionStrings.Settings_ThemeAndLayout_ReduceMotion_Description);
         }
     }
 

HellionChat/Util/ColourUtil.cs

@@ -66,6 +66,18 @@ internal static class ColourUtil
         return ((uint)a << 24) | ((uint)nb << 16) | ((uint)ng << 8) | nr;
     }
 
+    // Modulates the alpha byte of an ABGR color by a factor in [0, 1].
+    // RGB stays intact. Used by the PM-3 hover-lerp path where each
+    // frame produces a fractional alpha value but the colour itself
+    // must not shift.
+    internal static uint ApplyAlpha(uint abgr, float alphaFactor)
+    {
+        alphaFactor = Math.Clamp(alphaFactor, 0f, 1f);
+        var origAlpha = (byte)((abgr >> 24) & 0xFFu);
+        var newAlpha = (byte)Math.Round(origAlpha * alphaFactor);
+        return (abgr & 0x00FFFFFFu) | ((uint)newAlpha << 24);
+    }
+
     public static uint HexToRgba(string hex)
     {
         ArgumentNullException.ThrowIfNull(hex);

HellionChat/Util/FrameLerp.cs

@@ -0,0 +1,17 @@
+namespace HellionChat.Util;
+
+// Framerate-independent smoothing for per-frame hover and motion
+// values. Pattern anchor: Umbra Toolbar.Autohide.cs:55
+// (`v += (target - v) * deltaTime`). The Math.Min(1f, speed*dt)
+// clamp is a deliberate HellionChat addition -- on Wine/DXVK a
+// stalled frame can push deltaTime well over 16ms, which would
+// otherwise let the raw factor exceed 1.0 and overshoot the target.
+// Clamping makes a stalled frame land exactly on target instead.
+internal static class FrameLerp
+{
+    public static float Smooth(float current, float target, float speed, float deltaTime)
+    {
+        var factor = Math.Min(1f, speed * deltaTime);
+        return current + (target - current) * factor;
+    }
+}

HellionChat/_Helpers/FailedTellMatcher.cs

@@ -0,0 +1,27 @@
+using System.Collections.Generic;
+
+namespace HellionChat._Helpers;
+
+// Pure decision helper for failed-tell detection. The processed message
+// stream carries no LogMessage row id, so detection happens at the
+// RaptureLogModule level (see FailedTellNotifier). This POCO stays free of
+// Dalamud types so the "known id AND enabled" rule is Build-Suite testable.
+// TEST-MIRROR: ../../../Hellion Build test/Ui/FailedTellMatcherTests.cs
+public static class FailedTellMatcher
+{
+    // Log-message ids the game raises for a tell that could not be delivered,
+    // pinned from in-game discovery. 50 covers an unreachable recipient
+    // (offline, non-existent, or on another world); 3832 is a recipient
+    // inside an instance.
+    public static readonly IReadOnlySet<uint> FailedTellLogMessageIds = new HashSet<uint>
+    {
+        50u,
+        3832u,
+    };
+
+    public static bool ShouldNotify(
+        uint logMessageId,
+        bool notifyEnabled,
+        IReadOnlySet<uint> failedTellIds
+    ) => notifyEnabled && failedTellIds.Contains(logMessageId);
+}

HellionChat/_Helpers/TabSoundDecision.cs

@@ -0,0 +1,17 @@
+namespace HellionChat._Helpers;
+
+// Pure decision helper: should an incoming message play a per-tab notification
+// sound? Kept Dalamud-free so the Build Suite can test the
+// "inactive + enabled + global-allowed" rule in isolation.
+// TEST-MIRROR: ../../../Hellion Build test/Ui/TabSoundDecisionTests.cs
+public static class TabSoundDecision
+{
+    // True only when the message landed in a tab the user is not looking at,
+    // that tab has its own sound switched on, and the global sound master is
+    // not muted.
+    public static bool ShouldPlay(
+        bool isActiveTab,
+        bool tabSoundEnabled,
+        bool globalSoundsEnabled
+    ) => !isActiveTab && tabSoundEnabled && globalSoundsEnabled;
+}

HellionChat/packages.lock.json

@@ -102,6 +102,15 @@
         "resolved": "4.4.0",
         "contentHash": "QX3bsK9oFeUXk8tFsc9NkI6NnCr8Ar/ex027p+ZZ/jdLCdX2RlryDtxUqZW5j45NVwn4E4Z4hzupsoMQd6Yxtg=="
       },
+      "NAudio.WinMM": {
+        "type": "Direct",
+        "requested": "[2.2.1, )",
+        "resolved": "2.2.1",
+        "contentHash": "xFHRFwH4x6aq3IxRbewvO33ugJRvZFEOfO62i7uQJRUNW2cnu6BeBTHUS0JD5KBucZbHZaYqxQG8dwZ47ezQuQ==",
+        "dependencies": {
+          "NAudio.Core": "2.2.1"
+        }
+      },
       "Pidgin": {
         "type": "Direct",
         "requested": "[3.5.1, 4.0.0)",
@@ -366,6 +375,11 @@
         "resolved": "17.11.4",
         "contentHash": "mudqUHhNpeqIdJoUx2YDWZO/I9uEDYVowan89R6wsomfnUJQk6HteoQTlNjZDixhT2B4IXMkMtgZtoceIjLRmA=="
       },
+      "NAudio.Core": {
+        "type": "Transitive",
+        "resolved": "2.2.1",
+        "contentHash": "GgkdP6K/7FqXFo7uHvoqGZTJvW4z8g2IffhOO4JHaLzKCdDOUEzVKtveoZkCuUX8eV2HAINqi7VFqlFndrnz/g=="
+      },
       "SQLitePCLRaw.bundle_e_sqlite3": {
         "type": "Transitive",
         "resolved": "2.1.11",

README.md

@@ -2,7 +2,7 @@
 
 [![Build](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/actions/workflows/build.yml/badge.svg?branch=main)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/actions/workflows/build.yml)
 [![License: EUPL-1.2](https://img.shields.io/badge/License-EUPL--1.2-blue.svg)](LICENSE)
-[![Latest release](https://img.shields.io/badge/release-v1.5.1-brightgreen)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases/latest)
+[![Latest release](https://img.shields.io/badge/release-v1.5.5-brightgreen)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases/latest)
 [![Dalamud API](https://img.shields.io/badge/Dalamud-API_15-purple)](https://github.com/goatcorp/Dalamud)
 [![.NET](https://img.shields.io/badge/.NET-10.0-512BD4)](https://dotnet.microsoft.com/)
 [![FFXIV](https://img.shields.io/badge/FFXIV-Dawntrail-c3a37f)](https://www.finalfantasyxiv.com/)
@@ -11,7 +11,7 @@
   <img src="docs/images/hellion-forge.png" alt="Hellion Forge" width="180" />
 </p>
 
-**Version 1.5.1** — Privacy-first chat plugin for FINAL FANTASY XIV / Dalamud, built on
+**Version 1.5.5** — Privacy-first chat plugin for FINAL FANTASY XIV / Dalamud, built on
 [Chat 2](https://github.com/Infiziert90/ChatTwo) (EUPL-1.2).
 
 Hellion Chat is a privacy-first plugin built on the Chat 2 foundation. The majority of the engine
@@ -55,7 +55,7 @@ Hellion Chat is developed under **Hellion Forge**, the specialized modding and p
 | UI           | Dear ImGui (Dalamud bindings)                       |
 | Database     | SQLite (Microsoft.Data.Sqlite, MessagePack storage) |
 | Localization | ResX (HellionStrings.resx, .de.resx; PR-based)      |
-| Font         | Exo 2 (SIL Open Font License 1.1, bundled)          |
+| Font         | Inter Light (SIL Open Font License 1.1, bundled)    |
 | Toolchain    | dotnet 10 SDK, VS Code with C# Dev Kit              |
 | Deployment   | GitHub Releases + custom repo (`repo.json`)         |
 
@@ -103,7 +103,7 @@ Hellion Chat is developed under **Hellion Forge**, the specialized modding and p
   Colors: Classic (Chat 2 default), High Contrast, Pastel, Dark Mode Tuned, Hellion (brand), plus
   bonus moods Night Blue and Indigo Violet. One-click apply, battle channels remain untouched.
 - **Window opacity slider** for combat-friendly transparency.
-- **Bundled Hellion font** (Exo 2, OFL-1.1) as an optional default instead of the system font.
+- **Bundled UI font** (Inter Light, OFL-1.1) as an optional default instead of the system font.
 - **Hellion logo** bundled in the plugin and displayed in the Dalamud plugin list.
 
 #### Custom Themes (v1.1.0)
@@ -164,8 +164,8 @@ HellionChat/
 │   ├── HellionStrings.de.resx   # German translation
 │   ├── HellionStrings.Designer.cs # Hand-maintained accessor
 │   ├── ChatColourPresets.cs     # Seven built-in color presets (v0.6.0)
-│   ├── HellionFont.ttf          # Exo 2 variable font
+│   ├── Inter-Light.ttf          # Inter Light static font (bundled UI font)
-│   ├── HellionFont-OFL.txt      # OFL-1.1 license text (bundled with font)
+│   ├── Inter-OFL.txt            # OFL-1.1 license text (bundled with font)
 │   └── Language*.resx           # Upstream localization (Crowdin)
 ├── Ui/
 │   ├── FirstRunWizard.cs        # Three-profile onboarding
@@ -299,6 +299,57 @@ An optional submission to the Dalamud main plugin repo (in addition to the custo
 
 ## Project Status
 
+**Version 1.5.5** — Upstream-Sync Tab-Features. Failed tells now raise a warning toast
+when a message could not be delivered (recipient offline, in an instance, or blocking
+you). Per-tab notification sounds let each tab play one of the 16 game chat sounds or
+three bundled Hellion sounds when a message arrives on a background tab, with a
+preview button. The tab rename field in the right-click menu auto-focuses on open and
+accepts up to 512 characters. A jump-to-latest button appears in the chat log header
+while scrolled up from the live end. Map-flag and item-link insertion is available from
+the chat input right-click menu. The Hellion Forge fox banner in the first-run wizard
+and the Information tab is now a real image. Schema bumped to v18, additive fields
+only, no data migration.
+
+---
+
+### Project status (pre-v1.5.4, kept for context)
+
+**Version 1.5.3** — Localisation Wave + Bundled-Font Overhaul. Twenty-four selectable UI languages
+(Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Italian,
+Japanese, Korean, Norsk bokmål, Polish, Portuguese (Brazil), Portuguese (Portugal), Romanian,
+Russian, Spanish, Swedish, Turkish, Ukrainian, Simplified Chinese, Traditional Chinese); dropdown
+sorts alphabetically by endonym, "None" pinned first. Non-native translations are AI-assisted and
+flagged for community native-speaker review. The bundled UI font swaps from Exo 2 to **Inter
+Light** (SIL OFL 1.1, 343 KB) for wider Latin Extended-A/B, Greek polytonic and Cyrillic Supplement
+coverage. **NotoSansCjkRegular** joins as a third merge layer so Hangul and Simplified-Chinese
+glyphs the FFXIV Japanese game font does not ship now render correctly. First-frame HITCH dropped
+from ~74 ms (v1.5.2 baseline that held since v1.4.x) to a median of ~20 ms (5-reload sample
+17.9-23.6 ms, Linux/Wine) as a side effect: the bundled-font path was silently falling back to the
+FFXIV Axis game font for the entire v1.5.x series because of an early-return in `Plugin.cs:937`.
+The fix routes `RegularFont` through draw whenever either `FontsEnabled` or `UseHellionFont` is on,
+and lands the defer-pattern win v1.5.1 was reaching for. `ExtraGlyphRanges` auto-activates the
+matching flag on language change; two new flags (`LatinExtended`, `Greek`) join the existing set.
+A WarningText under the language dropdown notes that FFXIV's own chat input only fully supports
+EN/DE/FR/JA — other languages may garble when typed in-game. Migration v17 stays.
+
+---
+
+**Version 1.5.2** — First-Run Wizard Rework. The single-page wizard becomes a four-step
+staged-commit flow (Welcome → Privacy → Power Settings → Done). The privacy picker becomes a 2×2
+grid with a fourth profile "Roleplay" that extends Privacy-First with `Say` and both emote types
+under a 30-/90-day retention window. A power-settings stage surfaces six previously-hidden
+`Configuration` defaults in one place without introducing any new settings. The wizard window
+shrinks to 720×480 default (was 900×560, MinimumSize 600×400) after smoke feedback and Step 1
+keeps the fox banner in a folded TreeNode so the onboarding copy stays primary. Existing v1.5.1
+users see the new flow once on first v1.5.2 boot via a new `WizardLastShownVersion` config marker.
+Under the hood: a `WizardStateSmokeStep` joins `/xlperf`, the Build Suite gains twelve pure-helper
+xUnit Facts pinning all four privacy profile sets and the new Roleplay retention overrides.
+Migration v17 stays — `Configuration` only grows one optional string field.
+
+---
+
+### Project status (pre-v1.5.2, kept for context)
+
 **Version 1.5.1** — FontAtlas Refactor and Hellion Forge Signature. The FontManager moves from the
 inherited Chat 2 anti-pattern (null! fields + a separate BuildFonts method) to a hybrid model where
 the game fonts and FontAwesome are init-only handles and only the user-configurable delegate fonts
@@ -318,10 +369,6 @@ defer their font-atlas build to land at ~7 ms; Chat 2 + HellionChat were ~75 ms)
 cost lives in the UiBuilder first-frame render path, not in the atlas build. A first-frame render
 investigation is reserved for a later cycle.
 
----
-
-### Project status (pre-v1.5.1, kept for context)
-
 **Version 1.5.0** — DI Foundation and Service Refactor. Major architecture cycle: the plugin
 bootstrap moves to a generic-host DI container (`Microsoft.Extensions.Hosting` +
 `IServiceCollection`) modelled on Lightless Sync. All 18 instance-class services migrate from a
@@ -345,7 +392,7 @@ Hellion Chat is a standalone plugin, no longer a fork in the repository sense. F
 - First-run wizard with three profiles
 - Plugin identity: own `HellionChat` slot, layout migration from Chat 2, Migrate3 recovery
 - Bilingual UI (EN and DE) with live language switching
-- Hellion theme, Hellion logo, bundled Exo 2 font
+- Hellion theme, Hellion logo, bundled Inter Light font
 - Custom repo pipeline with automated GitHub Release distribution
 - Slash commands consolidated to the `/hellionchat` family
 - Web interface removed (v0.2.0)