A downloadable tool

Get this tool and 21 more for $39.99 USD
View bundle
Buy Now
On Sale!
10% Off
$5.99 $5.39 USD or more

Note: This plugin is a part of the OctoPack Battler plugin set. Please keep in mind if you purchase this plugin, it will not deduct the price from the OctoPack Battler Sample Project if you wish to buy it later.

This is a RPG Maker MV plugin that will give your game's actors the function to swap weapons in the middle of the fight. Up to one of each weapon type can be equipped at a time and they can be switched out each turn. Swapping weapons can let the player team adapt to certain situations better or giving them the ability to hit certain weapon weaknesses in battle.

This plugin changes both something inside battle and outside of battle. The Attack command option can now have the weapon being used swapped by pressing left or right (if that option is turned on). Some skills can also automatically switch to a weapon when it starts being used.

The other change is in the Equip menu. Instead of having only a single weapon slot, there is now one weapon slot for each of the weapon types. Each actor can equip a weapon of that type into those slots if they can use those weapon types.

There will be a warning though. This feature does not work with the Dual Wield system so it is disabled in order to be able to swap weapons.

Some plugin parameters require your attention. Please read through and configure them to customize weapon swapping for your game.

Plugin Parameters

Battle Control: 

Swap Command: How command for how Weapon Swap is displayed

Show Command?: Show the Weapon Swap Command in the Actor Command Window? Turn this on if you are making your game for mouse control because there is no other way to switch weapons without using the arrow keys.

Use Arrow Swapping?: Use Arrow Keys to control weapon swapping? If on, then pressing left or right will switch the weapon currently equipped in the order of the Weapon Types list in the Database's Types tab.

Show Swap Arrows?: Shows arrow sprites next to the Attack command to tell the player that pressing Left or Right here can have an effect.

Battle Test Weapons: During battle test, equip each party member with one of each weapon type. The weapon selected will be the first available one in the database unless they already have that weapon equipped.


Show Battle Icons: Show icons of currently equipped weapons in battle? This will show the icon next to the Attack command, making it easier for the player to know which weapon the actor has currently equipped.

Show Battle Action: Show animation of actor switching weapons? This is for sideview only. When weapon switching is done during Attack switching, the actor will perform an attack motion to display the weapon it is  currently equipped with.

Extend Equip Stat Window: If you are using Yanfly's Equip Core, this will extend the stat compare window to have Hit Accuracy, Evasion, and Critical.


Skill and Item Notetags:

<Switch to Weapon: x>
<Switch to Weapon: text>
When the actor uses this skill or item, the actor will switch to this weapon if it is equipped when the skill cost is paid. x is the weapon type ID and text is the weapon name. If you use the weapon name, type it out exactly since it is case sensitive. This notetag does not make the weapon a requirement. To make it a requirement, use the database's "Required Weapon" dropdown lists to enforce the requirement.

Skill Notetags:

Require Any Weapon>
Requires any kind of weapon to be equipped in order to use it.
<Require Weapon Types: x>
<Require Weapon Types: x, x, x>
Insert multiple x to add more weapon types. All of the weapon types must be equipped in order for this skill to be used.

Action Sequence

If you are using YEP Battle Engine Core, there is an action sequence that
lets you switch weapons for the actor in the middle of an action sequence:

Weapon Swap: targets, x
Weapon Swap: targets, text
Swap Weapon: targets, x
Swap Weapon: targets, text

Use x with the weapon type ID in the Database Type tab. Or use text and replace it with the name of the weapon type. If you use the name of the weapon type, type it out exactly as it is spelled because it is case sensitive.


This plugin is made for RPG Maker MV versions 1.6.1 and below. If you update RPG Maker MV past that and this plugin breaks, I am NOT responsible for it.


This plugin is compatible with the following plugins:

  • - YEP Core Engine
  • - YEP Battle Engine Core
  • - YEP Action Sequence Packs 1, 2, 3
  • - YEP Animated Sideview Enemies
  • - YEP Buffs & States Core
  • - YEP Damage Core
  • - YEP Element Core
  • - YEP Item Core
  • - YEP Equip Core

Place this plugin under those in the Plugin Manager list.

Terms of Use

  1. These plugins may be used in free or commercial games.
  2. 'Fallen Angel Olivia' must be given credit in your games.
  3. You are allowed to edit the code.
  4. Do NOT change the filename, parameters, and information of the plugin.
  5. You are NOT allowed to redistribute these Plugins.
  6. You may NOT take code for your own released Plugins.

Change Log History

  • Sep 8 2018: Added Battle Test Weapons plugin parameter
  • Sep 9 2018: New notetags added: <Require Any Weapon> and <Require Weapon Types: x> and added new parameters: Extend Equip Stat Window
  • Sep 11 2018: Bug fix for Optimize and Clear weapon. Should be fixed now. Added a new parameter: Show Swap Arrows?
  • Sep 18 2018: Add fail safe: battle test will not provide weapon types that don't have weapons made for them and give you a warning.
  • Sep 23 2018: Bug fix for Battle Test Weapon. Can now be turned off.
Rated 4.6 out of 5 stars
(7 total ratings)
GenreRole Playing
Tagsasset, plugin, RPG Maker, tool


Get this tool and 21 more for $39.99 USD
View bundle
Buy Now
On Sale!
10% Off
$5.99 $5.39 USD or more

In order to download this tool you must purchase it at or above the minimum price of $5.39 USD. You will get access to the following files:

Olivia_WeaponSwap.js 40 kB

Exclusive content

Support this tool at or above a special price point to receive something exclusive.

Limited Free Downloads

I will be switching this plugin to be a paid plugin for various reasons. To give some users that wanted this plugin but did not acquire it for free during the time it was available as such, I will be allowing the first 20 people to download this plugin to acquire it freely.