Download
(374 Kb)
Download
Updated: 07-23-14 09:55 PM
Pictures
File Info
Compatibility:
Warlords of Draenor (6.0)
Siege of Orgrimmar (5.4)
Updated:07-23-14 09:55 PM
Created:06-11-14 07:52 PM
Downloads:719
Favorites:26
MD5:
Categories:Utility Mods, Action Bar Mods, Combat Mods, Warlords of Draenor Beta, Beta-version AddOns
5.4
KayrMacro - Advanced Macros and Expanded Storage  Updated less than 3 days ago!
Version: 0.3.6 (Public Alpha)(WoD Beta Compatible)
by: Kvalyr [More]
================================================================
= KayrMacro - Advanced Macros Addon for World of Warcraft
= Copyright (c) Kvalyr - 2014 - All Rights Reserved
================================

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

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.

Compatible with Warlords of Draenor Beta

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>"


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

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
+ User-defined sub-macros

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

================
Credits/Contact:
=======
Contact Email: wowaddons@kvalyr.com
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:
=======
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: [classPLAYERCLASS)], [namePLAYERNAME)], [factionPLAYERFACTION)], [pvp],
[realmPLAYERREALM)], [sexPLAYERSEX)], [racePLAYERRACE)]
- 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

================================================================
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 (7)
File Name
Version
Size
Author
Date
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
Old 07-21-14, 02:36 PM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Originally Posted by vikkyne
Simply not able to get the game to consistently load with versions 0.3.3.1 and upward. Not in beta, so I did go back to 0.3.3.1 to see if that might solve the issue, but no. Reloads (and sometimes fresh loading of the game) balk and freeze at about 95% on the loading bar.
Can you clarify this? Are you playing Beta or on live realms? I'm using 0.3.5 on both live realms and beta without issues currently so I'll need more information to nail down why you're having problems.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-21-14, 02:21 PM  
vikkyne
A Murloc Raider

Forum posts: 4
File comments: 88
Uploads: 0
Simply not able to get the game to consistently load with versions 0.3.3.1 and upward. Not in beta, so I did go back to 0.3.3.1 to see if that might solve the issue, but no. Reloads (and sometimes fresh loading of the game) balk and freeze at about 95% on the loading bar.
vikkyne is offline Report comment to moderator  
Reply With Quote
Old 07-18-14, 05:11 PM  
sandoog
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
works great

now its working thanks for ur support
sandoog is offline Report comment to moderator  
Reply With Quote
Old 07-18-14, 09:12 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Re: Addon crash the game WoD

Originally Posted by sandoog
as soon as i log into the character wow crash
WoD 18566 build
WoD Beta seems to be unstable in some of its Lua API code. I've uploaded a new version with a workaround to avoid this issue. The updated version (0.3.3.1) should be available soon, once approved by WoWInterface.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-18-14, 03:45 AM  
sandoog
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
Addon crash the game WoD

as soon as i log into the character wow crash
WoD 18566 build

Last edited by sandoog : 07-18-14 at 03:54 AM.
sandoog is offline Report comment to moderator  
Reply With Quote
Old 07-18-14, 01:11 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Originally Posted by Qlix
I cant seem to close the KayrMacro window. In the description it says I can utilize Kayr or not, that the default UI remains untouched. Yet I cannot create macros while the KayrMacro window is up.
Just to respond to this as well: Why do you say that you cannot create macros while the KM window is up?
KM does nothing to prevent creation of normal macros.

The only reason that you might not be able to create new macros is if you have run out of macro space; and KM won't cause that on its own.
Last edited by Kvalyr : 07-18-14 at 01:11 AM.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-10-14, 02:39 PM  
Qlix
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
Originally Posted by Kvalyr
Originally Posted by Qlix
I cant seem to close the KayrMacro window. In the description it says I can utilize Kayr or not, that the default UI remains untouched. Yet I cannot create macros while the KayrMacro window is up. And i cant close it, without closing the default window. Also, are there supposed to be options?
The KM window can't be closed at the moment because I haven't implemented a button to re-open it yet. I'll try to include that in the next release!

Options haven't been implemented yet either, but are on the way.
thank you for the quick response
Qlix is offline Report comment to moderator  
Reply With Quote
Old 07-10-14, 12:08 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Originally Posted by Qlix
I cant seem to close the KayrMacro window. In the description it says I can utilize Kayr or not, that the default UI remains untouched. Yet I cannot create macros while the KayrMacro window is up. And i cant close it, without closing the default window. Also, are there supposed to be options?
The KM window can't be closed at the moment because I haven't implemented a button to re-open it yet. I'll try to include that in the next release!

Options haven't been implemented yet either, but are on the way.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-09-14, 09:20 PM  
Qlix
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
I cant seem to close the KayrMacro window. In the description it says I can utilize Kayr or not, that the default UI remains untouched. Yet I cannot create macros while the KayrMacro window is up. And i cant close it, without closing the default window. Also, are there supposed to be options?
Qlix is offline Report comment to moderator  
Reply With Quote
Old 07-07-14, 01:57 PM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Originally Posted by Qlix
Ok this is the part that made me think "working as intended". My thought was that active stayed tic'd to modify the macro, untick it when youre done and ready to use. Thanks!

