Battle Popups - BattlePopups.js

Plugin desc : ver1.031/Various information will pop up during battle.

License : MIT License

Author : Yana

Website : https://w.atwiki.jp/pokotan/pages/3.html

Desc page : https://github.com/munokura/Yana-MV-plugins

Download Page : https://raw.githubusercontent.com/munokura/Yana-MV-plugins/refs/heads/master/Map_Message/Popups/BattlePopups/BattlePopups.js

File name : BattlePopups.js

Help of plugin :

@plugindesc ver1.031/Various information will pop up during battle.
@author Yana
@url https://github.com/munokura/Yana-MV-plugins
@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/Yana-MV-plugins ).
Original plugin by Yana.
-----
Installation Notes
------------------------------------------------------
This plugin requires CommonPopupCore.js ver1.04 or later.
Place this plugin below CommonPopupCore.
------------------------------------------------------
Plugin Commands
------------------------------------------------------
************************************************
BattlePopup pos ~
************************************************
Calls the battle popup at the specified position.

For map scenes， the position is set as follows:
-1: player， 0: called event， 1 or higher: event with the corresponding ID.

For battle scenes， the position is set as follows:
0-999: actor with the corresponding member index
1000 or higher: enemy with the corresponding member index (-1000 or higher): enemy

You can also specify the popup position directly by specifying x and y.
In this case， x and y refer to the bottom center of the popup (x=0.5， y=1.0).

Specify any of the following parameters， separated by commas.
text is required. This parameter must be specified.

text: Text to display
pattern: Display pattern. Normal fades， GrowUp stretches vertically， and Stretch stretches horizontally.
size: Font size
back: Background image name. Please provide a background image in img/pictures/.
count: Display time

************************************************
BattlePopup SetText type ~
************************************************
Changes the text displayed in the specified type (encounter， victory， etc.).

Specify one of the following for type:
Emerge
Surprise
Preemptive
Victory
Escape
Defeated

The same settings as for BattlePopup Position ~ can be used for ~.
text is required.

------------------------------------------------------
How to Use
------------------------------------------------------
By entering
<UsePopup:xxx>
in the Note field of a skill or item， xxx will be displayed as a popup when the skill or item is used.
In this case， the _icon part of the text entered for xxx will be converted to the icon of the skill or item， and
_name will be converted to the name of the skill or item.
You can also specify parameters after xxx， separated by a comma.
The parameters available are the same as those for plugin commands.
Example: Set the display pattern to Stretch， the background image to MiniWindowR， and display the name with an icon.
<UsePopup:_icon_name，pattern:Stretch，back:MiniWindowR>

By entering either
<PopupTarget>
in the Note field of a skill or item， you can target the popup displayed when that skill or item is used.

************************************************
By entering
<AddPopup:xxx>
in the state Note field， xxx will be displayed as a popup when the state is added.
You can change the name and set parameters in the same way as for the Use popup above.

************************************************
By entering
<RemovePopup:xxx>
in the state Note field， xxx will be displayed as a popup when the state is released.
All other settings are the same as above.

************************************************
By entering
<ContinuationPopup:xxx>
in the state Note field， xxx will be displayed as a popup when the continuation message is displayed.
All other settings are the same as above.

************************************************
Battle popups can use ￥V， ￥G， ￥N， ￥P， ￥C， and ￥I， as well as the special control character ￥SG.
Instead of the ￥SG[xxx] character， the image xxx in the img/pictures/ folder will be displayed.

****************************************************
By entering
<BattlePopupOffset X:n>
in the actor or enemy Note field， the popup displayed for that actor or enemy will be offset by that value.
You can also adjust the Y coordinate by changing X to Y.

****************************************************

------------------------------------------------------
Terms of Use
------------------------------------------------------
This plugin is released under the MIT License.
http://opensource.org/licenses/mit-license.php
------------------------------------------------------
Update History:
ver1.031:180410
Updated plugin parameter specifications to 1.5.0.
ver1.03:
Fixed a bug that prevented the hit count display from functioning properly.
ver1.02:
Fixed a bug that caused an infinite loop when Substitute was activated.
Fixed a bug that caused an error when the item was empty when activating a skill.
Added a popup when an escape attempt fails.
Added a function to display battle results， such as experience points， in popups.
Also added a setting to hide the message window accordingly.
Added processing that can be used in conjunction with the hit avoidance calculation formula.
ver1.01:
Removed console.log.
Fixed a bug that prevented the popup from displaying correctly when a buff or debuff was removed.
Added settings for major weaknesses and blocks.
Fixed a bug that caused an error if the background image was not specified.
ver1.00:
Released

