zheromiku/UmaViewer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
UmaViewer/docs/LIVE_DEV_MAP.md
T

15 KiB
Raw Permalink Blame History

Live Timeline 开发地图

系统架构

Asset Bundles（游戏加密包）
  └── LiveTimelineWorkSheet（ScriptableObject，103 条轨道的关键帧数据）
        └── LiveTimelineControl（每帧按帧号插值，触发事件）
              └── Director（订阅事件，调用 Unity API）
                    ├── GameObject / Transform  → SetActive, position/rotation/scale
                    ├── Camera                 → fieldOfView, transform
                    ├── Light                  → color, intensity
                    ├── MaterialPropertyBlock  → toon shader 属性（已移植到 URP）
                    ├── ParticleSystem         → emission rate
                    ├── RenderSettings         → fog, ambient
                    └── URP Volume / Feature   → 后处理效果

游戏原版 Built-in 管线；UmaViewer 用 URP 14（Unity 2022.3.62f1）。 Toon shader 已移植，卡住的主要是全屏后处理和几个逆向未完成的轨道。

状态记号

2026-08-05 起区分「实现存在」和「实现被核查过」：

记号 含义
✅ 已实现，且本次审计核查过（读代码 + 用 tools/ 对过 bundle 数据）
✅? 标着已实现，但没人核查过。本项目已经出现过 8 次「看着能用其实整条静默失效」，未核查 ≠ 正常
⚠️ 已实现但不完整，缺的部分写在备注里
❌ 未实现

审计报告见 LIVE_AUDIT_2026-08-05.md。

轨道 → Unity API 对照

GameObject / Transform

