# live2d_viewer

**Repository Path**: yfang_1019/live2d_viewer

## Basic Information

- **Project Name**: live2d_viewer
- **Description**: 预览live2d模型,使用pixi-live2d-display实现在web端使用live2d模型。本站不支持Cubism 2.1版本。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 1
- **Created**: 2021-06-05
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: React, vite2, live2d

## README

# live2d_viewr
[前往查看](http://www.twofang.top/live2d/)
#### 介绍
展示live2模型,设置背景,模型移动,鼠标跟随,缩放,动作展示等

#### 软件架构

+ 框架 : 

  [vite2](https://www.vitejs.net/) 
  
  [react](https://reactjs.bootcss.com/)

  [redux](https://redux.js.org/)

+ 模型展示库 :

  [pixi.js](https://www.pixijs.com/)

  [pixi-live2d-display](https://github.com/guansss/pixi-live2d-display)

+ UI库

  [antd](https://ant.design/index-cn)

#### 安装教程

1.  git clone https://gitee.com/yfang_1019/live2d_viewer.git
2.  cd live2d_viewr
3.  npm install
4.  npm run dev

#### 使用需知
1.  浏览器必须支持[webGL](https://developer.mozilla.org/zh-CN/docs/Web/API/WebGL_API)渲染
2.  右上角箭头打开菜单
3.  输入模型配置文件的url,或者选择项目预设的模型。[live2D配置说明](https://docs.live2d.com/cubism-editor-manual/top/)
4.  本站只支持 Cubism 3 及以上版本模型,详情请前往[pixi-live2d-display](https://github.com/guansss/pixi-live2d-display)查看
5.  本站预设模型来源于 [Eikanya](https://github.com/Eikanya/Live2d-model)
6.  你的模型可能会因为与官方标准不符,导致模型加载后功能缺失(比如鼠标追踪等),解决方式请前往`pixi-live2d-display`文档查找
7.  菜单栏右下角问号按钮打开使用说明