ツクールフォーラムアドベントカレンダー Advent Calendar 2020
https://adventar.org/calendars/5074
https://forum.tkool.jp/index.php?threads/【募集中】アドベントカレンダー2020.4530/#post-26453
まえがきの後は、特定スロットの武具の名前を、職業欄に表示するスクリプトを作成していきます。
まえがき（読み飛ばして頂いて構いません）
さて、今年は書く方が不足しているということで、久々にci-enで筆を取ってみたわけであります。
自分は、RPGツクールMV Trinityのｐｓ４版を発売直後に定価
その時に感動したのが、プラグインという素晴らしいモノがあること。
競合の問題。欲しいゲーム内情報の取得法。何度も掲示板やＳＮＳで諸先輩方に助けてもらって今があります。
そんな自分の現在はというと、バリバリスクリプトを書けるようになった！
自分で必要な分のゲーム内の情報を取得したり、
画面は現在作っているゲームのステータス画面です。
教える立場にいるのかといえば、
もしここで自分がおかしな事を書けばきっと諸先輩方が指摘をしてくれるでしょうし、
ぶっちゃけ記事の中で多くの部分に多分
スクリプトに関して、まず何に躓いたのか。
自分が当時、最も始めに疑問に思い、理解に時間がかかった事を書いていきます。
プラグインとはどうやって、いつロードされているのか。
プラグインっていつどうやってロードされてるんだ？
プラグインコマンドで呼ぶものやメモ欄に記述するもの。
プラグインへの認識が、お借りして入れると（何故か）動く。
これに関しては、
ゲーム中は常にスクリプトは常に絶え間なく呼び出されているものであり、
イメージ的にはイベントコマンドの並列処理がずーっと走っている感じでしょうか。
そして、プラグインとはコアスクリプトを上書き・或いは拡張するものであり、
つまり、然るべき場所 (処理の近しい場所)にやりたい処理を追加する事が出来れば、
例えばクリティカル威力を変更したり、アイテムの取得時にはそのＩＤをゲーム内変数に代入したり、ＴＰ再生を固定値ではなく割合にしたり。リザルト画面を消したり。
その為にはまず、然るべき場所 とはコアスクリプトの何処であるのかを見つける方法を身に着けなくてはいけません。
今回は例として、ステータス画面に表示されている職業名の場所に、
例えばその防具を称号として扱えば、付けている称号がステータス画面に表示される。
何処を修正したいのか探そう。
コアスクリプトは
rmmz_core
から構成されています。詳しい説明はもう他の方でしてる方も多いですし、
何処に入ってるかわからない？
料理だってそうでしょう？
因みに自分はプラグイン触るときは未だに全部コアスクリプト開きっぱなしです。
今回はステータス画面で、職業の表示です。
まず、statusでコアスクリプト内を検索してみます。４８７件ヒットしました。
では、次にclassで検索します。これは１７６件ヒットしました。だいぶマシですね。然るべき場所 にたどり着けるのですが、
ステータス画面。表記は他にもあります。
でも職業はクラス。ステータスはステータスでわかりましたが、二つ名とはどう探せばいいのか？
ここでは２つの方法を提示します。
一つ、トリアコンタンさんのMZの非公式スクリプトリファレンスをお借りします。
$dataActors[id].nickname
と記述してあります。
もう一つは、テストプレイ中のコンソールログを使います。
……だけではなく、下の入力欄に適正な記述を行うと、
コンソールログの使い方
テストプレイ中にＦ１２を押すと出てきます。
こんなのですね。
とりあえずこれを開いて。
$gameActors.actor(アクターID).setNickname("変更する二つ名")
次に、こういう記述がどういう意味なのか紐解いておきましょう。
. ←は、そのデータ群の中の……或は命令という感じです。
$gameActors.actor(アクターID).setNickname("変更する二つ名")
一行の中に、何処のデータで何をしろ。
カッコの中の数字は何番のＩＤの情報を見るか。という指定なので、
$gameActors.actor(1)
この記述で見てみましょう。
見ていくと、見覚えのある名前が出てくると思います。ブレン や、二つ名のＥクラス冒険者 ですね。
このデータを見れることはとても重要で、
今回であればアクターの情報はもう見えています。
例えばこのコンソールログに
$gameActors.actor(1)._paramPlus[3] =999
ともあれ、$gameActors.actor()の中身を覗いてみたことで、
そうすると、１４件しかヒットしません！
色々見ていくと、いかにも怪しげな
という記述が見つかります。名前、クラス、ニックネーム。
そうです、ここはもう然るべき場所 の一歩手前です。
this.はとても難しいのですが、
ここで、本来変更したいのはクラスであることを考え、
Window_StatusBase.prototype.drawActorClass = function(actor, x, y, width) {
width = width || 168;
this.resetTextColor();
this.drawText(actor.currentClass().name, x, y, width);
};
そのうちの１件がこれ。
ここが目的地です。お疲れさまでした！
これをプラグインにする。以下をコピーして貼り付け
/*============================================================================http://opensource.org/licenses/mit-license.php
[Blog] : / : @target MZ @plugindesc 職業表示を変更する @author あなた
(() => {
width = width || 168;
this.resetTextColor();
this.drawText(actor.currentClass().name, x, y, width);
};
↑ここまで
これに、適当な名前をつけて拡張子を.jsで保存します。
自分も暫くメモ帳をつかっていましたが、エディタをオススメされまして。
因みに自分はatomですが、他人にコードを見せる（相談する）
諸先輩方がきっとおすすめを教えてくれることでしょう。
で、これを普段使っているプラグインと同様の場所に入れて、ゲーム内からいつもどおりに入れれば、あなたのプラグインが完成しました！
とはいえ、このプラグインは、
ここで競合についても少しお話します。
Window_StatusBase.prototype.drawActorClass
プラグインはコアスクリプトに対して、上に置いてあるものから上書き保存をして、最終的に出来上がったものを、あなたのゲームで起動します（多分）
プラグインの競合というのは、この過程で、
クリティカル威力は本来の威力の１００倍にせよ。
と、コアスクリプトに上書きをした後に、
クリティカル威力は本来の威力の１０００倍にせよ。
という上書きをすれば、片方は機能しなくなりますよね。そういうことです。
とりあえず概要の話なのでここでは置いておきます。
さて、次にプラグイン化した方の記述を変えていきます。
this.drawText(actor.currentClass().name, x, y, width);
では、これをどうしたいのかを考えます。
称号の装備がない時は、職業本来の名前を表示し、
はい、どーん。 ……流石に疲れてきたので。
改変後
Window_StatusBase.prototype.drawActorClass = function(actor, x, y, width) {
width = width || 168;
this.resetTextColor();
if ($dataArmors[actor._equips[4]._itemId] == null) {
this.drawText(actor.currentClass().name, x, y, width);
return;
}
if (actor._equips[4]._itemId == 0) {
this.drawText(actor.currentClass().name, x, y, width);
}else{
this.drawText($dataArmors[actor._equips[4]._itemId].name, x, y, width);
}
};
ここまで
actor._equips[4] というのは、アクターの装備で５箇所目を意味します。
そこを参照します。
$dataArmors[].name
というのは、防具データ[]番の名前を参照する。ということです。
$dataArmors[actor._equips[4]._itemId].name
こうなると、五箇所目に装備中の”何か”のＩＤと同じＩＤを持つ防具の名前を参照せよ。です。
this.drawText(,x,y,width)は少し難しいのですが、
そもそも、大本のこれ↓が呼び出された際、
actorとｘとｙとwidthの数値を受け取ってきています。
Window_Status.prototype.drawBlock1 = function() {
const y = this.block1Y();
this.drawActorName(this._actor, 6, y, 168);
this.drawActorClass(this._actor, 192, y, 168);
this.drawActorNickname(this._actor, 432, y, 270);
};
この中にある、
this.drawActorClass(this._actor, 192, y, 168);
呼び出し元のこの記述ですね。
因みにblock1Yを追いかけると、
Window_Status.prototype.block1Y = function() {
return 0;
};
つまり、block1Yは０です。block1YをＹという名前に変えて、
Window_StatusBase.prototype.drawActorClassの中で
this.actor が何番のアクターであるかの情報をもっていて、それをactorという名前で受け取ってきているからですね。
……俺のこんな説明でわかるでしょうか？
その文字列に拘って見るのではなく、それに入っている情報が
ここでお役立ち情報。
これなんの情報持ってんだよって思ったときには
console.log();
をスクリプトの間に記述してみましょう。
Window_StatusBase.prototype.drawActorClass = function(actor, x, y, width) {
width = width || 168;
this.resetTextColor();
this.drawText(actor.currentClass().name, x, y, width);
};
例えば今回の大本。改変前のこれで言えば、actorとかthisなんかはわかりにくいですよね。こんなときは
Window_StatusBase.prototype.drawActorClass = function(actor, x, y, width) {
width = width || 168;
console.log(this);
console.log(actor);
this.resetTextColor();
this.drawText(actor.currentClass().name, x, y, width);
};
のように、記述することで、thisとactorが持っている情報をコンソールログに出力せよ。という命令になります。この状態でテストプレイを開始し、Ｆ１２でコンソールログを開けば、該当した場所が呼び出された時に、このスクリプト内の何行目の出力結果がこれ！
今回であればステータス画面を開いたりすると、コンソールログが出力されると思います。このように console.log(); は値の特定に極めて役立ちます。
困ったら console.log(); です。
こんなものでしょうか。
今回書いたのはステータス画面用に。ではあるのですが、
Window_StatusBase.prototype.drawActorClass
は機能が最小限で、とても汎用的なモノなので、
その他のプラグイン独自のシーンに呼び出されているケースもありますし、
Window_StatusBase.prototype.drawActorClass
さ、これで自分の記事も終了です。
誰かのお役に立てば幸いです。
最後に、完成後にもう少し使いやすくした状態のプラグインです。
そして、以前Twitterでひっそり公開したプラグインの再掲示もしておきます。
職業名か二つ名の表示欄に武具の名前を表示させるプラグイン
https://drive.google.com/file/d/11fgMnFm9sEArMJyab8Q8A9gz_0QPHbJ7/view?usp=sharing
ＴＰＢにおいてスキル後にゲージが溜まっているスキルや装備がつくれるプラグイン
https://drive.google.com/file/d/1BOsEBFdsESVJSZzfIkEH3EKfhLvQb5DZ/view?usp=sharing
ＴＰＢにおいて、キャストタイムを軽減するスキルや装備が作れるプラグイン
https://drive.google.com/file/d/18nIe1hp1vEi0dwexfFu_S0Ag52EFIdcL/view?usp=sharing
