Minion Beta! - Help us test our new AddOn updater. Get it now!
Download
(376 Kb)
Download
Updated: 10-18-14 01:48 PM
Pictures
File Info
Compatibility:
Warlords of Draenor Pre-Patch (6.0.2)
Siege of Orgrimmar (5.4)
Updated:10-18-14 01:48 PM
Created:06-11-14 07:52 PM
Downloads:3,863
Favorites:61
MD5:
Categories:Utility Mods, Action Bar Mods, Combat Mods, Warlords of Draenor Beta, Beta-version AddOns
6.0.2
KayrMacro - Advanced Macros and Expanded Storage  Updated this week!
Version: 0.4.4.1 (Public Alpha)(WoD Beta Compatible)
by: Kvalyr [More]
================================================================
= KayrMacro - Advanced Macros Addon for World of Warcraft
= Copyright (c) Kvalyr - 2014 - All Rights Reserved
================================

Please see the KayrMacro Wiki @ http://kayrmacro.kvalyr.com

THIS IS AN ALPHA 'PREVIEW' RELEASE.
! BUGS AND MISSING FEATURES !

In-Game Documentation added!
Compatible with Warlords of Draenor Beta

Syntax for macros may occasionally change during alpha phase, but once the addon reaches beta the KMacro addon syntax will be stable and should see minimal changes in future.

Please note: Users upgrading from versions prior to 0.3.4 may need to update any of their KMacros that used macro shorthands (such as [Tx] for talent-casting).
The wrapper symbols for these shorthands have been changed from "[x]" to "<x>"


This addon has been in development on-and-off for a number of months and I've been using it myself since 5.0.
I'm releasing this alpha version to get feedback from users on usability and functionality and to get the ideas and code out.

================================
Description & Features:
================

KayrMacro (KM) is an AddOn for World of Warcraft that expands the functionality of the game's built-in macro system.
It adds new conditions and keywords; and greatly expands macro storage, all while retaining full compatibility with
the default UI as well as all ActionBar addons.

* Vastly expanded macro storage (Space for thousands of macros)
* New advanced macro conditions in addition to those built into WoW
* Supports macros longer than 255 characters (to almost any length)
* Macro-shortening and useful shorthands
* Macro Indentation & Syntax Highlighting during editing

================
Examples
================
Examples of the kinds of complex macros and conditions possible with KM can be seen at: http://kayrmacro.kvalyr.com

================
Existing macros are left untouched
================
KM never modifies existing macros and does not interfere with the normal usage of macros in WoW.
KM will only modify/rewrite macros that have been 'enabled' in the main KM window.

Players can choose to give KayrMacro control of none or all 54 macro slots in the default macro UI.

================
Expanded Macro Storage
================
KM greatly expands the amount of storage space available for macros by allowing the player to store their macros on an
account-wide, class-wide or character-specific basis.

The AddOn then dynamically calls up the stored macros according to the player's choice on a per-macro basis that can be
changed at any time (out of combat) by the user.

The actual macro icon in the macro frame or on the player's bars remains where it is at all times and the addon simply
re-writes the macro's code when necessary.

================
Advanced Macro Conditions
================
KM adds a number of new conditions to macros for choosing actions according to class, spec, talent-choices, known spells, etc.

Note: The new conditions added to the macro system by KM are ONLY PARSED OUTSIDE OF COMBAT.
The WoW API prevents macros from being edited during combat and KM makes no attempt to circumvent this limitation.

KM cannot automate macros during combat, it is simply a way to consolidate macros according to new out-of-combat conditions.

================
Infinite Macro-length
================
Macros in KayrMacro can be of any length. The advanced conditions added by KM make it less likely that the user will need macros
longer than 255 characters, but the addon supports macros of almost any length as long as no single slash-command within the macro
is longer than 1023 characters.
The addon warns the user in the rare case that this is an issue.

================
Macro Shorthands
================
Talent-spells can be cast by using <Tx> in place of a spell name, where 'x' is the tier of the talent.

For instance, to cast the player's chosen 2nd-tier talent:
''/cast <T2>;''

Other shorthands include:
Best Health Potion: <healthpotion>
Best Mana Potion: <manapotion>
Best Bandage: <bandage>
Best Food: <food>
Best Water: <water>

