Version 0.8.0-beta

- handle replacement via slash command
- emote and ooc detection
- de-/activate single mappings
- move buttons and mappings are disabled when already at top/bottom or deactivated
- minimap button is darkened when addon is disabled
- help tab with examples

- right-click on minimap button quickly de-/activates replacements

- fixed mapping to raid warning, instance and battleground chats
- localized raid target markers
- capital % substitutions
- incorrect consolidation
- Umlaut and accent replacements

.docmeta

@@ -0,0 +1,4 @@
+-
+  type: markdown
+  input-file: README.md
+  output-page: "Main"

.gitignore

@@ -37,7 +37,7 @@ out/
 obj/
 
 # Misc
-twitch/
+.bin/
 *.log
 *.graphml
 coverage.db*

.pkgmeta

@@ -0,0 +1,27 @@
+package-as: Grichelde
+
+enable-nolib-creation: no
+
+externals:
+  libs/LibStub: https://repos.wowace.com/wow/libstub/tags/1.0
+  libs/LibDataBroker: https://github.com/tekkub/libdatabroker-1-1
+  libs/LibDBIcon: https://repos.curseforge.com/wow/libdbicon-1-0/trunk/LibDBIcon-1.0
+  libs/CallbackHandler-1.0: https://repos.wowace.com/wow/callbackhandler/trunk/CallbackHandler-1.0
+  libs/AceAddon-3.0: https://repos.wowace.com/wow/ace3/trunk/AceAddon-3.0
+  libs/AceConfig-3.0: https://repos.wowace.com/wow/ace3/trunk/AceConfig-3.0
+  libs/AceConsole-3.0: https://repos.wowace.com/wow/ace3/trunk/AceConsole-3.0
+  libs/AceDB-3.0: https://repos.wowace.com/wow/ace3/trunk/AceDB-3.0
+  libs/AceDBOptions-3.0: https://repos.wowace.com/wow/ace3/trunk/AceDBOptions-3.0
+  libs/AceEvent-3.0: https://repos.wowace.com/wow/ace3/trunk/AceEvent-3.0
+  libs/AceGUI-3.0: https://repos.wowace.com/wow/ace3/trunk/AceGUI-3.0
+  libs/AceHook-3.0: https://repos.wowace.com/wow/ace3/trunk/AceHook-3.0
+  libs/AceLocale-3.0: https://repos.wowace.com/wow/ace3/trunk/AceLocale-3.0
+
+ignore:
+  - twitch
+
+manual-changelog:
+  filename: CHANGELOG.md
+  markup-type: markdown
+
+license-output: LICENSE

CHANGELOG.md

@@ -3,13 +3,85 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] Version 1.0 - 2020-05-27
-First version to be released
+## Version 0.8.0-beta - 2020-06-14 [Feature Complete]
 ### Added
-- slash commands
-- Options GUI
-- store settings globally or per character
-- added translations
+- handle replacement via slash command
+- emote and ooc detection
+- de-/activate single mappings
+- move buttons are disabled when already at top/bottom or replacements were deactivated
+- minimap button is darkened when addon is disabled
+- help tab with examples
+### Changed
+- right-click on minimap button quickly de-/activates replacements
+### Fixed
+- mapping to raid warning, instance and battleground chats
+- localized raid target markers
+- capital % substitutions
+- incorrect consolidation
+- Umlaut and accent replacements
+
+## Version 0.7.2-beta - 2020-06-08
+### Added
+- minimap button
+### Changed
+- graphical move arrows
+### Fixed
+- crash on matches with 0-width
+
+## Version 0.7.1-beta - 2020-06-07
+### Added
+- user reporting capabilities
+- ignore Battle.net contacts
+### Changed
+- graphical move arrows
+
+## Version 0.7.0-beta - 2020-06-07
+### Added
+- order buttons
+### Changed
+- use numeric LogLevel over booleans
+- exact case option reversed (again)
+- smart case handling if replacement is longer than match
+### Fixed
+- Deletion of all mappings
+
+## Version 0.6.0 (unreleased) - 2020-06-05
+### Added
+- honour capital/mixed cases for ignore case
+- consolidate consecutive matches
+- database upgrade capability
+### Changed
+- case sensitivity option reversed
+- removed obsolete WIM handling
+### Fixed
+- skip empty mapping
+- Deletion of mapping
+
+## Version 0.5.0 - 2020-06-01
+### Added
+- add replacements via options UI
+
+## Version 0.4.0 (unreleased) - 2020-05-30
+### Added
+- restructured files
+- extract functions and color codes
+- filter channels
+
+## Version 0.3.0 - 2020-05-27
+### Fixed
+- fixed DB storange and debug printing
+
+## Version 0.2.2 (unreleased) - 2020-05-26
+### Added
+- added Options UI under Interface Options
+- store settings in profiles
+- added more translations
+
+## Version 0.2.1 (unreleased) - 2020-05-25
+### Added
+- support automatic packaging for curseforge via .pkgmeta
+- include project logo
+- auto-update the project description via .docmeta
 
 ## Version 0.2 - 2020-05-25
 ### Added
@@ -18,6 +90,6 @@ First version to be released
 - handle SendChatMessage ordering if addon Misspelled is also installed
 - break long texts in chunks of 255 length
 
-## Version 0.1 - 2020-05-24
+## Version 0.1 (unreleased) - 2020-05-24
 ### Added
-- bootstrap addon with Ace3 from [Misspelled](https://www.curseforge.com/wow/addons/misspelled)
+- bootstrap addon with Ace3 based on [Misspelled](https://www.curseforge.com/wow/addons/misspelled)

Grichelde.lua

@@ -1,365 +1,88 @@
 --[[---------------------------------------------------------------------------
-  Grichelde
+
+  Grichelde - Text Replacer
+
   Copyright 2020 Teilzeit-Jedi <tj@teilzeit-jedi.de>
 
-  based on Misspelled developed by Nathan Pieper - nrpieper (@) gmail (dot) com
+  This addon is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
 
-  This code freely distributed for your use in any GPL compliant project.
-  See conditions in the LICENSE file attached.
+  You should have received a copy of the GNU General Public License
+  along with the addon. If not, see <http://www.gnu.org/licenses/gpl-3.0.txt>.
 
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
-
---------------------------------------------------------------------------]] --
+-----------------------------------------------------------------------------]]
 
+-- read namespace from global env
 local AddonName, AddonTable = ...
+local _G = _G
 
-local Grichelde = LibStub("AceAddon-3.0"):NewAddon("Grichelde", "AceEvent-3.0", "AceHook-3.0")
+-- initialize addon
+local Grichelde = LibStub("AceAddon-3.0"):NewAddon(AddonTable, AddonName, "AceConsole-3.0", "AceEvent-3.0", "AceHook-3.0")
 Grichelde.version = GetAddOnMetadata(AddonName, "Version")
-Grichelde.build = GetAddOnMetadata(AddonName, "X-Build") or "UNKNOWN"
+Grichelde.build = GetAddOnMetadata(AddonName, "X-Build") or "Experimental"
+Grichelde.classic = _G.WOW_PROJECT_ID == _G.WOW_PROJECT_CLASSIC
+Grichelde.logLevel = 0      -- cannot reference Grichelde.LOG_LEVELs here as they are loaded afterwards
 
-local L = LibStub("AceLocale-3.0"):GetLocale("Grichelde", true)
-
-local Grichelde_Debug = false
-
--- faster function lookups by mapping to local refs
-local string_find = string.find
-local string_gsub = string.gsub
-local string_len = string.len
-local string_rep = string.rep
-local string_sub = string.sub
-local strtrim = strtrim
-local strmatch = strmatch
-local tostring = tostring
-local tInsert = table.insert
-local tContains = tContains
-local pairs = pairs
-local ipairs = ipairs
-
-local Grichelde_Hooks = {}
-
---local Grichelde_ChatTypes = { "SAY", "EMOTE", "YELL", "PARTY", "GUILD", "OFFICER", "RAID", "RAID_WARNING", "INSTANCE_CHAT", "BATTLEGROUND", "WHISPER" }
-local Grichelde_ChatTypes = { "SAY", "EMOTE", "YELL", "PARTY", "GUILD" }
-local Grichelde_ChatCommands = { "/s", "/e", "/me", "/y", "/p", "/pl", "/g", "/o", "/raid", "/rl", "/rw", "/i", "bg", "/w", "/r", "/tt" }
-
--- do not replace these patterns
-local Grichelde_IgnorePatterns = {
-    "|[Cc]%x%x%x%x%x%x%x%x.-|r",    -- colored items (or links)
-    "|H.-|h",                       -- item links (http://www.wowwiki.com/ItemLink)
-    "|T.-|t",                       -- textures
-    "|n",                           -- newline
-    "{rt[1-8]}",                    -- rumbered raid target icons
-    "{Star}",                       -- named raid target icon 1
-    "{Circle}",                     -- named raid target icon 2
-    "{Coin}",                       -- named raid target icon 2
-    "{Diamond}",                    -- named raid target icon 3
-    "{Triangle}",                   -- named raid target icon 4
-    "{Moon}",                       -- named raid target icon 5
-    "{Square}",                     -- named raid target icon 6
-    "{Cross}",                      -- named raid target icon 7
-    "{X}",                          -- named raid target icon 7
-    "{Skull}"                       -- named raid target icon 8
-}
+-- publish to global env
+_G[AddonName] = Grichelde
 
+-- Ace3 callbacks
 function Grichelde:OnInitialize()
-    -- Build Interface Options window
-    --self:CreateInterfaceOptions()
+    self.L = LibStub("AceLocale-3.0"):GetLocale(self.name, true)
 
-    -- Watch for WIM and Prat to Load, then integrate
-    self:RegisterEvent("ADDON_LOADED", "HookIntoForOtherChatAddons")
+    -- Build Interface Options window
+    self.db = self:LoadDatabase()
+    self:UpgradeDatabase()
 end
 
 function Grichelde:OnEnable()
     -- Hook in before message is sent to replace all character occurrences where replacements have been defined in the options
     self:RawHook("SendChatMessage", true)
 
-    if (Misspelled) then
-        print("Misspelled detected, Grichelde will have any messsage being cleansed")
-    end
+    self.options, self.dialog = self:SetupOptions()
+    self:RefreshOptions("OnProfileChanged")
+
+    self.ldb, self.icon = self:MinimapButton()
+    self:SetupSlashCommands()
 
     -- tell the world we are listening
-    print(L.AddonLoaded)
+    if self.db.profile.enabled then
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        self:Print(self.L.AddonLoaded, self.COLOR_CODES.PREFIX .. namePlusVersion .. self.COLOR_CODES.CLOSE)
+    end
 end
 
 function Grichelde:OnDisable()
     self:Unhook("SendChatMessage")
+    self:CloseOptions()
+    self:HideMinimapButton()
+    self:UnregisterChatCommand("grichelde")
+    self:UnregisterChatCommand("gri")
 end
 
---- @param event string
---- @param addonName string
-function Grichelde:HookIntoForOtherChatAddons(event, addonName)
-    if event == "ADDON_LOADED" then
-        if addonName == "WIM" then
-            WIM.RegisterWidgetTrigger("msg_box", "whisper,chat,w2w", "OnEnterPressed", Grichelde.EditBox_OnEnterPressed)
+--- Register  slash commands 'gri' and 'grichelde'
+function Grichelde:SetupSlashCommands()
+    self:RegisterChatCommand("grichelde", "HandleSlashCommand")
+    self:RegisterChatCommand("gri", "HandleSlashCommand")
+end
 
-            -- If available use the WIM API
-            if (WIM.RegisterPreSendFilterText) then -- avoid error if WIM not up to date.
-                WIM.RegisterPreSendFilterText(function(text)
-                    return Grichelde:CheckAndReplace(text)
-                end)
+function Grichelde:HandleSlashCommand(input, ...)
+    -- Show the GUI if no input is supplied, otherwise handle the chat input.
+    if self.functions.nilOrEmpty(input) then
+        self:ToggleOptions()
     else
-                -- WIM sends its chat messages via the API ChatThrottleLib, which itself hooks the default SendChatMessage api
-                -- many times before Grichelde will. ChatThrottleLib might potentially load before Grichelde, so we just hook
-                -- into ChatThrottleLib to be on the safe side.
-
-                if (ChatThrottleLib) then
-                    Grichelde_Hooks["ChatThrottleLib"] = ChatThrottleLib.SendChatMessage
-
-                    function ChatThrottleLib:SendChatMessage(prio, prefix, text, ...)
-                        Grichelde:DebugPrint("ChatThrottleLib:SendChatMessage : Hook called")
-                        local replacedText = Grichelde:CheckAndReplace(text)
-                        return Grichelde_Hooks["ChatThrottleLib"](ChatThrottleLib, prio, prefix, replacedText, ...)
-                    end
-                end
-            end
-        end
-    end
-end
-
---- Before af chat message is sent, check if replacement is required and replace the text accordingly.
---- @param message string
---- @param type string
---- @param language string
---- @param channel string
-function Grichelde:SendChatMessage(message, type, language, channel, ...)
-    local replacedText = self:CheckAndReplace(message, type)
-
-    self:DebugPrint("SendChatMessage : replacedText: " .. replacedText)
-
-    -- Send text in chunks if length exceeds 255 bytes after replacement
-    local chunks = self:SplitText(replacedText)
-    self:DebugPrint("SendChatMessage : #chunks: " .. #chunks)
-
-    for _, chunk in ipairs(chunks) do
-        self.hooks["SendChatMessage"](chunk, type, language, channel, ...);
-    end
-end
-
-function Grichelde:CheckAndReplace(message, type)
-    local text = message
-    if (Misspelled) then
-        self:DebugPrint("Misspelled detected: cleansing message")
-        text = Misspelled:RemoveHighlighting(text)
-    end
-    text = strtrim(text)
-
-    if (self:CheckReplacement(text, type)) then
-        text = self:ReplaceText(text)
-    end
-    return text
-end
-
-function Grichelde:CheckReplacement(text, type)
-    -- todo: globally disabled?
-
-    -- check type
-    if (not tContains(Grichelde_ChatTypes, type)) then
-        self:DebugPrint("CheckReplacement : skip channel type")
-        return false
-    end
-
-    -- don't replace slash commands except chat related commands
-    if string_sub(text, 1, 1) == "/" then
-        local firstWord, _ = self:SplitOnFirstMatch(text)
-        if (firstWord == nil or not tContains(Grichelde_ChatCommands, firstWord)) then
-            self:DebugPrint("CheckReplacement : ignore slash command")
-            return false
-        end
-    end
-
-    -- in any other case
-    return true
-end
-
---- Checks if the text starts with a preversable ignore pattern, such as itemLinks, textures or raid target icons
---- and returns the end location of the match, or 0 if no pattern was found
---- @param text string
---- @return number
-function Grichelde:CheckForPreversableText(text)
-    self:DebugPrint("CheckForPreversableText : text is " .. text)
-    -- Calling find on ever pattern might be inefficient but its way less code.
-    for _, pattern in ipairs(Grichelde_IgnorePatterns) do
-        local pos1, pos2 = string_find(text, pattern)
-        if pos1 == 1 and pos2 ~= nil then
-            self:DebugPrint("CheckForPreversableText : Found ignore pattern " .. pattern .. " at (" .. pos1 .. "," .. pos2 .. ")")
-            return pos2
-        end
-    end
-    self:DebugPrint("CheckForPreversableText : no ignore pattern found")
-    return 0
-end
-
---- Replaces all character occurrences for which replacements have been defined in the options,
---- while preserving any itemLinks or textures. (http://www.wowwiki.com/ItemLink)
---- @param text string
---- @return string
-function Grichelde:ReplaceText(text)
-    local finalText = ""
-    local newText = text
-
-    -- don't replace non-chat related slash commands
-    local firstWord, line = self:SplitOnFirstMatch(text)
-    if (firstWord ~= nil and tContains(Grichelde_ChatCommands, firstWord)) then
-        self:DebugPrint("ReplaceText : Found slash command " .. (firstWord + "") )
-        -- skip chat slash command
-        finalText = finalText .. firstWord .. ' '
-        newText = line
-    end
-
-    local current = 1
-    local lastStart = 1
-
-    while current <= string_len(newText) do
-        local currentChar = string_sub(newText, current, current)
-        self:DebugPrint("current/char : " .. current .. "," .. currentChar)
-
-        if currentChar ~= '|' and currentChar ~= '{' then
-            current = current + 1
+        -- handle slash ourselves
+        self:DebugPrint("Handle slash command: " .. input)
+        if input == "mappings" then
+            self:ToogleMappings()
+        elseif input == "options" then
+            self:ToggleOptions()
+        elseif input == "profile" then
+            self:PrintProfile()
         else
-
-            -- lookahead-check for itemLinks, textures and raid target icons
-            local textAhead = string_sub(newText, current)
-            local posEnd = self:CheckForPreversableText(textAhead)
-            if posEnd > 0 then
-                self:DebugPrint("ReplaceText : Found an ignore pattern")
-
-                local textBehind = string_sub(newText, lastStart, current - 1)
-                local replacement = self:ReplaceCharacters(textBehind)
-                local preservedText = string_sub(textAhead, 1, posEnd)
-
-                finalText = finalText .. replacement .. preservedText
-                current = current + posEnd
-                lastStart = current
-                self:DebugPrint("ReplaceText : restarting at " .. lastStart)
-            else
-                -- no corresponding end was found to start pattern, continue loop with next char
-                current = current + 1
-            end
-        end
-    end
-
-    -- cleanup remaining text to the end
-    local remainingText = string_sub(newText, lastStart)
-    local replacement = self:ReplaceCharacters(remainingText)
-    finalText = finalText .. replacement
-
-    self:DebugPrint("ReplaceText : replaced \"" .. text .. "\"")
-    self:DebugPrint("ReplaceText : with         \"" .. finalText .. "\"")
-    return finalText
-end
-
---- Replaces all character occurrences for which replacements have been defined in the options
---- @param text string
---- @return string
-function Grichelde:ReplaceCharacters(text)
-    -- todo: read from options
-    -- todo: case (in)sensitivity
-    local replacement = text
-    replacement = string_gsub(replacement, "s", "ch")
-    replacement = string_gsub(replacement, "S", "Ch")
-    replacement = string_gsub(replacement, "t", "k")
-    replacement = string_gsub(replacement, "T", "K")
-    self:DebugPrint("ReplaceCharacters : replaced \"" .. text .. "\" with \"" .. replacement .. "\"")
-    return replacement
-end
-
---- Splits a long text in longest possible chunks of <= 255 length, split at last available space
---- @param text string
---- @return table
-function Grichelde:SplitText(text)
-    local chunks = {}
-    local splitText = text
-    local textSize = string_len(splitText)
-
-    while textSize > 255 do
-        local chunk = string_sub(splitText, 1, 255)
-        local remaining = ""
-
-        -- special case: if space is the start of the next chunk, don't split this chunk
-        if string_sub(splitText, 256, 256) ~= ' ' then
-            -- split at last space, don't assign directly as nil might be returned
-            local left, right = self:SplitOnLastMatch(chunk)
-            if left ~= nil then
-                chunk = left
-            end
-            if right ~= nil then
-                remaining = right
-            end
-        end
-
-        self:DebugPrint("SplitText : chunk: " .. chunk )
-
-        tInsert(chunks, chunk)
-        splitText = remaining .. string_sub(splitText, 256)
-        textSize = string_len(splitText)
-    end
-
-    -- pickup remaining text < 255
-    self:DebugPrint("SplitText : last chunk: " .. splitText)
-    tInsert(chunks, splitText)
-
-    return chunks
-end
-
--- split first word of a text line
-function Grichelde:SplitOnFirstMatch(text, start)
-    self:DebugPrint("SplitOnFirstMatch : text: " .. text .. ", start: " .. self:EmptyIfNil(start))
-    local pos = 1
-    if start ~= nil then pos = start end
-    local left, right = strmatch(text, "^.- .+", pos)
-    self:DebugPrint("SplitOnFirstMatch : left: " .. self:EmptyIfNil(left) .. ", right: " .. self:EmptyIfNil(right))
-    return left, right
-end
-
-function Grichelde:SplitOnLastMatch(text, start)
-    self:DebugPrint("SplitOnLastMatch : text: " .. text .. ", start: " .. self:EmptyIfNil(start))
-    local pos = 1
-    if start ~= nil then pos = start end
-    local left, right = strmatch(text, ".+ .-$", pos)
-    self:DebugPrint("SplitOnLastMatch : left: " .. self:EmptyIfNil(left) .. ", right: " .. self:EmptyIfNil(right))
-    return left, right
-end
-
-function Grichelde:DebugPrint(message)
-    if (Grichelde_Debug) then
-        print(GRAY_FONT_COLOR_CODE .. "Grichelde:" .. FONT_COLOR_CODE_CLOSE .. " " .. message)
-    end
-end
-
-function Grichelde:EmptyIfNil(value)
-    if value == nil then return "" end
-    return tostring(value)
-end
-
-function Grichelde:tprint(t, indent, done)
-    -- in case we run it standalone
-    local Note = Note or print
---  local Tell = Tell or io.write
-
-    -- show strings differently to distinguish them from numbers
-    local function show(val)
-        if type(val) == "string" then
-            return '"' .. val .. '"'
-        else
-            return tostring(val)
-        end
-    end
-
-    -- entry point here
-    done = done or {}
-    indent = indent or 0
-    for key, value in pairs(t) do
-        print(string_rep(" ", indent)) -- indent it
-        if type(value) == "table" and not done[value] then
-            done[value] = true
-            Note(show(key), ":");
-            self:tprint(value, indent + 2, done)
-        else
-            print(show(key), "=")
-            print(show(value))
+            self:SendChatMessageOverride(input, ...)
         end
     end
 end

Grichelde.toc

@@ -1,23 +1,32 @@
 ## Interface: 11304
 
 ## Title: Grichelde
-## Notes: Replaces characters you type in the chat box
+## Notes: Replaces characters from the chat box
 ## Notes-de: Ersetzt eingegebene Zeichen in der Chat-Zeile
-## Version: 1.0
+## Version: 0.8.0-beta
 ## Author: Teilzeit-Jedi
 ## eMail: tj@teilzeit-jedi.de
 
 ## X-Build: Classic
 ## X-Curse-Project-ID: 385480
+## X-License: GPLv3
 ## X-Category: Chat/Communication
-## X-Credits: Teilzeit-Jedi, Nathan Pieper
-## X-Embeds: Ace3
+## X-Credits: Teilzeit-Jedi
+## X-Embeds: LibStub, CallbackHandler, Ace3, LibDataBroker, LibDBIcon
 
-## OptionalDeps: Ace3
-## SavedVariables: GrichseldeOptions
-## SavedVariablesPerCharacter: GrichseldeCharOptions
+## OptionalDeps: LibStub, CallbackHandler, Ace3, LibDataBroker, LibDBIcon
+## SavedVariables: GricheldeDB
 
 libs.xml
-localisation.xml
 
 Grichelde.lua
+GricheldeConstants.lua
+
+localisation.xml
+
+GricheldeUtils.lua
+GricheldeDatabase.lua
+GricheldeUpgrade.lua
+GricheldeOptions.lua
+GricheldeMinimap.lua
+GricheldeChat.lua

GricheldeChat.lua

@@ -0,0 +1,653 @@
+-- import addon read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local IsAddOnLoaded, assert, nilOrEmpty, pairs, ipairs, spairs, tContains, tFilter, tInsert, tConcat, tSize, tIsEmpty, find, sub, isUpper, isLower, toUpper, toLower, trim, length, lenUtf8
+    = Grichelde.functions.IsAddOnLoaded, Grichelde.functions.assert, Grichelde.functions.nilOrEmpty, Grichelde.functions.pairs, Grichelde.functions.ipairs, Grichelde.functions.spairs, Grichelde.functions.tContains, Grichelde.functions.tFilter, Grichelde.functions.tInsert, Grichelde.functions.tConcat, Grichelde.functions.tSize, Grichelde.functions.tIsEmpty,
+      Grichelde.functions.find, Grichelde.functions.sub, Grichelde.functions.isUpper, Grichelde.functions.isLower, Grichelde.functions.toUpper, Grichelde.functions.toLower, Grichelde.functions.trim, Grichelde.functions.length, Grichelde.functions.lenUtf8
+
+local function cleanseMessage(this, message)
+    local text = message or ""
+    if (IsAddOnLoaded("Misspelled")) then
+        this:DebugPrint("Misspelled detected: cleansing message")
+        text = _G.Misspelled:RemoveHighlighting(message)
+    end
+    return trim(text)
+end
+
+--- Before a chat message is sent, check if replacement is required and replace the text accordingly.
+-- @param message string
+-- @param type string
+-- @param language string
+-- @param channel string
+function Grichelde:SendChatMessage(message, type, ...)
+    local text = cleanseMessage(self, message)
+    if (self:CheckReplacementAllowed(text, type)) then
+        text = self:ReplaceText(text)
+    end
+
+    self:SendChunkifiedChatMessage(text, type, ...)
+end
+
+--- Always replaces the text accoording to the configuration, even if activation or channel was disabled.
+--- This is used the the override slash command: "/gri /emote text to replace".
+--- NOTE: type and channel (in case of whispers) are determined from the message text.
+-- @param message string
+-- @param type string
+function Grichelde:SendChatMessageOverride(message, ...)
+    local text = cleanseMessage(self, message)
+
+    local chatType, lang, channel = text, DEFAULT_CHAT_FRAME.editBox.chatType or "SAY", DEFAULT_CHAT_FRAME.editBox.languageID
+    local msg, type, chan = self:CheckAndExtractMessageTypeTarget(text)
+
+    if msg ~= nil then
+        msg = self:ReplaceText(msg)
+
+        if type ~= nil then
+            self:SendChunkifiedChatMessage(msg, type, lang, chan, ...)
+        else
+            self:SendChunkifiedChatMessage(msg, chatType, lang, channel, ...)
+        end
+    else
+        -- suppress invalid messages/channels/targets
+    end
+end
+
+--- Send text in chunks if length exceeds 255 bytes after replacement.
+function Grichelde:SendChunkifiedChatMessage(message, ...)
+    if length(message) > 255 then
+        local chunks = self:SplitText(message)
+        self:DebugPrint("SendChatMessage : #chunks:", #chunks)
+
+        for _, chunk in ipairs(chunks) do
+            self.hooks["SendChatMessage"](chunk, ...);
+        end
+    else
+        self.hooks["SendChatMessage"](message, ...);
+    end
+end
+
+local function IsOneBigEmote(this, text)
+    local firstWord, _ = this:SplitOnFirstMatch(text)
+    assert(firstWord ~= nil, "firstWord is never nil")
+
+    -- emote detection
+    local isOneBigEmote = false
+    -- scheme *emote*
+    if sub(firstWord, 1, 1) == "<" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%>", 2)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+    if not isOneBigEmote and sub(firstWord, 1, 1) == "*" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%*", 2)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+    -- scheme **emote**
+    if not isOneBigEmote and sub(firstWord, 1, 2) == "**" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%*%*", 3)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+
+    -- the whole text is one big emote
+    return isOneBigEmote
+end
+
+--[[
+--- Detect OOC in text, patterns are (( ooc )) or ooc:
+local function IsOoc(this, text)
+    local firstWord, _ = this:SplitOnFirstMatch(text)
+    assert(firstWord ~= nil, "firstWord is never nil")
+
+    -- scheme: (( ooc ))
+    if sub(firstWord, 1, 2) == "((" then
+        -- search for emote end
+        local _, oocEnd = find(text, "%)%)", 3)
+        if (oocEnd == length(text)) then
+            this:TracePrintPrint("IsOoc : skip ((ooc))", text)
+            return true
+        end
+    end
+    -- scheme: ooc:
+    if sub(firstWord, 1, 4) == "ooc:" then
+        this:TracePrint("IsOoc : skip ooc:", text)
+        return true
+    end
+
+    return false
+end
+]]
+
+--- Checks if a message can be replaced according to configuration.
+-- @return boolean
+function Grichelde:CheckReplacementAllowed(text, channel)
+    self:DebugPrint("CheckReplacementAllowed : text:", text)
+
+    -- skip if disabled
+    if (not self.db.profile.enabled) then
+        self:DebugPrint("CheckReplacementAllowed : disabled")
+        return false
+    end
+
+    -- skip if no text
+    if nilOrEmpty(text) then
+        return false
+    end
+
+    -- skip if wrong channel
+    local chan = self:ConvertBlizzTypeToOption(channel)
+    local allowedChannels = tFilter(self.db.profile.channels,
+        function(_, k, v) return k == chan and v == true end,
+        function(_, k, _) return k end
+    )
+    self:DebugPrint("CheckReplacementAllowed : allowed channels:")
+    self:DebugPrint(allowedChannels)
+
+    if tIsEmpty(allowedChannels) then
+        self:DebugPrint("CheckReplacementAllowed : skip channel type:", chan)
+        return false
+    end
+
+    local firstWord, _ = self:SplitOnFirstMatch(text)
+    assert(firstWord ~= nil, "firstWord is never nil")
+
+    -- don't replace slash commands
+    if sub(firstWord, 1, 1) == "/" then
+        self:DebugPrint("CheckReplacementAllowed : skip other slash commands:", firstWord)
+        return false
+    end
+
+    -- emote detection
+    if IsOneBigEmote(self, text) then
+        self:DebugPrint("CheckReplacementAllowed : one big emote")
+        return self.db.profile.channels.emote
+    end
+
+    -- in any other case, treat as ordinary text or emote
+    return true
+end
+
+--- Checks if the text from the Grichelde slash command can be replaced and if so
+--- returns the replacable text, the chat type and target (player or channel) from the message text.
+--- This is used the the override slash command: "/gri /emote text to replace".
+-- @param text (string) the whole message
+-- @return message (string) stripped message
+-- @return type (string) chat type
+-- @return channel (string|number) channel number for whispers
+function Grichelde:CheckAndExtractMessageTypeTarget(text)
+    self:DebugPrint("CheckAndExtractMessageTypeTarget : text:", text)
+
+    -- skip if no further text
+    if nilOrEmpty(text) then
+        return nil      -- dont send text at all
+    end
+
+    -- first word should be a chat command
+    if sub(text, 1, 1) == "/" then
+        -- extract chat command
+        local chatCmd, targetAndText = self:SplitOnFirstMatch(text)
+        assert(chatCmd ~= nil, "chatCmd is never nil")
+
+        local type = tFilter(self.SUPPORTED_CHAT_COMMANDS,
+            function(_, k, _) return chatCmd == k end
+        )
+        self:DebugPrint("CheckAndExtractMessageTypeTarget : determined type:")
+        self:DebugPrint(type)
+
+        if not tIsEmpty(type) then
+            -- valid /chattype
+            if type[1] == "WHISPER" then
+                -- special reply handling
+                if "/r" == chatCmd or "/reply" == chatCmd then
+                    -- reuse last type and target if possible
+                    local lastTold, lastToldType = ChatEdit_GetLastToldTarget()
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : lastTell, lastTellType =", lastTold, lastToldType)
+                    return targetAndText, lastToldType or type[1], lastTold
+                elseif "/tt" == chatCmd then
+                    -- determine target from game world selection
+                    if (not UnitExists("target") or not UnitIsPlayer("target")) then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil      -- dont send text at all
+                    end
+
+                    local target = UnitName("target");
+                    if target == nil then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil -- dont send text at all
+                    end
+
+                    -- eventually we found our target
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : target:", target)
+                    return targetAndText, type[1], target
+                else
+                    -- determine target from text
+                    local target, msg = self:SplitOnFirstMatch(targetAndText)
+                    if target == nil then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil -- dont send text at all
+                    end
+
+                    -- eventually we found our target
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : determined target:", target)
+                    return msg, type[1], target
+                end
+            else
+                -- all other chat types
+                return targetAndText, type[1], nil
+            end
+        else
+            -- if not a valid chat command, try as a numbered channel
+            local _, _, channelNumber = find(chatCmd, "^/(%d+)")
+            if channelNumber ~= nil then
+                local channelId = GetChannelName(channelNumber)
+                if channelId ~= nil then
+                    return targetAndText, "CHANNEL", channelId
+                end
+            end
+
+            -- ignore any other slash commands
+            self:ErrorPrint(self.L.Error_InvalidChannel)
+            return nil      -- dont send text at all
+        end
+    elseif IsOneBigEmote(self, text) then
+        self:DebugPrint("CheckAndExtractMessageTypeTarget : determined EMOTE type")
+        return text, "EMOTE", nil
+    else
+        -- in any other case, treat as ordinary text, assume default type and channel
+        return text
+    end
+end
+
+function Grichelde:ConvertBlizzTypeToOption(channel)
+    local option = tFilter(self.BLIZZ_TYPE_TO_OPTIONS,
+        function(_, k, _) return channel == k end
+    )
+    if not tIsEmpty(option) then
+        self:DebugPrint("ConvertBlizzTypeToOption : convert %s to %s", channel, option[1])
+        return option[1]
+    else
+        return nil
+    end
+end
+
+--- Replaces all character occurrences for which replacements have been defined in the options,
+--- while preserving any itemLinks or textures. (http://www.wowwiki.com/ItemLink)
+-- @param text string
+-- @return string
+function Grichelde:ReplaceText(text)
+    local lookAheads = {'|', '{', '%', '*', '<', '(', 'o'}
+    local newText = text
+    local finalText = ""
+
+    local current = 1
+    local lastStart = 1
+
+    while current <= length(newText) do
+        local currentChar = sub(newText, current, current)
+        self:TracePrint("current/char : %s,%s", current, currentChar)
+
+        if ( not tContains(lookAheads, currentChar)) then
+            current = current + 1
+        else
+            -- lookahead-check for all preservable patterns (itemLinks, textures, emotes, ooc, etc.)
+            local textAhead = sub(newText, current)
+            local posEnd = self:CheckForPreversableText(textAhead)
+            if posEnd > 0 then
+                self:DebugPrint("ReplaceText : Found an ignore pattern")
+
+                local textBehind = sub(newText, lastStart, current - 1)
+                local replacement = self:ReplaceCharacters(textBehind)
+                local preservedText = sub(textAhead, 1, posEnd)
+
+                finalText = finalText .. replacement .. preservedText
+                current = current + posEnd
+                lastStart = current
+                self:DebugPrint("ReplaceText : restarting at", lastStart)
+            else
+                -- no corresponding end was found to start pattern, continue loop with next char
+                current = current + 1
+            end
+        end
+    end
+
+    -- cleanup remaining text to the end
+    local remainingText = sub(newText, lastStart)
+    local replacement = self:ReplaceCharacters(remainingText)
+    finalText = finalText .. replacement
+
+    self:DebugPrint("ReplaceText : replaced \"%s\"", text)
+    self:DebugPrint("ReplaceText : with         \"%s\"", finalText)
+    return finalText
+end
+
+
+--- Checks if the text starts with a preversable ignore pattern, such as itemLinks, textures, raid target icons,
+--- emotes, ooc or %-substitutons and returns the end location of the match, or 0 if no pattern was found
+-- @param text string
+-- @return number
+function Grichelde:CheckForPreversableText(text)
+    self:TracePrint("CheckForPreversableText : text:", text)
+
+    -- Calling find on ever pattern might be inefficient but its way less code than marching over every character
+    for _, pattern in ipairs(Grichelde.IGNORE_PATTERNS_CASE_SENSITIVE) do
+        local pos1, pos2 = find(text, pattern)
+        if pos1 == 1 and pos2 ~= nil then
+            self:DebugPrint("CheckForPreversableText : Found ignore pattern \"%s\" at (%d, %d)", pattern, pos1, pos2)
+            return pos2
+        end
+    end
+
+    -- emote detection
+    for _, pattern in ipairs(Grichelde.EMOTE_PATTERNS) do
+        local pos1, pos2 = find(text, pattern)
+        if pos1 == 1 and pos2 ~= nil then
+            local emote = sub(text, pos1, pos2)
+            if (not self.db.profile.channels.emote) then
+                self:DebugPrint("CheckForPreversableText : Found emote \"%s\" but preserved it", emote)
+                return pos2
+            else
+                self:DebugPrint("CheckForPreversableText : Found emote \"%s\" at (%d, %d)", emote, pos1, pos2)
+            end
+        end
+    end
+
+    -- %-substitutions
+    local lowerText = toLower(text)
+    for _, pattern in ipairs(Grichelde.IGNORE_PATTERNS_CASE_INSENSITIVE) do
+        local pos1, pos2 = find(lowerText, pattern)
+        if pos1 == 1 and pos2 ~= nil then
+            self:DebugPrint("CheckForPreversableText : Found ignore pattern \"%s\" at (%d, %d)", pattern, pos1, pos2)
+            return pos2
+        end
+    end
+
+    -- Localized raid target markers
+    for _, localizedRT in ipairs(Grichelde.LOCALIZED_RAID_TARGETS) do
+        local translation = toLower(self.L["IgnorePattern_" .. localizedRT])
+        local locPattern = "{" .. translation .. "}"
+        self:TracePrint("CheckForPreversableText : locPattern:", locPattern)
+        local pos1, pos2 = find(lowerText, locPattern)
+        if pos1 == 1 and pos2 ~= nil then
+            self:DebugPrint("CheckForPreversableText : Found localized raid target marker \"%s\" at (%d, %d)", locPattern, pos1, pos2)
+            return pos2
+        end
+    end
+
+    -- ooc: detection remaing text is treated as ooc completely!
+    if sub(lowerText, 1, 4) == "ooc:" then
+        self:DebugPrint("CheckForPreversableText : ooc for remaing text")
+        return length(text)
+    end
+
+    self:DebugPrint("CheckForPreversableText : no ignore pattern found")
+    return 0
+end
+
+--- Replaces all character occurrences for which replacements have been defined in the options
+-- @param text string
+-- @return string
+function Grichelde:ReplaceCharacters(text)
+    local replacements = self.db.profile.replacements or {}
+    self:DebugPrint("ReplaceCharacters : replacements")
+    self:DebugPrint(replacements)
+
+    local result = text
+    local consolidate = {}
+
+    -- replacements are done first
+    for replName, replTable in spairs(replacements) do
+        local before = result
+        local search = replTable.searchText
+
+        if not nilOrEmpty(search) and replTable.active then
+            local replace = replTable.replaceText
+            consolidate[replName] = {}
+
+            if replTable.exactCase then
+                -- exact case
+                self:DebugPrint("ReplaceCharacters : \"%s => %s\" (exact case)", search, replace)
+                local pos, offset = 1, 0
+                local oldResult = result
+
+                local pos1, pos2 = find(oldResult, search, pos)
+                self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
+                while (pos1 and pos2 and pos1 <= pos2) do
+                    local pre = sub(result, 1, pos1 - 1 + offset)
+                    local post = sub(result, pos2 + 1 + offset)
+                    self:TracePrint("ReplaceCharacters : pre: %s, post: %s", pre, post)
+
+                    -- actual replacement
+                    result = pre .. replace .. post
+                    self:DebugPrint("result: %s", result)
+
+                    -- remember positions for consolidate
+                    if replTable.consolidate then
+                        tInsert(consolidate[replName], pos1 + offset)
+                    end
+
+                    -- update previous consolidate markers
+                    local diff = length(replace) - length(search)
+                    for key, posList in pairs(consolidate) do
+                        if key ~= replName then
+                            for i, pc in ipairs(posList) do
+                                if pos1 < pc then
+                                    consolidate[key][i] = consolidate[key][i] + diff
+                                end
+                            end
+                        end
+                    end
+
+                    -- replacement text can lengthen or shorten the resulting text
+                    -- after replacement result and lowerResult can have different sizes
+                    offset = offset + diff
+                    -- update values for next iteration
+                    pos = pos2 + 1
+                    pos1, pos2 = find(oldResult, search, pos)
+                end
+            else
+                self:DebugPrint("ReplaceCharacters : \"%s => %s\" (ignoreCase)", search, replace)
+                local pos, offset = 1, 0
+                local lowerResult = toLower(result)
+                local lowerSearch = toLower(search)
+
+                local pos1, pos2 = find(lowerResult, lowerSearch, pos)
+                self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
+                while (pos1 and pos2 and pos1 <= pos2) do
+                    local pre = sub(result, 1, pos1 - 1 + offset)
+                    local match = sub(result, pos1 + offset, pos2 + offset)
+                    local post = sub(result, pos2 + 1 + offset)
+                    self:TracePrint("ReplaceCharacters : pre: %s, match: %s, post: %s", pre, match, post)
+
+                    -- keep cases
+                    local utf8, uc, tc = nil, 0, 0
+                    local repl = ""
+                    local lastCase = nil
+                    for p = pos1, pos2 do
+                        self:TracePrint("ReplaceCharacters : p: %d", p)
+                        local c = sub(match, p - pos1 + 1, p - pos1 + 1)
+                        -- put together umlaut or accent
+                        if utf8 ~= nil then
+                            c = utf8 .. c
+                            utf8 = nil
+                        end
+
+                        -- if not umlaut or accent
+                        if c ~= "\195" then
+                            local r = sub(replace, p - pos1 + 1 - uc + tc, p - pos1 + 1 - uc + tc) or ""
+                            if r == "\195" then
+                                r = sub(replace, p - pos1 + 1 - uc + tc, p - pos1 + 1 - uc + tc + 1) or ""
+                                tc = tc + 1
+                            end
+                            self:TracePrint("ReplaceCharacters : character: %s, %s", c, r)
+
+                            if (isUpper(c)) then            -- UPPER-CASE letter
+                                lastCase = true
+                                repl = repl .. toUpper(r)
+                            elseif (isLower(c)) then        -- lower_case letter
+                                lastCase = false
+                                repl = repl .. toLower(r)
+                            else                            -- no letter
+                                lastCase = nil
+                                repl = repl .. r
+                            end
+                        else
+                            -- handle UTF8 characters
+                            utf8 = c
+                            uc = uc + 1
+                        end
+                    end
+
+                    self:TracePrint("ReplaceCharacters : length %d > %d", length(replace), pos2 - pos1 + 1 - uc + tc)
+                    if (length(replace) > pos2 - pos1 + 1 - uc + tc) then
+                        local remainingReplace = sub(replace, pos2 - pos1 + 2 - uc + tc)
+                        local nextLetter = sub(post, 1, 1)
+                        self:TracePrint("ReplaceCharacters : rest: %s, n: %s, lastCase: %s", remainingReplace, nextLetter, lastCase)
+
+                        if lastCase == nil then
+                            if (isUpper(nextLetter)) then
+                                repl = repl .. toUpper(remainingReplace)
+                            elseif (isLower(nextLetter)) then
+                                repl = repl .. toLower(remainingReplace)
+                            else
+                                repl = repl .. remainingReplace
+                            end
+                        elseif lastCase == false then
+                            repl = repl .. toLower(remainingReplace)
+                        else
+                            if (isLower(nextLetter)) then
+                                repl = repl .. toLower(remainingReplace)
+                            else
+                                repl = repl .. toUpper(remainingReplace)
+                            end
+                        end
+                    end
+
+                    -- actual replacement
+                    result = pre .. repl .. post
+                    self:DebugPrint("ReplaceCharacters : result: %s", result)
+
+                    -- remember positions for consolidate
+                    if replTable.consolidate then
+                        tInsert(consolidate[replName], pos1 + offset)
+                        self:TracePrint("consolidate[" .. replName .. "] is:")
+                        self:TracePrint(consolidate[replName])
+                    end
+
+                    -- update previous consolidate markers
+                    local diff = length(repl) - length(lowerSearch)
+                    for key, posList in pairs(consolidate) do
+                        if key ~= replName then
+                            for i, pc in ipairs(posList) do
+                                if pos1 < pc then
+                                    consolidate[key][i] = consolidate[key][i] + diff
+                                end
+                            end
+                        end
+                    end
+
+                    -- replacement text can be longer or shorter the resulting text
+                    -- after replacement result and lowerResult can have different sizes
+                    offset = offset + diff
+                    -- update values for next iteration
+                    pos = pos2 + 1
+                    pos1, pos2 = find(lowerResult, lowerSearch, pos)
+                end
+            end
+
+            if before ~= result then
+                self:DebugPrint("ReplaceCharacters : replaced \"%s\" with \"%s\"", before, result)
+            end
+            if replTable.consolidate then
+                self:DebugPrint("consolidate[" .. replName .. "] is:")
+                self:DebugPrint(consolidate[replName])
+            end
+        else
+            self:DebugPrint("ReplaceCharacters : Skip replacement for %s", replName)
+        end
+    end
+
+    -- consolidation is done last
+    for replName, replTable in spairs(replacements) do
+        local before = result
+        local search = replTable.searchText
+
+        if not nilOrEmpty(search) and replTable.active  then
+            local replace = replTable.replaceText
+            local lowerResult = toLower(result)
+            local offset = 0
+
+            if replTable.consolidate then
+                self:DebugPrint("ReplaceCharacters : consolidating \"%s => %s\"", search, replace)
+                self:DebugPrint("consolidate[" .. replName .. "] is:")
+                self:DebugPrint(consolidate[replName])
+
+                for _, pos1 in spairs(consolidate[replName]) do
+                    local pos2 = pos1 + length(replace) - 1
+                    self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
+                    local match = toLower(replace)
+                    local next = sub(lowerResult, pos2 + 1, pos2 + 1 + pos2 - pos1)
+                    self:TracePrint("ReplaceCharacters : match: %s, next: %s", match, next)
+
+                    local _, p2 = find(next, "^" .. match)
+                    self:TracePrint("ReplaceCharacters : p2: %d", p2)
+                    if (p2) then
+                        result = sub(result, 1, pos2 + offset) .. sub(result, pos2 + 1 + p2 + offset)
+
+                        -- consolidation will shorten the resulting text
+                        offset = offset + length(result) - length(lowerResult)
+                    end
+                    self:DebugPrint("ReplaceCharacters : result: %s", result)
+                end
+            end
+
+            if before ~= result then
+                self:DebugPrint("ReplaceCharacters : consolidate \"%s\" with \"%s\"", before, result)
+            end
+        else
+            self:DebugPrint("ReplaceCharacters : Skip consolidation for %s", replName)
+        end
+    end
+
+    self:DebugPrint("ReplaceCharacters : final text:", result)
+    return result
+end
+
+--- Splits a long text in longest possible chunks of <= 255 length, split at last available space
+-- @param text string
+-- @return table
+function Grichelde:SplitText(text)
+    local chunks = {}
+    local splitText = text
+    local textSize = length(splitText or "")
+
+    while textSize > 255 do
+        local chunk = sub(splitText, 1, 255)
+        local remaining = ""
+
+        -- special case: if space is the start of the next chunk, don't split this chunk
+        if sub(splitText, 256, 256) ~= ' ' then
+            -- split at last space, don't assign directly as nil might be returned
+            local left, right = self:SplitOnLastMatch(chunk)
+            if left ~= nil then
+                chunk = left
+            end
+            if right ~= nil then
+                remaining = right
+            end
+        end
+
+        self:DebugPrint("SplitText : chunk:", chunk)
+
+        tInsert(chunks, chunk)
+        splitText = remaining .. sub(splitText, 256)
+        textSize = length(splitText)
+    end
+
+    -- pickup remaining text < 255
+    self:DebugPrint("SplitText : last chunk:", splitText)
+    tInsert(chunks, splitText)
+
+    return chunks
+end

GricheldeConstants.lua

@@ -0,0 +1,332 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+-- constants and upvalues
+Grichelde.LOG_LEVEL = {}
+Grichelde.LOG_LEVEL.DEBUG = 1
+Grichelde.LOG_LEVEL.TRACE = 2
+
+Grichelde.MAPPING_OFFSET = 10
+Grichelde.MINIMAP_ENABLED = 1.0
+Grichelde.MINIMAP_DARKENDED = 0.5
+
+Grichelde.ICONS = {}
+Grichelde.ICONS.MOVE_UP = "Interface\\MainMenuBar\\UI-MainMenu-ScrollUpButton-Up"
+Grichelde.ICONS.MOVE_UP_DISABLED = "Interface\\MainMenuBar\\UI-MainMenu-ScrollUpButton-Disabled"
+Grichelde.ICONS.MOVE_DOWN = "Interface\\MainMenuBar\\UI-MainMenu-ScrollDownButton-Up"
+Grichelde.ICONS.MOVE_DOWN_DISABLED = "Interface\\MainMenuBar\\UI-MainMenu-ScrollDownButton-Disabled"
+Grichelde.ICONS.DELETE = "Interface\\Buttons\\UI-Panel-MinimizeButton-Up"
+Grichelde.ICONS.DELETE_DISABLED = "Interface\\Buttons\\UI-Panel-MinimizeButton-Disabled"
+
+-- colors:
+Grichelde.COLORS = {}
+Grichelde.COLORS.NORMAL    = _G.NORMAL_FONT_COLOR
+Grichelde.COLORS.HIGHLIGHT = _G.HIGHLIGHT_FONT_COLOR
+Grichelde.COLORS.RED       = _G.RED_FONT_COLOR
+Grichelde.COLORS.GREEN     = _G.GREEN_FONT_COLOR
+
+Grichelde.COLOR_CODES = {}
+Grichelde.COLOR_CODES.PREFIX      = "|c00FFAA00"
+-- https://github.com/stoneharry/Misc-WoW-Stuff/blob/master/EoC%20Interface/FrameXML/Constants.lua
+Grichelde.COLOR_CODES.NORMAL      = _G.NORMAL_FONT_COLOR_CODE      or "|cffffd200"
+Grichelde.COLOR_CODES.HIGHLIGHT	  = _G.HIGHLIGHT_FONT_COLOR_CODE   or "|cffffffff"
+Grichelde.COLOR_CODES.RED         = _G.RED_FONT_COLOR_CODE         or "|cffff2020"
+Grichelde.COLOR_CODES.GREEN       = _G.GREEN_FONT_COLOR_CODE       or "|cff20ff20"
+Grichelde.COLOR_CODES.LIGHTGRAY   = "|cffC0C0C0"
+Grichelde.COLOR_CODES.GRAY        = _G.GRAY_FONT_COLOR_CODE        or "|cff808080"
+Grichelde.COLOR_CODES.DARKGRAY    = "|cff404040"
+Grichelde.COLOR_CODES.YELLOW      = _G.YELLOW_FONT_COLOR_CODE      or "|cffffff00"
+Grichelde.COLOR_CODES.LIGHTYELLOW = _G.LIGHTYELLOW_FONT_COLOR_CODE or "|cffffff9a"
+Grichelde.COLOR_CODES.ORANGE      = _G.ORANGE_FONT_COLOR_CODE      or "|cffff7f3f"
+Grichelde.COLOR_CODES.CLOSE       = _G.FONT_COLOR_CODE_CLOSE       or "|r"
+
+Grichelde.SLASH_COMMANDS = { "gri", "grichelde" }
+
+Grichelde.SUPPORTED_CHAT_COMMANDS = {
+    ["/s"]               = "SAY",
+    ["/say"]             = "SAY",
+    ["/sprechen"]        = "SAY",
+    ["/c"]               = "CHANNEL",
+    ["/csay"]            = "CHANNEL",
+    ["/e"]               = "EMOTE",
+    ["/em"]              = "EMOTE",
+    ["/me"]              = "EMOTE",
+    ["/emote"]           = "EMOTE",
+    ["/y"]               = "YELL",
+    ["/yell"]            = "YELL",
+    ["/sh"]              = "YELL",
+    ["/shout"]           = "YELL",
+    ["/schreien"]        = "YELL",
+    ["/sch"]             = "YELL",
+    ["/p"]               = "PARTY",
+    ["/party"]           = "PARTY",
+    ["/gruppe"]          = "PARTY",
+    ["/pl"]              = "PARTY",
+    ["/partyleader"]     = "PARTY",
+    ["/g"]               = "GUILD",
+    ["/gc"]              = "GUILD",
+    ["/guild"]           = "GUILD",
+    ["/gilde"]           = "GUILD",
+    ["/o"]               = "OFFICER",
+    ["/osay"]            = "OFFICER",
+    ["/officer"]         = "OFFICER",
+    ["/offizier"]        = "OFFICER",
+    ["/raid"]            = "RAID",
+    ["/rsay"]            = "RAID",
+    ["/rl"]              = "RAID",
+    ["/rsay"]            = "RAID",
+    ["/raidleader"]      = "RAID",
+    ["/schlachtzug"]     = "RAID",
+    ["/rw"]              = "RAID_WARNING",
+    ["/raidwarning"]     = "RAID_WARNING",
+    ["/i"]               = "INSTANCE_CHAT",
+    ["/instance"]        = "INSTANCE_CHAT",
+    ["/instanz"]         = "INSTANCE_CHAT",
+    ["/bg"]              = "BATTLEGROUND",
+    ["/battleground"]    = "BATTLEGROUND",
+    ["/schlachfeld"]     = "BATTLEGROUND",
+    ["/w"]               = "WHISPER",
+    ["/whisper"]         = "WHISPER",
+    ["/t"]               = "WHISPER",
+    ["/tell"]            = "WHISPER",
+    ["/send"]            = "WHISPER",
+    ["/tt"]              = "WHISPER",
+    ["/r"]               = "WHISPER",
+    ["/reply"]           = "WHISPER",
+    ["/fl\195\188stern"] = "WHISPER",
+    ["/antworten"]       = "WHISPER",
+}
+
+Grichelde.BLIZZ_TYPE_TO_OPTIONS = {
+    ["SAY"]          = "say",
+    ["EMOTE"]        = "emote",
+    ["YELL"]         = "yell",
+    ["PARTY"]        = "party",
+    ["GUILD"]        = "guild",
+    ["OFFICER"]      = "officer",
+    ["RAID"]         = "raid",
+    ["RAID_WARNING"] = "raidWarning",
+    ["INSTANCE"]     = "instance",
+    ["BATTLEGROUND"] = "battleground",
+    ["WHISPER"]      = "whisper",
+}
+
+-- do not replace these patterns
+Grichelde.IGNORE_PATTERNS_CASE_SENSITIVE = {
+    "|[Cc]%x%x%x%x%x%x%x%x.-|r", -- colored items (or links)
+    "|H.-|h",     -- item links (http://www.wowwiki.com/ItemLink)
+    "|T.-|t",     -- textures
+    "|K.-|k",     -- Battle.net
+    "|n",         -- newline
+
+    "%(%(.-%)%)", -- (( ooc ))
+}
+
+-- for separate emote detection
+Grichelde.EMOTE_PATTERNS = {
+    "%*.-%*",     -- emotes *
+    "%*%*.-%*%*", -- emotes **
+    "%<.-%>"      -- emotes < >
+}
+
+Grichelde.IGNORE_PATTERNS_CASE_INSENSITIVE = {
+    "{rt[1-8]}",  -- rumbered raid target icons, localized raid targets are handled differently
+    "%%n",        -- player's name
+    "%%z",        -- player's currnt zone
+    "%%sz",       -- player's current sub-zone
+    "%%loc",      -- player's map coordinates
+    "%%t",        -- name of target
+    "%%f",        -- name of focus target
+    "%%m",        -- name of mouseover unit
+    "%%p",        -- name of player pet
+    "%%tt"        -- name of player's target's target
+}
+
+Grichelde.LOCALIZED_RAID_TARGETS = { "Star", "Circle", "Diamond", "Triangle", "Moon", "Square", "Cross", "Skull" }
+
+local function nilOrEmpty(s)
+    return s == nil or s:trim() == ""
+end
+
+local function spairs(t, orderFunc)
+    -- collect the keys
+    local sortedKeys = {}
+    -- for every non-nil value
+    for key, _ in Grichelde.functions.pairs(t) do
+        Grichelde.functions.tInsert(sortedKeys, key)
+    end
+
+    if orderFunc then
+        Grichelde.functions.tSort(sortedKeys, function(a, b) return orderFunc(sortedKeys, a, b) end)
+    else
+        -- lexicographical order
+        Grichelde.functions.tSort(sortedKeys)
+    end
+
+    -- return the iterator function
+    local it = 0
+    return function()
+        it = it + 1
+        if sortedKeys[it] then
+            return sortedKeys[it], t[sortedKeys[it]]
+        else
+            return nil
+        end
+    end
+end
+
+local function tFilter(t, condition, extract)
+    local filtered = {}
+    for key, value in Grichelde.functions.pairs(t) do
+        local cond = false
+        if condition then
+            local t = Grichelde.functions.type(condition)
+            if t == "function" then
+                cond = condition(t, key, value)
+            elseif t == "string" or t == "number" then
+                cond = (value == condition)
+            end
+        end
+
+        if cond then
+            local val = value
+            if extract and Grichelde.functions.type(extract) == "function" then
+                val = extract(t, key, value)
+            end
+            Grichelde.functions.tInsert(filtered, val)
+        end
+    end
+    return filtered
+end
+
+local function tSize(t)
+    local size = 0
+    if (t) then
+        -- for every non-nil value
+        for _, _ in Grichelde.functions.pairs(t) do
+            size = size + 1
+        end
+    end
+    return size
+end
+
+local function tIsEmpty(t)
+    if (not t) then return true end
+    return Grichelde.functions.tNext(t) == nil
+end
+
+local function tClone(orig)
+    local orig_type = Grichelde.functions.type(orig)
+    local copy
+    if orig_type == 'table' then
+        copy = {}
+        -- for every non-nil value
+        for orig_key, orig_value in Grichelde.functions.tNext, orig, nil do
+            copy[tClone(orig_key)] = tClone(orig_value)
+        end
+        Grichelde.functions.setmetatable(copy, tClone(Grichelde.functions.getmetatable(orig)))
+    else -- number, string, boolean, etc
+        copy = orig
+    end
+    return copy
+end
+
+local function isChar(word)
+    return Grichelde.functions.find(word, "[%z\65-\90\97-\122\195-\197][\128-\191]?")
+end
+
+local function isNumber(digit)
+    return Grichelde.functions.find(digit, "%d+")
+end
+
+local function isUpper(word)
+    return Grichelde.functions.isChar(word) and word == Grichelde.functions.toUpper(word)
+end
+
+local function isLower(word)
+    return Grichelde.functions.isChar(word) and word == Grichelde.functions.toLower(word)
+end
+
+local function isCapital(word)
+    return Grichelde.functions.legnth(word) > 1
+        and Grichelde.functions.isUpper(Grichelde.functions.sub(word,1,1))
+        and Grichelde.functions.isLower(Grichelde.functions.sub(word,2))
+end
+
+local function color(color, text)
+    return color .. text .. Grichelde.COLOR_CODES.CLOSE
+end
+
+local function cPrefix(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.PREFIX, text)
+end
+
+local function cYellow(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.NORMAL, text)
+end
+
+local function cGray(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.GRAY, text)
+end
+
+local function cDarkgray(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.DARKGRAY, text)
+end
+
+local function cOrange(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.ORANGE, text)
+end
+
+-- faster function lookups by mapping to local refs
+Grichelde.functions = {}
+Grichelde.functions.IsAddOnLoaded = _G.IsAddOnLoaded
+Grichelde.functions.assert        = _G.assert
+Grichelde.functions.type          = _G.type
+Grichelde.functions.print         = _G.print
+Grichelde.functions.nilOrEmpty    = nilOrEmpty
+Grichelde.functions.pairs         = _G.pairs
+Grichelde.functions.ipairs        = _G.ipairs
+Grichelde.functions.spairs        = spairs
+Grichelde.functions.tContains     = _G.tContains
+Grichelde.functions.tFilter       = tFilter
+Grichelde.functions.tInsert       = _G.table.insert
+Grichelde.functions.tConcat       = _G.table.concat
+Grichelde.functions.tSize         = tSize
+Grichelde.functions.tIsEmpty      = tIsEmpty
+Grichelde.functions.tSort         = _G.table.sort
+Grichelde.functions.tClone        = tClone
+Grichelde.functions.tNext         = _G.next
+Grichelde.functions.tWipe         = _G.wipe
+Grichelde.functions.setmetatable  = _G.setmetatable
+Grichelde.functions.getmetatable  = _G.getmetatable
+Grichelde.functions.select        = _G.select
+Grichelde.functions.unpack        = _G.unpack
+Grichelde.functions.find          = _G.string.find
+Grichelde.functions.sub           = _G.string.sub
+Grichelde.functions.gsub          = _G.string.gsub
+Grichelde.functions.match         = _G.strmatch
+Grichelde.functions.join          = _G.strjoin
+Grichelde.functions.split         = _G.strsplit
+Grichelde.functions.toUpper       = _G.strupper
+Grichelde.functions.toLower       = _G.strlower
+Grichelde.functions.isChar        = isChar
+Grichelde.functions.isNumber      = isNumber
+Grichelde.functions.isUpper       = isUpper
+Grichelde.functions.isLower       = isLower
+Grichelde.functions.isCapital     = isCapital
+Grichelde.functions.color         = color
+Grichelde.functions.cPrefix       = cPrefix
+Grichelde.functions.cYellow       = cYellow
+Grichelde.functions.cGray         = cGray
+Grichelde.functions.cDarkgray     = cDarkgray
+Grichelde.functions.cOrange       = cOrange
+Grichelde.functions.format        = _G.string.format
+Grichelde.functions.rep           = _G.string.rep
+Grichelde.functions.trim          = _G.strtrim
+Grichelde.functions.length        = _G.string.len
+Grichelde.functions.lenUtf8       = _G.strlenutf8
+Grichelde.functions.toString      = _G.tostring
+Grichelde.functions.toNumber      = _G.tonumber
+Grichelde.functions.max           = _G.math.max
+Grichelde.functions.min           = _G.math.min

GricheldeDatabase.lua

@@ -0,0 +1,149 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local pairs, tInsert, tClone, unpack, join, toString
+    = Grichelde.functions.pairs, Grichelde.functions.tInsert, Grichelde.functions.tClone, Grichelde.functions.unpack, Grichelde.functions.join, Grichelde.functions.toString
+
+function Grichelde:GetDefaultConfig()
+    return {
+        global = {},
+        profile = {
+            enabled = true,
+            minimapButton = {
+                hide = false
+            },
+            channels = {
+                ["*"] = false,
+                say = true,
+                emote = false,
+                yell = true,
+                party = true,
+                guild = true,
+                officer = true,
+            },
+            replacements = {
+                ["**"] = {
+                    active = true,
+                    order = 9999,
+                    searchText = "",
+                    replaceText = "",
+                    exactCase = false,
+                    consolidate = true,
+                },
+                replacement_10 = {
+                    order = 10,
+                    searchText = "s",
+                    replaceText = "ch",
+                },
+                replacement_11 = {
+                    order = 11,
+                    searchText = "t",
+                    replaceText = "ck",
+                },
+            }
+        }
+    }
+end
+
+function Grichelde:LoadDatabase()
+    local db = LibStub("AceDB-3.0"):New(self.name .."DB", self:GetDefaultConfig(), true)
+
+    db.RegisterCallback(self, "OnNewProfile", "RefreshOptions")
+    db.RegisterCallback(self, "OnProfileChanged", "RefreshOptions")
+    db.RegisterCallback(self, "OnProfileDeleted", "RefreshOptions")
+    db.RegisterCallback(self, "OnProfileCopied", "RefreshOptions")
+    db.RegisterCallback(self, "OnProfileReset", "RefreshOptions")
+
+    return db
+end
+
+function Grichelde:SyncToDatabase(info, val)
+    self:TracePrint("SyncToDatabase : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local option = self.db.profile
+    local path = 1
+    while (path < #info) do
+        if info[path] ~= "mappings" then
+            option = option[info[path]] -- or nil
+        end
+        path = path + 1
+    end
+    local optionPath = join(".", unpack(info, 1, #info))
+    self:DebugPrint("change option \"%s\" from %s to %s", optionPath, toString(option[info[path]]), toString(val))
+    option[info[path]] = val
+end
+
+function Grichelde:ReadFromDatabase(info)
+    self:TracePrint("ReadFromDatabase : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local option = self.db.profile
+    local path = 1
+    while (path <= #info) do
+        if info[path] ~= "mappings" then
+            option = option[info[path]] -- or nil
+        end
+        path = path + 1
+    end
+    local optionPath = join(".", unpack(info, 1, #info))
+    self:DebugPrint("read option \"%s\": %s", optionPath, toString(option))
+    return option
+end
+
+--- Sorts a replacements table by order sub-field and rename.
+--- Do NOT reassign self.db.profile.replacements here or with its output as it will break defaults
+function Grichelde:ReorderReplacements()
+    local replacements = self.db.profile.replacements or {}
+
+    self:TracePrint("ReorderReplacements : unsorted table")
+    self:TracePrint(replacements)
+
+    local orderToName = {}
+    local size = 0
+    for replName, replTable in pairs(replacements) do
+        size = size + 1
+        tInsert(orderToName, replTable.order, replName)
+    end
+
+    self:TracePrint("ReorderReplacements : size: %d, orderToName", size)
+    self:TracePrint(orderToName)
+
+    local sorted = {}
+    local index, count = 0, 0
+
+    while count < size do
+        local replName = orderToName[index]
+        if replName and replacements[replName] then
+            self:TracePrint("ReorderReplacements : replName: %s, replTable", replName)
+            self:TracePrint(replacements[replName])
+            local order = Grichelde.MAPPING_OFFSET + count
+            sorted["replacement_" .. order] = tClone(replacements[replName])
+            sorted["replacement_" .. order].order = order
+            count = count + 1
+        end
+        index = index + 1
+        if ( index > 10000) then break end
+    end
+
+--  self:TracePrint("ReorderReplacements : sorted")
+--  self:TracePrint(sorted)
+
+    -- do NOT set self.db.profile.replacements = {} it will break defaults
+    for replName, _ in pairs(replacements) do
+        replacements[replName] = nil
+    end
+
+    -- copy over sorted replacements
+    for replName, replTable in pairs(sorted) do
+        replacements[replName] = replTable
+    end
+
+    self:DebugPrint("ReorderReplacements : sorted table")
+    self:DebugPrint(self.db.profile.replacements)
+end

GricheldeMinimap.lua

@@ -0,0 +1,107 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+--- add Minimap button
+function Grichelde:MinimapButton()
+    local function clickHandler(_, button)
+        if button == 'LeftButton' then
+            self:ToggleOptions()
+        elseif button == 'RightButton' then
+            self:ToggleActivation()
+        end
+    end
+
+    local function updateTooltip(tooltip)
+        if not tooltip or not tooltip.AddLine then return end
+
+        local tooltipTitle = self:Format(self.L.Minimap_Tooltip_Enabled, self.L.AddonName)
+        if not self.db.profile.enabled then
+            tooltipTitle = self:Format(self.L.Minimap_Tooltip_Disabled, self.L.AddonName)
+        end
+
+        tooltip:SetText(tooltipTitle,
+            Grichelde.COLORS.HIGHLIGHT.r, Grichelde.COLORS.HIGHLIGHT.g, Grichelde.COLORS.HIGHLIGHT.b, Grichelde.COLORS.HIGHLIGHT.a
+        )
+
+        tooltip:AddDoubleLine(self.L.Minimap_Tooltip_Options_Left, self.L.Minimap_Tooltip_Options_Right,
+            Grichelde.COLORS.GREEN.r, Grichelde.COLORS.GREEN.g, Grichelde.COLORS.GREEN.b, Grichelde.COLORS.GREEN.a,
+            Grichelde.COLORS.NORMAL.r, Grichelde.COLORS.NORMAL.g, Grichelde.COLORS.NORMAL.b, Grichelde.COLORS.NORMAL.a
+        )
+        tooltip:AddDoubleLine(self.L.Minimap_Tooltip_Mappings_Left, self.L.Minimap_Tooltip_Mappings_Right,
+            Grichelde.COLORS.GREEN.r, Grichelde.COLORS.GREEN.g, Grichelde.COLORS.GREEN.b, Grichelde.COLORS.GREEN.a,
+            Grichelde.COLORS.NORMAL.r, Grichelde.COLORS.NORMAL.g, Grichelde.COLORS.NORMAL.b, Grichelde.COLORS.NORMAL.a
+        )
+    end
+
+    local darkened = Grichelde.MINIMAP_ENABLED
+    if not self.db.profile.enabled then
+        darkened = Grichelde.MINIMAP_DARKENDED
+    end
+
+    local ldb = LibStub("LibDataBroker-1.1"):NewDataObject(self.name, {
+        type = "launcher",
+        text = self.AddonName,
+        icon = "Interface\\Icons\\Spell_Holy_Silence",
+        --icon = ([[Interface\Addons\%s\%s]]):format(self.name, self.name),
+        OnClick = clickHandler,
+        OnRightClick = function() self:ShowMappings() end,
+        OnTooltipShow = updateTooltip,
+        iconR = darkened,
+        iconG = darkened,
+        iconB = darkened
+    })
+
+    local icon = LibStub("LibDBIcon-1.0")
+    self:DebugPrint("MinimapButton : hidden: ", self.db.profile.minimapButton.hide)
+    icon:Register(self.name, ldb, self.db.profile.minimapButton)
+
+    return ldb, icon
+end
+
+function Grichelde:ToggleMinimapButton()
+    self.db.profile.minimapButton.hide = not self.db.profile.minimapButton.hide
+    self:DebugPrint("ToggleMinimapButton : hidden: ", self.db.profile.minimapButton.hide)
+
+    if self.db.profile.minimapButton.hide then
+        self:HideMinimapButton()
+    else
+        self:ShowMinimapButton()
+    end
+end
+
+function Grichelde:ShowMinimapButton()
+    if self.icon then
+        self.icon:Show(self.name)
+    end
+end
+
+function Grichelde:HideMinimapButton()
+    if self.icon then
+        self.icon:Hide(self.name)
+    end
+end
+
+function Grichelde:ToggleActivation()
+    self.db.profile.enabled = not self.db.profile.enabled
+    -- refresh option UI if open at the moment
+    self.dialog:SelectGroup(self.name, "enabled")
+
+    local formatString = self.L.AddonLoaded
+    local darkened = Grichelde.MINIMAP_ENABLED
+    if not self.db.profile.enabled then
+        formatString = self.L.AddonUnloaded
+        darkened = Grichelde.MINIMAP_DARKENDED
+    end
+
+    if self.dialog ~= nil and self.dialog.OpenFrames[self.name] ~= nil then
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        local statusText = self:Format(formatString, namePlusVersion)
+        self.dialog.OpenFrames[self.name]:SetStatusText(statusText)
+    end
+
+    self.ldb.iconR = darkened
+    self.ldb.iconG = darkened
+    self.ldb.iconB = darkened
+end
+

GricheldeOptions.lua

@@ -0,0 +1,690 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local nilOrEmpty, pairs, tContains, tWipe, find, match, color, toString, toNumber
+    = Grichelde.functions.nilOrEmpty, Grichelde.functions.pairs, Grichelde.functions.tContains, Grichelde.functions.tWipe, Grichelde.functions.find, Grichelde.functions.match, Grichelde.functions.color, Grichelde.functions.toString, Grichelde.functions.toNumber
+
+local selectedExample = 1
+
+function Grichelde:CreateOptionsUI()
+    return {
+        name = self:Format(self.L.Options_Title, self.L.AddonName),
+        type = "group",
+        childGroups = "tab",
+        set = function(info, val) self:SyncToDatabase(info, val) end,
+        get = function(info) return self:ReadFromDatabase(info) end,
+        hidden = false,
+        disabled = function(info) return self:IsDisabled(info) end,
+        args = {
+            enabled = {
+                order = 0,
+                type = "toggle",
+                name = self.L.Options_Enabled_Name,
+                desc = self:Format(self.L.Options_Enabled_Desc, self.L.AddonName),
+                set = function() self:ToggleActivation() end,
+                disabled = false,
+            },
+            minimapButton = {
+                order = 1,
+                type = "toggle",
+                name = self.L.Options_Minimap_Button_Name,
+                desc = self.L.Options_Minimap_Button_Desc,
+                set = function(_, _) self:ToggleMinimapButton() end,
+                get = function(_) return not self.db.profile.minimapButton.hide end,
+                disabled = false,
+            },
+
+            replacements = {
+                order = 2,
+                type = "group",
+                name = self.L.Options_Replacements_Group_Name,
+                desc = self.L.Options_Replacements_Group_Desc,
+                args = {
+                    add = {
+                        order = 0,
+                        type = "execute",
+                        confirm = false,
+                        name = self.L.Options_Replacements_Add_Name,
+                        desc = self.L.Options_Replacements_Add_Desc,
+                        func = function(info) self:AddEmptyMapping(info) end,
+                    },
+                    deleteAll = {
+                        order = 1,
+                        type = "execute",
+                        confirm = true,
+                        confirmText = self.L.Options_Replacements_DeleteAll_ConfirmText,
+                        name = self.L.Options_Replacements_DeleteAll_Name,
+                        desc = self.L.Options_Replacements_DeleteAll_Desc,
+                        func = function(info) self:DeleteAllMappings(info) end,
+                    },
+                    header = {
+                        order = 3,
+                        type = "description",
+                        name = self.L.Options_Replacements_Header,
+                    },
+                    spacer1 = {
+                        order = 4,
+                        type = "header",
+                        name = "",
+                    },
+                },
+            },
+
+            channels = {
+                order = 3,
+                type = "group",
+                name = self.L.Options_Channels_Group_Name,
+                desc = self:Format(self.L.Options_Channels_Group_Desc, self.L.AddonName),
+                args = {
+                    header = {
+                        order = 1,
+                        type = "description",
+                        name = self.L.Options_Channels_Header,
+                    },
+                    spacer2 = {
+                        order = 2,
+                        type = "header",
+                        name = "",
+                    },
+                    say = {
+                        order = 10,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Say_Name,
+                        desc = self:Format(self.L.Options_Channel_Say_Desc, self.L.AddonName),
+                    },
+                    emote = {
+                        order = 11,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Emote_Name,
+                        desc = self:Format(self.L.Options_Channel_Emote_Desc, self.L.AddonName),
+                    },
+                    yell = {
+                        order = 12,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Yell_Name,
+                        desc = self:Format(self.L.Options_Channel_Yell_Desc, self.L.AddonName),
+                    },
+                    party = {
+                        order = 13,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Party_Name,
+                        desc = self:Format(self.L.Options_Channel_Party_Desc, self.L.AddonName),
+                    },
+                    guild = {
+                        order = 14,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Guild_Name,
+                        desc = self:Format(self.L.Options_Channel_Guild_Desc, self.L.AddonName),
+                    },
+                    officer = {
+                        order = 15,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Officer_Name,
+                        desc = self:Format(self.L.Options_Channel_Officer_Desc, self.L.AddonName),
+                    },
+                    raid = {
+                        order = 16,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Raid_Name,
+                        desc = self:Format(self.L.Options_Channel_Raid_Desc, self.L.AddonName),
+                    },
+                    raidWarning = {
+                        order = 17,
+                        type = "toggle",
+                        name = self.L.Options_Channel_RaidWarning_Name,
+                        desc = self:Format(self.L.Options_Channel_RaidWarning_Desc, self.L.AddonName),
+                    },
+                    instance = {
+                        order = 18,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Instance_Name,
+                        desc = self:Format(self.L.Options_Channel_Instance_Desc, self.L.AddonName),
+                    },
+                    battleground = {
+                        order = 19,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Battleground_Name,
+                        desc = self:Format(self.L.Options_Channel_Battleground_Desc, self.L.AddonName),
+                    },
+                    whisper = {
+                        order = 20,
+                        type = "toggle",
+                        name = self.L.Options_Channel_Whisper_Name,
+                        desc = self:Format(self.L.Options_Channel_Whisper_Desc, self.L.AddonName),
+                    },
+                },
+            },
+
+            help = {
+                order = -1,
+                type = "group",
+                childGroups = "tab",
+                name = self.L.Options_Help_Group_Name,
+                desc = self.L.Options_Help_Group_Desc,
+                disabled = false,
+                args = {
+                    basics = {
+                        order = 10,
+                        type = "group",
+                        name = self.L.Options_Help_Tab_Basics_Name,
+                        desc = self.L.Options_Help_Tab_Basics_Desc,
+                        args = {
+                            paragraph1 = {
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Basics,
+                                fontSize = "medium",
+                            },
+                        },
+                    },
+                    expert = {
+                        order = 11,
+                        type = "group",
+                        name = self.L.Options_Help_Tab_Expert_Name,
+                        desc = self.L.Options_Help_Tab_Expert_Desc,
+                        args = {
+                            paragraph4 = {
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Expert,
+                                fontSize = "medium",
+                            },
+                        },
+                    },
+                    examples = {
+                        order = 12,
+                        type = "group",
+                        name = self.L.Options_Help_Tab_Examples_Name,
+                        desc = self.L.Options_Help_Tab_Examples_Desc,
+                        args = {
+                            note = {
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Examples_Note,
+                            },
+                            header = {
+                                order = 2,
+                                type = "description",
+                                name = self.L.Options_Help_Examples0_Header,
+                                fontSize = "medium",
+                                width = 2.5,
+                            },
+                            dropDown = {
+                                order = 3,
+                                type = "select",
+                                name = "",
+                                --width = 1,
+                                values = {
+                                    self.L.Options_Help_Examples1_Select,
+                                    self.L.Options_Help_Examples2_Select,
+                                    self.L.Options_Help_Examples3_Select,
+                                    self.L.Options_Help_Examples4_Select,
+                                    self.L.Options_Help_Examples5_Select,
+                                    self.L.Options_Help_Examples6_Select,
+--                                  self.L.Options_Help_Examples7_Select,
+                                },
+                                set = function(info, val) selectedExample = val end,
+                                get = function(_)
+                                    self.options.args.help.args.examples.args.header.name = self.L["Options_Help_Examples" .. selectedExample .. "_Header"]
+                                    self.options.args.help.args.examples.args.example.name = self.L["Options_Help_Examples" .. selectedExample .. "_Text"]
+                                    self.dialog:SelectGroup(self.name, "help", "examples", "header.name")
+                                    return selectedExample
+                                end,
+                            },
+                            spacer3 = {
+                                order = 4,
+                                type = "header",
+                                name = "",
+                            },
+                            example = {
+                                order = 5,
+                                type = "description",
+                                name = self.L.Options_Help_Examples0_Text,
+                                fontSize = "medium",
+                            },
+                        },
+                    },
+                    disclaimer = {
+                        order = 20,
+                        type = "description",
+                        name = self.L.Options_Help_Disclaimer,
+                    },
+                },
+            },
+        },
+    }
+end
+
+function Grichelde:CreateMapping(offset)
+    return {
+        order = offset or 9999,
+        type = "group",
+        name = function(info) return self:MappingName(info) end,
+        desc = self.L.Options_Mapping_Group_Desc,
+        childGroups = "tree",
+        disabled = function(info) return not self:IsMappingActive(info) end,
+        args = {
+            moveUp = {
+                order = 0,
+                type = "execute",
+                name = "",
+                desc = self.L.Options_Mapping_MoveUp_Desc,
+                image = function(info) return self:GetMoveUpImage(info) end,
+                width = 0.15,
+                func = function(info) self:MoveUp(info) end,
+            },
+            moveDown = {
+                order = 1,
+                type = "execute",
+                name = "",
+                desc = self.L.Options_Mapping_MoveDown_Desc,
+                image = function(info) return self:GetMoveDownImage(info) end,
+                width = 0.15,
+                func = function(info) self:MoveDown(info) end,
+            },
+--[[
+            spacer4 = {
+                order = 2,
+                type = "description",
+                name = "",
+                width = 0.1,
+            },
+]]
+            active = {
+                order = 3,
+                type = "toggle",
+                name = self.L.Options_Mapping_Enabled_Name,
+                desc = self.L.Options_Mapping_Enabled_Desc,
+                width = 2.2,
+            },
+            delete = {
+                order = 4,
+                type = "execute",
+                confirm = true,
+                confirmText = self.L.Options_Mapping_Delete_ConfirmText,
+                name = "",
+                desc = self.L.Options_Mapping_Delete_Desc,
+                image = function(info) return self:GetDeleteImage(info) end,
+                width = 0.1,
+                func = function(info) self:DeleteMapping(info) end,
+            },
+
+            searchText = {
+                order = 10,
+                type = "input",
+                name = self.L.Options_Mapping_SearchText_Name,
+                desc = self.L.Options_Mapping_SearchText_Desc,
+            },
+            replaceText = {
+                order = 11,
+                type = "input",
+                name = self.L.Options_Mapping_ReplaceText_Name,
+                desc = self.L.Options_Mapping_ReplaceText_Desc,
+            },
+
+            exactCase = {
+                order = 20,
+                type = "toggle",
+                name = self.L.Options_Mapping_ExactCase_Name,
+                desc = self.L.Options_Mapping_ExactCase_Desc,
+                width = "full",
+            },
+            consolidate = {
+                order = 21,
+                type = "toggle",
+                name = self.L.Options_Mapping_Consolidate_Name,
+                desc = self.L.Options_Mapping_Consolidate_Desc,
+                width = "full",
+            },
+--[[
+            stopOnMatch = {
+                order = 22,
+                type = "toggle",
+                name = self.L.Options_Mapping_StopOnMatch_Name,
+                desc = self.L.Options_Mapping_StopOnMatch_Desc,
+                width = "full",
+            }
+]]
+        }
+    }
+end
+
+function Grichelde:SetupOptions()
+    -- add DB-backed profiles to UI options
+    local options = self:CreateOptionsUI()
+    options.args.profiles = LibStub("AceDBOptions-3.0"):GetOptionsTable(self.db)
+    options.args.profiles.order = 8
+    options.args.profiles.disabled = false
+
+    -- Adding options to blizzard frame
+    LibStub("AceConfig-3.0"):RegisterOptionsTable(self.name, options)
+    local dialog = LibStub("AceConfigDialog-3.0")
+    dialog:AddToBlizOptions(self.name, self.L.AddonName)
+
+    return options, dialog
+end
+
+function Grichelde:RefreshOptions(event)
+    self:DebugPrint("RefreshOptions : event:", event)
+    local currentProfile = color(Grichelde.COLOR_CODES.GREEN, self.db:GetCurrentProfile())
+    if event == "OnNewProfile" then
+        self:PrefixedPrint(self.L.Profiles_Created, currentProfile)
+    elseif event == "OnProfileChanged" then
+        self:PrefixedPrint(self.L.Profiles_Loaded, currentProfile)
+    elseif event == "OnProfileDeleted" then
+        self:PrefixedPrint(self.L.Profiles_Deleted, currentProfile)
+    elseif event == "OnProfileCopied" then
+        self:PrefixedPrint(self.L.Profiles_Copied, currentProfile)
+    elseif event == "OnProfileReset" then
+        self:PrefixedPrint(self.L.Profiles_Reset, currentProfile)
+    else
+        self:DebugPrint("Refreshing Profile %s on options change: %s", self.db:GetCurrentProfile(), event)
+    end
+
+    self:ReorderReplacements()
+    self:RefreshReplacements(self.db.profile.replacements)
+end
+
+function Grichelde:ToggleOptions()
+    self:DebugPrint("ToggleOptions : options open: ", not not self.dialog.OpenFrames[self.name])
+    if self.dialog ~= nil and self.dialog.OpenFrames[self.name] ~= nil then
+        self:CloseOptions()
+    else
+        self:OpenOptions()
+    end
+end
+
+function Grichelde:OpenOptions()
+    if self.dialog ~= nil then
+        self.dialog:Open(self.name)
+
+        local formatString = self.L.AddonLoaded
+        if not self.db.profile.enabled then
+            formatString = self.L.AddonUnloaded
+        end
+
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        local statusText = self:Format(formatString, namePlusVersion)
+        self.dialog.OpenFrames[self.name]:SetStatusText(statusText)
+    end
+end
+
+function Grichelde:CloseOptions()
+    if self.dialog ~= nil then
+        self.dialog:Close(self.name)
+    end
+end
+
+--- If all replacements were disabled
+-- @return (boolean)
+function Grichelde:IsDisabled(info)
+    if info and info.option.type == "group" then
+        return false
+    end
+    return not self.db.profile.enabled
+end
+
+--- If all replacements were disabled
+-- @return (boolean)
+function Grichelde:IsMappingActive(info)
+    self:TracePrint("IsMappingActive : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    if info and info.option.type == "group" then
+        return true
+    end
+    if not self.db.profile.enabled then
+        return false
+    end
+
+    local replacements = self.db.profile.replacements or {}
+    local currentName = info[2]
+    local uiElem = info[3]
+
+    self:DebugPrint("IsMappingActive : \"%s\"", currentName)
+    self:DebugPrint(replacements[currentName])
+
+    if (tContains({"moveUp", "moveDown", "active", "delete"}, uiElem)) then
+        return true
+    else
+        return not not replacements[currentName].active
+    end
+end
+
+function Grichelde:MappingName(info)
+--  self:TracePrint("MappingName : info")
+--  self:TracePrint(info)
+    local option = self.db.profile.replacements[info[2]]
+
+    if nilOrEmpty(option.searchText) and nilOrEmpty(option.replaceText) then
+        return color(Grichelde.COLOR_CODES.GRAY, self.L.Options_Mapping_EmptyMapping)
+    else
+        local name = self:Format(self.L.Options_Mapping_Group_Name, option.searchText or "", option.replaceText or "")
+        if option.active == true then
+            return name
+        else
+            return color(Grichelde.COLOR_CODES.GRAY, name)
+        end
+    end
+end
+
+
+--- Create UI options for rhe given replacement table (from DB).
+--- Usually called with with self.db.profile.replacements
+-- @param replacementsTable
+function Grichelde:RefreshReplacements(replacementsTable)
+    self:TracePrint("RefreshReplacements : DB table:")
+    self:TracePrint(replacementsTable)
+
+    -- remove all previous replacements from options (not DB), except header and buttons
+    local replacements = self.options.args.replacements.args or {}
+    for k, _ in pairs(replacements) do
+        if k and find(k, "^replacement_") then
+            replacements[k] = nil
+        end
+    end
+
+    for replName, _ in pairs(replacementsTable or {}) do
+        local _, replNumber = self:SplitOnFirstMatch(replName, "_")
+        replacements[replName] = self:CreateMapping(toNumber(replNumber))
+    end
+
+--  self:TracePrint("RefreshReplacements : UI options:")
+--  self:TracePrint(replacements)
+
+    self.dialog:ConfigTableChanged(nil, self.name)
+end
+
+function Grichelde:AddEmptyMapping()
+    local replacements = self.db.profile.replacements or {}
+
+    self:DebugPrint("AddEmptyMapping : old DB entries:")
+    self:DebugPrint(replacements)
+
+    local maxRepl = Grichelde.MAPPING_OFFSET
+    for replName, _ in pairs(replacements) do
+        local num = match(replName, "^replacement_(%d+)")
+        if num and maxRepl < toNumber(num) then
+            maxRepl = toNumber(num)
+        end
+    end
+
+    local newMapping = "replacement_" .. toString(maxRepl + 1)
+    self:DebugPrint("AddEmptyMapping : new mapping key:", newMapping)
+
+    -- do NOT set self.db.profile.replacements = {} it will break defaults
+    replacements[newMapping].order = toString(maxRepl + 1)    -- will be reordered anyway
+    self:DebugPrint("AddEmptyMapping : new DB entries:")
+    self:DebugPrint(replacements)
+
+    self:RefreshOptions("AddEmptyMapping " .. newMapping)
+    self.dialog:SelectGroup(self.name, "replacements", newMapping)
+end
+
+function Grichelde:MoveUp(info)
+    self:TracePrint("MoveUp : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local replacements = self.db.profile.replacements or {}
+    local currentName = info[2]
+
+    self:DebugPrint("MoveUp : \"%s\"", currentName)
+    self:DebugPrint(replacements[currentName])
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    -- if not on top
+    if currentOrder ~= Grichelde.MAPPING_OFFSET then
+        local swapName = "replacement_" .. toString(currentOrder - 1)
+
+        -- swap ordering
+        self:DebugPrint("swap with option %s", swapName)
+
+        replacements[swapName].order = currentOrder
+        replacements[currentName].order = currentOrder - 1
+
+        self:RefreshOptions("MoveUp " .. currentName)
+
+        self:DebugPrint("MoveUp : refresh focus on %s", swapName)
+        self.dialog:SelectGroup(self.name, "replacements", swapName)
+    else
+        self:DebugPrint("MoveUp : already on top")
+    end
+end
+
+function Grichelde:MoveDown(info)
+    self:TracePrint("MoveDown : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local replacements = self.db.profile.replacements or {}
+    local currentName = info[2]
+
+    self:DebugPrint("MoveDown : \"%s\"", currentName)
+    self:DebugPrint(replacements[currentName])
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    local maxRepl = Grichelde.MAPPING_OFFSET
+    for replName, _ in pairs(replacements) do
+        local num = match(replName, "^replacement_(%d+)")
+        if num and maxRepl < toNumber(num) then
+            maxRepl = toNumber(num)
+        end
+    end
+
+    -- if not last element
+    self:DebugPrint("MoveDown : maxRepl: %d", maxRepl)
+    if currentOrder < maxRepl then
+        local swapName = "replacement_" .. toString(currentOrder + 1)
+
+        -- swap ordering
+        self:DebugPrint("swap with option %s", swapName)
+
+        replacements[swapName].order = currentOrder
+        replacements[currentName].order = currentOrder + 1
+
+        self:RefreshOptions("MoveDown " .. currentName)
+
+        self:DebugPrint("MoveDown : refresh focus on %s", swapName)
+        self.dialog:SelectGroup(self.name, "replacements", swapName)
+    else
+        self:DebugPrint("MoveDown : already at bottom")
+    end
+end
+
+function Grichelde:GetMoveUpImage(info)
+    self:TracePrint("GetMoveUpImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local currentName = info[2]
+    self:DebugPrint("GetMoveUpImage : \"%s\"", currentName)
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    if (self:IsMappingActive(info) and currentOrder > Grichelde.MAPPING_OFFSET ) then
+        return Grichelde.ICONS.MOVE_UP
+    else
+        return Grichelde.ICONS.MOVE_UP_DISABLED
+    end
+end
+
+function Grichelde:GetMoveDownImage(info)
+    self:TracePrint("GetMoveDownImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local currentName = info[2]
+    self:DebugPrint("GetMoveDownImage : \"%s\"", currentName)
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    local maxRepl = Grichelde.MAPPING_OFFSET
+    local replacements = self.db.profile.replacements or {}
+    for replName, _ in pairs(replacements) do
+        local num = match(replName, "^replacement_(%d+)")
+        if num and maxRepl < toNumber(num) then
+            maxRepl = toNumber(num)
+        end
+    end
+
+    if (self:IsMappingActive(info) and currentOrder < maxRepl) then
+        return Grichelde.ICONS.MOVE_DOWN
+    else
+        return Grichelde.ICONS.MOVE_DOWN_DISABLED
+    end
+end
+
+function Grichelde:GetDeleteImage(info)
+    self:TracePrint("GetDeleteImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    if (self:IsMappingActive(info)) then
+        return Grichelde.ICONS.DELETE
+    else
+        return Grichelde.ICONS.DELETE_DISABLED
+    end
+end
+
+function Grichelde:DeleteMapping(info)
+    self:TracePrint("DeleteMapping : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local currentName = info[2]
+
+    self:DebugPrint("delete option: %s", currentName)
+    self.db.profile.replacements[currentName] = nil
+
+    self:RefreshOptions("DeleteMapping " .. currentName)
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local newMapping = "replacement_" .. toNumber(replNumber - 1)
+    self.dialog:SelectGroup(self.name, "replacements", newMapping)
+end
+
+function Grichelde:DeleteAllMappings()
+    self:DebugPrint("DeleteAllMappings")
+
+    -- do NOT set self.db.profile.replacements = {} it will break defaults
+    tWipe(self.db.profile.replacements)
+    self:AddEmptyMapping()
+
+    self:RefreshOptions("DeleteAllMappings")
+end

GricheldeUpgrade.lua

@@ -0,0 +1,109 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local pairs, find, color, cOrange, toNumber = Grichelde.functions.pairs, Grichelde.functions.find, Grichelde.functions.color, Grichelde.functions.cOrange, Grichelde.functions.toNumber
+
+function Grichelde:Upgrade_To_v060()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.6.0"))
+
+    local replacements = self.db.profile.replacements or {}
+    self:DebugPrint("Upgrade_To_v060 : old database")
+    self:DebugPrint(replacements)
+
+    for _, replTable in pairs(replacements) do
+        replTable["ignoreCase"] = not replTable["caseSensitive"]
+        replTable["caseSensitive"] = nil
+    end
+
+    self:DebugPrint("Upgrade_To_v060 : new database")
+    self:DebugPrint(replacements)
+    return 0, 6, 0
+end
+
+function Grichelde:Upgrade_To_v070()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.7.0"))
+
+    local replacements = self.db.profile.replacements or {}
+    self:DebugPrint("Upgrade_To_v070 : old replacements")
+    self:DebugPrint(replacements)
+
+    for _, replTable in pairs(replacements) do
+        replTable["exactCase"] = not replTable["ignoreCase"]
+        replTable["ignoreCase"] = nil
+    end
+
+    self:DebugPrint("Upgrade_To_v070 : new replacements")
+    self:DebugPrint(replacements)
+    return 0, 7, 0
+end
+
+function Grichelde:Upgrade_To_v072()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.7.2"))
+
+    self:DebugPrint("Upgrade_To_v072 : old database")
+    self:DebugPrint(self.db.profile)
+
+    self.db.profile["minimapButton"] = { hide = false }
+
+    self:DebugPrint("Upgrade_To_v072 : new database")
+    self:DebugPrint(self.db.profile)
+    return 0, 7, 2
+end
+
+function Grichelde:Upgrade_To_v080()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.8.0"))
+
+    local replacements = self.db.profile.replacements or {}
+    self:DebugPrint("Upgrade_To_v080 : old replacements")
+    self:DebugPrint(replacements)
+
+    for _, replTable in pairs(replacements) do
+        replTable["active"] = true
+    end
+
+    self:DebugPrint("Upgrade_To_v080 : new replacements")
+    self:DebugPrint(self.db.profile)
+    return 0, 8, 0
+end
+
+function Grichelde:UpgradeDatabase()
+    local dbVersion = self.db.global.version or "0.0.0"
+    self:DebugPrint("Database version:", dbVersion)
+
+    local _, _, maj, min, pat = find(dbVersion, "(%d+)%.(%d+)%.(%d+).*")
+    local major, minor, patch = toNumber(maj) or 0, toNumber(min) or 0, toNumber(pat) or 0
+
+    local upgrade = 0
+    local error = false
+
+    if major == 0 then
+        if minor < 6 then
+            upgrade = upgrade + 1
+            major, minor, patch = self:Upgrade_To_v060(dbVersion)
+        end
+        if minor < 7 then
+            upgrade = upgrade + 1
+            major, minor, patch = self:Upgrade_To_v070(dbVersion)
+        end
+        if minor == 7 then
+            if patch < 2 then
+                upgrade = upgrade + 1
+                major, minor, patch = self:Upgrade_To_v072(dbVersion)
+            end
+        end
+        if minor < 8 then
+            upgrade = upgrade + 1
+            major, minor, patch = self:Upgrade_To_v080(dbVersion)
+        end
+    end
+
+    if upgrade == 0 then
+        self:DebugPrint("Database up-to-date")
+    else
+        if not error then
+            self.db.global.version = self.version
+            self:PrefixedPrint(color(Grichelde.COLOR_CODES.GREEN, self.L.Upgrade_Successful))
+        end
+    end
+end

GricheldeUtils.lua

@@ -0,0 +1,247 @@
+-- import addon read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local type, print, pairs, tSize, select, unpack, find, color, cGray, cDarkgray, cPrefix, format, rep, toString
+    = Grichelde.functions.type, Grichelde.functions.print, Grichelde.functions.pairs, Grichelde.functions.tSize, Grichelde.functions.select, Grichelde.functions.unpack, Grichelde.functions.find, Grichelde.functions.color,  Grichelde.functions.cGray, Grichelde.functions.cDarkgray, Grichelde.functions.cPrefix, Grichelde.functions.format, Grichelde.functions.rep, Grichelde.functions.toString
+
+-- show strings differently to distinguish them from numbers
+local function plainValue(val)
+    if val == nil then
+        return "<nil>"
+    elseif type(val) == "string" then
+        return '"' .. val .. '"'
+    elseif type(val) == "table" then
+        if tSize(val) > 0 then
+            return toString(val)
+        else
+            return "{}"
+        end
+    else
+        return toString(val)
+    end
+end
+
+--- Prints any value to default channel, do NOT return a string.
+local function tPrint(val, indent, known, printFunc)
+    local printF = printFunc or print
+    indent = indent or 0
+    known = known or {}
+
+    if val == nil then
+        printF(rep(" ", indent) .. "<nil>")
+    elseif type(val) == "string" then
+        printF(rep(" ", indent) .. "\"" .. val .. "\"")
+    elseif type(val) == "table" then
+        if tSize(val) > 0 then
+            for key, value in pairs(val) do
+                if value == nil then
+                    printF(rep(" ", indent) .. plainValue(key) .. " = <nil>")
+                elseif type(value) == "table" then
+                    printF(rep(" ", indent) .. plainValue(key) .. " = {")
+                    if tSize(value) > 0 then
+                        if not known[value] then
+                            tPrint(value, indent + 4, known, printF)
+                            known[value] = true
+                        else
+                            printF("<known table> " .. plainValue(value))
+                        end
+                    end
+                    printF(rep(" ", indent) .. "}")
+                else
+                    printF(rep(" ", indent) .. plainValue(key) .. " = " .. plainValue(value))
+                end
+            end
+        else
+            printF(rep(" ", indent) .. "{}")
+        end
+    else
+        printF(rep(" ", indent) .. toString(val))
+    end
+end
+
+--- Splits at first word of a text line
+function Grichelde:SplitOnFirstMatch(text, delimPattern, start)
+    if text == nil then return nil end
+    local pattern = "^(.-)" .. (delimPattern or " " ) .."(.*)"
+    local pos = start or 1
+    self:TracePrint("SplitOnFirstMatch : text: %s, pattern: %s, start: %d", text, pattern, start)
+    local _, _, left, right = find(text, pattern, pos)
+    self:TracePrint("SplitOnFirstMatch : left: %s, right: %s", left, right)
+    return left or text, right
+end
+
+--- Splits at last word of a text line
+function Grichelde:SplitOnLastMatch(text, delimPattern, start)
+    local pattern = "(.*)" .. (delimPattern or " ") .. "(.-)$"
+    local pos = start or 1
+    self:TracePrint("SplitOnLastMatch : text: %s, pattern: %s, start: %d", text, pattern, start)
+    local _, _, left, right = find(text, pattern, pos)
+    self:TracePrint("SplitOnLastMatch : left: %s, right: %s", left, right)
+    return left, right or text
+end
+
+--- Splits at last word of a text line
+function Grichelde:TestMatch(text, pattern)
+    local pos1, pos2, left, right = find(text, pattern, 1)
+    self:DebugPrint("TestMatch : pos1: %d, pos2: %d, left: %s, right: %s", pos1, pos2, left, right)
+end
+
+function Grichelde:Format(message, ...)
+    if ( not message ) then
+        return "<nil>"
+    elseif type(message) == "string" then
+        if ( not find(message, "%%")) then
+            return message, ...
+        else
+            local l = select("#", ...)
+            if l > 0 then
+                -- sanitize nil values in vararg
+                local packed = { ... }
+                for i = 1, l do
+                    packed[i] = toString(packed[i]) or "nil"
+                end
+--              print("packed = ", packed)
+--              self:tPrint(packed)
+                -- cannot assign unpacked to a vararg variable and print it for debug
+                -- Manually set count as unpack() stops on nil (bug with #table)
+                return format(message, unpack(packed, 1, l))
+            end
+        end
+    end
+end
+
+--- deprecated
+function Grichelde:Print(...)
+    print(self:Format(...))
+end
+
+function Grichelde:PrefixedPrint(...)
+    print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+end
+
+function Grichelde:ErrorPrint(...)
+    print(cPrefix(self.L.AddonName) .. ": " .. color(self.COLOR_CODES.RED, self:Format(...)))
+end
+
+function Grichelde:DebugPrint(obj, ...)
+    self:LogPrint(Grichelde.LOG_LEVEL.DEBUG, function(...)
+        print(cGray(self.L.AddonName) .. ":", self:Format(...))
+    end, obj, ...)
+end
+
+function Grichelde:TracePrint(obj, ...)
+    self:LogPrint(Grichelde.LOG_LEVEL.TRACE, function(...)
+        print(cDarkgray(self.L.AddonName) .. ":", self:Format(...))
+    end, obj, ...)
+end
+
+function Grichelde:LogPrint(logLevel, printFunc, obj, ...)
+    if (self.logLevel >= logLevel) then
+        local printF = printFunc or print
+        if obj == nil then
+            printF("<nil>")
+        else
+            if type(obj) == "string" then
+                local l = select("#", ...)
+                if ( l == 0 or not find(obj, "%%")) then
+                    printF(obj, ...)
+                else
+                    -- sanitize nil values in vararg
+                    local packed = { ... }
+                    for i = 1, l do
+                        packed[i] = toString(packed[i]) or "nil"
+                    end
+
+--                  print("packed = ", packed)
+--                  self:tPrint(packed)
+                    -- cannot assign unpacked to a vararg variable and print it for debug
+                    local fmtMsg = format(obj, unpack(packed, 1, l)) -- manually set count as unpack() stops on nil (bug with #table)
+                    printF(fmtMsg)
+                end
+            elseif type(obj) == "table" then
+                tPrint(obj, 0, {}, printF)
+            else
+                printF(plainValue(obj))
+            end
+        end
+    end
+end
+
+--- Print UI options to chat frame
+function Grichelde:PrintOptions()
+    self:PrefixedPrint(cPrefix(self.L.Debug_Options))
+    self:LogPrint(-1, function(...)
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+    end, self.options.args.replacements.args)
+end
+
+--- Print current DB profile
+function Grichelde:PrintProfile()
+    self:PrefixedPrint(cPrefix(self.L.Debug_Profile))
+    self:LogPrint(-1, function(...)
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+    end, self.db.profile)
+end
+
+--- Print DB replacements to chat frame
+function Grichelde:PrintMappings()
+    self:PrefixedPrint(cPrefix(self.L.Debug_Mappings))
+    self:LogPrint(-1, function(...)
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+    end, self.db.profile.replacements)
+end
+
+--- Open window with DB replacements in it
+function Grichelde:ToogleMappings()
+    local AceGUI = LibStub("AceGUI-3.0")
+
+    if self.debugFrame then
+        AceGUI:Release(self.debugFrame)
+        self.debugFrame = nil
+    else
+        local replacements = self.db.profile.replacements or {}
+        local repls = 0
+        for k, _ in pairs(replacements) do
+            if k and find(k, "^replacement_") then
+                repls = repls + 1
+            end
+        end
+
+        local frame = AceGUI:Create("Frame");
+        frame:SetTitle(self.L.Debug_Mappings);
+        frame:SetStatusText(self:Format(self.L.Debug_Mappings_Found, repls))
+        frame:SetWidth(400);
+        frame:SetAutoAdjustHeight(true)
+        --frame:SetFullHeight(true)
+        frame:SetLayout("Flow");
+        local function closeFrame(widget) AceGUI:Release(widget); self.debugFrame = nil end
+        frame:SetCallback("OnClose", closeFrame)
+
+        local hint = AceGUI:Create("Label");
+        hint:SetText(self.L.Debug_Mappings_Hint)
+        hint:SetFullWidth(true)
+        frame:AddChild(hint);
+
+        local scroll = AceGUI:Create("ScrollFrame");
+        scroll:SetFullWidth(true)
+        scroll:SetFullHeight(true)
+        scroll:SetLayout("Fill");
+
+        local configBox = AceGUI:Create("MultiLineEditBox");
+        configBox:SetLabel("")
+        local text = ""
+        tPrint(replacements, 0, {}, function(s) text = text .. s .. "|n" end)
+        configBox:SetText(text)
+        configBox:SetFullWidth(true)
+        --configBox:SetFullHeight(true)
+        configBox:DisableButton(true)
+        --configBox:SetDisabled(true)
+        configBox:SetNumLines(50);
+        configBox:SetFocus()
+        scroll:AddChild(configBox);
+
+        frame:AddChild(scroll);
+        self.debugFrame = frame
+    end
+end

Libs/AceConfig-3.0/AceConfig-3.0.lua

@@ -0,0 +1,58 @@
+--- AceConfig-3.0 wrapper library.
+-- Provides an API to register an options table with the config registry,
+-- as well as associate it with a slash command.
+-- @class file
+-- @name AceConfig-3.0
+-- @release $Id: AceConfig-3.0.lua 1161 2017-08-12 14:30:16Z funkydude $
+
+--[[
+AceConfig-3.0
+
+Very light wrapper library that combines all the AceConfig subcomponents into one more easily used whole.
+
+]]
+
+local cfgreg = LibStub("AceConfigRegistry-3.0")
+local cfgcmd = LibStub("AceConfigCmd-3.0")
+
+local MAJOR, MINOR = "AceConfig-3.0", 3
+local AceConfig = LibStub:NewLibrary(MAJOR, MINOR)
+
+if not AceConfig then return end
+
+--TODO: local cfgdlg = LibStub("AceConfigDialog-3.0", true)
+--TODO: local cfgdrp = LibStub("AceConfigDropdown-3.0", true)
+
+-- Lua APIs
+local pcall, error, type, pairs = pcall, error, type, pairs
+
+-- -------------------------------------------------------------------
+-- :RegisterOptionsTable(appName, options, slashcmd, persist)
+--
+-- - appName - (string) application name
+-- - options - table or function ref, see AceConfigRegistry
+-- - slashcmd - slash command (string) or table with commands, or nil to NOT create a slash command
+
+--- Register a option table with the AceConfig registry.
+-- You can supply a slash command (or a table of slash commands) to register with AceConfigCmd directly.
+-- @paramsig appName, options [, slashcmd]
+-- @param appName The application name for the config table.
+-- @param options The option table (or a function to generate one on demand).  http://www.wowace.com/addons/ace3/pages/ace-config-3-0-options-tables/
+-- @param slashcmd A slash command to register for the option table, or a table of slash commands.
+-- @usage
+-- local AceConfig = LibStub("AceConfig-3.0")
+-- AceConfig:RegisterOptionsTable("MyAddon", myOptions, {"/myslash", "/my"})
+function AceConfig:RegisterOptionsTable(appName, options, slashcmd)
+	local ok,msg = pcall(cfgreg.RegisterOptionsTable, self, appName, options)
+	if not ok then error(msg, 2) end
+	
+	if slashcmd then
+		if type(slashcmd) == "table" then
+			for _,cmd in pairs(slashcmd) do
+				cfgcmd:CreateChatCommand(cmd, appName)
+			end
+		else
+			cfgcmd:CreateChatCommand(slashcmd, appName)
+		end
+	end
+end

Libs/AceConfig-3.0/AceConfig-3.0.xml

@@ -0,0 +1,8 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Include file="AceConfigRegistry-3.0\AceConfigRegistry-3.0.xml"/>
+	<Include file="AceConfigCmd-3.0\AceConfigCmd-3.0.xml"/>
+	<Include file="AceConfigDialog-3.0\AceConfigDialog-3.0.xml"/>
+	<!--<Include file="AceConfigDropdown-3.0\AceConfigDropdown-3.0.xml"/>-->
+	<Script file="AceConfig-3.0.lua"/>
+</Ui>

Libs/AceConfig-3.0/AceConfigCmd-3.0/AceConfigCmd-3.0.lua

@@ -0,0 +1,794 @@
+--- AceConfigCmd-3.0 handles access to an options table through the "command line" interface via the ChatFrames.
+-- @class file
+-- @name AceConfigCmd-3.0
+-- @release $Id: AceConfigCmd-3.0.lua 1161 2017-08-12 14:30:16Z funkydude $
+
+--[[
+AceConfigCmd-3.0
+
+Handles commandline optionstable access
+
+REQUIRES: AceConsole-3.0 for command registration (loaded on demand)
+
+]]
+
+-- TODO: plugin args
+
+local cfgreg = LibStub("AceConfigRegistry-3.0")
+
+local MAJOR, MINOR = "AceConfigCmd-3.0", 14
+local AceConfigCmd = LibStub:NewLibrary(MAJOR, MINOR)
+
+if not AceConfigCmd then return end
+
+AceConfigCmd.commands = AceConfigCmd.commands or {}
+local commands = AceConfigCmd.commands
+
+local AceConsole -- LoD
+local AceConsoleName = "AceConsole-3.0"
+
+-- Lua APIs
+local strsub, strsplit, strlower, strmatch, strtrim = string.sub, string.split, string.lower, string.match, string.trim
+local format, tonumber, tostring = string.format, tonumber, tostring
+local tsort, tinsert = table.sort, table.insert
+local select, pairs, next, type = select, pairs, next, type
+local error, assert = error, assert
+
+-- WoW APIs
+local _G = _G
+
+-- Global vars/functions that we don't upvalue since they might get hooked, or upgraded
+-- List them here for Mikk's FindGlobals script
+-- GLOBALS: LibStub, SELECTED_CHAT_FRAME, DEFAULT_CHAT_FRAME
+
+
+local L = setmetatable({}, {	-- TODO: replace with proper locale
+	__index = function(self,k) return k end
+})
+
+
+
+local function print(msg)
+	(SELECTED_CHAT_FRAME or DEFAULT_CHAT_FRAME):AddMessage(msg)
+end
+
+-- constants used by getparam() calls below
+
+local handlertypes = {["table"]=true}
+local handlermsg = "expected a table"
+
+local functypes = {["function"]=true, ["string"]=true}
+local funcmsg = "expected function or member name"
+
+
+-- pickfirstset() - picks the first non-nil value and returns it
+
+local function pickfirstset(...)	
+	for i=1,select("#",...) do
+		if select(i,...)~=nil then
+			return select(i,...)
+		end
+	end
+end
+
+
+-- err() - produce real error() regarding malformed options tables etc
+
+local function err(info,inputpos,msg )
+	local cmdstr=" "..strsub(info.input, 1, inputpos-1)
+	error(MAJOR..": /" ..info[0] ..cmdstr ..": "..(msg or "malformed options table"), 2)
+end
+
+
+-- usererr() - produce chatframe message regarding bad slash syntax etc
+
+local function usererr(info,inputpos,msg )
+	local cmdstr=strsub(info.input, 1, inputpos-1);
+	print("/" ..info[0] .. " "..cmdstr ..": "..(msg or "malformed options table"))
+end
+
+
+-- callmethod() - call a given named method (e.g. "get", "set") with given arguments
+
+local function callmethod(info, inputpos, tab, methodtype, ...)
+	local method = info[methodtype]
+	if not method then
+		err(info, inputpos, "'"..methodtype.."': not set")
+	end
+
+	info.arg = tab.arg
+	info.option = tab
+	info.type = tab.type
+
+	if type(method)=="function" then
+		return method(info, ...)
+	elseif type(method)=="string" then
+		if type(info.handler[method])~="function" then
+			err(info, inputpos, "'"..methodtype.."': '"..method.."' is not a member function of "..tostring(info.handler))
+		end
+		return info.handler[method](info.handler, info, ...)
+	else
+		assert(false)	-- type should have already been checked on read
+	end
+end
+
+-- callfunction() - call a given named function (e.g. "name", "desc") with given arguments
+
+local function callfunction(info, tab, methodtype, ...)
+	local method = tab[methodtype]
+
+	info.arg = tab.arg
+	info.option = tab
+	info.type = tab.type
+	
+	if type(method)=="function" then
+		return method(info, ...)
+	else
+		assert(false) -- type should have already been checked on read
+	end
+end
+
+-- do_final() - do the final step (set/execute) along with validation and confirmation
+
+local function do_final(info, inputpos, tab, methodtype, ...)
+	if info.validate then 
+		local res = callmethod(info,inputpos,tab,"validate",...)
+		if type(res)=="string" then
+			usererr(info, inputpos, "'"..strsub(info.input, inputpos).."' - "..res)
+			return
+		end
+	end
+	-- console ignores .confirm
+	
+	callmethod(info,inputpos,tab,methodtype, ...)
+end
+
+
+-- getparam() - used by handle() to retreive and store "handler", "get", "set", etc
+
+local function getparam(info, inputpos, tab, depth, paramname, types, errormsg)
+	local old,oldat = info[paramname], info[paramname.."_at"]
+	local val=tab[paramname]
+	if val~=nil then
+		if val==false then
+			val=nil
+		elseif not types[type(val)] then 
+			err(info, inputpos, "'" .. paramname.. "' - "..errormsg) 
+		end
+		info[paramname] = val
+		info[paramname.."_at"] = depth
+	end
+	return old,oldat
+end
+
+
+-- iterateargs(tab) - custom iterator that iterates both t.args and t.plugins.*
+local dummytable={}
+
+local function iterateargs(tab)
+	if not tab.plugins then 
+		return pairs(tab.args) 
+	end
+	
+	local argtabkey,argtab=next(tab.plugins)
+	local v
+	
+	return function(_, k)
+		while argtab do
+			k,v = next(argtab, k)
+			if k then return k,v end
+			if argtab==tab.args then
+				argtab=nil
+			else
+				argtabkey,argtab = next(tab.plugins, argtabkey)
+				if not argtabkey then
+					argtab=tab.args
+				end
+			end
+		end
+	end
+end
+
+local function checkhidden(info, inputpos, tab)
+	if tab.cmdHidden~=nil then
+		return tab.cmdHidden
+	end
+	local hidden = tab.hidden
+	if type(hidden) == "function" or type(hidden) == "string" then
+		info.hidden = hidden
+		hidden = callmethod(info, inputpos, tab, 'hidden')
+		info.hidden = nil
+	end
+	return hidden
+end
+
+local function showhelp(info, inputpos, tab, depth, noHead)
+	if not noHead then
+		print("|cff33ff99"..info.appName.."|r: Arguments to |cffffff78/"..info[0].."|r "..strsub(info.input,1,inputpos-1)..":")
+	end
+	
+	local sortTbl = {}	-- [1..n]=name
+	local refTbl = {}   -- [name]=tableref
+	
+	for k,v in iterateargs(tab) do
+		if not refTbl[k] then	-- a plugin overriding something in .args
+			tinsert(sortTbl, k)
+			refTbl[k] = v
+		end
+	end
+	
+	tsort(sortTbl, function(one, two) 
+		local o1 = refTbl[one].order or 100
+		local o2 = refTbl[two].order or 100
+		if type(o1) == "function" or type(o1) == "string" then
+			info.order = o1
+			info[#info+1] = one
+			o1 = callmethod(info, inputpos, refTbl[one], "order")
+			info[#info] = nil
+			info.order = nil
+		end
+		if type(o2) == "function" or type(o1) == "string" then
+			info.order = o2
+			info[#info+1] = two
+			o2 = callmethod(info, inputpos, refTbl[two], "order")
+			info[#info] = nil
+			info.order = nil
+		end
+		if o1<0 and o2<0 then return o1<o2 end
+		if o2<0 then return true end
+		if o1<0 then return false end
+		if o1==o2 then return tostring(one)<tostring(two) end   -- compare names
+		return o1<o2
+	end)
+	
+	for i = 1, #sortTbl do
+		local k = sortTbl[i]
+		local v = refTbl[k]
+		if not checkhidden(info, inputpos, v) then
+			if v.type ~= "description" and v.type ~= "header" then
+				-- recursively show all inline groups
+				local name, desc = v.name, v.desc
+				if type(name) == "function" then
+					name = callfunction(info, v, 'name')
+				end
+				if type(desc) == "function" then
+					desc = callfunction(info, v, 'desc')
+				end
+				if v.type == "group" and pickfirstset(v.cmdInline, v.inline, false) then
+					print("  "..(desc or name)..":")
+					local oldhandler,oldhandler_at = getparam(info, inputpos, v, depth, "handler", handlertypes, handlermsg)
+					showhelp(info, inputpos, v, depth, true)
+					info.handler,info.handler_at = oldhandler,oldhandler_at
+				else
+					local key = k:gsub(" ", "_")
+					print("  |cffffff78"..key.."|r - "..(desc or name or ""))
+				end
+			end
+		end
+	end
+end
+
+
+local function keybindingValidateFunc(text)
+	if text == nil or text == "NONE" then
+		return nil
+	end
+	text = text:upper()
+	local shift, ctrl, alt
+	local modifier
+	while true do
+		if text == "-" then
+			break
+		end
+		modifier, text = strsplit('-', text, 2)
+		if text then
+			if modifier ~= "SHIFT" and modifier ~= "CTRL" and modifier ~= "ALT" then
+				return false
+			end
+			if modifier == "SHIFT" then
+				if shift then
+					return false
+				end
+				shift = true
+			end
+			if modifier == "CTRL" then
+				if ctrl then
+					return false
+				end
+				ctrl = true
+			end
+			if modifier == "ALT" then
+				if alt then
+					return false
+				end
+				alt = true
+			end
+		else
+			text = modifier
+			break
+		end
+	end
+	if text == "" then
+		return false
+	end
+	if not text:find("^F%d+$") and text ~= "CAPSLOCK" and text:len() ~= 1 and (text:byte() < 128 or text:len() > 4) and not _G["KEY_" .. text] then
+		return false
+	end
+	local s = text
+	if shift then
+		s = "SHIFT-" .. s
+	end
+	if ctrl then
+		s = "CTRL-" .. s
+	end
+	if alt then
+		s = "ALT-" .. s
+	end
+	return s
+end
+
+-- handle() - selfrecursing function that processes input->optiontable 
+-- - depth - starts at 0
+-- - retfalse - return false rather than produce error if a match is not found (used by inlined groups)
+
+local function handle(info, inputpos, tab, depth, retfalse)
+
+	if not(type(tab)=="table" and type(tab.type)=="string") then err(info,inputpos) end
+
+	-------------------------------------------------------------------
+	-- Grab hold of handler,set,get,func,etc if set (and remember old ones)
+	-- Note that we do NOT validate if method names are correct at this stage,
+	-- the handler may change before they're actually used!
+
+	local oldhandler,oldhandler_at = getparam(info,inputpos,tab,depth,"handler",handlertypes,handlermsg)
+	local oldset,oldset_at = getparam(info,inputpos,tab,depth,"set",functypes,funcmsg)
+	local oldget,oldget_at = getparam(info,inputpos,tab,depth,"get",functypes,funcmsg)
+	local oldfunc,oldfunc_at = getparam(info,inputpos,tab,depth,"func",functypes,funcmsg)
+	local oldvalidate,oldvalidate_at = getparam(info,inputpos,tab,depth,"validate",functypes,funcmsg)
+	--local oldconfirm,oldconfirm_at = getparam(info,inputpos,tab,depth,"confirm",functypes,funcmsg)
+	
+	-------------------------------------------------------------------
+	-- Act according to .type of this table
+		
+	if tab.type=="group" then
+		------------ group --------------------------------------------
+		
+		if type(tab.args)~="table" then err(info, inputpos) end
+		if tab.plugins and type(tab.plugins)~="table" then err(info,inputpos) end
+		
+		-- grab next arg from input
+		local _,nextpos,arg = (info.input):find(" *([^ ]+) *", inputpos)
+		if not arg then
+			showhelp(info, inputpos, tab, depth)
+			return
+		end
+		nextpos=nextpos+1
+		
+		-- loop .args and try to find a key with a matching name
+		for k,v in iterateargs(tab) do
+			if not(type(k)=="string" and type(v)=="table" and type(v.type)=="string") then err(info,inputpos, "options table child '"..tostring(k).."' is malformed") end
+			
+			-- is this child an inline group? if so, traverse into it
+			if v.type=="group" and pickfirstset(v.cmdInline, v.inline, false) then
+				info[depth+1] = k
+				if handle(info, inputpos, v, depth+1, true)==false then
+					info[depth+1] = nil
+					-- wasn't found in there, but that's ok, we just keep looking down here
+				else
+					return	-- done, name was found in inline group
+				end
+			-- matching name and not a inline group
+			elseif strlower(arg)==strlower(k:gsub(" ", "_")) then
+				info[depth+1] = k
+				return handle(info,nextpos,v,depth+1)
+			end
+		end
+			
+		-- no match 
+		if retfalse then
+			-- restore old infotable members and return false to indicate failure
+			info.handler,info.handler_at = oldhandler,oldhandler_at
+			info.set,info.set_at = oldset,oldset_at
+			info.get,info.get_at = oldget,oldget_at
+			info.func,info.func_at = oldfunc,oldfunc_at
+			info.validate,info.validate_at = oldvalidate,oldvalidate_at
+			--info.confirm,info.confirm_at = oldconfirm,oldconfirm_at
+			return false
+		end
+		
+		-- couldn't find the command, display error
+		usererr(info, inputpos, "'"..arg.."' - " .. L["unknown argument"])
+		return
+	end
+	
+	local str = strsub(info.input,inputpos);
+	
+	if tab.type=="execute" then
+		------------ execute --------------------------------------------
+		do_final(info, inputpos, tab, "func")
+		
+
+	
+	elseif tab.type=="input" then
+		------------ input --------------------------------------------
+		
+		local res = true
+		if tab.pattern then
+			if not(type(tab.pattern)=="string") then err(info, inputpos, "'pattern' - expected a string") end
+			if not strmatch(str, tab.pattern) then
+				usererr(info, inputpos, "'"..str.."' - " .. L["invalid input"])
+				return
+			end
+		end
+		
+		do_final(info, inputpos, tab, "set", str)
+		
+
+	
+	elseif tab.type=="toggle" then
+		------------ toggle --------------------------------------------
+		local b
+		local str = strtrim(strlower(str))
+		if str=="" then
+			b = callmethod(info, inputpos, tab, "get")
+
+			if tab.tristate then
+				--cycle in true, nil, false order
+				if b then
+					b = nil
+				elseif b == nil then
+					b = false
+				else
+					b = true
+				end
+			else
+				b = not b
+			end
+			
+		elseif str==L["on"] then
+			b = true
+		elseif str==L["off"] then
+			b = false
+		elseif tab.tristate and str==L["default"] then
+			b = nil
+		else
+			if tab.tristate then
+				usererr(info, inputpos, format(L["'%s' - expected 'on', 'off' or 'default', or no argument to toggle."], str))
+			else
+				usererr(info, inputpos, format(L["'%s' - expected 'on' or 'off', or no argument to toggle."], str))
+			end
+			return
+		end
+		
+		do_final(info, inputpos, tab, "set", b)
+		
+
+	elseif tab.type=="range" then
+		------------ range --------------------------------------------
+		local val = tonumber(str)
+		if not val then
+			usererr(info, inputpos, "'"..str.."' - "..L["expected number"])
+			return
+		end
+		if type(info.step)=="number" then
+			val = val- (val % info.step)
+		end
+		if type(info.min)=="number" and val<info.min then
+			usererr(info, inputpos, val.." - "..format(L["must be equal to or higher than %s"], tostring(info.min)) )
+			return
+		end
+		if type(info.max)=="number" and val>info.max then
+			usererr(info, inputpos, val.." - "..format(L["must be equal to or lower than %s"], tostring(info.max)) )
+			return
+		end
+		
+		do_final(info, inputpos, tab, "set", val)
+
+	
+	elseif tab.type=="select" then
+		------------ select ------------------------------------
+		local str = strtrim(strlower(str))
+		
+		local values = tab.values
+		if type(values) == "function" or type(values) == "string" then
+			info.values = values
+			values = callmethod(info, inputpos, tab, "values")
+			info.values = nil
+		end
+		
+		if str == "" then
+			local b = callmethod(info, inputpos, tab, "get")
+			local fmt = "|cffffff78- [%s]|r %s"
+			local fmt_sel = "|cffffff78- [%s]|r %s |cffff0000*|r"
+			print(L["Options for |cffffff78"..info[#info].."|r:"])
+			for k, v in pairs(values) do
+				if b == k then
+					print(fmt_sel:format(k, v))
+				else
+					print(fmt:format(k, v))
+				end
+			end
+			return
+		end
+
+		local ok
+		for k,v in pairs(values) do 
+			if strlower(k)==str then
+				str = k	-- overwrite with key (in case of case mismatches)
+				ok = true
+				break
+			end
+		end
+		if not ok then
+			usererr(info, inputpos, "'"..str.."' - "..L["unknown selection"])
+			return
+		end
+		
+		do_final(info, inputpos, tab, "set", str)
+		
+	elseif tab.type=="multiselect" then
+		------------ multiselect -------------------------------------------
+		local str = strtrim(strlower(str))
+		
+		local values = tab.values
+		if type(values) == "function" or type(values) == "string" then
+			info.values = values
+			values = callmethod(info, inputpos, tab, "values")
+			info.values = nil
+		end
+		
+		if str == "" then
+			local fmt = "|cffffff78- [%s]|r %s"
+			local fmt_sel = "|cffffff78- [%s]|r %s |cffff0000*|r"
+			print(L["Options for |cffffff78"..info[#info].."|r (multiple possible):"])
+			for k, v in pairs(values) do
+				if callmethod(info, inputpos, tab, "get", k) then
+					print(fmt_sel:format(k, v))
+				else
+					print(fmt:format(k, v))
+				end
+			end
+			return
+		end
+		
+		--build a table of the selections, checking that they exist
+		--parse for =on =off =default in the process
+		--table will be key = true for options that should toggle, key = [on|off|default] for options to be set
+		local sels = {}
+		for v in str:gmatch("[^ ]+") do
+			--parse option=on etc
+			local opt, val = v:match('(.+)=(.+)')
+			--get option if toggling
+			if not opt then 
+				opt = v 
+			end
+			
+			--check that the opt is valid
+			local ok
+			for k,v in pairs(values) do 
+				if strlower(k)==opt then
+					opt = k	-- overwrite with key (in case of case mismatches)
+					ok = true
+					break
+				end
+			end
+			
+			if not ok then
+				usererr(info, inputpos, "'"..opt.."' - "..L["unknown selection"])
+				return
+			end
+			
+			--check that if val was supplied it is valid
+			if val then
+				if val == L["on"] or val == L["off"] or (tab.tristate and val == L["default"]) then
+					--val is valid insert it
+					sels[opt] = val
+				else
+					if tab.tristate then
+						usererr(info, inputpos, format(L["'%s' '%s' - expected 'on', 'off' or 'default', or no argument to toggle."], v, val))
+					else
+						usererr(info, inputpos, format(L["'%s' '%s' - expected 'on' or 'off', or no argument to toggle."], v, val))
+					end
+					return
+				end
+			else
+				-- no val supplied, toggle
+				sels[opt] = true
+			end
+		end
+		
+		for opt, val in pairs(sels) do
+			local newval
+			
+			if (val == true) then
+				--toggle the option
+				local b = callmethod(info, inputpos, tab, "get", opt)
+				
+				if tab.tristate then
+					--cycle in true, nil, false order
+					if b then
+						b = nil
+					elseif b == nil then
+						b = false
+					else
+						b = true
+					end
+				else
+					b = not b
+				end
+				newval = b
+			else
+				--set the option as specified
+				if val==L["on"] then
+					newval = true
+				elseif val==L["off"] then
+					newval = false
+				elseif val==L["default"] then
+					newval = nil
+				end
+			end
+			
+			do_final(info, inputpos, tab, "set", opt, newval)
+		end
+					
+		
+	elseif tab.type=="color" then
+		------------ color --------------------------------------------
+		local str = strtrim(strlower(str))
+		if str == "" then
+			--TODO: Show current value
+			return
+		end
+		
+		local r, g, b, a
+		
+		local hasAlpha = tab.hasAlpha
+		if type(hasAlpha) == "function" or type(hasAlpha) == "string" then
+			info.hasAlpha = hasAlpha
+			hasAlpha = callmethod(info, inputpos, tab, 'hasAlpha')
+			info.hasAlpha = nil
+		end
+		
+		if hasAlpha then
+			if str:len() == 8 and str:find("^%x*$")  then
+				--parse a hex string
+				r,g,b,a = tonumber(str:sub(1, 2), 16) / 255, tonumber(str:sub(3, 4), 16) / 255, tonumber(str:sub(5, 6), 16) / 255, tonumber(str:sub(7, 8), 16) / 255
+			else
+				--parse seperate values
+				r,g,b,a = str:match("^([%d%.]+) ([%d%.]+) ([%d%.]+) ([%d%.]+)$")
+				r,g,b,a = tonumber(r), tonumber(g), tonumber(b), tonumber(a)
+			end
+			if not (r and g and b and a) then
+				usererr(info, inputpos, format(L["'%s' - expected 'RRGGBBAA' or 'r g b a'."], str))
+				return
+			end
+			
+			if r >= 0.0 and r <= 1.0 and g >= 0.0 and g <= 1.0 and b >= 0.0 and b <= 1.0 and a >= 0.0 and a <= 1.0 then
+				--values are valid
+			elseif r >= 0 and r <= 255 and g >= 0 and g <= 255 and b >= 0 and b <= 255 and a >= 0 and a <= 255 then
+				--values are valid 0..255, convert to 0..1
+				r = r / 255
+				g = g / 255
+				b = b / 255
+				a = a / 255
+			else
+				--values are invalid
+				usererr(info, inputpos, format(L["'%s' - values must all be either in the range 0..1 or 0..255."], str))
+			end
+		else
+			a = 1.0
+			if str:len() == 6 and str:find("^%x*$") then
+				--parse a hex string
+				r,g,b = tonumber(str:sub(1, 2), 16) / 255, tonumber(str:sub(3, 4), 16) / 255, tonumber(str:sub(5, 6), 16) / 255
+			else
+				--parse seperate values
+				r,g,b = str:match("^([%d%.]+) ([%d%.]+) ([%d%.]+)$")
+				r,g,b = tonumber(r), tonumber(g), tonumber(b)
+			end
+			if not (r and g and b) then
+				usererr(info, inputpos, format(L["'%s' - expected 'RRGGBB' or 'r g b'."], str))
+				return
+			end
+			if r >= 0.0 and r <= 1.0 and g >= 0.0 and g <= 1.0 and b >= 0.0 and b <= 1.0 then
+				--values are valid
+			elseif r >= 0 and r <= 255 and g >= 0 and g <= 255 and b >= 0 and b <= 255 then
+				--values are valid 0..255, convert to 0..1
+				r = r / 255
+				g = g / 255
+				b = b / 255
+			else
+				--values are invalid
+				usererr(info, inputpos, format(L["'%s' - values must all be either in the range 0-1 or 0-255."], str))
+			end
+		end
+		
+		do_final(info, inputpos, tab, "set", r,g,b,a)
+
+	elseif tab.type=="keybinding" then
+		------------ keybinding --------------------------------------------
+		local str = strtrim(strlower(str))
+		if str == "" then
+			--TODO: Show current value
+			return
+		end
+		local value = keybindingValidateFunc(str:upper())
+		if value == false then
+			usererr(info, inputpos, format(L["'%s' - Invalid Keybinding."], str))
+			return
+		end
+
+		do_final(info, inputpos, tab, "set", value)
+
+	elseif tab.type=="description" then
+		------------ description --------------------
+		-- ignore description, GUI config only
+	else
+		err(info, inputpos, "unknown options table item type '"..tostring(tab.type).."'")
+	end
+end
+
+--- Handle the chat command.
+-- This is usually called from a chat command handler to parse the command input as operations on an aceoptions table.\\
+-- AceConfigCmd uses this function internally when a slash command is registered with `:CreateChatCommand`
+-- @param slashcmd The slash command WITHOUT leading slash (only used for error output)
+-- @param appName The application name as given to `:RegisterOptionsTable()`
+-- @param input The commandline input (as given by the WoW handler, i.e. without the command itself)
+-- @usage
+-- MyAddon = LibStub("AceAddon-3.0"):NewAddon("MyAddon", "AceConsole-3.0")
+-- -- Use AceConsole-3.0 to register a Chat Command
+-- MyAddon:RegisterChatCommand("mychat", "ChatCommand")
+-- 
+-- -- Show the GUI if no input is supplied, otherwise handle the chat input.
+-- function MyAddon:ChatCommand(input)
+--   -- Assuming "MyOptions" is the appName of a valid options table
+--   if not input or input:trim() == "" then
+--     LibStub("AceConfigDialog-3.0"):Open("MyOptions")
+--   else
+--     LibStub("AceConfigCmd-3.0").HandleCommand(MyAddon, "mychat", "MyOptions", input)
+--   end
+-- end
+function AceConfigCmd:HandleCommand(slashcmd, appName, input)
+
+	local optgetter = cfgreg:GetOptionsTable(appName)
+	if not optgetter then
+		error([[Usage: HandleCommand("slashcmd", "appName", "input"): 'appName' - no options table "]]..tostring(appName)..[[" has been registered]], 2)
+	end
+	local options = assert( optgetter("cmd", MAJOR) )
+	
+	local info = {   -- Don't try to recycle this, it gets handed off to callbacks and whatnot
+		[0] = slashcmd,
+		appName = appName,
+		options = options,
+		input = input,
+		self = self,
+		handler = self,
+		uiType = "cmd",
+		uiName = MAJOR,
+	}
+	
+	handle(info, 1, options, 0)  -- (info, inputpos, table, depth)
+end
+
+--- Utility function to create a slash command handler.
+-- Also registers tab completion with AceTab
+-- @param slashcmd The slash command WITHOUT leading slash (only used for error output)
+-- @param appName The application name as given to `:RegisterOptionsTable()`
+function AceConfigCmd:CreateChatCommand(slashcmd, appName)
+	if not AceConsole then
+		AceConsole = LibStub(AceConsoleName)
+	end
+	if AceConsole.RegisterChatCommand(self, slashcmd, function(input)
+				AceConfigCmd.HandleCommand(self, slashcmd, appName, input)	-- upgradable
+		end,
+	true) then -- succesfully registered so lets get the command -> app table in
+		commands[slashcmd] = appName
+	end
+end
+
+--- Utility function that returns the options table that belongs to a slashcommand.
+-- Designed to be used for the AceTab interface.
+-- @param slashcmd The slash command WITHOUT leading slash (only used for error output)
+-- @return The options table associated with the slash command (or nil if the slash command was not registered)
+function AceConfigCmd:GetChatCommandOptions(slashcmd)
+	return commands[slashcmd]
+end

Libs/AceConfig-3.0/AceConfigCmd-3.0/AceConfigCmd-3.0.xml

@@ -0,0 +1,4 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Script file="AceConfigCmd-3.0.lua"/>
+</Ui>

Libs/AceConfig-3.0/AceConfigDialog-3.0/AceConfigDialog-3.0.xml

@@ -0,0 +1,4 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Script file="AceConfigDialog-3.0.lua"/>
+</Ui>

Libs/AceConfig-3.0/AceConfigRegistry-3.0/AceConfigRegistry-3.0.lua

@@ -0,0 +1,350 @@
+--- AceConfigRegistry-3.0 handles central registration of options tables in use by addons and modules.\\
+-- Options tables can be registered as raw tables, OR as function refs that return a table.\\
+-- Such functions receive three arguments: "uiType", "uiName", "appName". \\
+-- * Valid **uiTypes**: "cmd", "dropdown", "dialog". This is verified by the library at call time. \\
+-- * The **uiName** field is expected to contain the full name of the calling addon, including version, e.g. "FooBar-1.0". This is verified by the library at call time.\\
+-- * The **appName** field is the options table name as given at registration time \\
+-- 
+-- :IterateOptionsTables() (and :GetOptionsTable() if only given one argument) return a function reference that the requesting config handling addon must call with valid "uiType", "uiName".
+-- @class file
+-- @name AceConfigRegistry-3.0
+-- @release $Id: AceConfigRegistry-3.0.lua 1169 2018-02-27 16:18:28Z nevcairiel $
+local CallbackHandler = LibStub("CallbackHandler-1.0")
+
+local MAJOR, MINOR = "AceConfigRegistry-3.0", 18
+local AceConfigRegistry = LibStub:NewLibrary(MAJOR, MINOR)
+
+if not AceConfigRegistry then return end
+
+AceConfigRegistry.tables = AceConfigRegistry.tables or {}
+
+if not AceConfigRegistry.callbacks then
+	AceConfigRegistry.callbacks = CallbackHandler:New(AceConfigRegistry)
+end
+
+-- Lua APIs
+local tinsert, tconcat = table.insert, table.concat
+local strfind, strmatch = string.find, string.match
+local type, tostring, select, pairs = type, tostring, select, pairs
+local error, assert = error, assert
+
+-----------------------------------------------------------------------
+-- Validating options table consistency:
+
+
+AceConfigRegistry.validated = {
+	-- list of options table names ran through :ValidateOptionsTable automatically. 
+	-- CLEARED ON PURPOSE, since newer versions may have newer validators
+	cmd = {},
+	dropdown = {},
+	dialog = {},
+}
+
+
+
+local function err(msg, errlvl, ...)
+	local t = {}
+	for i=select("#",...),1,-1 do
+		tinsert(t, (select(i, ...)))
+	end
+	error(MAJOR..":ValidateOptionsTable(): "..tconcat(t,".")..msg, errlvl+2)
+end
+
+
+local isstring={["string"]=true, _="string"}
+local isstringfunc={["string"]=true,["function"]=true, _="string or funcref"}
+local istable={["table"]=true,   _="table"}
+local ismethodtable={["table"]=true,["string"]=true,["function"]=true,   _="methodname, funcref or table"}
+local optstring={["nil"]=true,["string"]=true, _="string"}
+local optstringfunc={["nil"]=true,["string"]=true,["function"]=true, _="string or funcref"}
+local optstringnumberfunc={["nil"]=true,["string"]=true,["number"]=true,["function"]=true, _="string, number or funcref"}
+local optnumber={["nil"]=true,["number"]=true, _="number"}
+local optmethod={["nil"]=true,["string"]=true,["function"]=true, _="methodname or funcref"}
+local optmethodfalse={["nil"]=true,["string"]=true,["function"]=true,["boolean"]={[false]=true},  _="methodname, funcref or false"}
+local optmethodnumber={["nil"]=true,["string"]=true,["function"]=true,["number"]=true,  _="methodname, funcref or number"}
+local optmethodtable={["nil"]=true,["string"]=true,["function"]=true,["table"]=true,  _="methodname, funcref or table"}
+local optmethodbool={["nil"]=true,["string"]=true,["function"]=true,["boolean"]=true,  _="methodname, funcref or boolean"}
+local opttable={["nil"]=true,["table"]=true,  _="table"}
+local optbool={["nil"]=true,["boolean"]=true,  _="boolean"}
+local optboolnumber={["nil"]=true,["boolean"]=true,["number"]=true,  _="boolean or number"}
+local optstringnumber={["nil"]=true,["string"]=true,["number"]=true, _="string or number"}
+
+local basekeys={
+	type=isstring,
+	name=isstringfunc,
+	desc=optstringfunc,
+	descStyle=optstring,
+	order=optmethodnumber,
+	validate=optmethodfalse,
+	confirm=optmethodbool,
+	confirmText=optstring,
+	disabled=optmethodbool,
+	hidden=optmethodbool,
+		guiHidden=optmethodbool,
+		dialogHidden=optmethodbool,
+		dropdownHidden=optmethodbool,
+	cmdHidden=optmethodbool,
+	icon=optstringnumberfunc,
+	iconCoords=optmethodtable,
+	handler=opttable,
+	get=optmethodfalse,
+	set=optmethodfalse,
+	func=optmethodfalse,
+	arg={["*"]=true},
+	width=optstringnumber,
+}
+
+local typedkeys={
+	header={},
+	description={
+		image=optstringnumberfunc,
+		imageCoords=optmethodtable,
+		imageHeight=optnumber,
+		imageWidth=optnumber,
+		fontSize=optstringfunc,
+	},
+	group={
+		args=istable,
+		plugins=opttable,
+		inline=optbool,
+			cmdInline=optbool,
+			guiInline=optbool,
+			dropdownInline=optbool,
+			dialogInline=optbool,
+		childGroups=optstring,
+	},
+	execute={
+		image=optstringnumberfunc,
+		imageCoords=optmethodtable,
+		imageHeight=optnumber,
+		imageWidth=optnumber,
+	},
+	input={
+		pattern=optstring,
+		usage=optstring,
+		control=optstring,
+		dialogControl=optstring,
+		dropdownControl=optstring,
+		multiline=optboolnumber,
+	},
+	toggle={
+		tristate=optbool,
+		image=optstringnumberfunc,
+		imageCoords=optmethodtable,
+	},
+	tristate={
+	},
+	range={
+		min=optnumber,
+		softMin=optnumber,
+		max=optnumber,
+		softMax=optnumber,
+		step=optnumber,
+		bigStep=optnumber,
+		isPercent=optbool,
+	},
+	select={
+		values=ismethodtable,
+		style={
+			["nil"]=true, 
+			["string"]={dropdown=true,radio=true}, 
+			_="string: 'dropdown' or 'radio'"
+		},
+		control=optstring,
+		dialogControl=optstring,
+		dropdownControl=optstring,
+		itemControl=optstring,
+	},
+	multiselect={
+		values=ismethodtable,
+		style=optstring,
+		tristate=optbool,
+		control=optstring,
+		dialogControl=optstring,
+		dropdownControl=optstring,
+	},
+	color={
+		hasAlpha=optmethodbool,
+	},
+	keybinding={
+		-- TODO
+	},
+}
+
+local function validateKey(k,errlvl,...)
+	errlvl=(errlvl or 0)+1
+	if type(k)~="string" then
+		err("["..tostring(k).."] - key is not a string", errlvl,...)
+	end
+	if strfind(k, "[%c\127]") then
+		err("["..tostring(k).."] - key name contained control characters", errlvl,...)
+	end
+end
+
+local function validateVal(v, oktypes, errlvl,...)
+	errlvl=(errlvl or 0)+1
+	local isok=oktypes[type(v)] or oktypes["*"]
+
+	if not isok then
+		err(": expected a "..oktypes._..", got '"..tostring(v).."'", errlvl,...)
+	end
+	if type(isok)=="table" then		-- isok was a table containing specific values to be tested for!
+		if not isok[v] then
+			err(": did not expect "..type(v).." value '"..tostring(v).."'", errlvl,...)
+		end
+	end
+end
+
+local function validate(options,errlvl,...)
+	errlvl=(errlvl or 0)+1
+	-- basic consistency
+	if type(options)~="table" then
+		err(": expected a table, got a "..type(options), errlvl,...)
+	end
+	if type(options.type)~="string" then
+		err(".type: expected a string, got a "..type(options.type), errlvl,...)
+	end
+	
+	-- get type and 'typedkeys' member
+	local tk = typedkeys[options.type]
+	if not tk then
+		err(".type: unknown type '"..options.type.."'", errlvl,...)
+	end
+	
+	-- make sure that all options[] are known parameters
+	for k,v in pairs(options) do
+		if not (tk[k] or basekeys[k]) then
+			err(": unknown parameter", errlvl,tostring(k),...)
+		end
+	end
+
+	-- verify that required params are there, and that everything is the right type
+	for k,oktypes in pairs(basekeys) do
+		validateVal(options[k], oktypes, errlvl,k,...)
+	end
+	for k,oktypes in pairs(tk) do
+		validateVal(options[k], oktypes, errlvl,k,...)
+	end
+
+	-- extra logic for groups
+	if options.type=="group" then
+		for k,v in pairs(options.args) do
+			validateKey(k,errlvl,"args",...)
+			validate(v, errlvl,k,"args",...)
+		end
+		if options.plugins then
+			for plugname,plugin in pairs(options.plugins) do
+				if type(plugin)~="table" then
+					err(": expected a table, got '"..tostring(plugin).."'", errlvl,tostring(plugname),"plugins",...)
+				end
+				for k,v in pairs(plugin) do
+					validateKey(k,errlvl,tostring(plugname),"plugins",...)
+					validate(v, errlvl,k,tostring(plugname),"plugins",...)
+				end
+			end
+		end
+	end
+end
+
+
+--- Validates basic structure and integrity of an options table \\
+-- Does NOT verify that get/set etc actually exist, since they can be defined at any depth
+-- @param options The table to be validated
+-- @param name The name of the table to be validated (shown in any error message)
+-- @param errlvl (optional number) error level offset, default 0 (=errors point to the function calling :ValidateOptionsTable)
+function AceConfigRegistry:ValidateOptionsTable(options,name,errlvl)
+	errlvl=(errlvl or 0)+1
+	name = name or "Optionstable"
+	if not options.name then
+		options.name=name	-- bit of a hack, the root level doesn't really need a .name :-/
+	end
+	validate(options,errlvl,name)
+end
+
+--- Fires a "ConfigTableChange" callback for those listening in on it, allowing config GUIs to refresh.
+-- You should call this function if your options table changed from any outside event, like a game event
+-- or a timer.
+-- @param appName The application name as given to `:RegisterOptionsTable()`
+function AceConfigRegistry:NotifyChange(appName)
+	if not AceConfigRegistry.tables[appName] then return end
+	AceConfigRegistry.callbacks:Fire("ConfigTableChange", appName)
+end
+
+-- -------------------------------------------------------------------
+-- Registering and retreiving options tables:
+
+
+-- validateGetterArgs: helper function for :GetOptionsTable (or, rather, the getter functions returned by it)
+
+local function validateGetterArgs(uiType, uiName, errlvl)
+	errlvl=(errlvl or 0)+2
+	if uiType~="cmd" and uiType~="dropdown" and uiType~="dialog" then
+		error(MAJOR..": Requesting options table: 'uiType' - invalid configuration UI type, expected 'cmd', 'dropdown' or 'dialog'", errlvl)
+	end
+	if not strmatch(uiName, "[A-Za-z]%-[0-9]") then	-- Expecting e.g. "MyLib-1.2"
+		error(MAJOR..": Requesting options table: 'uiName' - badly formatted or missing version number. Expected e.g. 'MyLib-1.2'", errlvl)
+	end
+end
+
+--- Register an options table with the config registry.
+-- @param appName The application name as given to `:RegisterOptionsTable()`
+-- @param options The options table, OR a function reference that generates it on demand. \\
+-- See the top of the page for info on arguments passed to such functions.
+-- @param skipValidation Skip options table validation (primarily useful for extremely huge options, with a noticeable slowdown)
+function AceConfigRegistry:RegisterOptionsTable(appName, options, skipValidation)
+	if type(options)=="table" then
+		if options.type~="group" then	-- quick sanity checker
+			error(MAJOR..": RegisterOptionsTable(appName, options): 'options' - missing type='group' member in root group", 2)
+		end
+		AceConfigRegistry.tables[appName] = function(uiType, uiName, errlvl)
+			errlvl=(errlvl or 0)+1
+			validateGetterArgs(uiType, uiName, errlvl)
+			if not AceConfigRegistry.validated[uiType][appName] and not skipValidation then
+				AceConfigRegistry:ValidateOptionsTable(options, appName, errlvl)	-- upgradable
+				AceConfigRegistry.validated[uiType][appName] = true
+			end
+			return options 
+		end
+	elseif type(options)=="function" then
+		AceConfigRegistry.tables[appName] = function(uiType, uiName, errlvl)
+			errlvl=(errlvl or 0)+1
+			validateGetterArgs(uiType, uiName, errlvl)
+			local tab = assert(options(uiType, uiName, appName))
+			if not AceConfigRegistry.validated[uiType][appName] and not skipValidation then
+				AceConfigRegistry:ValidateOptionsTable(tab, appName, errlvl)	-- upgradable
+				AceConfigRegistry.validated[uiType][appName] = true
+			end
+			return tab
+		end
+	else
+		error(MAJOR..": RegisterOptionsTable(appName, options): 'options' - expected table or function reference", 2)
+	end
+end
+
+--- Returns an iterator of ["appName"]=funcref pairs
+function AceConfigRegistry:IterateOptionsTables()
+	return pairs(AceConfigRegistry.tables)
+end
+
+
+
+
+--- Query the registry for a specific options table.
+-- If only appName is given, a function is returned which you
+-- can call with (uiType,uiName) to get the table.\\
+-- If uiType&uiName are given, the table is returned.
+-- @param appName The application name as given to `:RegisterOptionsTable()`
+-- @param uiType The type of UI to get the table for, one of "cmd", "dropdown", "dialog"
+-- @param uiName The name of the library/addon querying for the table, e.g. "MyLib-1.0"
+function AceConfigRegistry:GetOptionsTable(appName, uiType, uiName)
+	local f = AceConfigRegistry.tables[appName]
+	if not f then
+		return nil
+	end
+	
+	if uiType then
+		return f(uiType,uiName,1)	-- get the table for us
+	else
+		return f	-- return the function
+	end
+end

Libs/AceConfig-3.0/AceConfigRegistry-3.0/AceConfigRegistry-3.0.xml

@@ -0,0 +1,4 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Script file="AceConfigRegistry-3.0.lua"/>
+</Ui>

Libs/AceDB-3.0/AceDB-3.0.lua

@@ -0,0 +1,746 @@
+--- **AceDB-3.0** manages the SavedVariables of your addon.
+-- It offers profile management, smart defaults and namespaces for modules.\\
+-- Data can be saved in different data-types, depending on its intended usage.
+-- The most common data-type is the `profile` type, which allows the user to choose
+-- the active profile, and manage the profiles of all of his characters.\\
+-- The following data types are available:
+-- * **char** Character-specific data. Every character has its own database.
+-- * **realm** Realm-specific data. All of the players characters on the same realm share this database.
+-- * **class** Class-specific data. All of the players characters of the same class share this database.
+-- * **race** Race-specific data. All of the players characters of the same race share this database.
+-- * **faction** Faction-specific data. All of the players characters of the same faction share this database.
+-- * **factionrealm** Faction and realm specific data. All of the players characters on the same realm and of the same faction share this database.
+-- * **locale** Locale specific data, based on the locale of the players game client.
+-- * **global** Global Data. All characters on the same account share this database.
+-- * **profile** Profile-specific data. All characters using the same profile share this database. The user can control which profile should be used.
+--
+-- Creating a new Database using the `:New` function will return a new DBObject. A database will inherit all functions
+-- of the DBObjectLib listed here. \\
+-- If you create a new namespaced child-database (`:RegisterNamespace`), you'll get a DBObject as well, but note
+-- that the child-databases cannot individually change their profile, and are linked to their parents profile - and because of that,
+-- the profile related APIs are not available. Only `:RegisterDefaults` and `:ResetProfile` are available on child-databases.
+--
+-- For more details on how to use AceDB-3.0, see the [[AceDB-3.0 Tutorial]].
+--
+-- You may also be interested in [[libdualspec-1-0|LibDualSpec-1.0]] to do profile switching automatically when switching specs.
+--
+-- @usage
+-- MyAddon = LibStub("AceAddon-3.0"):NewAddon("DBExample")
+--
+-- -- declare defaults to be used in the DB
+-- local defaults = {
+--   profile = {
+--     setting = true,
+--   }
+-- }
+--
+-- function MyAddon:OnInitialize()
+--   -- Assuming the .toc says ## SavedVariables: MyAddonDB
+--   self.db = LibStub("AceDB-3.0"):New("MyAddonDB", defaults, true)
+-- end
+-- @class file
+-- @name AceDB-3.0.lua
+-- @release $Id: AceDB-3.0.lua 1142 2016-07-11 08:36:19Z nevcairiel $
+local ACEDB_MAJOR, ACEDB_MINOR = "AceDB-3.0", 26
+local AceDB, oldminor = LibStub:NewLibrary(ACEDB_MAJOR, ACEDB_MINOR)
+
+if not AceDB then return end -- No upgrade needed
+
+-- Lua APIs
+local type, pairs, next, error = type, pairs, next, error
+local setmetatable, getmetatable, rawset, rawget = setmetatable, getmetatable, rawset, rawget
+
+-- WoW APIs
+local _G = _G
+
+-- Global vars/functions that we don't upvalue since they might get hooked, or upgraded
+-- List them here for Mikk's FindGlobals script
+-- GLOBALS: LibStub
+
+AceDB.db_registry = AceDB.db_registry or {}
+AceDB.frame = AceDB.frame or CreateFrame("Frame")
+
+local CallbackHandler
+local CallbackDummy = { Fire = function() end }
+
+local DBObjectLib = {}
+
+--[[-------------------------------------------------------------------------
+	AceDB Utility Functions
+---------------------------------------------------------------------------]]
+
+-- Simple shallow copy for copying defaults
+local function copyTable(src, dest)
+	if type(dest) ~= "table" then dest = {} end
+	if type(src) == "table" then
+		for k,v in pairs(src) do
+			if type(v) == "table" then
+				-- try to index the key first so that the metatable creates the defaults, if set, and use that table
+				v = copyTable(v, dest[k])
+			end
+			dest[k] = v
+		end
+	end
+	return dest
+end
+
+-- Called to add defaults to a section of the database
+--
+-- When a ["*"] default section is indexed with a new key, a table is returned
+-- and set in the host table.  These tables must be cleaned up by removeDefaults
+-- in order to ensure we don't write empty default tables.
+local function copyDefaults(dest, src)
+	-- this happens if some value in the SV overwrites our default value with a non-table
+	--if type(dest) ~= "table" then return end
+	for k, v in pairs(src) do
+		if k == "*" or k == "**" then
+			if type(v) == "table" then
+				-- This is a metatable used for table defaults
+				local mt = {
+					-- This handles the lookup and creation of new subtables
+					__index = function(t,k)
+							if k == nil then return nil end
+							local tbl = {}
+							copyDefaults(tbl, v)
+							rawset(t, k, tbl)
+							return tbl
+						end,
+				}
+				setmetatable(dest, mt)
+				-- handle already existing tables in the SV
+				for dk, dv in pairs(dest) do
+					if not rawget(src, dk) and type(dv) == "table" then
+						copyDefaults(dv, v)
+					end
+				end
+			else
+				-- Values are not tables, so this is just a simple return
+				local mt = {__index = function(t,k) return k~=nil and v or nil end}
+				setmetatable(dest, mt)
+			end
+		elseif type(v) == "table" then
+			if not rawget(dest, k) then rawset(dest, k, {}) end
+			if type(dest[k]) == "table" then
+				copyDefaults(dest[k], v)
+				if src['**'] then
+					copyDefaults(dest[k], src['**'])
+				end
+			end
+		else
+			if rawget(dest, k) == nil then
+				rawset(dest, k, v)
+			end
+		end
+	end
+end
+
+-- Called to remove all defaults in the default table from the database
+local function removeDefaults(db, defaults, blocker)
+	-- remove all metatables from the db, so we don't accidentally create new sub-tables through them
+	setmetatable(db, nil)
+	-- loop through the defaults and remove their content
+	for k,v in pairs(defaults) do
+		if k == "*" or k == "**" then
+			if type(v) == "table" then
+				-- Loop through all the actual k,v pairs and remove
+				for key, value in pairs(db) do
+					if type(value) == "table" then
+						-- if the key was not explicitly specified in the defaults table, just strip everything from * and ** tables
+						if defaults[key] == nil and (not blocker or blocker[key] == nil) then
+							removeDefaults(value, v)
+							-- if the table is empty afterwards, remove it
+							if next(value) == nil then
+								db[key] = nil
+							end
+						-- if it was specified, only strip ** content, but block values which were set in the key table
+						elseif k == "**" then
+							removeDefaults(value, v, defaults[key])
+						end
+					end
+				end
+			elseif k == "*" then
+				-- check for non-table default
+				for key, value in pairs(db) do
+					if defaults[key] == nil and v == value then
+						db[key] = nil
+					end
+				end
+			end
+		elseif type(v) == "table" and type(db[k]) == "table" then
+			-- if a blocker was set, dive into it, to allow multi-level defaults
+			removeDefaults(db[k], v, blocker and blocker[k])
+			if next(db[k]) == nil then
+				db[k] = nil
+			end
+		else
+			-- check if the current value matches the default, and that its not blocked by another defaults table
+			if db[k] == defaults[k] and (not blocker or blocker[k] == nil) then
+				db[k] = nil
+			end
+		end
+	end
+end
+
+-- This is called when a table section is first accessed, to set up the defaults
+local function initSection(db, section, svstore, key, defaults)
+	local sv = rawget(db, "sv")
+
+	local tableCreated
+	if not sv[svstore] then sv[svstore] = {} end
+	if not sv[svstore][key] then
+		sv[svstore][key] = {}
+		tableCreated = true
+	end
+
+	local tbl = sv[svstore][key]
+
+	if defaults then
+		copyDefaults(tbl, defaults)
+	end
+	rawset(db, section, tbl)
+
+	return tableCreated, tbl
+end
+
+-- Metatable to handle the dynamic creation of sections and copying of sections.
+local dbmt = {
+	__index = function(t, section)
+			local keys = rawget(t, "keys")
+			local key = keys[section]
+			if key then
+				local defaultTbl = rawget(t, "defaults")
+				local defaults = defaultTbl and defaultTbl[section]
+
+				if section == "profile" then
+					local new = initSection(t, section, "profiles", key, defaults)
+					if new then
+						-- Callback: OnNewProfile, database, newProfileKey
+						t.callbacks:Fire("OnNewProfile", t, key)
+					end
+				elseif section == "profiles" then
+					local sv = rawget(t, "sv")
+					if not sv.profiles then sv.profiles = {} end
+					rawset(t, "profiles", sv.profiles)
+				elseif section == "global" then
+					local sv = rawget(t, "sv")
+					if not sv.global then sv.global = {} end
+					if defaults then
+						copyDefaults(sv.global, defaults)
+					end
+					rawset(t, section, sv.global)
+				else
+					initSection(t, section, section, key, defaults)
+				end
+			end
+
+			return rawget(t, section)
+		end
+}
+
+local function validateDefaults(defaults, keyTbl, offset)
+	if not defaults then return end
+	offset = offset or 0
+	for k in pairs(defaults) do
+		if not keyTbl[k] or k == "profiles" then
+			error(("Usage: AceDBObject:RegisterDefaults(defaults): '%s' is not a valid datatype."):format(k), 3 + offset)
+		end
+	end
+end
+
+local preserve_keys = {
+	["callbacks"] = true,
+	["RegisterCallback"] = true,
+	["UnregisterCallback"] = true,
+	["UnregisterAllCallbacks"] = true,
+	["children"] = true,
+}
+
+local realmKey = GetRealmName()
+local charKey = UnitName("player") .. " - " .. realmKey
+local _, classKey = UnitClass("player")
+local _, raceKey = UnitRace("player")
+local factionKey = UnitFactionGroup("player")
+local factionrealmKey = factionKey .. " - " .. realmKey
+local localeKey = GetLocale():lower()
+
+local regionTable = { "US", "KR", "EU", "TW", "CN" }
+local regionKey = regionTable[GetCurrentRegion()]
+local factionrealmregionKey = factionrealmKey .. " - " .. regionKey
+
+-- Actual database initialization function
+local function initdb(sv, defaults, defaultProfile, olddb, parent)
+	-- Generate the database keys for each section
+
+	-- map "true" to our "Default" profile
+	if defaultProfile == true then defaultProfile = "Default" end
+
+	local profileKey
+	if not parent then
+		-- Make a container for profile keys
+		if not sv.profileKeys then sv.profileKeys = {} end
+
+		-- Try to get the profile selected from the char db
+		profileKey = sv.profileKeys[charKey] or defaultProfile or charKey
+
+		-- save the selected profile for later
+		sv.profileKeys[charKey] = profileKey
+	else
+		-- Use the profile of the parents DB
+		profileKey = parent.keys.profile or defaultProfile or charKey
+
+		-- clear the profileKeys in the DB, namespaces don't need to store them
+		sv.profileKeys = nil
+	end
+
+	-- This table contains keys that enable the dynamic creation
+	-- of each section of the table.  The 'global' and 'profiles'
+	-- have a key of true, since they are handled in a special case
+	local keyTbl= {
+		["char"] = charKey,
+		["realm"] = realmKey,
+		["class"] = classKey,
+		["race"] = raceKey,
+		["faction"] = factionKey,
+		["factionrealm"] = factionrealmKey,
+		["factionrealmregion"] = factionrealmregionKey,
+		["profile"] = profileKey,
+		["locale"] = localeKey,
+		["global"] = true,
+		["profiles"] = true,
+	}
+
+	validateDefaults(defaults, keyTbl, 1)
+
+	-- This allows us to use this function to reset an entire database
+	-- Clear out the old database
+	if olddb then
+		for k,v in pairs(olddb) do if not preserve_keys[k] then olddb[k] = nil end end
+	end
+
+	-- Give this database the metatable so it initializes dynamically
+	local db = setmetatable(olddb or {}, dbmt)
+
+	if not rawget(db, "callbacks") then
+		-- try to load CallbackHandler-1.0 if it loaded after our library
+		if not CallbackHandler then CallbackHandler = LibStub:GetLibrary("CallbackHandler-1.0", true) end
+		db.callbacks = CallbackHandler and CallbackHandler:New(db) or CallbackDummy
+	end
+
+	-- Copy methods locally into the database object, to avoid hitting
+	-- the metatable when calling methods
+
+	if not parent then
+		for name, func in pairs(DBObjectLib) do
+			db[name] = func
+		end
+	else
+		-- hack this one in
+		db.RegisterDefaults = DBObjectLib.RegisterDefaults
+		db.ResetProfile = DBObjectLib.ResetProfile
+	end
+
+	-- Set some properties in the database object
+	db.profiles = sv.profiles
+	db.keys = keyTbl
+	db.sv = sv
+	--db.sv_name = name
+	db.defaults = defaults
+	db.parent = parent
+
+	-- store the DB in the registry
+	AceDB.db_registry[db] = true
+
+	return db
+end
+
+-- handle PLAYER_LOGOUT
+-- strip all defaults from all databases
+-- and cleans up empty sections
+local function logoutHandler(frame, event)
+	if event == "PLAYER_LOGOUT" then
+		for db in pairs(AceDB.db_registry) do
+			db.callbacks:Fire("OnDatabaseShutdown", db)
+			db:RegisterDefaults(nil)
+
+			-- cleanup sections that are empty without defaults
+			local sv = rawget(db, "sv")
+			for section in pairs(db.keys) do
+				if rawget(sv, section) then
+					-- global is special, all other sections have sub-entrys
+					-- also don't delete empty profiles on main dbs, only on namespaces
+					if section ~= "global" and (section ~= "profiles" or rawget(db, "parent")) then
+						for key in pairs(sv[section]) do
+							if not next(sv[section][key]) then
+								sv[section][key] = nil
+							end
+						end
+					end
+					if not next(sv[section]) then
+						sv[section] = nil
+					end
+				end
+			end
+		end
+	end
+end
+
+AceDB.frame:RegisterEvent("PLAYER_LOGOUT")
+AceDB.frame:SetScript("OnEvent", logoutHandler)
+
+
+--[[-------------------------------------------------------------------------
+	AceDB Object Method Definitions
+---------------------------------------------------------------------------]]
+
+--- Sets the defaults table for the given database object by clearing any
+-- that are currently set, and then setting the new defaults.
+-- @param defaults A table of defaults for this database
+function DBObjectLib:RegisterDefaults(defaults)
+	if defaults and type(defaults) ~= "table" then
+		error("Usage: AceDBObject:RegisterDefaults(defaults): 'defaults' - table or nil expected.", 2)
+	end
+
+	validateDefaults(defaults, self.keys)
+
+	-- Remove any currently set defaults
+	if self.defaults then
+		for section,key in pairs(self.keys) do
+			if self.defaults[section] and rawget(self, section) then
+				removeDefaults(self[section], self.defaults[section])
+			end
+		end
+	end
+
+	-- Set the DBObject.defaults table
+	self.defaults = defaults
+
+	-- Copy in any defaults, only touching those sections already created
+	if defaults then
+		for section,key in pairs(self.keys) do
+			if defaults[section] and rawget(self, section) then
+				copyDefaults(self[section], defaults[section])
+			end
+		end
+	end
+end
+
+--- Changes the profile of the database and all of it's namespaces to the
+-- supplied named profile
+-- @param name The name of the profile to set as the current profile
+function DBObjectLib:SetProfile(name)
+	if type(name) ~= "string" then
+		error("Usage: AceDBObject:SetProfile(name): 'name' - string expected.", 2)
+	end
+
+	-- changing to the same profile, dont do anything
+	if name == self.keys.profile then return end
+
+	local oldProfile = self.profile
+	local defaults = self.defaults and self.defaults.profile
+
+	-- Callback: OnProfileShutdown, database
+	self.callbacks:Fire("OnProfileShutdown", self)
+
+	if oldProfile and defaults then
+		-- Remove the defaults from the old profile
+		removeDefaults(oldProfile, defaults)
+	end
+
+	self.profile = nil
+	self.keys["profile"] = name
+
+	-- if the storage exists, save the new profile
+	-- this won't exist on namespaces.
+	if self.sv.profileKeys then
+		self.sv.profileKeys[charKey] = name
+	end
+
+	-- populate to child namespaces
+	if self.children then
+		for _, db in pairs(self.children) do
+			DBObjectLib.SetProfile(db, name)
+		end
+	end
+
+	-- Callback: OnProfileChanged, database, newProfileKey
+	self.callbacks:Fire("OnProfileChanged", self, name)
+end
+
+--- Returns a table with the names of the existing profiles in the database.
+-- You can optionally supply a table to re-use for this purpose.
+-- @param tbl A table to store the profile names in (optional)
+function DBObjectLib:GetProfiles(tbl)
+	if tbl and type(tbl) ~= "table" then
+		error("Usage: AceDBObject:GetProfiles(tbl): 'tbl' - table or nil expected.", 2)
+	end
+
+	-- Clear the container table
+	if tbl then
+		for k,v in pairs(tbl) do tbl[k] = nil end
+	else
+		tbl = {}
+	end
+
+	local curProfile = self.keys.profile
+
+	local i = 0
+	for profileKey in pairs(self.profiles) do
+		i = i + 1
+		tbl[i] = profileKey
+		if curProfile and profileKey == curProfile then curProfile = nil end
+	end
+
+	-- Add the current profile, if it hasn't been created yet
+	if curProfile then
+		i = i + 1
+		tbl[i] = curProfile
+	end
+
+	return tbl, i
+end
+
+--- Returns the current profile name used by the database
+function DBObjectLib:GetCurrentProfile()
+	return self.keys.profile
+end
+
+--- Deletes a named profile.  This profile must not be the active profile.
+-- @param name The name of the profile to be deleted
+-- @param silent If true, do not raise an error when the profile does not exist
+function DBObjectLib:DeleteProfile(name, silent)
+	if type(name) ~= "string" then
+		error("Usage: AceDBObject:DeleteProfile(name): 'name' - string expected.", 2)
+	end
+
+	if self.keys.profile == name then
+		error("Cannot delete the active profile in an AceDBObject.", 2)
+	end
+
+	if not rawget(self.profiles, name) and not silent then
+		error("Cannot delete profile '" .. name .. "'. It does not exist.", 2)
+	end
+
+	self.profiles[name] = nil
+
+	-- populate to child namespaces
+	if self.children then
+		for _, db in pairs(self.children) do
+			DBObjectLib.DeleteProfile(db, name, true)
+		end
+	end
+
+	-- switch all characters that use this profile back to the default
+	if self.sv.profileKeys then
+		for key, profile in pairs(self.sv.profileKeys) do
+			if profile == name then
+				self.sv.profileKeys[key] = nil
+			end
+		end
+	end
+
+	-- Callback: OnProfileDeleted, database, profileKey
+	self.callbacks:Fire("OnProfileDeleted", self, name)
+end
+
+--- Copies a named profile into the current profile, overwriting any conflicting
+-- settings.
+-- @param name The name of the profile to be copied into the current profile
+-- @param silent If true, do not raise an error when the profile does not exist
+function DBObjectLib:CopyProfile(name, silent)
+	if type(name) ~= "string" then
+		error("Usage: AceDBObject:CopyProfile(name): 'name' - string expected.", 2)
+	end
+
+	if name == self.keys.profile then
+		error("Cannot have the same source and destination profiles.", 2)
+	end
+
+	if not rawget(self.profiles, name) and not silent then
+		error("Cannot copy profile '" .. name .. "'. It does not exist.", 2)
+	end
+
+	-- Reset the profile before copying
+	DBObjectLib.ResetProfile(self, nil, true)
+
+	local profile = self.profile
+	local source = self.profiles[name]
+
+	copyTable(source, profile)
+
+	-- populate to child namespaces
+	if self.children then
+		for _, db in pairs(self.children) do
+			DBObjectLib.CopyProfile(db, name, true)
+		end
+	end
+
+	-- Callback: OnProfileCopied, database, sourceProfileKey
+	self.callbacks:Fire("OnProfileCopied", self, name)
+end
+
+--- Resets the current profile to the default values (if specified).
+-- @param noChildren if set to true, the reset will not be populated to the child namespaces of this DB object
+-- @param noCallbacks if set to true, won't fire the OnProfileReset callback
+function DBObjectLib:ResetProfile(noChildren, noCallbacks)
+	local profile = self.profile
+
+	for k,v in pairs(profile) do
+		profile[k] = nil
+	end
+
+	local defaults = self.defaults and self.defaults.profile
+	if defaults then
+		copyDefaults(profile, defaults)
+	end
+
+	-- populate to child namespaces
+	if self.children and not noChildren then
+		for _, db in pairs(self.children) do
+			DBObjectLib.ResetProfile(db, nil, noCallbacks)
+		end
+	end
+
+	-- Callback: OnProfileReset, database
+	if not noCallbacks then
+		self.callbacks:Fire("OnProfileReset", self)
+	end
+end
+
+--- Resets the entire database, using the string defaultProfile as the new default
+-- profile.
+-- @param defaultProfile The profile name to use as the default
+function DBObjectLib:ResetDB(defaultProfile)
+	if defaultProfile and type(defaultProfile) ~= "string" then
+		error("Usage: AceDBObject:ResetDB(defaultProfile): 'defaultProfile' - string or nil expected.", 2)
+	end
+
+	local sv = self.sv
+	for k,v in pairs(sv) do
+		sv[k] = nil
+	end
+
+	local parent = self.parent
+
+	initdb(sv, self.defaults, defaultProfile, self)
+
+	-- fix the child namespaces
+	if self.children then
+		if not sv.namespaces then sv.namespaces = {} end
+		for name, db in pairs(self.children) do
+			if not sv.namespaces[name] then sv.namespaces[name] = {} end
+			initdb(sv.namespaces[name], db.defaults, self.keys.profile, db, self)
+		end
+	end
+
+	-- Callback: OnDatabaseReset, database
+	self.callbacks:Fire("OnDatabaseReset", self)
+	-- Callback: OnProfileChanged, database, profileKey
+	self.callbacks:Fire("OnProfileChanged", self, self.keys["profile"])
+
+	return self
+end
+
+--- Creates a new database namespace, directly tied to the database.  This
+-- is a full scale database in it's own rights other than the fact that
+-- it cannot control its profile individually
+-- @param name The name of the new namespace
+-- @param defaults A table of values to use as defaults
+function DBObjectLib:RegisterNamespace(name, defaults)
+	if type(name) ~= "string" then
+		error("Usage: AceDBObject:RegisterNamespace(name, defaults): 'name' - string expected.", 2)
+	end
+	if defaults and type(defaults) ~= "table" then
+		error("Usage: AceDBObject:RegisterNamespace(name, defaults): 'defaults' - table or nil expected.", 2)
+	end
+	if self.children and self.children[name] then
+		error ("Usage: AceDBObject:RegisterNamespace(name, defaults): 'name' - a namespace with that name already exists.", 2)
+	end
+
+	local sv = self.sv
+	if not sv.namespaces then sv.namespaces = {} end
+	if not sv.namespaces[name] then
+		sv.namespaces[name] = {}
+	end
+
+	local newDB = initdb(sv.namespaces[name], defaults, self.keys.profile, nil, self)
+
+	if not self.children then self.children = {} end
+	self.children[name] = newDB
+	return newDB
+end
+
+--- Returns an already existing namespace from the database object.
+-- @param name The name of the new namespace
+-- @param silent if true, the addon is optional, silently return nil if its not found
+-- @usage
+-- local namespace = self.db:GetNamespace('namespace')
+-- @return the namespace object if found
+function DBObjectLib:GetNamespace(name, silent)
+	if type(name) ~= "string" then
+		error("Usage: AceDBObject:GetNamespace(name): 'name' - string expected.", 2)
+	end
+	if not silent and not (self.children and self.children[name]) then
+		error ("Usage: AceDBObject:GetNamespace(name): 'name' - namespace does not exist.", 2)
+	end
+	if not self.children then self.children = {} end
+	return self.children[name]
+end
+
+--[[-------------------------------------------------------------------------
+	AceDB Exposed Methods
+---------------------------------------------------------------------------]]
+
+--- Creates a new database object that can be used to handle database settings and profiles.
+-- By default, an empty DB is created, using a character specific profile.
+--
+-- You can override the default profile used by passing any profile name as the third argument,
+-- or by passing //true// as the third argument to use a globally shared profile called "Default".
+--
+-- Note that there is no token replacement in the default profile name, passing a defaultProfile as "char"
+-- will use a profile named "char", and not a character-specific profile.
+-- @param tbl The name of variable, or table to use for the database
+-- @param defaults A table of database defaults
+-- @param defaultProfile The name of the default profile. If not set, a character specific profile will be used as the default.
+-- You can also pass //true// to use a shared global profile called "Default".
+-- @usage
+-- -- Create an empty DB using a character-specific default profile.
+-- self.db = LibStub("AceDB-3.0"):New("MyAddonDB")
+-- @usage
+-- -- Create a DB using defaults and using a shared default profile
+-- self.db = LibStub("AceDB-3.0"):New("MyAddonDB", defaults, true)
+function AceDB:New(tbl, defaults, defaultProfile)
+	if type(tbl) == "string" then
+		local name = tbl
+		tbl = _G[name]
+		if not tbl then
+			tbl = {}
+			_G[name] = tbl
+		end
+	end
+
+	if type(tbl) ~= "table" then
+		error("Usage: AceDB:New(tbl, defaults, defaultProfile): 'tbl' - table expected.", 2)
+	end
+
+	if defaults and type(defaults) ~= "table" then
+		error("Usage: AceDB:New(tbl, defaults, defaultProfile): 'defaults' - table expected.", 2)
+	end
+
+	if defaultProfile and type(defaultProfile) ~= "string" and defaultProfile ~= true then
+		error("Usage: AceDB:New(tbl, defaults, defaultProfile): 'defaultProfile' - string or true expected.", 2)
+	end
+
+	return initdb(tbl, defaults, defaultProfile)
+end
+
+-- upgrade existing databases
+for db in pairs(AceDB.db_registry) do
+	if not db.parent then
+		for name,func in pairs(DBObjectLib) do
+			db[name] = func
+		end
+	else
+		db.RegisterDefaults = DBObjectLib.RegisterDefaults
+		db.ResetProfile = DBObjectLib.ResetProfile
+	end
+end

Libs/AceDB-3.0/AceDB-3.0.xml

@@ -0,0 +1,4 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Script file="AceDB-3.0.lua"/>
+</Ui>

Libs/AceDBOptions-3.0/AceDBOptions-3.0.lua

@@ -0,0 +1,460 @@
+--- AceDBOptions-3.0 provides a universal AceConfig options screen for managing AceDB-3.0 profiles.
+-- @class file
+-- @name AceDBOptions-3.0
+-- @release $Id: AceDBOptions-3.0.lua 1140 2016-07-03 07:53:29Z nevcairiel $
+local ACEDBO_MAJOR, ACEDBO_MINOR = "AceDBOptions-3.0", 15
+local AceDBOptions, oldminor = LibStub:NewLibrary(ACEDBO_MAJOR, ACEDBO_MINOR)
+
+if not AceDBOptions then return end -- No upgrade needed
+
+-- Lua APIs
+local pairs, next = pairs, next
+
+-- WoW APIs
+local UnitClass = UnitClass
+
+-- Global vars/functions that we don't upvalue since they might get hooked, or upgraded
+-- List them here for Mikk's FindGlobals script
+-- GLOBALS: NORMAL_FONT_COLOR_CODE, FONT_COLOR_CODE_CLOSE
+
+AceDBOptions.optionTables = AceDBOptions.optionTables or {}
+AceDBOptions.handlers = AceDBOptions.handlers or {}
+
+--[[
+	Localization of AceDBOptions-3.0
+]]
+
+local L = {
+	choose = "Existing Profiles",
+	choose_desc = "You can either create a new profile by entering a name in the editbox, or choose one of the already existing profiles.",
+	choose_sub = "Select one of your currently available profiles.",
+	copy = "Copy From",
+	copy_desc = "Copy the settings from one existing profile into the currently active profile.",
+	current = "Current Profile:",
+	default = "Default",
+	delete = "Delete a Profile",
+	delete_confirm = "Are you sure you want to delete the selected profile?",
+	delete_desc = "Delete existing and unused profiles from the database to save space, and cleanup the SavedVariables file.",
+	delete_sub = "Deletes a profile from the database.",
+	intro = "You can change the active database profile, so you can have different settings for every character.",
+	new = "New",
+	new_sub = "Create a new empty profile.",
+	profiles = "Profiles",
+	profiles_sub = "Manage Profiles",
+	reset = "Reset Profile",
+	reset_desc = "Reset the current profile back to its default values, in case your configuration is broken, or you simply want to start over.",
+	reset_sub = "Reset the current profile to the default",
+}
+
+local LOCALE = GetLocale()
+if LOCALE == "deDE" then
+	L["choose"] = "Vorhandene Profile"
+	L["choose_desc"] = "Du kannst ein neues Profil erstellen, indem du einen neuen Namen in der Eingabebox 'Neu' eingibst, oder wähle eines der vorhandenen Profile aus."
+	L["choose_sub"] = "Wählt ein bereits vorhandenes Profil aus."
+	L["copy"] = "Kopieren von..."
+	L["copy_desc"] = "Kopiere die Einstellungen von einem vorhandenen Profil in das aktive Profil."
+	L["current"] = "Aktuelles Profil:"
+	L["default"] = "Standard"
+	L["delete"] = "Profil löschen"
+	L["delete_confirm"] = "Willst du das ausgewählte Profil wirklich löschen?"
+	L["delete_desc"] = "Lösche vorhandene oder unbenutzte Profile aus der Datenbank, um Platz zu sparen und die SavedVariables-Datei 'sauber' zu halten."
+	L["delete_sub"] = "Löscht ein Profil aus der Datenbank."
+	L["intro"] = "Hier kannst du das aktive Datenbankprofil ändern, damit du verschiedene Einstellungen für jeden Charakter erstellen kannst, wodurch eine sehr flexible Konfiguration möglich wird."
+	L["new"] = "Neu"
+	L["new_sub"] = "Ein neues Profil erstellen."
+	L["profiles"] = "Profile"
+	L["profiles_sub"] = "Profile verwalten"
+	L["reset"] = "Profil zurücksetzen"
+	L["reset_desc"] = "Setzt das momentane Profil auf Standardwerte zurück, für den Fall, dass mit der Konfiguration etwas schief lief oder weil du einfach neu starten willst."
+	L["reset_sub"] = "Das aktuelle Profil auf Standard zurücksetzen."
+elseif LOCALE == "frFR" then
+	L["choose"] = "Profils existants"
+	L["choose_desc"] = "Vous pouvez créer un nouveau profil en entrant un nouveau nom dans la boîte de saisie, ou en choississant un des profils déjà existants."
+	L["choose_sub"] = "Permet de choisir un des profils déjà disponibles."
+	L["copy"] = "Copier à partir de"
+	L["copy_desc"] = "Copie les paramètres d'un profil déjà existant dans le profil actuellement actif."
+	L["current"] = "Profil actuel :"
+	L["default"] = "Défaut"
+	L["delete"] = "Supprimer un profil"
+	L["delete_confirm"] = "Etes-vous sûr de vouloir supprimer le profil sélectionné ?"
+	L["delete_desc"] = "Supprime les profils existants inutilisés de la base de données afin de gagner de la place et de nettoyer le fichier SavedVariables."
+	L["delete_sub"] = "Supprime un profil de la base de données."
+	L["intro"] = "Vous pouvez changer le profil actuel afin d'avoir des paramètres différents pour chaque personnage, permettant ainsi d'avoir une configuration très flexible."
+	L["new"] = "Nouveau"
+	L["new_sub"] = "Créée un nouveau profil vierge."
+	L["profiles"] = "Profils"
+	L["profiles_sub"] = "Gestion des profils"
+	L["reset"] = "Réinitialiser le profil"
+	L["reset_desc"] = "Réinitialise le profil actuel au cas où votre configuration est corrompue ou si vous voulez tout simplement faire table rase."
+	L["reset_sub"] = "Réinitialise le profil actuel avec les paramètres par défaut."
+elseif LOCALE == "koKR" then
+	L["choose"] = "저장 중인 프로필"
+	L["choose_desc"] = "입력창에 새로운 이름을 입력하거나 저장 중인 프로필 중 하나를 선택하여 새로운 프로필을 만들 수 있습니다."
+	L["choose_sub"] = "현재 이용할 수 있는 프로필 중 하나를 선택합니다."
+	L["copy"] = "복사해오기"
+	L["copy_desc"] = "현재 사용 중인 프로필에 선택한 프로필의 설정을 복사합니다."
+	L["current"] = "현재 프로필:"
+	L["default"] = "기본값"
+	L["delete"] = "프로필 삭제"
+	L["delete_confirm"] = "정말로 선택한 프로필을 삭제할까요?"
+	L["delete_desc"] = "저장 공간 절약과 SavedVariables 파일의 정리를 위해 데이터베이스에서 사용하지 않는 프로필을 삭제하세요."
+	L["delete_sub"] = "데이터베이스의 프로필을 삭제합니다."
+	L["intro"] = "활성 데이터베이스 프로필을 변경할 수 있고, 각 캐릭터 별로 다른 설정을 할 수 있습니다."
+	L["new"] = "새로운 프로필"
+	L["new_sub"] = "새로운 프로필을 만듭니다."
+	L["profiles"] = "프로필"
+	L["profiles_sub"] = "프로필 관리"
+	L["reset"] = "프로필 초기화"
+	L["reset_desc"] = "설정이 깨졌거나 처음부터 다시 설정을 원하는 경우, 현재 프로필을 기본값으로 초기화하세요."
+	L["reset_sub"] = "현재 프로필을 기본값으로 초기화합니다"
+elseif LOCALE == "esES" or LOCALE == "esMX" then
+	L["choose"] = "Perfiles existentes"
+	L["choose_desc"] = "Puedes crear un nuevo perfil introduciendo un nombre en el recuadro o puedes seleccionar un perfil de los ya existentes."
+	L["choose_sub"] = "Selecciona uno de los perfiles disponibles."
+	L["copy"] = "Copiar de"
+	L["copy_desc"] = "Copia los ajustes de un perfil existente al perfil actual."
+	L["current"] = "Perfil actual:"
+	L["default"] = "Por defecto"
+	L["delete"] = "Borrar un Perfil"
+	L["delete_confirm"] = "¿Estas seguro que quieres borrar el perfil seleccionado?"
+	L["delete_desc"] = "Borra los perfiles existentes y sin uso de la base de datos para ganar espacio y limpiar el archivo SavedVariables."
+	L["delete_sub"] = "Borra un perfil de la base de datos."
+	L["intro"] = "Puedes cambiar el perfil activo de tal manera que cada personaje tenga diferentes configuraciones."
+	L["new"] = "Nuevo"
+	L["new_sub"] = "Crear un nuevo perfil vacio."
+	L["profiles"] = "Perfiles"
+	L["profiles_sub"] = "Manejar Perfiles"
+	L["reset"] = "Reiniciar Perfil"
+	L["reset_desc"] = "Reinicia el perfil actual a los valores por defectos, en caso de que se haya estropeado la configuración o quieras volver a empezar de nuevo."
+	L["reset_sub"] = "Reinicar el perfil actual al de por defecto"
+elseif LOCALE == "zhTW" then
+	L["choose"] = "現有的設定檔"
+	L["choose_desc"] = "您可以在文字方塊內輸入名字以建立新的設定檔，或是選擇一個現有的設定檔使用。"
+	L["choose_sub"] = "從當前可用的設定檔裡面選擇一個。"
+	L["copy"] = "複製自"
+	L["copy_desc"] = "從一個現有的設定檔，將設定複製到現在使用中的設定檔。"
+	L["current"] = "目前設定檔："
+	L["default"] = "預設"
+	L["delete"] = "刪除一個設定檔"
+	L["delete_confirm"] = "確定要刪除所選擇的設定檔嗎？"
+	L["delete_desc"] = "從資料庫裡刪除不再使用的設定檔，以節省空間，並且清理 SavedVariables 檔案。"
+	L["delete_sub"] = "從資料庫裡刪除一個設定檔。"
+	L["intro"] = "您可以從資料庫中選擇一個設定檔來使用，如此就可以讓每個角色使用不同的設定。"
+	L["new"] = "新建"
+	L["new_sub"] = "新建一個空的設定檔。"
+	L["profiles"] = "設定檔"
+	L["profiles_sub"] = "管理設定檔"
+	L["reset"] = "重置設定檔"
+	L["reset_desc"] = "將現用的設定檔重置為預設值；用於設定檔損壞，或者單純想要重來的情況。"
+	L["reset_sub"] = "將目前的設定檔重置為預設值"
+elseif LOCALE == "zhCN" then
+	L["choose"] = "现有的配置文件"
+	L["choose_desc"] = "你可以通过在文本框内输入一个名字创立一个新的配置文件，也可以选择一个已经存在的配置文件。"
+	L["choose_sub"] = "从当前可用的配置文件里面选择一个。"
+	L["copy"] = "复制自"
+	L["copy_desc"] = "从当前某个已保存的配置文件复制到当前正使用的配置文件。"
+	L["current"] = "当前配置文件："
+	L["default"] = "默认"
+	L["delete"] = "删除一个配置文件"
+	L["delete_confirm"] = "你确定要删除所选择的配置文件么？"
+	L["delete_desc"] = "从数据库里删除不再使用的配置文件，以节省空间，并且清理SavedVariables文件。"
+	L["delete_sub"] = "从数据库里删除一个配置文件。"
+	L["intro"] = "你可以选择一个活动的数据配置文件，这样你的每个角色就可以拥有不同的设置值，可以给你的插件配置带来极大的灵活性。"
+	L["new"] = "新建"
+	L["new_sub"] = "新建一个空的配置文件。"
+	L["profiles"] = "配置文件"
+	L["profiles_sub"] = "管理配置文件"
+	L["reset"] = "重置配置文件"
+	L["reset_desc"] = "将当前的配置文件恢复到它的默认值，用于你的配置文件损坏，或者你只是想重来的情况。"
+	L["reset_sub"] = "将当前的配置文件恢复为默认值"
+elseif LOCALE == "ruRU" then
+	L["choose"] = "Существующие профили"
+	L["choose_desc"] = "Вы можете создать новый профиль, введя название в поле ввода, или выбрать один из уже существующих профилей."
+	L["choose_sub"] = "Выбор одиного из уже доступных профилей"
+	L["copy"] = "Скопировать из"
+	L["copy_desc"] = "Скопировать настройки из выбранного профиля в активный."
+	L["current"] = "Текущий профиль:"
+	L["default"] = "По умолчанию"
+	L["delete"] = "Удалить профиль"
+	L["delete_confirm"] = "Вы уверены, что вы хотите удалить выбранный профиль?"
+	L["delete_desc"] = "Удалить существующий и неиспользуемый профиль из БД для сохранения места, и очистить SavedVariables файл."
+	L["delete_sub"] = "Удаление профиля из БД"
+	L["intro"] = "Изменяя активный профиль, вы можете задать различные настройки модификаций для каждого персонажа."
+	L["new"] = "Новый"
+	L["new_sub"] = "Создать новый чистый профиль"
+	L["profiles"] = "Профили"
+	L["profiles_sub"] = "Управление профилями"
+	L["reset"] = "Сброс профиля"
+	L["reset_desc"] = "Сбросить текущий профиль к стандартным настройкам, если ваша конфигурация испорчена или вы хотите настроить всё заново."
+	L["reset_sub"] = "Сброс текущего профиля на стандартный"
+elseif LOCALE == "itIT" then
+	L["choose"] = "Profili Esistenti"
+	L["choose_desc"] = "Puoi creare un nuovo profilo digitando il nome della casella di testo, oppure scegliendone uno tra i profili già esistenti."
+	L["choose_sub"] = "Seleziona uno dei profili attualmente disponibili."
+	L["copy"] = "Copia Da"
+	L["copy_desc"] = "Copia le impostazioni da un profilo esistente, nel profilo attivo in questo momento."
+	L["current"] = "Profilo Attivo:"
+	L["default"] = "Standard"
+	L["delete"] = "Cancella un Profilo"
+	L["delete_confirm"] = "Sei sicuro di voler cancellare il profilo selezionato?"
+	L["delete_desc"] = "Cancella i profili non utilizzati dal database per risparmiare spazio e mantenere puliti i file di configurazione SavedVariables."
+	L["delete_sub"] = "Cancella un profilo dal Database."
+	L["intro"] = "Puoi cambiare il profilo attivo, in modo da usare impostazioni diverse per ogni personaggio."
+	L["new"] = "Nuovo"
+	L["new_sub"] = "Crea un nuovo profilo vuoto."
+	L["profiles"] = "Profili"
+	L["profiles_sub"] = "Gestisci Profili"
+	L["reset"] = "Reimposta Profilo"
+	L["reset_desc"] = "Riporta il tuo profilo attivo alle sue impostazioni predefinite, nel caso in cui la tua configurazione si sia corrotta, o semplicemente tu voglia re-inizializzarla."
+	L["reset_sub"] = "Reimposta il profilo ai suoi valori predefiniti."
+elseif LOCALE == "ptBR" then
+	L["choose"] = "Perfis Existentes"
+	L["choose_desc"] = "Você pode tanto criar um perfil novo tanto digitando um nome na caixa de texto, quanto escolher um dos perfis já existentes."
+	L["choose_sub"] = "Selecione um de seus perfis atualmente disponíveis."
+	L["copy"] = "Copiar De"
+	L["copy_desc"] = "Copia as definições de um perfil existente no perfil atualmente ativo."
+	L["current"] = "Perfil Autal:"
+	L["default"] = "Padrão"
+	L["delete"] = "Remover um Perfil"
+	L["delete_confirm"] = "Tem certeza que deseja remover o perfil selecionado?"
+	L["delete_desc"] = "Remove perfis existentes e inutilizados do banco de dados para economizar espaço, e limpar o arquivo SavedVariables."
+	L["delete_sub"] = "Remove um perfil do banco de dados."
+	L["intro"] = "Você pode alterar o perfil do banco de dados ativo, para que possa ter definições diferentes para cada personagem."
+	L["new"] = "Novo"
+	L["new_sub"] = "Cria um novo perfil vazio."
+	L["profiles"] = "Perfis"
+	L["profiles_sub"] = "Gerenciar Perfis"
+	L["reset"] = "Resetar Perfil"
+	L["reset_desc"] = "Reseta o perfil atual para os valores padrões, no caso de sua configuração estar quebrada, ou simplesmente se deseja começar novamente."
+	L["reset_sub"] = "Resetar o perfil atual ao padrão"
+end
+
+local defaultProfiles
+local tmpprofiles = {}
+
+-- Get a list of available profiles for the specified database.
+-- You can specify which profiles to include/exclude in the list using the two boolean parameters listed below.
+-- @param db The db object to retrieve the profiles from
+-- @param common If true, getProfileList will add the default profiles to the return list, even if they have not been created yet
+-- @param nocurrent If true, then getProfileList will not display the current profile in the list
+-- @return Hashtable of all profiles with the internal name as keys and the display name as value.
+local function getProfileList(db, common, nocurrent)
+	local profiles = {}
+	
+	-- copy existing profiles into the table
+	local currentProfile = db:GetCurrentProfile()
+	for i,v in pairs(db:GetProfiles(tmpprofiles)) do 
+		if not (nocurrent and v == currentProfile) then 
+			profiles[v] = v 
+		end 
+	end
+	
+	-- add our default profiles to choose from ( or rename existing profiles)
+	for k,v in pairs(defaultProfiles) do
+		if (common or profiles[k]) and not (nocurrent and k == currentProfile) then
+			profiles[k] = v
+		end
+	end
+	
+	return profiles
+end
+
+--[[
+	OptionsHandlerPrototype
+	prototype class for handling the options in a sane way
+]]
+local OptionsHandlerPrototype = {}
+
+--[[ Reset the profile ]]
+function OptionsHandlerPrototype:Reset()
+	self.db:ResetProfile()
+end
+
+--[[ Set the profile to value ]]
+function OptionsHandlerPrototype:SetProfile(info, value)
+	self.db:SetProfile(value)
+end
+
+--[[ returns the currently active profile ]]
+function OptionsHandlerPrototype:GetCurrentProfile()
+	return self.db:GetCurrentProfile()
+end
+
+--[[ 
+	List all active profiles
+	you can control the output with the .arg variable
+	currently four modes are supported
+	
+	(empty) - return all available profiles
+	"nocurrent" - returns all available profiles except the currently active profile
+	"common" - returns all avaialble profiles + some commonly used profiles ("char - realm", "realm", "class", "Default")
+	"both" - common except the active profile
+]]
+function OptionsHandlerPrototype:ListProfiles(info)
+	local arg = info.arg
+	local profiles
+	if arg == "common" and not self.noDefaultProfiles then
+		profiles = getProfileList(self.db, true, nil)
+	elseif arg == "nocurrent" then
+		profiles = getProfileList(self.db, nil, true)
+	elseif arg == "both" then -- currently not used
+		profiles = getProfileList(self.db, (not self.noDefaultProfiles) and true, true)
+	else
+		profiles = getProfileList(self.db)
+	end
+	
+	return profiles
+end
+
+function OptionsHandlerPrototype:HasNoProfiles(info)
+	local profiles = self:ListProfiles(info)
+	return ((not next(profiles)) and true or false)
+end
+
+--[[ Copy a profile ]]
+function OptionsHandlerPrototype:CopyProfile(info, value)
+	self.db:CopyProfile(value)
+end
+
+--[[ Delete a profile from the db ]]
+function OptionsHandlerPrototype:DeleteProfile(info, value)
+	self.db:DeleteProfile(value)
+end
+
+--[[ fill defaultProfiles with some generic values ]]
+local function generateDefaultProfiles(db)
+	defaultProfiles = {
+		["Default"] = L["default"],
+		[db.keys.char] = db.keys.char,
+		[db.keys.realm] = db.keys.realm,
+		[db.keys.class] = UnitClass("player")
+	}
+end
+
+--[[ create and return a handler object for the db, or upgrade it if it already existed ]]
+local function getOptionsHandler(db, noDefaultProfiles)
+	if not defaultProfiles then
+		generateDefaultProfiles(db)
+	end
+	
+	local handler = AceDBOptions.handlers[db] or { db = db, noDefaultProfiles = noDefaultProfiles }
+	
+	for k,v in pairs(OptionsHandlerPrototype) do
+		handler[k] = v
+	end
+	
+	AceDBOptions.handlers[db] = handler
+	return handler
+end
+
+--[[
+	the real options table 
+]]
+local optionsTable = {
+	desc = {
+		order = 1,
+		type = "description",
+		name = L["intro"] .. "\n",
+	},
+	descreset = {
+		order = 9,
+		type = "description",
+		name = L["reset_desc"],
+	},
+	reset = {
+		order = 10,
+		type = "execute",
+		name = L["reset"],
+		desc = L["reset_sub"],
+		func = "Reset",
+	},
+	current = {
+		order = 11,
+		type = "description",
+		name = function(info) return L["current"] .. " " .. NORMAL_FONT_COLOR_CODE .. info.handler:GetCurrentProfile() .. FONT_COLOR_CODE_CLOSE end,
+		width = "default",
+	},
+	choosedesc = {
+		order = 20,
+		type = "description",
+		name = "\n" .. L["choose_desc"],
+	},
+	new = {
+		name = L["new"],
+		desc = L["new_sub"],
+		type = "input",
+		order = 30,
+		get = false,
+		set = "SetProfile",
+	},
+	choose = {
+		name = L["choose"],
+		desc = L["choose_sub"],
+		type = "select",
+		order = 40,
+		get = "GetCurrentProfile",
+		set = "SetProfile",
+		values = "ListProfiles",
+		arg = "common",
+	},
+	copydesc = {
+		order = 50,
+		type = "description",
+		name = "\n" .. L["copy_desc"],
+	},
+	copyfrom = {
+		order = 60,
+		type = "select",
+		name = L["copy"],
+		desc = L["copy_desc"],
+		get = false,
+		set = "CopyProfile",
+		values = "ListProfiles",
+		disabled = "HasNoProfiles",
+		arg = "nocurrent",
+	},
+	deldesc = {
+		order = 70,
+		type = "description",
+		name = "\n" .. L["delete_desc"],
+	},
+	delete = {
+		order = 80,
+		type = "select",
+		name = L["delete"],
+		desc = L["delete_sub"],
+		get = false,
+		set = "DeleteProfile",
+		values = "ListProfiles",
+		disabled = "HasNoProfiles",
+		arg = "nocurrent",
+		confirm = true,
+		confirmText = L["delete_confirm"],
+	},
+}
+
+--- Get/Create a option table that you can use in your addon to control the profiles of AceDB-3.0.
+-- @param db The database object to create the options table for.
+-- @return The options table to be used in AceConfig-3.0
+-- @usage 
+-- -- Assuming `options` is your top-level options table and `self.db` is your database:
+-- options.args.profiles = LibStub("AceDBOptions-3.0"):GetOptionsTable(self.db)
+function AceDBOptions:GetOptionsTable(db, noDefaultProfiles)
+	local tbl = AceDBOptions.optionTables[db] or {
+			type = "group",
+			name = L["profiles"],
+			desc = L["profiles_sub"],
+		}
+	
+	tbl.handler = getOptionsHandler(db, noDefaultProfiles)
+	tbl.args = optionsTable
+
+	AceDBOptions.optionTables[db] = tbl
+	return tbl
+end
+
+-- upgrade existing tables
+for db,tbl in pairs(AceDBOptions.optionTables) do
+	tbl.handler = getOptionsHandler(db)
+	tbl.args = optionsTable
+end

Libs/AceDBOptions-3.0/AceDBOptions-3.0.xml

@@ -0,0 +1,4 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+	<Script file="AceDBOptions-3.0.lua"/>
+</Ui>

Libs/LibDBIcon-1.0/LibDBIcon-1.0.lua

@@ -0,0 +1,470 @@
+
+-----------------------------------------------------------------------
+-- LibDBIcon-1.0
+--
+-- Allows addons to easily create a lightweight minimap icon as an alternative to heavier LDB displays.
+--
+
+local DBICON10 = "LibDBIcon-1.0"
+local DBICON10_MINOR = 43 -- Bump on changes
+if not LibStub then error(DBICON10 .. " requires LibStub.") end
+local ldb = LibStub("LibDataBroker-1.1", true)
+if not ldb then error(DBICON10 .. " requires LibDataBroker-1.1.") end
+local lib = LibStub:NewLibrary(DBICON10, DBICON10_MINOR)
+if not lib then return end
+
+lib.objects = lib.objects or {}
+lib.callbackRegistered = lib.callbackRegistered or nil
+lib.callbacks = lib.callbacks or LibStub("CallbackHandler-1.0"):New(lib)
+lib.notCreated = lib.notCreated or {}
+lib.radius = lib.radius or 5
+lib.tooltip = lib.tooltip or CreateFrame("GameTooltip", "LibDBIconTooltip", UIParent, "GameTooltipTemplate")
+local next, Minimap = next, Minimap
+local isDraggingButton = false
+
+function lib:IconCallback(event, name, key, value)
+	if lib.objects[name] then
+		if key == "icon" then
+			lib.objects[name].icon:SetTexture(value)
+		elseif key == "iconCoords" then
+			lib.objects[name].icon:UpdateCoord()
+		elseif key == "iconR" then
+			local _, g, b = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(value, g, b)
+		elseif key == "iconG" then
+			local r, _, b = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(r, value, b)
+		elseif key == "iconB" then
+			local r, g = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(r, g, value)
+		end
+	end
+end
+if not lib.callbackRegistered then
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__icon", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconCoords", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconR", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconG", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconB", "IconCallback")
+	lib.callbackRegistered = true
+end
+
+local function getAnchors(frame)
+	local x, y = frame:GetCenter()
+	if not x or not y then return "CENTER" end
+	local hhalf = (x > UIParent:GetWidth()*2/3) and "RIGHT" or (x < UIParent:GetWidth()/3) and "LEFT" or ""
+	local vhalf = (y > UIParent:GetHeight()/2) and "TOP" or "BOTTOM"
+	return vhalf..hhalf, frame, (vhalf == "TOP" and "BOTTOM" or "TOP")..hhalf
+end
+
+local function onEnter(self)
+	if isDraggingButton then return end
+
+	for _, button in next, lib.objects do
+		if button.showOnMouseover then
+			button.fadeOut:Stop()
+			button:SetAlpha(1)
+		end
+	end
+
+	local obj = self.dataObject
+	if obj.OnTooltipShow then
+		lib.tooltip:SetOwner(self, "ANCHOR_NONE")
+		lib.tooltip:SetPoint(getAnchors(self))
+		obj.OnTooltipShow(lib.tooltip)
+		lib.tooltip:Show()
+	elseif obj.OnEnter then
+		obj.OnEnter(self)
+	end
+end
+
+local function onLeave(self)
+	lib.tooltip:Hide()
+
+	if not isDraggingButton then
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Play()
+			end
+		end
+	end
+
+	local obj = self.dataObject
+	if obj.OnLeave then
+		obj.OnLeave(self)
+	end
+end
+
+--------------------------------------------------------------------------------
+
+local onDragStart, updatePosition
+
+do
+	local minimapShapes = {
+		["ROUND"] = {true, true, true, true},
+		["SQUARE"] = {false, false, false, false},
+		["CORNER-TOPLEFT"] = {false, false, false, true},
+		["CORNER-TOPRIGHT"] = {false, false, true, false},
+		["CORNER-BOTTOMLEFT"] = {false, true, false, false},
+		["CORNER-BOTTOMRIGHT"] = {true, false, false, false},
+		["SIDE-LEFT"] = {false, true, false, true},
+		["SIDE-RIGHT"] = {true, false, true, false},
+		["SIDE-TOP"] = {false, false, true, true},
+		["SIDE-BOTTOM"] = {true, true, false, false},
+		["TRICORNER-TOPLEFT"] = {false, true, true, true},
+		["TRICORNER-TOPRIGHT"] = {true, false, true, true},
+		["TRICORNER-BOTTOMLEFT"] = {true, true, false, true},
+		["TRICORNER-BOTTOMRIGHT"] = {true, true, true, false},
+	}
+
+	local rad, cos, sin, sqrt, max, min = math.rad, math.cos, math.sin, math.sqrt, math.max, math.min
+	function updatePosition(button, position)
+		local angle = rad(position or 225)
+		local x, y, q = cos(angle), sin(angle), 1
+		if x < 0 then q = q + 1 end
+		if y > 0 then q = q + 2 end
+		local minimapShape = GetMinimapShape and GetMinimapShape() or "ROUND"
+		local quadTable = minimapShapes[minimapShape]
+		local w = (Minimap:GetWidth() / 2) + lib.radius
+		local h = (Minimap:GetHeight() / 2) + lib.radius
+		if quadTable[q] then
+			x, y = x*w, y*h
+		else
+			local diagRadiusW = sqrt(2*(w)^2)-10
+			local diagRadiusH = sqrt(2*(h)^2)-10
+			x = max(-w, min(x*diagRadiusW, w))
+			y = max(-h, min(y*diagRadiusH, h))
+		end
+		button:SetPoint("CENTER", Minimap, "CENTER", x, y)
+	end
+end
+
+local function onClick(self, b)
+	if self.dataObject.OnClick then
+		self.dataObject.OnClick(self, b)
+	end
+end
+
+local function onMouseDown(self)
+	self.isMouseDown = true
+	self.icon:UpdateCoord()
+end
+
+local function onMouseUp(self)
+	self.isMouseDown = false
+	self.icon:UpdateCoord()
+end
+
+do
+	local deg, atan2 = math.deg, math.atan2
+	local function onUpdate(self)
+		local mx, my = Minimap:GetCenter()
+		local px, py = GetCursorPosition()
+		local scale = Minimap:GetEffectiveScale()
+		px, py = px / scale, py / scale
+		local pos = 225
+		if self.db then
+			pos = deg(atan2(py - my, px - mx)) % 360
+			self.db.minimapPos = pos
+		else
+			pos = deg(atan2(py - my, px - mx)) % 360
+			self.minimapPos = pos
+		end
+		updatePosition(self, pos)
+	end
+
+	function onDragStart(self)
+		self:LockHighlight()
+		self.isMouseDown = true
+		self.icon:UpdateCoord()
+		self:SetScript("OnUpdate", onUpdate)
+		isDraggingButton = true
+		lib.tooltip:Hide()
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+end
+
+local function onDragStop(self)
+	self:SetScript("OnUpdate", nil)
+	self.isMouseDown = false
+	self.icon:UpdateCoord()
+	self:UnlockHighlight()
+	isDraggingButton = false
+	for _, button in next, lib.objects do
+		if button.showOnMouseover then
+			button.fadeOut:Play()
+		end
+	end
+end
+
+local defaultCoords = {0, 1, 0, 1}
+local function updateCoord(self)
+	local coords = self:GetParent().dataObject.iconCoords or defaultCoords
+	local deltaX, deltaY = 0, 0
+	if not self:GetParent().isMouseDown then
+		deltaX = (coords[2] - coords[1]) * 0.05
+		deltaY = (coords[4] - coords[3]) * 0.05
+	end
+	self:SetTexCoord(coords[1] + deltaX, coords[2] - deltaX, coords[3] + deltaY, coords[4] - deltaY)
+end
+
+local function createButton(name, object, db)
+	local button = CreateFrame("Button", "LibDBIcon10_"..name, Minimap)
+	button.dataObject = object
+	button.db = db
+	button:SetFrameStrata("MEDIUM")
+	button:SetSize(31, 31)
+	button:SetFrameLevel(8)
+	button:RegisterForClicks("anyUp")
+	button:RegisterForDrag("LeftButton")
+	button:SetHighlightTexture(136477) --"Interface\\Minimap\\UI-Minimap-ZoomButton-Highlight"
+	local overlay = button:CreateTexture(nil, "OVERLAY")
+	overlay:SetSize(53, 53)
+	overlay:SetTexture(136430) --"Interface\\Minimap\\MiniMap-TrackingBorder"
+	overlay:SetPoint("TOPLEFT")
+	local background = button:CreateTexture(nil, "BACKGROUND")
+	background:SetSize(20, 20)
+	background:SetTexture(136467) --"Interface\\Minimap\\UI-Minimap-Background"
+	background:SetPoint("TOPLEFT", 7, -5)
+	local icon = button:CreateTexture(nil, "ARTWORK")
+	icon:SetSize(17, 17)
+	icon:SetTexture(object.icon)
+	icon:SetPoint("TOPLEFT", 7, -6)
+	button.icon = icon
+	button.isMouseDown = false
+
+	local r, g, b = icon:GetVertexColor()
+	icon:SetVertexColor(object.iconR or r, object.iconG or g, object.iconB or b)
+
+	icon.UpdateCoord = updateCoord
+	icon:UpdateCoord()
+
+	button:SetScript("OnEnter", onEnter)
+	button:SetScript("OnLeave", onLeave)
+	button:SetScript("OnClick", onClick)
+	if not db or not db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	end
+	button:SetScript("OnMouseDown", onMouseDown)
+	button:SetScript("OnMouseUp", onMouseUp)
+
+	button.fadeOut = button:CreateAnimationGroup()
+	local animOut = button.fadeOut:CreateAnimation("Alpha")
+	animOut:SetOrder(1)
+	animOut:SetDuration(0.2)
+	animOut:SetFromAlpha(1)
+	animOut:SetToAlpha(0)
+	animOut:SetStartDelay(1)
+	button.fadeOut:SetToFinalAlpha(true)
+
+	lib.objects[name] = button
+
+	if lib.loggedIn then
+		updatePosition(button, db and db.minimapPos)
+		if not db or not db.hide then
+			button:Show()
+		else
+			button:Hide()
+		end
+	end
+	lib.callbacks:Fire("LibDBIcon_IconCreated", button, name) -- Fire 'Icon Created' callback
+end
+
+-- We could use a metatable.__index on lib.objects, but then we'd create
+-- the icons when checking things like :IsRegistered, which is not necessary.
+local function check(name)
+	if lib.notCreated[name] then
+		createButton(name, lib.notCreated[name][1], lib.notCreated[name][2])
+		lib.notCreated[name] = nil
+	end
+end
+
+-- Wait a bit with the initial positioning to let any GetMinimapShape addons
+-- load up.
+if not lib.loggedIn then
+	local f = CreateFrame("Frame")
+	f:SetScript("OnEvent", function(f)
+		for _, button in next, lib.objects do
+			updatePosition(button, button.db and button.db.minimapPos)
+			if not button.db or not button.db.hide then
+				button:Show()
+			else
+				button:Hide()
+			end
+		end
+		lib.loggedIn = true
+		f:SetScript("OnEvent", nil)
+	end)
+	f:RegisterEvent("PLAYER_LOGIN")
+end
+
+local function getDatabase(name)
+	return lib.notCreated[name] and lib.notCreated[name][2] or lib.objects[name].db
+end
+
+function lib:Register(name, object, db)
+	if not object.icon then error("Can't register LDB objects without icons set!") end
+	if lib.objects[name] or lib.notCreated[name] then error(DBICON10.. ": Object '".. name .."' is already registered.") end
+	if not db or not db.hide then
+		createButton(name, object, db)
+	else
+		lib.notCreated[name] = {object, db}
+	end
+end
+
+function lib:Lock(name)
+	if not lib:IsRegistered(name) then return end
+	if lib.objects[name] then
+		lib.objects[name]:SetScript("OnDragStart", nil)
+		lib.objects[name]:SetScript("OnDragStop", nil)
+	end
+	local db = getDatabase(name)
+	if db then
+		db.lock = true
+	end
+end
+
+function lib:Unlock(name)
+	if not lib:IsRegistered(name) then return end
+	if lib.objects[name] then
+		lib.objects[name]:SetScript("OnDragStart", onDragStart)
+		lib.objects[name]:SetScript("OnDragStop", onDragStop)
+	end
+	local db = getDatabase(name)
+	if db then
+		db.lock = nil
+	end
+end
+
+function lib:Hide(name)
+	if not lib.objects[name] then return end
+	lib.objects[name]:Hide()
+end
+
+function lib:Show(name)
+	check(name)
+	local button = lib.objects[name]
+	if button then
+		button:Show()
+		updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+	end
+end
+
+function lib:IsRegistered(name)
+	return (lib.objects[name] or lib.notCreated[name]) and true or false
+end
+
+function lib:Refresh(name, db)
+	check(name)
+	local button = lib.objects[name]
+	if db then
+		button.db = db
+	end
+	updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+	if not button.db or not button.db.hide then
+		button:Show()
+	else
+		button:Hide()
+	end
+	if not button.db or not button.db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	else
+		button:SetScript("OnDragStart", nil)
+		button:SetScript("OnDragStop", nil)
+	end
+end
+
+function lib:GetMinimapButton(name)
+	return lib.objects[name]
+end
+
+do
+	local function OnMinimapEnter()
+		if isDraggingButton then return end
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+	local function OnMinimapLeave()
+		if isDraggingButton then return end
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Play()
+			end
+		end
+	end
+	Minimap:HookScript("OnEnter", OnMinimapEnter)
+	Minimap:HookScript("OnLeave", OnMinimapLeave)
+
+	function lib:ShowOnEnter(name, value)
+		local button = lib.objects[name]
+		if button then
+			if value then
+				button.showOnMouseover = true
+				button.fadeOut:Stop()
+				button:SetAlpha(0)
+			else
+				button.showOnMouseover = false
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+end
+
+function lib:GetButtonList()
+	local t = {}
+	for name in next, lib.objects do
+		t[#t+1] = name
+	end
+	return t
+end
+
+function lib:SetButtonRadius(radius)
+	if type(radius) == "number" then
+		lib.radius = radius
+		for _, button in next, lib.objects do
+			updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+		end
+	end
+end
+
+function lib:SetButtonToPosition(button, position)
+	updatePosition(lib.objects[button] or button, position)
+end
+
+-- Upgrade!
+for name, button in next, lib.objects do
+	local db = getDatabase(name)
+	if not db or not db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	end
+	button:SetScript("OnEnter", onEnter)
+	button:SetScript("OnLeave", onLeave)
+	button:SetScript("OnClick", onClick)
+	button:SetScript("OnMouseDown", onMouseDown)
+	button:SetScript("OnMouseUp", onMouseUp)
+
+	if not button.fadeOut then -- Upgrade to 39
+		button.fadeOut = button:CreateAnimationGroup()
+		local animOut = button.fadeOut:CreateAnimation("Alpha")
+		animOut:SetOrder(1)
+		animOut:SetDuration(0.2)
+		animOut:SetFromAlpha(1)
+		animOut:SetToAlpha(0)
+		animOut:SetStartDelay(1)
+		button.fadeOut:SetToFinalAlpha(true)
+	end
+end
+lib:SetButtonRadius(lib.radius) -- Upgrade to 40

Libs/LibDBIcon-1.0/lib.xml

@@ -0,0 +1,7 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+
+<Script file="LibDBIcon-1.0.lua"/>
+
+</Ui>
+

Libs/LibDataBroker-1.1/LibDataBroker-1.1.lua

@@ -0,0 +1,90 @@
+
+assert(LibStub, "LibDataBroker-1.1 requires LibStub")
+assert(LibStub:GetLibrary("CallbackHandler-1.0", true), "LibDataBroker-1.1 requires CallbackHandler-1.0")
+
+local lib, oldminor = LibStub:NewLibrary("LibDataBroker-1.1", 4)
+if not lib then return end
+oldminor = oldminor or 0
+
+
+lib.callbacks = lib.callbacks or LibStub:GetLibrary("CallbackHandler-1.0"):New(lib)
+lib.attributestorage, lib.namestorage, lib.proxystorage = lib.attributestorage or {}, lib.namestorage or {}, lib.proxystorage or {}
+local attributestorage, namestorage, callbacks = lib.attributestorage, lib.namestorage, lib.callbacks
+
+if oldminor < 2 then
+	lib.domt = {
+		__metatable = "access denied",
+		__index = function(self, key) return attributestorage[self] and attributestorage[self][key] end,
+	}
+end
+
+if oldminor < 3 then
+	lib.domt.__newindex = function(self, key, value)
+		if not attributestorage[self] then attributestorage[self] = {} end
+		if attributestorage[self][key] == value then return end
+		attributestorage[self][key] = value
+		local name = namestorage[self]
+		if not name then return end
+		callbacks:Fire("LibDataBroker_AttributeChanged", name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged_"..name, name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged_"..name.."_"..key, name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged__"..key, name, key, value, self)
+	end
+end
+
+if oldminor < 2 then
+	function lib:NewDataObject(name, dataobj)
+		if self.proxystorage[name] then return end
+
+		if dataobj then
+			assert(type(dataobj) == "table", "Invalid dataobj, must be nil or a table")
+			self.attributestorage[dataobj] = {}
+			for i,v in pairs(dataobj) do
+				self.attributestorage[dataobj][i] = v
+				dataobj[i] = nil
+			end
+		end
+		dataobj = setmetatable(dataobj or {}, self.domt)
+		self.proxystorage[name], self.namestorage[dataobj] = dataobj, name
+		self.callbacks:Fire("LibDataBroker_DataObjectCreated", name, dataobj)
+		return dataobj
+	end
+end
+
+if oldminor < 1 then
+	function lib:DataObjectIterator()
+		return pairs(self.proxystorage)
+	end
+
+	function lib:GetDataObjectByName(dataobjectname)
+		return self.proxystorage[dataobjectname]
+	end
+
+	function lib:GetNameByDataObject(dataobject)
+		return self.namestorage[dataobject]
+	end
+end
+
+if oldminor < 4 then
+	local next = pairs(attributestorage)
+	function lib:pairs(dataobject_or_name)
+		local t = type(dataobject_or_name)
+		assert(t == "string" or t == "table", "Usage: ldb:pairs('dataobjectname') or ldb:pairs(dataobject)")
+
+		local dataobj = self.proxystorage[dataobject_or_name] or dataobject_or_name
+		assert(attributestorage[dataobj], "Data object not found")
+
+		return next, attributestorage[dataobj], nil
+	end
+
+	local ipairs_iter = ipairs(attributestorage)
+	function lib:ipairs(dataobject_or_name)
+		local t = type(dataobject_or_name)
+		assert(t == "string" or t == "table", "Usage: ldb:ipairs('dataobjectname') or ldb:ipairs(dataobject)")
+
+		local dataobj = self.proxystorage[dataobject_or_name] or dataobject_or_name
+		assert(attributestorage[dataobj], "Data object not found")
+
+		return ipairs_iter, attributestorage[dataobj], 0
+	end
+end

Libs/LibDataBroker-1.1/README.textile

@@ -0,0 +1,13 @@
+LibDataBroker is a small WoW addon library designed to provide a "MVC":http://en.wikipedia.org/wiki/Model-view-controller interface for use in various addons.
+LDB's primary goal is to "detach" plugins for TitanPanel and FuBar from the display addon.
+Plugins can provide data into a simple table, and display addons can receive callbacks to refresh their display of this data.
+LDB also provides a place for addons to register "quicklaunch" functions, removing the need for authors to embed many large libraries to create minimap buttons.
+Users who do not wish to be "plagued" by these buttons simply do not install an addon to render them.
+
+Due to it's simple generic design, LDB can be used for any design where you wish to have an addon notified of changes to a table.
+
+h2. Links
+
+* "API documentation":http://github.com/tekkub/libdatabroker-1-1/wikis/api
+* "Data specifications":http://github.com/tekkub/libdatabroker-1-1/wikis/data-specifications
+* "Addons using LDB":http://github.com/tekkub/libdatabroker-1-1/wikis/addons-using-ldb

README.md

@@ -1,6 +1,6 @@
 # Grichelde - Text replacer
 
-Grichelde replaces characters you entered in a chatbox with any replacment text you specified in the addon options.   
+Grichelde is a WoW Classic Addon that replaces characters you typed in a chatbox with any replacement text you specified in the addon options.   
 
 Intentionally started as a helper addon for a roleplaying friend, Grichelde can be used for much more, like 
 * fixing your common spelling errors :)
@@ -8,4 +8,57 @@ Intentionally started as a helper addon for a roleplaying friend, Grichelde can
 * write out abbreviations for you
 * create hilarious moments during roleplay
 
-<!-- Did you ever had an Undead without a jaw and wondered how it might sound like if s/he'd actually speak? --> 
+## Disclaimer
+#### No Warranty
+The addon is provided "AS IS" and comes without warranty of any kind of function or correctness (for more details, consult the GPL 3 license).
+Also the author is not held responsible for any risk or damage the addon or its use might cause, especially lost of progress or data due to crashes of the WoW client.
+
+#### Respect others
+This addon does not encourange or intend to hurt or to tease people with speaking disabilities or language disorders. 
+The responsibility rest on the user completely. Please use the features with care and respect to other players.
+                                 
+## FAQ
+
+#### Where do I start?
+
+Grichelde is active right from the start with default mappings. To open the options UI, either left-click on
+the new minimap icon, or type `/gri` or `/grichelde` in the chatbox. All mappings and channels can be configured there.
+
+#### Does it replace only letters but also whole words?
+
+Grichelde is capable of handling both, even whole sentences can be replaced. 
+Only slash commands, item links, textures, placeholders and ooc-markers are excluded from replacement.
+
+#### My replacement is not taken.
+
+After entering a search or replacement text, you see a button "Okay" next to yout input. This is **not** a validation message, 
+but the save button for text. This is a restriction from the UI library and can be seen in other addons as well. 
+Please click on "Okay" button to save the input permanently.
+
+If it still does not work or gives you errors, please read the next question. 
+
+#### I have to disable the Addon frequently. Is there a more elegant solution
+
+Actually there are two solutions:
+1. A right-click on the minimap button will disable Grichelde instantly. Right-click a second time will activate it again. Easy, isn't it?
+2. You can disable Grichelde permanently and forcefully replace the sentence in the chatbox. I call it "Grichelde-On-Demand" :) 
+   In the chatbox put `/gri` or `/grichelde` in front of your typed text, you can also include the target channel, 
+   i.e. `/gri /guild hello there` and Grichelde will apply the active replacements even if guild channel or Grichelde was disabled.
+
+#### I get errors, what should I do?
+
+Please report your errors here. Make a screenshot or copy both the error message as well as your recent mappings.
+You can bring up a small windows with your mapping by entering the `/gri mappings` command.
+
+#### Why that strange name?
+
+Grichelde is the name of an undead rogue without a jaw, who was played in RP sessions with a guild member.
+She started replacing "s" and "t" letters manually for each line in the chat, which became cumbersome over time.
+(If you ever wondered how an Undead without a jaw sounds like, its really hilarious, you should try it.) 
+Without spelling errors, "Griselde" in German is an old-fashioned female first name.
+
+#### I'm a pro. Does it support regular expressions?
+
+This is actually an unofficial feature. In general the searchText is passed in as Lua, so yes regex can be used in lookups.
+There are two caveats: first, Lua does not support PCRE syntax, as it would bloat Lua's simplicity and performance (read [here](http://www.lua.org/pil/20.1.html) why).
+Secondly, Grichelde does not support capture groups in the replacement text, so matches get lost. 

libs.xml

@@ -1,12 +1,17 @@
 <Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
 ..\FrameXML\UI.xsd">
 
-  <Script file="libs\LibStub\LibStub.lua"/>
-  <Include file="libs\CallbackHandler-1.0\CallbackHandler-1.0.xml"/>
-  <Include file="libs\AceAddon-3.0\AceAddon-3.0.xml"/>
-  <Include file="libs\AceConsole-3.0\AceConsole-3.0.xml"/>
-  <Include file="libs\AceGUI-3.0\AceGUI-3.0.xml"/>
-  <Include file="libs\AceEvent-3.0\AceEvent-3.0.xml" />
-  <Include file="libs\AceLocale-3.0\AceLocale-3.0.xml" />
-  <Include file="libs\AceHook-3.0\AceHook-3.0.xml"/>
+  <Script file="Libs\LibStub\LibStub.lua"/>
+  <Include file="Libs\CallbackHandler-1.0\CallbackHandler-1.0.xml"/>
+  <Include file="Libs\AceAddon-3.0\AceAddon-3.0.xml"/>
+  <Include file="Libs\AceLocale-3.0\AceLocale-3.0.xml" />
+  <Include file="Libs\AceEvent-3.0\AceEvent-3.0.xml" />
+  <Include file="Libs\AceHook-3.0\AceHook-3.0.xml"/>
+  <Include file="Libs\AceConsole-3.0\AceConsole-3.0.xml"/>
+  <Include file="Libs\AceDB-3.0\AceDB-3.0.xml"/>
+  <Include file="Libs\AceDBOptions-3.0\AceDBOptions-3.0.xml"/>
+  <Include file="Libs\AceGUI-3.0\AceGUI-3.0.xml"/>
+  <Include file="Libs\AceConfig-3.0\AceConfig-3.0.xml"/>
+  <Script file="Libs\LibDataBroker-1.1\LibDataBroker-1.1.lua" />
+  <Script file="Libs\LibDBIcon-1.0\LibDBIcon-1.0.lua" />
 </Ui>

localisation/deDE.lua

@@ -1,14 +1,199 @@
-local L = LibStub('AceLocale-3.0'):NewLocale('Grichelde', 'deDE')
+-- read namespace from global env
+local AddonName, _ = ...
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local L = LibStub('AceLocale-3.0'):NewLocale(AddonName, 'deDE')
 if not L then return end
 
+local cYellow = Grichelde.functions.cYellow
+local cGray = Grichelde.functions.cGray
+local cPrefix = Grichelde.functions.cPrefix
+
 -- system messages
-L.AddonLoaded = 'Grichelde hilft Euch jetzt bei euren Sprachschwierigkeiten.'
+L.AddonName = "Grichelde"
+L.AddonNamePlusVersion = "%s v%s"
+L.AddonLoaded = "%s unterst\195\188tzt Euch jetzt bei euren Sprachschwierigkeiten."
+L.AddonUnloaded = "%s wartet geduldig Euch weiter unterst\195\188tzen zu d\195\188rfen."
+L.Upgrade_ToVersion = "Hebe Databank auf Version %s an."
+L.Upgrade_Successful = "Upgrade erfolgreich."
+
+-- debug
+L.Debug_Options = "Optionen"
+L.Debug_Mappings = "Ersetzungen"
+L.Debug_Mappings_Hint = "Der Inhalt der Textbox dient nur zur Fehlersuche und kann herauskopiert werden. Es werden keine Werte aus dieser Textbox eingelesen oder anderweitig verwertet."
+L.Debug_Mappings_Found = "%d Ersetzungen gefunden"
+L.Debug_Profile = "Profil"
+
+-- errors
+L.Error_InvalidCommand = "Ung\195\188ltiger Befehl"
+L.Error_InvalidChannel = "Ung\195\188ltiger Kanal"
+L.Error_InvalidWhisperTarget = "Ung\195\188ltiger Fl\195\188sterziel"
+L.Error_UnsupportedChannel = "Nicht unterst\195\188tzter Kanal"
 
 -- profiles
---L.ProfileCreated = 'Neues Profil "%s" erstellt'
---L.ProfileLoaded = 'Profil auf "%s" festgelegt'
---L.ProfileDeleted = 'Profil "%s" gel\195\182scht'
---L.ProfileCopied = 'Einstellungen von "%s" kopiert'
---L.ProfileReset = 'Profil "%s" zur\195\188ckgesetzt'
---L.CantDeleteCurrentProfile = 'Das aktuelle Profil kann nicht gel\195\182scht werden'
---L.InvalidProfile = 'Ung\195\188ltiges Profil "%s"'
+L.Profiles_Available = "Verf\195\188gbare Profile:"
+L.Profiles_Created = "Neues Profil %s angelegt."
+L.Profiles_Loaded = "Profil %s geladen."
+L.Profiles_Refreshed = "Profil %s aktualisiert."
+L.Profiles_Deleted = "Profil %s gel\195\182scht."
+L.Profiles_Copied = "Einstellungen von Profil %s \195\188bernommen."
+L.Profiles_Reset = "Profil %s zur\195\188ckgesetzt."
+L.Profiles_Invalid = "Ung\195\188ltiges Profil %s!"
+L.Profiles_DeleteError = "Das aktive Profil kann nicht gel\195\182scht werden!"
+
+-- minimap
+L.Minimap_Tooltip_Enabled = "%s"
+L.Minimap_Tooltip_Disabled = "%s " .. cGray("(inaktiv)")
+L.Minimap_Tooltip_Options_Left = "Linksklick"
+L.Minimap_Tooltip_Options_Right = "\195\150ffnet oder schlie\195\159t die Einstellungen."
+L.Minimap_Tooltip_Mappings_Left = "Rechtsklick"
+L.Minimap_Tooltip_Mappings_Right = "Aktiviert oder Deaktivert jegliche Ersetzungen."
+
+-- options
+L.Options_Title = "%s Einstellungen"
+L.Options_Enabled_Name = "Aktiv"
+L.Options_Enabled_Desc = "Aktiviert %s"
+L.Options_Minimap_Button_Name = "Zeige Minimap-Knopf"
+L.Options_Minimap_Button_Desc = "Zeigt oder versteckt den Knopf an der Miniaturkarte"
+
+L.Options_Channels_Group_Name = "Kan\195\164le"
+L.Options_Channels_Group_Desc = "%s ist in folgenden Kan\195\164len aktiv."
+L.Options_Channels_Header = "Eine Ersetzung wird nur in den unten markierten Kan\195\164len durchgef\195\188hrt:"
+
+L.Options_Channel_Say_Name = "Sagen"
+L.Options_Channel_Say_Desc = "Aktiviert %s im Kanal \"Sagen\"."
+L.Options_Channel_Emote_Name = "Emote"
+L.Options_Channel_Emote_Desc = "Aktiviert %s im Kanal \"Emote\"."
+L.Options_Channel_Yell_Name = "Schreien"
+L.Options_Channel_Yell_Desc = "Aktiviert %s im Kanal \"Schreien\"."
+L.Options_Channel_Party_Name = "Gruppe"
+L.Options_Channel_Party_Desc = "Aktiviert %s im Kanal \"Gruppe\"."
+L.Options_Channel_PartyLeader_Name = "Gruppenanf\195\188hrer"
+L.Options_Channel_PartyLeader_Desc = "Aktiviert %s im Kanal \"Gruppenanf\195\188hrer\"."
+L.Options_Channel_Guild_Name = "Gilde"
+L.Options_Channel_Guild_Desc = "Aktiviert %s im Kanal \"Gilde\"."
+L.Options_Channel_Officer_Name = "Offiziere"
+L.Options_Channel_Officer_Desc = "Aktiviert %s im Kanal \"Offiziere\"."
+L.Options_Channel_Raid_Name = "Schlachtzug"
+L.Options_Channel_Raid_Desc = "Aktiviert %s im Kanal \"Schlachtzug\"."
+L.Options_Channel_RaidLeader_Name = "Schlachtzugsanf\195\188hrer"
+L.Options_Channel_RaidLeader_Desc = "Aktiviert %s im Kanal \"Schlachtzugsanf\195\188hrer\"."
+L.Options_Channel_RaidWarning_Name = "Schlachtzugswarnung"
+L.Options_Channel_RaidWarning_Desc = "Aktiviert %s im Kanal \"Schlachtzugswarnung."
+L.Options_Channel_Instance_Name = "Instanz"
+L.Options_Channel_Instance_Desc = "Aktiviert %s im Kanal \"Instanz\"."
+L.Options_Channel_Battleground_Name = "Schlachtfeld"
+L.Options_Channel_Battleground_Desc = "Aktiviert %s im Kanal \"Schlachtfeld\"."
+L.Options_Channel_Whisper_Name = "Fl\195\188stern"
+L.Options_Channel_Whisper_Desc = "Aktiviert %s im Kanal \"Fl\195\188stern\"."
+
+L.Options_Replacements_Group_Name = "Ersetzungen"
+L.Options_Replacements_Group_Desc = "Diese Vorkommen werden in den aktivierten Kan\195\164len ersetzt."
+L.Options_Replacements_Add_Name = "Hinzu"
+L.Options_Replacements_Add_Desc = "F\195\188gt eine neue Zuordnung hinzu."
+L.Options_Replacements_DeleteAll_Name = "Alle L\195\182schen"
+L.Options_Replacements_DeleteAll_Desc = "L\195\182scht alle Zuweisungen."
+L.Options_Replacements_DeleteAll_ConfirmText="Wirklich ALLE Zuweisungen l\195\182schen?"
+L.Options_Replacements_Header = "Die Vorkommen links vom Pfeil \"=>\" werden in den aktivierten Kan\195\164len gesucht und durch den Text rechts vom Pfeil ersetzt."
+
+L.Options_Mapping_Group_Name = "%s => %s"
+L.Options_Mapping_Group_Desc = "Dieses Vorkommen wird in den aktivierten Kan\195\164len ersetzt."
+L.Options_Mapping_EmptyMapping = "(keine)"
+L.Options_Mapping_Enabled_Name = "Aktiv"
+L.Options_Mapping_Enabled_Desc = "Diese Ersetzung wird durchgef\195\188hrt"
+L.Options_Mapping_SearchText_Name = "Suchtext:"
+L.Options_Mapping_SearchText_Desc = "Dieser Text wird in der Chateingabe gesucht."
+L.Options_Mapping_ReplaceText_Name = "Ersetzung:"
+L.Options_Mapping_ReplaceText_Desc = "Jeder Suchtreffer wird mit diesem Text ersetzt."
+L.Options_Mapping_ExactCase_Name = "Exakte Gro\195\159- und Kleinschreibung"
+L.Options_Mapping_ExactCase_Desc = "Wenn gesetzt, muss die Gro\195\159- und Kleinschreibung des Suchtextes exakt \195\188berein stimmen. Anderfalls wird die Gro\195\159schreibung jedes Zeichens bei der Ersetzung \195\188bernommen."
+L.Options_Mapping_Consolidate_Name = "Zusammenfassen aufeinanderfolgender Treffer"
+L.Options_Mapping_Consolidate_Desc = "Wenn durch die Ersetzung die Zeichenfolge mehrfach hintereinander steht,|nfasse sie zu einem Vorkommen zusammen."
+L.Options_Mapping_StopOnMatch_Name = "Anhalten nach Treffer"
+L.Options_Mapping_StopOnMatch_Desc = "F\195\188hrt keine nachfolgenden Ersetzungen mehr durch, wenn dieser Eintrag ein Suchtreffer war."
+L.Options_Mapping_MoveUp_Name = "^"
+L.Options_Mapping_MoveUp_Desc = "nach oben verschieben"
+L.Options_Mapping_MoveDown_Name = "v"
+L.Options_Mapping_MoveDown_Desc = "nach unten verschieben"
+L.Options_Mapping_Delete_Name = "L\195\182schen"
+L.Options_Mapping_Delete_Desc = "L\195\182scht diese Zuweisung."
+L.Options_Mapping_Delete_ConfirmText="Diese Zuweisung l\195\182schen?"
+
+L.Options_Help_Group_Name = "Hilfe"
+L.Options_Help_Group_Desc = "Hilfstellungen zu den Suchmustern und zur Ersetzungslogik."
+L.Options_Help_Disclaimer = cYellow("Haftungsausschlu\195\159:") .. " Das Addon wird im reinen Ist-Zustand zur Verf\195\188gung gestellt, ohne Garantie auf Funktion und Fehlerfreiheit (f\195\188r mehr Details siehe GPL 3 Lizenzdokument). "
+                            .. "Ferner \195\188bernimmt der Autor keinerlei Haftung oder Gew\195\164hrleistung f\195\188r durch das Addon oder dessen Nutzung entstandene Fehler oder Sch\195\164den, "
+                            .. "insb. den Verlust von Spielfortschritt oder Daten aufgrund von Abst\195\188rzen des WoW-Clients."
+L.Options_Help_Tab_Basics_Name = "Grundlagen"
+L.Options_Help_Tab_Basics_Desc = "Erl\195\164utert die Grundlagen des Addons"
+L.Options_Help_Tab_Expert_Name = "Experte"
+L.Options_Help_Tab_Expert_Desc = "Beleuchtet die Besonderheiten bei der Textsuche."
+L.Options_Help_Tab_Examples_Name = "Beispiele"
+L.Options_Help_Tab_Examples_Desc = "Beispiele f\195\188r bestimmte Szenarien."
+
+L.Options_Help_Basics = cYellow("Reihenfolge")
+                        .. "|nEs sind unbegrenzt viele Textersetzung m\195\182glich, und sie werden in der Reihenfolge der definierten Zuordnungen abgearbeitet, von oben nach unten. "
+                        .. "Ersetzungen sind transitiv, d.h. nachfolgende Zuordnungen beziehen sich nicht auf den Originaltext, sondern das Resultat der vorherigen Ersetzung. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"a\" => \"b\"") .. " und " .. cPrefix("\"b\" => \"c\"") .. " wird bei Eingabe von " .. cPrefix("\"a\" => \"c\"") .. "."
+                        .. "|n|n" .. cYellow("Exakte Gro\195\159- und Kleinschreibung")
+                        .. "|nBei exakter Gro\195\159- und Kleinschreibung muss die Schreibweise genau \195\188berstimmen, sonst findet keine Textersetzug f\195\188r diese Zuordnung statt. "
+                        .. "Wird die Gro\195\159- und Kleinschreibung ignoriert, wird die Gro\195\159schreibung jedes Zeichens bei der Ersetzung \195\188bernommen. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"aBcDeF\" => \"uvWXYz\"") .. " wird aus " .. cPrefix("\"abcdef\" => \"uvwxyz\"") .. ", "
+                        .."aus " .. cPrefix("\"ABCDEF\" => \"UVWXYZ\"") .. " und aus " .. cPrefix("\"AbCdEf\" => \"UvWxYz\"") .. "."
+                        .. "|n|n" .. cYellow("Zusammenfassen aufeinanderfolgender Treffer")
+                        .. "|nDas Zusammenfassen aufeinanderfolgender Treffer vermeidet unsch\195\182ne Wiederholungen, die durch die Ersetzung entstehen k\195\182nnen. "
+                        .. "Die Zusammenfassung wird erst nach der Ersetzung vorgenommen, d.h. am vollst\195\164ndig ersetzten Text f\195\188r jede Zuordnung. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"s\" => \"sch\"") .. " wird aus " .. cPrefix("\"Tasse\" => \"Tasche\"") .. " statt " .. cPrefix("\"Taschsche\"") .. ", "
+                        .. "aber " .. cPrefix("\"schmeissen\" => \"schchmeischen\"") .. ". Solche Randbedingungen beseitigt in der Regel eine weitere Zuordnung wie " .. cPrefix("\"chch\" => \"ch\"") .. "."
+L.Options_Help_Expert = cYellow("verk\195\188rzende/verl\195\163ngernde Ersetzungen")
+                        .. "|nIst der Ersetzungstext k\195\188rzer als der eigentliche Suchtext, werden die \195\188bersch\195\188\195\159igen Zeichen des Suchtreffers entfernt. "
+                        .. "Ist der Ersetzungstext l\195\163nger, werden die \195\188brigen Zeichen nach dem Treffer hinten drangehangen. Dabei wird die Gro\195\159- und Kleinschreibung des letzten Zeichens ber\195\188cksichtigt, "
+                        .. "ebenso wie die Gro\195\159- und Kleinschreibung des nachfolgenden Zeichens. Gro\195\159geschriebene Abk\195\188rzungen und Ausdr\195\188cke bleiben so einheitlich. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"Kr\195\164uter\" => \"Gr\195\188nzeugs\"") .. " wird aus " .. cPrefix("\"KR\195\132UTER\" => \"GR\195\156NZEUGS\"") .. " statt " .. cPrefix("\"GR\195\156NZEUgs\"") .. " "
+                        .. "unter Beibehaltung von absichtlicher Gro\195\159schreibung wie " .. cPrefix("\"Kr\195\132utERGarten\" => \"Gr195\156nzEUGSgarten\"") .. " statt " .. cPrefix("\"Gr\195\188nzeugsGarten\"") .. "."
+                        .. "|n|n" .. cYellow("Standby")
+                        .. "|nErsetzungen k\195\182nnen auch nur bei Bedarf durchgef\195\188hrt werden, selbst wenn das Addon oder ein Kanal deaktivert wurde. "
+                        .. "Vor der Eingabe in der Chatbox schreibt man " .. cPrefix("/gri").. " oder " .. cPrefix("/grichelde").. " und optional noch den Zielkanal "
+                        .. "z.B. " .. cPrefix("\"/gri /p hallo da dr\195\188ben\"") .. " und alle aktiven Zuordnungen werden ersetzt, selbst wenn der Gruppenkanal oder das Addon nicht aktiv sind."
+                        .. "|n|n" .. cYellow("Regul\195\164re Ausdr\195\188cke")
+                        .. "|nRegEx sind sehr m\195\163chtige Such- und Ersetzunsgmuster die h\195\163ufig in der Programmierung verwendet werden. Technisch gesehen benutzt das Addon f\195\188r die Suchen des Eingabetextes bereits regul\195\163ren Ausdr\195\188cke. "
+                        .. "Das Eingeben von RegEx als Suchtext ist allerings eine inoffizielle Funktion und hat zwei gro\195\159e Einschr\195\163nkungen: "
+                        .. "|n1. Leider unterst\195\188tzt Lua nicht den vollst\195\163ndigen Umfang von PCRE. Trotzdem k\195\182nnen einige Muster verwendet werden wie Zeilenanfang " .. cPrefix("\"^\"") .. " "
+                        .."oder Zeilenende " .. cPrefix("\"$\"") .. ", Zeichenklassen wie Zahlen " .. cPrefix("\"%d\"") .. " oder (negierte) Auswahlen " .. cPrefix("\"[^%p]\"") .. ". "
+                        .. "|n2. Es werden keine Gruppen im Ersetzungstest unterst\195\188tzt, so da\195\159 Gruppen einfach verloren gehen. Wegen der Gro\195\159- und Kleinschreibung und steigender Komplexit\195\163t ist diese Funktion auch f\195\188r die Zukunft nicht geplant. "
+                        .. "|nIm Beispiel-Reiter gibt es einige Ersetzungen, welche mit regul\195\164ren Ausdr\195\188cke umgesetzt wurden."
+
+L.Options_Help_Examples_Note = cYellow("Hinweis:") .. " Dieses Addon bef\195\188rwortet nicht und beabsichtig nicht Personen mit (Fremd-)Sprachproblemen |nzu verletztem oder herabzuw\195\188rdigen. Die Verantwortung f\195\188r den Einsatz des Addons obliegt dem Benutzer. |nBitte verwendet die Funktion respektvoll und zur\195\188ckhaltend gegen\195\188ber anderen Mitspielern."
+L.Options_Help_Examples0_Header = cYellow("Beispiel")
+L.Options_Help_Examples0_Text = "Bitte ein Beispiel aus der Auswahlbox ausw\195\164hlen."
+L.Options_Help_Examples1_Select = "fehlender Unterkiefer"
+L.Options_Help_Examples1_Header = cYellow("S und P werden durch Zisch- und Klacklaute ersetzt.")
+L.Options_Help_Examples1_Text = cPrefix("s => ch") .. "|n|n" .. cPrefix("t => ck")
+L.Options_Help_Examples2_Select = "Trollifizierung"
+L.Options_Help_Examples2_Header = cYellow("L\195\164\195\159t euch fast wie ein echter Troll klingen.")
+L.Options_Help_Examples2_Text = cPrefix("%.$ => , maan.") .. "|n|n" .. cPrefix("ir => ia") .. "|n|n" .. cPrefix("ch => ck") .. "|n|n" .. cPrefix("g => ch") .. "|n|n" .. cPrefix("qu => kw") .. "|n|n" .. cPrefix("t => d")
+L.Options_Help_Examples3_Select = "Altmodisch"
+L.Options_Help_Examples3_Header = cYellow("Benutzt eine antiquiertere Schreibweise.")
+L.Options_Help_Examples3_Text = cPrefix("ei => ey") .. "|n|n" .. cPrefix("\195\159 => sz")
+L.Options_Help_Examples4_Select = "Abk\195\188rzungen"
+L.Options_Help_Examples4_Header = cYellow("Viel sagen, wenig tippen.")
+L.Options_Help_Examples4_Text = cPrefix("gz => Herzlichen Gl\195\188ckwunsch") .. "|n|n" .. cPrefix("gn8 => Gute Nacht") .. "|n|n" .. cPrefix("afk => Bin mal eben weg (AFK)") .. "|n|n" .. cPrefix("MC => Geschmolzener Kern")
+L.Options_Help_Examples5_Select = "Eigennamen"
+L.Options_Help_Examples5_Header = cYellow("Ersetzt Spielernamen, NPCs oder Orte durch andere Ausdr\195\188cke.")
+L.Options_Help_Examples5_Text = cPrefix("Sylvanas => die rachs\195\188chtige Bansheek\195\182nigin") .. "|n|n" .. cPrefix("R\195\188tzkn\195\188bbel => R\195\188tzi") .. "|n|n" .. cPrefix("Unterstadt => Undercity")
+L.Options_Help_Examples6_Select = "Lispeln"
+L.Options_Help_Examples6_Header = cYellow("Aussprache von S und Z wird zu einem Zischlaut")
+L.Options_Help_Examples6_Text = cPrefix("sch => ch") .. "|n|n" .. cPrefix("s => fs") .. "|n|n" .. cPrefix("z => ts") .. "|n|n" .. cPrefix("chs => x")
+L.Options_Help_Examples7_Select = "Stottern"
+L.Options_Help_Examples7_Header = cYellow("Stottern")
+L.Options_Help_Examples7_Text = "p[%s]-$"
+
+L.IgnorePattern_Star = "Stern"
+L.IgnorePattern_Circle = "Kreis"
+L.IgnorePattern_Diamond = "Diamant"
+L.IgnorePattern_Triangle = "Dreieck"
+L.IgnorePattern_Moon = "Mond"
+L.IgnorePattern_Square = "Quadrat"
+L.IgnorePattern_Cross = "Kreuz"
+L.IgnorePattern_Skull = "Totenkopf"

localisation/enUS.lua

@@ -1,5 +1,199 @@
-local L = LibStub('AceLocale-3.0'):NewLocale('Grichelde', 'enUS', true)
+-- read namespace from global env
+local AddonName, _ = ...
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local L = LibStub('AceLocale-3.0'):NewLocale(AddonName, 'enUS', true)
 if not L then return end
 
+local cYellow = Grichelde.functions.cYellow
+local cGray = Grichelde.functions.cGray
+local cPrefix = Grichelde.functions.cPrefix
+
 -- system messages
-L.AddonLoaded = 'Grichelde now helps you with your spelling disabilities.'
+L.AddonName = "Grichelde"
+L.AddonNamePlusVersion = "%s v%s"
+L.AddonLoaded = "%s happily assists you with your spelling disabilities now."
+L.AddonUnloaded = "%s patiently waits to support you again when needed."
+L.Upgrade_ToVersion = "Upgrade database to version %s."
+L.Upgrade_Successful = "Upgrade successful."
+
+-- debug
+L.Debug_Options = "Options"
+L.Debug_Mappings = "Mappings"
+L.Debug_Mappings_Hint = "The content of this input box is used for debugging purposes only and can be copied. No input from this box will be read or processed."
+L.Debug_Mappings_Found = "%d mappings found"
+L.Debug_Profile = "Profile"
+
+-- errors
+L.Error_InvalidCommand = "Invalid command"
+L.Error_InvalidChannel = "Invalid channel"
+L.Error_InvalidWhisperTarget = "Invalid whisper target"
+L.Error_UnsupportedChannel = "Unsupported channel"
+
+-- profiles
+L.Profiles_Available = "Available profiles:"
+L.Profiles_Created = "New profile %s created."
+L.Profiles_Loaded = "Profile %s is loaded."
+L.Profiles_Refreshed = "Profil %s refreshed."
+L.Profiles_Deleted = "Profile %s deleted."
+L.Profiles_Copied = "Settings applied from profile %s."
+L.Profiles_Reset = "Profil %s reset."
+L.Profiles_Invalid = "Invalid profile %s!"
+L.Profiles_DeleteError = "The active profile cannot be deleted!"
+
+-- minimap
+L.Minimap_Tooltip_Enabled = "%s"
+L.Minimap_Tooltip_Disabled = "%s " .. cGray("(inactive)")
+L.Minimap_Tooltip_Options_Left = "Left-Click"
+L.Minimap_Tooltip_Options_Right = "Opens or closes the options UI."
+L.Minimap_Tooltip_Mappings_Left = "Right-Click"
+L.Minimap_Tooltip_Mappings_Right = "Enables or disables any replacements."
+
+-- options
+L.Options_Title = "%s Options"
+L.Options_Enabled_Name = "Enabled"
+L.Options_Enabled_Desc = "Enables %s"
+L.Options_Minimap_Button_Name = "Show minimap button"
+L.Options_Minimap_Button_Desc = "Shows or hides the button on the minimap."
+
+L.Options_Channels_Group_Name = "Channels"
+L.Options_Channels_Group_Desc = "%s is active in the following channels."
+L.Options_Channels_Header = "Text replacement will only be done for marked channels below:"
+
+L.Options_Channel_Say_Name = "Say"
+L.Options_Channel_Say_Desc = "Activates %s in channel \"Say\"."
+L.Options_Channel_Emote_Name = "Emote"
+L.Options_Channel_Emote_Desc = "Activates %s in channel \"Emote\"."
+L.Options_Channel_Yell_Name = "Yell"
+L.Options_Channel_Yell_Desc = "Activates %s in channel \"Yell\"."
+L.Options_Channel_Party_Name = "Party"
+L.Options_Channel_Party_Desc = "Activates %s in channel \"Party\"."
+L.Options_Channel_PartyLeader_Name = "Party Leader"
+L.Options_Channel_PartyLeader_Desc = "Activates %s in channel \"Party Leader\"."
+L.Options_Channel_Guild_Name = "Guild"
+L.Options_Channel_Guild_Desc = "Activates %s in channel \"Guild\"."
+L.Options_Channel_Officer_Name = "Officers"
+L.Options_Channel_Officer_Desc = "Activates %s in channel \"Officers\"."
+L.Options_Channel_Raid_Name = "Raid"
+L.Options_Channel_Raid_Desc = "Activates %s in channel \"Raid\"."
+L.Options_Channel_RaidLeader_Name = "Raid Leader"
+L.Options_Channel_RaidLeader_Desc = "Activates %s in channel \"Raid Leader\"."
+L.Options_Channel_RaidWarning_Name = "Raid Warning"
+L.Options_Channel_RaidWarning_Desc = "Activates %s in channel \"Raid Warning\"."
+L.Options_Channel_Instance_Name = "Instance"
+L.Options_Channel_Instance_Desc = "Activates %s in channel \"Instance\"."
+L.Options_Channel_Battleground_Name = "Battleground"
+L.Options_Channel_Battleground_Desc = "Activates %s in channel \"Battleground\"."
+L.Options_Channel_Whisper_Name = "Whisper"
+L.Options_Channel_Whisper_Desc = "Activates %s in channel \"Whisper\"."
+
+L.Options_Replacements_Group_Name = "Replacements"
+L.Options_Replacements_Group_Desc = "These lookups will be replaced in activated channels."
+L.Options_Replacements_Add_Name = "Add"
+L.Options_Replacements_Add_Desc = "Adds a new replacement mapping."
+L.Options_Replacements_DeleteAll_Name = "Delete All"
+L.Options_Replacements_DeleteAll_Desc = "Deletes all replacement mappings."
+L.Options_Replacements_DeleteAll_ConfirmText = "Do you really want to delete ALL replacement mappings?"
+L.Options_Replacements_Header = "All matches on the lefthand side of the arrow \"=>\" will be replaced in activated channels by the text on the righthand side. "
+
+L.Options_Mapping_Group_Name = "%s => %s"
+L.Options_Mapping_Group_Desc = "This lookup will be replaced in activated channels."
+L.Options_Mapping_EmptyMapping = "(none)"
+L.Options_Mapping_Enabled_Name = "active"
+L.Options_Mapping_Enabled_Desc = "This replacement will be processed."
+L.Options_Mapping_SearchText_Name = "Search for:"
+L.Options_Mapping_SearchText_Desc = "This text is looked up in your chat input box."
+L.Options_Mapping_ReplaceText_Name = "Replacement:"
+L.Options_Mapping_ReplaceText_Desc = "Any match will be replaced with this text."
+L.Options_Mapping_ExactCase_Name = "exact case"
+L.Options_Mapping_ExactCase_Desc = "When set, matches must be case-sensitive. Otherwise the case for each letter of the matching text is taken over when replaced."
+L.Options_Mapping_Consolidate_Name = "consolidate consecutive matches"
+L.Options_Mapping_Consolidate_Desc = "If after the replacement a text sequence is repeated|ndirectly after another, treat them as one occurrence."
+L.Options_Mapping_StopOnMatch_Name = "stop on match"
+L.Options_Mapping_StopOnMatch_Desc = "Stops looking for any following replacements, when this one matched."
+L.Options_Mapping_MoveUp_Name = "^"
+L.Options_Mapping_MoveUp_Desc = "move up"
+L.Options_Mapping_MoveDown_Name = "v"
+L.Options_Mapping_MoveDown_Desc = "move down"
+L.Options_Mapping_Delete_Name = "Delete"
+L.Options_Mapping_Delete_Desc = "Deletes this replacement mapping."
+L.Options_Mapping_Delete_ConfirmText = "Delete this replacement mapping?"
+
+L.Options_Help_Group_Name = "Help"
+L.Options_Help_Group_Desc = "Guideance to search patterns and replacement logic."
+L.Options_Help_Disclaimer = cYellow("Disclaimer of warranty:") .. " The addon is provided \"AS IS\" and comes without warranty of any kind of function or correctness (for more details, consult the GPL 3 license). "
+                            .."Also the author is not held responsible for any risk or damage the addon or its use might cause, especially lost of progress or data due to crashes of the WoW client."
+
+L.Options_Help_Tab_Basics_Name = "Basics"
+L.Options_Help_Tab_Basics_Desc = "Some explanatory notes the the basic behaviour."
+L.Options_Help_Tab_Expert_Name = "Expert"
+L.Options_Help_Tab_Expert_Desc = "More details on special search options."
+L.Options_Help_Tab_Examples_Name = "Examples"
+L.Options_Help_Tab_Examples_Desc = "Templates for particular scenarios."
+
+L.Options_Help_Basics = cYellow("Ordering")
+                        .. "|nYou can have an unlimited number of replacements. All mappings will be processed in same order as defined, from top down. "
+                        .. "Replacements are also transitive, so consecutive mappings do not work on the original input but the resulting text from the previous replacements. "
+                        .. "|nBoth mappings " .. cPrefix("\"a\" => \"b\"") .. " and " .. cPrefix("\"b\" => \"c\"") .. " applied, result in the final text " .. cPrefix("\"a\" => \"c\"") .. "."
+                        .. "|n|n" .. cYellow("exact case")
+                        .. "|nIf \"exact case\" is checked, lower and upper case must match exactly to be replaced, otherwise the mapping is skipped. "
+                        .. "If case sensivity is ignored, the case for each letter of the matching text is taken over when replaced. "
+                        .. "|nWith mapping " .. cPrefix("\"aBcDeF\" => \"uvWXYz\"") .. " text results in " .. cPrefix("\"abcdef\" => \"uvwxyz\"") .. ", "
+                        .. "also " .. cPrefix("\"ABCDEF\" => \"UVWXYZ\"") .. " and " .. cPrefix("\"AbCdEf\" => \"UvWxYz\"") .. "."
+                        .. "|n|n" .. cYellow("consolidate consecutive matches")
+                        .. "|nConsolidation of consecutive matches prevent unaesthetic repetitions of letters introduced during replacements. "
+                        .. "Consolidation takes place after all replacements were done, meaning it's applied to the completely replaced text. "
+                        .. "|nWith mapping " .. cPrefix("\"s\" => \"sh\"") .. " text becomes " .. cPrefix("\"tossing\" => \"toshing\"") .. " instead of " .. cPrefix("\"toshshing\"") .. ", yet still " .. cPrefix("\"paths\" => \"pathsh\"") .. ". "
+                        .. "Such edge cases can usually be mitigated with an additional mapping at the end: " .. cPrefix("\"thsh\" => \"thz\"") .. "."
+L.Options_Help_Expert = cYellow("shortening/lengthening replacements")
+                        .. "|nIf the replacement is shorter than the actual match, all remaining characters will be skipped. If the replacement is longer, all remaining characters will be appended. "
+                        .. "The case of the replaced character is considered as well as the case of the next character in the original text. That way capital case abbreviations and expressions will not be distorted. "
+                        .. "|nWith mapping " .. cPrefix("\"Body\" => \"Corpse\"") .. " the input becomes " .. cPrefix("\"BODY\" => \"CORPSE\"") .. " instead of " .. cPrefix("\"CORPse\"") .. " "
+                        .. "but still keeps intended exceptions like " .. cPrefix("\"BodYGuard\" => \"CorPSEGuard\"") .. " instead of " .. cPrefix("\"CorpseGuard\"") .. ". "
+                        .. "|n|n" .. cYellow("On-Demand")
+                        .. "|nFor convenience input text in a chatbox can be forcefully replaced, even if the addon or the channel was disabled. "
+                        .. "In the chatbox put " .. cPrefix("/gri") .. " or " .. cPrefix("/grichelde") .. " in front of your typed text, you can also include the target channel, "
+                        .. "i.e. " .. cPrefix("\"/gri /guild hello there\"") .. " and the active replacements are applied even if the guild channel or global switch was disabled."
+                        .. "|n|n" .. cYellow("Regular Expressions")
+                        .. "|nRegex are very powerful search and replacement patterns commonly used in programming. Technically all searches the addon performs on the input text are done with regular expression methods. "
+                        .. "Entering regex as search text however is an unofficial feature and has two major caveats: "
+                        .. "|n1. Unfornately Lua does not support full PCRE syntax and is very limited. Nethertheless some patterns can be used like start of line " .. cPrefix("\"^\"") .. " or end of line " .. cPrefix("\"$\"") .. ", "
+                        .. "character classes like numbers " .. cPrefix("\"%d\"") .. " or (inversed) sets " .. cPrefix("\"[^%p]\"") .. ". "
+                        .. "|n2. There is no support for capture groups in the replacement text, so matches get lost. Because of case sensivity and complexity there are no plans to support this."
+                        .. "|nAnyway, there are some mappings using RegEx in the Example secion."
+
+
+L.Options_Help_Examples_Note = cYellow("Note:") .. " This addon does not encourange or intend to hurt or to tease people with speaking disabilities or language disorders. The responsibility rest on the user completely. Please use the features with care and respect to other players."
+L.Options_Help_Examples0_Header = cYellow("Example")
+L.Options_Help_Examples0_Text = "Select an example from the dropdown above."
+L.Options_Help_Examples1_Select = "absent jaw"
+L.Options_Help_Examples1_Header = cYellow("S and P will be replaced by sibilant and clack sounds.")
+L.Options_Help_Examples1_Text = cPrefix("s => ch") .. "|n|n" .. cPrefix("t => ck")
+L.Options_Help_Examples2_Select = "trollifier"
+L.Options_Help_Examples2_Header = cYellow("Almost sound like a real Troll.")
+L.Options_Help_Examples2_Text = cPrefix("%.$ => , mon.") .. "|n|n" .. cPrefix("th => d") .. "|n|n" .. cPrefix("you => ya") .. "|n|n" .. cPrefix("ing => in'")
+L.Options_Help_Examples3_Select = "old-fashioned"
+L.Options_Help_Examples3_Header = cYellow("Use an outdate pronounciation.")
+L.Options_Help_Examples3_Text = cPrefix("oi => oy") .. "|n|n" .. cPrefix("do => doe") .. "|n|n" .. cPrefix("go => goe") .. "|n|n" .. cPrefix("you => thou") .. "|n|n" .. cPrefix("yours => thy") .. "|n|n" .. cPrefix("be => bee") .. "|n|n" .. cPrefix("we => wee")
+L.Options_Help_Examples4_Select = "abbreviations"
+L.Options_Help_Examples4_Header = cYellow("Say much, type less.")
+L.Options_Help_Examples4_Text = cPrefix("gz => Congratulations") .. "|n|n" .. cPrefix("gn8 => Good night") .. "|n|n" .. cPrefix("afk => I'm temporarikly not available (AFK)") .. "|n|n" .. cPrefix("MC => Molten Core")
+L.Options_Help_Examples5_Select = "Proper names"
+L.Options_Help_Examples5_Header = cYellow("Replace player names, NPCs or locations.")
+L.Options_Help_Examples5_Text = cPrefix("Sylvanas => the revengeful banshee queen") .. "|n|n" .. cPrefix("Asmongold => Asmon") .. "|n|n" .. cPrefix("Crossroads => X-roads")
+L.Options_Help_Examples6_Select = "lisp"
+L.Options_Help_Examples6_Header = cYellow("S and Z will become a sibilant")
+L.Options_Help_Examples6_Text = cPrefix("s => th") .. "|n|n" .. cPrefix("ch => tsh") .. "|n|n" .. cPrefix("z => tsh") .. "|n|n" .. cPrefix("dg => ck")
+L.Options_Help_Examples7_Select = "stammer"
+L.Options_Help_Examples7_Header = cYellow("stammer")
+L.Options_Help_Examples7_Text = "p[% s]-$"
+
+L.IgnorePattern_Star = "Star"
+L.IgnorePattern_Circle = "Circle"
+L.IgnorePattern_Diamond = "Diamond"
+L.IgnorePattern_Triangle = "Triangle"
+L.IgnorePattern_Moon = "Moon"
+L.IgnorePattern_Square = "Square"
+L.IgnorePattern_Cross = "Cross"
+L.IgnorePattern_Skull = "Skull"

twitch/image-descriptions.txt

@@ -0,0 +1,40 @@
+Sample replacement
+Text is replaced in the "Say" channel.
+
+Replacements
+Create multiple mappings between search text and replacement with additional conditions.
+
+Channel configuration
+individual channel activation
+
+Profiles
+global, per server, per class, per character
+
+New: Examples
+Templates for various situations
+
+
+
+Beispielersetzung
+Eine Texteingabe wird im "Sagen"-Kanal ersetzt.
+
+Zeichenersetzung
+Erzeuge bedingte Zuordnungen zwischen Such- und Ersetzungetext.
+
+Kanälekonfiguration
+einzeln pro Kanal aktivierbar
+
+Profile:
+Global, pro Server, pro Klasse, pro Character
+
+Neu: Beispiele
+Vorlagen für verschiedene Zwecke
+
+
+
+Error Reporting
+In case of errors please send me the exact error message and please also provide the mapping from "/gri mappings" (see next screen).
+
+Debug Mappings
+In case of errors please send me the exact error message and please also provide the mapping from "/gri mappings".
+