Download
(378Kb)
Download
Updated: 06-19-15 09:01 AM
Pictures
File Info
Compatibility:
The Adventure Continues (6.1)
Warlords of Draenor (6.0.3)
Warlords of Draenor Pre-Patch (6.0.2)
Updated:06-19-15 09:01 AM
Created:06-11-14 07:52 PM
Downloads:12,076
Favorites:70
MD5:
Categories:Utility Mods, Action Bar Mods, Combat Mods, Graphic UI Mods, Beta-version AddOns

KayrMacro - Advanced Macros and Expanded Storage  Popular! (More than 5000 hits)

Version: 0.4.6.1 (Public Alpha)
by: Kvalyr [More]

================================================================
= KayrMacro - Advanced Macros Addon for World of Warcraft
= Copyright (c) Kvalyr - 2015 - 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!

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
* 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 2015 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.6.1
- Fixed MacroFrame not responding immediately to changes to KMacros
- Updated TOC to 60100
- Fixed catform variable (was wrong number)
- Minor cleanups & bugfixes

0.4.6
- Significant further optimization using KLib Async Threads
- Infinite-length macros disabled by default until the feature has been properly fleshed-out.
Use the following command (without quotes) to enable Long Macros again: '/script KayrMacro.cfgScheme:Set(false, "LongMacros")' (This is NOT supported currently)

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
Post A Reply Comment Options
Unread 12-10-15, 12:54 PM  
Noradin
A Kobold Labourer

Forum posts: 0
File comments: 6
Uploads: 0
This addon seems to constantly forget which macros are activated on my druid.

Also, is it possible to add some functionality to use some of the macro-options for whole chunks of code that would get switched out of combat?
Something like this: <<[spec:1]||code for spec 1||alternative code>>

Addtionally, I often find myself missing something like this: "[known:Spell,]Spell" which would translate to "[]Spell" instead of the ususal "[known:Spell]Spell" -> "Spell".

An example for this being useful:

/use [known:Heal,alt,@player][known:Heal,]Heal;[alt,@player][]Tiny Heal

Which would turn into

/use [mod:alt,@player][]Heal;[mod:alt,@player][]Tiny Heal

if Heal is known, and

/use [mod:alt,@player][]Tiny Heal

otherwise.
Report comment to moderator  
Reply With Quote
Unread 10-30-15, 10:23 AM  
Noradin
A Kobold Labourer

Forum posts: 0
File comments: 6
Uploads: 0
There should be no reason to ever use "/cast" in a condensed macro, should there?
After all "/use" is the very same thing and is shorter, since some (read all) spellnames translated from English into other languages always end up being ridiculously long and intricate every single letter counts.

Making marcos support spell IDs would be even better (because sometimes tanslations present you with multiple spells of the same name available at the same time), but one step at a time xD
Last edited by Noradin : 10-30-15 at 10:23 AM.
Report comment to moderator  
Reply With Quote
Unread 08-03-15, 09:05 AM  
ctrlaltdeny
A Murloc Raider

Forum posts: 9
File comments: 1
Uploads: 0
Please add an icon search function, I like to assign icons to my moves to make it more unique to me. This addon lacks that, look to Macro Toolkit for an example of this.
Report comment to moderator  
Reply With Quote
Unread 06-15-15, 07:42 PM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 31
Uploads: 8
0.4.6 has been uploaded and will be available soon (pending WoWInterface moderation).

It's just a maintenance update to keep the addon vaguely up to date, but it also brings some substantial performance improvements and some minor bugfixes.

Infinite-length macros have been disabled by default until the feature has been properly fleshed-out.
Though it is NOT SUPPORTED (Meaning: Don't complain if it doesn't work), you can use the following chat command (with KayrMacro loaded and enabled) to enable Long Macros again:
Code:
/script KayrMacro.cfgScheme:Set(true, "LongMacros")
(Again: This is NOT supported currently - No need to submit bug reports involving this feature, it's a Work-in-progress)
Last edited by Kvalyr : 06-15-15 at 07:52 PM.
Report comment to moderator  
Reply With Quote
Unread 11-20-14, 02:56 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 31
Uploads: 8
Originally Posted by Oakenwynd
I have an issue. When I get in combat, the kmacro I've selected to active, and placed on my bars vanishes from my macros slot and off my bars. Then when I get out of combat, it reappears in my macros pane.
That sounds strange - Are you certain that your bars aren't paging (if you're using an actionbar addon such as Bartender) ?
If you can post the contents of the macro itself and the settings chosen for it as well, that would make it easier for me to diagnose the issue.

I hope to get back to working on this addon next week, RL is quite busy right now.
Last edited by Kvalyr : 11-20-14 at 02:56 AM.
Report comment to moderator  
Reply With Quote
Unread 11-16-14, 12:44 AM  
Oakenwynd
A Kobold Labourer

Forum posts: 1
File comments: 39
Uploads: 0
I have an issue. When I get in combat, the kmacro I've selected to active, and placed on my bars vanishes from my macros slot and off my bars. Then when I get out of combat, it reappears in my macros pane.
Report comment to moderator  
Reply With Quote
Unread 11-13-14, 01:15 PM  
Oakenwynd
A Kobold Labourer

Forum posts: 1
File comments: 39
Uploads: 0
Really looking forward to the progression of this Addon. Amazing job!
Report comment to moderator  
Reply With Quote
Unread 10-19-14, 03:41 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 31
Uploads: 8
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.
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: 55
File comments: 138
Uploads: 3
Keep up the great work, love the addon
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: 75
Uploads: 2
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?
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: 31
Uploads: 8
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.
Report comment to moderator  
Reply With Quote
Unread 10-18-14, 05:49 AM  
infinityz
A Kobold Labourer

Forum posts: 0
File comments: 9
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?
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: 31
Uploads: 8
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.
Report comment to moderator  
Reply With Quote
Unread 09-23-14, 10:40 AM  
wolfi
A Kobold Labourer

Forum posts: 1
File comments: 13
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. ^^
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: 31
Uploads: 8
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™.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: