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

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