v4.0.1: full README parity (6 languages) + version bump

- Expanded the DE/ES/FR/ZH READMEs to match EN/RU: TL;DR, step-by-step install,
  a "Verify it worked" section, an install-pipeline "under the hood" breakdown,
  a macOS split-archive (*.zip.001) join/extract how-to, and the "purchases vs
  content packs" FAQ (why the DLC/appid count is lower than the dlc/ folders).
- Bumped UNLOCKER_VERSION and all six README subtitles to 4.0.1.
- CHANGELOG: added the [4.0.1] section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: 2 people

README.md

@@ -1,6 +1,6 @@
 # EU4 DLC Unlocker for macOS
 
-**Version 4.0 — modular engine, CreamAPI v5.3.0.0, complete DLC unlock, multiplayer supported**
+**Version 4.0.1 — modular engine, CreamAPI v5.3.0.0, complete DLC unlock, multiplayer supported**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-macOS-blue.svg)](https://www.apple.com/macos/)

bin/unlocker

@@ -22,7 +22,7 @@ SELF="$0"
 SELF_DIR="$(cd "$(dirname "$SELF")" && pwd)"
 LIB_DIR="$SELF_DIR/lib"
 
-UNLOCKER_VERSION="4.0"
+UNLOCKER_VERSION="4.0.1"
 
 usage() {
     cat <<EOF

docs/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project are documented here.
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [4.0.1] — 2026-06-19
+
+Documentation and packaging follow-up to 4.0. No behavior change in the engine.
+
+### Changed
+- All six READMEs (EN/RU/DE/FR/ES/ZH) brought to full parity: TL;DR, step-by-step
+  install, a "Verify it worked" section, an "under the hood" breakdown of the
+  install pipeline, a macOS split-archive (`*.zip.001`) join/extract how-to, and
+  a "purchases vs content packs" FAQ explaining why the DLC count (appids) is
+  lower than the number of `dlc/` folders.
+- `--version` now reports `4.0.1`.
+
+### Fixed
+- Dropped the dead `pointfeev/CreamInstaller` credit link — the repo now returns
+  HTTP 451 (Unavailable For Legal Reasons), which failed the link-check CI.
+
 ## [4.0] — 2026-06
 
 Modular rewrite. The two monolithic scripts are replaced by a small,

docs/README_DE.md

@@ -1,6 +1,6 @@
 # EU4 DLC Unlocker für macOS
 
-**Version 4.0 — modulare Engine, CreamAPI v5.3.0.0, vollständige DLC-Freischaltung, Multiplayer unterstützt**
+**Version 4.0.1 — modulare Engine, CreamAPI v5.3.0.0, vollständige DLC-Freischaltung, Multiplayer unterstützt**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-macOS-blue.svg)](https://www.apple.com/macos/)
@@ -84,26 +84,62 @@ beiden Slices `x86_64` und `arm64` — **kein Rosetta 2 auf Apple Silicon nötig
 
 ## 🚀 Installation
 
-1. **Repository klonen oder herunterladen:**
+**Kurzfassung** — drei Befehle, dann das Spiel starten:
+
+```bash
+git clone https://github.com/KyLaEga/EU4-DLC-Unlocker-macOS.git
+cd EU4-DLC-Unlocker-macOS
+./install_dlc_unlocker.sh
+```
+
+### Schritt für Schritt
+
+1. **Stellen Sie zuerst sicher, dass der DLC-Inhalt vorhanden ist.** Der
+   `dlc/`-Ordner des Spiels muss die DLC-Pakete bereits enthalten (das Tool
+   schaltet den Besitz frei, es **lädt keine** Inhalte herunter). Ist der Ordner
+   leer, siehe [Wo bekomme ich die DLC-Inhaltsdateien?](#wo-bekomme-ich-die-dlc-inhaltsdateien) unten.
+
+2. **Repository klonen oder herunterladen:**
    ```bash
    git clone https://github.com/KyLaEga/EU4-DLC-Unlocker-macOS.git
    cd EU4-DLC-Unlocker-macOS
    ```
 
-2. **Installer ausführen:**
+3. **Installer ausführen:**
    ```bash
    ./install_dlc_unlocker.sh
    ```
    Ein dünner Wrapper um `./bin/unlocker install eu4`. Das Tool verifiziert die
-   mitgelieferte Bibliothek, erkennt die EU4-Installation, sichert das Original,
-   installiert CreamAPI und signiert das Ergebnis für Gatekeeper neu.
+   mitgelieferte Bibliothek, erkennt die EU4-Installation (interne **und**
+   externe Laufwerke), sichert das Original als `libsteam_api_o.dylib`,
+   installiert CreamAPI, baut die explizite DLC-Liste aus Ihrem `dlc/`-Inhalt
+   und signiert das Ergebnis ad-hoc für Gatekeeper neu.
+
+   Liegt das Spiel an einem ungewöhnlichen Ort, geben Sie den Pfad direkt an:
+   ```bash
+   ./bin/unlocker install eu4 --path "/Volumes/My Drive/SteamLibrary/steamapps/common/Europa Universalis IV"
+   ```
+
+4. **EU4 über Steam starten.** Mit der expliziten `[dlc]`-Liste funktioniert das
+   auch offline. **Wichtig:** War das Spiel oder der Paradox-Launcher bereits
+   offen, **beenden Sie es vollständig (`⌘Q`)** und starten Sie neu — CreamAPI
+   liest `cream_api.ini` nur einmal beim Prozessstart.
 
-3. **EU4 über Steam starten** (beim ersten Mal online, damit die DLC aufgelöst werden).
+### Überprüfen
 
-Liegt das Spiel an einem ungewöhnlichen Ort, geben Sie den Pfad direkt an:
+Den Patch-Zustand prüfen, ohne etwas zu ändern:
 ```bash
-./bin/unlocker install eu4 --path "/Volumes/My Drive/SteamLibrary/steamapps/common/Europa Universalis IV"
+./bin/unlocker status eu4
+```
+Erwartet wird:
+```
+[+] Patch state:     INSTALLED (CreamAPI active)
+[+] Original backup: PRESENT (...libsteam_api_o.dylib)
+[+] cream_api.ini:   PRESENT
+[*]   unlockall = false; explicit [dlc] list (N DLC)
 ```
+Öffnen Sie dann den **DLC-Tab** im Paradox-Launcher — jedes DLC, dessen Inhalt
+vorhanden ist, sollte nun im Besitz sein (keine „Buy“-Buttons, keine Warnsymbole).
 
 ---
 
@@ -129,6 +165,25 @@ Status ohne Änderung prüfen:
 ./bin/unlocker status eu4
 ```
 
+### Was `install` im Hintergrund macht
+
+1. **Integritätsprüfung** — läuft nur, wenn die mitgelieferte
+   `libsteam_api.dylib` zum festgeschriebenen SHA256 passt (Manipulationsschutz).
+2. **Spiel finden** — expandiert die Suchpfade aus `games/eu4.conf` (mit
+   Leerzeichen und externen `/Volumes/*`-Laufwerken); oder nutzt `--path`.
+3. **Sicherung** des Originals als `libsteam_api_o.dylib` (überschreibt keine
+   vorhandene gute Sicherung).
+4. **CreamAPI installieren** — kopiert die Proxy-dylib und prüft den Hash der
+   Kopie vor dem Neusignieren.
+5. **`cream_api.ini` bauen** — scannt `dlc/*/*.dlc`, sammelt jede `steam_id`,
+   entfernt Duplikate und schreibt eine explizite `[dlc]`-Liste mit
+   `unlockall = false`.
+6. **macOS-Härtung** — entfernt das Quarantäne-Attribut (`xattr`) und signiert
+   die dylib ad-hoc neu (`codesign -s -`), damit Gatekeeper sie lädt.
+
+`uninstall` macht die Schritte 3–4 rückgängig (Sicherung wiederherstellen,
+`cream_api.ini` löschen, neu signieren). `status` zeigt all dies und ändert nichts.
+
 ---
 
 ## 🗑️ Deinstallation
@@ -154,9 +209,33 @@ Die DLC-**Inhaltsdateien** fehlen. Der Unlocker ändert nur den Besitzstatus —
 der eigentliche Inhalt muss im `dlc/`-Ordner des Spiels liegen.
 
 ### Wo bekomme ich die DLC-Inhaltsdateien?
-Paradox-DLC-Inhalte sind plattformübergreifend. Wenn Sie sie von einer
-Windows-/Linux-Installation haben, kopieren Sie den Inhalt des `dlc/`-Ordners
-in Ihre Mac-Installation.
+Dieses Tool **verteilt und lädt keine** DLC — Sie bringen Ihre eigenen mit.
+Paradox-DLC-Inhalte sind plattformübergreifend, also kopieren Sie üblicherweise
+den **`dlc/`-Ordner von einem Rechner, auf dem Sie ihn bereits haben** (z. B.
+eine Ihnen gehörende Windows-/Linux-Installation) in Ihre Mac-Installation unter:
+```
+.../steamapps/common/Europa Universalis IV/dlc/
+```
+Jedes DLC liegt in einem eigenen Unterordner (`dlc/dlcNNN_name/`) mit
+`.dlc`-Metadatei, `.zip` und Thumbnail. Führen Sie danach den Installer (erneut)
+aus, damit die `[dlc]`-Liste aus dem neuen Inhalt neu gebaut wird.
+
+**Inhalt als mehrteiliges Archiv erhalten (`*.zip.001`, `*.zip.002`, …)?**
+Diese Teile sind **ein** in Stücke geteiltes Archiv — keine separaten Zips.
+Zusammenfügen und auf macOS so entpacken (nicht jeden Teil einzeln entpacken):
+```bash
+# 7-Zip kann das oft genutzte LZMA und liest alle Teile automatisch, wenn man
+# auf den ersten zeigt:
+brew install sevenzip
+7zz x "DLC-….zip.001" -o"/Pfad/zu/Europa Universalis IV"   # schreibt den dlc/-Baum
+
+# Alternativ die Teile zuerst zu einer Datei zusammenfügen (Reihenfolge wichtig):
+cat DLC-….zip.00{1,2,3,4} > DLC-….zip
+7zz x DLC-….zip -o"/Pfad/zu/Europa Universalis IV"
+```
+Richten Sie `-o` auf den Spielordner (das übergeordnete Verzeichnis von `dlc/`) —
+das Archiv enthält bereits ein oberstes `dlc/`, das so an Ort und Stelle gemerged
+wird.
 
 ### Steam „Spieldateien überprüfen“ hat meinen Patch zurückgesetzt
 Normal — Steam hat unsere Bibliothek durch das Original ersetzt. Prüfen Sie mit

docs/README_ES.md

@@ -1,6 +1,6 @@
 # EU4 DLC Unlocker para macOS
 
-**Versión 4.0 — motor modular, CreamAPI v5.3.0.0, desbloqueo completo de DLC, multijugador compatible**
+**Versión 4.0.1 — motor modular, CreamAPI v5.3.0.0, desbloqueo completo de DLC, multijugador compatible**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-macOS-blue.svg)](https://www.apple.com/macos/)
@@ -84,26 +84,62 @@ porciones `x86_64` y `arm64` — **no requiere Rosetta 2** en Apple Silicon.
 
 ## 🚀 Instalación
 
-1. **Clona o descarga** el repositorio:
+**Resumen** — tres comandos, luego inicia el juego:
+
+```bash
+git clone https://github.com/KyLaEga/EU4-DLC-Unlocker-macOS.git
+cd EU4-DLC-Unlocker-macOS
+./install_dlc_unlocker.sh
+```
+
+### Paso a paso
+
+1. **Asegúrate primero de que el contenido DLC esté en su sitio.** La carpeta
+   `dlc/` del juego ya debe contener los paquetes de DLC (esta herramienta
+   desbloquea la propiedad, **no descarga** contenido). Si está vacía, mira
+   [¿Dónde obtengo los archivos de contenido DLC?](#dónde-obtengo-los-archivos-de-contenido-dlc) abajo.
+
+2. **Clona o descarga** el repositorio:
    ```bash
    git clone https://github.com/KyLaEga/EU4-DLC-Unlocker-macOS.git
    cd EU4-DLC-Unlocker-macOS
    ```
 
-2. **Ejecuta el instalador:**
+3. **Ejecuta el instalador:**
    ```bash
    ./install_dlc_unlocker.sh
    ```
    Una fina envoltura sobre `./bin/unlocker install eu4`. La herramienta
-   verifica la biblioteca incluida, detecta la instalación de EU4, guarda el
-   original, instala CreamAPI y vuelve a firmar el resultado para Gatekeeper.
+   verifica la biblioteca incluida, detecta la instalación de EU4 (disco interno
+   **y** unidades externas), guarda el original como `libsteam_api_o.dylib`,
+   instala CreamAPI, construye la lista explícita de DLC a partir de tu `dlc/` y
+   vuelve a firmar el resultado en ad-hoc para Gatekeeper.
 
-3. **Inicia EU4 a través de Steam** (en línea la primera vez para resolver los DLC).
+   Si el juego está en una ubicación inusual, indica la ruta directamente:
+   ```bash
+   ./bin/unlocker install eu4 --path "/Volumes/My Drive/SteamLibrary/steamapps/common/Europa Universalis IV"
+   ```
+
+4. **Inicia EU4 a través de Steam.** Con la lista `[dlc]` explícita esto también
+   funciona sin conexión. **Importante:** si el juego o el Paradox Launcher ya
+   estaban abiertos, **ciérralos por completo (`⌘Q`)** y reinicia — CreamAPI lee
+   `cream_api.ini` solo una vez al iniciar el proceso.
 
-Si el juego está en una ubicación inusual, indica la ruta directamente:
+### Verificar
+
+Comprueba el estado del parche sin cambiar nada:
 ```bash
-./bin/unlocker install eu4 --path "/Volumes/My Drive/SteamLibrary/steamapps/common/Europa Universalis IV"
+./bin/unlocker status eu4
 ```
+Deberías ver:
+```
+[+] Patch state:     INSTALLED (CreamAPI active)
+[+] Original backup: PRESENT (...libsteam_api_o.dylib)
+[+] cream_api.ini:   PRESENT
+[*]   unlockall = false; explicit [dlc] list (N DLC)
+```
+Luego abre la pestaña **DLC** en el Paradox Launcher — cada DLC cuyo contenido
+esté presente debería aparecer como propio (sin botones «Buy», sin advertencias).
 
 ---
 
@@ -129,6 +165,24 @@ Comprobar el estado sin cambiar nada:
 ./bin/unlocker status eu4
 ```
 
+### Qué hace `install` por dentro
+
+1. **Control de integridad** — no se ejecuta salvo que la `libsteam_api.dylib`
+   incluida coincida con el SHA256 fijado (protección contra manipulación).
+2. **Localizar el juego** — expande las rutas de `games/eu4.conf` (con espacios y
+   unidades externas `/Volumes/*`); o usa `--path`.
+3. **Copia de seguridad** del original como `libsteam_api_o.dylib` (no sobrescribe
+   una copia buena existente).
+4. **Instalar CreamAPI** — copia la dylib proxy y vuelve a comprobar el hash de
+   la copia antes de firmar.
+5. **Construir `cream_api.ini`** — escanea `dlc/*/*.dlc`, recoge cada `steam_id`,
+   elimina duplicados y escribe una lista `[dlc]` explícita con `unlockall = false`.
+6. **Endurecimiento macOS** — quita el atributo de cuarentena (`xattr`) y vuelve a
+   firmar la dylib en ad-hoc (`codesign -s -`) para que Gatekeeper la cargue.
+
+`uninstall` revierte los pasos 3–4 (restaurar la copia, borrar `cream_api.ini`,
+volver a firmar). `status` informa de todo esto y no cambia nada.
+
 ---
 
 ## 🗑️ Desinstalación
@@ -154,8 +208,32 @@ Faltan los **archivos de contenido** DLC. La herramienta solo cambia el estado
 de propiedad — el contenido debe estar en la carpeta `dlc/` del juego.
 
 ### ¿Dónde obtengo los archivos de contenido DLC?
-El contenido DLC de Paradox es multiplataforma. Si lo tienes de una instalación
-Windows/Linux, copia el contenido de la carpeta `dlc/` a tu instalación de Mac.
+Esta herramienta **no distribuye ni descarga** DLC — tú aportas el tuyo. El
+contenido DLC de Paradox es multiplataforma, así que lo habitual es **copiar la
+carpeta `dlc/` desde una máquina donde ya lo tengas** (p. ej. una instalación
+Windows/Linux tuya) a tu instalación de Mac en:
+```
+.../steamapps/common/Europa Universalis IV/dlc/
+```
+Cada DLC vive en su propia subcarpeta (`dlc/dlcNNN_name/`) con un archivo de
+metadatos `.dlc`, un `.zip` y una miniatura. Después de copiar, ejecuta (o vuelve
+a ejecutar) el instalador para que la lista `[dlc]` se reconstruya.
+
+**¿Recibiste el contenido como un archivo multiparte (`*.zip.001`, `*.zip.002`, …)?**
+Esas partes son **un** archivo dividido en trozos, no zips separados. Únelas y
+extráelas en macOS así (no extraigas cada parte por separado):
+```bash
+# 7-Zip admite el LZMA que suelen usar los paquetes de EU4 y lee todas las partes
+# automáticamente si apuntas a la primera:
+brew install sevenzip
+7zz x "DLC-….zip.001" -o"/ruta/a/Europa Universalis IV"   # escribe el árbol dlc/
+
+# Alternativa: concatena primero las partes en un solo archivo (el orden importa):
+cat DLC-….zip.00{1,2,3,4} > DLC-….zip
+7zz x DLC-….zip -o"/ruta/a/Europa Universalis IV"
+```
+Apunta `-o` a la carpeta del juego (el padre de `dlc/`) — el archivo ya contiene
+un `dlc/` de nivel superior, así que al extraer ahí se fusiona en su sitio.
 
 ### «Verificar integridad» de Steam revirtió mi parche
 Es normal — Steam reemplazó nuestra biblioteca por la original. Comprueba con