Live2D Web Canvas · Documentation

This site hosts the user documentation for Live2D Web Canvas. The project ships both a WordPress plugin and a Chrome / Edge browser extension.

Use the left sidebar to browse by category:

• Introduction: understand the difference between V1 and V2 models first.
• Configuration: how to fill in modelAPI / modelDir, the two ways to use V1 / V2 models, V2 anti-hotlink.
• Advanced: custom ChatGPT endpoint, V2 model HitArea touch zones.
• Chrome / Edge Extension: Web Store install link, uninstall, and login.
• Privacy & Copyright: extension privacy policy and project copyright / open-source license.

General notes

1. Keep your model textures small — no more than 2048×2048 is recommended, otherwise the load time gets very long.
2. The moc3 scale ratio is often quite small; we recommend setting the model scale to around 2.0 in the admin panel. We don't hard-code 2.0 because the value compounds multiplicatively (setting 1.1 would actually become 2.2).
3. Make sure your WordPress REST API (rest_route) is reachable. If saving settings fails, first check whether the REST API is being blocked by a security plugin or Cloudflare. Since 2.1.3, both the local V1 model service and the V2 anti-hotlink rely on /wp-json/live2d/v1/... paths.
4. If you're using a CDN, remember to flush the cache after updating the plugin.
5. Files such as live2d.js / waifu-tips.min.js must not be re-minified — a second minification pass can break them.
6. The plugin cannot save settings on intranet / localhost. Use a public IP + domain (a free Peanut Hull / no-ip style domain works fine) to access the site.
7. You can buy genuine MOC3 models on nizima. This plugin has also been listed on the official Live2D Showcase.
8. Changelogs are posted on Weibo and bilibili.
9. If your payment doesn't activate, please join QQ group 49463654. (Chinese-speaking only)