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

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

MZ plugins

Battle Effect Popup - BattleEffectPopup.js

Plugin desc : Combat Action Result Popup Plug-in

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

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

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

File name : BattleEffectPopup.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/BattleEffectPopup.js
@plugindesc Combat Action Result Popup Plug-in
@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
-----

Pops up a message of the result of an action during the battle.
The popup can be a dynamically created string or a prepared picture.
The display conditions are as follows
The font of the popup will be the numeric font specified in the database.

Failure (normal misses will not be displayed)
Evade (normal misses will no longer be displayed)
Invalid (the action succeeded but had no effective effect)
Guard (the action succeeded but was completely blocked by the opponent’s
resistance)
Critical
Counterattack
Magic Reflection
Weakness (damage ratio is greater than 1.1)
Resistance (damage multiplier below 0.9)
State grant (can be set for each state)
Common events (executed via plug-in commands)

The guard is displayed when there is an effect with 0% state or attribute
validity and no other valid effects exist.
The guard is displayed when there is an effect with 0% state or attribute
validity and no other valid effects are available.
If the guard is prevented by ”State Disable”, it will not be displayed.

The base plugin ”PluginCommonBase.js” is required to use this plugin.
PluginCommonBase.js” is stored in the following folder under the RPG Tool MZ
installation folder.
It is stored in the following folder under the RPG Tool MZ installation
folder.
dlc/BasicResources/plugins/official

Terms of Use:
You may modify and redistribute the software without permission of the author.
You can modify and redistribute the plugin without permission of the author.
This plugin is now yours.

@param Critical
@text critical pop-up
@desc Pop-up information when a critical event occurs.
@type struct<Popup>
@default {”text”:”Critical”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Avoid
@text avoidance pop-up
@desc Pop-up information when evasion occurs.
@type struct<Popup>
@default {”text”:”Avoid”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Miss
@text mis-popup
@desc Pop-up information when mistakes occur.
@type struct<Popup>
@default {”text”:”Miss”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Buff
@text buffer pop-up
@desc Pop-up information when buffs occur.
@type struct<Popup>
@default {”text”:”%1 UP!”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Debuff
@text debuff pop-up
@desc Pop-up information when debuffs occur.
@type struct<Popup>
@default {”text”:”%1 DOWN!”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param ParamName
@text Parameter name
@desc Parameter name for buff pop-up.
@type string[]
@default [”MaxHP”,”MaxMP”,”ATK”,”DEF”,”MAG”,”MDF”,”AGI”,”LUK”]

@param Invalid
@text invalid pop-up
@desc Pop-up information when the action was invalid (the action was successful but had no effective effect).
@type struct<Popup>
@default {”text”:”Invalid”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Guard
@text guard pop-up
@desc Pop-up information when the action is guarded (the action succeeded but was completely prevented by the opponent’s resistance).
@type struct<Popup>
@default {”text”:”Guard”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param StateGuard
@text State Disable Popup
@desc Pop-up information in case of complete resistance to state (0% state validity or state deactivation).
@type struct<Popup>
@default {”text”:”State Guard”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Reflection
@text Magic Reflection Popup
@desc Pop-up information during magic reflection.
@type struct<Popup>
@default {”text”:”Reflection”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Counter
@text counterattack popup
@desc Pop-up information during counterattack.
@type struct<Popup>
@default {”text”:”Counter”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Substitute
@text scapegoat pop-up
@desc Pop-up information at the time of substitution.
@type struct<Popup>
@default {”text”:”Substitute”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param SubstituteTarget
@text Pop-up to substitute target
@desc When enabled, the target of the substitution pop-up becomes ”the one who was substituted”.
@type boolean
@default false

@param Weakness
@text Weak Point Popup
@desc Pop-up information during times of weakness.
@type struct<Popup>
@default {”text”:”Weakness”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param Resistance
@text Resistance pop-up
@desc Pop-up information during resistance.
@type struct<Popup>
@default {”text”:”Resist”,”fileName”:””,”stateId”:””,”color”:””,”flash”:””,”se”:””}

@param IgnoreElements
@text Weakness Resistance Ignore Attribute List
@desc Numbered attributes in the list are excluded from the Weakness Resistance pop-up.
@type number[]
@default []

@param StateList
@text state pop-up list
@desc List of popup information when a state occurs. Be sure to specify the ”state ID”.
@type struct<Popup>[]
@default []

@param MaxWidth
@text Maximum message width
@desc This is the maximum width of the pop-up message.
@type number
@default 240

@param OffsetX
@text X-coordinate correction
@desc X-coordinate correction value for popups.
@type number
@default 0
@min -999
@max 999

@param OffsetY
@text Y-coordinate correction
@desc Correction value for the Y-coordinate of the pop-up.
@type number
@default 0
@min -999
@max 999

@param MessageWait
@text message weight
@desc The number of wait frames before the next message is displayed when pop-up messages overlap.
@type number
@default 16

@param MessageMarginY
@text Message interval Y
@desc Corrects the Y coordinate at which the next message appears when pop-up messages overlap.
@type number
@default 16

@param weaknessThreshold
@text Weakness threshold
@desc Threshold value of damage multiplier to be considered as a weakness. It is specified as a percentage (%).
@type number
@default 110

@param resistanceThreshold
@text tolerance threshold
@desc The threshold value of the damage multiplier that is considered resistant. It is specified as a percentage (%).
@type number
@default 90

@command USER_POPUP
@text user pop-up
@desc Pop up to the user of the skill.
@arg value
@text Pop-up Information
@desc Information to be displayed in a pop-up window.
@type struct<Popup>

@command TARGET_POPUP
@text Subject Popup
@desc Pop up to the subject of the skill.
@arg value
@text Pop-up Information
@desc Information to be displayed in a pop-up window.
@type struct<Popup>

スポンサードリンク

-MZ plugins

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