================
Macro Indentation and Syntax-highlighting
================
+ Macros written in KM can have as much or as little whitespace as the user desires.
+ KM ignores whitespace and even linebreaks in most circumstances.
+ The semicolon ( ; ) is used to signal the end of a 'line' in a macro.
+ This also allows for indentation so that separate conditions (such as modifiers) can be split across multiple lines after a
slash command for readability in a macro.

+ Examples of this can be seen on the Wiki ( http://www.kvalyr.com/wiki/index.php/KayrMacro#Syntax )



================
How it works
================
KM Works by adding a pre-processor stage to macro creation that works outside of combat to re-write KM macros according to
states such as the player's chosen spec, talents, available items, etc.

KMacros are handled in a window attached to the MacroFrame of the default UI but the macros produced by KM are normal, valid
macros indistinguishable from hand-written macros in the default UI.

================
Usage:
========
+ Please see documentation at http://kayrmacro.kvalyr.com
+ Getting started: http://www.kvalyr.com/wiki/index.php/KayrMacro#Getting_Started

================
Requirements & Compatibility:
=======
+ WoW 5.4 to 6.x (Mists of Pandaria / Warlords of Draenor)

+ KayrMacro requires empty/available macro slots to work initially.

+ The end-result Macros generated by KM are functionally identical to hand-written macros and are equally compatible with
existing action bar addons.

+ Please report any incompatibilities discovered to Kvalyr on the WoWInterface.com page for this addon.

================
Installation:
=======
+ Standard addon installation:
Place the "KayrMacro" folder inside "[WoW Folder]\Interface\Addons".
Enable KayrMacro in the Addons menu on the character selection screen.

================
Planned Features:
========

+ Options GUI
+ Multi-line Conditions
+ User-defined conditions, sub-macros, variables

================
Libraries
=======
+ Embeds KayrLib by Kvalyr and LibStrataFix by oscarucb

================
Credits/Contact:
=======
Wiki: http://kayrmacro.kvalyr.com

+ Kvalyr (Author)

================
Licence & Disclaimer:
=======
THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

KayrMacro & KayrLib - Copyright 2014 Kvalyr (Robert Voigt) - ALL RIGHTS RESERVED
Modification or redistribution without explicit consent from the author is prohibited and
considered a breach of copyright.

A lack of response by the author to requests for permission to redistribute this software
in any state must NOT be considered as permission, implicit or otherwise.
In such case as redistribution is explicitly permitted by the author, this software and
these accompanying notices must remain intact and included with the software.

================================
Authorized Download Locations:
================
WoWInterface.com

================
Known Issues:
=======
+ No user-configurable options for submacros (healthpotion, manapotion, bandage, food, water)

================
Change Log:
=======
See Change Log tab (above)

================================================================
0.4.4.1
- Fixed issue of long pause at login introduced by caching changes in 0.4.4

0.4.4
- Major optimization pass. Core addon functions should run without any tangible impact on game performance now due to added caching of intermediate macroBody states.
- Updated forms/stances for 6.0.2

0.4.3.1
- Fixed error relating to CfgScheme.LongMacros general field

0.4.3
- Fixed issue with valid slash commands being removed during KMacro cleanup stage
- Fixed issue with spec condition and numerical arguments

0.4.2
- Fixed issue where existing duplicately-named macros can be inadvertently modified by KM
- Fixed typo in <Tx> description

0.4.1
- Added new constants (in the 'variables' menu) for frequently used pieces of macros.
- Added 'words' for different forms/stances. Example: "form:<bear>" can now be used instead of "form:1"
(Easier to remember)
- Fixed issue with creating new normal macros when KayrMacro is active
- Improved Syntax Highlighting now handles subMacros nested in condition blocks; and higlights condition-negation symbols (! or ~) in red

0.4.0
- Added menus to view SubMacros, Conditions and Variables and their documentation!
These menus currently just display information and usage instructions for KM's built-in macro components.
In later versions this is where users will define their own custom SubMacros, Conditions and Variables
- Improved layout and appearance of main KM window
- Moved "Character-Specific Storage" checkbutton to the macro right-click menu
- Fixed bug in macro shortHand subMacro that allowed for trying to cast tiers beyond the current expansion's max
- Added confirmation dialog to "Place All Macros" button
- Fixed occasional error when renaming KMacros
- UI Performance improvements

----------------------------------------------------------------

0.3.6 (Internal)
- Updated macro defaults to match changes made in 0.3.4
- KM_Parses refactored into separate files in preparation for 0.4
- Improved macro tidy-up procedure to clear out redundant slash commands where KM conditions have removed arguments

0.3.6
- Updated macro defaults to match changes made in 0.3.4
- KM_Parses refactored into separate files in preparation for 0.4
- Improved macro tidy-up procedure to clear out redundant slash commands where KM conditions have removed arguments

0.3.5
- Fixed problems with some conditions spamming errors
- Added unique syntax color for SubMacros
- Added substution submacros for using items like <gloves>, <belt>, <cloak> (eg: for engineering tinkers), <trinket1>, <trinket2>, etc.

0.3.4
- Important: Changed wrapping symbols for all submacro functions from [x] to <x>. This includes talent and item shorthands.
This was necessary in order to support features in developent for future release.
Example: [T1] (for casting 1st-tier talent) should now be written as <T1> in macros. Macros will need to be updated manually.
- Fixed reliability issues with talent conditions and shorthands for both MoP and WoD
- Added new conditions: [class:(PLAYERCLASS)], [name:(PLAYERNAME)], [faction:(PLAYERFACTION)], [pvp],
[realm:(PLAYERREALM)], [sex:(PLAYERSEX)], [race:(PLAYERRACE)]
- Added baseline support for user-defined subMacros and conditions due in 0.4.x


0.3.3.1
- Added workaround for TextBlock.cpp crash on line 553 in WoD Beta

0.3.3
- Updated to support Warlords of Draenor Beta (Backwards-compatible with MoP 5.4.8)
- Performance improvements from memoizing player talent information
- Added toggle button for the KM window and enabled its X button (Remembers state between sessions)

0.3.2
- New feature: Infinite-length macros (in theory). See Wiki for info.
- More small fixes to layering issues
- Macros containing /script or /run slash-commands will no longer be parsed for KM conditions etc.

0.3.1.1
- Fixed layering issue with ActionSlot menu

0.3.1
- Fixed right-click context menu
- Macros can now have "Action Slots" assigned to them (ie: numbers representing positions on the actionbars)
(Middle-click to place them without dragging)
- Added "Place All Macros" button
- Increased height of main KM window

0.3.0
- First Alpha Release
Archived Files (14)
File Name
Version
Size
Author
Date
0.4.4 (Public A
376kB
Kvalyr
10-17-14 11:52 PM
0.4.3.1 (Public
376kB
Kvalyr
08-16-14 01:20 PM
0.4.3 (Public A
376kB
Kvalyr
08-08-14 12:36 PM
0.4.2 (Public A
375kB
Kvalyr
08-05-14 08:03 PM
0.4.1 (Public A
375kB
Kvalyr
08-02-14 12:37 PM
0.4.0 (Public A
371kB
Kvalyr
07-25-14 08:45 PM
0.3.6 (Public A
374kB
Kvalyr
07-23-14 09:55 PM
0.3.5 (Public A
358kB
Kvalyr
07-19-14 11:34 AM
0.3.4 (Public A
358kB
Kvalyr
07-19-14 03:18 AM
0.3.3.1 (Public
354kB
Kvalyr
07-18-14 09:12 AM
0.3.2 (Public A
351kB
Kvalyr
06-26-14 07:30 PM
0.3.1.1 (Public
348kB
Kvalyr
06-21-14 04:56 PM
0.3.1 (Public A
348kB
Kvalyr
06-20-14 08:17 PM
0.3.0 (Public A
344kB
Kvalyr
06-11-14 07:52 PM


Post A Reply Comment Options
Unread 10-19-14, 03:41 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 26
Uploads: 4
Re: option to turn off dynamic icons?

Originally Posted by b3n9ti
all I want for my macro is to show me the icon I specify, as in:

#showtooltip
#show [talent:1/3,stance:1] wild charge; cyclone
/cast blabla bla


can I do this somehow?
Your #showtoolip and #show are probably conflicting in a situation like this.

Have you tried something like:

Code:
#showtooltip [talent:1/3,stance:1] wild charge; cyclone
/cast blabla

Are you seeing unexpected behaviour from KM, compared to normal macros in this case?

Originally Posted by Tntdruid
Keep up the great work, love the addon
Thanks for the support! It means a lot.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Unread 10-18-14, 02:58 PM  
Tntdruid
Premium Member
 
Tntdruid's Avatar
Premium Member
AddOn Author - Click to view AddOns

Forum posts: 48
File comments: 105
Uploads: 3
Keep up the great work, love the addon
Tntdruid is offline Report comment to moderator  
Reply With Quote
Unread 10-18-14, 02:58 PM  
b3n9ti
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 31
Uploads: 1
option to turn off dynamic icons?

all I want for my macro is to show me the icon I specify, as in:

#showtooltip
#show [talent:1/3,stance:1] wild charge; cyclone
/cast blabla bla


can I do this somehow?
b3n9ti is offline Report comment to moderator  
Reply With Quote
Unread 10-18-14, 01:07 PM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 26
Uploads: 4
Originally Posted by infinityz
Hey mate, any chance to get something like that: /cast [mod:shift] Kill Shot;[mod:ctrl] Steady Shot
working in the near future?
Probably not in the near future - The infinitely-long macros feature is experimental and I don't have as much time to work on the addon these days; and there are other things that need work more urgently. It's on the to-do list, but I'd be lying if I said it'll get done soon.
When it's done, you'll see it mentioned in the change log.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Unread 10-18-14, 05:49 AM  
infinityz
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
Hey mate, any chance to get something like that: /cast [mod:shift] Kill Shot;[mod:ctrl] Steady Shot
working in the near future?
infinityz is offline Report comment to moderator  
Reply With Quote
Unread 10-17-14, 11:58 PM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 26
Uploads: 4
0.4.4

Just a quick update to account for some changes in 6.0.2 that I didn't catch during the beta (due to RL taking me away from addon development).

More importantly, 0.4.4 brings a major optimization pass to the core functions of the addon. Prior to this version the addon's impact on performance wasn't noticable on faster CPUs, but occasional stutters were apparent on machines with slower CPUs when entering/exiting combat with all 54 KMacros enabled. This was due to the huge amount of string processing the addon needs to do on-demand.

In 0.4.4 I introduced some serious caching to the macro-parsing part of the addon and optimized some of the loops, which should get rid of any of the previous stuttering. Future versions will take these optimizations further and put the processing into something vaguely similar to a secondary 'thread' (via lua coroutines). This is something I've used extensively elsewhere in my KLib library (the code that underlies KM) and should go a long way towards eliminating any noticable performance impact of the addon even on old/weak PCs.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Unread 09-23-14, 10:40 AM  
wolfi
A Kobold Labourer

Forum posts: 1
File comments: 12
Uploads: 0
Re: Re: Wiki

Originally Posted by Kvalyr
Development on KM has slowed considerably but I hope to get back to it soon™.
I'm looking foward. ^^
wolfi is offline Report comment to moderator  
Reply With Quote
Unread 09-12-14, 12:15 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 26
Uploads: 4
Re: Wiki

Originally Posted by wolfi
maybe you could mention in the wiki that class-condition works with english names (druid, mage,...) but spec-condition needs the localized names.

edit: this is not always, testing more.
KM has no support for languages other than enUS and enGB yet, sorry - It's on the roadmap but I want to tackle localization properly once I get to that point.

As a more general update - I've started a new job and moved country so things are a bit hectic for me right now. Development on KM has slowed considerably but I hope to get back to it soon™.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Unread 09-07-14, 03:05 PM  
wolfi
A Kobold Labourer

Forum posts: 1
File comments: 12
Uploads: 0
Wiki

maybe you could mention in the wiki that class-condition works with english names (druid, mage,...) but spec-condition needs the localized names.

edit: this is not always, testing more.
Last edited by wolfi : 09-09-14 at 03:49 AM.
wolfi is offline Report comment to moderator  
Reply With Quote
Unread 08-29-14, 04:30 AM  
b3n9ti
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 31
Uploads: 1
Originally Posted by Trimble Epic
...

I do have to specify it by using #show [@mouseover,help] heal; mindflay on top of everything else, otherwise it doesn't work.

but that's something I'm missing with KayrMacro. I'm using it for my druid and usually cram all the abilites (for the different forms) in for example button 3, so, if i'm in stance 0 it's moonfire, stance:2 shred etc. etc..

with KayrMacro, as a lot of other conditions also go in there, it almost never shows me the correct icon, as I also wanna see e.g. a certain spell out of combat, even though it's only supposed to cast it in combat... (maybe i'm just using wrong syntax or sth, but if I understand it correctly you can't display icons that don't have anything to do with what is cast, right?)
Last edited by b3n9ti : 08-29-14 at 04:31 AM.
b3n9ti is offline Report comment to moderator  
Reply With Quote
Unread 08-26-14, 08:11 PM  
Trimble Epic
An Aku'mai Servant
 
Trimble Epic's Avatar
AddOn Author - Click to view AddOns

Forum posts: 31
File comments: 40
Uploads: 2
Originally Posted by the-wind-waker
Originally Posted by Trimble Epic
I don't understand your question.
I was just wondering, why the limitation you mentioned earlier doesn't seem to apply to the aforementioned addon. my macros are frequently longer than 255 characters and the correct icons are nonetheless shown.
Oh... I don't think the limitation is on the icon, I think the limitation is on the tooltip when you hover over the icon.

Does SDM handle dynamic icon? i.e. when your macro includes a mouseover conditional, and you mouseover a valid target for that condition - does the icon momentarily change to the other spell when it becomes valid?

For example:
/cast [@mouseover,help] Heal; Mindflay

Icon is for mindflay unless my mouse happens to pass over a player that I can heal...
Trimble Epic is offline Report comment to moderator  
Reply With Quote
Unread 08-22-14, 03:57 PM  
the-wind-waker
A Kobold Labourer

Forum posts: 0
File comments: 9
Uploads: 0
Originally Posted by Trimble Epic
I don't understand your question.
I was just wondering, why the limitation you mentioned earlier doesn't seem to apply to the aforementioned addon. my macros are frequently longer than 255 characters and the correct icons are nonetheless shown.
Last edited by the-wind-waker : 08-22-14 at 04:06 PM.
the-wind-waker is offline Report comment to moderator  
Reply With Quote
Unread 08-20-14, 08:10 PM  
Trimble Epic
An Aku'mai Servant
 
Trimble Epic's Avatar
AddOn Author - Click to view AddOns

Forum posts: 31
File comments: 40
Uploads: 2
Originally Posted by the-wind-waker
remember http://www.wowinterface.com/download...uperMacro.html ?
for some reason the icon still shows even if the macro is longer than 255 characters. any idea why that is?
the tooltip thing is the only reason I'm still sticking with that fossil SuperDuperMacro :-(
I don't understand your question.
Trimble Epic is offline Report comment to moderator  
Reply With Quote
Unread 08-20-14, 09:52 AM  
the-wind-waker
A Kobold Labourer

Forum posts: 0
File comments: 9
Uploads: 0
remember http://www.wowinterface.com/download...uperMacro.html ?
for some reason the icon still shows even if the macro is longer than 255 characters. any idea why that is?
the tooltip thing is the only reason I'm still sticking with that fossil SuperDuperMacro :-(
the-wind-waker is offline Report comment to moderator  
Reply With Quote
Unread 08-18-14, 09:05 AM  
Trimble Epic
An Aku'mai Servant
 
Trimble Epic's Avatar
AddOn Author - Click to view AddOns

Forum posts: 31
File comments: 40
Uploads: 2
Whoops! that was quick...

Possible bug: strata doesn't seem to match the macros window - bartender is poking through (above) your kayrmacro window, but not the blizzard macro window.

Also, I'm having trouble editing a macro - when I press Enter on the keyboard, it completes the macro, but doesn't start a New Line... need to be able to add more lines That's a pretty big deal breaker... (edit: ahh, shift-enter does a newline... that's kinda painful... can you change that? Ion uses TAB or just click outside the edit window to save)

Also, is there a way to sort the macros? or will they always be in the KMacro_01- order? Blizzard's macros sort alphabetically, and I can force a sort order by renaming in-game macros if I want... (i.e. my /macro macro is called AAmacro)

Another missing feature - I can shift-click a spell in the spellbook to auto-type the spell name into the editor for both blizzard's build in macro editor (and Ion's editor, so I know it's hookable somehow..) ... however, KayrMacro doesn't push the spellbook window... I guess I can open spellbook first, then open the macro window... kayrmacro is so wide, i'm not sure how you would address that.
Last edited by Trimble Epic : 08-18-14 at 09:25 AM.
Trimble Epic is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: