diff --git a/LIVE_DEV_MAP.md b/LIVE_DEV_MAP.md new file mode 100644 index 0000000..d6ccfb6 --- /dev/null +++ b/LIVE_DEV_MAP.md @@ -0,0 +1,133 @@ +# 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 已移植,卡住的主要是全屏后处理和几个逆向未完成的轨道。 + +--- + +## 轨道 → Unity API 对照 + +### GameObject / Transform +| 轨道 | 状态 | 操作 | +|------|------|------| +| Object (33) | ✅ | `SetActive` | +| Transform (31) | ✅ | position / rotation / scale | +| WashLight (43) | ⚠️ | `SetActive`(颜色/投影未做) | +| Laser (44) | ⚠️ | `SetActive` + transform(blink 未做) | +| BlinkLight (45) | ⚠️ | `SetActive` + 子 `Light`(color1Array/BlendMode 未做) | +| Spotlight3d (68) | ✅ | `SetActive` + `Light.color/intensity` | +| Effect (60) | ✅ | `Instantiate` prefab | + +### 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 等未传) | +| GlobalLight (48) | ✅ | 角色 rim light 属性 | +| UVScrollLight (46) | ⚠️ | `_MainTex` offset 累积(已修 bug,mulColor 等未用) | + +### ParticleSystem +| 轨道 | 状态 | +|------|------| +| Particle (41) | ✅ `emission.rateOverTime` | +| ParticleGroup (42) | ✅ `FlickerLightRate` MinMaxCurve | + +### RenderSettings +| 轨道 | 状态 | +|------|------| +| GlobalFog (49) | ✅ fogColor / fogMode / fogDensity / fogStart / fogEnd | +| BgColor2 (9) | ⚠️ 接线完成,`RenderSettings.ambient*` 打错目标(见卡点) | + +### URP Volume / RendererFeature +| 轨道 | 状态 | +|------|------| +| ChromaticAberration (73) | ⚠️ intensity 完成,通道偏移无 URP 对应 | +| ColorCorrection (61) | ⚠️ saturation 完成,depth/blend curve 无 URP 对应 | +| HdrBloom (38) | ❌ 0/58 首无数据,无需实现 | +| PostFilm (39) / RadialBlur (15) / TiltShift (63) / SunShafts (37) | ❌ 见后处理 TODO | + +### 内部系统 +| 轨道 | 状态 | +|------|------| +| 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 系统完全没有(第二摄像机→RenderTexture→地板 shader)(48/58 首)| +| LensFlare (57) | 舞台用 `CustomLensFlare` 脚本,UmaBuild 无源码;可先做 SetActive(45/58 首)| + +### 没 dump 找明白(不知道打哪里) + +| 轨道 | 不明白什么 | +|------|-----------| +| BgColor2 (9) | entry 名 `BgWashA`~`J` 在所有 bundle 里找不到;舞台 shader 不响应 `RenderSettings.ambient`(15/58 首)| +| MonitorControl (10) | `dispID` 0–15 不对应 monitor 材质索引,内容资源路径未知;颜色/UV 控制可先做(★★/58 首)| +| AdditionalLight (82) | 字段未 dump,结构未知(22/58 首)| + +### 可以直接做 + +| 轨道 | 工作 | 难度 | +|------|------|------| +| BgColor1 (8) 缺字段 | 补 `vertexColorToonPower`/`outlineWidthPower`/`IsSilhouette`/`LightBlendMode` | ★☆☆ | +| BlinkLight (45) 缺字段 | `color1Array` 多色循环、`LightBlendMode` | ★★☆ | +| Billboard (75) | 始终朝摄像机面片,Unity 有内置 LookAt 逻辑(12/58 首)| ★☆☆ | +| AdditionalLight (82) | 先 dump 字段再实现(22/58 首)| 待评估 | + +--- + +## 未实现轨道优先级(综合覆盖率 + 难度) + +1. **AdditionalLight (82)** — 22/58 首,先 dump 评估 +2. **Billboard (75)** — 12/58 首,简单 +3. **BgColor1 缺字段** — 58/58 首都有,补全影响所有歌 +4. **LensFlare SetActive (57)** — 45/58 首,先做 enableFlare 这一层 +5. **后处理系列** — 见 `live-shader-todo.md` +6. **MonitorControl 框架 (10)** — 颜色/UV 先做,dispID 留 TODO +7. **LightProjection (74)** — 工程量大 +8. **Environment (58)** — 最复杂,Planar Reflection 从零搭 + +--- + +## 关键文件 + +| 文件 | 说明 | +|------|------| +| `Assets/Scripts/umamusume/Gallop/Live/Director.cs` | 事件订阅 + 所有 handler | +| `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(按名字查舞台对象)| +| `Assets/Resources/RenderPipeline/UMAUniversalRenderPipelineAsset_Renderer.asset` | RendererFeature 注册位置 | +| `LIVE_TRACKS.md` | 103 条轨道全览(ID/覆盖率/状态/Bug)| +| `live-shader-todo.md` | 后处理轨道实现细节 | diff --git a/live-shader-todo.md b/live-shader-todo.md index 3822d26..d73a05c 100644 --- a/live-shader-todo.md +++ b/live-shader-todo.md @@ -1,83 +1,33 @@ -# Live Timeline 轨道实现 TODO +# Live 后处理轨道 TODO -UmaViewer 逆向实现了游戏的 Live 演出系统: -- 解密加载 asset bundle → 反序列化 `LiveTimelineWorkSheet` → `LiveTimelineControl` 每帧插值触发事件 → `Director` 订阅事件调用 Unity API -- 游戏原版 Built-in 管线;UmaViewer 用 URP 14(Unity 2022.3.62f1),toon shader 已移植 -- 103 条轨道中约 21 条完整,其余卡点分两类(见下) +全局开发地图见 `LIVE_DEV_MAP.md`。本文件只覆盖需要 URP 移植的后处理效果。 --- -## 卡点分类 - -### 缺零件(知道要做什么,Unity/URP 没有现成组件) - -| 轨道 | 缺什么 | -|------|-------| -| PostFilm (39) / RadialBlur (15) / TiltShift (63) / SunShafts (37) | URP 无对应效果,需自写 ScriptableRendererFeature + shader | -| LightProjection (74) | Unity `Projector` 组件在 URP 不工作,需 DecalProjector 或自定义实现 | -| Environment (58) | Planar Reflection 系统(第二摄像机→RenderTexture→地板 shader)项目里完全没有 | -| LensFlare (57) | 舞台用 `CustomLensFlare` 脚本,UmaBuild 里无源码 | - -### 没 dump 找明白(不知道打哪里) - -| 轨道 | 不明白什么 | -|------|-----------| -| BgColor2 (9) | entry 名 `BgWashA`~`J` 在所有 bundle 里找不到,目标对象未知 | -| MonitorControl (10) | `dispID` 值 0–15 不对应 monitor 材质索引,内容资源路径未知 | -| AdditionalLight (82) | 字段未 dump,结构未知 | - -### 两个都缺一点 - -| 轨道 | 情况 | -|------|------| -| WashLight (43) | 对象能找到,`RaycastDistance`/`CameraProjection` 语义不明,可能需要 Projector | -| UVScrollLight (46) | 知道怎么修(offset 累积),还没动手 | - ---- - -## 已实现但不完整的 Handler(`Director.cs`) - -| Handler | 问题 | 难度 | -|---------|------|------| -| ~~`OnBlinkLightUpdate`~~ | ✅ 已修复:`pattern==0` 走静态路径,`pattern!=0` 用 `turnOnTime`/`keepTime`/`turnOffTime`/`intervalTime`/`waitTime`/`loopCount`/`powerMin`/`powerMax` 计算每帧强度(含淡入淡出)。剩余未做:`color1Array`、`LightBlendMode`、颜色混合字段 | — | -| `OnUVScrollLightUpdate` | `scrollSpeedX/Y` 映射为 `SetTextureScale` 可能错误——若原版 shader 以速度做每帧增量位移,应改为 `offset += speed * deltaTime`。另:`mulColor1`、`ColorType`、`CharacterIndex`、颜色混合字段未使用 | ★☆☆(待确认语义) | -| ~~`OnParticleGroupUpdate`~~ | ✅ 已修复:改用 `MinMaxCurve(FlickerDarkRate, FlickerLightRate)`,Unity 粒子系统在两个发射率之间随机取值,自然模拟闪烁 | — | -| `OnWashLightUpdate` | 仅 `SetActive(true)`,`RaycastDistance`/`CameraProjectionSide`/`CameraProjectionColorPower` 未使用,需 Projector 或自定义投影组件 | ★★☆ | -| `OnLaserUpdate` | `blink`/`blinkPeriod`/`degLaserPitch`/`RaycastDistance`/`formation`/`posInterval` 未使用 | ★★☆ | - -### 剩余问题说明 - -**UVScrollLight scrollSpeed**:需先用 `read_cutt_effect.py` dump 一首有 UV 滚动的曲目,对比 `scrollSpeedX/Y` 的实际值和视觉效果来确认语义。如果值是每秒 offset 增量,改为在 handler 里维护累计 offset(需持久化,不能每帧从 keyData 重置)。 - -**WashLight / Laser**:依赖舞台 prefab 的实际组件结构,需先加载一个含 WashLight/Laser 的 Live 看 prefab 里有什么,才能决定如何驱动。在此之前无法实现。 - ---- - -## 架构说明(必读) - -### 为什么不能直接用旧方法 +## 为什么不能直接用旧方法 Built-in 管线支持 `OnRenderImage()`,脚本可直接拦截帧缓冲做全屏处理。**URP 删掉了这个接口**。 项目同时装了 `com.unity.postprocessing 3.4.0`(旧 Built-in 包)和 URP 14。`Screenshot.cs` 在用旧包的 `PostProcessLayer`,但该组件在 URP 管线下**不渲染任何效果**,只是没报错。后续实现不要依赖旧包。 -### 两种实现路径 +--- -**路径 A — URP Volume Override(适用于内置效果)** +## 两种实现路径 + +### 路径 A — URP Volume Override(适用于内置效果) 摄像机上挂 `Volume` 组件,`VolumeProfile` 里添加对应 Override,每帧在 Director handler 里设值: ```csharp _liveTimelineControl.OnUpdateXxx += (data, keyData) => { - var vol = Camera.main.GetComponent(); - if (vol.profile.TryGet(out var fx)) + if (_postProcessVolume.profile.TryGet(out var fx)) fx.someParam.Override(keyData.value); }; ``` 适用:ChromaticAberration、Bloom、ColorAdjustments、DepthOfField。 -**路径 B — ScriptableRendererFeature(适用于自定义效果)** +### 路径 B — ScriptableRendererFeature(适用于自定义效果) URP 在管线中插入自定义 Render Pass,用 Material 做全屏 Blit: @@ -90,16 +40,9 @@ ScriptableRendererFeature ← 注册到 Renderer Asset Feature 暴露公开字段,Director 持有 Feature 引用,每帧写入参数: ```csharp -// Director 字段 private PostFilmRendererFeature _postFilmFeature; - -// InitializeTimeline 里获取 -var data = GraphicsSettings.currentRenderPipeline as UniversalRenderPipelineAsset; -_postFilmFeature = data.GetRenderer(0) ... // 或序列化直接引用 - -// handler 里设值 +// handler 里: _postFilmFeature.settings.color0 = keyData.color0; -_postFilmFeature.settings.filmMode = (int)keyData.filmMode; ``` Feature 必须在 `UMAUniversalRenderPipelineAsset_Renderer.asset` 的 Renderer Features 列表里手动添加。 @@ -108,27 +51,25 @@ Feature 必须在 `UMAUniversalRenderPipelineAsset_Renderer.asset` 的 Renderer --- -## 分组与优先顺序 +## 优先顺序 -### 第一组:URP 内置,工作量小 +### 第一组:URP 内置,工作量小(路径 A) | 优先级 | Track ID | 字段名 | URP 类型 | 覆盖率 | |--------|----------|--------|---------|--------| | 1 | 73 | `chromaticAberrationList` | `ChromaticAberration` | 22/58 | -| 2 | 38 | `hdrBloomKeys` | `Bloom` | 58/58(疑似骨架) | -| 3 | 61 | `colorCorrectionDataLists` | `ColorAdjustments` + `ColorCurves` | — | -| 4 | 13 | `postEffectDOFKeys` | `DepthOfField` | — | +| 2 | 61 | `colorCorrectionDataLists` | `ColorAdjustments` + `ColorCurves` | 47/58 | +| 3 | 13 | `postEffectDOFKeys` | `DepthOfField` | — | +| — | 38 | `hdrBloomKeys` | — | 0/58,无需实现 | -这四个照标准 5 步走,在 Director handler 里操作 Volume 即可。 - -### 第二组:自定义 shader,工作量大 +### 第二组:自定义 shader,工作量大(路径 B) | 优先级 | Track ID | 字段名 | 覆盖率 | 备注 | |--------|----------|--------|--------|------| -| 5 | 39 | `postFilmKeys` / `postFilm2Keys` / `postFilm3Keys` | 58/58 | 最复杂,优先做 | -| 6 | 37 | `volumeLightKeys` | 58/58 | 数据类已有,shader 需移植 | -| 7 | 15 | `radialBlurKeys` | 58/58(骨架居多) | 大多数曲目值为0 | -| 8 | 63 | `tiltShiftKeys` | 58/58(骨架居多) | 大多数曲目值为0 | +| 4 | 39 | `postFilmKeys` / `postFilm2Keys` / `postFilm3Keys` | 58/58 | 最复杂,优先做 | +| 5 | 37 | `volumeLightKeys` | 57/58 | 数据类已有,shader 需移植 | +| 6 | 15 | `radialBlurKeys` | 58/58(骨架居多)| 大多数曲目值为 0 | +| 7 | 63 | `tiltShiftKeys` | 58/58(骨架居多)| 大多数曲目值为 0 | --- @@ -136,89 +77,76 @@ Feature 必须在 `UMAUniversalRenderPipelineAsset_Renderer.asset` 的 Renderer ### 1. ChromaticAberration(路径 A) -**Track ID**: 73 +**Track ID**: 73 | **覆盖**: 22/58 首 **URP 类型**: `UnityEngine.Rendering.Universal.ChromaticAberration` -字段(待从 bundle dump): -- `effectType` (int) — 目前值为 0,可能控制启用/强度 +已知字段:`power`(intensity)、`effectType`(目前值为 0,语义待确认)、per-channel offset(`redOffset`/`greenOffset`/`blueOffset`,URP 内置无对应,暂忽略) -实现:摄像机 Volume → Profile 加 ChromaticAberration override → handler 设 `intensity.Override(value)`。 +实现:摄像机 Volume → Profile 加 ChromaticAberration override → handler 设 `intensity.Override(power)`。 --- -### 2. HdrBloom(路径 A) +### 2. ColorCorrection(路径 A) -**Track ID**: 38 -**URP 类型**: `UnityEngine.Rendering.Universal.Bloom` +**Track ID**: 61 | **覆盖**: 47/58 首 +**URP 类型**: `ColorAdjustments` + `ColorCurves` -字段(待 dump)。注意 `hdrBloomSettings` 在 `LiveTimelineData.cs` 里只有 `bloomBlurIterations` 一个字段, -实际 key 数据需要从 bundle 确认。 +已知字段:`saturation`(已实现)、RGB 曲线(已部分实现)、`depthRedCurve/Green/Blue`/`blendCurve`/`mode`/`selective`/`keyColor`/`targetColor` 无 URP 对应,忽略。 --- -### 3. ColorCorrection(路径 A) - -**Track ID**: 61 -**URP 类型**: `ColorAdjustments`(曝光、饱和度、色相)+ `ColorCurves` - -字段(待 dump)。 - ---- - -### 4. DepthOfField(路径 A) +### 3. DepthOfField(路径 A) **Track ID**: 13 **URP 类型**: `UnityEngine.Rendering.Universal.DepthOfField` -字段(待 dump)。注意 URP DOF 分 Gaussian 和 Bokeh 两种模式,选哪种取决于原版字段。 +字段待 dump。URP DOF 分 Gaussian 和 Bokeh 两种模式,选哪种取决于原版字段。 --- -### 5. PostFilm(路径 B,优先) +### 4. PostFilm(路径 B,优先) -**Track ID**: 39(还有 76=MultiCameraPostFilm) +**Track ID**: 39(还有 `postFilm2Keys`、`postFilm3Keys`,song 1177 有数据) **数据类**: `LiveTimelineKeyPostFilmData`(`LiveTimelineKeyPostFilmDataList.cs` 已存在) -**为什么复杂**:`filmMode` 决定混合逻辑(8种),`PostColorType` 决定颜色布局(4种), -shader 需要处理 4×8 种组合,用 keyword 或 uniform 分支实现: +`filmMode` 决定混合逻辑(8 种),`colorType` 决定颜色布局(4 种): ``` -filmMode: None=0 Lerp=1 Add=2 Mul=3 - VignetteLerp=4 VignetteAdd=5 VignetteMul=6 Monochrome=7 +filmMode: None=0 Lerp=1 Add=2 Mul=3 + VignetteLerp=4 VignetteAdd=5 VignetteMul=6 Monochrome=7 -colorType: ColorAll=0 Color2TopBottom=1 Color2LeftRight=2 Color4=3 +colorType: ColorAll=0 Color2TopBottom=1 Color2LeftRight=2 Color4=3 ``` -已知字段(`LiveTimelineKeyPostFilmData`): +已知字段: ``` filmMode, colorType -filmPower → 全局强度 -filmOffsetParam → 位移参数 -filmOptionParam → 附加参数(Vector4) -color0/1/2/3 → 最多4个颜色分区 -depthPower → 深度混合强度 -DepthClip → 深度剪裁 -RollAngle → 旋转角度 -FilmScale → 缩放 -layerMode → Color=0 / UVMovie=1 -colorBlend → None/Lerp/Additive/Multiply -colorBlendFactor → 混合系数 +filmPower → 全局强度 +filmOffsetParam → 位移参数 +filmOptionParam → 附加参数(Vector4) +color0/1/2/3 → 最多 4 个颜色分区 +depthPower → 深度混合强度 +DepthClip → 深度剪裁 +RollAngle → 旋转角度 +FilmScale → 缩放 +layerMode → Color=0 / UVMovie=1 +colorBlend → None/Lerp/Additive/Multiply +colorBlendFactor → 混合系数 ``` -**实现步骤**: +实现步骤: 1. 创建 `PostFilmRendererFeature.cs` + `PostFilmRenderPass.cs` 2. 写 `PostFilm.shader`(HLSL,`AfterRenderingPostProcessing` 插入点) 3. 在 `UMAUniversalRenderPipelineAsset_Renderer.asset` 添加该 Feature 4. Director 持有 Feature 引用,`OnPostFilmUpdate` handler 写入参数 -5. WorkSheet 加 `postFilmKeys`、`postFilm2Keys`、`postFilm3Keys` 字段,Control 加事件 +5. WorkSheet 加 `postFilmKeys`/`postFilm2Keys`/`postFilm3Keys` 字段,Control 加事件 --- -### 6. SunShafts / VolumeLight(路径 B) +### 5. SunShafts / VolumeLight(路径 B) -**Track ID**: 37 -**数据类**: `LiveTimelineVolumeLightData`(已有,handler 目前是存根) -**原版 shader**: Unity 官方开源 `ImageEffects/SunShafts`(MIT) +**Track ID**: 37 | **覆盖**: 57/58 首 +**数据类**: `LiveTimelineVolumeLightData`(已有,handler 目前是存根) 已知字段: ``` @@ -232,66 +160,37 @@ EffectColorPower → 效果强度 enable: bool → 启用开关 ``` -**实现步骤**: -1. 从 Unity ImageEffects 仓库取 `SunShaftsComposite.shader` 作为参考 -2. 改写为 URP HLSL(`HLSLPROGRAM`,去掉 `GrabPass`,用 `_CameraOpaqueTexture`) +实现步骤: +1. 参考 Unity ImageEffects 仓库 `SunShaftsComposite.shader` +2. 改写为 URP HLSL(去掉 `GrabPass`,用 `_CameraOpaqueTexture`) 3. Feature 在 `BeforeRenderingPostProcessing` 插入,两个 pass:遮罩 + 径向模糊 -4. `OnVolumeLightUpdate` handler 填充 Feature 参数(enable 为 false 时关闭 Feature) +4. `OnVolumeLightUpdate` handler 填充参数 --- -### 7. RadialBlur(路径 B) +### 6. RadialBlur(路径 B) -**Track ID**: 15 -**字段**: 待从 bundle dump。 -**算法**: 屏幕空间径向模糊,从中心向外方向采样 N 次,每次 offset = direction × step × i。 +**Track ID**: 15 | **覆盖**: 58/58 首(骨架居多) -注意:58/58 首都有此 track,但大多数 key 值为 0(骨架数据),只有转场时有效。可先把 Feature 架子搭好, -shader 逻辑简单实现,等有真实数据时再调参。 +字段待 dump。算法:屏幕空间径向模糊,从中心向外方向采样 N 次,`offset = direction × step × i`。 + +骨架数据居多,先搭 Feature 架子,等有真实数据再调参。 --- -### 8. TiltShift(路径 B) +### 7. TiltShift(路径 B) -**Track ID**: 63 -**字段**: 待从 bundle dump。 -**算法**: 屏幕中间区域清晰,上下(或可配置方向)做高斯模糊,用渐变 mask 混合。 +**Track ID**: 63 | **覆盖**: 58/58 首(骨架居多) -同 RadialBlur,骨架数据居多,优先级最低。 +字段待 dump。算法:屏幕中间清晰,上下做高斯模糊,用渐变 mask 混合。 + +骨架数据居多,优先级最低。 --- -### 9. Komorebi / 丁达尔(SunShafts 子项) +### 8. Komorebi / 丁达尔(SunShafts 子项) -**字段位置**: `volumeLightKeys[i].keys.thisList[j].komorebi` -**原版 shader**: Cygames 私有,屏幕空间光斑散射 - -目前 VolumeLight handler 读取该字段但未使用。归并到 SunShafts Feature 里作为额外 pass, -工作量最大,在 SunShafts 基础实现完成后再加。 - ---- - -## 舞台 / 灯光轨道 - -### 可以直接做 - -| 轨道 | 问题 | 难度 | -|------|------|------| -| UVScrollLight (46) bug | `scrollSpeedX/Y` 现在用 `SetTextureScale` 是错的,应每帧累积 `offset += speed * deltaTime`,需持久化累计值 | ★☆☆ | -| BgColor1 (8) 缺字段 | `vertexColorToonPower`、`outlineWidthPower`、`IsSilhouette`、`LightBlendMode` 未传给 shader | ★☆☆ | -| BlinkLight (45) 缺字段 | `color1Array`(多色循环)、`LightBlendMode`、`isReverseHueArray` 未使用 | ★★☆ | -| AdditionalLight (82) | 22/58 首有数据,字段未 dump,可能是普通 Light 参数,需先 dump 再评估 | 待评估 | -| Billboard (75) | 12/58 首有数据,始终朝摄像机的面片,Unity 有内置 `BillboardRenderer` 或 LookAt 逻辑 | ★☆☆ | - -### 暂时卡住 - -| 轨道 | 卡点 | 解法方向 | -|------|------|---------| -| BgColor2 (9) | entry 名 `BgWashA`~`BgWashJ` 在所有 stage bundle 和 meta DB 里均不存在;舞台 shader 不响应 Unity 环境光,所以当前 `RenderSettings.ambient*` 实现无效 | 需 Frame Debugger 截帧确认实际 shader 属性名,须找到镜头给到舞台背景全景的歌曲 | -| LensFlare (57) | Stage bundle 用 `CustomLensFlare` / `UnityLensFlareController` 脚本,UmaBuild 里无源码 | 可先做 `SetActive`(`enableFlare`);完整颜色/亮度控制需找到脚本接口或用 Renderer 直接设材质颜色 | -| MonitorControl (10) | `dispID` 值 0–15 不对应 monitor 材质索引(每个舞台只有 2–5 张);内容资源路径格式未知 | 可先做框架 + `colorFade`/UV 控制,`dispID` 内容切换留 TODO | -| LightProjection (74) | Unity 的 `Projector` 组件在 URP 不工作;URP 有 `DecalProjector` 但 API 差异较大 | 用 URP `DecalProjector` 替代;或用自定义 `ScriptableRendererFeature` 实现投影 | -| Environment (58) | 核心是 Planar Reflection(第二摄像机 → RenderTexture → 地板 shader),项目里完全没有这套系统 | 水面 UV 参数 + 阴影开关可部分实现;镜面反射需从零搭 Planar Reflection Camera | +`volumeLightKeys[i].keys[j].komorebi` 字段目前读取但未使用。归并到 SunShafts Feature 里作为额外 pass,在 SunShafts 基础实现完成后再加。 --- @@ -302,4 +201,3 @@ shader 逻辑简单实现,等有真实数据时再调参。 - 渲染器(Feature 注册位置): `UMAUniversalRenderPipelineAsset_Renderer.asset` - Director 入口: `Assets/Scripts/umamusume/Gallop/Live/Director.cs` → `InitializeTimeline()` - Control 事件模板: `LiveTimelineControl.cs` → `AlterUpdate_SimpleListControl` -- PostFilm 数据类: `Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineDataList/LiveTimelineKeyPostFilmDataList.cs`