live2dviewerex 中文文档 下载 App

LPK 和 WPK 模型文件导入方法

三种模型文件格式

Live2DViewerEX 支持三种本地模型文件格式，它们各有不同：

格式全称说明可编辑性
LPKLive2D Viewer Pack打包好的模型文件，像 ZIP 一样把贴图、配置、动作等全部塞在一起❌ 不可自由编辑
WPKWorkshop Pack类似 LPK 但专为创意工坊设计❌ 不可自由编辑
Json.model3.json 模型文件夹解压后的模型配置 + 贴图文件夹结构✅ 可用 EX 工作室编辑

简单说：LPK/WPK 是"一键即用"的成品包，Json 是"可拆解"的源材料。如果你想调整模型参数或做二次创作，必须要用 Json 格式。

导入 LPK 模型

  1. 打开控制面板 → 模型标签页
  2. 切换到「LPK」子标签
  3. 点击「导入」按钮，在文件浏览器中选择你的 .lpk 文件
  4. 导入成功后，LPK 文件会显示在列表中
  5. 双击载入到当前模型槽

删除 LPK 模型

在 LPK 列表中，每一项右侧有一个垃圾桶图标，点击后选择要删除的源文件即可。

导入 WPK 模型

WPK 是创意工坊使用的格式，你一般不会手动去导入它（Steam 订阅后自动下载）。但如果你从别处拿到了 WPK 文件：

  1. 控制面板 → 模型 → 切换到「创意工坊」子标签
  2. 点击「导入」按钮选择 WPK 文件

导入 Json 模型

Json 格式是 Live2D Cubism SDK 标准模型格式，结构是这样的一个文件夹：

模型文件夹/
├── xxx.model3.json      ← 主配置文件（选这个导入）
├── xxx.moc3               ← 模型二进制
├── xxx.physics3.json     ← 物理模拟配置
├── xxx.pose3.json        ← 姿态配置
├── textures/              ← 贴图文件夹
│   ├── xxx_00.jpg
│   └── xxx_01.jpg
├── motions/               ← 动作文件夹
│   ├── idle_01.json
│   └── tap_body.json
└── expressions/           ← 表情文件夹
    ├── f01.json
    └── f02.json

导入步骤：

  1. 控制面板 → 模型 → 切换到「Json」子标签
  2. 点击「导入」按钮
  3. 选择 .model3.json 文件本身（不是选文件夹）
  4. 导入后双击列表中该模型载入

删除 Json 模型

长按列表项（Android）或右键（PC）→ 选择要删除的项 → 点垃圾桶图标。注意：这只会从应用列表中移除，不会删除你原始的 Json 文件。

从 EX 工作室导出模型

如果你用 Live2D Cubism Editor 或 EX 工作室自己做了模型，导出后得到的就是 Json 格式。Live2DViewerEX 支持 Cubism 2 和 Cubism 3 两个版本：

SDK 3 还新增了 pose3.json（姿态配置）和更丰富的 motions3.json 格式。

导入常见问题

模型无法加载

多出现于 LPK 格式，原因通常是：

模型贴图显示有问题 / 出现黑边

到「控制面板 → 设定 → 显示」：

Android 版格式限制