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

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

MV plugins

Battle Formation - BattleFormation.js

Plugin desc : ver1.06/Added formation system.

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/Menu/BattleFormation.js

File name : BattleFormation.js

Help of plugin :

@plugindesc ver1.06/Added formation system.
@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.
-----
Plugin Commands
--------------------------------------------------------------------
This plugin has the following plugin commands.

BattleFormation callScene
- Calls a formation scene.

BattleFormation Set Item ID
- Sets the formation to an item ID.

-----------------------------------------------------------------
How to Use
--------------------------------------------------------------------
-- Basics--
A formation is a Traits that positions actors in specific locations and enhances their abilities depending on their location.
If even one player is Collapse, the formation collapses and the formation effect is invalidated.
If any battle member's characteristic object contains either
<InvalidFormation>
, the formation effect is invalidated.
Furthermore, if the battle ends with the formation invalidated for any of the above reasons, formation experience points will not be earned.

-- Creating a Formation--
- Basic Formation Settings
Set in the item's Note field.
The formation will become available when you obtain the specified item.

If the following settings are present, the item will be treated as a formation item.
Write the following in the item's memo:
<陣形設定>
First player's X coordinate, Y coordinate, Class ID to be used [, Placement Condition]
Second player's X coordinate, Y coordinate, Class ID to be used [, Placement Condition]
Third player's X coordinate, Y coordinate, Class ID to be used [, Placement Condition]
...
</陣形設定>

For up to one player, it will be a one-person formation; for up to two players, it will be a two-person formation; for up to three players, it will be a three-person formation, etc.
The class ID setting will add the abilities and Traits of the actor placed at this position to those set for that class.
The placement condition setting is optional. This part is evaluated using eval, and if all players evaluate to true, the formation will be enabled.
If omitted, it will always be treated as true.

The item name will be used as the formation name, and the item description will be used as the formation description.

- Formation Experience Settings
Similarly, you can set a formation's level by entering the following in the item's notes:
<FormationExpSetting: Required Value up to Lv2, Required Value up to Lv3, Required Value up to Lv4...>

The maximum level is the number you set + 1.
Formation experience points accumulate by winning battles.
The formation's level is used for stat adjustments based on the class level (explained below) and for acquired skills.

--Setting the Contents of the Formation--
Adjustments for each position in the formation are made using a class.
The Traits, stats, and acquired skills set for the class are added to the actor in that position.
In this case, the formation level is used as the level value for this class.

The name you set for this class will be displayed in the window confirming the Traits of each position during the formation scene.

You can add text to the window confirming class details by entering any of the following:

<AddFormationEffectText:F:Desired Text>
<AddFormationEffectText:L:Desired Text>

If you specify Before or F, the text will be added before other effects.
If you specify After or L, the text will be added after other effects.
Also, by adding Lv○ after the before or after specification, such as
<AddFormationEffectText:F:Lv2:Desired Text>
, the text will be added at that level or above.

In addition, if the notes for the acquired skills of the class set in the formation include
<HideFormation>
, that skill will not be displayed in the details window.

--About Formation Experience--

Formation Experience is generally gained by winning, with 1 point added.
By writing either
<BattleFormationExp:x>
in the enemy's memo, you can add an additional x points of formation EXP when defeating that enemy.

Also, by writing either
<BattleFormationExpRate:x>
in the Note field of an actor, class, or other object with special Traits, the final formation EXP gained will be multiplied by x.
These are Reflectioned individually for all actors and are multiplied together, so be careful when setting them.
(For example, if five actors each have a 2x setting, the final value will be 32x.)

--About the List Display--
You can customize the EXP display in the formation list using item memos.

By writing either
<LevelSymbol:x>
in the item's memo, the EXP symbol for that formation will be set to x.
If you specify two or more characters for x, it will be displayed as a number, such as x:1.
If you specify a number for x, it will use that as the scale width and be displayed as a gauge, such as ||||||||.

Similarly, by entering
<SymbolColor:x>
in an item's note, the color of the symbol, gauge, or text will be set to x.
Specify x using the color index listed in the bottom right of Window.png.

