live2d-widget

Live2D Widget is a JavaScript library that adds an animated anime-style character to a website. The character appears in a corner of the page, reacts to mouse movement, and can display short messages. The README is primarily written in Chinese, with some English sections.

Adding the widget to an existing website requires pasting one script tag into the HTML of the page. The library then loads its own stylesheet and behavior file automatically. There are no additional runtime dependencies aside from the Live2D rendering engine (Cubism Core), which the library fetches from a CDN on its own.

The repository does not include any character models. Models are stored and served separately, either from a CDN path you configure or from your own server. Configuration options let you set which model appears by default, whether the character can be dragged around the page, and which small toolbar buttons are shown on the widget.

The README includes steps for deploying the widget in several ways: loading the default version directly from jsDelivr CDN with a single line, forking the repository and hosting a customized version through jsDelivr or Cloudflare Pages, or placing the built files on your own server. For static blogs built with tools like Hexo, the files can sit in the blog source directory so they are published automatically during the normal build step.

The core code is licensed under GPLv3. The Live2D rendering components are subject to separate Live2D license terms. Character models, artwork, and animation data are not covered by this repository and remain the property of their respective creators.