ModBoo制作 MOD
MOD 是包含 mod.json 的文件夹或 ZIP。可以拖放到页面上,或在 Mods 面板的 Manage mods 界面中加载。
Mods 面板
- 用开关启用/停用,用 ↑↓ 调整顺序,用 × 移除
- 每个 MOD 行都带有操作类型标签(
Textures·Materials·Mesh visibility·Accessory·Expression·XXMI outfit)。 Refresh mods(图标):重新读取 MOD 列表。
MOD 从上到下依次应用。修改同一目标的 MOD 会被标记为冲突,且下方的 MOD 优先。模型中没有的材质、变形、骨骼或纹理,会在 MOD 行下方以黄色警告显示。
mod.json 示例
{
"schemaVersion": 1,
"name": "Summer outfit",
"version": "1.0",
"author": "me",
"operations": [
{ "type": "textureReplace", "texture": "tex/body.png", "file": "textures/body_summer.png" },
{ "type": "materialParams", "materials": { "体": { "shadowColor": "#c8a0b4", "threshold": 0.2 } } },
{ "type": "meshVisibility", "materials": ["スカート"], "visible": false },
{ "type": "attachAccessory", "file": "hat/hat.glb", "bone": "頭", "position": [0, 1.5, 0], "rotation": [0, 0, 0], "scale": 1 },
{ "type": "morphPreset", "weights": { "笑い": 1, "あ": 0.3 } }
]
}操作类型
| 操作 | 内容 |
|---|---|
textureReplace | 把模型使用的纹理(路径或文件名)替换为 MOD 文件夹中的新图片。方向和重复设置沿用原纹理 |
materialParams | 按材质名称设置卡通参数(只写一部分也可以)。在卡通和 Face SDF 中可见 |
meshVisibility | 按材质名称隐藏(visible: false)或重新显示网格 |
attachAccessory | 把 MOD 文件夹中的 PMX、PMD、glTF、GLB 挂到骨骼上。position、rotation(度)、scale 以骨骼为基准,配件本身不会动 |
morphPreset | 铺设变形值(0 到 1)。在表情面板中固定的值优先 |
bodyPreset | 体型预设。用户模型不允许使用,因此总是被拒绝 |
- 路径只能是 MOD 文件夹内的相对路径(.. 、绝对路径、URL 都会被拒绝)。没有脚本或表达式。
- 格式有误时,会指出哪个项目有误,并且不会加载。
- 请把 mod.json 放在与模型不同的文件夹里(例如 模型文件夹/mods/名称/)。mod.json 所在文件夹下的所有文件都会被当作 MOD 文件。
- MOD 只适用于 MMD(PMX、PMD)模型。
INFO
MOD 文件只存在于浏览器内存中,刷新页面后需要重新加载。想要保留的话,请在 MOD 管理中连接文件夹。