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

PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

MZ plugins

Substitute Extend - SubstituteExtend.js

Plugin desc : Substitute Extension Plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/SubstituteExtend.js

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

File name : SubstituteExtend.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/SubstituteExtend.js
@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-MZ-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----

We’re changing the Substitute mechanic.
First, let’s explain the Substitute mechanic in RPG Maker MZ.

- The Substitute
- Alive
- Not subject to the ”Cannot Act” action restriction
- Possess the ”Substitute” trait

- Substituted
- Critically Dying (HP is 1/4 or less)
- Not the same Battler as the Substitute
- Skills activated by Substitute
- Hit type is 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”)

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 memo field of the database with the characteristic.
Substitute will be activated when ”all conditions” in the memo field are met.
Generally, this is entered together with the ”Substitute” feature.

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

<SE_ExecutorHP%:50> # Activates only when the executer’s HP is 50% or above.
<SE_SubjectHPRate:50> # Same as above
<SE_TargetHPRate:50> # Activates only when the target’s HP is below 50%. (※1)
<SE_TargetHPRate:50> # Same as above
<SE_SubstituteTargetRestriction:1> # Limits the target of substitution to [1].
(※2)
<SE_TargetRestriction:1> # Same as above
<SE_SubstituteSwitch:4> # Activates only when switch [4] is ON.
<SE_SubstituteSwitch:4> # Same as above
<SE_SubstituteFormula:f> # Activates only when formula [f] is true. (※3)
<SE_SubstituteFormula:f> # Same as above
<SE_SubstituteRate:50> # Activates Substitute with a 50% chance.
<SE_SubstituteRate:50> # Same as above
<SE_SubstituteState:5> # State [5] is automatically granted only during
Substitute.
<SE_SubstituteState:5> # Same as above

*1 This is only determined if the default Substitute condition, ”Dying,” is
disabled in the parameters.

*2 To specify the target of the <SE_SubstituteTargetLimit:n> tag, enter the
following in the memo field of the database with the feature.

<SE_SubstituteTarget:1> # The target will be <SE_SubstituteTargetLimit:1>.
<SE_SubstituteTarget:1> # Same as above

Any actor matching the parameters specified in ”SubstituteTargetLimit” will be
considered a Substitute target.
For example, if you enter <SE_SubstituteTargetLimit:2> in the memo field,
Substitute will only be performed on actors with the feature that also have
<SE_SubstituteTarget:2> in the memo field.

*3 This is an advanced feature.

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 activated by
Substitute.

Below is an example.
<SE_Substitute Calculation Formula:action.isAttack()> # Activates Substitute
for normal attacks only
<SE_Substitute Calculation Formula:action.isPhysical()> # Activates Substitute
for physical attacks only
<SE_Substitute Calculation Formula:action.isForOne()> # Activates Substitute
for single targets only
<SE_Substitute Calculation Formula:action.hasElement(2)> # Activates
Substitute for skills with attribute [2] only

3. When Substitute is activated, you can apply the effect of a skill with a
specified ID to the substitute performer.
<SE_SubstituteSkillID:5> # Apply skill [5] to the performer when Substitute is
activated. (※1)
<SE_SubstituteSkillId:5> # Same as above

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

4. You can individually specify skills for which you want to disable
Substitute.
Specify the following in the skill or item’s memo field:
<SE_SubstituteInvalid>
<SE_SubstituteInvalid>

This plugin does not have any plugin commands.

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

@param condDying
@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 condNonCertainHit
@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 substituteCounter
@text Substitute Counterattack
@desc The Substitute effect has been changed, allowing counterattacks and magic reflection after the Substitute effect.
@type boolean
@default false

@param invalidConfused
@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 validRestriction
@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

スポンサードリンク

-MZ plugins

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