プラグインの作り方入門その7：プラグインコマンドの作り方（JavaScriptの配列） #RPGツクールMZ #RPGツクールMV

Game_Interpreter.prototype.pluginCommand = function(command, args) {
    // to be overridden by plugins
};

(() => {
    "use strict";

    const pluginName = 'ファイル名';

    const _Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
    Game_Interpreter.prototype.pluginCommand = function (command, args) {
        _Game_Interpreter_pluginCommand.call(this, command, args);

        if (command === pluginName) {
            //処理
        }
    };

})();

// _Game_Interpreter_pluginCommand.call(this, command, args);
_Game_Interpreter_pluginCommand.apply(this, arguments); 

両方を紹介したのは、今後は他のプラグインの中を見て学んでいく事が増えると想定しているからです。
同じ処理でも、違う書き方（おそらく「.apply(this, arguments)」の方が多数派）をしているプラグインを見た時の手がかりにしてください。

callとapplyの違い

筆者は勘違いしていたのですが、callとapplyは働きが明確に異なります。
同じ書き方が可能なケースがありますが、callでなければ正常に動作しないケースがあります。
プラグインコマンドは配列を使用しているので、apply で動作しているのでしょうか？
command は配列でないので、エラーが出ていないだけなのかもしれません。
（ただ、この書き方をしているプラグインコマンドは多数見ます。）
値を返す関数をフックする場合、callを使用する必要があります。
どちらを使うべきか判断できない場合、callを使ったほうが安全と思われます。

developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Function/apply

プラグインコマンドの仕様を確認

ツクール上で「スクリプト」を実行するのを簡略化するための仕組みと考えると理解しやすいです。

多くのプラグインにあるプラグインコマンドは、プラグイン内の動作を指定するコマンドとしてスクリプトを書くハードルを下げるために、そのプラグインの中の動作を呼び出すJavaScriptをプラグインコマンドの中に入れています。
この仕組がなければ、毎回スクリプトを書いてもらう事になっていたでしょう。

プラグインコマンドを動作させる

上記のテンプレートを「testPC.js」のファイル名で保存し、プラグイン管理で有効化します。
コード内の「ファイル名」の箇所も忘れずに書き換えてください。
まず、console.logを入れます。

(() => {
    "use strict";

    const pluginName = 'testPC';

    const _Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
    Game_Interpreter.prototype.pluginCommand = function (command, args) {
        _Game_Interpreter_pluginCommand.call(this, command, args);

        if (command === pluginName) {
            console.log('command');
            console.log(command);
            console.log('args');
            console.log(args);
        }
    };

})();

プラグインコマンド「testPC a b1 c123」を実行して、ログを見ます。

下記のようなログが出ていますね。

(3)の左にある三角をクリックすると、展開されます。

それでは、もう少し詳細を見ていきましょう。
下記のように、ログを追加します。

(() => {
    "use strict";

    const pluginName = 'testPC';

    const _Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
    Game_Interpreter.prototype.pluginCommand = function (command, args) {
        _Game_Interpreter_pluginCommand.call(this, command, args);

        if (command === pluginName) {
            console.log('command');
            console.log(command);
            console.log('args');
            console.log(args);
            console.log('args[0]');
            console.log(args[0]);
            console.log('args[1]');
            console.log(args[1]);
            console.log('args[2]');
            console.log(args[2]);
            console.log('args.length');
            console.log(args.length);
        }
    };

})();

下記のようなログが出ていますね。

RPGツクールMVのプラグインコマンドでは、コマンド後に半角スペース区切りで項目を入力していく仕様になっています。
これをJavaScriptの変数の型の１つ「配列」に入れ["a", "b1", "c123"] のような形で保存されています。
この配列の1つずつを args[x] とすることで、文字列を変数に入れていくことが出来ます。
args[x]のxは0から連番で進みます。

「.length」は項目の数を引き出します。
他にも使い方があるので、JavaScriptのリファレンスで調べてみてください。
developer.mozilla.org/ja/docs/Learn/JavaScript/First_steps/Arrays

ウェブサイトを開くプラグインコマンドを作成

ウェブサイトを開くスクリプトは、「プラグインの作り方入門その3：コマンドを追加する」で調べてあります。
これをそのまま使用します。

答えは下記です。