@param 【基本設定】
@text [Basic settings]

@param HideBattleLog
@desc This is a setting to hide the battle log. If set to true， the battle log will disappear.
@default false
@type boolean

@param PopupSize
@desc The size of the popup text.
@default 18
@type number

@param PopupDelay
@desc Delay when popping up consecutively.
@default 8
@type number

@param PopupPattern
@desc Popup display pattern.
@default GrowUp
@type select
@option GrowUp
@option Normal
@option Stretch

@param ShowCount
@desc The duration for which the popup is displayed.
@default 60
@type number

@param SuccessionOffsetY
@desc This is the offset value for the Y coordinate when popups are displayed consecutively.
@default 4

@param ShowAnchorX
@desc Popup anchor position X for the butler.
@default 0.5

@param ShowAnchorY
@desc The popup anchor position Y relative to the butler.
@default 0

@param ShowOffsetX
@desc Pop-up correction X value for the battler.
@default 0

@param ShowOffsetY
@desc Pop-up offset Y value for the butler.
@default 0

@param 【行動の表示設定】
@text [Activity display settings]

@param PopupActionItem
@desc This is the name setting that pops up when using skills or items. _name: Name _icon: Icon You can disable it by leaving it blank.
@default _icon_name

@param AttackUseWeaponName
@desc When an actor attacks with skill number 1， this setting displays the weapon name instead of the skill name. Enabled with true.
@default true
@type boolean

@param PopupDamageActionItem
@desc This is the suffix for the background of the popup that appears when using damage skills， etc. An image with this suffix added to the end of the background image name will be loaded.
@default R

@param PopupRecoverActionItem
@desc This is the suffix for the background of the popup when using recovery skills， etc. An image with this suffix added to the end of the background image name will be loaded.
@default G

@param PopupOtherActionItem
@desc This is the suffix for the popup background when using any of the above two options. An image with this suffix added to the end of the background image name will be loaded.

@param PopupState
@desc This is the text that pops up when the state is activated. _name: State name _icon: Icon You can disable it by leaving it blank.
@default _icon_name

@param PopupRemoveState
@desc This is the text that pops up when the state is released. _name: State name _icon: Icon You can disable it by leaving it blank.
@default ￥￥C[24]_icon_name

@param 【背景の設定】
@text [Background settings]

@param PopupPatternBack
@desc The display pattern for background popups.
@default GrowUp
@type select
@option GrowUp
@option Normal
@option Stretch

@param PopupBackPicture
@desc This is the name of the image that is usually used as the background of the popup. It should be in the img/pictures/ folder.
@type file
@require 1
@dir img/pictures/

@param BigPopupSize
@desc This is the text size of the large pop-up that appears when a battle starts or when a victory occurs.
@default 72
@type number

@param BigPopupCount
@desc This is the display time for the large image pop-up at the start of a battle or when you win.
@default 90
@type number

@param BigPopupPattern
@desc This is the display pattern for the large pop-up that appears when a battle starts or when a victory occurs.
@default Stretch
@type select
@option GrowUp
@option Normal
@option Stretch

@param BigPopupBackPicture
@desc This is the name of the image that will be displayed in the background of the large popup when a battle starts or when a victory occurs.
@type file
@require 1
@dir img/pictures/

@param StartBattleDelay
@desc This is the time it takes for a popup to appear at the start of a battle.
@default 30
@type number

@param 【リザルトの設定】
@text [Results settings]

@param ResultCount
@desc This setting determines how many times the popup displayed in the results will be displayed.
@default 1

@param RewardCount
@desc The time it takes for the popup displayed during the results display to change.
@default 65
@type number

@param LevelUpPopup
@desc This is the text of the popup that appears when you level up.
@default Level up!

