Shadow Cataclysm

# ETBW2 2.2.4 — Changelog

**Version**: etbw2 `2.2.3` → `2.2.4` | bundled narrative module `etbw2_narrative` `1.8.3` → `1.8.4`
**Requires**: Minecraft 1.20.1 · Forge 47.3+ · Java 17
**Scope**: **Phase 1 of the subtitle SRT migration** — establishes the "resource pack first, built-in table as fallback" loading pipeline. **No visual or cinematic changes in this release.**

---

## Added

- **All cutscene dialogue moved to SRT resource files.** Lines are no longer hard-coded: **109 `.srt` files / 559 subtitle cues**, covering **10 cutscenes** and **5 languages** (Simplified Chinese, Traditional Chinese, Classical Chinese, English, Japanese).
- **Hot reload.** Edit an `.srt`, press `F3+T`, replay the cutscene — no recompile or restart required.
- **Optional debug resource pack** (`etbw2-字幕SRT资源包_2.2.4.zip`): enable it to override the bundled subtitles and tweak timings or text directly in-game.
- **Per-role subtitle groups.** Main dialogue, narrator, player lines, glitched system text, weakened speech and soft lyrics are separate files, each mapped to its own subtitle style.
- **Safe fallback.** Missing or unparseable resources automatically fall back to the built-in tables — no black screen, no lost subtitles.

## Changed

- All 20 cutscene subtitle trigger points now route through the new SRT loader; pause / skip behaviour is unchanged.
- Japanese locale unified to `ja_jp` (removed the old `jp_jp` directory).
- **Patchouli manual data pack updated to its final revision**: the book no longer goes blank when optional mods such as Goety, Deeper and Darker or KubeJS are absent.
- Author credit unified to **StarmapleFantasy**.

## Installation & Requirements

- Place **either** `etbw2-1.20.1-2.2.4-all.jar` (full bundle, recommended for PC) **or** `core.jar` in `mods/` — **never both**. Android users should use the standalone jars in `standalone/`.
- **`cinematic_subtitles` is a separate mod and is NOT bundled.** Place `cinematic_subtitles-0.2.3.jar` in `mods/` and remove older 0.2.0 / 0.2.2 copies. Version 0.2.0 still runs 2.2.4, but the visual effects planned for later releases require 0.2.3+.
- **Do NOT add a standalone `etbw2-narrative-*.jar`.** The bundles already embed narrative 1.8.4 via Jar-in-Jar; a duplicate will be rejected by Forge.
- Remove all 2.2.3 or older etbw2 jars — do not run them alongside the new ones.
- If the in-game manual fails to open, enable `etbw2-帕秋莉手册数据包_1.20.1.zip`.

## Notes

- This release is the **loading-pipeline foundation only**. Character colours, true obfuscated text, continuous shake and keyword highlighting are **not implemented yet** and are planned for later versions.
- Core gameplay logic is untouched; subtitle timings and text are identical to 2.2.3.

---

> To adjust timings: enable the SRT resource pack → edit an `.srt` → save → `F3+T` → replay the cutscene.

---

# ETBW2 2.2.5 — Changelog

**Version**: etbw2 `2.2.4` → `2.2.5` | bundled narrative module `etbw2_narrative` remains `1.8.4`
**Requires**: Minecraft 1.20.1 · Forge 47.3+ · Java 17
**Scope**: **SFST pilot for the "plot4 — Harbinger's Death" cutscene**, plus a full visual and pacing rework. All other cutscenes keep their SRT subtitles unchanged.

---

## ⚠️ READ FIRST: upgrade the subtitle backend to 0.2.5

`cinematic_subtitles` is a **separate mod, NOT bundled** in the core / all jars. Place it in `mods/` yourself.
This release requires **0.2.5**: remove `cinematic_subtitles-0.2.2.jar` (and any 0.2.0 / 0.2.3) from `mods/`,
keeping only `cinematic_subtitles-0.2.5.jar`.

> With 0.2.2, style registration fails on a missing `IdleAnimationConfig` and **not a single plot4 subtitle appears**.
> This release adds a graceful fallback — subtitles still show on an outdated backend and a warning is logged —
> but obfuscated text, continuous shake and the red error lines will not work. **Use 0.2.5 for the full experience.**

---

## Added

- **SFST subtitle format pilot.** All **19 plot4 SRT files converted 1:1 into 19 `.sfst` files**, keeping the `{lang}/{style}/{group}` layout — **no single-file merge**. Each cue carries its style name in the first line; the loader prefers `.sfst` and only falls back to `.srt` when absent. Original SRTs are kept, so existing resource-pack overrides and `F3+T` hot reload still work.
- **True obfuscated text now works.** The static block characters `░▒▓` in system error lines are replaced with vanilla `§k` obfuscation, so the glyphs **randomly scramble every frame** in-game. Previously the "glitch" never changed because the files contained no `§k` at all — just hand-typed static characters; the container format was never the cause.
- **Colour scheme finally implemented** (planned back in 2.2.4 Phase 2, but never shipped):
  - Harbinger dialogue is now **blue-grey `#B8C4E3`** via a plot4-only style; the global gold `TYPE_DIALOGUE` is untouched, so **other cutscenes are unaffected**.
  - Key guidance terms are highlighted **light purple `#924EC7`** inline. The bracketed boss title `「悼亡者」` is highlighted **together with its `「」` brackets**, which remain visible on screen. Curly quotes used purely as editing markers do not appear in the final text.
  - Every system line starts with a **cyan `[SYS]`** tag so it cannot be mistaken for a second character speaking. Lines are tiered by severity: **red** for critical errors, **yellow `#ecc720`** for warnings, cyan for everything else.
- **8 new main dialogue lines**, rewritten and aligned across all **5 languages** (Simplified Chinese, Traditional Chinese, Classical Chinese, English, Japanese) with matching highlight positions.
- **Reworked pacing**: every dialogue line stays **3 seconds**, every system line **2 seconds**, so players have time to read.

## Changed

- **The whole cutscene is extended from 45s to 57s.** 22 cues run back-to-back from 0.5s to 56.5s; camera end / fade start moves 40s → 52s, titles 41/42s → 53/54s, boss kill & restore 43.5s → 55.5s, skip target 41.4s → 53.4s. All 8 camera shots and the handheld shake are scaled proportionally, so camera rhythm is unchanged; server-side kills, malfunction particles and the safety timeout shift automatically with the shared timeline constants.
- `.srt` and `.sfst` are now generated from one single source: text, timings, colour tags and `§k` are identical, so **falling back no longer reverts the glitch to static blocks**.

## Fixed

- **Harbinger system lines only shook once at the start.** Added a persistent `idle_animation` SHAKE (1.5 / 0.8 px amplitude, 9 cycles per second) that runs for the full duration of each line, alongside the existing glitch entry / exit.
- **plot2 boss intro dialogue overlapping the cutscene subtitles** when the Ancient Remnant is spawned: the server now pre-sets `etbw2bd_announced=true` so the boss-dialog mod skips this staged entity, and the client clears any leftover instances on start and teardown (belt and braces).
- **Outdated backend compatibility**: a missing 0.2.5 class now degrades gracefully instead of wiping out the entire subtitle layer.

## Installation & Requirements

1. Place **either** `etbw2-1.20.1-2.2.5-core.jar` **or** `-all.jar` in `mods/` — **never both**.
2. Place **`cinematic_subtitles-0.2.5.jar`** in `mods/` separately, and remove all older backends (0.2.0 / 0.2.2 / 0.2.3).
3. **Do NOT add a standalone `etbw2-narrative-*.jar`** — the core jar already embeds it via Jar-in-Jar; a duplicate causes Forge to abort with a duplicate-mod error.
4. Remove 2.2.4 and older etbw2 jars.

## Notes

- This is a **plot4-only pilot**. The remaining 90 SRT files across 9 cutscenes are untouched; full conversion is planned for a later release.
- The embedded narrative version is still `1.8.4` and the project still contains 109 `.srt` files — both are expected. To confirm the update, check for the 19 new `.sfst` files under the plot4 folder.
- The `2.2.5` jars were re-packed in place several times under the same version number — **always use the currently downloaded files**.
- Verification: `gradle build` successful; 22 static checks with 0 failures; end-to-end backend parse (real SFST → block parser → inline colour parser) with 0 failures; core / all re-packed and integrity-checked.

---

> Test in-game with `/etbw2 play_cg plot4cg true`: scrambling glitch text with continuous shake, the cyan `[SYS]` tag with red / yellow / cyan tiers, purple keywords inside blue-grey dialogue, ~3s per line, ~57s total. The log line `[SRT] triggered 'cg_plot4 / dialogue' from resource` confirms the new resources are active.