AzerothCore support

.gitignore

@@ -1 +1,2 @@
 .idea/
+.vscode/

Core/ChatMessageObserver/Bootstrap.lua

@@ -0,0 +1,14 @@
+local defaultInGameChatEventHandler = ChatFrame_MessageEventHandler;
+local function ourChatEventHandler(self, event, message, ...)
+    local response = nil;
+    if event == "CHAT_MSG_SYSTEM" then
+        response = GMGenie.ChatMessagePublisher.publishSystemMessage(message);
+    end
+
+    if not response or not response.stopPropagation then
+        defaultInGameChatEventHandler(self, event, message, ...);
+    end
+end
+
+-- Hacky, but by doing it this way propagation of messages to the in-game chat can be controlled.
+ChatFrame_MessageEventHandler = ourChatEventHandler;

Core/ChatMessageObserver/Publisher.lua

@@ -0,0 +1,45 @@
+local ChatMessagePublisher = {
+    --- @type table<string, ChatMessageSubscriber[]>
+    subscribersByKey = {},
+}
+
+GMGenie.ChatMessagePublisher = ChatMessagePublisher;
+
+--- Subscribe to chat messages, to read command responses and act on them.
+--- @param subscriptionKey string Several subscribers can share a key. If one unsubscribes, all are unsubscribed.
+--- @param subscriber ChatMessageSubscriber
+function ChatMessagePublisher.subscribe(subscriptionKey, subscriber)
+    GMGenie.printDebugMessage("Subscribed: " .. subscriptionKey);
+
+    if not ChatMessagePublisher.subscribersByKey[subscriptionKey] then
+        ChatMessagePublisher.subscribersByKey[subscriptionKey] = {};
+    end
+    table.insert(ChatMessagePublisher.subscribersByKey[subscriptionKey], subscriber);
+end
+
+--- Unsubscribe from chat messages, when all required information has been gathered.
+--- @param subscriptionKey string
+function ChatMessagePublisher.unsubscribe(subscriptionKey)
+    GMGenie.printDebugMessage("Unsubscribed: " .. subscriptionKey);
+    ChatMessagePublisher.subscribersByKey[subscriptionKey] = {};
+end
+
+--- @param message string
+--- @return ChatMessageSubscriberResponse
+--- @internal
+function ChatMessagePublisher.publishSystemMessage(message)
+    for subscriptionKey, subscribers in pairs(ChatMessagePublisher.subscribersByKey) do
+        for _, subscriber in ipairs(subscribers) do
+            local response;
+            if subscriber.onSystemMessage then
+                response = subscriber.onSystemMessage(message);
+            end
+
+            if response.stopPropagation then
+                return {stopPropagation = true};
+            end
+        end
+    end
+
+    return {stopPropagation = false};
+end

Core/ChatMessageObserver/Subscriber.lua

@@ -0,0 +1,5 @@
+--- Subscribers are notified by the publisher when a chat message is sent.
+--- The subscriber can then act on the message, if needed.
+---
+--- @class ChatMessageSubscriber
+--- @field onSystemMessage nil|fun(message: string):ChatMessageSubscriberResponse Implement this method to subscribe to system messages.

Core/ChatMessageObserver/SubscriberResponse.lua

@@ -0,0 +1,2 @@
+--- @class ChatMessageSubscriberResponse
+--- @field stopPropagation boolean Should the message be propagated to other subscribers, including the in-game chat?

Core/Functions.lua

@@ -0,0 +1,3 @@
+GMGenie.Functions = {
+
+};

Core/GMCommandDispatcher.lua

@@ -0,0 +1,13 @@
+local GMCommandDispatcher = {};
+
+GMGenie.GMCommandDispatcher = GMCommandDispatcher;
+
+--- Dispatch a GM command.
+--- @param command string
+function GMCommandDispatcher.dispatch(command)
+    GMGenie.printDebugMessage("Dispatching GM command: " .. command);
+
+    -- Using the guild channel to prevent messages being broadcast publicly
+    -- in case the server does not interpret the message as a command
+    SendChatMessage(command, "GUILD");
+end

Core/Readers/PlayerInfo/IncompletePlayerInfo.lua

@@ -0,0 +1,20 @@
+--- @class IncompletePlayerInfo
+--- @field accountName string|nil
+--- @field accountId number|nil
+--- @field emailAdress string|nil
+--- @field gmLevel number|nil
+--- @field ip string|nil
+--- @field latency number|nil
+--- @field lastLogin string|nil
+--- @field failedLogins number|nil
+--- @field characterName string|nil
+--- @field characterId number|nil
+--- @field race string|nil
+--- @field class string|nil
+--- @field level number|nil
+--- @field location string|nil
+--- @field money string|nil
+--- @field phase number|nil
+--- @field totalPlayTime string|nil
+--- @field isGmModeActive boolean|nil
+--- @field guildName string|nil

Core/Readers/PlayerInfo/PlayerInfo.lua

@@ -0,0 +1,20 @@
+--- @class PlayerInfo
+--- @field accountName string
+--- @field accountId number
+--- @field emailAdress string|nil
+--- @field gmLevel number
+--- @field ip string
+--- @field latency number
+--- @field lastLogin string
+--- @field failedLogins number
+--- @field characterName string
+--- @field characterId number
+--- @field race string
+--- @field class string
+--- @field level number
+--- @field location string
+--- @field money string
+--- @field phase number
+--- @field totalPlayTime string
+--- @field isGmModeActive boolean
+--- @field guildName string|nil