SVキャラのモーションを拡張するプラグイン – FTKR_ExSvMotion.js

-----------------------------------------------------------------------------
概要
-----------------------------------------------------------------------------
本プラグインを実装することで、アクターのさまざまな状態における
SVキャラのモーションを変更します。


-----------------------------------------------------------------------------
設定方法
-----------------------------------------------------------------------------
1.「プラグインマネージャー(プラグイン管理)」に、本プラグインを追加して
ください。

2. 他プラグインと組み合わせる場合
当プラグインは以下のプラグインよりも下にしてください。
YEP_BattleEngineCore
YEP_X_AnimatedSVEnemies
YED_SideviewBattler


-----------------------------------------------------------------------------
行動モーションの設定
-----------------------------------------------------------------------------
アクターの非ダメージ時や、攻撃時など行動時におけるモーション設定します。
設定できる行動モーションは以下の通りです。

待機、ダメージ、回避、突き、払い、飛び道具、スキル、魔法、アイテム

プラグインパラメータの行動モーションの設定で、以下のコード名から
指定してください。

モーションのコード
walk, wait, chant, guard, damage, evade, thrust, swing,
missile, skill, spell, item, escape, victory, dying,
abnormal, sleep, dead, custom, other

customはカスタムモーションです。(は番号)

otherは別画像モーションです。(は番号)


-----------------------------------------------------------------------------
スキル・アイテムに個別でモーションを設定
-----------------------------------------------------------------------------
スキル、アイテムのメモ欄に以下のタグを設定すると、待機時、使用時のモーションを
変更することができます。

<ESM モーション: name>
<ESM MOTION: name>
使用時のモーションを name に変更します。
name にはモーションのコードを設定してください。


<ESM 武器モーション>
<ESM WEAPON_MOTION>
このタグがあると、手持ちの武器付きのモーションになります。


<ESM 詠唱ON>
<ESM CHANT_ON>
このタグがあると、スキル実行待機中のモーションを詠唱モーションに設定できます。


<ESM 詠唱OFF>
<ESM CHANT_OFF>
このタグがあると、詠唱モーションをOFFに設定できます。
SV魔法スキルに設定したスキルであっても、詠唱モーションを実行しません。



-----------------------------------------------------------------------------
カスタムモーションについて
-----------------------------------------------------------------------------
custom(は数字)で指定するモーションは、本プラグインで新規に設定可能な
モーションです。

以下のプラグインパラメータで表示するモーションのコードを設定することで
複数のモーションを連続して表示させることができます。
カスタムモーションは、8個まで設定できます。

<CustomNon Loop>
:ここに設定したコードのモーションはループしません。
<CustomLoop>
:ここに設定したコードのモーションをループさせます。

モーションのコードは、カンマ(,)を使うことで複数入力できます。
これらのパラメータに、customを使用することはできません。


モーションのループについて
<CustomLoop>に設定したモーションをループさせます。
複数のコードを入力した場合も、それらを順に表示してループします。
設定しない場合は、そのカスタムモーションはループしません。

設定例)
<CustomNon Loop> :victory, skill
<CustomLoop> :item, walk
上記のように設定した場合、以下の順番でモーションを表示します。

victory ⇒ skill ⇒ item ⇒ walk ⇒ item ⇒ walk ⇒ ...
|→ここからループ


-----------------------------------------------------------------------------
別画像モーションについて
-----------------------------------------------------------------------------
other(は数字)で指定するモーションは、本プラグインで新規に設定可能な
アクター専用のモーションです。

データベースのアクターの「画像」設定で選択したSV戦闘キャラ画像以外の
画像を使用することができます。

使用する画像は、アクターのメモ欄に以下のタグで設定します。

<ESM_画像:filename>
<ESM_IMAGE:filename>

画像ファイル filename.png は img/sv_actors/ に保存してください。
使用できる画像規格は、SV戦闘キャラ画像と同じです。

otherの番号は、画像内のどの位置のモーションを使用するか設定する番号です。
3枚で1セットで左上のモーションを0番、一つ下を1番、一つ右を6番として数えます。
other0 ~ other17 まで使用できます。

なお、各別画像モーションはループしません。


-----------------------------------------------------------------------------
状態モーションの設定
-----------------------------------------------------------------------------
アクターの以下の状態におけるモーション設定します。

input : コマンド入力中
chant : 詠唱中
guard : 防御中/防御待機中
state: ステート付加中(がステートモーション番号)(例:state4)
victory : 戦闘勝利中
escape : 逃走中
dying : 瀕死時(残りHP25％以下)
custom: カスタムコンディション(は番号)(例:custom1)
action : 行動モーション全般(モーション名は空欄)

モーションは、モーション1～モーション16まで設定できます。
数字が大きい方が、モーションの優先度が高くなります。

<MotionName>
:モーション名のコードを指定してください。
: walk, wait, chant, guard, damage, evade, thrust, swing,
: missile, skill, spell, item, escape, victory, dying,
: abnormal, sleep, dead, custom, other

<MotionCondition>
:モーションの状態。上記の9種類から設定してください。
:状態モーションに設定したモーションは、ループします。(action除く)

※action を設定しない場合は、すべての行動モーションよりも優先が高くなります。


-----------------------------------------------------------------------------
ステートモーションの設定
-----------------------------------------------------------------------------
ステートのメモ欄に以下のタグを入力することで、ステート付加中のモーションを
設定できます。

