Live2D 公式プラグイン Cubism4対応版

＞＞Live2D 公式サイト

Live2Dは２次元の画像をなめらかにアニメーションさせることができる技術です。
最近はゲームやVtuberなどで活用が進んでいます。

　サンプルゲームプロジェクトファイルを入手

*サンプルプロジェクトには、live2dcubismcore.min.js　が含まれていないので本ページの手順を参考に入手してdriverフォルダに配置しないと動きません。

ティラノスクリプト本体、および、Live2Dプラグインは無料で利用できます。
本プラグインはLive2D Cubism SDKを使用しており、本プラグインを使用してゲームを制作する場合はLive2D Proprietary Licenseへの同意が必要となります。
https://www.live2d.jp/terms/live2d-proprietary-software-license-agreement/

上記は導入手順中、Cubism Core for Web をダウンロードする際に確認できます。

また、制作したゲームを公開する場合は SDKリリースライセンスへの同意が必要です。

Live2D SDKリリースライセンスを確認する

2020年10月現在、 直近売上が1,000 万円未満の小規模事業者・個人・学生・サークル・その他の団体については無償で作品をリリースできます。

また、本プラグインに含まれているLive2Dモデルについては、Live2Dのガイドラインに準拠して使用することができます。

【ガイドライン】https://docs.live2d.com/cubism-editor-manual/sample-model/

　【最新版】live2d_tyrano_plugin_v410 プラグインを入手(2024/2/13)

　live2d_tyrano_plugin_v401 プラグインを入手(2021/1/24)

上記、Live2Dプラグインをダウンロードして適当な場所に展開してください。


続いて、Live2D公式サイトから開発用のライブラリをダウンロードします。以下のURLにアクセスしてください。

https://www.live2d.com/download/cubism-sdk/download-web/




入手したファイルを、先にダウンロードしておいたプラグインフォルダの
「live2d/driver」フォルダの中にコピーしてください。


次に、このlive2dフォルダを、ご自身のティラノプロジェクトのdata/others/plugin フォルダに配置します。



あとは、first.ks に

[plugin name="live2d"]



続いて、make.ks に

[live2d_restore ]



と記述すれば、Live2Dをティラノスクリプトで使用する準備は完了です。

（make.ks の記述は ロード時にLive2Dモデルを再現するために必須です。）

詳しいタグの説明や使い方について、上記のサンプルゲームをダウンロードして スクリプトを見ていただくのがわかりやすいかと思います。

Live2Dモデルデータはdata/others/plugin/live2d/modelフォルダの中に配置します。

このディレクトリ名に記載されているのがモデルIDです。
上記画像だと「Haru」というのがモデルIDになります。

あとは、タグを記述するだけでLive2Dモデルを表示できます。


[live2d_new name="haru" model_id="Haru" ]

;Live2Dモデルの表示
[live2d_show name="haru" y=-0.8 x=0 scale=2.5 ]



これで表示されました。簡単ですね。

Live2Dのモーションについて好きなタイミングで制御することができます。
モーションを再生するには[live2d_motion]タグを使用します。

モーション名についてはモデルデータをエディタで確認します。 モデルIDがHaruのデータを例にすると
Haru.model3.json ファイルをエディタで開きます。

その中を確認するとモーションファイルとの紐づけが記述されている部分が確認できます。



このNameを[live2d_motion]タグで指定することでモーションを操作することができます。

この例だと、「Idle」「Idle2」「TapBody」「Test」と名前でモーションファイルが紐付いています。

ちなみに「Idle」はキャラクターが通常立っている状態に再生するモーションになります。

なので、「TapBody」というモーションを指定したい場合は

[live2d_motion name="haru" mtn="TapBody" ]
このように記述するとモーションが再生されます。

また、このTapBodyには複数のモーションが配列で設定されています。
通常は１番目のモーションが再生されますが、別のモーションを指定することもできます。 [live2d_motion name="haru" mtn="TapBody" no=2 ]
no=2 を指定しているので、TapBodyの中の、0から数えて２つ目のモーションが再生されます。

また、表情を変更するExpressionもゲーム中に変更できます。
こちらもjsonファイルのExpressionで紐付いた名前を指定することができます。
[live2d_expression name="haru" expression="f07"]

■アイドルモーションについて

通常の立っている状態で再生されるモーションはデフォルトは「Idle」です。
この「Idle」モーションの中に設定されているものがランダムに繰り返し再生されています。

アイドルモーションの変更については[live2d_mod]タグを使用してください。

[live2d_mod name="haru" idle="Test" ]

モデルが話している間、口を動かすことができます。
これはリップシンクに対応したモデルでなければいけません。

まず、[live2d_new]のタイミングで lip="text" jname="ハル" というように リップ機能の有効化と、このキャラクターの表示名を指定します。

[live2d_new name="haru" model_id="Haru" lip=text jname="ハル"]
あとは、通常のティラノで使用する、名前欄の指定と、このjnameが一致する場合、口が動きます。

[live2d_new name="haru" model_id="Haru" lip=true jname="ハル"]
#ハル
今はハルがしゃべってるよ。[p]
いい感じに喋れてるかな[p]

口の動くスピードなども変更できますので、ぜひ確認してみてください。

■ボイスと連動するリップシンクについて

ボイスに合わせて、リップシンクすることも可能です。

Live2Dプラグイン401以降で対応します。あわせてティラノスクリプトのV506以降が必須です。

モデルを定義するときにlip="sound"と指定します。
また、反応させたいボイスが再生されるチャネル（buf）も必要なら指定しておきましょう。
lip_seパラメータに反応させたい buf を記述します。
[live2d_new name="haru" model_id="Haru" lip="sound" lip_se="1" jname="ハル"]

この場合、例えば[playse buf=1 storage="voice.mp3"] で再生されている音声に反応します。

注意点として、すべての再生されている音楽に反応してしまうので、そのままですとBGMにもリップシンクしてしまいます。

これを回避するため、BGMを再生する場合は次のように記述します。

[playbgm storage="music.mp3" html5="true"]
html5パラメータをtrueにすると、そのサウンドはリップシンクに反映されません。効果音の場合も同様に

[playse storage="door.mp3" html5="true"]

上記のように記述するとリップシンクに反映されません。

ゲーム画面の画面を初期設定のサイズより拡大したとき、
Live２Dモデルがメッセージウィンドウの前に 表示されてしまうケースがあります。

対策として
①ゲームの画面サイズを大きく設定する。

もしくは

② tyrano.css を編集する。

tyrano/tyrano.cssファイルをエディタで開いて以下の箇所『position: absolute;』の１行を消してください。 .tyrano_base{
-moz-user-select: none;
-webkit-user-select: none;
-khtml-user-select: none;

position: absolute; top: 0;
left: 0;
right: 0;
bottom: 0;
margin: auto;
}
ただし、②の方法だと画面のセンタリングとカメラが使用できなくなります。ご了承ください。