Skip to content

v3.0.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jun 23:46
· 632 commits to main since this release
v3.0.0-alpha.1
e9376d4

⚠️ Alpha release. Use, file issues, expect rough edges. Known gaps and ongoing investigations are documented in the memory/ topic notes.

Headline features

🧬 DMP→ESP converter

Turn an Xbox 360 Fallout: New Vegas memory dump into a PC-loadable plugin (.esp + co-emitted .bsa). A new two-pass planner / encoder / merge pipeline covers ~60 FormTypes end-to-end with runtime-read → encoder coverage, plus a post-emission sanitizer pass for FormID, NVEX, and CTDA dangling references. Available as falloutu dmp-to-esp … on the CLI and as a new tab in the WinUI app (multi-DMP picker, dialogue-CSV inputs, secondary-data overlays, live event log).

🏞 v3 worldspace 3D viewer

Real-time WinUI 3 viewer for exterior worldspaces. Five phases shipped:

  • Phase 0 — GPU pipeline migrated from Veldrid to Vortice.Windows / D3D11
  • Phase 1 — Camera, cell-origin transforms, frustum culling
  • Phase 2a — Per-cell terrain meshes from runtime VHGT/VNML, water, walk mode
  • Phase 2b — Per-cell landscape texturing via opacity-blended shaders, world-map 2D overlay system, multi-format Map Export dialog, per-stage frame profiling
  • Phase 2c — Instanced 3D rendering of placed references (statics, doors, containers, lights)

Also in this release

  • 50+ new encoders for the converter — full coverage from ARMA to WRLD
  • GLB exporter generalized — MeshGlbExporter + TerrainGlbExporter replace the deleted OBJ pipeline; NpcGlbWriter → GlbWriter
  • ESP Planner pipeline — Tier 0 through Tier 7b, opt-in via --planner-types
  • PdbStructView runtime layout abstraction + ~30 specialized readers migrated
  • New CLI commands — report validate / report consistency, dmp analyze / compare / formtype-census / scan-cell, dialogue player-lines, esm gameplay-audit, esm diagnose-scripts
  • WindowsAppSDK 1.8 → 2.1.3, centralized package versions via Directory.Packages.props
  • From-scratch test-discipline framework — SyntheticStructFactory, RuntimeReaderTestFixture, snippet harness retired

⚠️ Breaking changes

  • OBJ mesh / terrain exporters removed. Consumers of CLI-driven OBJ output need to switch to GLB.
  • NpcExport{MeshPart,Node,NodeKind,Scene,SkinBinding}.cs → Glb* as part of the GLB writer generalization.
  • CrossDumpComparisonPipeline.cs deleted in favor of the new streaming projection pipeline.

Known alpha limitations

  • DMP→ESP master-cell NAVM augmentation is gated off by default (PluginBuildOptions.EmitMasterCellNavmAugmentation); some new NAVM cells still require an extended NAVI override the planner doesn't yet emit.
  • A WastelandNV-specific crash is under investigation (other worldspaces render fine).
  • v3 viewer's reference renderer is alpha — diffuse-only, no shader effects.

Downloads

Artifact When to use it
FalloutXbox360Utils-Windows-GUI-x64.zip Default Windows download — full WinUI 3 app with GUI tabs (NPC Browser, World Map, DMP→ESP converter, etc.)
FalloutXbox360Utils-Windows-CLI-x64.zip Windows headless — just the falloutu CLI
FalloutXbox360Utils-Linux-CLI-x64.tar.gz Linux headless CLI
FalloutAudioTranscriber-Windows-x64.zip Companion app for transcribing extracted dialogue audio

All builds are self-contained (no .NET runtime install required).

Links

Assets 6
Loading