場所移動前後にコモンイベントを実行【RPGツクールMZ&MVプラグイン】

2021年10月31日

 場所移動前後にコモンイベントを実行します。


 例えば、独自のフェードアウト/フェードイン処理の作成などに便利です。
 もちろん、場所移動後の共通処理を設定したい場合にも有効です。

 ※ちなみに、上記の演出はFilterControllerMZ.js(ツキミ様)のshockwaveというエフェクトを使っています。

目次


導入方法(Install)

更新履歴(History)

使用方法(Usage)

MZ用プラグインコマンド(Plugin Command MZ)

MV用プラグインコマンド(Plugin Command MV)

プラグインパラメータ

移動前コモンイベント(BeforeCommonEvent)

移動後コモンイベント(AfterCommonEvent)


導入方法(install)


 以下のファイルをダウンロードし 、[プロジェクト]\js\plugins に放り込みます。ツクールのプラグイン管理から機能をONにしてください。
 ※いずれのプラグインもMV、MZの両方で有効です。

 NRP_TransferCommonEvent.js ver1.01(2021/10/31)

更新履歴(History)


2021/10/31(ver1.01)

  • 一時的にコモンイベントを無効化するプラグインコマンドを追加。

2021/07/29(ver1.00)

  • 公開!

使用方法(Usage)


 プラグインパラメータに実行したいコモンイベントを設定してください。
 設定すると、あらゆる場所移動に対して有効になります。

 また、プラグインコマンドによって、フェード方法を強制的に変更できます。
 例えば、制作の途中で独自のフェード処理を追加した場合、デフォルトのフェードが『黒』のままだと無駄なウェイトが発生してしまいます。
 そういった場合は、移動前コモンイベント内でフェードを『なし』に変更すればOKです。

 あるいは、通常のフェード処理に戻したいということもあるかもしれません。
 その場合も、場所移動の直前にスイッチなどを使って、移動前コモンイベント内で切り替えればOKです。

MZ用プラグインコマンド(Plugin Command MZ)


コモンイベントの無効化

 一時的に場所移動時のコモンイベントを無効化します。
 falseにすれば元に戻ります。

場所移動情報の変更

 フェードインの方法を変更できます。
 移動前コモンイベントなどで指定してください。
 なお、一度場所移動すると設定はクリアされます。

MV用プラグインコマンド(Plugin Command MV)


 ※大文字個別は区別しません。また[]は含まないでください。

コモンイベントの無効化

NRP.TransferCommonEvent.DisableCommonEvent [true/false]


場所移動情報の変更

NRP.TransferCommonEvent.ChangeTransferInfo [フェード方法]

 フェード方法は数値で指定してください。
  0 = 黒, 1 = 白, 2 = なし
 となります。

プラグインパラメータ


移動前コモンイベント(BeforeCommonEvent)

 場所移動前に実行するコモンイベントです。
 正確にはデフォルトのフェードアウト前に実行されます。

移動後コモンイベント(AfterCommonEvent)

 場所移動後に実行するコモンイベントです。
 正確にはデフォルトのフェードイン後に実行されます。

 >RPGツクールMZ&MV目次に戻る
posted by 砂川赳 at 18:26 | RPGツクールMZ&MV | このブログの読者になる | 更新情報をチェックする

スキルの効果範囲を拡張【RPGツクールMZ&MVプラグイン】

2021年10月30日

 スキル(およびアイテム)の効果範囲を拡張するプラグインです。

 縦列、横列、円形、グループ、敵味方全体など様々な効果範囲を実現できます。
 初期状態のままでも多数の範囲パターンを使用できますが、独自追加も可能です。いわゆるレベル5デスなど、風変わりなスキルもこのプラグインで実現可能です。
 基本的にはサイドビュー用ですが、一部はフロントビューでも使えます。

 以下は紹介動画です。
 縦・横・円・十字・敵味方全体(使用者除く)などの範囲で魔法を使ってみました。ついでにレベル5デスもあります。