Furthermore, by entering either
<ExpGaugeColor1:rgba(r,g,b,a)>
the left side of the experience color will be set to an rgba color.

<ExpGaugeColor2:rgba(r,g,b,a)>
the right side of the experience color will be set to an rgba color.
r, g, and b represent red, green, and blue, respectively, and should be values between 0 and 255. a represents transparency, and should be a value between 0 and 1.0.

-----------------------------------------------------
Terms of Use
------------------------------------------------------
This plugin is released under the MIT License.
http://opensource.org/licenses/mit-license.php
------------------------------------------------------
Update History:
ver 1.06:
Added Scene_BattleFormation.prototype.isBottomHelpMode.
by Shiguren
ver 1.05:
Fixed a bug where the inheritance source was set to Window_Base when it should have been Window_Selectable.
by Shiguren
ver 1.04:
Fixed some processing changes to accommodate the addition of the Acquisition Information Traits.
ver 1.03:
Added the ability to set the item names displayed in the details window.
Added settings for experience point layout.
ver 1.02:
Fixed a bug where class parameters set in the formation were not properly Reflectioned.
Added an option to set the coordinates of the window that displays the current formation on the menu screen.
ver1.01:
Fixed a bug that caused the window to extend off-screen when the number of formation types increased.
ver1.00:
Released

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

@param BasicFormationText
@desc The name of the basic formation.
@default 基本陣形

@param BasicFormationHelp
@desc This is the help displayed for the basic formation.
@default もっとも基本となる陣形。特に特別な効果はない。

@param 【メニューの設定】
@text [Menu settings]

@param AddMenuBattleFormation
@desc This setting determines whether to add a formation item to the menu.
@default true

@param MenuBattleFormationTitle
@desc The name of the formation to display in the menu.
@default 陣形

@param BattleFormationInfoX
@desc The X coordinate of the window that displays the formation. Evaluated with eval. cw:commandW sw:statusW gw:goldW h:height w:width
@default 0

@param BattleFormationInfoY
@desc The Y coordinate of the window that displays the formation. Evaluated with eval. cw:commandW sw:statusW gw:goldW h:height w:width
@default Graphics.boxHeight - (gw.height + h)

@param 【シーンの設定】
@text [Scene setting]

@param FormationListWidth
@desc This is the width of the list section during formation scenes.
@default 320

@param LevelSymbol
@desc A symbol that indicates the level. Two or more characters will be used as text, such as x:1, and numbers will be used to display the gauge.
@default ★

@param LevelColor
@desc The color of the symbol that indicates the level. Specify it using the color index at the bottom right of Window.png.
@default 6

@param ExpGaugeColor1
@desc Experience gauge color 1. Specify using rgba (r,g,b,a). r,g,b are numbers between 0 and 255, and a is a number between 0 and 1.0.
@default rgba(128,128,255,1.0)

@param ExpGaugeColor2
@desc Experience gauge color 2. Specify using rgba (r,g,b,a). r,g,b are numbers between 0 and 255, and a is a number between 0 and 1.0.
@default rgba(0,0,255,1.0)

@param ShowParamWindow
@desc This setting determines whether to use a window to display formation details.
@default true

@param ParamColor
@desc These are the color settings for the Traits displayed in the Details window: Base color, System color, Increase color, Decrease color.
@default 6,4,24,2

@param AddSkillText
@desc The name of the skill acquired by the class that will be displayed in the details window.
@default スキル追加:

@param ParamText1
@desc The display name of the Traits to show in the details window. 1 is for Enable and Disable.
@default 有効度,弱体有効度,無効化

@param ParamText2
@desc This is the display name of the trait to show in the details window. 2 is an additional ability score.
@default 命中率,回避率,会心率,会心回避,魔法回避,魔法反射率,反撃率,再生率

@param ParamText3
@desc The display name of the trait to show in the details window. 3 is the special ability value.
@default 狙われ率,防御効果率,回復効果率,薬の知識,消費率,チャージ率,物理ダメージ率,魔法ダメージ率,床ダメージ率,経験値獲得率