轨道 状态 操作
Object (33) ✅? SetActive
Transform (31) ✅ position / rotation / scale。2026-08-05 修：原先只查 StageObjectUnitMap，组名是 GameObject 名（son1028 的 light001_glow_001）时整条轨道静默失效，12 首 / 681 keys 从未生效
WashLight (43) ⚠️ SetActive（颜色/投影未做）
Laser (44) ⚠️ SetActive + transform（blink 未做）
BlinkLight (45) ⚠️ SetActive + 写 Renderer 的 _BlinkLightColor/_ColorPower。2026-08-05 补：调色板槽位映射已逆出 —— 槽位号 = 渲染器自身或最近祖先的 lightNNN_/alphaNNN_ 名字前缀，live10149 每组「前缀种数」与「调色板去重颜色数」精确相等；组内无前缀的渲染器（镜面球球体等）留给它真正的所有者 BgColor1，不再被涂成粉红。剩 color1Array/BlendMode 未做
Spotlight3d (68) ✅ SetActive + 写 Renderer 颜色属性（不是 Unity Light）。2026-08-05 修：原先写 _Color，而 Gallop/3D/Live/Stage/* 下没有任何 shader 声明该属性（133 个全枚举过），颜色写入一直是空操作；灯柱是 StageBeamLight 系列 → _MulColor0 + _ColorPower，改用 BlinkLight 的 shader 探测
Effect (60) ✅? Instantiate prefab

⚠️ 舞台上没有 Unity Light 组件。 live10149 实测：10102 个 GameObject、 898 MeshRenderer、602 SkinnedMeshRenderer、Light 0 个；整个 Live 代码也没有任何 地方读写 Light.color/intensity。所有「灯」都是自发光几何体，靠时间轴写 shader 颜色属性。 本表此前把 BlinkLight / Spotlight3d 写成「子 Light color/intensity」，是错的，已更正。

Camera

轨道 状态
CameraPos (1) / LookAt (2) / Fov (3) / Roll (4) ✅?
CameraSwitcher (11) ✅?
MultiCameraPos (53) / LookAt (54) ✅?

MaterialPropertyBlock → Shader

轨道 状态 属性
BgColor1 (8) 角色分支 ⚠️ _CharaColor/_ToonDarkColor/_ToonBrightColor/_OutlineColor/_Saturation；vertexColorToonPower/outlineWidthPower/LightBlendMode/IsSilhouette 已填入 UpdateInfo 但 handler 还没用
BgColor1 (8) 舞台分支 ⚠️ 2026-08-04 新增。遍历舞台层级按 Transform 名解析 Renderer，写 _MulColor0（已确认）。_AmbientColor 归 BgColor2，别抢
GlobalLight (48) ✅ 角色 rim light 属性。2026-08-05 修：SetPropertyBlock 是整块替换，BgColor1 角色分支在它之后跑，每帧把 13 个 rim 属性全抹掉 —— 全语料 59/59 首同时有这两条轨道，等于从来没生效过。两处都改成 GetPropertyBlock 读-改-写
UVScrollLight (46) ⚠️ _MainTex offset 累积（已修 bug，mulColor 等未用）

ParticleSystem

轨道 状态
Particle (41) ✅? emission.rateOverTime；每帧全场景 GetComponentsInChildren 且漏 inactive
ParticleGroup (42) ✅? FlickerLightRate MinMaxCurve；与 Particle 同名时会覆盖它

RenderSettings

轨道 状态
GlobalFog (49) ⚠️ 已核查：数据是高度雾(isDistance=0,isHeight=1)，却当成距离雾在开；Unity RenderSettings 没有高度雾。见审计报告 C1
BgColor2 (9) ⚠️ 写 _AmbientColor，Lerp(color1, color2, value)。2026-08-05：组名已接通（原先整条被丢弃，最多 15 个组每帧各刷一遍全舞台、只有最后一个留得下来），性能已修。但 BgWashA..O/LaserA..C 既不是 GameObject 名也不是 unit 名，映射未知 —— 解析不到时退回全舞台写入并打警告

URP Volume / RendererFeature

轨道 状态
ChromaticAberration (73) ⚠️ intensity 完成，通道偏移无 URP 对应
ColorCorrection (61) ⚠️ saturation 完成，depth/blend curve 无 URP 对应
HdrBloom (38) ❌ 0/58 首无数据。2026-08-07 起连 handler 和 Bloom override 一并撤掉，只留数据层
PostFilm (39) ⚠️ 数据层已通（三条轨道 → PostFilmRendererFeature.Layers），Feature 已注册进 Renderer 资产但 _enableRendering = false —— 定义 vignette 几何的 shader 不在任何 bundle 里，开着只会画错
RadialBlur (15) / TiltShift (63) / SunShafts (37) ❌ 见后处理 TODO

舞台自带脚本（原版 MonoBehaviour，按签名重建）

分诊规则:舞台元素「行为不对」时,第一嫌疑是缺组件,不是解析错。 至今仍有 728 个 MonoBehaviour 实例是空的(基线 892),光 AnimationObjectController 就占 282 个 —— 舞台上「什么时候动、动多快」的决定原本都在这些缺失的脚本里。 而数据层(字段值 / clip 曲线 / shader 属性表)是能 dump 出来核对的,一路核对下来基本都对。 所以先查「这个物件挂过什么脚本、我们有没有」,再怀疑解析。详见 CLAUDE.md 同名小节。 ⚠ 但别一律归咎于缺组件:光柱变黑墙那次是材质数据问题(URP Lit 属性表把 _DstBlend 从 One 压成 Zero,加法混合变不透明),照样是 dump 出来的。

Assets/Scripts/umamusume.asmdef 的程序集名与 bundle 里写的 umamusume 一致，所以按 类名 + namespace + 程序集名 建类就能让 Unity 把原版的序列化字段真正填进来。 清单和实例数见 CLAUDE.md「用原签名重建脚本」。

脚本 状态
Gallop.MirrorReflection ✅ 已建并实现。第二摄像机 + 反射矩阵 + 斜投影 → RT → _ReflectionTex。顺带解决了长期的「舞台地板发白」 —— mirror_a 的 _ReflectionTex 从没被赋值，Unity 代入白贴图 × 默认 _ReflectionRate = 1.0
Gallop.Live.BillboardController ⚠️ 已建，字段可读（[StageScripts] 丢失数 892→728）。朝向行为写过一版,实机是「一直转来转去而那东西不该转」,已默认关闭(EnableRotation = false)——_rotationType 语义和 up 轴取法都无依据。同批修掉一个确定 bug:目标摄像机被缓存,而生效摄像机随 CameraSwitcher 每帧变
Gallop.Live.AnimationObjectController ❌ 不要建,也不要顶替:实测零序列化字段(282 个实例全空),纯行为类,重建拿不到任何信息。后果是舞台 283 个 Animation 一个都不播(灯球不转/wash 不扫/灯牌不动)——这是有意接受的现状。顶替版 StageAnimationPlayer 已于 2026-08-07 撤除,理由见 LIVE_TRACKS.md 专条
Gallop.RenderPipeline.CustomLensFlare (+LensFlareData) ❌ 未建，但数据齐全、语义不受 IL2CPP 阻塞——LensFlareData 是 Unity legacy Flare 的逐字翻版，URP 侧有 LensFlareComponentSRP 对应。199+5 个物件，星芒在原版截图里很显眼。下一个该做的就是它
Gallop.RenderPipeline.MirrorBallProjector ❌ 字段已 dump，但 4 个 projector 全在原点、共用一个材质、没有任何指向灯球的引用字段——绑定关系只在方法体里。卡住，不是没做
Gallop.Live.ShaderParam.ShaderParamController ⚠️ 实测是空操作（两个向量都是 (1,1,1,1)），从待办里划掉
其余 5 个 ❌ 未建，见 CLAUDE.md 清单

镜面球转速:素材确定,倍率仍未知。 live10149 的 4 个 MirrorBallProjector 全部 MirrorBallIsLoopRotation = 0 / LoopRotationSpeed = 0,shader 的 loop-rotation 通路是 关的;真正在转的是 clip(恒定 −179.50°/s 绕 Y,2.0 s 一圈,7 帧算出来都是这个数), 曾按 currentLiveTime(秒)忠实播过它,实机观察是「所有迪斯科灯球还是太快」 —— 所以原版要么有播放倍率,要么根本不用这条 clip 驱动球体。数据确定的是素材, 不是原版怎么用素材;倍率属于不可知常量,要定它只能对着参考视频标定。 2026-08-07 起播放实现整体撤除,球现在不转,见上一行的专条链接。

内部系统

轨道 状态
CharaMotionSequence (7) / LipSync (12) / FormationOffset (28) ✅?
FacialFace/Eye/Mouth 等 (18–25) ✅?

卡点分类

缺零件（知道要做什么，Unity/URP 没有现成组件）

轨道 缺什么
PostFilm (39) / RadialBlur (15) / TiltShift (63) / SunShafts (37) URP 无对应，需自写 ScriptableRendererFeature + shader → 见 live-shader-todo.md
LightProjection (74) Projector 组件在 URP 不工作，需 DecalProjector 或自定义（36/58 首）
Environment (58) 轨道本身仍未接。但 Planar Reflection 已经不是从零 —— Gallop.MirrorReflection 已实现整条第二摄像机→RT→镜面 shader 的路径，轨道要做的是把 mirrorReflectionRate 这类关键帧接到它上面（48/58 首）
LensFlare (57) UmaBuild 无源码 这句是错的,而且这条已经不缺零件了：CustomLensFlare 的 Flare 指向 Gallop.RenderPipeline.LensFlareData（同程序集的 ScriptableObject，可按签名重建），字段是 Unity legacy Flare 的逐字翻版（ElementArray[{ImageIndex, Position, Size, Color, UseLightColor, Rotate, Zoom, Fade}]），URP 有 LensFlareComponentSRP/LensFlareDataSRP 对应。剩下的是翻译工作，不是逆向工作（45/58 首）

没 dump 找明白（不知道打哪里）

dump 工具链已于 2026-08-04 重建（tools/），这一类现在可以自己解决： ~/.venvs/umatools/bin/python3 tools/dump_cutt_typetree.py --tree <字段名> <songid> 出结构， --sample <字段名> <songid> 出第一个真实关键帧的值。

轨道 不明白什么
MonitorControl (10) dispID 0–15 不对应 monitor 材质索引，内容资源路径未知；颜色/UV 控制可先做（3911 keys / 55 首）
AdditionalLight (82) 字段结构未知，但 AdditionalLightList 确认存在，657 keys / 23 首 → 用 --tree AdditionalLightList 即可 dump

可以直接做

轨道 工作 难度
BgColor1 (8) 缺字段 补 vertexColorToonPower/outlineWidthPower/IsSilhouette/LightBlendMode ★☆☆
BlinkLight (45) 缺字段 color1Array 多色循环、LightBlendMode ★★☆
Billboard (75) 始终朝摄像机面片，Unity 有内置 LookAt 逻辑（12/58 首） ★☆☆
AdditionalLight (82) 先 dump 字段再实现（22/58 首） 待评估

未实现轨道优先级

完整分级见 LIVE_TRACKS.md 末尾「优先级排序」。2026-08-04 用 tools/ 全量重测后重排（59 首全语料，数字是总 keyframe 数）：

  1. BgColor1 (8) 舞台分支 — 43617 keys / 59首，全语料最大轨道。分发过滤已拆，通道已确认为 _MulColor0；剩 BgBL/FollowSpotColor/Shadow/mob_00 4 个非物件名的组待定
  2. BlinkLight (45) 补字段 — 19420 keys / 57首，灯光线最大权重（含全部 *_wash_* 效果）
  3. PostFilm (39) — ~20200 keys / 59首（三字段合计），未实现里最大的一块。旧记录说它「全 0 keyframe」是错的
  4. FacialToon (47) — 6341 keys / 59首，只差 C# 字段 + handler
  5. PostEffectDOF (13) — 3879 keys / 59首，URP 有内置 DepthOfField，属路径 A
  6. VolumeLight / SunShafts (37) — 2048 keys / 58首，字段表齐全，做通后 URP Feature 就有模板
  7. LightProjection (74) — 3793 keys / 37首，URP 下 Projector 不工作
  8. Environment (58) — 1375 keys / 49首，Planar Reflection 从零搭

Environment 之前排第一，现已后移：它属于「从零搭系统」，而 1、2 属于「数据早就在手但没用上」，性价比高一个量级。

旧的 ❌「WorkSheet 无字段」判断多数是错的 —— MobControl / CyalumeControl / NodeScale / SweatLocator / MonitorCameraPos / MonitorCameraLookAt / FacialNoise / CharaMotionNoise 的字段都存在且有数据，它们属于「只差 C# 声明」的第三档，不是被卡住。

关键文件

文件 说明
Assets/Scripts/umamusume/Gallop/Live/Director.cs 事件订阅 + 所有 handler。写 shader 属性统一走共享的 PropBlock，且必须 Get→改→Set
Assets/Scripts/umamusume/Gallop/MirrorReflection.cs 平面镜反射（原版脚本按签名重建）
Assets/Scripts/umamusume/Gallop/Live/StageMissingScriptCensus.cs 缺失脚本普查（[StageScripts] 日志），当重建进度表用
Assets/Scripts/umamusume/Gallop/Live/PostEffect/PostFilmRendererFeature.cs PostFilm 的 URP Feature，默认 _enableRendering = false
Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineControl.cs 每帧插值 + 事件触发
Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineWorkSheet.cs 所有轨道字段声明
Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineDataList/ 各轨道数据类
Assets/Scripts/umamusume/Gallop/Live/StageController.cs StageObjectMap（按名字查舞台对象）；IsTimelineControlledLight() 决定哪些对象默认 inactive（blinklight/spotlight3d/_wash_/laser）
Assets/Resources/RenderPipeline/UMAUniversalRenderPipelineAsset_Renderer.asset RendererFeature 注册位置
LIVE_TRACKS.md 103 条轨道全览（ID/覆盖率/状态/Bug）
live-shader-todo.md 后处理轨道实现细节
LIVE_AUDIT_2026-08-05.md ✅ 轨道审计报告：A1–A4 已修的证据与改法，C1–C3 未修项及其阻塞原因
Reference in New Issue View Git Blame Copy Permalink