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

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 鼠标移上透明度