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 Battle Action Points - FTKR_BattleActionPoints.js

Plugin desc : v1.1.0 Plugin that introduces the parameter "Action Points (AP)" for consumption costs

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_BattleActionPoints.js

File name : FTKR_BattleActionPoints.js

Help of plugin :

@plugindesc v1.1.0 Plugin that introduces the parameter "Action Points (AP)" for consumption costs
@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
-----------------------------------------------------------------------------
This plugin introduces "Action Points (AP)," a cost parameter shared among party members.

For instructions on how to use the plugin, see the online manual page below.
https://github.com/futokoro/RPGMaker/blob/master/FTKR_BattleActionPoints.ja.md

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

2. When combining with the following plugins, be sure to pay attention to the order of plugin management.

FTKR_CustomSimpleActorStatus.js (Changes status display)
FTKR_AlternatingTurnBattle.js
FTKR_ExBattleCommand.js
↑Register above this plugin↑
FTKR_BattleActionPoints.js

-----------------------------------------------------------------------------
About this plugin's license (License)
-----------------------------------------------------------------------------
This plugin is released under the MIT License.

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

Plugin publisher
https://github.com/futokoro/RPGMaker/blob/master/README.md

-----------------------------------------------------------------------------
Change history
-----------------------------------------------------------------------------

v1.1.0 - 2018/12/10: Compatible with FTKR_ExBattleCommand v2.0.0.

v1.0.3 - 2018/12/08: Bug fixes
1. Fixed turn recovery processing in accordance with the v2.0.2 fix for FTKR_AlternatingTurnBattle.

v1.0.2 - 2018/12/04: Bug fixes
1. Fixed an issue where the plugin parameter "Show AP Window" was not properly Reflectioned.

v1.0.1 - 2018/12/03: Bug fixes
1. Fixed a typo in the plugin command.

v1.0.0 - 2018/12/02: First version created

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

@param Init Start AP
@desc Sets the initial number of action points for the party.
@default 4
@type number
@min 0

@param Init Max AP
@desc Sets the maximum number of action points for the party.
@default 4
@type number
@min 0

@param Item AP Cost
@desc Sets the action points for skills and items. If you do not set it in the Note field, this value will be used.
@default 1
@type number
@min 0

@param Turn Refresh AP
@desc Set the action points recovered each turn with a script. Set it to -1 to fully recover.
@default -1

@param Enabled Preserve AP
@desc Set whether to carry over AP for each battle.
@default false
@type boolean
@on Enabled (AP carryover)
@off invalid

@param Enabled Use AP0Skills Regardless Of AP
@desc Even if the party's remaining AP is 0, AP0 skills can be used.
@default false
@type boolean
@on valid
@off invalid

@param --- アクションポイントの表示 ---
@text --- Action Points Display ---

@param Show AP Window
@desc Set whether to display action points on the battle screen.
@default 2
@type select
@option Do not display
@value 0
@option Show only player turns
@value 1
@option Always show
@value 2

@param Display AP
@desc Set the display name of the action point.
@default AP

@param AP Draw Type
@desc Select how to display action points.
@default 0
@type select
@option Numerical value (current value only)
@value 0
@option Numerical values (current and maximum values)
@value 1
@option Icons (current and maximum values)
@value 2
@option Icon (current value only)
@value 3

@param apGauge
@text Gauge Settings

@param Display AP Gauge
@desc Displays the action point gauge.
@default false
@type boolean
@parent apGauge
@on Show
@off Do not display

@param AP Gauge Color1
@desc Sets the action point gauge color 1.
@default 10
@type number
@min 0
@parent apGauge

@param AP Gauge Color2
@desc Sets the action point gauge color 2.
@default 2
@type number
@min 0
@parent apGauge

@param apIcon
@text Icon Settings

@param AP Icon Index
@desc Sets the icon that represents the action point.
@default 162
@type number
@min 0
@parent apIcon

@param AP Empty Icon Index
@desc Sets the icon that represents the empty part of the action point.
@default 160
@type number
@min 0
@parent apIcon

@param Draw Icon Space
@desc Sets the interval at which action point icons are displayed.
@default 0
@type number
@min 0
@parent apIcon

@param apCost
@text Cost display settings

@param AP Cost Color
@desc Sets the display color for action point costs.
@default 0
@type number
@min 0
@max 31
@parent apCost

@param Display AP Width Cmd
@desc Sets the display width of the action point cost in the command field (number of characters, 0 to hide).
@default 3
@type number
@min 0
@parent apCost

@param Display AP Width Item
@desc Set the display width of the action point cost in the skill and item columns. (Number of characters, 0 to hide)
@default 4
@type number
@min 0
@parent apCost

@param AP Window Layout
@desc AP window layout settings If left blank, the default display position will be used.
@type struct<window>

@param --- 戦闘行動の強制 ---
@text --- Battle Mandate ---

@param Enabled Force Action AP Cost
@desc Enables AP consumption for skills executed by forced Battle actions. If you do not have enough AP, you cannot execute the skill.
@default false
@type boolean
@on valid
@off invalid

@param atcode
@text --- Traits and Usage Effects Code ID ---

@param TRAIT_AP_PLUS
@desc Do not change this unless it causes a conflict with another plugin.
@default 163
@type number
@min 0
@parent atcode

@param TRAIT_AP_RATE
@desc Do not change this unless it causes a conflict with another plugin.
@default 164
@type number
@min 0
@parent atcode

@param TRAIT_AP_COST_PLUS
@desc Do not change this unless it causes a conflict with another plugin.
@default 165
@type number
@min 0
@parent atcode

@param TRAIT_AP_COST_RATE
@desc Do not change this unless it causes a conflict with another plugin.
@default 166
@type number
@min 0
@parent atcode

スポンサードリンク

-MV plugins

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