仕様・詳細情報

# 制限事項・非対応機能

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

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

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

また次の機能は非サポートです。

これらは 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 上とニコ生環境で問題なく動作することを確認する

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

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

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

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