=====================================================================
 CWIC LINUX/MAC CASE FIX  —  installation guide
 for Cold War Iron Curtain: A World Divided (Steam Workshop 1458561226)
=====================================================================

WHAT THIS FIXES
---------------
On native Linux (and possibly macOS), CWIC crashes to desktop every
time you load into a country in a new 1949 game — a silent segfault
with nothing useful in error.log. This submod fixes that, plus a pile
of related breakage:

  * Renames two GUI element identifiers that contain accented
    characters (e.g. Comecon_Luis_Echeverria) —
    Windows and Linux normalize non-ASCII names differently, so the
    game registers the element under one name and looks it up under
    another, then dereferences the failed lookup. Instant crash,
    no log entry. In-game leader names keep their accents; only
    internal IDs changed.
  * 457 texture references that were broken only by filename CASE
    (fine on Windows, missing-texture on Linux).
  * CWIC's outdated topbar.gui (missing the after_faction_button
    anchor added in the 1.19.2 hotfix) and fonts.gfx (missing two
    vanilla fonts).
  * CWIC's outdated popupwindow.gui (missing special-projects popup
    windows that the 1.19 engine builds at load-in) and six other
    stale vanilla .gui overrides.
  * 215 textures with malformed mipmap chains ("Expected more data
    in the texture mipmaps" errors).
  * Lowercased GUI type keywords (containerwindowtype, icontype,
    gridboxtype) normalized in 7 files.

Built against the CWIC workshop build of 2026-07-04. If CWIC updates
after that date, this fix may need regenerating — if the game starts
crashing again after a CWIC update, disable this submod and check
whether the problem was fixed upstream.

WHAT'S IN THIS FOLDER
---------------------
  cwic_linux_case_fix/        the mod itself (copy this)
  cwic_linux_case_fix.mod     the launcher registration file (copy this)
  INSTALL_README.txt          this file

=====================================================================
 STEP 1 — FIND YOUR MOD FOLDER
=====================================================================

LINUX:
    ~/.local/share/Paradox Interactive/Hearts of Iron IV/mod/

    Note: .local is a hidden folder. In your file manager press
    Ctrl+H to show hidden files, or paste the path into the
    location bar (Ctrl+L in most file managers).

MACOS:
    ~/Documents/Paradox Interactive/Hearts of Iron IV/mod/

    In Finder: Go menu > Go to Folder... (Cmd+Shift+G) and paste
    the path above.

    Mac note: the mod contains both a "gfx" and a "GFX" folder.
    Mac disks usually don't distinguish the two, so they will be
    merged into one folder when you copy or unzip — that is fine
    and expected (no files overlap, and the game finds everything
    either way). If your unzip tool asks about merging folders,
    choose Merge/Keep Both contents.

If there is no "mod" folder inside "Hearts of Iron IV", create it
(exact lowercase name: mod).

=====================================================================
 STEP 2 — COPY TWO THINGS INTO IT
=====================================================================

Copy BOTH of these from this release folder into the mod folder from
Step 1:

    1. the folder        cwic_linux_case_fix
    2. the file          cwic_linux_case_fix.mod

So you end up with:

    .../Hearts of Iron IV/mod/cwic_linux_case_fix/        (folder)
    .../Hearts of Iron IV/mod/cwic_linux_case_fix.mod     (file)

The .mod file uses a relative path ( path="mod/cwic_linux_case_fix" )
so it works as-is — you do NOT need to edit it or type in your
username.

Do not rename the folder or the .mod file, and do not put the folder
inside another folder (a common mistake when unzipping:
mod/cwic_linux_case_fix/cwic_linux_case_fix/... will not load).
The folder you copy must directly contain descriptor.mod, common,
gfx, GFX, and interface.

=====================================================================
 STEP 3 — ENABLE IT IN THE PARADOX LAUNCHER
=====================================================================

 1. Start Hearts of Iron IV from Steam so the Paradox launcher opens.
    (If the launcher was already open, close it fully and reopen —
    it only scans for new mods on startup.)

 2. In the left sidebar click  "All Installed Mods"  and confirm
    "CWIC Linux Case Fix" appears in the list. If it doesn't,
    re-check Step 2 — wrong folder location or an extra nested
    folder are the usual causes.

 3. In the left sidebar click  "Playsets" ,  then open the playset
    you use for CWIC (the one where Cold War Iron Curtain is
    enabled).

 4. Click  "Add More Mods"  (top right), type  "CWIC Linux Case Fix"
    in the search box, tick it, and click  "Add to Playset" .

 5. Make sure the toggle next to CWIC Linux Case Fix is ON (blue),
    and that Cold War Iron Curtain itself is ON too.

 6. LOAD ORDER — this matters. In the playset list, CWIC Linux Case
    Fix must sit BELOW Cold War Iron Curtain (lower = loads later =
    overrides win). The .mod file declares CWIC as a dependency so
    the launcher should order it correctly by itself, but check
    anyway: if the fix is above CWIC, drag it below using the
    handle on the left of its row.

 7. Click  "Play" .  Start a new game, pick any country, and load
    in. Previously the game died at the loading screen or within
    the first in-game hour; with the fix it should load and run.

=====================================================================
 KNOWN INCOMPATIBILITY — CWIC MUSIC ADDON
=====================================================================

The CWIC Music addon (Workshop ID 1364520259) crashes the game on
its own: its musicplayer.gui is from game version 1.15 and is missing
GUI entries that current versions require. This fix mod does NOT
repair it. Keep the Music addon DISABLED in your playset.

=====================================================================
 STILL CRASHING?
=====================================================================

  * Verify the fix mod actually loaded: after a crash, open
    (Linux)  ~/.local/share/Paradox Interactive/Hearts of Iron IV/logs/error.log
    (macOS)  ~/Documents/Paradox Interactive/Hearts of Iron IV/logs/error.log
    and check settings: the launcher writes enabled mods to
    dlc_load.json in the same "Hearts of Iron IV" folder —
    "mod/cwic_linux_case_fix.mod" should be listed AFTER
    "mod/ugc_1458561226.mod".
  * Make sure no other CWIC submod is overriding the same interface
    files (topbar.gui, popupwindow.gui, COMECON_Redux.gui, etc.).
  * If CWIC updated on the Workshop after 2026-07-04, the fix's
    file overrides are forks of the older build and may clash with
    new content — report it / wait for a regenerated fix.

Fix built 2026-07-04/05 against HoI4 1.19.2 and the CWIC build
timestamped 2026-07-04 17:21 EDT.
=====================================================================