(() => {
    "use strict";

    const pluginName = 'testPC';

    const _Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
    Game_Interpreter.prototype.pluginCommand = function (command, args) {
        _Game_Interpreter_pluginCommand.call(this, command, args);

        if (command === pluginName) {
            const url = String(args[0]);
            window.open(url);
        }
    };

})();

上記にプラグインを修正し、プラグインコマンド

testPC https://tkool.jp/mv/

を実行してテストしてください。
URLを変えれば、違うサイトが開くはずです。
開かれるウィンドウの大きさなどを色々調整したい場合は、下記を参照しコードを変更してください。
developer.mozilla.org/ja/docs/Web/API/Window/open

アクターが変身（別アクターと交代）するプラグインコマンド

筆者はよく、Googleサジェストをチェックしています。
その中で、「主人公　交代」というのが気になっていました。
「ストーリーの途中で主人公が親から子供に移る」とかを想定しているのかな？と考えていたのですが、「呪術廻戦（アニメ）」を見ていて、「もしかして、主人公に取り付いている悪魔と交代してステータスもスキルもパワーアップする変身的な事も交代なんじゃない？」と考えて、作りました。
リクエストがあったわけでもないので、微妙ですがパーティの並び順を変えたりするのに応用できる知識なので、こちらで情報の整理をします。

まず、大まかなテストを書いて、ログを見ることでどのように実装していくのかの情報を整理します。

(() => {
    "use strict";

    const pluginName = 'testPC';

    const _Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
    Game_Interpreter.prototype.pluginCommand = function (command, args) {
        _Game_Interpreter_pluginCommand.call(this, command, args);

        if (command == pluginName) {
            const before = Number(args[0]);
            const after = Number(args[1]);

            console.log($gameParty);
            console.log($gameParty._actors);
            console.log($gameParty._actors.indexOf(before));

            $gameParty._actors.splice($gameParty._actors.indexOf(before), 1, after);
            $gamePlayer.refresh();
            $gameMap.requestRefresh();
        }
    };

})();

上記をプラグイン（testPC.js）にし、プラグインコマンド「testPC 1 5」を実行します。

下記のようなログが出ています。

今回のプラグインコマンドは「アクターID1のパーティメンバーをアクターID5のアクターと入れ替えるという内容です。
並び順をそのままにしたかったので、少し手が込んでいます。

まず、ログの最初「console.log($gameParty); 」で、パーティのデータを引き出しています。
この左側にある三角をクリックしデータを見てみましょう。

_actors:(4) [5, 2, 3, 4] に注目してください。
これはアクターが4人いて、並び順にアクターIDが入っています。
これは変身後のデータが表示されているのか、先頭のID1がID5に入れ替わっています。
この配列だけを引き出すための方法が、次のログ「console.log($gameParty._actors); 」に入っています。
このように、元の全体のデータが引き出せれば、その部分的なデータは「～.項目名」とドットを入れてつなぐことで、部分的に引き出すことが可能なのが分かります。
この大元のデータの引き出し方は、トリアコンタン氏作のスプレッドシート等が参考になるでしょう。

indexOf：JavaScript

最後の「console.log($gameParty._actors.indexOf(before));」はJavaScriptの知識が必要です。
これまでの情報で書いたとおり、配列は[a,b,c]のように括弧内に要素が入っています。
「indexOf(xxx)」はJavaScriptで配列の中に同じ内容が何番目に入っているのかを返します。
順番のカウントは0から始まります。
developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf
今回は、これを使って指定のアクターIDがパーティの何番目に入っているのかを調べています。

splice：JavaScript

次の「splice」で配列を置換しています。
developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Array/splice

最後の2行はツクールのゲーム内のリフレッシュ処理です。

これを行わないと、アクターがマップ画面で入れ替わっても表示されているキャラクターが入れ替え前のままになってしまうため実行します。

まとめ

プラグインコマンドでJavaScriptが実行できるのが、ご理解いただけたかと思います。
プラグインコマンド単体のプラグインもありますが、多くはプラグインで追加された機能に対して、何らかの指示（機能のON/OFF等）を行うために設定するケースが多いです。
この場合、そのプラグイン内をスクリプトで呼び出しているというわけです。

完成品は下記です。
fungamemake.com/archives/12051

次のステップ

RPGツクールMZ用にプラグインコマンドを移植します。
仕様を把握し、JSONデータを扱う初歩に触れます。

プラグインの作り方入門その8：MZプラグインコマンドの作り方（JSONデータ）