LoTROInterface SVN KragenBars

KragenBars by Kragenwar and Valdacil
v3.21 - 2011-01-28

Kragenwar and Valdacil have been working together for the last month and a half on the next generation
of Kragenbars. This new version features all classes (except Warden, expected to be added in a later
version) with all skills organized onto multiple bars and offering contextual feedback as appropriate.
Skills your character is too low to use will be hidden. Please note installation instructions below for
notes on upgrading from an earlier version.


Global Features:
----------------------
- NEW: Automatic class detection and setup
- NEW: Ability to swap skills between bars
- NEW: Ability to lock swappable skill bars to prevent accidental skill swapping
- NEW: Ability to rotate bars to be horizontal or vertical
- NEW: Option to snap bars to grid for easy alignment
- NEW: Completely revised setup screen better details the options and allows for future additions
- UDATED: Skills respond to combat states (ie. skills not usable in combat hide when combat starts)
- FIXED: Fully compatible with Nov Update and other plugins by changing coding to AddCallback vice
attaching directly to the player. (Now fully compatible with BuffBars and other plugins)
- REVISED: Reorganized directory structure to reduce dependencies on external libraries (please see
upgrade instructions below)

Certain plugins which directly overwrite player functions like InCombatChanged, StanceChanged, EffectAdded and EffectRemoved may break KragenBars functionality if loaded after KragenBars. If things do not seem to be working correctly then ensure that you are loading KragenBars last as KragenBars does not overwrite these functions.


Class Specific:
----------------------
Burglar
- Crit chain bars display and update when you crit.
- Find Footing indicator displays when stunned/dazed/knocked down
- Mischief indicator displays when out of combat and not in mischief
- Mischief related skills only display when in mischief (Honed Wit option allows Clever Retort to display out of Mischief)
- Item slots for Marbles, Caltrops, Stun Dust and Throwing Knives/Hatchets
- FM Response bar displays when the fellowship completes a named FM
- Green Poison indicator appears on Cure Poison/Burglar's Antidote when you have clearable poison debuffs.

Captain
- Defeat response bar displays when you receive a defeat response
- Devestating Blow, Pressing Attack and Blade of Elendil only appear when available.
- Option for all three marks on one scrolling quickslot
- Motivating Speech indicator displays when buff is not active
- IDOME indicator displays when buff is not active
- Tactics quickslot contains all 3 tactics (use scroll wheel to change shown tactic). Can be set to either fade or disappear when a tactic is active on the player
- Cry of Vengence indicator displayed upon fellowship member defeat
- Herald scroll quickslot displays when not in combat and fades down to indicate when you have a banner buff on you
- Banner scroll quickslot displays all banner plus Armament for switching back to Heralds. Fades down when you have banner buff active.
- Item Quickslots for Summoning Horn, Battle-Tonics and Blazoned Emblems
- Purple Fear indicator appears on Muster Courage when you have clearable fear debuffs.

Champions
- Defeat response bar displays when you receive a defeat response.
- Buff bar displays available buffs (Flurry/Exchange of Blows) depending on your stance. Icons disappear when buffs are activated and come back when they fade off.
- Stance quickslot contains all stances in one slot (use scroll wheel to cycle). Options available to select a primary and secondary stance. If you are in your primary stance, the stance slot will fade and show your secondary stance; if not it will show your primary stance. Options to hide or dim when in a stance.
- Hedge indicator when disarmed
- Blood Rage indicator when stunned/dazed/knocked down
- Fervor Tracking: Skills only display if you have enough fervor for them.
- Item Quickslots for Crafted Horn and Fervor Tonics
- Purple Fear indicator appears on Fear Nothing when you have clearable fear debuffs.

