fix(font): bundled font now actually renders, ship Inter Light, +CJK fallback
Security / scan (push) Successful in 19s
Build / Build (Release) (push) Successful in 29s
Forge Announce / Post changelog to Hellion Forge (push) Successful in 5s
Release / Build and attach release ZIP (push) Successful in 49s

Plugin.cs:937 only pushed RegularFont when Config.FontsEnabled was true.
  FontsAndColours.cs:50 forces FontsEnabled=false whenever UseHellionFont is
  enabled (to hide the chooser UI), so the bundled-font path was silently
  dead and the FFXIV Axis game-font took over. Exo 2 looked "almost right"
  because it overlaps Axis on basic Latin, so the regression went unnoticed
  for the entire v1.5.x series.

  The fix routes RegularFont through draw whenever either FontsEnabled or
  UseHellionFont is on. First-frame HITCH dropped from ~74 ms to ~20 ms
  median (5-reload Linux/Wine sample 17.9-23.6 ms) as a side effect — the
  v1.5.1 "too optimistic" defer-pattern hypothesis was actually a symptom
  of this bug, not bad math.

  Font-stack overhaul on top:
  - Inter Light (Static 18pt-Light, 343 KB, SIL OFL 1.1) replaces Exo 2 as
    the bundled font. Inter ships full Latin Extended-A/B, Greek polytonic
    and Cyrillic Supplement coverage.
  - NotoSansCjkRegular added as a third merge layer for Hangul,
    Simplified-Chinese-specific Han glyphs, and CJK fallbacks the FFXIV
    Japanese font does not ship.
  - Two new ExtraGlyphRanges flags (LatinExtended, Greek) implemented via
    AddChar pair lists in SetUpRanges.
  - Settings.Apply auto-activates the matching ExtraGlyphRanges flag on
    language change. Plugin.LoadAsync runs a one-shot migration that ORs
    in the required flag for an already-selected language.
  - ExtraGlyphRanges CollapsingHeader reachable regardless of
    UseHellionFont (was hidden in the early-return branch).
  - New WarningText below the language combo: FFXIV's chat engine only
    fully supports EN/DE/FR/JA. Other scripts render in the HellionChat
    UI but may garble in in-game chat input/send.

  Localisation wave (originally a FR-only cycle):
  - 24 selectable UI languages. LanguageOverride enum gains 10 new locales
    plus 3 previously commented-out (Italian, Korean, Norwegian with ISO
    code `nb` instead of `no`). All new values append to keep existing
    user-config integer serialisation stable.
  - Resource bundle split: HellionStrings.resx (24 locales, 328 keys) for
    fork-added strings, Language.resx (24 locales, 456 keys) for the
    ChatTwo-Crowdin-heritage. 4 post-sync Crowdin keys backfilled into
    13 legacy locales with per-key AI-assisted comment marker.
  - Em-dash sweep on EN source plus 18 translations. Russian and Ukrainian
    keep their typographic norm.

  Old HellionFont.ttf + HellionFont-OFL.txt removed; Inter-Light.ttf +
  Inter-OFL.txt take their place. Configuration field UseHellionFont keeps
  its name for backwards-compat. Migration v17 stays.
