ritenseki d6c262ba93 docs: correct the track data, record what is blocked and why
The pre-2026-08-04 scan data was wrong in two systematic ways, and acting on
it wasted real time. Re-measured everything with tools/ against all 59 songs.

  * Eleven tracks marked "WorkSheet 无 X 字段" do have the field, several with
    substantial data: MobControlKeys (2392 keys), CyalumeControlKeys (2372),
    nodeScaleList (57/59 songs), monitorCameraPos/LookAtKeys, sweatLocatorList,
    facialNoiseKeys, charaMotionNoiseKeys, LipSyncPattern*, and the multi-camera
    bloom keys. These are "just needs a C# declaration", not blocked.
  * Six tracks marked "全 0 keyframe 空占位" carry thousands of keys. PostFilm
    is the worst case at ~20200 keys over 59/59 songs; live-shader-todo.md was
    right to rank it first and LIVE_TRACKS.md was wrong to write it off.

Rows that have been re-measured are tagged ✅实测; untagged rows are still old
data and should be re-verified before anyone acts on them. Priorities are now
ordered by measured data volume crossed with the kind of work required.

Also recorded:
  * The stage shader colour/brightness channel table, and the warning that a
    material's m_SavedProperties lists properties its current shader no longer
    has — enumerate the shader, never trust that table.
  * A working rule: no ground truth, no implementation. Guessing cost two wrong
    PostFilm vignette implementations before it turned out the defining shader
    is not shipped in any bundle. Note that "the property exists" is not "this
    field maps to that property" — that distinction is why BgColor1's power ->
    _ColorPower write was reverted while BlinkLight's was kept.
  * A 「已知未解问题」 section splitting open items into: has ground truth so
    can be built, lacks it so disabled, and rendering problems unrelated to the
    timeline (the stage floor blowing out predates all of this work; the small
    bulbs render black because their shaders expose no colour property at all).
  * Song 1177 (stage live10149) is the reference song used throughout. Earlier
    notes said 1157, which was wrong — that song uses stage live10146.
  * The old UmaCrack tool paths are gone; tools/ replaces them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-05 01:12:22 +08:00
2025-01-20 11:11:43 +01:00
2025-07-20 07:18:58 +02:00
2022-06-18 17:47:39 +02:00
2022-09-07 01:22:44 +08:00
2025-10-03 11:00:39 +02:00

Uma Viewer (2)

Unity application that makes it easy to view assets from Uma Musume: Pretty Derby.

Version Supported
JP (DMM) ✅
JP (Steam) ✅
KR ✅
Global ✅

⚠️ 🌍 EN/Global users ⚠️

In UmaViewer, set WorkMode to Default and Region to Global in the 'Other' Settings tab.

Currently only the default work mode is supported - you need to download assets using the Download All button in the game's settings for the viewer to work.


Requirements/Installation

  1. Uma Musume: Pretty Derby with full data download is required to run the viewer.
  2. Depending on your version and update status, the game stores its data in different locations
  • DMM/Steam Older installations : C:\Users\your_username\AppData\LocalLow\Cygames\umamusume(?)\
  • DMM/Steam Fresh installations : ...\Umamusume installation directory\Umamusume_Data\Persistent(?)\
  • In any case,confirm your file listing in target folder looks like this
    • Target Folder\
      • meta
      • master\
        • master.mdb
      • dat\
        • 2A\...
        • 2B\...
        • ...\...
  1. Download the most recent UmaViewer.zip file from Releases tab.
  2. Extract the archive anywhere, can be extracted over previous version.
  3. Run the UmaViewer.exe.
  4. UmaViewer will try to automatically detect the game data folder.
    • If it fails or shows an error, go to Settings → Other → Change DataPath and manually select target folder.

  • For Developers/Contributors
  1. Unity Hub with Unity Engine Version 2022.3.62f1 is recommended. It should be possible to run it on newer 2022.3.X versions.
  2. Clone or download and extract this repository.
  3. Import and Open the project in Unity Hub, missing files should be automatically repaired.
  4. Open the Assets/Scenes/Version2 scene.

Features

✓ - Working / - Incomplete x - Unsupported
Viewing main character models/animations ✓
Swapping costumes/animations between characters ✓
Viewing chibi models/animations ✓
Viewing mob (NPC) models ✓
Playing facial animations, custom sliders ✓
Cloth/Hair physics ✓
Playing Live Audio with Lyrics ✓
Exporting animations to MMD ✓
Recording animations (.gif), screenshots ✓
Viewing Props, Scenery, Live scenes /
Exporting models /

All characters and animations are supported

Mobs / background characters as well

Mixing outfits and animations

Screenshot and .gif recording

and more

Also check out:

UmaChat by kagari - model viewer fork that lets you chat with Umas using AI + TTS

Special Thank to:

MarshmallowAndroid: UmaMusumeExplorer for acb/awb decoder.

S
Description
Mirror of https://github.com/0xcjy/UmaViewer (Unity Uma Musume viewer)
Readme 159 MiB
Languages
C# 94.3%
GLSL 1.8%
ShaderLab 1.6%
C 0.7%
JavaScript 0.5%
Other 0.9%