Retry Battle - RetryBattle.js

Plugin desc : Battle Retry 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/RetryBattle.js

File name : RetryBattle.js

Help of plugin :

@url https://triacontane.blogspot.com/
@plugindesc Battle Retry 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
-----
After a battle， you can retry from the Game Over screen.
You can set whether or not to allow retry for minor enemies and boss enemies.
Selecting Retry allows you to retry after opening the menu screen only once.
You cannot save from the menu screen， and items and skills that trigger common
events cannot be used.

Enemy status is determined as follows:

- Minor enemies
Select "Random Encounter" or "Same as Random Encounter" in "Battle Processing"

- Boss enemies
Other than the above

As an added bonus， a plugin command is provided that， when executed during
battle， forces the battle to restart from the beginning.

Plugin Command Details
Execute from the "Plugin Command" event command.
(Parameters are separated by a space.)

RB_RETRY_DISABLE
- Temporarily disables retries.
RB_RETRY_ENABLE
- Re-enables retries.
RB_FORCE_RETRY
- Use during battle to force a retry.

Script Details
Execute from the "Variable Operation" event command.
$gameSystem.getRetryCount();
- Gets the retry count and stores it in a variable.

This plugin is released under the MIT License.

@param RetryNormalEnemy
@text Retry possible with weak enemies
@desc You can retry after getting a game over from a weak enemy.
@type boolean
@default true

@param RetryBossEnemy
@text Retry possible with boss enemies
@desc You can retry after a game over from a boss enemy.
@type boolean
@default true

@param CommandRetry
@text Command Retry
@desc This is the command string for "retry" that is displayed on the game over screen.
@default Retry

@param CommandLoad
@text Command Load
@desc This is the command string to "go to the loading screen" that is displayed on the game over screen.
@default Load

@param CommandTitle
@text Command Title
@desc This is the command string to "Go to the title screen" that is displayed on the game over screen.
@default To Title

@param WindowY
@text Window Y coordinate
@desc The Y coordinate of the retry window display.
@type number
@default 464

@param ShowMenu
@text Display the menu screen
@desc After selecting retry， a menu screen will be displayed before the battle begins.
@type boolean
@default true

@param Message
@text message
@desc Displays a message at the top of the window.
@default ￥c[2]You died.￥c[0]

@param MessageY
@desc The Y coordinate of the message display.
@type number
@default 360

@param FontSize
@text Font size
@desc The font size of the message.
@type number
@default 32

@param RetryCostGold
@text Retry cost (money)
@desc This is the money you will need when retrying. If you don't have enough， you won't be able to retry.
@type number
@default 0

@param RetryCostVariable
@text Retry cost (variable)
@desc The variable number required for retrying.
@type variable
@default 0

@param RetryCostValue
@text Retry cost (variable value)
@desc This is the variable value required for retrying. If it is insufficient， retrying will not be possible.
@type number
@default 0
@parent RetryCostVariable

@param RetryCostItem
@text Retry Cost (Item)
@desc These are items required when retrying. If you do not have one， you will not be able to retry.
@type item
@default 0

@param CostItemVariable
@text Cost item possession variable
@desc This variable stores the number of retry cost items you have. It is used when outputting the number in a message.
@type variable
@default 0
@parent RetryCostItem

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.