Vulkan PostFX 1.15.6 Changelog

Added

• Added the native-first safe fallback runtime strategy.

  • VPFX now attempts to use the native direct backend first.
  • If the native backend is unsupported, fails preparation, or fails during frame execution, VPFX automatically falls back to the Minecraft PostChain backend.
  • Native backend failures no longer disable the active VPFX pack by default.

• Added native fallback stage tracking.

  • VPFX can now report where the fallback happened:

    • SUPPORT_CHECK
    • PREPARE
    • FRAME_EXECUTION

  • HUD and diagnostics can now display the native fallback reason.

• Added initial Pack Validation UI support.

  • Invalid VPFX packs are now shown in the pack list instead of being silently ignored.
  • Invalid packs are marked as Invalid.
  • Clicking an invalid pack copies a validation report for easier debugging and issue reporting.

• Added scan-stage issue tracking for VPFX packs.

  • Missing pack.json
  • Manifest parse failures
  • Graph parse failures
  • Missing shaders
  • Fatal validation errors
  • ZIP read failures

Changed

• Changed VPFX backend selection to prefer native direct execution while keeping Minecraft PostChain as the safe fallback backend.

• Changed native backend failure handling so that native failures fall back to PostChain instead of failing the whole pack.

• Changed ZIP pack scanning so broken VPFX packs are preserved as invalid UI entries.

• Changed the shader pack selection screen to use VpfxPackListEntry, allowing packs to be displayed as:

  • VALID
  • WARNING
  • INVALID

• Improved fallback diagnostics shown in HUD, UI services, and failure reports.

Fixed

• Fixed native direct backend failures incorrectly disabling the active VPFX pack.
• Fixed native frame execution failures potentially causing black screens or broken rendering state.
• Fixed missing native fallback stage information in diagnostics.
• Fixed invalid VPFX ZIP packs being silently skipped during scanning.
• Fixed missing shader, missing target, malformed graph, and broken manifest errors not being visible from the UI.
• Fixed scan-stage exceptions potentially disrupting the whole pack list.

Removed

• Removed the old behavior where invalid VPFX packs were silently ignored during scanning.
• Removed the old behavior where native backend failure could immediately mark the active VPFX pack as failed.
• Removed several log-only error paths by surfacing pack validation issues through the UI instead.

Developer Notes

This release focuses on VPFX v0.2 stabilization. The main goal is not to add new visual effects, but to improve backend reliability, automatic fallback behavior, and pack author debugging.

Recommended test cases:

• A VPFX pack that works on the native backend.
• A VPFX pack that cannot use native but works on PostChain.
• A pack with a missing shader file.
• A pack with an invalid graph target reference.
• A ZIP pack with a missing or malformed pack.json.