darake Update: 2025-03-25

RPGツクールMVでScene_BattleやBattleManagerの処理まとめ

RPGツクールMV

この記事では、RPGツクールMVのバトル処理の根幹をなすScene_BattleとBattleManager回りの解説をする。

攻撃処理の基本的な流れ

まずは攻撃の処理について追っていく。プレイヤーが行動を決定してから、実際に攻撃の計算や表示が行われる処理は以下の通り。

RPGツクールMVで攻撃を実行するときの処理の流れを解説します。

攻撃処理の基本的な流れ

攻撃処理は大きく分けて以下のステップで行われます：

行動者（アクター/敵）の行動決定
行動内容（攻撃）の実行決定
ターゲット選択
ダメージ計算
ダメージ適用とアニメーション表示
結果の反映

コードの流れ

1. 行動者の取得

// BattleManager.update() から始まり、行動者を選択
BattleManager.updateTurn = function() {
    // 現在の行動者がいなければ、次の行動者を取得
    if (!this._subject) {
        this._subject = this.getNextSubject();
    }

    // 行動者がいる場合は処理を進める
    if (this._subject) {
        this.processTurn();
    } else {
        this.endTurn();
    }
};

getNextSubject() が先ほど説明した関数で、行動可能なキャラクターを選びます。

2. 行動内容の決定

// 行動内容を処理
BattleManager.processTurn = function() {
    var subject = this._subject;
    var action = subject.currentAction();

    if (action) {
        action.prepare(); // 行動の準備
        if (action.isValid()) {
            this.startAction(); // 行動開始
        }
        subject.removeCurrentAction(); // 行動を削除
    } else {
        this.endAction(); // 行動終了
    }
};

subject.currentAction() で行動者の行動を取得します。例えば攻撃ならば「攻撃」行動が選ばれます。

3. 行動の実行

BattleManager.startAction = function() {
    var subject = this._subject;
    var action = subject.currentAction();
    var targets = action.makeTargets(); // ターゲット選択

    this._phase = 'action';
    this._action = action;
    this._targets = targets;

    // 行動者のモーション開始
    subject.useItem(action.item());
    this._action.applyGlobal(); // 全体効果の適用

    this.refreshStatus();
    this._logWindow.startAction(subject, action, targets); // ログ表示
};

makeTargets() でターゲットが選択され、useItem() で行動使用時の処理（MP消費など）が実行されます。

4. 攻撃の実行とダメージ計算

// Window_BattleLog でアニメーション表示後に実行される
BattleManager.invokeAction = function(subject, target) {
    var action = this._action;
    this._logWindow.push('performActionStart', subject, action);

    // 攻撃実行
    action.apply(target);

    // 行動実行後の処理
    this._logWindow.push('performActionEnd', subject);
    this._logWindow.displayActionResults(subject, target);
};

action.apply(target) で実際の攻撃が行われます。内部ではダメージ計算が行われています。

5. 実際のダメージ計算

// 攻撃時のダメージ計算（Game_Action.prototype.apply から呼ばれる）
Game_Action.prototype.makeDamageValue = function(target, critical) {
    var item = this.item();
    var baseValue = this.evalDamageFormula(target); // ダメージ式評価
    var value = baseValue * this.calcElementRate(target); // 属性倍率

    if (this.isPhysical()) {
        value *= target.pdr; // 物理防御率
    }
    if (this.isMagical()) {
        value *= target.mdr; // 魔法防御率
    }

    if (baseValue < 0) {
        value *= target.rec; // 回復倍率
    }

    if (critical) {
        value = this.applyCritical(value); // クリティカル
    }

    value = this.applyVariance(value, item.damage.variance); // ばらつき
    value = this.applyGuard(value, target); // ガード

    // 最終的なダメージ値（整数化）
    return Math.round(value);
};

この関数で、基本ダメージやクリティカル、属性などの計算が行われます。

6. ダメージの適用

