Difference between revisions of "MQ2BardSwap" - MMOBugs Wiki

Line 1: Line 1:
 +
{{plugin}}
 
{{Pluginbox
 
{{Pluginbox
|author=Cr4zyb4rd
+
| name = MQ2BardSwap
 +
| author = Cr4zyb4rd  
 +
| link = [http://www.mmobugs.com/wiki Wiki Link]
 +
| commands=/bardswap
 +
| source = Yes
 +
| usesini = Yes
 
}}
 
}}
 +
==Description==
 +
<font class="highlight">MQ2Bardswap</font> automatically swaps weapons with instruments as needed by bards.
  
[[Category: Incomplete Plugin Pages]]
+
==Commands==
{{stub}}
+
 
 +
* <span class="highlight2">/bardswap</span> Toggles swapping on/off.
 +
* <span class="highlight2">/bardswap melee</span> Toggles melee swap delay on/off.
 +
 
 +
 
 +
==Example Usage==
 +
Usage is simple, once you have your INI setup toggle the plugin on and it will start autoswaping intruments for the different types of songs.
 +
 
 +
==Macro Data==
 +
 
 +
This plugin adds a new TLO
 +
 
 +
* <span class="highlight2">${BardSwap} : bool</span> - Returns true if bardswap is on, false if bardswap is off.
 +
 
 +
===ExampleType===
 +
* <span class="highlight2">${BardSwap.Swapping} : bool</span> returns the status of swapping.
 +
* <span class="highlight2">${BardSwap.Excluded} : bool</span> Unknown how this type works, please edit if you do.
 +
* <span class="highlight2">${BardSwap.MeleeSwap} : bool</span> retuns the status of Melee swapping.
 +
* <span class="highlight2">${BardSwap.Delay} : int</span> returns the melee swap delay as set in the ini.
 +
* <span class="highlight2">${BardSwap.Casting} : string</span> returns the current spell/song being casted/sung.
 +
* <span class="highlight2">${BardSwap.CurrentSwap} : string</span> returns the name of currently swapped intstrument or weapon.
 +
 
 +
===Example Usage===
 +
Set your ini file up and toggle bardswap on with the toggle command listed above.  The ini doesn't have to be exactly like the ini.  The easiest way to think about it is this, if a Stringed song is started to be sung the command listed in the ini file will execute.  This can be an /exchange, /bandolier, /echo or any other number of commands.
 +
 
 +
==Configuration==
 +
 
 +
MQ2Bardswap provides configuration
 +
 
 +
===Sample Configuration===
 +
MQ2BardSwap_CharacterName_ServerName.ini
 +
<pre>[Settings]
 +
Horn=/exchange "Trumpet of the Dragon Goddess" mainhand
 +
Drum=/exchange "Thunderous Drum of Karana" mainhand
 +
Lute=DISABLED
 +
Wind=DISABLED
 +
Singing=DISABLED
 +
Weapons=/exchange "Blade of Vesagran" mainhand
 +
Delay=21
 +
[Exclude]
 +
;Instruments don't have an effect on these
 +
exclude1=Requiem of Time
 +
exclude2=Selo's Rhythm of Speed
 +
exclude3=Selo`s Assonant Strane
 +
exclude4=Song of Sustenance
 +
exclude5=Alenia`s Disenchanting Melody
 +
;no swap for my Selo's AA
 +
exclude6=Selo`s Accelerating Chorus
 +
;or lute of the flowing waters click
 +
exclude7=Wind of Marr</pre>
 +
 
 +
===Configuration Explanation===
 +
 
 +
* <span class="highlight2">Horn</span>: When you sing a brass instrument song this item will be autoswapped to your mainhand before cast is up to get the extra boost from the item.
 +
* <span class="highlight2">Lute</span>: Disabled means the plugin will not do any swapping if this type of song is played.
 +
* <span class="highlight2">Weapons</span>: This is the item to swap back to once the song has been sung.
 +
* <span class="highlight2">Exclude#</span>: If you want to exclude a specific song do so in the [Exclude] section of the ini file.
 +
 
 +
==Version History==
 +
 
 +
*<span class="highlight2">1.1</span> <span class="highlight">''Cr4zyb4rd'' @ 2004-09-25</span>
 +
** Use spell structs instead of parsing MQ2Data complete rewrite of swapping logic, melee swapping should work in all situations
 +
 
 +
==Availability==
 +
 
 +
This plugin is included with the MMOBugs Compile.

Revision as of 15:23, 20 December 2008

Plugin Info
Name MQ2BardSwap
Author Cr4zyb4rd
Link Wiki Link
Commands /bardswap
Source Available Yes
Uses INI File Yes

Description

MQ2Bardswap automatically swaps weapons with instruments as needed by bards.

Commands

  • /bardswap Toggles swapping on/off.
  • /bardswap melee Toggles melee swap delay on/off.


Example Usage

Usage is simple, once you have your INI setup toggle the plugin on and it will start autoswaping intruments for the different types of songs.

Macro Data

This plugin adds a new TLO

  • ${BardSwap} : bool - Returns true if bardswap is on, false if bardswap is off.

ExampleType

  • ${BardSwap.Swapping} : bool returns the status of swapping.
  • ${BardSwap.Excluded} : bool Unknown how this type works, please edit if you do.
  • ${BardSwap.MeleeSwap} : bool retuns the status of Melee swapping.
  • ${BardSwap.Delay} : int returns the melee swap delay as set in the ini.
  • ${BardSwap.Casting} : string returns the current spell/song being casted/sung.
  • ${BardSwap.CurrentSwap} : string returns the name of currently swapped intstrument or weapon.

Example Usage

Set your ini file up and toggle bardswap on with the toggle command listed above. The ini doesn't have to be exactly like the ini. The easiest way to think about it is this, if a Stringed song is started to be sung the command listed in the ini file will execute. This can be an /exchange, /bandolier, /echo or any other number of commands.

Configuration

MQ2Bardswap provides configuration

Sample Configuration

MQ2BardSwap_CharacterName_ServerName.ini

[Settings]
Horn=/exchange "Trumpet of the Dragon Goddess" mainhand
Drum=/exchange "Thunderous Drum of Karana" mainhand
Lute=DISABLED
Wind=DISABLED
Singing=DISABLED
Weapons=/exchange "Blade of Vesagran" mainhand
Delay=21
[Exclude]
;Instruments don't have an effect on these
exclude1=Requiem of Time
exclude2=Selo's Rhythm of Speed
exclude3=Selo`s Assonant Strane
exclude4=Song of Sustenance
exclude5=Alenia`s Disenchanting Melody
;no swap for my Selo's AA
exclude6=Selo`s Accelerating Chorus
;or lute of the flowing waters click
exclude7=Wind of Marr

Configuration Explanation

  • Horn: When you sing a brass instrument song this item will be autoswapped to your mainhand before cast is up to get the extra boost from the item.
  • Lute: Disabled means the plugin will not do any swapping if this type of song is played.
  • Weapons: This is the item to swap back to once the song has been sung.
  • Exclude#: If you want to exclude a specific song do so in the [Exclude] section of the ini file.

Version History

  • 1.1 Cr4zyb4rd @ 2004-09-25
    • Use spell structs instead of parsing MQ2Data complete rewrite of swapping logic, melee swapping should work in all situations

Availability

This plugin is included with the MMOBugs Compile.