Guardians
- Block and Parry reactive bars display when you block/parry and update as you move down the chain. (Now includes Tier 3 Block/Parry Responses)
- Guardian's Ward quickslot can be set to dim or hide when you have the Guardian's Ward Buff up.  Additional option Early Warning makes the slot hide and then come back dimmed about 3-5 seconds before the buff fades.
- Stance quickslot contains all stances in one slot (use scroll wheel to cycle). Options available to select a primary and secondary stance. If you are in your primary stance, the stance slot will fade and show your secondary stance; if not it will show your primary stance. Options to hide or dim when in a stance.
- Overpower bar shows if you are in Overpower. Shield Blow, Protection and Shield Wall disappear when in Overpower.
- Turn the Tables indicator displays when you are stunned/dazed/knocked down
- Item Quickslots for Shield Spikes and Overpower Tactics
- Red Wound indicator appears on Feel No Pain when you have clearable wound debuffs.

Hunter
- Agile Rejoinder displays if you receive Parry response
- Swift Stroke indicator displays when you don't have the Swift Stroke buff
- Tracking skills contained in one slot (use scroll wheel to cycle)
- Stance quickslot contains all stances in one slot (use scroll wheel to cycle). Options available to select a primary and secondary stance. If you are in your primary stance, the stance slot will fade and show your secondary stance; if not it will show your primary stance.
- Find the Path indicator can hide or dim when active
- Trapping skills contained in one slot (use scroll wheel to cycle)
- Strength of the Earth hidden when not in combat
- Focus Tracking: Skills only display if you have enough focus for them.
- Fire Oil and Light Oil quickslots configurable in the setup window. When an oil is active that slot will be hidden and the alternate oil slot will dim.
- Bow Chants quickslot configurable in the setup window.  When Bow chant is active slot will be hidden.
- Crafted traps multiquickslot configurable in the setup window (use scroll wheel to cycle crafted traps slot)
- Ports contained in one slot (use scroll wheel to cycle)

Loremaster
- Warding Lore skills contained in one slot (use scroll wheel to cycle)
- Pet buffs contained in one slot (use scroll wheel to cycle)
- Pet food multiquickslot configurable in the setup window.  (use scroll wheel to cycle)
- Pets contained in one slot (use scroll wheel to cycle between pet types; Alt+Scroll to cycle appearances). Setup window has options for which pets and appearences to show when scrolling
- Ancient Wisdom indicator shows when buff is not active
- Pets and Back from the Brink are hidden when in combat 

Minstrel
- Ballad bars and Anthem bar hide as appropriate (ie T2 Ballad bar is hidden until T1 Ballad is cast)
- Option to either hide or dim ballads with active buffs
- Skills only available in Warspeech are hidden if WS is not active
- Dethreat skills only show in combat
- Silence removal skills only show when silenced
- Tales contained in one slot (use scroll wheel to cycle). Tales indicator dims when a tale is active.
- Quickslots for Lute Strings and Sheet Music.  Lute Strings slot will hide while Lute Strings are active.

Runekeeper
- Calming Verse indicator shows when buff is not active
- Distracting Winds indicator show in combat
- Master of Writs indicator dims when buff is active. Writ skills show/hide depending on whether buff is present.
- Attunement and OffAttunement bars: Attunement bar shows usable Healing or Fury of Storm skills based on whether the player is Healing attuned or Battle attuned. OffAttune bar shows Scribe's Spark and Ceaseless Argument or Prelude to Hope, Rune of Restoration, Mending Verse and Writ of Health based on what is shown on the Attunement bar
- Skills show/hide based on attunement level
- Healing skills hide when out of combat as appropriate


Installation
----------------------
Due to significant reorganization within the KragenPlugs directory, if upgrading from version 2.0 and below it is recommended that you delete your old KragenPlugs folder before installing the new version.  If you are a KragenSlots user you can keep the directories KragenSlots, DUInterface and the file KragenSlots.plugin

Option 1: Use Lotr:O Plugin Assistant by Ify
1) Download KragenBars
2) In Lotr:O Plugin Assistant check the box next to KragenBars then select "Delete Checked"
3) Drag KragenBars.zip downloaded in step 1 onto Lotr:O Plugin Assistant to install it.
4) Launch from within game as normal (via manager or via /plugins load Kragenbars)


Option 2: Manual Install
1) Download KragenBars
2) Delete the KragenPlugs directory from %Documents$\Lord of the Rings Online\Plugins
3) Extract KragenBars.zip downloaded in step 1 to your %Documents%\Lord of the Rings Online\Plugins
directory
4) Launch from within game as normal (via manager or via /plugins load Kragenbars)


Note
----------------------
Due to significant changes in the PluginData file, anyone upgrading from a version of KragenBars prior to
version 3.00 will have their KragenBar settings reset to KragenBars defaults on first load of versions higher
than 3.00.


Usage
----------------------
The first time Kragenbars is loaded (either via an in-game plugin manager or by executing the command:
"/plugins load Kragenbars") your class will be automatically detected and default options selected. The
Kragenbars setup window will be displayed to further customize the available features.

Once you have configured Kragenbars with your class, you can access setup using:

/kragenbars setup

Other command:
/kragenbars refresh (forces Kragenbars to reprocess the level checking data; useful after leveling up
and training new skills at the trainer)
/kragenbars save (forces Kragenbars to save all options and window positions)
/kragenbars reset (resets all settings defaults and bar positions)
/kragenbars defaultpos (resets bar positions to default)



Known Issues
----------------------
-The API does not allow us to determine whether the client is in layout mode (CTRL + \) or not. Loading KragenBars while in layout mode will result in drag bars that display/hide when they should be doing the opposite. If this happens just unload and reload the plugin with layout mode turned off.
-KragenBars relies on effect names to change the state of your UI.  Because of this all features may not function properly on German and French clients.  We are in the midst of working on this, if you would like to help with effect name translation please PM KragenWar.
<<<<<<< .mine
    - Minstrel: French translation needed.
    - Loremaster: French and German translation needed.
    - Hunter: French and German translation needed.
    - Runekeeper: French and German translations needed.
    - Burglar: French and German(partial) translation needed
    - Captain: German(partial) and French(partial) translation needed
    - Guardian: French(partial) and German(partial) translation needed
=======
    - Minstrel: French translation needed.
    - Loremaster: French and German translation needed.
    - Hunter: French and German translation needed.
    - Runekeeper: French and German translations needed.
>>>>>>> .r49


Version Notes
----------------------
v3.21
- Fix for a Runekeeper skill issue.

v3.20
- Added language selection to setup window to override client locale.
- Updated Minstrel, Loremaster, Hunter, and Runekeeper with core code for localization.  Please see above
      translation requests for help in translating effects.
- Loremaster: Added pet food multiquickslot next to the Pet Buffs multislot.
- Hunter: Added crafted traps multiquickslot next to the Trapping multislot for 3 crafted traps.
- Hunter: Added Bow Chants quickslot next to the Light Oil quickslot.  Bow chant slot will hide when bow
      chants are active.
- Hunter: Bug fix for Distracting Shot showing up behind Rain of Thorns.
- Champion: Fixed some level errors on the skills Clobber, Bracing Attack and Hamstring
- Champion: Added quickslots for Crafted horn and Fervor Tonics
- Guardian: Added quickslot for Overpower Tactics
- Captain: Added quickslots for Rally Horn, Battle-tonics and Balzoned Emblems
- Burglar: Added quickslot for Throwing Knives/Hatchets
- Bug fix: Fixed bugs related to item quickslot visibility.

=======
v3.20
- Added language selection to setup window to override client locale.
- Updated Minstrel, Loremaster, Hunter, and Runekeeper with core code for localization.  Please see above
      translation requests for help in translating effects.
- Loremaster: Added pet food multiquickslot next to the Pet Buffs multislot.
- Hunter: Added crafted traps multiquickslot next to the Trapping multislot for 3 crafted traps.
- Hunter: Added Bow Chants quickslot next to the Light Oil quickslot.  Bow chant slot will hide when bow
      chants are active.
- Hunter: Bug fix for Distracting Shot showing up behind Rain of Thorns.

