簡易的にVOICEVOXでセリフを喋らせるRPGツクールMZプラグイン - VoicevoxTalkMZ.js

シェア用テキスト：

▼簡易的にVOICEVOXでセリフを喋らせるRPGツクールMZプラグイン（Ritsuki様作） - VoicevoxTalkMZ.js
https://plugin-mz.fungamemake.com/archives/8866
RPGツクールMZの会話をVOICEVOXのボイス付きにするプラグインです 音声自体をゲーム内に入れる本格的な物というわけではなく、VOICEVOXエンジンを使うものなので、プレイ中もVOICEVOXアプリ（またはエンジンのみ）が必要な簡易的なものです。

ふりがな：かんいてきにぼいすぼっくすでせりふをしゃべらせるあーるぴーじーつくーるえむぜっとぷらぐいん

機能概要： RPGツクールMZの会話をVOICEVOXのボイス付きにするプラグインです 音声自体をゲーム内に入れる本格的な物というわけではなく、VOICEVOXエンジンを使うものなので、プレイ中もVOICEVOXアプリ（またはエンジンのみ）が必要な簡易的なものです。

利用規約（ライセンス）：

この作品は マテリアル・コモンズ・ブルー・ライセンス の下に提供されています。

・クレジット表示：必須
・営利利用：許可（素材単体の販売は禁止）
・改変利用：許可
・再配布：許可
・クレジット：（下記に記載）

作者：Ritsuki

作者サイト：https://ha6mwljz4z93.blog.fc2.com/

解説ページ：https://ha6mwljz4z93.blog.fc2.com/blog-entry-217.html

直接ダウンロード：Zipファイル

ファイル名：VoicevoxTalkMZ.js

プラグインのヘルプ：

 * このプラグインは、RPGツクールMZでVOICEVOXを使用して
 * キャラクターのセリフを音声合成する非公式プラグインです。
 *
 * ■必要な準備
 * 1. VOICEVOX Engine(VOICEVOXアプリ)をインストールして起動しておく
 *    https://voicevox.hiroshiba.jp/
 *  　Engineだけでもいいけど、アプリがあると何かと便利です
 * 2. このプラグインを有効化
 * 3. プラグイン設定で音声プリセットを登録
 * ※ゲームに音声自体を組み込むわけではないのでVOICEVOXアプリ（またはEngineのみ）
 * 　がないと音声が出ません。起動させている状態にしてください。
 * ※プラグインの使用は自己責任でお願いします。
 * 　既存のプロジェクトに入れる時は事前にバックアップを取ってください。
 * ※読みのアクセントはVOICEVOXアプリ依存でしかできないので、
 * 　ちゃんとした配布するゲームには向きません。
 * 　VOICEVOXアプリ入れた自分用か、アクセント気にしないようなネタゲー向きです。
 * ※他プラグインとの競合確認はしていません。競合がおきる可能性があります。
 * 
 * ■使い方（制御文字を使う方法）
 * 1. プラグイン設定で音声プリセットを登録
 * 　■制御文字番号
 * 　制御文字(\VO)で呼び出す番号です。重複しないようにしてください。
 *   ■話者ID
 * 　VOICEVOXエンジン・アプリを起動した状態で一覧の見ることができます。
 * 　http://localhost:50021/speakers
 *　 見づらいですが、AIに見やすい一覧にしてと頼めば見やすくしてもらえます。
 * 
 * 2. 文章の表示で制御文字を使用
 * 　　\VO[音声プリセットの数字]
 * 　　例：こんにちは\VO[0]
 * 　　（会話終了後、自動で音声モードも終了）
 * 
 * ■制御文字一覧
 * \VO[数字] - 指定したプリセット番号の音声で話す
 * \VO[OFF]  - 音声なしにしたい時に使用
 * \RE[漢字|読み] - 読み仮名を指定（例：\RE[永遠|とわ]）
 * \IG[テキスト] - 音声では読まない（画面には表示される）
 * 
 * ■音声無し機能（\VO[OFF]）
 *  声有り分との途中で音声なしにしたい場合：
 *　\VO[OFF]で音声無しの文章にできます。
 *        こんにちは\VO[0]
 *        黙っていよう…\VO[OFF]（音声なし）
 *        ねえ、聞いてる？\VO[0]
 *   ※通常は会話終了後に自動で音声モードが終了するため、
 *   \VO[OFF]を使う必要はありません。
 *   途中で音声をオフにしたい時のみ使用してください。
 *
 * ■音声無視機能（\IG）
 * \IG[テキスト] 制御文字を使うと、そのテキストは画面に表示されますが
 * 音声では読み上げられません。
 * 
 * 使用例：
 * - 心の声：君天才だね\IG[（俺はもっと頭いいけど）]。すごいよ！
 *   → 表示：「君天才だね（俺はもっと頭いいけど）。すごいよ！」
 *   → 音声：「きみてんさいだね。すごいよ！」
 *
 * ■読み替え機能
 * 漢字や特殊な読み方をする単語を正しく読ませる方法が3つあります：
 * 
 * 1. 読み替え辞書（プラグイン設定）
 *    よく使う単語を登録しておけば、プロジェクト全体で自動変換されます。
 *    例：「永遠」→「とわ」
 * 
 * 2. 制御文字 \RE[漢字|読み]
 *    その場で読み仮名を指定できます。
 *    例：\RE[永遠|とわ]の愛 → 「とわのあい」と読む
 * 
 * 3. VOICEVOXで読み方＆アクセント辞書登録
 *  　プラグインではアクセント設定ができませんが、アプリではできます。
 *  　ただし、自分のPCのVOICEVOXアプリに登録されるだけなので、
 *  　ゲームを配布した場合など他のVOICEVOXアプリでは登録が反映されません。
 *  　自分用で遊ぶ時は一番おすすめ。
 *  　※反映されない時は単語優先度を最高にするなど、高くすると反映されます。
 * 
 * ※優先順位は、制御文字が最優先。次がプラグイン設定辞書。
 * 　最後がVOICEVOXアプリ辞書です。
 * 　（アプリで単語優先度を最高にしても、制御文字やプラグイン設定辞書の方が優先されます）
 *
 * ■使い方（プラグインコマンドを使う方法）
 * 　プラグインコマンド
 * - 音声開始: 音声合成モードを開始（制御文字不要）
 * 　 ※一時的に話者などを変えたい時やAI会話使用時に使うと良いです。
 * - 音声終了: 音声を一旦無しにします。\VO[OFF]と同じ。
 *
 * ■プラグインコマンドのデフォルト値の変更方法
 * コードを開いて※デフォルト値を変更したい時はコードのdefault値を編集
 * となっている部分のdefaultの値を変更して下さい。