<ESM モーション: x>
<ESM MOTION: x>
:ステートモーション番号を x に設定します。
:タグで設定しない場合は、基本設定の[SV]モーションの設定に従います。


<ESM モーション固定>
<ESM FIXED_MOTION>
:ステート付与中のモーションの更新を無効にします。
:例えば、防御モーション中にこのステートが付与されると、防御モーションで
:固定され、以降このステートが解除されるまで何があっても防御モーションを
:とり続けます。


-----------------------------------------------------------------------------
カスタムコンディションの設定
-----------------------------------------------------------------------------
状態モーションのプラグインパラメータ<MotionCondition>に設定できる
独自条件を設定できます。

プラグインパラメータ<Custom Condition> にJS条件式を入力してください。

[条件式 の値について]
条件式は、ダメージ計算式のように、計算式を入力することで、固定値以外の値を
使用することができます。以下のコードを使用できます。
a.param - 使用者のパラメータを参照します。(a.hit で使用者の命中率)
v[x] - 変数ID x の値を参照します。
s[x] - スイッチID x の値を参照します。


-----------------------------------------------------------------------------
本プラグインのライセンスについて(License)
-----------------------------------------------------------------------------
本プラグインはMITライセンスのもとで公開しています。
This plugin is released under the MIT License.

Copyright (c) 2017,2018 Futokoro
http://opensource.org/licenses/mit-license.php


プラグイン公開元
https://github.com/futokoro/RPGMaker/blob/master/README.md


-----------------------------------------------------------------------------
変更来歴
-----------------------------------------------------------------------------

v1.4.0 - 2019/04/13 : 機能追加
1. 状態モーションの優先度に、行動モーション action の状態を設定する機能を追加。

v1.3.2 - 2019/03/10 : 機能追加
1. パーティーコマンドをスキップするプラグインに対応するプラグインパラメータ
Enabled Refresh In PartyCmd を追加。

v1.3.1 - 2018/05/31 : 不具合修正
1. パーティーの誰かが防御を使用すると、パーティーメンバー全員が防御モーションを
一瞬実行する不具合を修正。

v1.3.0 - 2018/05/22 : 機能追加
1. 特定のステート付与中のモーションの更新を無効にする機能を追加。

v1.2.10 - 2018/04/29 : 不具合修正
1. 状態モーションにループしないモーションを設定すると、エラーになる不具合を修正。

v1.2.9 - 2018/04/28 : 不具合修正
1. デバッグ設定のログ表示を有効にすると、特定のモーション時にエラーになる
不具合を修正。

v1.2.8 - 2018/04/28 : 不具合修正
1. YEP_BattleEngineCore.jsと組み合わせている場合に、戦闘不能時の
状態モーションの設定が反映されない不具合を修正。

v1.2.7 - 2018/04/12 : 不具合修正
1. YEP_VictoryAftermath.jsと組み合わせた場合に、勝利モーションを実行しない
不具合を修正。

v1.2.6 - 2018/04/10 : 不具合修正、機能追加
1. YED_SideviewBattlerと組み合わせた場合に、3フレーム以外のモーションを
表示できない不具合を修正。
2. スキルに詠唱モーションを実行させるタグ付け機能を追加。

v1.2.5 - 2017/08/24 : 不具合修正
1. メモ欄の読み取り処理を見直し。

v1.2.4 - 2017/07/07 : 不具合修正
1. 状態モーションのescapeが、戦闘時以外でも有効になる不具合を修正。

v1.2.3 - 2017/05/19 : 不具合修正
1. 防御モーションの優先度が反映されない不具合を修正。

v1.2.2 - 2017/05/11 : 不要な記述を削除
1. 余計なログを出力する箇所を削除。

v1.2.1 - 2017/05/10 : 不具合修正
1. FTKR_FacialImageDifference.jsに対応

v1.2.0 - 2017/05/09 : 機能追加
1. 別のSV画像を使用したモーションを設定する機能を追加。
2. スキル・アイテムの使用モーションを個別に設定する機能を追加。
3. HP回復時のモーションを設定する機能を追加。
4. 状態モーションに独自条件を設定するカスタムコンディションの機能を追加。

v1.1.5 - 2017/05/06 : 不具合修正
1. ステートモーションタグが設定されていない場合に、ステートの
モーションを正しく反映できない不具合を修正。

v1.1.4 - 2017/04/30 : 不具合修正
1. YED_SideviewBattler側にモーションデータを正しく渡せていなかった
不具合を修正。

v1.1.3 - 2017/04/27 : 不具合修正、機能追加
1. requestMotion()に関する不具合修正。
2. YED_SideviewBattlerのバトラーセットカスタムに対応。
3. YEP_X_AnimatedSVEnemiesのエネミーモーションに対応。

v1.1.2 - 2017/04/27 : 不具合修正
1. 状態モーション10 以降が反映されない不具合を修正。

v1.1.1 - 2017/04/26 : YEP_BattleEngineCoreに対応

v1.1.0 - 2017/04/25 : 仕様変更、機能追加
1. 攻撃等の行動モーションを変更する機能を追加。
2. 状態モーションに、戦闘勝利、逃走、瀕死時のモーションを追加。
3. 状態モーションのデフォルト設定を見直し
4. 複数のモーションを組み合わせて連続で表示する機能を追加。

v1.0.1 - 2017/04/21 : 不具合修正
1. ステートのタグ設定が正しく読み取れない不具合を修正。

v1.0.0 - 2017/04/19 : 初版作成

-----------------------------------------------------------------------------