vignette/apps/web/public/live2d/README.md
2026-06-26 14:47:00 +09:00

30 lines
1.4 KiB
Markdown

# Live2D Assets
This directory contains the Live2D runtime and optional sample models served by the Vite/nginx static web app.
Default runtime:
```text
/live2d/live2dcubismcore.min.js
```
Sample models:
```text
/live2d/mao/Mao.model3.json
/live2d/haru/haru_greeter_t03.model3.json
```
Sources:
- Cubism Core: https://cubism.live2d.com/sdk-web/cubismcore/live2dcubismcore.min.js
- Mao model: https://github.com/Live2D/CubismWebSamples/tree/develop/Samples/Resources/Mao
- Haru model: https://github.com/guansss/pixi-live2d-display/tree/master/test/assets/haru
The Live2D `CubismWebSamples` license lists `Samples/Resources/Mao` under Live2D's Free Material License.
The `pixi-live2d-display` README states that the Haru sample is redistributed under Live2D's Free Material License.
The local `model3.json` removes optional `DisplayInfo` and motion sound references that are absent from the copied asset set.
No sample model is loaded by default. Session avatars use the SVG/persona renderer unless the active `AvatarPersona.live2dModelUrl` points to a real persona-specific Cubism `*.model3.json` asset. The Mao and Haru samples are for local wiring checks only; production builds ignore those bundled sample URLs instead of rendering them as shared persona fallbacks.
The app also falls back to the SVG avatar when `live2dModelUrl` is omitted, set to `off`/`false`/`none`, or the model cannot be loaded.