Minion Beta! - Help us test our new AddOn updater. Get it now!
Download
(19 Kb)
Download
Updated: 03-25-13 07:50 AM
Pictures
File Info
Updated:03-25-13 07:50 AM
Created:10-10-10 04:32 PM
Downloads:1,982
Favorites:19
MD5:

Paging

Version: 1.0.4
by: Teomyr [More]

For players who want to get the most out of the default action bar, the Paging addon automatically switches the primary action buttons to 10 different pages, based on customizable macro modifiers. You can, for example, change to different bars based on the target unit's reaction, or page using the Shift and CTRL keys to access more different abilities with the same set of keyboard buttons.

Since Paging uses the default Blizzard action bar, it is quick to set up ‒ there are no extra bars to fiddle around on screen, and it stays out of the way when paging is not necessary. This makes the addon ideal for players who do not want to spend time on configuring a full-blown action bar replacement, but who desire the automatic paging feature that some of them have to offer.

Quick facts

  • Automatic switching between action bar pages
  • Uses the same logic as macro conditionals ([harm], [mod:shift], etc.)
  • Can override stance-based paging, if desired
  • Profile support (can also set default profiles per realm or class)
  • Deals with keybindings automatically
  • No dependencies, requires only the default Blizzard action bar

How it works

Paging changes the action bar so that it switches the bar number depending on the current situation. You specify which page to use using a set of macro conditionals. These conditionals use the same syntax you know from e.g. the /cast command, however with page numbers instead of spell names. Like this:

[mod:shift] 6; [mod:ctrl] 5;

