pixi-live2d
Version:
Display live2D model as a sprite in pixi.js.
85 lines (55 loc) • 2.36 kB
Markdown
# pixi-live2d
Display live2D model as a sprite in [pixi.js](https://github.com/pixijs/pixi.js).
--------------------------------------------------------------------------------
[Installation](#installation) | [Example](#example) | [API](#api) | [License](#license) | [Donation](#donation)
Pixi-live2d is a plugin for pixi.js for displaying live2D model as a sprite in pixi.js.
- Only available in WebGL
- ECMAScript 2015+
- [Have a look at example!](https://avgjs.github.io/pixi-live2d-example/)
- [Make me know](mailto:bingfeng.web@gmail.com?subject=Hey,%20I%20made%20a%20cool%20work%20with%20your%20plugin!) if you use my plugin for cool things!
## Installation
```bash
npm install pixi-live2d
```
**Attention**
Because of [the SDK policy](http://sites.cybernoids.jp/cubism-sdk2_e/policy-sdk) of Live2D Inc., SDK file has been removed from the package, so you have to [download](http://sites.cybernoids.jp/cubism-sdk2_e/webgl2-1) and import it by yourself.
for example in HTML file:
```html
<script src="live2d.min.js"></script>
```
or just require it
```javascript
require('live2d.min.js');
```
## Example
```javascript
import PIXI from 'pixi.js';
import 'pixi-live2d';
const renderer = new PIXI.WebGLRenderer(800, 600);
document.body.appendChild(renderer.view);
const stage = new PIXI.Container();
const live2dSprite = new PIXI.Live2DSprite(modelHaru);
stage.addChild(live2dSprite);
live2dSprite.startRandomMotion('idle');
live2dSprite.on('mousemove', (evt) => {
const point = evt.data.global;
live2dSprite.setViewPoint(point.x, point.y);
});
function animate() {
requestAnimationFrame(animate);
renderer.render(stage);
}
animate();
```
You can find a more complex one at [`example` folder](./example), or [visit it online](https://avgjs.github.io/pixi-live2d-example/).
## API
[docs/API.md](./docs/API.md)
## License
This plugin is distributed under MIT license, and you should agree with the licenses of Live2D and pixi.js.
For more detail, please read [LICENSE.txt](./LICENSE.txt).
## Donation
The plugin is free for charge, if you like it don't forget to buy me a coffee!
ko-fi:<br>
[](https://ko-fi.com/A742BTX)
alipay:<br>