This commit is contained in:
2026-05-19 17:24:17 +02:00
parent 38586db9d8
commit 35e8d3a7fe
68 changed files with 3435 additions and 293 deletions
+88
View File
@@ -11,6 +11,94 @@ releases as an overview and links to the release pages for details.
---
## Hellion Chat 1.5.3 — Localisation Wave + Bundled-Font Overhaul (2026-05-19)
Multi-language pass plus a long-standing first-frame HITCH lands as a side effect of a font-stack
rewrite. The bundled UI font swaps from Exo 2 to Inter Light. HellionChat now ships strings and
renderable glyph coverage for 24 languages.
### User-visible
- 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. The dropdown sorts alphabetically by endonym, "None" pinned first.
Non-native translations are AI-assisted and flagged for community native-speaker review via the
Hellion Forge Discord.
- Bundled **Inter Light** replaces Exo 2 as the in-plugin font. Wider European coverage (Latin
Extended-A/B, Greek polytonic, Cyrillic Supplement) so Czech, Polish, Romanian, Turkish,
Hungarian, Greek and Ukrainian render without manual font configuration. SIL OFL 1.1, 343 KB.
- **NotoSansCjkRegular fallback** layer added as a merge-on-top so Hangul, Simplified-Chinese
characters specific to the post-1956 reform, and other CJK glyphs the FFXIV Japanese game font
does not ship now render correctly inside the HellionChat UI.
- First-frame **HITCH dropped from ~74 ms** (the v1.5.2 baseline that has held since v1.4.x) to a
**median of ~20 ms** (5-reload sample: 23.6 / 20.4 / 17.9 / 20.1 / 19.2 ms, Linux/Wine; Windows
baseline pending Jin's verification per the cross-platform-pflicht). The bundled-font path
silently fell back to the FFXIV Axis game font for the entire v1.5.x series because of an
early-return in the draw loop. The fix that routes `RegularFont` through draw also lands the
defer-pattern win the v1.5.1 cycle was reaching for.
- **ExtraGlyphRanges activates automatically** when the user picks a language that needs a non-Latin
script. Selecting Korean enables the Korean glyph range and rebuilds the atlas without a manual
toggle in Fonts & Colours.
- New **WarningText under the language dropdown** notes that FFXIV's own chat input only fully
supports EN, DE, FR and JA character sets. Other languages render inside HellionChat but may
garble when typed into in-game chat or sent as messages.
### Under the hood
- Three-layer font stack in `FontManager.BuildRegularFontHandle` and `BuildItalicFontHandle`:
Inter Light (or the user-selected global font) as primary, FFXIV JapaneseFont as merge 1 for
native FFXIV kana/kanji style, NotoSansCjkRegular as merge 2 for everything else CJK.
- Two new `ExtraGlyphRanges` flags: `LatinExtended` (U+0100-U+024F) and `Greek` (U+0370-U+03FF +
U+1F00-U+1FFF). Implemented as `builder.AddChar` pair lists in `SetUpRanges` (no managed-pointer
pinning needed).
- `LanguageOverride` enum gains ten locales (Catalan, Czech, Danish, Finnish, Hungarian,
Norwegian, Polish, Portuguese (Portugal), Turkish, Ukrainian) plus three previously
commented-out entries (Italian, Korean, Norwegian re-enabled with code `nb` instead of `no`).
New values are appended to the enum to keep existing user-config integer serialisation stable.
- **Crowdin gap closed:** four ChatTwo keys added after the last community sync
(`Options_ColorSelectedInputChannelButton_Name` / `_Description`,
`Options_HideInNewGamePlusMenu_Name` / `_Description`) are now backfilled into the thirteen
legacy Crowdin locales with per-key AI-translated markers.
- Plugin init runs a one-shot migration that ORs in the matching `ExtraGlyphRanges` flag based on
the user's current `LanguageOverride`. An update from v1.5.2 picks up the new coverage without
the user having to toggle the language twice.
- `Plugin.cs:937` draw-path fixed: `RegularFont` is now pushed whenever **either** `FontsEnabled`
**or** `UseHellionFont` is on. The previous `Config.FontsEnabled`-only check meant the bundled
font path was silently dead whenever `FontsAndColours.cs:50` force-set `FontsEnabled = false` on
the UseHellionFont-toggle. Source of the HITCH win.
- `ExtraGlyphRanges` settings panel is now reachable in **all** UseHellionFont / FontsEnabled
combinations. The bundled-font branch used to short-circuit past it.
- **Resource bundle split:** fork-added strings live in `HellionStrings.resx` (24 locales, 328
keys each) alongside the ChatTwo-Crowdin-heritage `Language.resx` (24 locales, 456 keys each).
The `Language` siblings for the ten brand-new locales and Greek carry a Hellion Forge maintainer
header that points reviewers at the Discord rather than the standalone-hosted Gitea.
- **Em-dash sweep** across the EN source and 18 translations: in-prose em-dashes replaced with
period or colon per the house style guide. Russian and Ukrainian keep their typographic norm
where the em-dash is orthographically required (subject-predicate separator).
- **Bundled font asset rotation:** `HellionFont.ttf` (Exo 2) plus its OFL notice removed from
`Resources/`. `Inter-Light.ttf` plus `Inter-OFL.txt` take their place. `FontManager`
references rename to `BundledFontBytes` / `TryGetBundledFontBytes()` for clarity (config field
`UseHellionFont` keeps its name so existing user configs deserialize cleanly).
### Migration
- Migration v17 stays (no schema bump).
- Existing `UseHellionFont = true` users transition transparently from Exo 2 to Inter Light on
first reload.
- Existing users with `LanguageOverride != None` get their matching `ExtraGlyphRanges` flag set
on the first plugin init after the v1.5.3 update (Plugin.cs LoadAsync migration step).
### Reserved for follow-up cycles
- Native-speaker review pass for AI-assisted translations in the 13 legacy Crowdin locales (ca,
es, fr, it, ja, ko, nl, pt-BR, ro, ru, sv, zh-Hans, zh-Hant) — corrections via the Hellion
Forge Discord.
Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
---
## Hellion Chat 1.5.2 — First-Run Wizard Rework (2026-05-18)
UX patch. The single-page first-run wizard becomes a four-step staged-commit flow, the privacy