仕様・詳細情報

# 制限事項・非対応機能

RPG ツクール MV ニコ生ゲーム化キットで作成されたニコ生ゲームでは、現在 RPG ツクール MV の以下の機能が利用できません。

  • タイトルシーンのメニュー表示
    • セーブ・ロードに非対応のため、メニューは表示されません。一定時間で自動的にニューゲームが選択されます。
  • 30MB 以上の容量
    • ニコ生ゲームのサイズ上限のため (下記に後述)
  • 音声のシーク再生
  • 音声のピッチ・位相の変更
  • セーブ・ロード機能
  • オプション機能
  • 動画再生
  • Window.png によるウィンドウデザインの一部カスタマイズ
  • キーボード入力
  • フォントの変更 (ブラウザ依存となります)

未対応機能は今後対応を進めていきます。Akashic Engine の機能やニコニコ生放送という実行環境の制約から、一部の機能のサポートは予定されていません。

RPG ツクール MV ニコ生ゲーム化キットでは以下のプラグインのみサポートしています。ただし、それ以外のプラグインについてもコンバータのプラグイン変換機能 (試験中) を利用することによって動作する可能性があります。(後述)

また、一部イベントなどの「スクリプト」による指定についても、完全な動作保証はできません。 RPG ツクール MV 標準のプログラムに強く依存した機能であるためです。 ある程度の互換性を目指してはおり ($gameVariables の提供など)、内容によっては動作する可能性もありますが、保証できかねます。

# ニコ生ゲームのサイズ上限

ニコ生ゲームの合計サイズは、従来 10MB が上限でした。 RPG ツクール MV ニコ生ゲームキットの公開に合わせ、 この制限は現在 実験的に 30 MB に引き上げられています 。 RPG ツクール MV から変換したゲームでは、画像や音声ファイルなどを限界まで削減・軽量化しないと 10MB に納まらないこと多かったためです。

ただしニコ生ゲームは「生放送の配信映像と並行してダウンロードされる」性質上、軽ければ軽い方がよいものです。 上限に関わらずできるだけ軽量化 していただくことは、プレイ体験のために引き続き重要です。

# ランキングゲームプラグイン

導入方法

  • RPG ツクール MV で作成しているゲームディレクトリの js 下に、ランキングプラグインファイル AkashicRankingMode.js をコピーする
    • RPG ツクール MV のゲームディレクトリは、Windows の場合デフォルトだと C:\Users\〇〇\Documents\Games(〇〇はユーザー名)下に配置されている
    • AkashicRankingMode.jstkoolmv-namagame-kit/plugins に配置されている
  • RPG ツクール MV の [ツール] - [プラグイン管理] で プラグイン画面を開き、AkashicRankingMode プラグインの状態を ON にすることで有効にする

効果・影響

  • タイトル画面のメニューを非表示
  • タイトル画面から一定時間でニューゲームを開始
  • タイマーを始動する時、時間を強制的にニコ生ゲームの実行時間に設定 (無効化可能)
  • タイマー表示中のメニューを禁止 (無効化可能)
  • メニューを禁止しない場合、メニュー画面の「ゲーム終了」を非表示
  • 特定の番号の変数に格納された数字を、ゲーム終了時に「得点」として集計
  • 「得点」をゲーム MAP 画面上に表示
  • 全体音量の設定 (ニコ生環境での実行時のみ)

このプラグインは、 タイトル画面のメニューを非表示 にします。 また一定時間で自動的にニューゲームを開始します。 これは時間制限のあるランキング形式のニコ生ゲームで、タイトル表示時間によってゲームプレイ時間が左右されないようにするための措置です。

このプラグインは、 タイマーの時間を強制的にニコ生ゲームの実行時間に上書き します。 これにより、ニューゲームの開始直後にタイマーを始動させることで、ゲーム画面に残り時間を表示できます。 RPG ツクール MV の通常のタイマー機能では固定の時間しか選べないため、ニコ生ゲームの残り時間 (必ずしも一定でない) を表示できるよう、強制的に時間を上書きしています。 ただし後述のパラメータ forceNamagameTimer"0" にすることで無効化できます。 これは暫定的な仕様です。将来的には、プラグインコマンドで「ニコ生ゲームの時間でタイマーを始動する」機能を提供する予定です。

またこのプラグインはデフォルトで タイマー表示中のメニュー表示を禁止 します。 これは後述のパラメータ prohibitMenu"0" にすることで無効化できます。 RPG ツクール MV のタイマーは、メニューを開いている間止まってしまうため、ニコ生ゲームのカウントダウンに使うと相性が悪いためです。

以下の画像のようにデフォルトで現在の「得点」をゲーム MAP 上に表示します。 これは後述のパラメータ showScore"0" にすることで無効化できます。 表示ウィンドウのサイズや位置については、scoreWidth, scoreHeight, svoreX, scoreY で設定します。 「得点」の単位はデフォルトだと「pt」になっていますが、scoreUnit で変更可能です。

ニコ生ゲーム用テンプレート

パラメータ

  • scoreVariableNumber: スコアとして使用する変数番号。RPG ツクール MV 側では個々で指定した変数をスコアとして利用する必要がある
  • totalTimeLimit: ゲームの総制限時間。titleTime や graceTime を含んでいる。最小値:20、最大値:200
  • titleTime: タイトル画面を表示する時間
  • graceTime: ゲーム終了後待機時間
  • prohibitMenu: タイマー表示中にメニューを禁止するかどうか。1:禁止、0:許可
  • showScore: 現在のスコアを表示するかどうか。1:表示する、0:表示しない
  • scoreWidth: スコア表示ウィンドウの横幅
  • scoreHeight: スコア表示ウィンドウの縦幅
  • scoreX: スコア表示ウィンドウ左上端の x 座標
  • scoreY: スコア表示ウィンドウ左上端の y 座標
  • scoreUnit: スコアの単位
  • musicVolume: BGM・BGS の全体音量。最小値:0、最大値:100
  • soundVolume: SE・ME の全体音量。最小値:0、最大値:100
  • forceNamagameTimer: タイマーの制限時間書き換えを行うかどうか。1:はい、0:いいえ

# ピクチャのボタン化プラグイン

RPG ツクール MV ニコ生ゲーム化キットはピクチャのボタン化プラグイン Version 1.14.5 (2023 年 11 月 8 日時点の最新版)に対応しています。ただし、他のバージョンで動作する保証はありません。

また、Akashic Engine 単体ではマウスホバーの検出ができないため、プラグインコマンド[P_CALL_CE]でマウスホバーに関する以下のトリガーには対応していません。

  • 4: マウスをピクチャに重ねる
  • 5: マウスをピクチャから放す
  • 11: マウスをピクチャ内で移動する

導入方法

新規導入の場合

  • RPG ツクール MV で作成しているゲームディレクトリの js 下に、ピクチャのボタン化プラグインファイル PictureCallCommon.js をコピーする
    • RPG ツクール MV のゲームディレクトリは、Windows の場合デフォルトだと C:\Users\〇〇\Documents\Games(〇〇はユーザー名)下に配置されている
    • PictureCallCommon.jstkoolmv-namagame-kit/plugins に配置されている
  • RPG ツクール MV の [ツール] - [プラグイン管理] で プラグイン画面を開き、PictureCallCommon プラグインの状態を ON にすることで有効にする

既に導入済みの場合

  • RPG ツクール MV で作成しているゲームディレクトリの js 下に、PictureCallCommon.jsVersion 1.14.5 のソースコードで置き換える
  • RPG ツクール MV 上とニコ生環境で問題なく動作することを確認する

# 動的文字列ピクチャ生成プラグイン

RPG ツクール MV ニコ生ゲーム化キットは動的文字列ピクチャ生成プラグイン Version 1.20.5 (2023 年 11 月 20 日時点の最新版)に対応しています。ただし、他のバージョンで動作する保証はありません。

また、制限事項として font の bold 指定はサポートしていません。

導入方法

新規導入の場合

  • RPG ツクール MV で作成しているゲームディレクトリの js 下に、ピクチャのボタン化プラグインファイル DTextPicture.js をコピーする
    • RPG ツクール MV のゲームディレクトリは、Windows の場合デフォルトだと C:\Users\〇〇\Documents\Games(〇〇はユーザー名)下に配置されている
    • DTextPicture.jstkoolmv-namagame-kit/plugins に配置されている
  • RPG ツクール MV の [ツール] - [プラグイン管理] で プラグイン画面を開き、DTextPicture プラグインの状態を ON にすることで有効にする

既に導入済みの場合

  • RPG ツクール MV で作成しているゲームディレクトリの js 下に、DTextPicture.jsVersion 1.20.5 のソースコードで置き換える
  • RPG ツクール MV 上とニコ生環境で問題なく動作することを確認する

# その他プラグインの利用

以下のように、RPG ツクール MV ニコ生ゲーム化コンバーターで「RPG ツクール MV プラグインを含めて変換する」にチェックを入れると、キットが標準でサポートしていないプラグイン (非サポートプラグイン)もニコ生ゲーム上で動くように変換処理が行われます。

RPG ツクール MV プラグインの変換

ただし、この機能は試験中のため、変換したゲームの実行時にエラーが発生する可能性があります。その場合はチェックを外して再度変換処理を行うかエラーが発生したプラグインに対して別途修正する対応を行ってください。 また本変換機能では以下の項目はサポートしていませんので、プラグインに該当する箇所がある場合は修正等の対応をお願いします。

  • ツクール MV コアスクリプトのオブジェクトの直接的書き換え
    • 例: Bitmap = BitmapHoge; というように既存のオブジェクトに別のオブジェクトを直接代入すること
  • documentwindow など Web ブラウザ上でのみ利用可能な値の利用

ニコ生ゲームに変換後の game のディレクトリ構造

ニコ生ゲームに変換後の game のディレクトリ構造は以下のようになります。

  • assets
    • img: RPG ツクールゲームからコピーしてきた画像ファイルが配置されている
    • audio: RPG ツクールゲームからコピーしてきた音声ファイルが配置されている
  • script: JavaScript ファイルが配置されている。これは game に初めから入っている
  • text: JSON 形式のテキストファイルが配置されている。RPG ツクールゲームの data からコピーしてきたものと game に初めから入っているファイルが混在している
  • game.json: ニコ生ゲームとして起動させるために必要な情報(画面サイズ、fps、アセット情報等)が記載されている

game の変換例として game-example.zip というものもあります。