这个神奇的看板生物我第一次碰巧看到后就瞬间觉得太好玩了吧

Hexo 配置好玩的 Live2D 还是非常简单的

安装 hexo-helper-live2d

1
npm install hexo-helper-live2d --save

配置 hexo-helper-live2d

在开始配置之前，你需要先获取 Live2D 的资源，很多手游中都有 Live2D 资源可以获取；为了能够快速配置好看板动画，可以在 插件作者的博客 里挑选一种你喜欢的动画，然后记录下它的名字

安装你看中的动画

上方页面中提供的 Live2D 资源已经都被作者发布成 npm 包啦

只需要简单滴安装 live2d-widget-model-你选中的动画名字 即可获得对应的 Live2D 资源，我们这里以 hijiki 这只黑喵为例

1
npm install live2d-widget-model-hijiki --save

配置你看中的动画

在官方文档中可以很容易获取配置文件的样例，下方提供的配置可以直接使用 hijiki

打开博客根目录下的配置文件 _config.yml，在配置文件的最后添加以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Live2D
## https://github.com/EYHN/hexo-helper-live2d
live2d:
    enable: true
    scriptFrom: jsdelivr # 默认
    pluginRootPath: live2dw/ # 插件在站点上的根目录(相对路径)
    pluginJsPath: lib/ # 脚本文件相对与插件根目录路径
    pluginModelPath: assets/ # 模型文件相对与插件根目录路径
    # scriptFrom: jsdelivr # jsdelivr CDN
    # scriptFrom: unpkg # unpkg CDN
    # scriptFrom: https://cdn.jsdelivr.net/npm/live2d-widget@3.x/lib/L2Dwidget.min.js # 你的自定义 url
    tagMode: false # 标签模式, 是否仅替换 live2d tag标签而非插入到所有页面中
    debug: false # 调试, 是否在控制台输出日志
    model:
        # use: live2d-widget-model-hijiki # npm-module package name
        # use: hijiki # 博客根目录/live2d_models/ 下的目录名
        # use: ./wives/hijiki # 相对于博客根目录的路径
        use: https://cdn.jsdelivr.net/npm/live2d-widget-model-hijiki@1.0.5/assets/hijiki.model.json # 你的自定义 url
        scale: 1
        hHeadPos: 0.5
        vHeadPos: 0.618
    display:
        superSample: 2
        width: 125
        height: 125
        position: left
        hOffset: 30
        vOffset: 0
    mobile:
        show: false
        scale: 0.05
    react:
        opacityDefault: 1
        opacityOnHover: 0.2

然后执行命令 hexo clean && hexo g && hexo s，即可在本地 4000 端口预览

配置详解

在下方表格中列出了位置、大小、属性等配置内容，并不是用到了所有配置

这里给出作者的 API 文档，此文档应该是作者根据版本更新的：live2d-widget.js API

配置项 类型 属性 备注
enable Boolean true 或者 false 控制 live2d 插件是否生效
scriptFrom String local 或者 jsdelivr 或者 unpkg l2dwidget.js 使用的 CDN 地址，local 表示使用本地地址
pluginRootPath String 例如：live2dw/ 插件在站点上根目录的相对路径
pluginJsPath String 例如：lib/ 脚本文件相对与插件根目录路径
pluginModelPath String 例如：assets/ 模型文件相对与插件根目录路径
tagMode Boolean true 或者 false 标签模式，控制是否仅替换 tag 标签而非插入到所有页面中
debug Boolean true 或者 false 调试模式，控制是否在控制台输出日志
model.use String 例如：live2d-widget-model-hijiki npm 模块包名
model.use String 例如：hijiki 博客根目录 /live2d_models/ 下的目录名
model.use String 例如：./wives/hijiki 相对于博客根目录的路径
model.use String 例如：https://域名/model.json 你自定义 live2d 模型 json 文件的 url
model.scale Number 可选值，默认值为 1 模型与 canvas 的缩放
model.hHeadPos Number 可选值，默认值为 0.5 模型头部横坐标
model.vHeadPos Number 可选值，默认值为 0.618 模型头部纵坐标
display.superSample Number 可选值，默认值为 2 超采样等级
display.width Number 可选值，默认值为 150 canvas 的长度
display.height Number 可选值，默认值为 300 canvas 的高度
display.position Number 可选值，默认值为 right 显示位置：左或右
display.hOffset Number 可选值，默认值为 0 canvas 水平偏移
display.vOffset Number 可选值，默认值为 -20 canvas 垂直偏移
mobile.show Boolean 可选值，默认值为 true 控制是否在移动设备上显示
mobile.scale Number 可选值，默认值为 0.5 移动设备上的缩放
react.opacityDefault Number 可选值，默认值为 0.7 默认透明度
react.opacityOnHover Number 可选值，默认值为 0.2 鼠标移上透明度