An open library of RPG Maker MV plugins, powered by the community.

PGMV - The Community-Driven Plugin Library for RPG Maker MV

MV plugins

Substitute Extend - SubstituteExtend.js

Plugin desc : Substitute Extension Plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com/

Desc page : https://triacontane.blogspot.com/

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MV-plugins/refs/heads/main/SubstituteExtend.js

File name : SubstituteExtend.js

Help of plugin :

@url https://triacontane.blogspot.com/
@plugindesc Substitute Extension Plugin
@author Triacontane
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MV-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----
We'll be changing the Substitute mechanics.
First, let's explain the Substitute mechanics in RPG Maker MV.
- The Substitute
- Alive
- Not subject to the "Cannot Act" action restriction
- Possess the "Substitute" trait
- Substituted
- Critically injured (HP is 1/4 or less)
- Not the same Battler as the Substitute
- Skills activated by Substitute
- Hit type not "Guaranteed Hit"
- Substitute priority
The "Substitute Battler" is determined in order, starting from the front of
the party.
- A commonly misunderstood feature
- Substitute is possible even if subject to the "Attack XX" action restriction
- The skill's "Range" and the skill's user have no effect on the Substitute
determination.
(Substitute will also activate for healing and defense if the Hit type is not
Guaranteed Hit.)
The determination is made only once, so Substitute will not be activated in
the following cases:
- The first and second Battlers can Substitute
- The first Battler is the Substitute target

1. The following default Substitute conditions can be disabled.
・Critical (HP is 1/4 or less)
・Accuracy type is not "Guaranteed Hit"
・Not subject to the "Cannot Act" action restriction

Note that if the "Accuracy type is not "Guaranteed Hit" condition is removed,
Substitute will be activated indiscriminately, even for unrelated skills such
as defense.
Please set this carefully.

2. You can set the detailed activation conditions for Substitute in detail.
Enter the following in the Note field of the database with the characteristic.
Substitute will be activated when "all conditions" in the Note field are met.
Generally, this is entered together with the "Substitute" feature.

Note that the Note field of the database with the characteristic is
the Note field for any of the following: actor, job, weapon, armor, state, or
enemy character.

<SE_SubjectHPRate%:50>
- Activates only when the executer's HP is 50% or above.
<SE_TargetHPRate:50>
- Activates only when the target's HP is below 50%. (*1)
<SE_TargetRestriction:1>
- Restricts the substitute target to [1].(*2)
<SE_SubstituteSwitch:4>
- Activates only when switch [4] is ON.
<SE_SubstituteFormula:f>
- Activates only when formula [f] is true. (*3)

*1 This only determines if the default substitute condition, "near death," is
disabled in the parameters.

*2 To set the target of the <SE_SubstituteTarget:n> tag, write the following
in the Note field of the database with the feature.

<SE_SubstituteTarget:1> # Targeted by <SE_TargetRestriction:1>.

Any actor matching the parameters specified in "SubstituteTarget" will be
considered a Substitute.
For example, if you enter <SE_SubstituteTarget:2> in the Note field,
Substitute will only be performed on actors with the feature
<SE_SubstituteTarget:2> in the Note field.

*3 This is an advanced feature.
Also, if you want to use inequality signs in a calculation formula, write it
as follows:
< → &lt;
> → &gt;

Example:
<SE_SubstituteFormula:¥v[2] &gt; 3>
- Triggered if variable [2] is greater than [3].

Within the formula, you can reference the Action object of the target skill
using "action."
By using this effectively, you can precisely limit the skills that Substitute
activates.

Below is an example.
<SE_SubstituteFormula:action.isAttack()>
- Activates Substitute only for normal attacks
<SE_SubstituteFormula:action.isPhysical()>
- Activates Substitute only for physical attacks
<SE_SubstituteFormula:action.isForOne()>
- Activates Substitute only for single targets

3. When Substitute is activated, the effect of the skill with the specified ID
can be applied to the Substitute performer.
<SE_SubstituteSkillID:5>
- When Substitute is activated, skill [5] is applied to the performer. (*1)

*1 Damage popups, animations, and other effects will not be displayed.

4. You can individually specify skills that will disable Substitute.
Specify the following in the skill or item Note field.
<SE_SubstituteInvalid>

This plugin does not have any plugin commands.

Terms of Use:
You may modify and redistribute this plugin without permission from the
author, and there are no restrictions on its use (commercial, 18+, etc.).
This plugin is now yours.

@param 身代わり条件_瀕死
@text Substitute Condition: Near Death
@desc Enables the default condition for substitution, "dying." Turning it OFF disables it. (ON/OFF)
@type boolean
@default true

@param 身代わり条件_必中以外
@text Substitute Conditions - Other than Guaranteed Hit
@desc Enables the default substitute condition "Other than guaranteed hit". Turning it OFF disables it. (ON/OFF)
@type boolean
@default true

@param 身代わり反撃
@text Substitute Counterattack
@desc The Substitute effect has been changed, allowing counterattacks and magic reflection after the Substitute effect.
@type boolean
@default false

@param 混乱時の身代わり無効
@text Substitute disabled when confused
@desc If the enemy is in a confused state (a state where the action restriction is "attack XX"), the activation of Substitute will be disabled.
@type boolean
@default false

@param 行動不能時の身代わり有効
@text Substitute available when unable to act
@desc Even if you are unable to act (a state where the action restriction is "cannot act"), the activation of Substitute will be enabled.
@type boolean
@default false

スポンサードリンク

-MV plugins

Copyright© PGMV - The Community-Driven Plugin Library for RPG Maker MV , 2026 All Rights Reserved.