>>>>>>> .r49
v3.12
- Bug fix: Burglar's Sneak was not displaying until level 28.  Sneak now will display at level 4.
- Bug fix: Burglar's FM Responses were causing an error due to a typo.
- Bug fix: Encoding/Decoding of numbers on French/German clients was not properly converting keys.  This has been fixed (Big thanks to ptweety for testing this and giving assistance in solving the issue)
- Minstrel: Added quickslots for consumables (Lute Strings and Sheet Music)
- Minstrel: Updated for localization and added German translations of effect (thanks to ptweety)
- Minstrel: Bug fix for Fellowship's Heart visibility after setting in the Setup window.

v3.11
- Bug fix: Hunter's Bards Arrow should now properly display on load.
- Bug fix: Multi-Slots were not showing if the user did not have the latest Turbine folder.  Multi-Slots are now independent of the Turbine library.
- New: Added encoding and decoding of numbers on save/load for French and German clients.  French and German clients should now properly save and load settings.
- Bug fix: Minor bug fixes to Champion and Captain.
- Bug fix: Sometimes the left half of the quickslots were becoming unclickable, this has been fixed.

v3.10
- Added Hunter "Stance Active" option in the Features panel
- Added Hunter Port skills on a single multislot (use scroll wheel to cycle)
- Bug fix for Minstrel related to Tales removal.

v3.02
- Additional bug fix for Minstrel skill Song of Restoration.  Thanks Uendilor for catching this one.
- Bug fix for Guardian and Champion Stance indicators.

v3.01
- Bug fix for Minstrel skill Song of Restoration/Chorus of Restoration.  Chorus will now replace Song at level 62.
- Optimization of features in Guardian, Champion and Captain setup windows.
- Bug fix for Captain's Motivated, IDoME and Tactics slots.  They should now behave as expected.

v3.00
- NEW: Automatic class detection and setup
- NEW: Ability to swap skills between bars
- NEW: Ability to lock swappable skill bars to prevent accidental skill swapping
- NEW: Ability to rotate bars to be horizontal or vertical
- NEW: Option to snap bars to grid for easy alignment
- NEW: Completely revised setup screen better details the options and allows for future additions
- UDATED: Skills respond to combat states (ie. skills not usable in combat hide when combat starts)
- FIXED: Fully compatible with Nov Update and other plugins by changing coding to AddCallback vice
attaching directly to the player. (Now fully compatible with BuffBars and other plugins)
- REVISED: Reorganized directory structure to reduce dependencies on external libraries

v2.0.0
- This is purely a fix to the problems introduced by the November Lotro Patch. Expect more fixes
and features early next week.

v1.5.2
- Fixed some bugs that were causing the individual components to still display on inital load if you had
set them off in the setup window.

v1.5.1
- CHAMPION: Fixed an issue where traited versions of Flurry and Exchange of Blows were not working
as intended.

v1.5.0
- KragenBars are now movable. Just press Ctrl+/ to unlock the UI and you will find dragbars for the
individual components of KragenBars. Additionally they will hide when you use F12 to hide your UI.
- New options and bars added to all classes, read the class sections above for more details. 
- BURGLAR: The Crit Chain for burgs was changed so that Burglar's Advantage/Double Edged Strike over
lap with the stage 3 responses. This was done because of the cooldowns on Exposed/Flashing Blades
I found that I missed not being able to start the chain over while waiting for cooldowns on
stage 3. Also feint attack will no longer display when you are in Mischief.


Future Plans
----------------------
- Add Warden class
- Add class consumables w/ appropriate effects
- Update for GetClassAttributes() to better handle class specific features (stances, crit responses, etc)
- Localized versions for German and French clients
- Add ability to rename and resize bars
- Add ability to make bars show only in/out of combat
- Add option to make scroll slots to scroll when right clicked instead of on scroll


Credits
----------------------
Thanks to Digital Utopia for his Timer class and DUInterface UI Library.
Thanks to Deusdictum for his DragBar class. 
Thanks to Pengoros for his permission and assistance in adapting the BuffBars setup window.
Thanks to Eronaile for helping with the German effect names for Guardian/Burglar/Champion and Captain.
Thanks to ptweety for testing and helping with the German/French client settings number issue.
Thanks to rafalek for helping with effect localization bugs