Uma Viewer (2)

⚠️ If you see "Failed to load il2cpp" or the app cannot start on Windows, it may be blocked by Windows Smart App Control.

If it fails, turn off Smart App Control:

Windows Security → App & browser control → Smart App Control settings → Off

This issue is caused by Windows blocking unsigned builds. The program should start normally after moving it to a local folder or disabling Smart App Control.

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

Uma Musume: Pretty Derby with full data download is required to run the viewer.
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\...
    - ...\...

Download the most recent UmaViewer.zip file from Releases tab.
Extract the archive anywhere, can be extracted over previous version.
Run the UmaViewer.exe.
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 (Windows x64)

Install Unity Hub and Unity Engine Version 2022.3.62f1, including Windows Build Support if you intend to build a player. This is the project version in ProjectSettings/ProjectVersion.txt.
Clone or download and extract this repository.
Add the project directory in Unity Hub and open it with Unity 2022.3.62f1. Allow Unity to import the supplied assets and resolve the dependencies in Packages/manifest.json (including JSON .NET); an initial package download requires internet access. Runtime files are retained in source control, not repaired by an unspecified missing-file download.
Open Assets/Scenes/Version2.unity and enter Play mode, or build a Windows x64 player from this scene.
Use your existing complete game data as described above. If detection selects the wrong location or your installation is non-default, choose Settings → Other → Change DataPath and select the folder containing meta, master/master.mdb, and dat.

PMX exporter maintainers should also read PMX Export Standard and Postmortem.

Live restoration maintainers should read 2026-10-01 improvement summary and current source-delivery boundary. The historical rendering and physics limitations remain; supplying the runtime dependencies does not establish full visual parity.

Supplied runtime files and local configuration

This source retains the plugin, resources, and runtime defaults supplied by katboi01/UmaViewer: Assets/Plugins/CySpringPlugin.dll and its Unity metadata, Assets/StreamingAssets/cri_auth and sound_proj.acf, and upstream UI/still/background/environment images. Upstream database, asset-bundle, and audio defaults are included. On Windows x64, you do not need to manually add keys, native plugins, or these resources for the upstream-supported setup. Full game data must still be obtained separately; it is not bundled with this repository.

Config.json is generated locally when absent: at the project root in the Editor, or beside the built player. It stores your machine-specific data path and preferences and remains ignored by Git. Optional DBBaseKeyText, DBKeyText, GlobalDBKeyText, ABKeyText, and AudioKeyText overrides remain available for compatible alternate data; blank overrides use the supplied upstream defaults. Overrides use hexadecimal text without a 0x prefix; an audio override must be nonzero and at most 16 hex digits. Restart after editing overrides. A pre-existing local config is not replaced, so review stale paths or custom overrides if you reuse one. No personal Config.json, private credentials, Unity caches, or generated game exports are published. See current publication manifest for source hashes and the delivery inventory. These source-delivery instructions are not a claim that all runtime or rendering checks have passed.

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	/