2021款丰田雅力士GR

丰田 GR Yaris (2021) 独立载具模组

一款完全独立的《赛博朋克 2077》丰田 GR Yaris (2021) 追加载具。从零开始构建为专用载具记录——并非车身替换——使用自定义的 Blender 到 WolvenKit 流程制作。具备真实的 257 马力 1.6L 涡轮增压三缸规格、AWD 驱动系统、1280kg 车重，以及基于真实 GR Yaris 6MT 齿比推导的换挡序列（在游戏内实现为 8 速序列）。包含三种配色的 CrystalCoat 动态涂装（红、黑、银），完全动画化的车门/引擎盖/后备箱，可工作的前大灯/尾灯/倒车灯/转向灯并带有正确的顶点着色色区（希望在未来更新中实现尾灯完全功能化），匹配真实车辆轴距和轮距的自定义悬挂几何结构，以及根据 Yaris 车身重建的完整物理碰撞体。

安装说明

1. 安装所需框架（见下方“需求”部分）
2. 将压缩包解压至你的《赛博朋克 2077》安装文件夹，使 archive/pc/mod/Toyota_GR_Yaris.archive 和 archive/pc/mod/Toyota_GR_Yaris.xl 与其他模组文件放在一起
3. 仅清除 r6/cache/modded/ —— 不要删除 r6/cache/tweakdb.bin 或 tweakdb_ep1.bin
4. 启动游戏。车辆将出现在虚拟车行中（需要街头声望 8 级，28,000 欧元），名称为“Toyota GR Yaris - Red/Black/Silver”
5. 或者通过 CET 控制台生成：Game.GetVehicleSystem():EnablePlayerVehicle('Vehicle.toyota_gr_yaris_purchasable', true, false)

主要特性

• 独立载具记录 — 独有的 TweakDB 条目、专用 .ent/.app 文件、独立形变骨骼，无原版记录冲突
• CrystalCoat 涂装 — 红（默认）、黑、银三色，完全支持 VCD 颜色选择器（主车身 + 副轮毂）
• 真实齿比 — 8 速游戏内换挡序列（0–1 挡完全重叠，2–7 挡密齿比）按真实 GR Yaris 6MT 齿比缩放，7,000 rpm 红线
• 动画组件 — 车门、引擎盖、后备箱通过骨骼开合；方向盘 + 手部骨骼动画
• 完整灯组 — 前大灯（#7C0101）、尾灯/刹车灯（#E70100）、倒车灯（#CB0000）、转向灯（SAE 琥珀色 #FF7E00），带正确材质区域
• 自定义物理 — 悬挂骨骼位置按真实轴距（2.565m）和轮距（前 1.32m/后 1.61m）测量，wheelsVerticalOffset: -0.15，轮胎/轮毂规格 225/40R18
• 重建碰撞 — DoctorPresto 物理流程，适配 Yaris 车身覆盖范围
• 代理网格 — 约 1.7k 三角形 LOD 用于远距离渲染
• 经销商集成 — 自定义图标、VCD 展厅图集、完整本地化（名称/描述/年份）

需求

• ArchiveXL (1.19.0+) — 用于网格/材质覆盖和本地化
• TweakXL (1.13.0+) — 用于载具记录注册
• Cyber Engine Tweaks (1.28+) — 用于 CET 控制台生成（可选但推荐）
• RED4ext — 上述工具的前置依赖
• 游戏版本 2.31（截至 2026 年当前版本）

已知问题

• 方向盘手部位置：steering_wheel_zro 骨骼偏移在视觉上移动了方向盘，但驾驶员手部骨骼仍停留在基础 Galena 车型位置——第一人称视角中手部悬浮，脱离方向盘边缘
• 刹车灯发光：刹车灯在未点亮状态下渲染出正确的玻璃外观和色调，但刹车时激活的辉光效果不会触发（动态投射光源工作正常）。根本原因正在调查中——可能是网格多边形数量/UV 与 vehicle_lights.mi 图案化发光纹理的交互问题

鸣谢

• boe6 ——“New Car from A to Z”指南，是每一步流程的权威参考
• erenn77 / maxsa5 / Okrasha——已安装模组中的可参考实现，提供了驱动模型、换挡序列、碳纤维材质和漂移辅助原型的工作模式
• DoctorPresto ——物理导入/导出脚本
• WolvenKit 团队 —— 唯一能让这一切成为可能的工具
• CDPR Modding Documentation / RedModding Wiki——官方架构参考
• CP2077 模组制作 Discord——Buzzler、misterchedda 以及其他提供了实时问题排查帮助的成员