Battle Effect Popup - BattleEffectPopup.js

Plugin desc : Battle Action Results Popup 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/BattleEffectPopup.js

File name : BattleEffectPopup.js

Help of plugin :

@url https://triacontane.blogspot.com/
@plugindesc Battle Action Results Popup 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
-----

Displays a pop-up message indicating the outcome of an action during
battle. The pop-up message can be a dynamically generated string or a
pre-defined picture.
The display conditions are as follows:

- Failure (Normal Miss messages will no longer be displayed)
- Evade (Normal Miss messages will no longer be displayed)
- Invalidated (The action was successful， but no effective effect was
found)
- Guard (The action was successful， but was completely blocked by the
opponent's resistance)
- Critical
- Counterattack
- Magic Reflection
- Weakness (When the damage multiplier exceeds 1.0)
- Resistance (When the damage multiplier falls below 1.0)
- Grant State (Can be set for each state)
- Common Event (Executed via plugin command)

*Guard will only be displayed if there is an effect with a state or
attribute effectiveness of 0%
and no other effective effects.
Note that it will not be displayed if the action was blocked by
"State Invalidation."

You can also specify a flash color for the popup.
Specify the flash colors in the following order: "Red，" "Green，" "Blue，"
and "Strength，" separated by commas.

If you want a message to pop up when a state is assigned
Specify the following in the state's memo field.
<BEPMessage:state>
 # The message "state" will be displayed when the state is assigned.
 # If image usage is enabled， specify the file name.
<BEPFlashColor:255，255，255，255>
 # Specifies the flash color when the state is assigned.

You can also freely pop up any text using plugin commands.
This command is only available for battle events.

Plugin Command Details
Execute from the "Plugin Command" event command.
(Separate parameters with a space.)

BEP_TARGET_POPUP message 255， 0， 0， 255
 # A message will pop up for the target of the action.

BEP_USER_POPUP message 255， 0， 0， 255
 # A message will pop up for the user of the action.

*If image usage is enabled， specify the file name.

Conflict Information
Please place this plugin below the following plugins:

YEP_BattleEngineCore.js

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 MessageWait
@desc The number of frames to wait before displaying the next popup message when popup messages overlap.
@type number
@default 12

@param Critical
@desc Pop-up message or file name when a critical event occurs. (img/pictures/) No extension required
@type file
@default CRITICAL!
@require 1
@dir img/pictures/

@param CriticalColor
@desc The flash color of the text when a critical hit occurs. Specify the color in the order of R (red)， G (green)， B (blue)， A (strength)， separated by a comma (，).
@default 255，0，0，255

@param Avoid
@desc The popup message or file name when the avoidance occurs.
@type file
@default Avoid!
@require 1
@dir img/pictures/

@param AvoidColor
@desc The color of the text flashes when an evasion occurs.
@default 0，128，255，255

@param Buff
@desc This is the popup message or file name when a buff occurs. %1 will be converted to the target parameter name.
@type file
@default %1 UP!
@require 1
@dir img/pictures/

@param BuffColor
@desc The color of the text flashing when a buff occurs.
@default 0，128，255，255

@param Debuff
@desc This is the popup message or file name when a debuff occurs. %1 will be converted to the target parameter name.
@type file
@default %1 Down!
@require 1
@dir img/pictures/

@param DebuffColor
@desc This is the color of the text flashing when a debuff occurs.
@default 255，128，0，255

@param ParamName
@desc Parameter names to use in the buff popup， separated by commas.
@default MaxHP，MaxMP，ATK，DEF，MAG，MDF，AGI，LUK

@param MissColor
@desc The color that the text flashes when a mistake occurs.
@default 0，0，0，0

@param Invalid
@desc The popup message or file name when the action was invalid (the action was successful but had no effective effect).
@type file
@default Invalid!
@require 1
@dir img/pictures/

@param InvalidColor
@desc The color of the flash when an invalid event occurs.
@default 0，0，0，0

@param Guard
@desc This is the popup message or file name when an action is guarded (the action was successful but completely blocked by the opponent's resistance).
@type file
@default Guard!
@require 1
@dir img/pictures/

@param GuardColor
@desc The color of the text flashes when a guard occurs.
@default 0，128，255，255

@param Reflection
@desc The popup message or file name when reflecting magic.
@type file
@default Reflection!
@require 1
@dir img/pictures/

@param ReflectionColor
@desc The color of the text flashes when magic is reflected.
@default 0，128，255，255

@param Counter
@desc The popup message or file name when counterattacking.
@type file
@default Counter!
@require 1
@dir img/pictures/

@param CounterColor
@desc This is the color that the text flashes when a counterattack occurs.
@default 0，128，255，255

@param Substitute
@desc This is the pop-up message or file name when substituting.
@type file
@default Substitute!
@require 1
@dir img/pictures/

@param SubstituteTarget
@desc When enabled， the substitute popup will be targeted at the "substitute" party.
@type boolean
@default false

@param SubstituteColor
@desc This is the color of the text that flashes when a substitute occurs.
@default 0，128，255，255

@param Weakness
@desc The pop-up message or file name when a vulnerability is found.
@type file
@default Weakness!
@require 1
@dir img/pictures/

@param WeaknessColor
@desc This is the color that the text flashes when a weak point occurs.
@default 0，255，128，255

@param WeaknessLine
@desc Anything above this value will be considered a weakness. Specify as a percentage.
@default 200

@param Resistance
@desc The pop-up message or file name when a vulnerability is found.
@type file
@default Resistance!
@require 1
@dir img/pictures/

@param ResistanceColor
@desc This is the color that the text flashes when resistance occurs.
@default 0，0，128，255

@param ResistanceLine
@desc Anything below this value is considered to be resistant. Specify as a percentage.
@default 50

@param ActorDamageColor
@desc Actor damage flash color.
@default 0，0，0，0

@param EnemyDamageColor
@desc This is the flash color of enemy character damage.
@default 0，0，0，0

@param FontSize
@desc The font size of the popup.
@default 42

@param MaxWidth
@desc The maximum width of the popup message.
@default 240

@param FlashDuration
@desc The number of frames before the flash color fades out.
@default 60

@param OffsetX
@desc The X coordinate correction value.
@default 0

@param OffsetY
@desc The Y coordinate correction value.
@default -40

@param UsingItalic
@desc The popup appears in italics.
@type boolean
@default false

@param UsingOutline
@desc The popup will appear outlined.
@type boolean
@default false

@param OutlineColor
@desc Popup border color. You can use CSS text color.
@default gray

@param UsingPicture
@desc Use any picture (img/pictures) for various popups. Enter the file name instead of the message.
@type boolean
@default false

munokura

Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.