模型管理

“模型管理”页面用于导入、整理玩家模型，并统一配置其他 Mod 提供的 Managed Pack 模型。每个模型有独立的详细设置，但未覆盖的字段会继续 继承全局配置。

支持的导入入口

• 单模型：选择 .model3.json。
• 配置包：选择 .live2dpack。
• 全局配置：导入只包含全局设置的配置包。

单模型导入会检查 model3 中引用的纹理、Motion、Expression、Physics 和 Pose。对于 VTube Studio 模型，导入器还会读取 .vtube.json，扫描 expressions 与 animations 目录，并把未写入 model3 的表情和动作合并到受管理副本。

全局值与模型覆盖

实际值按以下顺序解析：

程序默认值 → 全局配置 → 单模型覆盖

模型字段显示“继承”时，它会随全局配置变化；改成自定义值后只影响当前模型。清除覆盖即可恢复继承。 滤镜和画布蒙版按完整对象覆盖，不逐个子字段混合。

主菜单与游戏内

• 模型列表的“启用”勾选是持久的单模型总开关。启用后，模型参与场景渲染、物理、输入、动作快捷键和预览。
• “主菜单”控制主菜单宿主中的模型。
• “游戏内”同时用于地图和战斗。
• 全局显示快捷键临时关闭或恢复所有模型，并保留各模型配置。

预览并编辑

模型卡片的“预览并编辑”会加载当前模型和选定场景配置。画布左侧显示最终渲染，右侧可修改位置、缩放、旋转、混合、滤镜和蒙版。 所有变更先作为草稿实时预览，点击保存后写入该模型覆盖；取消则放弃本次草稿。

重命名与删除

重命名更新设置界面的显示名称并保留模型稳定 ID。删除前会显示确认弹窗。玩家导入模型的删除会同时移除配置和受管理文件。 RegisterPack 模型也可从模型库删除；该操作移除 Live2D 的本地配置和列表项，提供方资源继续由提供方 Mod 管理。 “恢复提供方模型”可重新加入这些模型。

本地文件丢失或提供方 Mod 未加载时，模型卡片显示“模型已丢失”，并保留布局、渲染和快捷键配置。资源恢复后模型继续使用原配置。

配置包

从模型卡片导出时包含当前模型及其覆盖值。持久导入会根据内容哈希跳过重复模型，并把资源复制到玩家模型目录。 Managed Pack 在这里保存布局、渲染与快捷键等用户配置。