- Joined
- Jan 28, 2013
- Messages
- 776
- Reaction score
- 487
- First Language
- English
- Primarily Uses
- RMMV
Announcement:
This plugin, as well as my shield block plugin have been moved over to my itch.io page as paid plugins from this point on. Anyone who was previously using these plugins can continue to do so, but no further updates will be posted tho this thread. The most up to date version will be available on my itch.io page at all times, and I'd recommend paying for the plugin to ensure you continue to get updates and bugfixes in the future.
This thread will remain here, as a place for users to discuss the plugin, and bring up any errors or problems they find with it, but download links to the plugin and it's extension have been removed. If there is a ToS problem with this thread, I will do what I can to correct it.
This plugin, as well as my shield block plugin have been moved over to my itch.io page as paid plugins from this point on. Anyone who was previously using these plugins can continue to do so, but no further updates will be posted tho this thread. The most up to date version will be available on my itch.io page at all times, and I'd recommend paying for the plugin to ensure you continue to get updates and bugfixes in the future.
This thread will remain here, as a place for users to discuss the plugin, and bring up any errors or problems they find with it, but download links to the plugin and it's extension have been removed. If there is a ToS problem with this thread, I will do what I can to correct it.
Greetings and welcome to the thread announcing my new and improved Dual Wield Plugin (v2.50)!
Edit:
I have created a written tutorial for using this plugin and the menu extension. It should make it a little less daunting to try to use it. Good luck RPGMakers.
I have uploaded an extension to this plugin which affects how certain menu scenes are drawn for dual wield actors. You can get more info from this post right here. Check it out.
Also note:
This plugin should be in your load order with the rest of your battle plugins. You should be following the yanfly plugins load order. This plugin needs to load after YEP_DamageCore if you are using it. For best compatibility, you should load this plugin at the end of the battle plugins section (before the item plugins section).
The menu extension plugin needs to load after any YEP menu plugins that it modifies the scene for. For maximum compatibility, load this extension as close to the end of your plugin list as possible.
Key features:
This plugin only affects the default attack skill for now. In a future update, skills tagged with a notetag may also be affected. This has been completed as of version 2.1. YEP_BattleEngineCore is a required dependency. for now. If you disable it, the mechanics of the plugin still work, but the visuals are a little screwy. (this is a 100% required dependency now).
What does this have over the old plugin?
This was my first plugin, and man, it was a bit out of my league at the time. While the concept was sound, the implementation was terrible. TBH I was embarrassed how bad the original was, and sorta hoped it would go away, but I kept meeting people who were still using it, and couldn't figure out why. In the original thread for the first plugin, I discovered Victor Sants VE - Dual Wield plugin, which was everything my plugin was supposed to be, and more, and happily redirected folks to use his plugin instead. Then a few months after that, he pushed an update that broke compatibility with the YEP action sequences plugin, which apparently caused a lot of people to come back to my plugin, I guess.
Anyways, since it was so bad, and I'm a little bit better now, I figured I'd help those people out, and fix this thing up so that it isn't such a pain in the butt to set up. I think I succeeded.
Edit: v2.1 is up. Added support for dual wielding skills with the note tag <Dualwield Skill>. The setup for this is slightly more complex than the regular attacks.
A skill with the <Dualwield SKill> tag by itself will not work correctly without modifying your action sequence. I have added a new action sequence action via this plugin to allow dual wielding skills to split damage and show different weapon animations as the normal attack skill does.
You need to add the action sequence action 'dualwield action: x' to your action sequence before your 'motion attack' command. What this does, is repeats the next x actions from your action sequence after the first time, after switching weaponsprites and changing damage values.
Example:
Will cause all six actions following the command to repeat with the offhand weapon, making the skill hit once with each weapon (and changing damage values as well). Without this tag, the skill will only hit once, but will ignore the damage of the offhand weapon as if he were only wielding his mainhand weapon.
Edit2: let's talk about how this effect looks!
Here's before this plugin:
And here's after:
Edit:
I have created a written tutorial for using this plugin and the menu extension. It should make it a little less daunting to try to use it. Good luck RPGMakers.
I have uploaded an extension to this plugin which affects how certain menu scenes are drawn for dual wield actors. You can get more info from this post right here. Check it out.
Also note:
This plugin should be in your load order with the rest of your battle plugins. You should be following the yanfly plugins load order. This plugin needs to load after YEP_DamageCore if you are using it. For best compatibility, you should load this plugin at the end of the battle plugins section (before the item plugins section).
The menu extension plugin needs to load after any YEP menu plugins that it modifies the scene for. For maximum compatibility, load this extension as close to the end of your plugin list as possible.
Key features:
- Version 2.50:
- Added a plugin parameter to disable the added barehanded offhand attack if an actor is wielding a weapon in his mainhand but nothing in his offhand.
- Actors who are dualwield type, and have no weapons in either hand will now correctly strike twice.
- Menu Extension updated to v1.25:
- Requires v2.50 of the base plugin.
- Support in menus for the blanking offhand attack values when the offhand barehanded attack is disabled via the new plugin parameter in v2.50.
- In the YEP_StatusMenuCore attributes scene, 'blk' will now no longer show a blank box if the 'Show Block Chance plugin parameter is set to false.
- Corrected a visual issue where a dualwield actor's offhand attack value would show '---' on the equip scene if 'Show Block Chance' was set to false.
- Fixed a display issue on the YEP_StatusMenuCore general scene, where the mainhand and offhand attack parameter boxes did not include the text for the 'attack' parameter in the box.
- Fixed a display issue on the YEP_StatusMenuCore parameter gauge scene where a dual wielding actor who had no weapon in his mainhand would only show the one gauge for his main hand attack value, and not both main and off attack gauges as intended.
- Menu Extension updated to v1.23:
- Fixed compatibility with YEP_ExtraParamFormula where the display on the status scene was showing an incorrect value for the ohcri, and ohhit values, but was otherwise functioning normally behind the scenes.
- Fixed an additional display issue with the fix below in v1.22 where those param change values were showing weird numbers when swapping between a weapon and a shield in the offhand or a one or two handed weapon in the main hand. It will now show no change on the offhand slot unless the item being equipped is changing the param being shown there directly.
- Menu Extension Updated to v1.22:
- Fixed an issue where the parameter change text in YEP_EquipCore wasn't in the correct place when changing the offhand equipment, causing it to show attack changes on the mainhand weapon instead. This text only shows when the menu scene is wide enough to display it, which is not the case on the default RMMV resolution, so this bug went unseen for a long time. See screenshot below:

