etbw2-mod-v2.2.7
Curse Maven Snippet
What's new
# ETBW2 2.2.7 Changelog
**Version**: etbw2 `2.2.6` → `2.2.7` | Embedded narrative module `etbw2_narrative` `1.8.5` → `1.8.6`
**Environment**: Minecraft 1.20.1 · Forge 47.3+ · Java 17
**Focus**: **Cutscenes go fully live-action and get a stability overhaul — plot4 Defiled-biome camera detour + mechanical damage SFX, plot1 village / amethyst crab / queen dialogue brought on location, and safety-point chunk pinning plus a unified transition across every cutscene.** Dialogue, timing and subtitle formats unchanged.
---
## ⚠️ READ FIRST: subtitle backend stays at 0.2.5
`cinematic_subtitles` is a standalone mod, **not** bundled in core / all. Keep `cinematic_subtitles-0.2.5.jar` in `mods/` (same as 2.2.6 — no upgrade needed). 0.2.5 is required for this version's `.sfst` subtitles to display.
---
## Added
- **Malfunction burst SFX (plot4)**: during the Harbinger near-death cutscene, every random explosion burst on the machine now plays a synced **0.68s "mechanical damage" sound** (2D, no attenuation, master category), matched to the burst particles. The cutscene keeps its "mechanical silence" BGM identity — this is a burst accent, not a soundtrack. Toggle and volume in config (`malfunctionSfxEnabled` / `malfunctionSfxVolume`).
- **Live-scene camera detour to a Defiled biome (plot4)**: the span "The dark purple blight… still spreads… find the Altar of Summoning…" (~24.5s–41.5s) is no longer an empty pan at the horizon — the show now **locates a real Defiled biome (Defiled Lands) in your world** and teleports the camera rig there for three live shots (panorama push-in, low ground sweep, tilt-up to the skyline), returning you to the trigger point before the ending. Site lookup, pre-generation and chunk pinning all happen during the pre-roll loading phase, and the mid-show switch-out / switch-back are **hard cuts with zero waiting** — no more slow void-loading after a teleport. Without the dependency, or if no biome is found in range, plot4 automatically falls back to the original 6-camera rig with no errors or black screen.
- **plot1 village live scene**: the show finds a real village in your world and puts you and the camera on location. The demo villager is on camera from appearance through its mutation into a shadow villager, with close and medium shots. Spawn points and camera positions are validated point by point: the villager stands on open outdoor ground, not stuck in a wall, and the camera position is clear with an unobstructed sightline so buildings never block the mutation close-up. The real village is left untouched — only the demo entities and temporary forced loading are cleaned up afterward.
- **plot1 amethyst crab live scene** (requires the Cataclysm mod and an amethyst crab nest in your world): the camera really teleports into the nest and films **the actual crab entity in the scene**, tilting up slowly from its lower body, then cuts back to the queen close-up on the final blessing line. The segment is skipped automatically if no nest exists.
- **plot1 queen dialogue multi-cam close-ups**: the "Remember this…" → "find the Shadow Stone to open the dimensional gate" span returns to the trigger point and plays the dialogue as shot/reverse-shot, two-shots and over-the-shoulder angles between the queen and the player.
- **plot2 dragon / withered skeleton / lost soul live sync**: in complete mode, after teleporting to the pyramid or frost prison, the dragon and all stage entities render reliably.
- **Complete-cutscene test mode**: `/etbw2 play_cg plot1cg false` / `plot4cg false` now rehearse the **same flow as the real show** (site lookup → loading → live detour or village/Shadow Day script → crab scene → finale) with no boss kill required. If the test save lacks the relevant mods or targets, it falls back to a debug anchor so the full flow stays testable.
## Changed
- **Unified ending / skip transition for all cutscenes**: no more "snap into the player's head for one last frame, then fade to black". At the moment the cutscene is judged finished, it cancels hold-space-to-skip, removes the camera armor stand and returns to first-person, fades in from black while the letterbox bars retract, then restores HUD and control. Skip and natural ending share the same "instant black → immediate fade-in → bars retract" transition, so a successful skip is clearly distinguishable.
- **Chapter-title timing**: after a skip the screen fades in immediately and the chapter number and name appear **together for 3 seconds**, then fade out; a natural ending keeps the chapter number first and the name one second later.
- **forestcg ending moved earlier**: the slow pull-back-and-rise closing shot starts at the final lyric "End this black torrent" (36.2s), moves for 6 seconds to 42.2s, then fades out — the show now ends right around the theme song's end (49.4s), with no dead air after the music.
- **Cutscene theme on its own channel**: the theme now plays on a dedicated jukebox channel, the sole whitelist tag for outside-BGM suppression — the Shadow Day mod's "stop everything on the music channel" call can no longer cut the theme mid-show. Skipping or finishing stops the theme immediately, and outside BGM (Shadow Day / boss / vanilla music) resumes once suppression is released. **Note**: theme volume now follows the **Jukebox / Note Blocks ("Records")** slider instead of the Music slider.
- **Clear two-mode boundary for the test command**: `/etbw2 play_cg <cg>` (no extra argument) is a pure camera preview — no lookup, no preloading, no world-time change; `/etbw2 play_cg <cg> false` is the reachable test entry for the real flow. plot1 / plot2 / plot4 preload before playback with hard cuts in between; the other cutscenes still film around the player and start instantly.
- **Loading-screen text unified**: every pre-roll / live-scene loading screen shows **only "Loading story…"** in game; search radius, location and preload progress are written to the log only.
- During the plot4 live-scene segment the local player model is hidden; after the return, the original boss shots and ending kill play unchanged.
- 4 new config entries under the `plot4cg` section: `malfunctionSfxEnabled`, `malfunctionSfxVolume`, `defiledSceneEnabled`, `defiledSearchRadius` (search radius for the nearest defiled biome, default 1024 blocks, max 8192).
## Fixed
- **plot1 purple-void terrain fixed**: the village and crab live scenes now really teleport the player and camera and rebuild the render grid around them, so the camera and player share one compiled chunk — no more whole segments of purple void from filming empty space hundreds of blocks away. Shadow Day's view-distance fog now keeps the purple-sun fog color but restores the render distance for blocks during the show, so the village scene is no longer crushed into a purple backdrop.
- **plot1 villagers now stay visible**: spawned villagers freeze in place instead of wandering into water or buildings; the mutated shadow villager is set persistent so peaceful difficulty can't despawn it instantly; spawn packets are re-sent after the chunk compiles on a repeating schedule with a client-side ghost fallback; and the shots use server-validated absolute camera positions so close and medium frames stay locked on the villager's face.
- **plot1 return-segment terrain gap fixed**: the same tick the player is teleported back from the village / nest, the surrounding 7×7 chunks are explicitly pushed to the client, so lines like "If we are to save them" no longer sit blank for long on slow devices.
- **plot1 noon and skyward shot aligned**: the noon time switch (6000 ticks) and the upward tilt now share the anchor of the line "this power will tear the sky asunder" — you look up straight into the zenith purple sun. World time advances from its original value when the show ends. The queen close-up locks horizontal facing only and stays level, instead of looking down the whole time.
- **Air / water trigger handling**: triggering while flying high in creative mode no longer force-drops the player or moves them at all — only the camera's rig baseline is lowered to ground / sea level, so lines like "If we are to save them" no longer stare into the night sky. Triggering over water or underwater makes the player invulnerable and stops oxygen drain; an underwater trigger returns you to the liquid surface on ending, and all other triggers return to the trigger point.
- **plot2 teleport-transition void fixed**: a client-side chunk-ready gate plus frame-spread pre-generation of radius-8 chunks before showtime means the pyramid / prison / final return no longer start as a screen full of slow-loading void; the gate uses a stall detector (release only when loading stops making progress) so slow devices still wait for a fully loaded scene. The fallback site now generates the chunk before reading its surface height, fixing a stage being built below bedrock that caused a fully black screen.
- **plot4 remote preloading fixed**: the anchor chunk is generated before reading its surface height, with a height sanity fallback; preloading now uses the vanilla async pipeline with zero main-thread blocking, so remote triggers no longer freeze the server and drop the client.
- **Camera orientation no longer locked to the triggering player's view**: cutscene camera rotation used to be overwritten every frame by Forge with the camera anchor's rotation (inherited from the triggering player's pitch), so triggering while looking up made the whole show face the sky. The computed orientation is now written back to the event, so **all cutscenes** follow their shot-by-shot framing.
- **Resource subtitles now actually load**: fixed a trailing-slash path passed to the subtitle loader that threw on packaged environments — resource SRT / SFST files had never been loaded and every CG silently ran on its built-in fallback table. Edits to subtitle files now take effect.
- **Chapter-title render overlap fixed**: the white chapter name's ghosted copies / white noise are gone; titles are now replaced atomically with immediate clearing, so only one is ever drawn.
- **Cutscene music no longer overlaps modded BGM**: a global music guard (whitelisting the current theme) plus actively stopping BGM already playing when suppression begins, so the theme is no longer drowned out by Cataclysm boss / final boss / Shadow Day tracks.
- **Black screen moved to the queen's killing blow**: the "Loading story…" screen now appears the instant the lethal hit lands, with village lookup, chunk loading and structure search moved behind it.
- **Safety-point chunk pinning for every cutscene**: each cutscene's core-scene chunks are force-pinned and only released when the show ends or is skipped, preventing mid-show unloads that caused voids or lost entities.
- **plot1 complete test mode fixed**: the test branch is wired into the real flow — the black loading screen appears immediately, preloading runs in the background, and noon / Shadow Day trigger at showtime; skip / end / disconnect all restore world time. Also fixed plot1 test mode wrongly registering plot2 stage entities.
## Installation & Dependencies
1. Put **either** `etbw2-1.20.1-2.2.7-core.jar` **or** `-all.jar` in `mods/` — never both.
2. Keep **`cinematic_subtitles-0.2.5.jar`** in `mods/` (unchanged from 2.2.6; remove 0.2.0 / 0.2.2 / 0.2.3).
3. To enable the plot4 live detour, put **`defiledlands-forge-1.10-1.20.1.jar`** and **`TerraBlender-forge-1.20.1-3.0.1.10.jar`** from the `etbw2-2.2.7-实景切镜依赖模组/` folder into `mods/` (only TerraBlender is a hard dependency; Curios / JEI optional). The pack plays fine without them — plot4 falls back automatically.
4. The plot1 amethyst crab scene needs the **Cataclysm** mod and a generated amethyst crab nest in your world; without it that segment is skipped and the rest of the show is unaffected.
5. Do **not** add a standalone `etbw2-narrative-*.jar` (core / all already embed 1.8.6; a duplicate jar makes Forge report a duplicate mod); for the standalone layout, replace the old one with `etbw2-narrative-1.20.1-1.8.6.jar`.
6. Remove any etbw2 jars from 2.2.6 or earlier.
## Notes
- The live detours are **soft dependencies**: biome / village / nest searches are progressive and frame-spread, so they never stall the server; site lookup, pre-generation and pinning all complete before showtime, with hard cuts and zero waiting in between. "Loading story…" only ever appears during pre-roll initialization.
- Sound asset `plot4_mechanical_damage.ogg` is packaged into narrative 1.8.6.
- Self-checks: `gradle build` passed; core / all and the standalone narrative 1.8.6 repacked and integrity-verified (embedded file byte-identical in all three, SFST / SRT cross-checks passed, sound asset and new network packets present); the 9 skip targets, noon time constant, global music guard, live-scene state machine and all nodes were re-checked by disassembling the shipped jars.
- If the village scene ever feels short of terrain, raise your in-game Render Distance to ≥ 8 chunks.
- Always trust the file you downloaded.
---
> **Testing tip**: with the dependency mods installed, trigger plot4 near any Defiled biome in the overworld and watch for the hard cut around 24.5s. Log line `[plot4cg][scene] player teleported to defiled biome` means the detour is active; `no defiled biome within … blocks` means a normal fallback.
>
> **No-boss test saves**: `/etbw2 play_cg plot4cg false` exercises the full live-detour flow; `/etbw2 play_cg plot1cg false` exercises the village / Shadow Day / crab scene / queen dialogue flow (logs: `village placement selected`, `village scene ENTER`, `crab scene ENTER`, `village scene LEAVE`). Without `false` it is a pure camera preview.
>
> **Regression checks**: any cutscene ending / skip should be "instant black → fade-in → bars retract" with the theme stopping immediately; plot1's skyward shot should show the noon purple sun, the village segment should have terrain and villagers, and return-segment terrain should recover within 1–2 seconds; plot2's complete mode should show the dragon and all stage entities after teleport. If anything looks off, send the log for that time span.
All Relations
- All Relations
- Embedded Library
- Optional Dependency
- Required Dependency
- Tool
- Incompatible
- Include