This is a mod to make swapping trinkets easier. It will display your two equipped trinkets in a bar. Mouseover on either trinket will display a menu of up to 30 trinkets in your bags to swap.
__ New in 3.8 __
- Scaling now done via sliders in options
- Updated for 3.0 client
- Removed obsolete buff cache system
- Auto swaps while casting wait until done casting
__ New in 3.72 __
- Key bindings now done in default UI key binding interface (hit ESC to Game Menu->Key Bindings and scroll to bottom)
__ New in 3.71 __
- Fix for upcoming 2.4.2 patch
__ New in 3.7 __
- Support for engineering bags. If you have an engineering bag in use, engineered trinkets will go there if space permits, and normal trinkets will only use normal bags.
- Trinkets that leave a buff no longer need a delay defined. It will detect what buff an item grants and keep the item equipped for as long as you have that buff. You can still use a delay if you want, for trinkets that don't give a buff (ie, Prismcharm) or have special needs.
- Removed obsolete help frame about the delay.
Swapping/Using trinkets
Left click a trinket in the menu to equip it to the top trinket slot.
Right click a trinket in the menu to equip it to the bottom trinket slot.
Left or Right click either trinket to use them. Or make a key binding for either trinket.
Auto Queue
3.0 introduces auto trinket queues to TrinketMenu. In options you can sort a trinket slot to the order you want trinkets equipped, turn on Auto Queue for that slot (Alt+Click the trinket on the bar or check the tab in options), and the mod will automatically swap trinkets as they're used and come off cooldown.
It was (hopefully) made to be intuitive enough to use without instructions, but if wondering about specifics:
The auto queue rules are:
A trinket at 30 seconds or less cooldown is considered off cooldown.
If the currently equipped trinket is on cooldown, swap to the first available trinket not on cooldown.
If the currently equipped trinket cannot go on cooldown (passive trinkets), equip a higher ranking trinket when it comes off cooldown.
If the currently equipped trinket is ready for use, then do nothing unless a higher-ranked trinket marked 'Priority' is waiting to swap in.
If a trinket has a 'Delay' defined, then hold that trinket for its delay before swapping it out. (ie, Earthstrike for 20 seconds)
Auto queue icon colors:
A gold gear on a trinket means that auto queue is active for that slot.
A grey gear on a trinket means the equipped trinket has a delay defined and is waiting to swap out.
A red gear on a trinket means the equipped trinket is flagged 'Pause Queue' and auto queue is suspended.
Other auto queue notes:
If you use some mod to automatically swap in passive trinkets (Carrot on a Stick or Argent Dawn Commission), flag those trinkets 'Pause Queue' to suspend the queue while they're equipped.
Swapping to a passive trinket manually in TrinketMenu will stop the auto queue for that slot. Alt+click the slot to turn auto queue back on.
A purely passive trinket will mark the natural end of a queue. If you would like the queue to stop sooner (ie, Burst of Knowledge as bottom-most trinket even on cooldown), move the "-- stop queue here--" mark to where you want the queue to stop.
The auto queues work independently of the "trinket ready!" notifications.
Trinkets attempting to swap during combat or while dead will queue for when you drop out of combat or return to life.
If you don't want to use auto queue and would like to remove it completely, you can delete TrinketMenuQueue.xml and TrinketMenuQueue.lua while out of game. The remaining mod will be about the size of TrinketMenu 2.7 and run better than 2.7.
Auto Queue Shared Timers
Keep in mind as you set up your queues that many trinkets trigger shared cooldown timers. As an example:
Trinket 0 contains a Cannonball Runner not on cooldown
Trinket 1 contains a Diamond Flask not on cooldown
When you click Diamond Flask, it will put the Cannonball Runner into a 60-second cooldown. TrinketMenu will then look for something more available for Trinket 0, and then 30 seconds later as the Cannonball Runner comes off cooldown it will swap it back in.
This is expected behavior. If it seems like this happens a lot, you may want to Auto Queue only one trinket slot, until you get trinkets that can be used without triggering the other's cooldown.
Customizing Display
The main and menu windows are independently scalable and rotatable. While the windows are unlocked:
Move either window by dragging its edge.
Rotate either window by right-clicking its edge.
Scale/resize either window by dragging the lower-right corner to the desired size.
If you're having problems grabbing the edge of the menu window to move/rotate/resize it, hold Shift down while it's open and the menu won't go away when the mouse leaves the menu's edge.
If you right-click the gear icon around the minimap (or /trinket options) a small options window will appear under the minimap. Here you can customize the display further by showing cooldowns as numbers and keeping the menu always open.
Once you're settled on a setup you like, you can lock the windows in options.
To set an exact scale (optional):
/trinket scale main n : Scale the main window to n
/trinket scale menu n : Scale the menu window to n
ie: /trinket scale menu 0.85
-- see readme.txt for much more info --
Optional Files - Trinket Menu
Sorry, there are currently no optional files available.
A minor change that should be made in my opinion. The TrinketMenu_MainFrame's Anchor point should be Center, and the RelativeTo point should also be Center.
This allows you to move it off the screen a little (in my case, I have it along the bottom edge of the screen, and before it would not allow me to move it below the edge, and it didn't line up withe verything else.)
This is one of the best addons ive downloaded in a long while! As an engineer I was having a horrible time switching my trinkets, but this made everything so much easier, thanks so much!!
Only the latter trinket button is displaying. My first trinket is not passive. Do you know what could be causing this? It's probably something really obvious.
I really can't get to bind any key.
At first it would display a LUA error message, but when trying again and again, the key binding window appears, but pressing a key doesn't do anything.
Is there a way to fix this?
Or to manually bind keys through a setting file?
Thanks.
i only experience problems when switching display resolutions (switching between notebook and monitor display, widescreen to normal). then the gui gets broken and i can't use or move the buttons. sometimes i can fix this by going to the menu and scaling around, which somehow seems to reset or recalculate some parameters. maybe this could be done more often, so on initial loading for example.
I'd like to edit the space between the buttons so I can line it up with some other bars in my UI. Can someone show me where in the lua I might be able to do this? I have zero experience editing lua...
I'll ++ buttonfacade support as well.
Great mod though, I've been using it for years and I love it.
When a character has a large number of trinkets, and the user attempts to scroll among them in the top or bottom priority arrangement tab, the window does not scroll past the first-displayed trinket at the bottom of the list. When scrolling is attempted, this error is thrown:
Error: attempt to index local 'self' (a number value)
File: Interface\FrameXML\UIPanelTemplates.lua
Line: 230
Count: 20
To the extent that trinkets can be prioritized given the bug described above, swapping and autoswapping are performed as well as on the 2.4.3 patch on the retail servers.
A small change that would help very much is for the popup trinket selection display to be "top" strata so that other UI elements do not get in the way while a trinket is being chosen to be equipped.
Terrific addon that i couldn't live without! Thank you for creating and maintaining it.
