ВЕРСИИ (25)

## Minecraft 26.3 - Builds against Minecraft 26.3 and Flashback 0.43.4. - Uses official Mojang runtime names for 26.3 compatibility. - Verifies the installable archive and required dependencies in CI.

## Minecraft 26.2 - Builds against Minecraft 26.2 and Flashback 0.43.2. - Uses official Mojang runtime names for 26.2 compatibility. - Verifies the installable archive and required Flashback dependency in CI.

### 0.6.1 (Minecraft 26.1) - Telemetry: every `fbt_*` analytics event now carries an `app=flashbackturbo` tag, so usage data can be segmented correctly in the shared analytics project. Anonymous telemetry is unchanged otherwise and can still be disabled in the config. No gameplay, export quality or performance change.

### 0.6.1 - Telemetry: every `fbt_*` analytics event now carries an `app=flashbackturbo` tag, so usage data can be segmented correctly in the shared analytics project. Anonymous telemetry is unchanged otherwise and can still be disabled in the config. No gameplay, export quality or performance change.

**Silent auto-update.** FlashbackTurbo now keeps your Zeffut mods up to date automatically: on launch it checks Modrinth for newer versions of the mods in your mods/ folder (matching your loader + MC version), downloads verified updates in the background, and swaps them in when you quit the game (a detached helper finishes the swap on Windows). Opt out with "autoUpdate": false in config/flashbackturbo.json (or -Dautoupdate.enabled=false).

**Silent auto-update.** FlashbackTurbo now keeps your Zeffut mods up to date automatically: on launch it checks Modrinth for newer versions of the mods in your mods/ folder (matching your loader + MC version), downloads verified updates in the background, and swaps them in when you quit the game (a detached helper finishes the swap on Windows). Opt out with "autoUpdate": false in config/flashbackturbo.json (or -Dautoupdate.enabled=false).

**H11 — Auto-promote software encoding to GPU.** When an H.264 export would fall back to the slow software encoder (libopenh264), FlashbackTurbo now detects and redirects it to an available hardware encoder (NVIDIA NVENC or Intel QSV) — targeting the ~13% of exports on machines where no GPU encoder was selected. Fully fail-safe (falls back to software if anything fails), no visual quality loss (SSIM ≥ 0.99). Also adds slice-based threading for the software encoder on multi-core CPUs, and anonymous GPU vendor/model telemetry to measure real-world impact.

**H11 — Auto-promote software encoding to GPU.** When an H.264 export would fall back to the slow software encoder (libopenh264), FlashbackTurbo now detects and redirects it to an available hardware encoder (NVIDIA NVENC or Intel QSV) — targeting the ~13% of exports on machines where no GPU encoder was selected. Fully fail-safe (falls back to software if anything fails), no visual quality loss (SSIM ≥ 0.99). Also adds slice-based threading for the software encoder on multi-core CPUs, and anonymous GPU vendor/model telemetry to measure real-world impact.

## 0.4.0+26.1 — Télémétrie anonyme (build MC 26.1) Variante 26.1 de la 0.4.0. Ajoute la **télémétrie d'usage anonyme** (PostHog, désactivable). - 100 % anonyme (UUID local, aucune PII), fail-safe, opt-out via `enableTelemetry: false`. - Suit format/encoder/résolution/framerate/durée d'export + succès/échec. ⚠️ Build cross-version mécanique (non testé en jeu sur 26.1) — comme les précédentes variantes +26.1.

## 0.4.0 — Télémétrie anonyme Ajoute une **télémétrie d'usage anonyme** (PostHog, désactivable) pour prioriser les améliorations : - Suit le format/encoder/résolution/framerate/durée d'export, les activations de hooks (H4/H8/H10), et le **succès/échec** des exports. - **100 % anonyme** : UUID aléatoire local, aucun pseudo/IP/chemin, messages d'exception nettoyés. - **Fail-safe** : hors du chemin d'export, ne ralentit ni ne casse jamais un export. - **Opt-out** : `"enableTelemetry": false` dans `config/flashbackturbo.json`. Voir la section *Telemetry & privacy* du README pour la liste complète des events.

H10 — Corrige un crash d'export Flashback (NullPointerException). ExportJob.setup() de Flashback lit mc.level apres un seul runClientTick(). Sur un export mi-replay (tick de depart != 0), le rechargement du monde laisse mc.level brievement null -> NullPointerException, l'export plante avant la premiere frame. FlashbackTurbo pompe desormais runClientTick jusqu'a ce que le niveau soit charge (timeout 60 s, no-op si deja pret). Flag config: fixExportSetupRace. Durcissement H6/H9: les appels d'options FFmpeg de EncoderTuning sont enveloppes dans try/catch — une option refusee ne peut plus avorter l'export. Bug reproduit et correctif valide de bout en bout en test autonome.

H10 — Corrige un crash d'export Flashback (NullPointerException). ExportJob.setup() de Flashback lit mc.level apres un seul runClientTick(). Sur un export mi-replay (tick de depart != 0), le rechargement du monde laisse mc.level brievement null -> NullPointerException, l'export plante avant la premiere frame. FlashbackTurbo pompe desormais runClientTick jusqu'a ce que le niveau soit charge (timeout 60 s, no-op si deja pret). Flag config: fixExportSetupRace. Durcissement H6/H9: les appels d'options FFmpeg de EncoderTuning sont enveloppes dans try/catch — une option refusee ne peut plus avorter l'export. Bug reproduit et correctif valide de bout en bout en test autonome.

Same as 0.3.7 for the 26.1.x branch. Explicit setScreen(null) cleanup at AsyncFFmpegVideoWriter.finish() TAIL — prevents the SavingExportScreen from lingering in Minecraft's screen field after export completes.

## Audit cycle 4 — clean post-export screen state Fix: when our H8 "Saving..." overlay's finish hook returns, we now explicitly call `setScreen(null)` to fully release Minecraft's screen state. Previously the SavingExportScreen lingered in the Screen field after the export completed — masked visually by Flashback's ImGui editor coming back, but technically still set as the active screen. User-facing effect: mouse events and any edge case where the editor closes before MC re-renders no longer expose the stale overlay. Cosmetic edge case fix. All H2–H9 hooks otherwise unchanged from 0.3.6.

Same as 0.3.6 for the 26.1.x branch — internal cleanup, no runtime behavior change. Removes 2 dead config fields and adds the cross-version build script.

## Audit cycle 1 — dead code cleanup No behavior change at runtime. Internal cleanup after a static audit: - Removed 2 dead config fields (`nativeAlphaCleanup`, `gpuColorspaceConversion`) that were placeholders for hooks never implemented and had 0 references in the codebase. The fields are silently ignored if still present in your existing `config/flashbackturbo.json`. - Added `scripts/build-26.1.sh` to mechanically derive the 26.1.x build from the 1.21.x source (yarn→mojang remapping). Internal tooling, prevents drift between the two branches. All H2–H9 hooks unchanged from 0.3.5. If 0.3.5 works for you, this update is purely cosmetic.

## Port to MC 26.1.x with H8 + H9 Brings the post-export overlay (H8) and fragmented MP4 (H9) introduced in 0.3.5 to the 26.1.x branch. ### What's new vs 0.2.1+26.1 - **H8 — Animated Saving overlay**: full-screen "Finalizing export / Saving... / Xs" with animated dots during the post-export finalize phase (FFmpeg queue drain + trailer write + file move). Replaces the previously frozen-looking window. Uses 26.1's new `extractRenderState(GuiGraphicsExtractor, ...)` Screen API. - **H9 — Fragmented MP4 on hardware encoders**: adds `movflags=+frag_keyframe+empty_moov` to FFmpeg recorder when using videotoolbox / nvenc / qsv / amf. Post-export finalize is ~10× faster on large MP4 files. ~1-3% larger file. Compatible with VLC, IINA, Premiere, DaVinci, Discord, YouTube, browsers. ### All other hooks unchanged - H2 parallel PNG writer - H3 zlib level 1 default - H4 silent 4K downscale cap removed - H6 FFmpeg threading tunes per encoder - H7 PNG color type 2 when transparency off ### Compatibility - MC 26.1 / 26.1.1 / 26.1.2 - Flashback ≥ 0.40.0 - Fabric Loader ≥ 0.19.2 - **Java 25** (MC 26.1 requirement) Build validé runtime sur MC 26.1.2 — Mixins appliquent sans erreur, mod loaded correctly.

## Two new optimizations for the export finalize phase When a Flashback export ends, FFmpeg still has work to do — drain its encoder queues, write the MP4 trailer, move the temp file. Before this release, the game window froze on Flashback's last progress frame during this whole period (often 10-30s on large exports). ### H8 — Animated Saving overlay After the export loop hits 100%, our own full-screen overlay appears: "Finalizing export / Saving... / Xs" with animated dots and elapsed-time counter. Confirms visually that the game is working, not crashed. Mechanism: @Redirect on the LockSupport.parkNanos calls inside AsyncFFmpegVideoWriter.finish()'s wait loops. We park as Flashback expects, plus we render+swap our screen at 4 fps. No interference with Flashback's own progress display during the main export loop — they don't overlap. ### H9 — Fragmented MP4 on hardware encoders For exports using videotoolbox, nvenc, qsv or amf, we add `movflags=+frag_keyframe+empty_moov` to the FFmpeg recorder options. This eliminates the monolithic moov atom (the giant index FFmpeg normally writes at the end of the file) and replaces it with self-contained fragments throughout the file. Result: post-export finalize is ~10× faster on large files. Verified: a 3 GB / 20-minute export now finalizes in seconds instead of tens of seconds. The .mp4 file is ~1-3% larger and is fully compatible with VLC, IINA, Premiere, DaVinci, Discord, YouTube, browsers, and every other modern MP4 player. Toggle `useFragmentedMp4OnHwEncoders` in `config/flashbackturbo.json` to opt out (e.g. for broadcast pipelines requiring strict MP4 layout). ### What 0.3.3 / 0.3.4 broke and 0.3.5 fixes The original 0.3.0–0.3.2 attempts at a progress overlay during the *main* export loop interfered with Flashback's own progress display and its FBO state — exports would fail to start or run at 1/10th speed. 0.3.5 narrows H8 to the post-export phase only, where there is no conflict. Confirmed working in real production exports. ### Compatibility - MC 1.21.9 / 1.21.10 / 1.21.11 with Flashback ≥ 0.39.0 - Fabric Loader ≥ 0.19.2 - Java 21 ### 26.1.x users 26.1.x builds remain on 0.2.1+26.1. MC 26.1 refactored the Screen render API; porting H8 needs further work. The H9 fragmented MP4 optimization will be available when the 26.1 build is updated.

## Fix the 0.3.0 export bug + re-enable H8 0.3.0's H8 Mixin had an invalid `@At("THROW")` annotation which caused the entire `ExportJobProgressMixin` to fail to apply with `InvalidInjectionException`. The error was at Mixin parse time, before our code could even run, and broke the export pipeline. This release: - Removes the invalid `@At("THROW")` and uses `@At("TAIL")` for cleanup (covers normal returns; if export throws, the screen stays — minor cosmetic, will close on next user interaction). - Sets `setScreen()` synchronously instead of via `mc.execute()` to avoid timing issues with Flashback's internal `setScreen(null)` calls. - Re-enables `showExportProgressOverlay` by default. The overlay should now display correctly during exports without breaking them. If you still hit issues, toggle `showExportProgressOverlay = false` in `config/flashbackturbo.json` to revert to vanilla behavior. Apologies again for the 0.3.0 regression.

## Bugfix 0.3.0's export progress overlay (H8) breaks Flashback's export pipeline — the export doesn't start at all. This release disables H8 by default while we investigate. **You should update to 0.3.1.** Without this update, the export overlay is enabled by default and your exports will not start. - All H2–H7 speed optimizations still active. The 10.95× speedup is preserved. - The H8 overlay code is still shipped but inert (toggle `showExportProgressOverlay` in `config/flashbackturbo.json` to try it at your own risk). - A fixed implementation will ship as 0.4.0. Apologies for the regression.

## New: Export progress overlay (H8) Flashback's export blocks the game's render thread for the whole export duration. Vanilla Flashback leaves the user with a frozen-looking window — many users assume the game crashed. This release adds a full-screen overlay shown during the entire export, with: - Frame counter (X / Y) - Progress bar with percentage - ETA in seconds/minutes The overlay redraws at ~10 fps by forcing a manual gameRenderer.render() + glfwSwapBuffers() between each export tick. Toggleable via the new `showExportProgressOverlay` field in `config/flashbackturbo.json`. ## Other changes - All H2-H7 hooks unchanged (10.95× speedup preserved). - No breaking changes vs 0.2.1. ## Note for MC 26.1.x users The 0.3.0+26.1 release is held back: MC 26.1 refactored the Screen render API (now uses `extractRenderState(GuiGraphicsExtractor, ...)` instead of `render(GuiGraphics, ...)`), so the overlay needs a partial rewrite. 26.1 users stay on 0.2.1+26.1 in the meantime (no overlay, but all speedup hooks active).

Metadata fix — no functional change vs 0.2.0+26.1. - Mod description corrected (was inherited from scaffold). - License field set to ARR. No code changes. Stays compatible with Flashback 0.40.0 on MC 26.1.x.

Metadata fix — no functional change. - Updated mod description to reflect actual hooks (was inherited from initial scaffold and mentioned PBO readback / hardware encoder injection that we don't actually implement). - License field corrected from TBD to ARR. - minecraft dependency widened to >=1.21.9 (was >=1.21.11) to match listed game_versions. No code changes. If 0.2.0 works for you, you don't need to update.

Clean release for MC 26.1.x with Flashback 0.40.0. Same hooks as 0.1.0, with removal of internal test scaffolding. - H2: parallel PNG writer (N-1 threads) - H3: configurable zlib level (default L1) - H4: removed silent 4K downscale cap - H6: FFmpeg threading tunes per encoder - H7: color type 2 (RGB) when transparency off Requires Java 25.

Clean release. Same hooks as 0.1.0, with removal of internal test scaffolding from the published jar. - H2: parallel PNG writer (N-1 threads) - H3: configurable zlib level (default L1) - H4: removed silent 4K downscale cap - H6: FFmpeg threading tunes per encoder - H7: color type 2 (RGB) when transparency off Measured speedup at 1080p: 10.95x on real Flashback replay.