@param ParamText4
@desc The display name of the Traits to show in the details window. 4 is the attack tab.
@default 攻撃属性付与:,攻撃時ステート付与:,攻撃速度,攻撃回数

@param ParamText5
@desc The display name of the trait to show in the details window. 5 is the Skills tab.
@default スキルタイプ追加:,スキルタイプ封印:,スキル追加:,スキル封印:

@param ParamText6
@desc The display name of the Traits to display in the details window. 6 is the equipment tab.
@default 武器タイプ追加:,防具タイプ追加:,装備固定:,装備封印:,二刀流

@param ParamText7
@desc This is the display name of the Traits to display in the details window. 7 is the Other tab.
@default 行動回数追加,自動戦闘,防御,身代わり,持越し,消滅エフェクト,エンカウント半減,エンカウント無効,不意打ち無効,先制率アップ,取得金額倍化,アイテム取得率倍化

@param DefeatText
@desc This is the subtext used in the disappearance effect. It is not generally used.
@default 通常,ボス,瞬間消去,消えない

@param ParamWindowWidth
@desc The width of the window for displaying formation details.
@default 220

@param BasicWinExp
@desc This is the base value of the formation experience points added upon victory.
@default 1

@param MasterText
@desc This is the text that will be displayed in the Next column when you have mastered the formation.
@default Master!

@param LevelUpText
@desc This is the text that is displayed when the formation level increases.
@default _nameの熟練度が上がった!

@param MasterFormText
@desc This is the text that is displayed when the formation reaches its maximum level.
@default _nameをマスターした!

@param ActiveHelpText
@desc This is the operation help that is displayed when the status is active.
@default 決定:並び替え ←,キャンセル:リストに戻る

@param DeactiveHelpText
@desc This is the operation help that is displayed when the status is inactive.
@default 決定:陣形を変更 →:陣形の詳細を確認,並び替え

@param 【ホームの設定】
@text [Home settings]

@param HomePosition1
@desc This is the actor's home position when there is only one member. Please enter x,y.
@default 700,267

@param HomePosition2
@desc This is the actor's home position when there are two members. Please enter x,y x,y.
@default 640,242 700,292

@param HomePosition3
@desc This is the actor's home position when there are three members. Please write it as x,y x,y x,y.
@default 640,217 670,267 700,317

@param HomePosition4
@desc This is the actor's home position when there are four members. Please write it as x,y x,y x,y x,y.
@default 640,192 660,242 680,292 700,342

@param HomePosition5
@desc This is the actor's home position when there are 5 members. Please write it as x,y x,y x,y x,y x,y.
@default 630,187 650,227 670,267 690,307 710,347

@param HomePosition6
@desc This is the actor's home position when there are 6 members. Please describe it as x,y x,y x,y x,y x,y x,y x,y.
@default 620,167 640,207 660,247 680,287 700,327 720,367

@param HomePosition7
@desc This is the actor's home position when there are 7 members. Please enter x,y x,y x,y x,y x,y x,y x,y x,y.
@default 610,177 630,207 650,237 670,267 690,297 710,327 730,357

@param HomePosition8
@desc This is the actor's home position when there are 8 members. Please describe it as x,y x,y x,y x,y x,y x,y x,y x,y x,y.
@default 600,162 620,192 640,222 660,252 680,282 700,312 720,342 740,372

@param HomePosition9
@desc This is the actor's home position when there are 9 members. Please enter x,y x,y x,y x,y x,y x,y x,y x,y x,y x,y.
@default 590,167 610,192 630,217 650,242 670,267 690,292 710,317 730,342 750,367

@param HomePosition10
@desc This is the actor's home position when there are 10 members. Please describe as x,y x,y x,y x,y x,y x,y x,y x,y x,y x,y x,y.
@default 580,159 600,183 620,207 640,231 660,255 680,279 700,303 720,327 740,351 760,375

スポンサードリンク

-MV plugins

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