@param ExpPopup
@desc This is the text for the experience points popup that appears when the result is displayed. _exp will be replaced with the experience points gained.
@default +_exp￥c[24]EXP

@param ClassLevelUpPopup
@desc [Only available when introducing status classes] This is the text of the pop-up that appears when a class levels up.
@default Class level up!

@param ClassLevelMaxPopup
@desc [Only available when introducing status classes] This is the text of the pop-up that appears when you master a class.
@default ￥C[14]★Class Master!

@param AbpPopup
@desc [Only available when status classes are introduced] This is the text of the ABP popup that appears when the results are displayed.
@default +_abp￥c[16]ABP

@param ShowNewSkillPopup
@desc This setting determines whether acquired skills will pop up when you level up.
@default true
@type boolean

@param HideResultMessage
@desc This setting hides the result message.
@default false
@type boolean

@param SkipResultInput
@desc This setting allows you to skip the result popup by pressing a key when HideResultMessage is selected.
@default true
@type boolean

@param RewardDelay
@desc This is the time it takes for the result popup to appear after the battle ends.
@default 60
@type number

@param 【会敵時等の設定】
@text [Settings for enemy encounters， etc.]

@param EmergePopup
@desc This is the text that pops up when a battle starts and there is no surprise attack or preemptive strike.
@default ENGAGE!

@param SurprisePopup
@desc This is the text of the popup that will be displayed when a surprise attack occurs at the start of a battle.
@default SURPRISE!

@param PreemptivePopup
@desc This is the text of the popup that appears when a preemptive attack occurs at the start of battle.
@default PREEMPTIVE!

@param EscapePopup
@desc This is the text that appears in the popup when fleeing Battle.
@default ESCAPE!

@param VictoryPopup
@desc This is the text that will appear in the popup when you win a battle.
@default VICTORY!

@param DefeatedPopup
@desc This is the text that will be displayed in a popup when you lose a battle.
@default DEFEATED!

@param EscapeFailurePopup
@desc Text to display in a popup when you fail to flee Battle.
@default ESCAPE FAILED!

@param 【回避などの設定】
@text [Avoidance settings]

@param CriticalPopupA
@desc The text that pops up when an actor is critical.
@default Critical

@param CriticalPopupE
@desc This is the text that pops up when an enemy lands a critical hit.
@default Critical

@param EffectivePopup
@desc This text is displayed when the elemental damage received is between 101% and 199%.
@default Weakness

@param NotEffectivePopup
@desc This is the text that is displayed when the elemental damage received is between 1% and 99%.
@default Resist

@param VeryEffectivePopup
@desc This text is displayed when the elemental damage received is 200% or more.
@default major weakness

@param NotValidPopup
@desc This is the text that is displayed when the damage of the Elements received is 0%.
@default Block

@param EvasionPopupP
@desc This is the text that pops up when you avoid a physical attack.
@default Avoid

@param EvasionPopupM
@desc This is the text that pops up when you avoid a magic attack.
@default Magic Evasion

@param CounterPopup
@desc This is the text that pops up when a counterattack is activated.
@default Counterattack

@param ReflectionPopup
@desc This is the text that pops up when the Reflection is activated.
@default Reflection

@param SubstitutePopup
@desc This is the text that pops up when Substitute is activated.
@default Substitute

@param 【強化の設定】
@text [Strengthening Settings]

@param BuffPopupHp
@desc This is the text that pops up when the HP Up enhancement is granted. Replace _param with the parameter name.
@default ￥I[32]_param UP

@param BuffPopupMp
@desc This is the text that pops up when MP Up is granted. Replace _param with the parameter name.
@default ￥I[33]_param UP

@param BuffPopupAtk
@desc This is the text that pops up when the attack power up enhancement is granted. Replace _param with the parameter name.
@default ￥I[34]_param UP

@param BuffPopupDef
@desc This is the text that pops up when the Defense Up buff is applied. Replace _param with the parameter name.
@default ￥I[35]_param UP

@param BuffPopupMat
@desc This is the text that pops up when the Magic Up enhancement is granted. Replace _param with the parameter name.
@default ￥I[36]_param UP

@param BuffPopupMdf
@desc This is the text that pops up when the Magic Defense Up enhancement is granted. Replace _param with the parameter name.
@default ￥I[37]_param UP

@param BuffPopupAgi
@desc This is the text that pops up when the Agility Up buff is granted. Replace _param with the parameter name.
@default ￥I[38]_param UP

@param BuffPopupLuk
@desc This is the text that pops up when a Luck Up buff is applied. Replace _param with the parameter name.
@default ￥I[39]_param UP

@param 【弱体の設定】
@text [Weakened Settings]

@param DebuffPopupHp
@desc This is the text that pops up when a HP down debuff is applied. Replace _param with the parameter name.
@default ￥I[48]_param DOWN

@param DebuffPopupMp
@desc This is the text that pops up when an MP Down debuff is applied. Replace _param with the parameter name.
@default ￥I[49]_param DOWN

@param DebuffPopupAtk
@desc This is the text that pops up when an attack power down debuff is applied. Replace _param with the parameter name.
@default ￥I[50]_param DOWN

@param DebuffPopupDef
@desc This is the text that pops up when a defense down debuff is applied. Replace _param with the parameter name.
@default ￥I[51]_param DOWN

@param DebuffPopupMat
@desc This is the text that pops up when a Magic Down debuff is applied. Replace _param with the parameter name.
@default ￥I[52]_param DOWN

@param DebuffPopupMdf
@desc This is the text that pops up when a magic defense down debuff is applied. Replace _param with the parameter name.
@default ￥I[53]_param DOWN

@param DebuffPopupAgi
@desc This is the text that pops up when the Agility Down debuff is applied. Replace _param with the parameter name.
@default ￥I[54]_param DOWN

@param DebuffPopupLuk
@desc This is the text that pops up when a Luck Down debuff is applied. Replace _param with the parameter name.
@default ￥I[55]_param DOWN

@param 【強化解除時の設定】
@text [Settings when strengthening is canceled]

@param BuffRemovePopupHp
@desc This is the text that pops up when the HP enhancement is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupMp
@desc This is the text that pops up when the MP enhancement is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupAtk
@desc This is the text that pops up when the attack power buff is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupDef
@desc The text that pops up when the defensive buff is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupMat
@desc This is the text that pops up when the magic power enhancement is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupMdf
@desc This is the text that pops up when the magic defense buff is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupAgi
@desc Text that pops up when the agility buff is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param BuffRemovePopupLuk
@desc Text that pops up when the luck boost is removed. Replace _param with the parameter name.
@default _param Removal of reinforcement

@param 【弱体解除時の設定】
@text [Settings when debuffing is removed]

@param DebuffRemovePopupHp
@desc This is the text that pops up when the HP debuff is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupMp
@desc This is the text that pops up when the MP debuff is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupAtk
@desc This is the text that pops up when the attack weakening is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupDef
@desc The text that pops up when the defense weakening is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupMat
@desc The text that pops up when the magic weakening is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupMdf
@desc This is the text that pops up when the magic defense weakening is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupAgi
@desc Text that pops up when the agility debuff is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param DebuffRemovePopupLuk
@desc Text that pops up when the Luck debuff is removed. Replace _param with the parameter name.
@default _param Debuff removal

@param 【その他の設定】
@text [Other settings]

@param HitText
@desc When the hit avoidance formula is implemented， this is the text that is displayed when there are two or more hits. Replace _cnt with the number of hits.
@default _cnt hits!

@param ChainText
@desc This is the text that will be displayed when a combo skill is activated.
@default Skill collaboration!

@param MagicBurstText
@desc This is the additional text that is displayed in Magic Burst when a linked skill is activated.
@default Magic Burst!

@param StartPhaseText
@desc When a phase skill is introduced， this is the text that will be displayed on the skill during the start of battle phase.
@default Fast skills!

@param TurnStartPhaseText
@desc When a phase skill is introduced， this is the text that will be displayed on the skill at the start of the turn.
@default Preemptive action!

@param TurnEndPhaseText
@desc When a phase skill is introduced， this is the text that will be displayed on the skill at the end of the turn.
@default Delayed activation!

@param LearningText
@desc This is the text that will be displayed when learning is introduced and during learning.
@default Learning!

@param FlashText
@desc This is the text that is displayed when a conditional skill change is introduced or when an idea strikes.
@default I had an idea!

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.