모드 만들기
모드는 mod.json이 든 폴더 또는 ZIP입니다. 화면에 끌어다 놓거나, 모드 패널의 모드 관리 화면에서 불러옵니다.
모드 패널
- 스위치로 켜기/끄기, ↑↓로 순서 바꾸기, ×로 빼기
- 모드 줄에는 작업 종류 태그(
텍스처 교체·재질 값·메시 표시·액세서리·표정·XXMI 의상)가 붙습니다. 모드 새로고침(아이콘): 모드 목록을 새로 읽습니다.
모드는 위에서 아래로 적용됩니다. 같은 대상을 건드리는 모드끼리는 충돌로 표시되고 아래 모드가 우선합니다. 모델에 없는 재질·모프·본·텍스처는 모드 줄 아래에 노란 경고로 나옵니다.
mod.json 예시
{
"schemaVersion": 1,
"name": "여름 의상",
"version": "1.0",
"author": "나",
"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 | 모델이 쓰는 텍스처(경로 또는 파일 이름)를 모드 폴더의 새 이미지로 바꿉니다. 방향·반복 설정은 원래 텍스처를 따릅니다 |
materialParams | 재질 이름별 툰 파라미터(일부만 써도 됨). 툰·얼굴 SDF에서 보입니다 |
meshVisibility | 재질 이름으로 메시를 숨기거나(visible: false) 다시 보입니다 |
attachAccessory | 모드 폴더의 PMX·PMD·glTF·GLB를 본에 붙입니다. position·rotation(도)·scale은 본 기준이고 액세서리는 움직이지 않습니다 |
morphPreset | 모프 값(0~1)을 깝니다. 표정 패널에서 직접 고정한 값이 우선합니다 |
bodyPreset | 체형 프리셋. 사용자 모델에서는 허용되지 않아 항상 거부됩니다 |
- 경로는 모드 폴더 안의 상대 경로만 됩니다(.., 절대 경로, URL은 거부). 스크립트·식은 없습니다.
- 형식이 틀리면 어느 항목이 틀렸는지 알려 주고 불러오지 않습니다.
- mod.json은 모델과 다른 폴더(예: 모델폴더/mods/이름/)에 두세요. mod.json이 든 폴더 아래 파일은 모두 모드 파일로 취급합니다.
- 모드는 MMD(PMX·PMD) 모델에만 적용됩니다.
INFO
모드 파일은 브라우저 메모리에만 있어서 새로고침하면 다시 불러와야 합니다. 폴더를 연결해 보관하려면 모드 관리를 쓰세요.