- Version 2.40:
- Revision a: Corrected an issue where a missed attack would cause all weapons to lose all traits permanently.
- Modified the plugin parameters for damage modifiers to allow them to be javascript evaluations. This will allow you to change the bonus/penalty of two-handing, dualwielding, or using a weapon in the offhand at runtime, by using eval codes that make use of states, variables, switches, skills known, and anything else you can think up.
- The offhand weapon's traits will no longer have an effect on the main hand weapon swings anymore, and vice versa. If one weapon has a large boost to crit or hit, or a different element than the other, the weapon being used will not be treated as if it also had that trait.
- Menu Extension Updated to v1.21:
- Fixed an issue in v1.20 where offhand hit and crit % would show a NaN value if the mainhand weapon slot was empty
- Note that the documentation previously incorrectly referred to the main and offhand crit short code as mhcrit and ohcrit, when it should have been mhcri and ohcri.
- Added compatibility with variable damage modifiers for Ramza_DualWIeld v 2.40.
- Added ability to show split hit and crit % on the YEP_StatusMenuCore attributes scene. Use mhhit, ohhit, mhcri, ohcri on the plugin parameters in that plugin to show them.
- Added plugin parameters to change the long names of the above exparams on that scene.
- Menu Extension updated to v1.12:
- (revision a) fixed a typo in the fix below that was causing the fix to not correctly apply when only the offhand was empty.
- Fixed a crash error when viewing a one-handed weapon in the shop menu, with a dual wield type actor selected who wasn't wielding an item in either his main or offhand to compare the shop item with.
- Version 2.30:
- (revision a) Corrected an issue with the second fix from v2.30, as it actually caused all attacks made by allies, with the exception of the very first action sequence taken in the game, will have reversed weapon battle animations. Actors that did not have an offhand weapon, or non-dual wield type actors, would instead have no weapon battle animation.
- Fixed an issue where custom damage formulas from YEP_DamageCore were not being handled correctly, and would sometimes result in a working formula erroring out and dealing zero damage
- Fixed an issue where a skill that when a dual wield type actor used a skill that hit an odd number of hits, their main and off hands would have their animations, sprites, and damage values permanently reversed.
- Menu Extension updated to v1.11:
- See this post for screenshots of the way the new scene looks
- This extension now fully supports the YEP_ShopMenuCore shop scene.
- When viewing a weapon that can be wielded in either hand, and an actor who can dual wield, the param preview pane on the shop scene is split to show the param changes for both the main hand and offhand item.
- Because the window pane doesn't have enough space for 16 params, the window has been changed to only show the four largest parameter changes per item. If there are less than four changes, the remaining spaces are filled with the normal param list, starting at Max Hp
- The secondary param window that shows all actors simultaneously has also been changed to show the param changes of a previewed weapon that can be equipped in either hand for both held items of a dual wield actor.
- All other weapons (two handed, main handed, off hand, shield) will only compare with the respective held item, leaving the shop scene looking normal.
- All other armors have the normal shop scene.
- Added a plugin parameter to show or hide the 'Possession: x' text at the bottom of the split param pane. I personally don't like where I had to put it, but there was no more room in that window, so I left the ability to turn it off.
- v1.11 Fixed a display issue with actors who do not have an actual shield or second weapon slot having their next available equipslot renamed to suggest it is their offhand slot.
- v1.11 If viewing a one handed weapon that cannot be equipped by the current dual wield actor, the shop scene will no longer show the split weapon comparison pane, and will instead show the default comparison pane. This was also causing the four largest params to change order (if moving between two weapons with different params that both couldn't be equipped), even though the param change values would always show '-'.
- v2.29:
- Weapon damage modifiers added in v2.24 now also apply to parameters added by event command to the actors. Originally, the bonus modifiers only applied to the base parameters on the actor (give by their class).
- Menu Extension updated to v1.04:
- The version check on launch will now detect and error out when it finds a version of the base dual wield plugin older than v2.20. Originally the plugin extension would run, but cause errors at runtime, now it properly throws an error message at startup.
- Fixed a bug on the YEP_EquipCore equip scene where swapping a two-handed weapon for a one-handed weapon would preview an offhand attack value, even if the actor wasn't capable of dual wielding.
- v2.28:
- Shop menu scenes will no longer incorrectly show that a non-dual wield actor can equip a weapon tagged with <offhand>, even if that actor could normally equip weapons of this wtypeId.
- Fixed an action sequence related issue where if checks to target.result() would always return false, such as target.result().i****()
- v2.27 bugfix:
- Attack parameters added to weapons via note tag in YEP_EquipCore are now correctly supported.
- (revision a) Corrected an issue where this version caused a crash if YEP_EquipCore was not being used.
- v2.26 bugfix:
- Enemies will now do more than zero damage, as an error in the damage calculation formula was corrected.
- Added in v2.25
- Fixed a bug where the correct attack value was being shown on the menus (with the menu plugin extension), but the actual values used during attack skills would not properly make use of the modifiers for dual wielding, offhanding or using a two-handed weapon unless the skill being used was a normal attack, a dual wield skill, or a main or offhand only skill.
- If you are using the YEP_BaseParamControl plugin, this dual wield plugin will need to be loaded after it. This plugin should always be loaded in your battle plugins for maximum compatibility, and the base param control plugin should always be loaded near the top of the list, so this shouldn't be an issue if you follow yanfly's suggested load order.
- All non-dual wield (or mainhand/offhand tagged) skills will now only benefit from the attack value of the weapon in the actor's main hand. Previously, these skills would deal damage based on the attack values of both weapons and the actor's base attack value (with no dual wield/offhand/two-handed modifiers)
- Removed confusing help text that implied that Monkeygripping was a thing (maybe next update?
)
- Added in v2.24
- New plugin parameters to adjust attack values on certain kinds of weapons. All of these modifiers are applied to the actor's base attack value before attack values on weapons are taken into account.
- Can set a modifier for a two-handed weapon
- Can set a modifier for dual wielding (which is applied to both the main and off hands)
- Can set a modifier for using a weapon in the offhand
- The above values should be an integer above 0
- Ex: if your actor has 100 attack when unarmed, and the default values of 1.5, 1.0 and 0.75, the following will happen:
- Using a two handed weapon with attack value of 10 will give a real attack value of 160 total
- If dual wielding two weapons with 10 attack each, the main hand will have 110 attack, while the offhand will have 85.
- A weapon tagged with <twohanded> will now always prevent an offhand barehanded attack if the offhand is empty, previously, the two-handed weapon needed to also have the disable state on it for this to be true.
- New plugin parameters to adjust attack values on certain kinds of weapons. All of these modifiers are applied to the actor's base attack value before attack values on weapons are taken into account.
- Menu Extension updated to v1.03:
- Added support for v2.24 of the main plugin
- Streamlined the equip scene to more consistently show the names for the mainhand and offhand slots when various different types of equipment are being exchanged, on default menu scenes and YEP menu scenes.
- Added in v2.23
- Updated help documentation to more easily list all note tags and their effects
- Added a <Mainhand> note tag for weapons, which will prevent them from being equipped in the offhand.
Made the <Offhand> note tag also support weapons. This makes a weapon tagged with this unable to be equipped in the mainhand. Note that equipping a two-handed weapon will still unequip a weapon in the offhand, and prevent one from being equipped. - Fixed a bug which prevented the player from manually equipping a shield into the offhand slot of a dualwield actor. Equipment optimization was previously the only way to get a shield into that slot.
- Menu Extension updated to v1.02:
- (new in v1.02) Default shop scene will now only compare the item in the correct hand when looking at an item tagged <Mainhand> or <Offhand>. This means that for a mainhand weapon, the stat compare will only show the mainhand weapon on the actor, even if the offhand weapon is worse, and vice versa. (v1.01 changes below)
- Code optimization
- The default shop scene will now use the offhand weapon as a comparison item if the player is viewing a shield
- The shop scene will also only compare the mainhand weapon against a two-handed weapon, even if the offhand weapon is worse
- YEP_ShopMenuCore shop scene now recognizes that an offhand weapon will be unequipped for a shield and will show the correct stat changes as a result.
- Added compatibility for the <Mainhand> and <Offhand> weapon note tags added in v2.23 of the main plugin.
- Added in v 2.22
- Shields can now be equipped in the offhand weapon slot of a dual wielding actor
- Equipment optimization will now no longer leave the offhand weapon slot of a dual wield actor blank if there is an equippable shield in the inventory. Optimization will equip a shield or a weapon in the offhand, preferring whichever provides the highest parameter buff.
- Added in v2.21
- Equipment optimization will now correctly place an offhand type shield into the offhand of a non-dual wielding actor who is using a two-handed weapon in their main hand. Previously, equipment optimization could determine that a non-offhand shield was better than an available offhand one, attempt to equip it with the two handed weapon, fail and end up with no item in the offhand.
- Added in v2.20
- Two new notetags. <twohanded> makes the given weapon force unequip the item in the offhand slot, such weapons cannot be equipped in the offhand slot of a dual wield actor. <offhand> makes a shield equippable in the offhand even when a twohanded weapon is equipped (think like a buckler shield)
- Added in v2.12
- Notetags for <mainhand skill> and <offhand skill> have been added. If a skill has either of these tags, it will only strike with the designated weapon, showing the correct animation and weapon sprite, as well as dealing damage that ignores the opposite weapon's atk parameters. Note that if both of these tags are put on the same skill, it won't work. This isn't a bug, just don't do that.
- Skills with one of the above tags will strike with the given weapon each time the skill hits, so if the skill hits three times, all three hits will be with the offhand weapon if an <offhand skill> tag is present.
- v2.12a:
- Fixed a bug where following a multi-hit offhand or mainhand skill, all dual wield attacks were reversed (mainhand was hitting as offhand, vice versa).
- v2.12b:
- Made a slight compatibility change in the background for action sequences that use the <mainhand skill> or <offhand skill> tags.
- Added in v2.11
- Added a plugin parameter to disable the added attack #, and damage splitting to the attack skill and skills tagged with the <dualwield skill>note tag, if a certain state is present on the actor. This allows you to more easily have dual wield actors able to use twohanded weapons, or sword and shield style, without disabling their dualwield type.
- New in version 2.1:
- Added notetag support to skills. <dualwield skill> denotes a skill as being a dualwield skill, which will split damage as normal attacks do.
- Added an action sequence command to facilitate the above change: DUALWIELD ACTION: X - repeats the X action sequence commands that follow this command with the offhand weapon. (this is required for damage splitting dual wield skills)
- Added two separate functions to track second weapon swings which can be eval'd into action sequences:
- user.isSecondAttack() returns true if the user is making his second weapon swing during a regular attack
- user.isSecondSkillHit() returns true if the user is making his offhand attack during a dual wielding skill (that is not attack).
- Plug and play, no setup required
- Actors that are dual wielding will deal two individual hits instead of one hit with two animations
- The two individual hits show the weapon sprite of each weapon equipped, and the proper animation
- The two individual hits deal damage without taking into account the attack power of the opposite weapon.
Showing individual attack values per hand on the status menu(added in extension)Possibility to make it affect more skills.(added in v2.1)
What does this have over the old plugin?
- The original dual wield plugin was unwieldy (see what I did there?). It required many dependency plugins, and took hours to set up correctly in a project. This one is plug and play.
- The original plugin had major issues with missed attacks, and required a number of function calls during action sequences to prevent data from being lost. This one doesn't.
- This plugin doesn't even require action sequences (although you should still use them because they're cool).
- The original plugin had issues with barehanded attacks. This plugin can properly show a barehanded main or offhand attack, while the other hand still has a weapon equipped.
This was my first plugin, and man, it was a bit out of my league at the time. While the concept was sound, the implementation was terrible. TBH I was embarrassed how bad the original was, and sorta hoped it would go away, but I kept meeting people who were still using it, and couldn't figure out why. In the original thread for the first plugin, I discovered Victor Sants VE - Dual Wield plugin, which was everything my plugin was supposed to be, and more, and happily redirected folks to use his plugin instead. Then a few months after that, he pushed an update that broke compatibility with the YEP action sequences plugin, which apparently caused a lot of people to come back to my plugin, I guess.
Anyways, since it was so bad, and I'm a little bit better now, I figured I'd help those people out, and fix this thing up so that it isn't such a pain in the butt to set up. I think I succeeded.
Edit: v2.1 is up. Added support for dual wielding skills with the note tag <Dualwield Skill>. The setup for this is slightly more complex than the regular attacks.
A skill with the <Dualwield SKill> tag by itself will not work correctly without modifying your action sequence. I have added a new action sequence action via this plugin to allow dual wielding skills to split damage and show different weapon animations as the normal attack skill does.
You need to add the action sequence action 'dualwield action: x' to your action sequence before your 'motion attack' command. What this does, is repeats the next x actions from your action sequence after the first time, after switching weaponsprites and changing damage values.
Example:
Code:
<dualwield skill>
<target action>
dualwield action: 6
motion attack: user
wait: 12
attack animation: target
wait: 4
action effect: target
wait for animation
</target action>
Edit2: let's talk about how this effect looks!
Here's before this plugin:
And here's after:
Attachments
-
805.3 KB Views: 281
-
773.8 KB Views: 309
Last edited:









