{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=ASwfGzpyznQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/990013" width="552" height="167"><a href="https://visustellamz.itch.io/battle-system-otb">Battle System - OTB plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 8}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:BattleSysOTB_Ani.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:BattleSysOTB_Preview.png|600px]]

This plugin changes the RPG Maker MZ battle system to "Order Turn Battle",
a turn-based battle system where actions are executed immediately and the
orders for both the current and next turn are not only visible, but also
malleable. New mechanics are introduced where the player can manipulate the
turn order of an action's user or action's target in various ways they want.

The two Turn Orders are displayed at the top of the top of the screen to
give the player a clear understanding of who's turn it will be when it
becomes time to act, making it easier and viable for the player to formulate
strategies and adapt to the situation in battle.

*NOTE* To use this battle system, you will need the updated version of
VisuStella's Core Engine. Go into its Plugin Parameters and change the
"Battle System" plugin parameter to "otb".

Features include all (but not limited to) the following:

* Utilizes the balanced AGI nature of the Default Turn Battle system.
* Allows for actions to execute immediately upon selection.
* Two Turn Order Displays appear at the top of the screen, giving the player an idea of who's turn it will be and when, for both the current turn and the next turn.
* Skills and Items can have an "Instant Use" effect, which allows them to perform an action immediately without using up a turn.
* Skills and Items can manipulate the turn order of the action's user or the action's target(s). This can apply to either the current turn or the next turn, depending on the notetags and/or action effects used.
* The Turn Order Display will give a preview on how turn orders will change upon specific skills and/or items being used.

== Requirements ==

This plugin is made for RPG Maker MZ. This will not work in other iterations
of RPG Maker.

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

This plugin adds some new hard-coded features to RPG Maker MZ's functions.
The following is a list of them.

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

=== Turn Order Displays ===

The Two Turn Order Displays will capture the battle's current and next turn
orders determined by the BattleManager. This feature does not overwrite any
functions, but the Turn Order Displays may or may not conflict with any
existing HUD elements that are already positioned on the screen. If so, you
can choose to offset the Turn Order Display or move it to a different part
of the screen through the plugin parameters.

---

=== Agility ===

Agility behaves slightly different from normal when it comes to the Order
Turn Battle system. Aside from the first turn in battle, agility will always
calculate the turn order for the "Next Turn" when conducted. This means that
any changes to agility values will not have any effect on the next turn's
already established turn order.

However, this can be remedied by utilizing the notetags provided by this
plugin to alter the Next Turn orders for specific targets. In fact, for
skill and item "effects" that add AGI Buffs and/or Debuffs, the target's
turn position on the Turn Order Display will be manipulated in accordance.
This auto-conversion feature can be disabled in the Plugin Parameters.

---

=== Action Speed ===

[[File:BattleSysOTB_TurnOrderChange.png]]

Because the Order Turn Battle system already calculates agility speeds
before selecting an action to perform, the effects of the action speed will
not work the same way it did with the default battle system. Instead, the
Action Speed will be sent through a formula to determine its effect on the
following turn, either pushing the user ahead in next turn's turn order
(with a positive speed value) or back (with a negative speed value).

This option can have its formula altered or straight up disabled in the
Plugin Parameters.

---

=== Infinity Speed and Clamping ===

Since Action Speeds are decided in such a way, enemies that will survive a
stun state past two turns will have "Infinity" speed on the recovery turn,
allowing them to act first relative to the rest of the battle participants
in order to balance out the turns they've lost.

Enemies with "Infinity" speed cannot be overtaken through turn order
manipulation while they are on the "Next Turn" order. If anything, battlers
who shift their turn order faster will be just trailing behind them, thus
the "clamping" effect. However if this occurs during the "Current Turn"
order, all is fair game and any battler can overtake them. Plan out your
battle system effects carefully with these rules in mind.

If you do not like the idea of Infinity Speed and/or Clamping, you can turn
them off in the Plugin Parameters.

This effect does not affect stun states that last only one turn. The effect
will only occur with stun states that last 2 turns or more.

---

=== Instant Use ===

Skills and Items can have an "Instant Use" property which allows them to be
used immediately without consuming a turn. This can be used for actions that
otherwise do not warrant a whole turn. These can be used for minor buffs,
debuffs, toggles, etc.

---

=== Force Actions ===

Due to how OTB behaves, Force Actions have be adjusted to fit the battle
system. With other battle systems, force actions are added into a hidden
queue that would act upon after the current battler finishes his/her current
action. The new changes made with force actions is that they now appear on
the queue visibly.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Party System VisuStella MZ]]

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Order Turn Battle is
in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

{{Notetags MZ}}

{{VisuMZ Battle System OTB Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Battle System OTB Plugin Commands}}

== Script Calls ==

The following are Script Calls that can be used with this plugin. These are
made for JavaScript proficient users. We are not responsible if you use them
incorrectly or for unintended usage.

---

=== Add Action-Related Script Calls ===

---

<pre>
$otbAddBattlerToCurrentTurnEnd(battler, times)

- Adds a battler to current turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

<pre>
$otbAddBattlerToNextTurnEnd(battler, times)

- Adds a battler to next turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

== Plugin Parameters ==

=== Conversion Settings ===

[[File:BattleSysOTB_TurnOrderChange.png]]

[[File:BattleSysOTB_Params1.png]]

Automatically converts specific mechanics to fit OTB.

---

Buffs

AGI Buff => Current:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
current Turn Order?

AGI Buff => Next:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
next Turn Order?

---

Debuffs

AGI Debuff => Current:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
current Turn Order?

AGI Debuff => Next:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
next Turn Order?

---

=== Mechanics Settings ===

[[File:BattleSysOTB_Params2.png]]

Determines the mechanics of Battle System OTB. These range from how Action
Times are handled to speed.

---

[[File:BattleSysOTB_ActionTimes.png]]

Action Times+

Enable Action Times?:
- Enable Action Times+ to have an effect on OTB?

Randomize Order?:
- If enabled, randomize the action order for added actions?

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

Speed

Allow Random Speed?:
- Allow speed to be randomized base off the user's AGI?

Post-Stun Infinity?:
- After a 2+ turn stun states, battlers have infinity speed for their
recovery turn.
- Once again, this only applies to stun states that last 2+ turns.

Infinity Clamp?:
- Prevents turn order manipulation from going faster than infinity
speed battlers.

JS: Initial Speed:
- Code used to calculate initial speed at the start of battle.

JS: Speed => Order:
- Code used to calculate how action speeds alter next turn's order.

---

=== Turn Order Display ===

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

[[File:BattleSysOTB_Params3.png]]

Turn Order Display settings used for Battle System OTB. These adjust how the
two visible turn orders appears in-game.

---

General

Display Position:
- Select where the Turn Order will appear on the screen.
- Top
- Bottom

Offset X:
- How much to offset the X coordinate by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the Y coordinate by.
- Negative: up. Positive: down.

Reposition for Help?:
- If the display position is at the top, reposition the display when the
help window is open?

Offset X:
- Reposition the display's X coordinates by this much when the Help
Window is visible.

Offset Y:
- Reposition the display's Y coordinates by this much when the Help
Window is visible.

Forward Direction:
- Decide on the direction of the Turn Order.
- Left to Right
- Right to Left

Subject Distance:
- How far do you want the currently active battler to distance itself from
the rest of the Turn Order?

Screen Buffer:
- What distance do you want the display to be away from the edge of the
screen by?

---

UI Background

Background Style:
- Select the style you want for the background.
- fill
- gradient
- image
- transparent

Image Filename:
- When using the "image" style, select an image from /img/system/ as the
background image.

Offset X:
- How much do you want to offset the Background Image's X position?

Offset Y:
- How much do you want to offset the Background Image's Y position?

---

UI Text

Font Size:
- The font size used for parameter values.

Active Battler Text:
- Text used to display the active battler.
- This text will always be center aligned.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Current Turn Text:
- Text used to display the current turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Next Turn Text:
- Text used to display the next turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Text Align:
- Text alignment for the Current and Next Turn texts?
- auto
- left
- center
- right

---

Slots

Width:
- How many pixels wide should the slots be on the Turn Order display?

Height:
- How many pixels tall should the slots be on the Turn Order display?

Preview Scale:
- How much do you want to scale the preview sprites by?
- Use a number between 0 and 1 for the best results.

Offset X:
- How much do you want to offset the Preview Sprites' X position?

Offset Y:
- How much do you want to offset the Preview Sprites' Y position?

Update Frames:
- How many frames should it take for the slots to update their
positions by?

---

Slot Border

Show Border?:
- Show borders for the slot sprites?

Border Thickness:
- How many pixels thick should the colored portion of the border be?

Actors
Enemies

Border Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Border Skin:
- Optional. Place a skin on the actor/enemy borders instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

Slot Sprites

Actors

Sprite Type:
- Select the type of sprite used for the actor graphic.
- Face Graphic - Show the actor's face.
- Icon - Show a specified icon.
- Sideview Actor - Show the actor's sideview battler.

Default Icon:
- Which icon do you want to use for actors by default?

Enemies

Sprite Type:
- Select the type of sprite used for the enemy graphic.
- Face Graphic - Show a specified face graphic.
- Icon - Show a specified icon.
- Enemy - Show the enemy's graphic or sideview battler.

Default Face Name:
- Use this default face graphic if there is no specified face.

Default Face Index:
- Use this default face index if there is no specified index.

Default Icon:
- Which icon do you want to use for enemies by default?

Match Hue?:
- Match the hue for enemy battlers?
- Does not apply if there's a sideview battler.

---

Slot Letter

Show Enemy Letter?:
- Show the enemy's letter on the slot sprite?

Font Name:
- The font name used for the text of the Letter.
- Leave empty to use the default game's font.

Font Size:
- The font size used for the text of the Letter.

---

Slot Background

Show Background?:
- Show the background on the slot sprite?

Actors
Enemies

Background Color 1:
Background Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Background Skin:
- Optional. Use a skin for the actor background instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

If you are using this plugin, credit the following people in your game:

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.19: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New script calls added by Olivia:
*** $otbAddBattlerToCurrentTurnEnd(battler, times)
*** $otbAddBattlerToNextTurnEnd(battler, times)
**** Adds actions for target battler to the end of current/next turn.

Version 1.18: May 15, 2025
* Bug Fixes!
** Fixed a bug where adding states with Action Times+ would add too many actions. Fix made by Olivia.

Version 1.17: November 14, 2024
* Bug Fixes!
** Fixed a bug where the <OTB Target Follow Turn: +x> and similar notetags altered the following turn regardless of the presence of the target in current turn order. Fix made by Olivia.

Version 1.16: September 19, 2024
* Compatibility Update!
** Added better compatibility with Auto Skill Triggers. Update by Arisu.

Version 1.15: May 16, 2024
* Feature Update!
** Direct removal of stun states will restore actions for battlers for current turns and follow up turns. Update made by Olivia.

Version 1.14: May 18, 2023
* Bug Fixes!
** Fixed a bug that caused turn order glitches with Action Times+ that aren't at 100% value. Fix made by Olivia.
** Fixed a bug that caused added Action Times+ to not trigger on actors that have already exhausted their current turns if raised due to a state. Fix made by Olivia.

Version 1.13: January 20, 2023
* Bug Fixes!
** Fixed a bug where the Forced Action of a battler is not used properly. Fix made by Arisu.

Version 1.12: December 15, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: August 18, 2022
* Bug Fixes!
** Fixed bugs that caused the OTB Turn Order faces and icons to not change properly for actors and enemies.

Version 1.10: July 7, 2022
* Feature Update!
** When the "Recover All" event command revives a dead unit, that revived unit can gain actions back if all other conditions are met. Update made by Olivia.

Version 1.09: June 2, 2022
* Documentation Update!
** Added "Force Actions" to "Major Updates" section.
*** Due to how OTB behaves, Force Actions have be adjusted to fit the battle system. With other battle systems, force actions are added into a hidden queue that would act upon after the current battler finishes his/her current action. The new changes made with force actions is that they now appear on the queue visibly.
* Bug Fixes!
** Fixed a bug that caused Forced Actions to not work properly while in OTB. Changes made to Forced Actions will now insert new actions at the front of the current action queue. Fix made by Olivia.

Version 1.08: March 10, 2022
* Feature Update!
** OTB Instant Actions should now appear in the turn order in a more sensible fashion. Update made by Olivia.

Version 1.07: February 24, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.06: November 11, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <OTB User Add Current Turn Actions: x>
*** <OTB User Add Next Turn Actions: x>
*** <OTB Target Add Current Turn Actions: x>
*** <OTB Target Add Next Turn Actions: x>
**** Adds extra actions for the user/target to perform during the current/next turn.
**** Added actions will go towards the back of the action list.
**** Multi-hit skills/items will trigger this effect multiple times.

Version 1.05: October 28, 2021
* Bug Fixes!
** Turn Order display will no longer appear at differing X and Y positions when using specific battle layouts. Update made by Olivia.

Version 1.04: August 6, 2021
* Bug Fixes!
** Enemies with multiple actions will no longer step forward when it's not their turn. Fix made by Olivia.

Version 1.03: June 25, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: April 16, 2021
* Bug Fixes!
** Post-stun infinity clamping should now be adjusted properly for previewing turn order changes.

Version 1.01: April 9, 2021
* Bug Fixes!
** Subsequent battles will properly reset the turn order. Fix by Olivia.

Version 1.00 Official Release Date: April 26, 2021
* Finished Plugin!

== See Also ==

* [[Battle System Differences VisuStella MZ]]
* [[Inspiration Behind Wave 8]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]