edit: ok i see whats happening, and i understand why it needs to remain tic'd. Basically, without active tic'd, its not changing the macro to the spec specific version. I didnt realize the addon was actually changing the macros altogether. Thats awesome though. opens up possibilities!
Exactly! Any macro marked as 'active' is continuously updated and rewritten by KM according to changes in spec, inventory, etc. I might have to make that clearer in the addon's description, I doubt you're the only person who thought that!

Glad it's working for you.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-07-14, 11:28 AM  
Qlix
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
Originally Posted by Kvalyr
Why are you unticking 'active'? Active should remain ticked for the macro to update itself continuously. If you're deactivating the macro then it won't update itself repeatedly nor in response to things like spec changes or logging in/out so that might explain it. I may have misunderstood your meaning though.
ok this is the part that made me think "working as intended". My thought was that active stayed tic'd to modify the macro, untick it when youre done and ready to use. Thanks!

edit: ok i see whats happening, and i understand why it needs to remain tic'd. Basically, without active tic'd, its not changing the macro to the spec specific version. I didnt realize the addon was actually changing the macros altogether. Thats awesome though. opens up possibilities!
Last edited by Qlix : 07-07-14 at 12:02 PM.
Qlix is offline Report comment to moderator  
Reply With Quote
Old 07-07-14, 07:54 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Originally Posted by Qlix
I dont see a way to share macros to guild/channel/player/etc. Most other macro addons have this function, though I understand these macros would require the use of your addon to function properly.
No, it doesn't include that feature and I don't currently have any plans for it. I can see the value of it and if a lot of people request it I can consider it in the future, but my plan is to focus on what I feel are the most useful/desirable features first.

Personally, any time I've ever shared a macro with someone it's been in an IM window or via a link to a website. For the work it would take to implement, I think my time would be better spent on other more useful features.
Not ruling it out, of course - Just that it's far down the priority list unless people really, really want it.

Originally Posted by Qlix
Also I think Ive found a bug. Though it may be working as intended if so, disregard. (actually now after testing a bit i dont think its intended, but somewhat corrected itself).

Basically whats happening is when i create a macro intended for 1 class that changes with spec, after I log out, log back in, the macro no longer works for the intended spec, that is until i go into the interface, tick active, untic it, and continue on with play. Happens with a couple of macros that Ive done like this. In the macro below Frost Strike is "Question Marked" and doesnt fire, but everything else works (other than blood/unholy abilities obviously).Macro example below:
Thanks for the detailed report! In testing I'm not able to replicate the behaviour that you're describing, though.
This part:
that is until i go into the interface, tick active, untic it, and continue on with play
-Confuses me a little though.

Why are you unticking 'active'? Active should remain ticked for the macro to update itself continuously. If you're deactivating the macro then it won't update itself repeatedly nor in response to things like spec changes or logging in/out so that might explain it. I may have misunderstood your meaning though.
Last edited by Kvalyr : 07-07-14 at 08:32 AM.
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-06-14, 10:11 PM  
Qlix
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
I dont see a way to share macros to guild/channel/player/etc. Most other macro addons have this function, though I understand these macros would require the use of your addon to function properly.

Also I think Ive found a bug. Though it may be working as intended if so, disregard. (actually now after testing a bit i dont think its intended, but somewhat corrected itself).

Basically whats happening is when i create a macro intended for 1 class that changes with spec, after I log out, log back in, the macro no longer works for the intended spec, that is until i go into the interface, tick active, untic it, and continue on with play. Happens with a couple of macros that Ive done like this. In the macro below Frost Strike is "Question Marked" and doesnt fire, but everything else works (other than blood/unholy abilities obviously).Macro example below:

Code:
#showtooltip
/cast
    [mod:alt,@mouseover,exists,harm,nodead]Mind Freeze;
    [mod:alt]Mind Freeze;
    [mod:ctrl]Death Coil;
/cast
    [spec:Blood]Heart Strike;
    [spec:Frost]Frost Strike;
    [spec:Unholy]Scourge Strike;
/cast
    Anti-Magic Shell;
/cast
    [spec:Blood]Blood Tap
/targetenemy
    [@target, noexists][help]
Last edited by Qlix : 07-06-14 at 10:11 PM.
Qlix is offline Report comment to moderator  
Reply With Quote
Old 07-05-14, 09:15 AM  
Kvalyr
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 14
Uploads: 4
Re: thank you....... so much.

Originally Posted by Qlix
Made an account just to say thanks. Ive been using just about every other macro addon available and none of them have satisfied me. Thank you. Seriously.
Glad to be of service!

If you have any suggestions on how it could be improved, they'd be very welcome!
Kvalyr is offline Report comment to moderator  
Reply With Quote
Old 07-05-14, 12:42 AM  
Qlix
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
thank you....... so much.

Made an account just to say thanks. Ive been using just about every other macro addon available and none of them have satisfied me. Thank you. Seriously.
Qlix is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: