Skip to content

optimum 0.3.3 release notes

Jump to bottom
Zaldaryon edited this page Aug 2, 2026 · 6 revisions

Optimum 0.3.3

Optimum 0.3.3 targets Vintage Story 1.22.5 and carries the crash recovery work from the 0.3.2 reports.

Fixes

  • SystemRenderOITLayers validates its framebuffer and shader resources, contains OpenGL failures, restores the active shader, and disables only OIT when the transparent render stage fails.
  • GearRenderer checks shape creation, renderer creation, mesh and shader lifetime, render callbacks, and state updates before it uses them. The Survival runtime manifest selects Init, LoadShader, OnRenderFrame, and updateSuperMechState. The callback restores blend and shader state after a failure.
  • EntityPlayer skips head-controller setup when the client has no animator. EntityHeadController.GetPose returns an empty ElementPose when the animation manager, animator, or named pose is missing.
  • The runtime API patcher leaves the shared AnimatorBase implementation unchanged. The source donor retains the comparer experiment for comparison, while tests cover the IL transformation without shipping it into the integrated server.
  • The launcher validates the hash of every cached patched assembly and writes cache files through temporary paths. A cache validation exception now triggers the existing re-patch path.
  • Bash and PowerShell bootstrap scripts normalize patch, source, generated, and runtime-donor files to LF. Git clone commands set the repository EOL policy before each checkout.
  • The Windows package ships a standalone uninstaller that removes its own folder after PowerShell exits, records cleanup results, reports failed paths, and leaves the user's vanilla Vintage Story installation intact.

Reports reviewed

The review covered the Vigilance and ImpureSoul3 render stacks, the ChestyLaRue Windows checkout report, the KandelKitty uninstall report, server-main.log, server-main (1).log, and message.txt. The server logs also contain third-party Harmony and JSON patch failures. Those stacks name other mods and receive no Optimum code change in this release.

Validation

The official .NET 10 SDK and ilspycmd 10.1.1.8388 produced the donor tree. Patch validation reported 52 source patches, 43 Cecil patches, zero pending patches, and zero conflicts. Exact runtime donor validation applied 22 patches and compiled both donor projects. The solution built with zero warnings and errors. The test suite passed 446 tests with 34 skips. Launcher tests passed 6 tests. Runtime transplant checks covered the Essentials and Survival donors, including both OIT callbacks and the four GearRenderer methods.

Clone this wiki locally