※画面が小さい場合は右下の全画面表示をクリックしてください。


  • 導入方法
  • 注意点
  • 更新履歴
  • 使用方法
  • パラメータ
  • 個別設定

    導入方法


     以下のファイルをダウンロードし 、[プロジェクト]\js\plugins に放り込みます。ツクールのプラグイン管理から機能をONにしてください。
     ※このプラグインはMV、MZの両方で有効です。

     NRP_SkillRangeEX.js ver1.061(2021/10/30)

    注意点


     このプラグインは以下のプラグインよりも、上に配置してください。そうしないと一部の機能が動作しなくなります。

    • NRP_VisualTurn.js(順序リストの色変え対象に影響)
    • NRP_DynamicAnimation.js(アニメーションの表示位置に影響)

    更新履歴


    2021/08/13 -> 10/30(ver1.06 -> 1/061)

    • NRP_PartyAttack.js(ver1.01)の全体選択に対応。
      『全体時の主対象条件』を使用したスキルも適切に表示します。
    • line(直線)型の対象が選択時と実行時で、アクターの前進分だけわずかにズレる不具合修正。(10/30 ver1.061)
      ※プラグインパラメータの既定値の修正なので、プラグインを一覧から一旦削除して再登録するなりしないと反映されません。

    2021/08/05(ver1.05)

    • MZにて範囲選択中のアクターがフラッシュしない不具合修正。
    • アクター対象ウインドウを未選択にできない不具合修正。

    2020/08/22 -> 2021/07/03(ver1.04 -> 1.043)

    • ツクールMZに対応。
    • 落ちるパターンがあるので修正。(08/24 ver1.041)
    • フロントビューでエラーになる不具合修正。(08/27 ver1.042)
    • MZ用にプラグインの登録順序を指定。(2021/07/03 ver1.043)

    2020/06/16(ver1.03)

    • 英語対応。

    2020/02/23(ver1.02 -> 1.023)

    • ツクールMV1.5.Xでも動作するよう対応。
    • 外部プラグインとの併用エラーの対処用に微調整@。(04/23 ver1.021)
    • 戦闘不能対象に空振りでエラーとなる不具合修正。(04/24 ver1.022)
    • 外部プラグインとの併用エラーの対処用に微調整A。(05/12 ver1.023)

    2020/02/12(ver1.01 -> 1.011)

    • 作成中プラグインとの連携処理を実装。
    • アクターのサイズが0として計算される不具合修正。
    • ↑の修正が不完全だったので再修正。(ver1.011)

    2020/02/01(ver1.00 -> 1.001)

    • 公開!
    • パーティ人数が3人以下だとエラーとなる不具合修正。(ver1.001)

    使用方法


     スキル(アイテム)のメモ欄に<RangeEx:[範囲]>を書き込めばOKです。
     初期状態で以下の範囲が使用できます。日本語でも英語でもどちらでも構いません。

    • vertical(縦)
    • horizontal(横)
    • group(グループ)
    • circle(円)
    • cross(十字)
    • line(直線)
    • around(自分周辺)
    • all(敵味方全員)
    • allOther(自分以外)
    • lv5(LV5の倍数)

     例1:<RangeEx:縦>
     例2:<RangeEx:vertical>

     エディタ上で設定する範囲は基本的に単体系のものを使います。ただし、全体範囲を使った特殊なスキルも作れます(詳細は後述)。
     以下、各範囲の詳細です。

    <RangeEx:縦> or <RangeEx:vertical>

     縦列範囲を対象にします。

    20200201_fireWall.JPG

     エディタ上で設定した範囲が『単体』の場合、選択した対象と同じ列にいるキャラも巻き込みます。
     以後、選択した対象を『主対象』。巻き込まれた側を『副対象』と記述します。
     対象選択時の範囲に含まれていれば、副対象も色が変わります。

     位置が『画面』のアニメーションを指定した場合、主対象と同一のX座標を中心に表示します。

     エディタ上で設定した範囲が『全体』の場合、最前列にいる主対象を強制で選択します。前列しか攻撃できないスキルが作れます。

     正確な巻き込み範囲は主対象のX座標から±40ピクセルです。数値は変更可能です。

    <RangeEx:横> or <RangeEx:horizontal>

     主対象とその横列上にいる相手を対象とします。

    20200201_thunderbolt.JPG

     要領は縦列とほぼ同じです。
     位置が『画面』のアニメーションを指定した場合、主対象と同一のY座標を中心に表示します。

    20200201_animatioon.JPG

     こんな感じで中央から左を範囲としたアニメーションを作ればいい感じになります。もちろん敵が使う場合はちゃんと左右反転されます。

     エディタ上で設定した範囲が『全体』の場合、最下段にいる主対象を強制で選択します。下段しか攻撃できないスキルが作れます。
     まあ、サイドビューでは用途不明なんですけどね。奥行きのあるフロントビューでの前列攻撃とかに使えませんかね?

     正確な巻き込み範囲は主対象のY座標から±40ピクセルです。

    <RangeEx:グループ> or <RangeEx:group>

     いわゆるドラクエシリーズのアレ。同一IDの敵キャラをまとめて対象とします。対象が味方の場合は単なる全体スキルです。
     配置が離れていても、同種の敵は同グループ扱いです。

    20200201_group.JPG

    <RangeEx:円> or <RangeEx:circle>

     主対象を中心とした円内にいる相手を対象とします。

    20200201_circle.jpg

     正確な巻き込み範囲は主対象から半径100ピクセルです。縦横100ピクセル以上のデカブツが主対象だと範囲が画像内に収まるため、何も巻き込めません。

     範囲を『全体』にすると、最も近くにいる相手を主対象とします。使い道は謎ですが、こういうこともできるというサンプルです。

    <RangeEx:十字> or <RangeEx:cross>

     主対象と同一の縦列&横列にいる相手を対象とします。

    20200201_cross.JPG

     前述の縦と横の範囲をくっつけたものです。

    <RangeEx:直線> or <RangeEx:line>

     行動主体と主対象を通過する直線上にいる相手を対象とします。
     投擲っぽいアニメーションを作れれば使い道もあるかも。

    <RangeEx:自分周辺> or <RangeEx:around>

     行動主体を中心とした円内にいる相手を対象とします。

     20200201_around.JPG

     正確な巻き込み範囲は行動主体から半径250ピクセルです。
     なお、対象がいないとアニメーションも何もなしで不発します。

     この範囲は主対象を使用しないため、エディタ上の範囲は『全体』にしたほうが自然かもしれません。この下の三項目も同様です。

    <RangeEx:敵味方全員> or <RangeEx:all>

     敵味方全員を対象とします。

    <RangeEx:自分以外> or <RangeEx:allOther>

     上の範囲からスキル使用者を除いたものです。

    <RangeEx:LV5の倍数> or <RangeEx:lv5>

     レベル5の倍数の相手を対象とします。これでレベル5デスもバッチリ再現できます。
     なお、初期状態では味方対象専用です。敵を対象にしてもレベルがないため意味をなしません。

    パラメータ


     上記だけで十分に利用可能ですが、当プラグインはパラメータによって独自範囲の追加も可能です。
     上級者向けの内容も含まれますが、ご了承ください。

    範囲一覧(rangeList)

     範囲を定義した一覧です。既存の設定を編集したり新しい範囲の追加が可能です。
     以下は範囲に含まれる項目です。

    名前(name)

     名称です。
     識別用のメモ書きとして作った項目ですが、メモ欄での指定にも使えます。

    識別子(id)

     スキル(アイテム)のメモ欄から呼び出す際に使う識別子です。

    範囲条件(rangeIf)

     範囲を定める条件式(JavaScript)です。

     例えば範囲『縦』だと、
    40 >= Math.abs(b.x - c.x)

     というように、定義されています。

     これは主対象(b)と副対象(c)のX座標を引き算し、その差が40ピクセル以下ならば副対象を巻き込むという意味です。
     Math.abs()というのは絶対値を求める関数です。つまり「(b.x - c.x)が-40〜40の範囲にあるかどうか?」ということ。

     40の数値を変えれば、範囲を広げたり狭めたりできます。難しいという人も、それだけ分かれば十分です。

     範囲『横』だと、以下の通りです。
     『縦』のxをyに変えるだけかと思いきや、少し違います。
    40 >= Math.abs(b.y - b.height / 2 - (c.y - c.height / 2))

     長くなって嫌な感じですが、これは画像の高さ(height)によってY座標の基準点を調整しているためです。
     というのも、戦闘キャラ画像のY座標は足元が基準になっています。画像の中央を基準とするように調整すると、こういう式になります。

     長くなるためその他の条件式については割愛します。
     これ以外の数式も範囲の広さや半径などは数式の先頭付近に記述しています。調整したい場合はそこをいじってください。
     円の数式とか凄いことになっていますが、最初の数値が半径です。それだけ理解すれば支障ありません。

     また、上述の数式では使用していませんが、行動主体の座標は『a』で参照可能です。
     ただし、この数式で使用する『a』『b』『c』はスキルの計算式で使用するものとは、中身が異なることにご注意ください。実体はスプライト(画像情報)なので、座標や画像幅の状態などしか持っていません。

     では、レベルや攻撃力などいつもの情報(バトラー情報)を参照したい時はどうするかというと……。
    c._battler.level % 5 == 0

     というようにやります。
     上記は『LV5の倍数』で使用している範囲条件です。
     『c._battler』というように記述すれば、バトラー情報を参照できます。

     ちなみに『% 5』というのは、5で割った余りという意味です。

    画面アニメのX座標(screenAnimationX)

    画面アニメのY座標(screenAnimationY)

     画面対象アニメーションを表示するX座標およびY座標です。
     それぞれ指定しないと通常の全体アニメーションと同じ位置に表示されます。

     例えば範囲『縦』のX座標は以下の通りです。
    b.x

     対して、Y座標は空のままです。
     これはX座標は主対象と同位置、Y座標は通常の全体アニメと同位置に戦闘アニメーションを表示するという意味です。

    全体時の主対象条件(mainTargetAllIf)

     エディタ上で範囲を『全体』に指定した場合、この条件に従って主対象を選択します。『全体』を使わない場合、および主対象を条件にしない場合は不要な項目です。
     
     例えば範囲『縦』だと以下の通りです。
    c1._battler.isEnemy() ? c1.x > c2.x : c1.x < c2.x

     これは副対象(c1, c2と定義)を比較しあって、最も条件に合う対象を求めています。

     対象が敵の時はX座標が最も大きな対象(最も右)、そうでない場合は最も小さな対象(最も左)という意味です。これによって、範囲『全体』を選んだ場合に強制で前列を選択するようにしています。

     ……あまりピンとこないと思いますが、分からなくともさして問題ありません。正直、前列対象技を作るぐらいしか用途はないので。

    敵味方の区別をしない(noSide)

     ONにすると敵味方を無差別に対象とします。
     『敵味方全員』や『自分以外』はこれによって実現しています。

    個別設定

     以下のタグをスキル(アイテム)のメモ欄に記入すれば、個別の設定も可能です。
     例えば『レベル5の倍数』など一つしか使わないような設定の時に。また、呼び出した範囲の一部だけ条件を変えたい場合などにも使えます。

    • 範囲条件:<RangeExIf:[条件]>(必須)
    • 画面アニメのX座標:<RangeExAnimationX:[座標]>
    • 画面アニメのY座標:<RangeExAnimationY:[座標]>
    • 全体時の主対象条件:<RangeExMainTargetAllIf:[条件]>
    • 敵味方の区別をしない:<RangeExNoSide:[true or false]>


    <RangeExIf:b==c>
    <RangeExMainTargetAllIf:c1._battler.hp < c2._battler.hp>

     全体を対象にした場合に、HPが最も低いバトラーを狙います。
     <RangeExIf:b==c>で単体対象になります。

     >RPGツクールMZ&MV目次に戻る
  • posted by 砂川赳 at 16:39 | RPGツクールMZ&MV | このブログの読者になる | 更新情報をチェックする

    MV用プラグインをMZで使おう!【RPGツクールMZ】

    2021年10月29日

     RPGツクールMZ発売から1年以上が経過しました。
     当サイトにあるMV用プラグインは、全てMZへの対応を完了しており、機能として使えないものは存在しない状態です。

     しかしながら、外部のMV用プラグインの中には今もなお、MZ対応されていないものがたくさんあります。ゲーム制作者として僕も困ってしまうことが多々ありました。

     実のところ、MVとMZのプログラム的な違いはさほど大きくありません。MZに放り込むだけで、そのまま使用できるプラグインもわりとあったりします。

     ただそれでも、日常的にプラグイン開発をするような人間ならともかく、それ以外の人には少し敷居が高いかなあと思います。

     そんなわけで、MV用プラグインをMZで使う手順を書いてみます。

    目次



    まずは放り込んで試す


     何はともあれ、MV用プラグインをダウンロードして、MZ用プラグインのフォルダに放り込みます。
     さらにプラグイン管理にプラグインを登録します。


     すると、以下のような警告メッセージが画面下に出ると思います。
    プラグイン「hogehoge.js」は、RPGツクールMZに対応していない可能性があります。

     これはMV時代に開発されて以降、変更されていないプラグインなら必ず出るメッセージです。実際に動作するかは関係ありません。

     というわけで、気にせず動かしてみましょう。
     実際にプラグインの機能を試してみて、動作するようなら万々歳です。

     エラーが出るなど、想定した動作をしない場合は諦めましょう。いきなり投げやりですが、動かないものは動きません。
     JavaScriptを編集する気概があるなら、戦ってみてもよいと思います。

     ……が、この記事ではそこまでは踏み込みません。

    警告メッセージを消す


     動作が確認できた後には、先程の警告メッセージを消すためにプラグインを編集しましょう。
     必須ではありませんが、数多くのプラグインを使っていくなら、余計な警告はなくすべきだと考えます。雑に管理していると後で泣きを見ます。

     やり方は簡単です。
     プラグイン(.jsファイル)をテキストエディタで開き、
    @target MV MZ

     の記述を解説の上部に追加するだけです。
     ※行頭の「 * 」も必要です。

     場所は、
    @plugindesc

     と書いてある行の上でよいと思います。


     多言語対応されているプラグインの場合は、間違えずに使用したい言語の箇所に追加するようにしましょう。
     この記事を読んでいる人は、まず日本語だと思われますが。先頭に『ja』と書いてあるのがそれです。
     もちろん、全言語に対して追加しても構いません。

     編集後、プラグイン管理を開いて警告が消えていれば成功です。

    MV用プラグインコマンドの呼び出し


     MZではMVとプラグインコマンドの仕様が大きく異なります。
     その結果、イベントコマンドからMV用のプラグインコマンドを呼び出せなくなりました。

     ……が、実は公式プラグインのEventCommandByCode.jsを使えば、呼び出すことも可能だったりします。
     ※「公式プラグインってどこ?」という方は以下をご確認ください。
       [MZ]\dlc\BasicResources\plugins\official



     イベントコマンドのプラグインコマンドでEventCommandByCodeを指定。
     コマンドコードに『プラグインコマンド(リストの一番下)』を選択し、パラメータにMV用プラグインコマンドを指定すればOKです。

     ※ちなみに上記の例はSupponChangeTileId(Suppon様)というプラグインです。タイルの置換ができるので便利!

    互換系のプラグイン


     MZ用プラグインの中には、MV用のプラグインをMZで無理やり動かすようなものも存在するらしいです。

     ただし、純粋なMZ用プラグインに影響を与える可能性もあります。
     当サイトでは未検証につき割愛させていただきます。

     >RPGツクールMZ&MV目次に戻る
    posted by 砂川赳 at 09:16 | RPGツクールMZ&MV | このブログの読者になる | 更新情報をチェックする