WoW MessageQueue addon Dragonflight/Wrath of the Lich King Classic 2024
wow addon MessageQueue


Game Version: 10.0.5 +3
Total Downloads: 45,436
Updated: Jan 25, 2023
Created: Jan 12, 2020
download MessageQueueDownload Earlier Versions

Earlier Versions

Name Size Uploaded Game Version Downloads
MessageQueue 0.5.7 release 18.46 KB Jan 25, 2023 10.0.5 +3 4,636 download MessageQueue MessageQueue 0.5.7 releaseDownload
MessageQueue 0.5.6 release 18.46 KB Nov 27, 2022 10.0.2 +3 3,875 download MessageQueue MessageQueue 0.5.6 releaseDownload
MessageQueue 0.5.5 release 18.44 KB Oct 26, 2022 10.0.0 +3 1,216 download MessageQueue MessageQueue 0.5.5 releaseDownload
MessageQueue 0.5.4 release 18.37 KB Oct 25, 2022 10.0.0 +3 1,582 download MessageQueue MessageQueue 0.5.4 releaseDownload
MessageQueue 0.5.3 release 18.36 KB Oct 6, 2022 9.2.7 +3 1,838 download MessageQueue MessageQueue 0.5.3 releaseDownload
MessageQueue 0.5.2 release 18.32 KB Aug 16, 2022 9.2.7 +3 2,310 download MessageQueue MessageQueue 0.5.2 releaseDownload
MessageQueue 0.5.1 release 17.94 KB Feb 22, 2022 9.2.0 +2 2,778 download MessageQueue MessageQueue 0.5.1 releaseDownload
MessageQueue 0.5.0 release 17.91 KB Dec 22, 2021 1.14.1 +2 1,794 download MessageQueue MessageQueue 0.5.0 releaseDownload
MessageQueue 0.4.0 release 17.54 KB Dec 2, 2021 1.14.1 +2 1,048 download MessageQueue MessageQueue 0.4.0 releaseDownload
MessageQueue 0.3.1 release 17.40 KB Nov 4, 2021 1.14.0 +2 1,180 download MessageQueue MessageQueue 0.3.1 releaseDownload
MessageQueue 0.3.1 release 17.43 KB Nov 4, 2021 1.14.0 +2 100 download MessageQueue MessageQueue 0.3.1 releaseDownload
MessageQueue 0.3.0 release 17.13 KB May 20, 2021 1.13.7 +2 2,991 download MessageQueue MessageQueue 0.3.0 releaseDownload
MessageQueue 0.2.0 release 16.52 KB Mar 27, 2021 9.0.5 3,717 download MessageQueue MessageQueue 0.2.0 releaseDownload
MessageQueue 0.1.4 release 16.45 KB Mar 10, 2021 9.0.5 2,162 download MessageQueue MessageQueue 0.1.4 releaseDownload
MessageQueue 0.1.3 release 16.46 KB Nov 19, 2020 9.0.2 3,778 download MessageQueue MessageQueue 0.1.3 releaseDownload
MessageQueue 0.1.2 release 16.45 KB Oct 12, 2020 9.0.1 +1 1,272 download MessageQueue MessageQueue 0.1.2 releaseDownload
MessageQueue 0.1.1 release 16.44 KB Jan 14, 2020 8.3.0 +1 2,122 download MessageQueue MessageQueue 0.1.1 releaseDownload
MessageQueue 0.1 release 16.48 KB Jan 13, 2020 8.2.5 +1 7,014 download MessageQueue MessageQueue 0.1 releaseDownload


Share this:


Implements an alternative to SendChatMessage() to securely send messages in chat channels in response to a hardware event such as a mouse click or a keypress.

How it works

Use MessageQueue.SendChatMessage() in your add-ons and macros to send chat messages instead of SendChatMessage(). MessageQueue will then wait for a hardware event to send the message. A callback that will be executed after the message has been sent can also be provided so you can write your code in an asynchronous way.

Any of the following hardware inputs allows the queue to run: mouse click, mouse wheel, keyboard, gamepad stick or button. Unlike keyboard inputs, mouse and gamepad inputs are consumed by an invisible frame that shows up at the topmost level so any click on an action may fail if MessageQueue needs to send a message at the same time.

Use with AutoHotKey

MessageQueue can be used in conjunction with AutoHotkey and the provided PixelTrigger.ahk script to automatically send hardware events to the World of Warcraft window when needed.

The script monitors the color of the top left pixel of the WoW window and sends a keypress on the PAUSE key every time the pixel turns gray (#333333). The WoW window doesn’t need to be active but the top left corner should remain visible on the screen and not be covered by another window for the script to work.

The AutoHotKey script only works on Windows. If you’re running MessageQueue on Mac, you’ll need to trigger your hardware event manually.

If you wish to use another hardware event than the PAUSE key, make a copy of the PixelTrigger.ahk script and edit it accordingly (instructions are provided within the script comments). Make sure to keep your copy of the script out of the add-on folder since it could be automatically deleted if you use an add-on manager.

Please be aware that the use of AutoHotkey is not against Blizzard’s ToS and you won’t get banned for just using it along with WoW. It’s commonly used by players with disabilities. Only obvious abuse such as spamming or automating complex actions can get you banned. Do not use any other script than the provided PixelTrigger.ahk unless you know what you’re doing. Anyway, the use of AutoHotKey and the provided script is not mandatory for MessageQueue to work, it just adds convenience.

API documentation


MessageQueue.SendChatMessage("msg" [,"chatType" [,languageID [,"target" [, "callback"]]]])

Add a message to the queue if the target requires a hardware event (chatType is either “SAY”, “YELL” or “CHANNEL”). For any other chatType, the message is sent instantly.

Arguments are the same as the regular SendChatMessage function.

The optional callback function will be executed when the message has been sent. The callback should not contain any other code requiring a hardware event.



Enqueue a function that requires a hardware event to run. The function may not perform more than one action requiring a hardware event.

Shares the same queue as MessageQueue.SendChatMessage().


messageCount = MessageQueue.GetNumPendingMessages()

Returns the number of messages awaiting in the queue.



Runs the first message awaiting in queue. Should only be called in response to a hardware event. If for some reason the message fails, it won’t be possible to attempt it again.

Integration guide

The integration of MessageQueue in your add-on is pretty straightforward.

First, add MessageQueue as a required dependency for your add-on by adding the following in the .toc file:
## RequiredDeps: MessageQueue

Then, just replace SendChatMessage() calls by MessageQueue.SendChatMessage().

However, keep in mind that the message will not be sent instantly (for example if the World of Warcraft window is not in focus). If the rest of your code requires the message to be actually sent, you should pause the execution of the current process then resume it in the callback.

SendChatMessage(text, 'SAY')
-- Do stuff

MessageQueue.SendChatMessage(text, 'SAY', nil, nil, function()
-- Do stuff
-- Resume process execution
-- Pause process execution

The functions MessageQueue.Enqueue and MessageQueue.Run can be hooked using hooksecurefunc() by your add-on to perform actions when an element has been added or removed from the queue.


Add a comment