(This is the example profile supplied with Paging. You can use the profile selection menu in Paging's addon settings to copy it to your current profile.)

The meaning of this setting is: "While the shift key is pressed down, choose action page 6. While the control key is pressed down, choose action page 5. In all other cases, use the default action bar."
Action pages 6 and 5 are the extra bars at the lower left and lower right, respectively. You can then access their abilities using Shift-1, Shift-2, … and CTRL-1, CTRL-2, …

This was just a trivial example of Paging's functionality. While this behaviour could be replicated using key bindings, macro conditionals are far more powerful than that. They can, for example, differentiate between allied and enemy units:

[help] [mod:alt] 2;

Using this selector, whenever you target a friendly unit or press ALT, the action bar switches to the second page, where you can place your beneficial spells. The [mod:alt] is there to play nicely with the ALT selfcast offered by the default UI.

While Paging overrides your default action bar page, the page indicator to the right lights up. If you omit the page number in your selector, Paging switches back to the default action page.

Examples

Shadow Priest: Do not switch to a separate action bar while in Shadowform, keep the default one
Code:
[stance:1] 1;
Shadow Priest: Same as above, but with helpful spells/self-casting on bar 2
Code:
[help] [mod:alt] 2; [stance:1] 1;
Druid: Have healing spells on bar 1 with ALT self-casting, and show damage spells from bar 2 while not shapeshifted and targeting an enemy
Code:
[mod:alt] 1; [nostance, harm] 2;
Switch to two extra bars using SHIFT and CTRL, and also have a separate bar for friendly units and self-casting
Code:
[help] [mod:alt] 2; [mod:shift] 6; [mod:ctrl] 5;
More action bar madness: Same as above, but now has two bars for friendly units/selfcasting toggled with SHIFT
Code:
[mod:alt-shift] [mod:shift, help] 8; [mod:shift] 6; [mod:ctrl] 5; [mod:alt] [help] 2;
Reference

For a list of macro conditionals, please have a look at Wowpedia: Macro conditionals.

The mapping of action bar page numbers is as follows (adapted from Wowpedia: Action Bar and Wowpedia: Stance):
  1. Primary Action Bar
  2. Primary Action Bar
  3. Right Bar
  4. Right Bar 2
  5. Bottom Right Bar
  6. Bottom Left Bar
  7. Druid: Cat Form (Stance 3), Rogue: Stealth (Stance 1), Priest: Shadowform (Stance 1)
  8. Unused
  9. Druid: Bear Form (Stance 1)
  10. Druid: Moonkin Form (Stance 5)

For the classes not mentioned in the list, pages 7 to 10 are unused and free to be used.

You do not have to write selectors for the default stance-based paging (and you shouldn't do that either). This means that e.g. if you're a druid, don't use selectors like [stance:1] 9; [stance:3] 7; [stance:5] 10; to get the usual stance bars ‒ the default behavior already does that for you, so you only have to let it fall back to an empty selector in that case.

Tips

You should always design your modifiers so that they fall back to the default action page if no conditional matches. This is what the semicolon at the end is for: if no page number is given, it resolves to "whatever Blizzard's unmodified action bar would show".
If you forget to do this, you get an interesting, but not usually desired effect where the bar remains in the switched state even after its selector no longer applies.

In the default configuration, Paging recognizes which modifier keys your selector uses and temporarily disables any key combination that could mask this modifier and prevent it from working. For example, if your action button 1 is bound to key "1" and your selector includes [mod:ctrl], Paging will disable an existing key binding for CTRL-1 (which is normally bound to the pet bar). Using [mod:alt-lshift] will disable ALT-1, LShift-1, ALT-LShift-1, ALT-Shift-1 and Shift-1 (which is normally bound to manually switching to the first action bar). These changes are non-permanent and only affect key bindings involving your action buttons. However, if your key binding setup is more complex, you can of course choose to disable this automatic feature and handle such conflicts manually.

Normally, Paging disables itself when the default action bar would be overridden by a special bar, such as when in a vehicle, in a pet battle or while dominating another unit. The reason for this is that it might break unexpectedly if one's selector does not account for these special occasions: If a Shadow Priest were to use the [stance:1] 1; selector from the examples above, using Dominate Mind on an enemy creature would never bring up the dominated unit's actions. Paging therefore gives priority to these special bars.
If you want to tweak this behaviour, for example if you still want quick access to your own abilities while dominating some unit, you can disable this safety measure by incorporating any or all of the macro modifiers overridebar, possessbar and petbattle in your selector with a lower priority.

Feedback

If you have any issues with the addon, feel free to report them in the issue tracker on GitHub. Alternatively, you can also leave comments on WoWInterface.

Locales for the English, German and French language versions are included; localization help is greatly appreciated!

Beyond the Addon

If you find that you need more advanced features not offered by Paging, such as adding more action bars on screen, moving them or paging multiple bars at once, I suggest that you take a look at other action bar mods. Bartender4, for example, is a customization powerhouse and has been one of my long-time favorite addons. You can re-use the same modifiers as in Paging, so the transition should be seamless ‒ but, as with any addon, keep in mind that additional features require you to spend more time configuring them.

Version 1.0.4 (2013-03-25)
  • Updated for Patch 5.2
  • Fixed paging not working while an extrabar is active
Version 1.0.3 (2012-09-06)
  • Updated for Patch 5.0.4
  • Added option to copy profiles
Version 1.0.2 (2010-10-13)
  • Fixed an error occurring while changing an action button keybinding
Version 1.0.1 (2010-10-12)
  • Added French locale (thanks, Adys!)
  • Minor help text changes
Version 1.0 (2010-10-11)
  • Initial release
Optional Files (0)


Archived Files (4)
File Name
Version
Size
Author
Date
1.0.3
19kB
Teomyr
09-06-12 08:20 AM
1.0.2
11kB
Teomyr
10-13-10 02:53 PM
1.0.1
11kB
Teomyr
10-12-10 01:57 PM
1.0
11kB
Teomyr
10-10-10 04:32 PM


Post A Reply Comment Options
Unread 02-14-11, 05:40 PM  
Teomyr
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 10
Uploads: 2
Re: Is this AddOn still being updated?

Originally posted by malsudon
I love the idea of this AddOn, but have been experiencing some problems with it. I use the following header as a feral druid; ALT is my self-cast key:

[bonusbar:5] 11; [mod:alt] 1; [form:1] 9; [form:3] 7; [harm] 2; 1;

- First, sometimes the vehicle bar does not have the appropriate spells. I'll end up with one of bar 1, 2, 7, or 9's icons in the vehicle bar.
- Second, sometimes the bar 1 spells (healing spells for me) will be cast no matter what form I am in and no matter whether I am using the alt modifier. Switching forms does not clear up the issue. Only a /reload ui solves it. I haven't determined for certain if this happens sometimes after re-entering an instance after dying or is just happening upon entering combat.

I tried to debug the code myself, but found the secure state header documentation frustrating. Props for getting this far... I've made a couple changes which seem to help, although since the error above are not consistent, I'd like to do more testing. I've changed:

- Event PLAYER_LOGIN to PLAYER_ENTERING_WORLD. If it is related to deaths and resurrections, I think that may help.
- I commented out all of the OverrideBindings code. I actually think this is what is causing problem number 2. I think I understand what you had in mind with the Overrides; however, I'm not sure that you should override bindings on the frame for modifies by default. If I had ctrl-2 bound on another ActionBar and had ctrl used in the header in Paging, that strikes me as a conflict that isn't resolvable. There isn't a good way of knowing if I mean ctrl-Paged 2 or just ctrl-2 from the other actionbar.
- when using the "visibility" special case of RegisterStateDriver, I found documentation stating to use "hide" and "show" instead of "hide" and "" as you had in the AddOn.
Thanks for your comments! I'll try to address your issues

Vehicle bar not having the appropriate spells: This is very odd, because normally the Vehicle UI completely replaces the part of the interface that is affected by Paging (it uses VehicleMenuBarActionButtonX while Paging only modifies ActionButtonX and BonusActionButtonX). However it might be a taint issue (I hope it isn't...) or maybe somehow the regular action buttons remain visible and capture the key presses. Do you actually see the icons from your other bars, or does it show the normal vehicle actions but performs different actions on keypress?

Wrong spells being cast: That might be caused by the dirty tricks that Paging uses with the bonus or stance bars. I've got a development branch where Paging does not attempt to hide the bonus bar, but overrides it in the same way as it does for the main bar. This should make it less error-prone, but it hasn't been tested extensively. Would you mind downloading it to see if it fixes (or breaks) anything for you? The URL is https://github.com/teomyr/Paging/zip...ual-overriding (there was a different link mentioned below, but it's currently broken, sorry about that).

Some words of advice on your header: you appear to be mirroring the default behavior (e.g. [form:1] 9; [form:3] 7; ) instead of letting it fall back to that using an empty selector. Keep your header as simple as possible to minimize the chances for breakage (the fewer selectors, the less involved Paging is ). The empty selector resembles Blizzard's behavior, which saves you a lot of work, so it's best if you don't use "catch-all" selectors without any conditionals, like the "1;" in your header.

Try the following replacement header (I hope I understood your header correctly):
Code:
[mod:alt] 1; [nostance, harm] 2;
(In words: while pressing ALT, use bar 1 no matter in which form; when not shapeshifted and targeting an enemy, use bar 2; in all other cases, use the default bar according to the table.)

Changed event: Absolutely correct, thanks for mentioning that. Will fix that in the next release.

Override bindings: Indeed, this is a conflict that isn't easily resolved. I'm most likely going to implement a configurable option to toggle this behavior.

Visibility: Good point, though the use of "show" is to explicitly force the frame to be visible, which might not be the case with an empty value. It's one of these crude hacks I mentioned above (In fact, the dual-overriding branch does no longer use it.)

Again, thanks for your comments; I'm not playing much at the moment, so feedback is the only way I'll notice these things.
Teomyr is offline Report comment to moderator  
Reply With Quote
Unread 05-10-12, 11:16 AM  
wootbeans
A Kobold Labourer

Forum posts: 0
File comments: 1
Uploads: 0
Thank you for making this addon. I had a similar idea that I was going to make myself, but the function to change pages can't be used in combat so that makes it a lot more complicated.
wootbeans is offline Report comment to moderator  
Reply With Quote
Unread 08-22-12, 11:47 AM  
Ygrayne
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
MoP Version?

Thank you for that utterly useful add-on! No bloat, just works...

Any hopes to get an updated version for MoP?

-- Ygrayne
Ygrayne is offline Report comment to moderator  
Reply With Quote
Unread 09-02-12, 03:04 PM  
Teomyr
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 10
Uploads: 2
Re: MoP Version?

Originally Posted by Ygrayne
Thank you for that utterly useful add-on! No bloat, just works...

Any hopes to get an updated version for MoP?

-- Ygrayne
Glad you like it If you're feeling brave, you can try the development version (ZIP), which I just updated for 5.0.4. Please report back if it works for you or not (I'm not actively playing right now, so this is the only way I get to know about possible issues).

Apparently, Blizzard has gotten rid of the former "bonus action bar" that was overlaid when entering a stance. I have updated the code to reflect this, but I can only really test it on a starter account, and I'm not sure if there are other changes that I missed.
Teomyr is offline Report comment to moderator  
Reply With Quote
Unread 09-03-12, 10:16 AM  
Ygrayne
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
Re: MoP Version?

Originally Posted by Teomyr
Originally Posted by Ygrayne
Thank you for that utterly useful add-on! No bloat, just works...

Any hopes to get an updated version for MoP?

-- Ygrayne
Glad you like it If you're feeling brave, you can try the development version (ZIP), which I just updated for 5.0.4. Please report back if it works for you or not (I'm not actively playing right now, so this is the only way I get to know about possible issues).

Apparently, Blizzard has gotten rid of the former "bonus action bar" that was overlaid when entering a stance. I have updated the code to reflect this, but I can only really test it on a starter account, and I'm not sure if there are other changes that I missed.
Works as intended up to now -- but I'll need to test more thoroughly in real combat situations. Thanks a lot, you made my day!
-- Ygrayne
Ygrayne is offline Report comment to moderator  
Reply With Quote
Unread 10-16-12, 08:30 AM  
nKweo
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
I like this addon a lot, but I have run into a small issue: whenever the extra action button pops up (which happens quite often nowadays), my script doesn't work (no errors whatsoever, just no reaction). I'm running a very simple script: [mod:alt]5; . I would appreciate it if you could look into this matter and thanks for a great addon!
nKweo is offline Report comment to moderator  
Reply With Quote
Unread 10-29-12, 10:32 AM  
Teomyr
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 10
Uploads: 2
Originally Posted by nKweo
I like this addon a lot, but I have run into a small issue: whenever the extra action button pops up (which happens quite often nowadays), my script doesn't work (no errors whatsoever, just no reaction). I'm running a very simple script: [mod:alt]5; . I would appreciate it if you could look into this matter and thanks for a great addon!
Could you elaborate on what you mean by "extra bar"?
Paging takes a safety measure to make sure it does not accidentally overwrite vehicle or "possessed" action bars (it could be disastrous if you were in a boss fight that requires you to use such an action bar, and Paging would always show bar 1 because you're using a stance-based selector).
Your ALT-based selector should be fine however, so you can disable this safety measure. Just add [overridebar], [extrabar], [possessbar] and/or [petbattle] at the end of your modifier. I think this would be appropriate in your case:
Code:
[mod:alt]5;[overridebar][extrabar];
Let me know if this fixed the problem or if there's some other issue.
Teomyr is offline Report comment to moderator  
Reply With Quote
Unread 10-31-12, 05:35 AM  
nKweo
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
Thanks for your response. This video http://www.youtube.com/watch?v=SNdkWOhpX6g (at 0:26) should clarify what I mean by 'extra action button'. I will try out the [extrabar] modifier.
nKweo is offline Report comment to moderator  
Reply With Quote
Unread 11-01-12, 03:05 PM  
Teomyr
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 10
Uploads: 2
Originally Posted by nKweo
Thanks for your response. This video http://www.youtube.com/watch?v=SNdkWOhpX6g (at 0:26) should clarify what I mean by 'extra action button'. I will try out the [extrabar] modifier.
Interesting! I've never seen that bar before, but then again, I'm not actively playing at the moment
Please let me know if adding [extrabar] fixes it for you so that I can remove it from the safety checks.
Teomyr is offline Report comment to moderator  
Reply With Quote
Unread 01-17-13, 04:02 PM  
garak8402
A Kobold Labourer

Forum posts: 0
File comments: 8
Uploads: 0
extrabar

Im having the same issue as nKweo. Ive been using a razer naga with shift alt and ctrl to hotkey for a while now, so when I seen this I was eager to give it a try since Id only need one main bar on my screen.

The first macro I added [mod:alt]6;[extrabar]; WILL work in areas where the extra action bar appears. Another example of this is a Klaxxi you can recruit to assist you on daily quests, the Extrabar is present in the Dread Wastes and goes away after you leave the zone. So after I added my next two macros [mod:shift]5;[extrabar]; and [mod:ctrl]3;[extrabar]; I'm unable to use them in the Dread Wastes, and only my first added macro will work (alt6) while the extrabar is up. All three of those macros will work though, in areas where there is no Extrabar. I used the "overridebar" and "possessbar" in all of them too and get the same result. I tried this with NO addons running as well.

Im not a heavy macro user so Im not sure what the issue here can be, other than some changes made to the code. And as nKweo stated the extrabar does appear quite often now in Mop, even in raids. Anyway, just thought Id put this out there to see if a fix can be made, or if by chance I did something wrong. I'd really love to use this
garak8402 is offline Report comment to moderator  
Reply With Quote
Unread 01-29-13, 04:57 PM  
Teomyr
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 10
Uploads: 2
I have changed the behaviour regarding [extrabar] in the development version. I'm waiting for Patch 5.2 to release it; in the meantime, could you download the following revision and check if it fixes the issue?
With this revision, you shouldn’t need to explicitly add this modifier any more.

17f53fcaf3 Retain paging while [extrabar] is active
Last edited by Teomyr : 01-29-13 at 05:01 PM.
Teomyr is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: