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

PGMV - The Community-Driven Plugin Library for RPG Maker MV

MV plugins

FTKR Ex Item Config Activate - FTKR_ExItemConfig_Activate.js

Plugin desc : v1.0.2 A plugin that expands item and skill activation settings

License : MIT License

Author : Futokoro

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

Download Page : https://raw.githubusercontent.com/munokura/futokoro-MV-plugins/refs/heads/master/FTKR_ExItemConfig_Activate.js

File name : FTKR_ExItemConfig_Activate.js

Help of plugin :

@plugindesc v1.0.2 A plugin that expands item and skill activation settings
@author Futokoro
@url https://github.com/munokura/futokoro-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/futokoro-MV-plugins ).
Original plugin by Futokoro.
Please check the URL below for the latest version of the plugin.
URL https://github.com/futokoro/RPGMaker
-----
-----------------------------------------------------------------------------
Overview
-----------------------------------------------------------------------------
By implementing this plugin, you can configure the activation settings of items and skills in more detail.

1. You can set the number of consecutive hits using a JavaScript formula.

2. You can set the success rate using a JavaScript formula.

3. You can change the calculation process for success checks, hit checks, and evasion checks.

4. You can set the hit rate for each item/skill using a JavaScript formula.

-----------------------------------------------------------------------------
Setup Instructions
-----------------------------------------------------------------------------
1. Add this plugin to the "Plugin Manager."

2. This plugin cannot be used in conjunction with FTKR_SkillExpansion.js.

-----------------------------------------------------------------------------
Setting the Number of Consecutive Hits
-----------------------------------------------------------------------------
You can set the number of consecutive hits by adding the following note tag to an item or skill.

<EIC ACTIVATE>
code
</EIC ACTIVATE>

[Items that can be used in code]
Count: eval
Continuous Count: Formula
: Changes the continuous count to the value of the formula (eval).

Success Rate: eval
Success Rate: Formula
: Changes the success rate to the value of the formula (eval).

Hit Rate: eval
Accuracy Rate: Formula
: Regardless of the plugin parameter settings
: Changes the accuracy rate to the value of the formula (eval).

Eva Rate: eval
Evasion Rate: Formula
: Regardless of the plugin parameter settings
: Changes the Evasion rate to the value of the formula (eval).

[About the Formula (eval) Value]
Like the damage formula, you can use non-fixed values for the formula (eval) by entering a formula. The following codes can be used:
a.param - References the user's parameters. (a.atk is the user's attack power)
b.param - References the target's parameters.
s[x] - References the state of switch ID x.
v[x] - References the value of variable ID x.
iv[x] - References the value of item self variable ID x. (*1)
BattleManager._repeatCount - References the number of consecutive hits, with the first hit being 0. (*2)

(*1) FTKR_ItemSelfVariables.js is required to use self variables.
(*2) If this plugin is enabled, this code can be used in the calculation formula of another plugin.

Input example)
Use the skill five times in a row, with the success rate decreasing by 10% each time.
The first hit is 100%, the second is 90%, the third is 80%, etc.
Adds a +10% correction to the user's hit rate.
<EIC ACTIVATE>
Number of Repeats: 5
Success Rate: 1 - BattleManager._repeatCount * 0.1
Accuracy Rate: a.hit + 0.1
</EIC ACTIVATE>

-----------------------------------------------------------------------------
Regarding Activation Failures During Repeat Attacks
-----------------------------------------------------------------------------
You can change this setting using the following plugin parameters.

<Enabled Repeat Failure>
: If an item/skill fails, misses, or is Evasiond during a repeat attack,
: Sets whether to stop the attack at that point.
: 0 - Continue attacking, 1 - Stop attacking

---------------------------------------------------------------------------
Regarding Activation Failure Handling
--------------------------------------------------------------------------------------------
In MV's standard specifications, if an item/skill fails to activate (fails based on success rate),
it is treated as a missed hit.
Therefore, the battle log displays a message for missed hits.

This plugin allows you to determine success rate separately from hit rate, and to display separate failure messages.
This is configured using the following plugin parameters.

<Enabled Action Failure>
: Sets whether to use a special message when an action fails.
: 0 - Disable, 1 - Enable
: If enabled, the action will first be determined based on success rate alone.

<Action Failure Message>
: Sets a special message when an action fails.
: %1 is replaced with the user's name, and %2 is replaced with the item/skill name.

-----------------------------------------------------------------------------
About Hit and Evasion Processing
-----------------------------------------------------------------------------
In MV's standard specifications, item/skill hit and Evasion processing follows this flow:

1. Determine whether to hit by checking the user's hit rate and the item/skill's success rate.

2. If the hit check is successful, determine whether the target will Evasion by checking the target's Evasion rate.

For this reason, a hit rate of 100% or higher is meaningless, and if the target has an Evasion rate, they may Evasion even if their hit rate is 100%.

In contrast, this plugin allows you to change the hit and Evasion processing.
For example, you can change the process to subtract the target's evasion rate from the user's hit rate, or use parameters other than hit rate and evasion rate.

This is configured using the following plugin parameters.

<Enabled Custom Hit>
: Sets whether to change the hit calculation formula.
: Setting this to 1 enables the formula described below.
: Note that if a hit rate is set in the item/skill Note field,
: that value will be used regardless of the setting of this parameter.

<Physical Hit Formula>
<Magical Hit Formula>
: Sets the hit calculation formula.
: Sets the hit rate for physical-type attacks with Physical~, and the hit rate for magical-type attacks with Magical~.
: Sets the hit rate for magical-type attacks with 1.

<Enabled Custom Eva>
: Sets whether to change the evasion calculation formula.
: Sets the formula described below with 1.

<Physical Eva Formula>
<Magical Eva Formula>
: Sets the evasion formula.
: Sets the evasion rate for physical types with Physical~, and the evasion rate for magical types with Magic~.
: Sets evasion to 0 to disable evasion.

[About the Calculation Formula (eval) Value]
Like the damage formula, the Calculation Formula (eval) allows you to use non-fixed values by entering a formula.
The following codes can be used:
a.param - References the user's parameters. (a.atk is the user's attack power)
b.param - References the target's parameters.
s[x] - References the state of switch ID x.
v[x] - References the value of variable ID x.
iv[x] - References the value of item self variable ID x. (*1)
BattleManager._repeatCount - References the number of consecutive hits, with the first hit being 0.

(*1) FTKR_ItemSelfVariables.js is required to use self variables.

[Configuration Example]
1. Hit - Evasion
During the hit process, the hit - Evasion calculation is performed, and the Evasion process is ignored.
In this case, the Evasion message will not be displayed.
Hit Processing
<Enabled Custom Hit> : 1
<Physical Hit Formula> : a.hit - b.eva
<Magical Hit Formula> : 1 - b.mev
Evasion Processing
<Enabled Custom Eva> : 1
<Physical Eva Formula> : 0
<Magical Eva Formula> : 0

2. When the hit rate exceeds 100%, the amount is subtracted from the target's evasion.
Hit Processing (No Change)
<Enabled Custom Hit> : 0
Evasion Processing
<Enabled Custom Eva> : 1
<Physical Eva Formula> : b.eva - Math.max(a.hit - 1, 0)
<Magical Eva Formula> : b.mev

-----------------------------------------------------------------------------
License for this Plugin
-----------------------------------------------------------------------------
This plugin is released under the MIT License.

Copyright (c) 2017 Futokoro
http://opensource.org/licenses/mit-license.php

----------------------------------------------------------------------------
Change History
----------------------------------------------------------------------------

v1.0.3 - 2017/06/23: Bug fixes
1. Fixed an error that occurred when obtaining evasion rate.

v1.0.2 - 2017/05/11: Bug fixes

v1.0.1 - 2017/04/29: Supports FTKR_ItemSelfVariables v1.1.0 and later

v1.0.0 - 2017/04/14: First version released

-----------------------------------------------------------------------------

@param Enabled Repeat Failure
@desc When attacking consecutively, if you fail midway, will the attack stop? 0 - Do not stop attacking, 1 - Stop attacking
@default 0

@param Console Display Result
@desc Whether to display the result of the trigger on the console screen. 0 - Do not display, 1 - Display
@default 0

@param -- 発動失敗処理 --
@text -- Activation failure processing --

@param Enabled Action Failure
@desc Use a special message when the activation fails. 0 - Do not use, 1 - Use
@default 0

@param Action Failure Message
@desc Special message when activation fails: %1 - The User's name, %2 - Item/skill name
@default %1は%2の発動に失敗した!

@param -- 命中処理 --
@text -- Hit Processing --

@param Enabled Custom Hit
@desc Change the hit calculation formula: 0 - Do not change, 1 - Change
@default 0

@param Physical Hit Formula
@desc Changed physical hit calculation formula: a - user, b - target
@default a.hit

@param Magical Hit Formula
@desc The modified magic hit formula is: a - user, b - target
@default 1

@param -- 回避処理 --
@text -- Avoidance process --

@param Enabled Custom Eva
@desc Change the avoidance formula: 0 - Do not change, 1 - Change
@default 0

@param Physical Eva Formula
@desc Changed physical evasion formula: a - user, b - target
@default b.eva

@param Magical Eva Formula
@desc The modified magic evasion formula is: a - user, b - target
@default b.mev

スポンサードリンク

-MV plugins

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