Remove PMX viewer section from README
Removed outdated PMX viewer instructions and related content.
This commit is contained in:
0xcjy
@@ -59,41 +59,7 @@ PMX exporter maintainers should also read [PMX Export Standard and Postmortem](d
|
||||
|
||||
Live restoration maintainers should read [2026-10-01 improvement summary and publication boundaries](docs/IMPROVEMENTS_20261001.md). This source snapshot does not establish full visual parity and excludes local keys, extracted game assets, authorization audio payloads, and the native CySpring plugin; these dependencies must be supplied separately.
|
||||
|
||||
脚本里面有错误的单词不要改! (Cy拼错一堆单词,我都无语了😓)
|
||||
|
||||
### PMX 网页查看器
|
||||
|
||||
`web/pmx-viewer` 可在浏览器中预览本次导出的无声铃鹿（1002，服装 00），并播放角色 VMD 动作。需要 Node.js 18 或更高版本，以及以下本地导出文件（游戏模型与动作不随网页依赖安装）：
|
||||
|
||||
```text
|
||||
exports/pmx-test/1002_00_20260926-221744/1002_00.pmx
|
||||
exports/pmx-test/1002_00_20260926-221744/Texture2D/
|
||||
exports/pmx-test/1002_00_20260926-221744/1002_idle.vmd
|
||||
```
|
||||
|
||||
从项目根目录启动：
|
||||
|
||||
```powershell
|
||||
cd web/pmx-viewer
|
||||
npm ci
|
||||
npm start
|
||||
```
|
||||
|
||||
打开 <http://127.0.0.1:8765>，不要直接双击 HTML。服务仅监听本机地址，只提供查看器文件、Three.js 依赖和指定模型目录，不开放整个项目。首次安装依赖需要网络，安装后查看模型不依赖 CDN 或 Unity 运行进程；终端按 Ctrl+C 停止服务。
|
||||
|
||||
- 左键拖动旋转、滚轮缩放、右键拖动平移；触屏使用单指旋转和双指缩放/平移。
|
||||
- 支持自动旋转、地面网格、线框显示和重置视角；模型统计来自实际解析结果。
|
||||
- 贴图缺失或 PMX 加载失败会显示错误，不会显示为加载完成。
|
||||
- 点击“载入待机动作”，再点击“播放”，即可查看从真实游戏资源 `anm_eve_chr1002_00_idle01_loop` 导出的待机动作。示例约 3.3 秒，按 30 fps 采样，共 100 帧；骨骼有实际运动，但该资源没有配套面部动作，示例表情保持中性。
|
||||
- “导入本地 VMD”在浏览器内读取文件，不上传。支持与模型同名匹配的骨骼、顶点表情轨道及 VMD IK 开关；不播放镜头、灯光、音乐或模型显隐轨道。其他模型制作的 VMD 仍需检查骨骼名称和参考姿势兼容性。
|
||||
- 导入成功后暂停在首帧；支持播放/暂停、从头播放、循环、进度拖动和 0.25–2 倍速。关闭循环后停在末帧，再次播放从头开始；“清除动作 / 还原姿势”恢复 PMX 参考姿势。导入无效文件或仅镜头 VMD 时保留原动作。
|
||||
- 使用 MMD 动画求解的 IK 与骨骼继承，但明确禁用刚体物理，不加载 Ammo，也不改变现有着色器或材质；外观不保证与游戏渲染一致。
|
||||
- 已用真实 PMX/VMD 验证骨骼随时间变化、暂停、倍速、循环、结束重播、往返定位无累积漂移、动作替换和清除，以及桌面/窄屏操作。当前 PMX 的脚趾 IK 层级会触发 Three.js 的构造警告；示例 VMD 明确关闭这四条足部/脚趾 IK 链，未验证依赖脚趾 IK 的外部动作效果。
|
||||
- 下载按钮仅下载 PMX，使用导出文件时必须同时保留原目录的 `Texture2D` 文件夹。
|
||||
|
||||
同级网站 `UmaAudioSite` 使用独立的原生导航页 `/models`：从 `data/model-viewer/catalog.json` 列出已成功导出的普通角色专属服装，按需读取每套服装的 PMX 和贴图。不上传动作，网页不运行物理或原版 Shader。上面的 `web/pmx-viewer/` 仍是仅供本地单角色调试的独立示例，**不再作为网站的部署入口**。网站的服务器源码与本地源码存在独立修改，线上更新前要按变更对照，不能用本地网站的 `dist` 全量覆盖线上文件。
|
||||
|
||||
批量导出普通角色的专属服装（排除通用服装、路人和动作）：在项目根目录运行 `python tools/export_exclusive_models.py --batch 24`。脚本使用 Unity 2022.3.62f1 的隔离项目，读取当前 `Config.json` 的游戏资源；中断后重新执行会校验已有输出并续跑。全部候选尝试后，可用 `--retry-failures` 重试失败项。输出位于同级网站的 `data/model-viewer/models/<角色ID>/<服装ID>/`，成功目录写入 `catalog.json`；检查点及失败原因保存在本项目 `exports/exclusive-model-report.json`。2026-09-30 的资源快照共验证通过 173 位角色、450 套服装及 10,605 张 PNG；完整验证记录为 `exports/exclusive-model-validation.json`。
|
||||
|
||||
|
||||
### Features
|
||||
|
||||
|
||||
Reference in New Issue
Block a user