PotionBar

Description
Dedicated customizable actionbar for potions that automatically updates itself based on player inventory.

Features

• Support for all potion categories and types
  
• Support for all liniments
  
• Support for unknown and special potions
  
• Automatic Updating based on current potion and liniment inventory in bag
  
• Customizable PotionBar size and position
  
• Configurable User Options
  
  • PotionBar display direction
    
  • Show/Hide activator nub
    
  • Autohide PotionBar
    
  • PotionBar Scale
    
  • PotionBar Opacity
    
  • Potion/Liniment Count display
    
• Configurable Potion Options
  
  • Quick Actions configure potion and lininment settings
    
  • Potion and liniment types to display
    
  • Display position of potions and liniments
    
  • Stack by potion type
    
  • Potion usage and sort priority (strongest potion, weakest potion, etc...)
    
• LibSlash support for chat line commands and options
  
• Multiple Language Support (currently includes English, German, Spanish, Italian, and French)

Supported Versions
Warhammer Online v1.4.5

Dependencies:
PotionBar 5.3 and above need LibSlash!

Usage

Simply download, unzip and install the Addon (see the included PotionBar_Install.txt for more details)

Following commands are implemented for help and additional information:

/PotionBar help
/PotionBar config
/PotionBar reset

Changing the configuration of PotionBar:
There are 2 ways to access the PotionBar configuration and options window:

1) Right click on the small circular button attached to PotionBar.

- or -

2) Type following command:

/PotionBar config

Either of these will bring up the PotionBar Config Window.

PotionBar configuration options are self explanatory.

Settings do not save unless you hit Save.

Hiding the Floating Activator provides a cleaner visual look, but you will only be able to access the Config Window using the aforementioned Slash commands.

The Quick Actions pulldown on the right pane allows the application of settings across all potions quickly.

When you choose to let PotionBar stack same potions, it ignores the difference in power or duration.
For example: Potionbar will show all your level 35 and level 38 potions as one single stack, even though they are multiple stacks in your backpack.

Potion stacks are sortable by size or power.
You can configure whether clicking a PotionBar button uses your weakest or strongest potion or whether it uses a potion from your smallest or biggest stack.

Hybrid potions are supported, albeit different from normal potions. They are only sortable by stacksize, because hybrid potions do yet not exist in different power.

Potions which PotionBar is not aware of are supported in a very limited form. Unlike other potions, they can't be grouped together. Though very limited, it makes PotionBar usable by foreign language clients.

Commands:
In addition to the graphical button bar, PotionBar supports using potions by using the following Slash commands:

/PotionBar use AP
/PotionBar use AP_RVR
/PotionBar use HEAL
/PotionBar use HEAL_RVR
/PotionBar use REGEN
/PotionBar use SHIELD
/PotionBar use STRENGTH
/PotionBar use INTELLIGENCE
/PotionBar use WILLPOWER
/PotionBar use BALLISTIC
/PotionBar use ARMOR
/PotionBar use TOUGHNESS
/PotionBar use THORNS
/PotionBar use SPIRIT
/PotionBar use ELEMENTAL
/PotionBar use CORPOREAL
/PotionBar use DOT
/PotionBar use AOEDOT
/PotionBar use FIREBREATH
/PotionBar use SNARE
/PotionBar use WARBLOOD
/PotionBar use WARDEMISE
/PotionBar use WARFERVOR
/PotionBar use WARGENIUS
/PotionBar use WARHUNGER
/PotionBar use WARMERCY
/PotionBar use BOUNDLESSSIGHT
/PotionBar use IMMUTABLEDEFIANCE
/PotionBar use INEXORABLEAEGIS
/PotionBar use INSPIRATIONALWINDS
/PotionBar use PEERLESSDEFENSE
/PotionBar use QUICKENDBLADES
/PotionBar use SAVAGEVIGOR
/PotionBar use SWIFTTERGIVERSATION
/PotionBar use ETERNALHUNT
/PotionBar use INEVITABLETEMPEST
/PotionBar use TOLLINGBELL
/PotionBar use UNFETTEREDZEAL
/PotionBar use ZEPHYRTONIC
/PotionBar use TAHOTHELIXIR
/PotionBar use PTRAELIXIR
/PotionBar use SPEEDBLOWINGSAND
/PotionBar use SINGLES
/PotionBar use UNKNOWNS 'Name of Potion'

Macros:
PotionBar can be used from within a macro as well. Please use it from within macros like this.

/script PotionBar.Use("HEAL")

or like this (please notice the different quote characters):

/script PotionBar.Use("UNKNOWNS 'Name of Potion'")

Please look above for other possible parameters.

PotionBar.Use() returns true, if it thinks it could successfully use a potion.
This can be used to make a macro which uses different potions in different conditions.

The following example will try to use a heal potion. If it couldn't use one, then it uses a regen potion.

/script if not PotionBar.Use("HEAL") then PotionBar.Use("REGEN") end

The following example will use a shield potion if you are on full health.
If you have less than 100% health and more than 50% health or if a shield potion couldn't be used then it tries to use a regen potion.
And if you have less then 50% health or the regen potion couldn't be used then it tries to use a heal potion.

/script local cur = 100 * GameData.Player.hitPoints.current / GameData.Player.hitPoints.maximum; if cur >= 100 and PotionBar.Use("SHIELD") then else if cur >= 50 and PotionBar.Use("REGEN") then else PotionBar.Use("HEAL") end end

Binding to keys:
PotionBar does not directly support binding to keys, but it supports being used from within macros.
You should be able to achieve the same result with the macro support of PotionBar.
Create a macro which makes PotionBar use a potion and bind this macro to a key of an actionbar which you don't use.

Multiple PotionBars:
I am sorry, but this isn't going to be implemented anytime soon.
You can achieve the exact same result if you take 2 minutes of your precious time and follow following steps:

• Choose a name for the bar. It must not have any numbers in it, iE 'LeftPotionBar' is a valid name, while 'PotionBar2' is not!
  
• Go into your addons folder, iE: C:\Program Files\Warhammer Online\interface\addons.
  
• Create a new folder with your new name.
  For example: C:\Program Files\Warhammer Online\interface\addons\LeftPotionBar
  
• Copy all files from the PotionBar folder into your new folder.
  The PotionBar folder is somewhere here: C:\Program Files\Warhammer Online\interface\addons\PotionBar.
  
• Open all files in your new folder with your favorite text editor (iE NotePad).
  
• Replace all occurances of PotionBar with your new name (iE LeftPotionBar).
  Please make sure that you make a case sensitive search and replace.
  For example, Settings.lua of version 6.4 contains exactly 280 strings to be replaced.
  You must not rename any files.
  
• Restart your game or type /reload.
  The new PotionBar should be visible right away.
  The commands for your new bar are based on your choosen name.
  For example: /LeftPotionBar use HEAL or /LeftPotionBar config.