pko-tools v0.1.8

Features

• Character action browser: Added CharacterAction.tx and PoseInfo parsing, split-animation export support, action lookup commands, and a frontend action picker for character preview workflows
• Shared effect rendering path: Refactored the standalone effect viewer and item effect viewer onto shared sub-effect frame/material helpers for better parity and less duplicated rendering logic
• Effect skeleton viewer: Added a dedicated skeleton inspection mode in the effect viewer with per-sub-effect hierarchy nodes, orientation arrows, geometry labels, and selected-layer proxy wireframes for debugging effect composition

Improvements

• CLI batch export: Added export_cli --characters mode for batch character GLB export
• Character viewer stability: Moved the action picker out of the Canvas path, hardened split-animation handling, and fixed action-table lookup to key by character ID instead of model number
• Item/effect parity: Wired item effect rendering through the same technique-state and transform/material path used by the standalone effect viewer

pko-tools v0.1.7

Take a look at the assets to download and install this app.

pko-tools v0.1.6

Take a look at the assets to download and install this app.

pko-tools v0.1.5

Features

• Effect rendering engine: Added a D3D8-accurate effect rendering engine with .par binary parser, geometry/state parity fixes matching C++ I_Effect.cpp and eff.fx shader source, and contextual action menus wired into the effect viewport

• Command palette (cmdk): Centralized action registry and keyboard router with a command palette UI, contextual menus across all workbenches, and usage-ranked suggestions

• Map export pipeline (v3): Per-section terrain export for large maps, shared asset export system, GLB writer for terrain and buildings, terrain height grid PNG export, and alpha mask atlas splitting into 16 slices

• Kaitai-only parsing: Migrated all PKO binary format parsers (LGO, LMO, LAB, OBJ, MAP, EFF) to Kaitai Struct adapters with exhaustive parity tests; deleted all legacy native parsers

• pko_inspect CLI: New binary that parses any supported PKO format and prints structured JSON for debugging

• Golden reference snapshot tests: Snapshot tests covering all Kaitai adapters to catch parser regressions

• TRS keyframe export: Animation TRS keyframes and frame rate exported to glTF node extras alongside standard animation channels, with point light data added to the manifest

• Building debug tools: Debug tools, cmdk actions, metadata panel, and UX improvements for the buildings workbench

• Scene object parsing: Full CSceneObjInfo semantic field parsing from sceneobjinfo.bin, including effect texture copying and texuv/teximg/mtlopac animation data

Improvements

• Performance: Code-split routes, tuned vendor chunking, per-workbench frame probes and dev performance overlay, instrumented Tauri invokes with timing metrics, capped DPR, preferred high-performance WebGL, and instanced mesh rendering for map object markers
• Effect performance: Cached cylinder deformation geometry, reused gizmo temporaries, moved playback clock off Jotai frame updates, and disabled persistent draw buffers
• Blend/material state: Per-material blend state via structured PKO suffix, D3DRS_CULLMODE extraction for double-sided materials, alpha test state parsing from V0000/V0001 render state blocks, and additive blend mode + vertex color export from LMO buildings
• Terrain export quality: Clamped boundary vertices to eliminate cliff faces at section edges; removed incorrect 25x height exaggeration from glTF output

Bug Fixes

• DXT1 alpha: Fixed silent alpha channel loss when decoding DXT1/BC1 textures; punch-through alpha now preserved across all DDS-to-PNG conversion paths
• Scene object height: Corrected height sampling to match PKO's bilinear terrain interpolation instead of nearest-tile lookup
• LMO parser: Fixed V0 parser for legacy headers, blend gating, material detection, and incorrect transp_type remapping (subtractive vs. additive)
• Terrain tile colors: Default missing-section tile colors to white instead of black; corrected BGR565 vertex color decode and sea floor triangle emission
• Character animation: Hardened animation teardown during rapid model switches to prevent stale state
• Atlas URI in section GLBs: Removed embedded atlas URI from section GLBs to fix slow Unity import times

pko-tools v0.1.4

Take a look at the assets to download and install this app.

pko-tools v0.1.3

Take a look at the assets to download and install this app.

pko-tools v0.1.2

Take a look at the assets to download and install this app.

pko-tools v0.1.0-alpha.4

Take a look at the assets to download and install this app.

pko-tools v0.1.0-alpha.3

Take a look at the assets to download and install this app.