// ダメージを対象に適用
Game_Action.prototype.executeDamage = function(target, value) {
    var result = target.result();
    if (value === 0) {
        result.critical = false;
    }
    if (this.isHpEffect()) {
        this.executeHpDamage(target, value);
    }
    if (this.isMpEffect()) {
        this.executeMpDamage(target, value);
    }
};

// HP値の変更
Game_Battler.prototype.gainHp = function(value) {
    this._result.hpDamage = -value;
    this._result.hpAffected = true;
    this._hp += value;
    this._hp = this._hp.clamp(0, this.mhp);
    this.refresh();
};

ダメージはこのようにターゲットのHPに適用されます。

解説のまとめ

RPGツクールMVでの攻撃処理の流れは以下の通りです：

BattleManager.getNextSubject() で次の行動者を決定
行動者の現在の行動（攻撃など）を取得
行動に応じたターゲットを選択
攻撃アニメーションの表示
action.apply(target) でダメージを計算・適用
結果をログウィンドウに表示
endAction() で行動終了処理

この仕組みを理解することで、カスタム攻撃やダメージ計算を実装するプラグインの開発が可能になります。例えば、特殊なダメージ計算式や、新しい攻撃タイプなどを追加できます。

攻撃時のアニメーション周りの処理について

RPGツクールMVでの攻撃アニメーションの流れについて、もう少し分かりやすく解説します。

攻撃アニメーションの基本的な流れ

RPGツクールMVでは、攻撃コマンドを選択してから実際にアニメーションが表示され、ダメージが計算されるまでに、複数のクラスとメソッドが連携して処理を行います。

1. 行動開始（BattleManager.startAction）

BattleManager.startAction = function() {
    var subject = this._subject;       // 行動するキャラクター
    var action = subject.currentAction(); // 実行する行動
    var targets = action.makeTargets(); // 対象の選定
    // 行動フェーズに移行
    this._phase = 'action';
    this._action = action;
    this._targets = targets;
    // アイテム/スキルの使用
    subject.useItem(action.item());
    this._action.applyGlobal();
    this.refreshStatus();
    // バトルログに行動開始を表示
    this._logWindow.startAction(subject, action, targets);
};

解説: この部分で「〇〇の攻撃！」というメッセージが表示され、行動の準備が整います。行動者（subject）と対象（targets）が決定されます。

2. 行動の更新と対象への適用（BattleManager.updateAction）

BattleManager.updateAction = function() {
    // 対象を順番に処理
    var target = this._targets.shift();
    if (target) {
        // 対象に行動を適用（ダメージ計算など）
        this._action.apply(target);
        this.refreshStatus();
        // 結果の表示（アニメーションもここで）
        this._logWindow.displayActionResults(this._subject, target);
    } else {
        // すべての対象の処理が終わったら行動終了
        this.endAction();
    }
};

解説: 対象に対して1人ずつ処理を行います。applyメソッドでダメージ計算をし、displayActionResultsでアニメーションとダメージ表示の指示を出します。

3. アニメーション表示の指示（Window_BattleLog.prototype.displayActionResults）

Window_BattleLog.prototype.displayActionResults = function(subject, target) {
    if (target.result().used) {

        this.push('pushBaseLine');

        // クリティカルヒットの表示
        this.displayCritical(target);
        this.push('popupDamage', target);
        this.push('popupDamage', subject);

        // アニメーションとダメージ表示
        this.displayDamage(target);
        this.displayAffectedStatus(target);
        this.displayFailure(target);
        this.push('waitForNewLine');
        this.push('popBaseLine');
    }
};

少し驚きなのが、Window_BattleLogの責務。クラス名からして戦闘ログのメッセージウィンドウで表示するだけかと思いきや、戦闘中のアニメーション等の表示、管理も担当しています。

pushメソッドで実行すべきコマンドをキューに追加して、順番に実行します。

Window_BattleLogには_methodsというプロパティがあり、こいつが戦闘ログ(アニメーション含む)の管理をしている。例えば、相手に攻撃を与えた時には、performDamageがリストに追加されて、実際にperformDamageメソッドが呼び出される。

このperformDamageがどのようになっているかというと、以下の通り。つまり、Game_Battler側で処理が行われるということになる。

Window_BattleLog.prototype.performDamage = function(target) {
    target.performDamage();
};

実際にはGame_ActorかGame_Enemyかによって処理は違っている。

Game_Actor.prototype.performDamage = function() {
    Game_Battler.prototype.performDamage.call(this);
    if (this.isSpriteVisible()) {
        this.requestMotion('damage');
    } else {
        $gameScreen.startShake(5, 5, 10);
    }
    SoundManager.playActorDamage();
};


Game_Enemy.prototype.performDamage = function() {
    Game_Battler.prototype.performDamage.call(this);
    SoundManager.playEnemyDamage();
    this.requestEffect('blink');
};

4. アニメーション表示処理（Window_BattleLog.prototype.displayDamage）

Window_BattleLog.prototype.displayDamage = function(target) {
    if (target.result().missed) {
        // ミス時の表示
        this.displayMiss(target);
    } else if (target.result().evaded) {
        // 回避時の表示
        this.displayEvasion(target);
    } else {
        // ヒット時の処理
        // 攻撃アニメーション表示の指示はここで行われる
        this.displayHpDamage(target);
        this.displayMpDamage(target);
        this.displayTpDamage(target);
    }
};

解説: この部分で、ミス・回避・ヒットの判定に応じた表示処理が分岐します。ヒット時にはdisplayHpDamageなどでアニメーション表示を指示します。

5. 実際のアニメーション作成（Sprite_Battler.prototype.startAnimation）

Sprite_Battler.prototype.startAnimation = function(animation, mirror, delay) {
    // アニメーションスプライトの作成
    var sprite = new Sprite_Animation();
    // アニメーションの設定
    sprite.setup(this._effectTarget, animation, mirror, delay);
    // 画面に追加
    this.parent.addChild(sprite);
    // 管理用配列に追加
    this._animationSprites.push(sprite);
};

解説: バトラーのスプライトに対してアニメーションスプライトを作成し、画面に表示します。Sprite_Animationクラスが実際のアニメーションを描画します。

6. アニメーション終了待機（BattleManager.isBusy）

BattleManager.isBusy = function() {
    return ($gameMessage.isBusy() || 
            this._spriteset.isAnimationPlaying() ||
            this._logWindow.isBusy());
};

解説: 戦闘システムは、アニメーションの再生が終わるまで次の処理に進まないように待機します。isAnimationPlayingでアニメーションが再生中かどうかを確認します。

簡単なカスタマイズ例（実践的な例）

// クリティカルヒット時にアニメーションを2回再生する
var _Window_BattleLog_displayHpDamage = Window_BattleLog.prototype.displayHpDamage;
Window_BattleLog.prototype.displayHpDamage = function(target) {
    _Window_BattleLog_displayHpDamage.call(this, target);

    // クリティカルヒット時、同じアニメーションをもう一度表示
    if (target.result().critical) {
        var animationId = 1; // 攻撃アニメーションのID
        if (target.result().hpDamage > 0) {
            // 少し遅らせて2回目のアニメーションを表示
            this.push('showAnimation', this._subject, [target], animationId, false, 15);
            this.push('waitForAnimation');
        }
    }
};

分かりやすい解説: 1. 上記のコードは元のHP用ダメージ表示メソッドを拡張しています 2. クリティカルヒットした場合、攻撃アニメーションを2回表示するようにしています 3. 2回目のアニメーションは少し遅らせて表示することで、連続ヒットのような演出になります 4. プレイヤーにクリティカルの「重み」を視覚的に伝えることができます

このように、RPGツクールMVのアニメーション処理は複数のクラスが連携していますが、それぞれの役割を理解すれば独自の演出を追加することが可能です。メッセージ表示→アニメーション表示→ダメージ計算という流れをカスタマイズして、オリジナルの戦闘システムを作り上げることができます。