warcraft-3-w3ts-utils 0.1.6 → 0.1.8

package/dist/utils/misc.lua

@@ -0,0 +1,143 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
+local ____exports = {}
+local properColorHexes, playerColors
+local ____w3ts = require("lua_modules.w3ts.index")
+local Timer = ____w3ts.Timer
+function ____exports.tColor(self, text, color, hex, alpha)
+    if color then
+        return ((("|cff" .. (properColorHexes:get(color) or "FFFFFF")) .. (alpha or "")) .. tostring(text)) .. "|r"
+    elseif hex then
+        return ((("|cff" .. hex) .. (alpha or "")) .. tostring(text)) .. "|r"
+    end
+    return tostring(text)
+end
+--- Colorizes the string according to the map player
+function ____exports.ptColor(self, player, text)
+    return ____exports.tColor(nil, text, nil, playerColors[player.id + 1])
+end
+properColorHexes = __TS__New(Map, {
+    {"goldenrod", "ffcc00"},
+    {"green", "00FF00"},
+    {"yellow", "FFFF00"},
+    {"red", "FF0000"},
+    {"magenta", "FF00FF"},
+    {"player1-red", "ff0303"},
+    {"player2-blue", "0042ff"},
+    {"player3-teal", "1ce6b9"},
+    {"player4-purple", "540081"},
+    {"player5-yellow", "fffc00"},
+    {"player6-orange", "fe8a0e"}
+})
+____exports.PlayerColorHex = PlayerColorHex or ({})
+____exports.PlayerColorHex.Red = "ff0303"
+____exports.PlayerColorHex.Blue = "0042ff"
+____exports.PlayerColorHex.Teal = "1be7ba"
+____exports.PlayerColorHex.Purple = "550081"
+____exports.PlayerColorHex.Yellow = "fefc00"
+____exports.PlayerColorHex.Orange = "fe890d"
+____exports.PlayerColorHex.Green = "21bf00"
+____exports.PlayerColorHex.Pink = "e45caf"
+____exports.PlayerColorHex.Gray = "939596"
+____exports.PlayerColorHex.LightBlue = "7ebff1"
+____exports.PlayerColorHex.DarkGreen = "106247"
+____exports.PlayerColorHex.Brown = "4f2b05"
+____exports.PlayerColorHex.Maroon = "9c0000"
+____exports.PlayerColorHex.Navy = "0000c3"
+____exports.PlayerColorHex.Turquoise = "00ebff"
+____exports.PlayerColorHex.Violet = "bd00ff"
+____exports.PlayerColorHex.Wheat = "ecce87"
+____exports.PlayerColorHex.Peach = "f7a58b"
+____exports.PlayerColorHex.Mint = "bfff81"
+____exports.PlayerColorHex.Lavender = "dbb8eb"
+____exports.PlayerColorHex.Coal = "4f5055"
+____exports.PlayerColorHex.Snow = "ecf0ff"
+____exports.PlayerColorHex.Emerald = "00781e"
+____exports.PlayerColorHex.Peanut = "a56f34"
+____exports.PlayerColorHex.Black = "2e2d2e"
+playerColors = {
+    "ff0303",
+    "0042ff",
+    "1be7ba",
+    "550081",
+    "fefc00",
+    "fe890d",
+    "21bf00",
+    "e45caf",
+    "939596",
+    "7ebff1",
+    "106247",
+    "4f2b05",
+    "9c0000",
+    "0000c3",
+    "00ebff",
+    "bd00ff",
+    "ecce87",
+    "f7a58b",
+    "bfff81",
+    "dbb8eb",
+    "4f5055",
+    "ecf0ff",
+    "00781e",
+    "a56f34",
+    "2e2d2e"
+}
+--- Standardized format for notifying player of events.
+function ____exports.notifyPlayer(self, msg)
+    print((____exports.tColor(nil, "!", "goldenrod") .. " - ") .. msg)
+end
+function ____exports.displayError(self, msg)
+    print((("[ " .. ____exports.tColor(nil, "WARNING", "red")) .. " ]: ") .. msg)
+end
+--- Returns degrees or radians?
+function ____exports.getRelativeAngleToUnit(self, unit, relativeUnit)
+    local locA = GetUnitLoc(unit.handle)
+    local locB = GetUnitLoc(relativeUnit.handle)
+    local angle = AngleBetweenPoints(locA, locB)
+    RemoveLocation(locA)
+    RemoveLocation(locB)
+    return angle
+end
+--- Manages state of effects in this context so you don't have to!
+function ____exports.useEffects(self)
+    local effects = {}
+    return {
+        addEffect = function(____, effect)
+            if effect then
+                effects[#effects + 1] = effect
+            end
+        end,
+        getEffects = function()
+            return effects
+        end,
+        destroyAllEffects = function()
+            __TS__ArrayForEach(
+                effects,
+                function(____, e)
+                    e:destroy()
+                end
+            )
+        end
+    }
+end
+function ____exports.useTempEffect(self, effect, duration)
+    if duration == nil then
+        duration = 1.5
+    end
+    if effect then
+        local timer = Timer:create()
+        timer:start(
+            duration,
+            false,
+            function()
+                effect:destroy()
+                timer:destroy()
+            end
+        )
+    end
+end
+return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9taXNjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O01BcUJNLGtCQXFFQTtBQTFGTixpQkFBK0M7QUFBbkI7QUFJNUIsa0NBQXVCLE1BQXVCLE9BQTZCLEtBQXNDO09BQ3pHO0FBQ0Esa0JBQU8sVUFBTyxrQkFBaUIsSUFBSSxVQUFVLGNBQVcsVUFBUyxpQkFBSyxVQUFJO1dBQ25FO0FBQ1Asa0JBQU8sVUFBTyxRQUFNLFVBQVMsaUJBQUssVUFBSTs7QUFHMUMsV0FBTyxTQUFPO0FBUGxCOztBQWFBLG1DQUF3QixRQUFtQjtBQUN2QyxXQUFVLHdCQUFPLE1BQU0sS0FBVyxhQUFhO0FBRG5EO0FBSU0sbUJBQW1CLFVBQUksS0FBMEI7SUFDbkQsQ0FBQyxhQUFhO0lBQ2QsQ0FBQyxTQUFTO0lBQ1YsQ0FBQyxVQUFVO0lBQ1gsQ0FBQyxPQUFPO0lBQ1IsQ0FBQyxXQUFXO0lBQ1osQ0FBQyxlQUFlO0lBQ2hCLENBQUMsZ0JBQWdCO0lBQ2pCLENBQUMsZ0JBQWdCO0lBQ2pCLENBQUMsa0JBQWtCO0lBQ25CLENBQUMsa0JBQWtCO0lBQ25CLENBQUMsa0JBQWtCOztBQThCdkI7QUFDSTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUdFLGVBQWU7SUFDakI7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7OztBQU1KLHdDQUE2QjtJQUN6QixPQUFTLHdCQUFPLEtBQUssZ0JBQVksVUFBTTtBQUQzQztBQUlBLHdDQUE2QjtJQUN6QixRQUFNLFFBQUssd0JBQU8sV0FBVyxXQUFNLFdBQU87QUFEOUM7O0FBT0Esa0RBQXVDLE1BQVk7QUFDekMsaUJBQU8sV0FBVztBQUNsQixpQkFBTyxXQUFXO0FBQ2xCLGtCQUFRLG1CQUFtQixNQUFNO0lBRXZDLGVBQWU7SUFDZixlQUFlO0FBRWYsV0FBTztBQVJYOztBQWNBO0FBQ1Usb0JBQW9CO0FBRTFCLFdBQU87UUFDSCxZQUFXLGVBQUM7ZUFDSjtBQUNBLHdDQUFhOztRQUZWO1FBUVgsYUFBWTtBQUNSLG1CQUFPO1FBREM7UUFHWixvQkFBbUI7WUFDZjtnQkFBQTtnQkFBZ0IsZUFBQztvQkFDYixFQUFFO2dCQURVOztRQUREOztBQWYzQjtBQXVCQSx5Q0FBOEIsUUFBNEI7T0FBQTtRQUFBLFdBQW1COztPQUNyRTtBQUNNLHNCQUFRLE1BQU07UUFFcEIsTUFBTTtZQUFNO1lBQVU7WUFBTztnQkFDekIsT0FBTztnQkFDUCxNQUFNO1lBRm1COzs7QUFKckMiLCJmaWxlIjoibWlzYy5sdWEiLCJzb3VyY2VSb290IjoiIn0=

package/dist/utils/physics.lua

@@ -0,0 +1,161 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____w3ts = require("lua_modules.w3ts.index")
+local Effect = ____w3ts.Effect
+local Timer = ____w3ts.Timer
+local Unit = ____w3ts.Unit
+local ____globals = require("lua_modules.w3ts.globals.index")
+local Players = ____globals.Players
+---
+-- @param angle degrees
+-- @param unit
+-- @param initialSpeed meters per second
+-- @param affectHeight determines whether or not to change unit height whilst force is applied
+function ____exports.applyForce(self, angle, unit, initialSpeed, config)
+    local timer = Timer:create()
+    local refreshInterval = 0.01
+    local updatesPerSecond = 1 / refreshInterval
+    local frictionConstant = 4800
+    local currentSpeed = initialSpeed
+    local timeElapsed = 0
+    local clickMoveOrder = 851971
+    local moveOrders = {
+        851986,
+        851984,
+        851990,
+        851983,
+        clickMoveOrder
+    }
+    local forceDummyUnit = nil
+    local defaultX = 11800
+    local defaultY = -5700
+    --- Prematurely end the force effect
+    local function destroyForceEffect(self, runOnEnd)
+        if runOnEnd == nil then
+            runOnEnd = false
+        end
+        if runOnEnd and (config and config.onEnd) then
+            config:onEnd()
+        end
+        ResetUnitAnimation(unit.handle)
+        if forceDummyUnit ~= nil then
+            forceDummyUnit:destroy()
+        end
+        timer:destroy()
+    end
+    --- These are the positions the unit would be if there were no minor disturbances
+    local theoreticalX = unit.x
+    local theoreticalY = unit.y
+    if not forceDummyUnit then
+        forceDummyUnit = Unit:create(Players[config.dummyUnitPlayerIndex + 1], config.dummyUnitPlayerIndex, defaultX, defaultY)
+    end
+    if config and config.animationIndexNumber then
+        ResetUnitAnimation(unit.handle)
+        SetUnitAnimationByIndex(unit.handle, config.animationIndexNumber)
+    end
+    timer:start(
+        refreshInterval,
+        true,
+        function()
+            if not unit then
+                destroyForceEffect(nil)
+                return destroyForceEffect
+            end
+            if forceDummyUnit and (config and config.strictPathing) then
+                local isWindWalked = UnitHasBuffBJ(
+                    forceDummyUnit.handle,
+                    FourCC("BOwk")
+                )
+                if not isWindWalked then
+                    forceDummyUnit:issueImmediateOrder(852129)
+                end
+                forceDummyUnit.x = unit.x
+                forceDummyUnit.y = unit.y
+                forceDummyUnit:issueImmediateOrder(851972)
+                if math.floor(forceDummyUnit.x) ~= math.floor(unit.x) or math.floor(forceDummyUnit.y) ~= math.floor(unit.y) then
+                    local e = Effect:create("Abilities\\Spells\\Other\\TalkToMe\\TalkToMe", forceDummyUnit.x, forceDummyUnit.y)
+                    if e ~= nil then
+                        e:setScaleMatrix(2, 2, 2)
+                    end
+                    destroyForceEffect(nil, true)
+                    return
+                end
+            end
+            local xVelocity = currentSpeed / updatesPerSecond * math.cos(Deg2Rad(angle))
+            local yVelocity = currentSpeed / updatesPerSecond * math.sin(Deg2Rad(angle))
+            if currentSpeed <= 0 then
+                destroyForceEffect(nil, true)
+                return
+            end
+            if config and config.onStart and currentSpeed == initialSpeed then
+                config:onStart(currentSpeed, timeElapsed)
+            end
+            if config and config.whileActive then
+                config:whileActive(currentSpeed, timeElapsed)
+            end
+            theoreticalX = theoreticalX + xVelocity
+            theoreticalY = theoreticalY + yVelocity
+            if config and config.strictPathing then
+                unit.x = theoreticalX
+                unit.y = theoreticalY
+            else
+                unit.x = unit.x + xVelocity
+                unit.y = unit.y + yVelocity
+            end
+            timeElapsed = timeElapsed + refreshInterval
+            if config and config.sustainedForceDuration and timeElapsed <= config.sustainedForceDuration then
+                return
+            end
+            currentSpeed = currentSpeed - frictionConstant / updatesPerSecond
+        end
+    )
+    return {destroyForceEffect = destroyForceEffect}
+end
+---
+-- @param angle degrees
+-- @param effect
+-- @param initialSpeed meters per second
+-- @param affectHeight determines whether or not to change unit height whilst force is applied
+function ____exports.applyForceForEffect(self, angle, effect, initialSpeed, config)
+    local timer = Timer:create()
+    local refreshInterval = 0.01
+    local updatesPerSecond = 1 / refreshInterval
+    local frictionConstant = 1200
+    local currentSpeed = initialSpeed
+    local timeElapsed = 0
+    timer:start(
+        refreshInterval,
+        true,
+        function()
+            local xVelocity = currentSpeed / updatesPerSecond * math.cos(Deg2Rad(angle))
+            local yVelocity = currentSpeed / updatesPerSecond * math.sin(Deg2Rad(angle))
+            if config and config.onEnd and currentSpeed <= 0 then
+                config:onEnd(currentSpeed, timeElapsed)
+            end
+            if currentSpeed <= 0 then
+                timer:destroy()
+                return
+            end
+            if config and config.onStart and currentSpeed == initialSpeed then
+                config:onStart(currentSpeed, timeElapsed)
+            end
+            if config and config.whileActive then
+                config:whileActive(currentSpeed, timeElapsed)
+            end
+            effect.x = effect.x + xVelocity
+            effect.y = effect.y + yVelocity
+            timeElapsed = timeElapsed + refreshInterval
+            if config and config.sustainedForceDuration and timeElapsed <= config.sustainedForceDuration then
+                return
+            end
+            currentSpeed = currentSpeed - frictionConstant / updatesPerSecond
+        end
+    )
+    local function destroyForceEffect(self)
+        timer:destroy()
+    end
+    return {destroyForceEffect = destroyForceEffect}
+end
+return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9waHlzaWNzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBRUEsaUJBQW9DO0FBQTNCO0FBQVE7QUFBTztBQUN4QixvQkFBaUM7QUFBZjs7Ozs7O0FBeUNsQixzQ0FDRSxPQUNBLE1BQ0EsY0FDQTtBQUVNLGtCQUFRLE1BQU07QUFDZCw0QkFBa0I7QUFDbEIsNkJBQW1CLElBQUk7QUFDdkIsNkJBQW1CO0FBQ3JCLHlCQUFlO0FBQ2Ysd0JBQWM7QUFFWiwyQkFBaUI7QUFDakIsdUJBQWE7UUFDakI7UUFDQTtRQUNBO1FBQ0E7UUFDQTs7QUFHRSwyQkFBbUM7QUFDakMscUJBQVc7QUFDWCxzQkFBWTs7QUFRbEIsbUJBQVMseUJBQW1CO1dBQUE7WUFBQSxXQUFvQjs7V0FDMUMsYUFBWTtZQUNkLE9BQU87O1FBR1QsbUJBQW1CO1dBQ25CO1lBQUEsZUFBZ0I7O1FBQ2hCLE1BQU07SUFQUjs7QUFhSSx5QkFBZTtBQUNmLHlCQUFlO1dBT2Q7QUFDSCx5QkFBaUIsS0FBSyxPQUNwQixRQUFRLGtDQUNSLDZCQUNBLFVBQ0E7O09BTUE7UUFDRixtQkFBbUI7UUFDbkIsd0JBQXdCLGFBQWE7O0lBR3ZDLE1BQU07UUFBTTtRQUFpQjtRQUFNO21CQUU1QjtnQkFDSDtBQUNBLHVCQUFPOztlQW1CTCxtQkFBa0I7QUFDZCxxQ0FBZTtvQkFBYztvQkFBdUIsT0FBTzs7dUJBRTVEO29CQUNILGVBQWUsb0JBQW9COztBQUtyQyxtQ0FBbUI7QUFDbkIsbUNBQW1CO2dCQUVuQixlQUFlLG9CQUFvQjttQkFJakMsV0FBVyxxQkFBc0IsV0FBVyxXQUM1QyxXQUFXLHFCQUFzQixXQUFXO0FBR3RDLDhCQUFJLE9BQU8sT0FDZixnREFDQSxrQkFDQTt1QkFFRjt3QkFBQSxFQUFHLGVBQWUsR0FBRyxHQUFHOztvQkFDeEIsd0JBQW1CO0FBQ25COzs7QUFJRSw4QkFDSixlQUFnQixtQkFBb0IsU0FBUyxRQUFRO0FBQ2pELDhCQUNKLGVBQWdCLG1CQUFvQixTQUFTLFFBQVE7ZUFHbkQsZ0JBQWdCO2dCQUNsQix3QkFBbUI7QUFDbkI7O2VBSUUsOEJBQW1CLGdCQUFpQjtnQkFDdEMsT0FBTyxRQUFRLGNBQWM7O2VBSTNCO2dCQUNGLE9BQU8sWUFBWSxjQUFjOztBQUduQywwQ0FBZ0I7QUFDaEIsMENBQWdCO2VBSVo7QUFDRix5QkFBUztBQUNULHlCQUFTOztBQUVULGtDQUFVO0FBQ1Ysa0NBQVU7O0FBR1osd0NBQWU7ZUFHYiw2Q0FDQSxlQUFlO0FBRWY7O0FBR0YsMENBQWdCLG1CQUFtQjtRQWpHRjs7QUFvR25DLFdBQU8sQ0FBRTtBQXpLWDs7Ozs7O0FBa0xBLCtDQUNFLE9BQ0EsUUFDQSxjQUNBO0FBRU0sa0JBQVEsTUFBTTtBQUNkLDRCQUFrQjtBQUNsQiw2QkFBbUIsSUFBSTtBQUN2Qiw2QkFBbUI7QUFDckIseUJBQWU7QUFDZix3QkFBYztJQUlsQixNQUFNO1FBQU07UUFBaUI7UUFBTTtBQUUzQiw4QkFDSixlQUFnQixtQkFBb0IsU0FBUyxRQUFRO0FBQ2pELDhCQUNKLGVBQWdCLG1CQUFvQixTQUFTLFFBQVE7ZUFHbkQsNEJBQWlCLGdCQUFnQjtnQkFDbkMsT0FBTyxNQUFNLGNBQWM7O2VBSXpCLGdCQUFnQjtnQkFDbEIsTUFBTTtBQUNOOztlQUlFLDhCQUFtQixnQkFBaUI7Z0JBQ3RDLE9BQU8sUUFBUSxjQUFjOztlQUkzQjtnQkFDRixPQUFPLFlBQVksY0FBYzs7QUFHbkMsa0NBQVk7QUFDWixrQ0FBWTtBQUVaLHdDQUFlO2VBR2IsNkNBQ0EsZUFBZTtBQUVmOztBQUdGLDBDQUFnQixtQkFBbUI7UUF4Q0Y7O0FBMkNuQyxtQkFBUztRQUNQLE1BQU07SUFEUjtBQUlBLFdBQU8sQ0FBRTtBQTlEWCIsImZpbGUiOiJwaHlzaWNzLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/dist/utils/players.lua

@@ -0,0 +1,234 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
+local __TS__InstanceOf = ____lualib.__TS__InstanceOf
+local __TS__StringReplace = ____lualib.__TS__StringReplace
+local ____exports = {}
+local ____w3ts = require("lua_modules.w3ts.index")
+local Group = ____w3ts.Group
+local MapPlayer = ____w3ts.MapPlayer
+local Trigger = ____w3ts.Trigger
+local ____globals = require("lua_modules.w3ts.globals.index")
+local Players = ____globals.Players
+---
+-- @param unitType Unit Type Id or the Unit Type String "hcas", etc
+function ____exports.forEachUnitOfPlayer(self, player, cb)
+    local g = Group:create()
+    if g ~= nil then
+        g:enumUnitsOfPlayer(
+            player,
+            function()
+                local unit = Group:getFilterUnit()
+                if not unit then
+                    print("Enumerating over a unit that doesn't exist!")
+                end
+                if unit then
+                    cb(nil, unit)
+                end
+                return true
+            end
+        )
+    end
+    if g ~= nil then
+        g:destroy()
+    end
+end
+--- Does a callback for every unit of the player that has the ability
+-- 
+-- @param player
+-- @param abilityId
+-- @param cb
+function ____exports.forEachUnitOfPlayerWithAbility(self, player, abilityId, cb)
+    ____exports.forEachUnitOfPlayer(
+        nil,
+        player,
+        function(____, u)
+            do
+                local x = 0
+                while x < 12 do
+                    local currentAbility = u:getAbilityByIndex(x)
+                    if currentAbility and currentAbility == u:getAbility(abilityId) and u:isAlive() then
+                        cb(nil, u)
+                    end
+                    x = x + 1
+                end
+            end
+        end
+    )
+end
+--- Calls a function for each player playing and is an ally of red.
+-- 
+-- @warning specific to map
+function ____exports.forEachAlliedPlayer(self, cb)
+    __TS__ArrayForEach(
+        Players,
+        function(____, player, index)
+            if player.slotState == PLAYER_SLOT_STATE_PLAYING and player:isPlayerAlly(Players[1]) and player ~= Players[26] and player ~= Players[28] then
+                cb(nil, player, index)
+            end
+        end
+    )
+end
+function ____exports.forEachPlayer(self, cb)
+    __TS__ArrayForEach(
+        Players,
+        function(____, p, index)
+            cb(nil, p, index)
+        end
+    )
+end
+--- Executes the callback function for each unit matching the unit type for the player
+-- 
+-- @param unitType Unit Type Id or the Unit Type String "hcas", etc
+function ____exports.forEachUnitTypeOfPlayer(self, unitType, player, cb)
+    if type(unitType) == "string" then
+        unitType = FourCC(unitType)
+    end
+    local g = Group:create()
+    if g ~= nil then
+        g:enumUnitsOfPlayer(
+            player,
+            function()
+                local unit = Group:getFilterUnit()
+                if unit and (unit and unit.typeId) == unitType then
+                    cb(nil, unit)
+                end
+                return true
+            end
+        )
+    end
+    if g ~= nil then
+        g:destroy()
+    end
+end
+--- Doesn;'t appear to actually work?
+-- 
+-- @broken
+-- @param unitName
+-- @param unitType
+-- @param fn
+function ____exports.forEachUnitOfType(self, unitName, unitType, fn)
+    if type(unitType) == "string" then
+        unitType = FourCC(unitType)
+    end
+    print(unitName)
+    local g = Group:create()
+    if g ~= nil then
+        g:enumUnitsOfType(
+            unitName,
+            function()
+                local unit = Group:getFilterUnit()
+                if unit and (unit and unit.typeId) == unitType then
+                    fn(nil, unit)
+                end
+                return true
+            end
+        )
+    end
+    print((("Total units of name " .. unitName) .. " found: ") .. tostring(g and g.size))
+    if g ~= nil then
+        g:destroy()
+    end
+end
+--- Executes the callback function for each unit matching the unit type for the player
+-- 
+-- @param unitType Unit Type Id or the Unit Type String "hcas", etc
+function ____exports.forEachUnitInRectangle(self, rectangle, cb)
+    local g = Group:create()
+    if g ~= nil then
+        g:enumUnitsInRect(
+            rectangle,
+            function()
+                local unit = Group:getFilterUnit()
+                if unit then
+                    cb(nil, unit)
+                end
+                return true
+            end
+        )
+    end
+    if g ~= nil then
+        g:destroy()
+    end
+end
+function ____exports.isPlaying(self, player)
+    if __TS__InstanceOf(player, MapPlayer) then
+        return player.slotState == PLAYER_SLOT_STATE_PLAYING
+    end
+    return GetPlayerSlotState(player) == PLAYER_SLOT_STATE_PLAYING
+end
+function ____exports.isUser(self, player)
+    if __TS__InstanceOf(player, MapPlayer) then
+        return GetPlayerController(player.handle) == MAP_CONTROL_USER
+    end
+    return GetPlayerController(player) == MAP_CONTROL_USER
+end
+function ____exports.isComputer(self, player)
+    if __TS__InstanceOf(player, MapPlayer) then
+        return GetPlayerController(player.handle) == MAP_CONTROL_COMPUTER
+    end
+    return GetPlayerController(player) == MAP_CONTROL_COMPUTER
+end
+function ____exports.isPlayingUser(self, player)
+    return ____exports.isUser(nil, player) and ____exports.isPlaying(nil, player)
+end
+function ____exports.adjustPlayerState(self, player, whichState, amount)
+    player:setState(
+        whichState,
+        player:getState(whichState) + amount
+    )
+end
+function ____exports.adjustGold(self, player, amount)
+    player:setState(
+        PLAYER_STATE_RESOURCE_GOLD,
+        player:getState(PLAYER_STATE_RESOURCE_GOLD) + amount
+    )
+end
+function ____exports.adjustLumber(self, player, amount)
+    player:setState(
+        PLAYER_STATE_RESOURCE_LUMBER,
+        player:getState(PLAYER_STATE_RESOURCE_LUMBER) + amount
+    )
+end
+function ____exports.adjustFoodCap(self, player, amount)
+    player:setState(
+        PLAYER_STATE_RESOURCE_FOOD_CAP,
+        player:getState(PLAYER_STATE_RESOURCE_FOOD_CAP) + amount
+    )
+end
+function ____exports.adjustFoodUsed(self, player, amount)
+    player:setState(
+        PLAYER_STATE_RESOURCE_FOOD_USED,
+        player:getState(PLAYER_STATE_RESOURCE_FOOD_USED) + amount
+    )
+end
+function ____exports.playerHasResources(self, player, data)
+    local hasGold = true
+    local hasLumber = true
+    if data.gold and data.gold ~= 0 then
+        hasGold = player:getState(PLAYER_STATE_RESOURCE_GOLD) >= data.gold
+    end
+    if data.lumber and data.lumber ~= 0 then
+        hasLumber = player:getState(PLAYER_STATE_RESOURCE_LUMBER) >= data.lumber
+    end
+    return hasGold and hasLumber
+end
+function ____exports.setPlayerName(self)
+    local t = Trigger:create()
+    ____exports.forEachPlayer(
+        nil,
+        function(____, p)
+            t:registerPlayerChatEvent(p, "-playername ", false)
+            t:addAction(function()
+                local str = GetEventPlayerChatString()
+                local ____opt_22 = str
+                local newName = ____opt_22 and __TS__StringReplace(str, "-playername", "")
+                if newName then
+                    SetPlayerName(p.handle, newName)
+                end
+            end)
+        end
+    )
+end
+return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9wbGF5ZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsaUJBQTJEO0FBQWxEO0FBQU87QUFBc0I7QUFDdEMsb0JBQXdCO0FBQWY7OztBQWlHVCwrQ0FBb0MsUUFBbUI7QUFDN0MsY0FBSSxNQUFNO09BRWhCO1FBQUEsRUFBRztZQUFrQjtZQUFRO0FBQ25CLDZCQUFPLE1BQU07dUJBRWQ7b0JBQ0QsTUFBTTs7bUJBRU47b0JBQ0EsUUFBRzs7QUFHUCx1QkFBTztZQVZrQjs7O09BYTdCO1FBQUEsRUFBRzs7QUFoQlA7Ozs7OztBQXpGQSwwREFBK0MsUUFBbUIsV0FBbUI7SUFDakY7O1FBQW9CO1FBQVEsZUFBQzs7QUFDaEIsMEJBQUk7c0JBQUcsSUFBSTtBQUNWLDJDQUFpQixFQUFFLGtCQUFrQjt1QkFFdkMsbUJBQWtCLGtCQUFtQixFQUFFLFdBQVcsZUFBYyxFQUFFO3dCQUNsRSxRQUFHOztBQUphOzs7UUFEQTs7QUFEaEM7Ozs7QUFnQkEsK0NBQW9DO0lBQ2hDO1FBQUE7UUFBZ0IsZUFBQyxRQUFRO2VBRWpCLG9CQUFxQiw4QkFBNkIsT0FBTyxhQUFhLFFBQVEsUUFBTyxVQUFVLFFBQVEsUUFBTyxVQUFVLFFBQVE7Z0JBQ2hJLFFBQUcsUUFBUTs7UUFISDs7QUFEcEI7QUFTQSx5Q0FBOEI7SUFDMUI7UUFBQTtRQUFnQixlQUFDLEdBQUc7WUFDaEIsUUFBRyxHQUFHO1FBRE07O0FBRHBCOzs7O0FBVUEsbURBQXdDLFVBQTJCLFFBQW1CO09BQzlFLEtBQU8sYUFBYTtBQUNwQixtQkFBVyxPQUFPOztBQUdoQixjQUFJLE1BQU07T0FFaEI7UUFBQSxFQUFHO1lBQWtCO1lBQVE7QUFDbkIsNkJBQU8sTUFBTTttQkFFZixTQUFRLDBCQUFpQjtvQkFDekIsUUFBRzs7QUFHUCx1QkFBTztZQVBrQjs7O09BVTdCO1FBQUEsRUFBRzs7QUFqQlA7Ozs7Ozs7QUEyQkEsNkNBQWtDLFVBQWtCLFVBQTJCO09BQ3ZFLEtBQU8sYUFBYTtBQUNwQixtQkFBVyxPQUFPOztJQUd0QixNQUFNO0FBRUEsY0FBSSxNQUFNO09BRWhCO1FBQUEsRUFBRztZQUFnQjtZQUFVO0FBQ25CLDZCQUFPLE1BQU07bUJBRWYsU0FBUSwwQkFBaUI7b0JBQ3pCLFFBQUc7O0FBR1AsdUJBQU87WUFQa0I7OztJQVU3QixRQUFNLDBCQUF1QixhQUFRLHdCQUFXO09BRWhEO1FBQUEsRUFBRzs7QUFyQlA7Ozs7QUFrREEsa0RBQXVDLFdBQXNCO0FBQ25ELGNBQUksTUFBTTtPQUVoQjtRQUFBLEVBQUc7WUFBZ0I7WUFBVztBQUNwQiw2QkFBTyxNQUFNO21CQUVmO29CQUNBLFFBQUc7O0FBR1AsdUJBQU87WUFQbUI7OztPQVU5QjtRQUFBLEVBQUc7O0FBYlA7QUFnQkEscUNBQTBCO09BQ2xCLHlCQUFrQjtBQUNsQixlQUFPLG9CQUFxQjs7QUFHaEMsV0FBTyxtQkFBbUIsV0FBWTtBQUwxQztBQVFBLGtDQUF1QjtPQUNmLHlCQUFrQjtBQUNsQixlQUFPLG9CQUFvQixrQkFBbUI7O0FBR2xELFdBQU8sb0JBQW9CLFdBQVk7QUFMM0M7QUFRQSxzQ0FBMkI7T0FDbkIseUJBQWtCO0FBQ2xCLGVBQU8sb0JBQW9CLGtCQUFtQjs7QUFHbEQsV0FBTyxvQkFBb0IsV0FBWTtBQUwzQztBQVFBLHlDQUE4QjtBQUMxQixXQUFPLHdCQUFPLFlBQVcsMkJBQVU7QUFEdkM7QUFJQSw2Q0FBa0MsUUFBbUIsWUFBeUI7SUFDMUUsT0FBTztRQUFTO1FBQVksT0FBTyxTQUFTLGNBQWM7O0FBRDlEO0FBSUEsc0NBQTJCLFFBQW1CO0lBQzFDLE9BQU87UUFBUztRQUE0QixPQUFPLFNBQVMsOEJBQThCOztBQUQ5RjtBQUlBLHdDQUE2QixRQUFtQjtJQUM1QyxPQUFPO1FBQVM7UUFBOEIsT0FBTyxTQUFTLGdDQUFnQzs7QUFEbEc7QUFJQSx5Q0FBOEIsUUFBbUI7SUFDN0MsT0FBTztRQUFTO1FBQWdDLE9BQU8sU0FBUyxrQ0FBa0M7O0FBRHRHO0FBSUEsMENBQStCLFFBQW1CO0lBQzlDLE9BQU87UUFBUztRQUFpQyxPQUFPLFNBQVMsbUNBQW1DOztBQUR4RztBQUlBLDhDQUFtQyxRQUFtQjtBQUM5QyxvQkFBVTtBQUNWLHNCQUFZO09BRVosY0FBYSxhQUFhO0FBQzFCLGtCQUFVLE9BQU8sU0FBUywrQkFBK0I7O09BR3pELGdCQUFlLGVBQWU7QUFDOUIsb0JBQVksT0FBTyxTQUFTLGlDQUFpQzs7QUFHakUsV0FBTyxZQUFXO0FBWnRCO0FBZUE7QUFDVSxjQUFJLFFBQVE7SUFDbEI7O1FBQWMsZUFBQztZQUNYLEVBQUUsd0JBQXdCLEdBQUcsZ0JBQWdCO1lBRTdDLEVBQUUsVUFBVTtBQUNGLDRCQUFNO21DQUNJO0FBQVYsZ0NBQVUsd0NBQWEsZUFBZTttQkFDeEM7b0JBQ0EsY0FBYyxVQUFVOztZQUpwQjtRQUhGOztBQUZsQiIsImZpbGUiOiJwbGF5ZXJzLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/dist/utils/point.lua

@@ -0,0 +1,60 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____w3ts = require("lua_modules.w3ts.index")
+local Point = ____w3ts.Point
+local Rectangle = ____w3ts.Rectangle
+local MAP_EDGE_BUFFER_DIST = 300
+function ____exports.createValidPoint(self, maxAttempts, validatorFn)
+    local MAX_ATTEMPTS = 65000
+    local currentAttempts = 0
+    local worldBounds = Rectangle:fromHandle(GetWorldBounds())
+    if not worldBounds then
+        return
+    end
+    local maxX, maxY = GetCameraBoundMaxX(), GetCameraBoundMaxY()
+    while currentAttempts <= MAX_ATTEMPTS do
+        local dirX = math.floor(math.random() * 100) >= 50 and 1 or -1
+        local dirY = math.floor(math.random() * 100) >= 50 and 1 or -1
+        local randX = dirX * math.ceil(math.random() * maxX) - dirX * MAP_EDGE_BUFFER_DIST
+        local randY = dirY * math.ceil(math.random() * maxY) - dirY * MAP_EDGE_BUFFER_DIST
+        local p = Point:create(randX, randY)
+        local isValidPoint = validatorFn(nil, p)
+        if isValidPoint then
+            return p
+        else
+            currentAttempts = currentAttempts + 1
+        end
+    end
+end
+function ____exports.getRandomCoordinatesInCircularArea(self, relativeX, relativeY, radius)
+    local randomTheta = math.random() * 360
+    local randomRadius = math.random() * radius
+    local randomX = relativeX + randomRadius * Cos(randomTheta)
+    local randomY = relativeY + randomRadius * Sin(randomTheta)
+    return {x = randomX, y = randomY}
+end
+function ____exports.getRandomCoordinatesOnCircle(self, relativeX, relativeY, radius)
+    local randomTheta = math.random() * 360
+    local randomX = relativeX + radius * Cos(randomTheta)
+    local randomY = relativeY + radius * Sin(randomTheta)
+    return {x = randomX, y = randomY}
+end
+--- Returns degrees or radians?
+function ____exports.getAngleBetweenPoints(self, x1, y1, x2, y2)
+    local locA = Location(x1, y1)
+    local locB = Location(x2, y2)
+    local angle = AngleBetweenPoints(locA, locB)
+    RemoveLocation(locA)
+    RemoveLocation(locB)
+    return angle
+end
+function ____exports.distanceBetweenPoints(self, x1, y1, x2, y2)
+    local deltaX = x1 - x2
+    local deltaY = y1 - y2
+    local squaredDist = deltaX * deltaX + deltaY * deltaY
+    local dist = math.sqrt(squaredDist)
+    return dist
+end
+return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9wb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLGlCQUFpQztBQUF4QjtBQUFPO0FBQ1YsNkJBQXVCO0FBRTdCLDRDQUFpQyxhQUFxQjtBQUM1Qyx5QkFBZTtBQUNqQiw0QkFBa0I7QUFDaEIsd0JBQWMsVUFBVSxXQUFXO1dBQ3BDO0FBQWE7O0FBQ0csVUFBZCxNQUFNLE9BQVMsc0JBQXNCO1VBRXJDLG1CQUFtQjtBQUNoQixxQkFBTyxXQUFXLGdCQUFnQixRQUFRLE9BQUssTUFBSztBQUNwRCxxQkFBTyxXQUFXLGdCQUFnQixRQUFRLE9BQUssTUFBSztBQUdwRCxzQkFBUSxPQUFPLFVBQVUsZ0JBQWdCLFFBQVEsT0FBTztBQUN4RCxzQkFBUSxPQUFPLFVBQVUsZ0JBQWdCLFFBQVEsT0FBTztBQUV4RCxrQkFBSSxNQUFNLE9BQU8sT0FBTztBQUV4Qiw2QkFBZSxpQkFBWTtXQUU3QjtBQUVBLG1CQUFPOztBQUdQOzs7QUF4Qlo7QUE2QkEsOERBQW1ELFdBQW1CLFdBQW1CO0FBQy9FLHdCQUFjLGdCQUFnQjtBQUM5Qix5QkFBZSxnQkFBZ0I7QUFFL0Isb0JBQVUsWUFBWSxlQUFlLElBQUk7QUFDekMsb0JBQVUsWUFBWSxlQUFlLElBQUk7QUFFL0MsV0FBTyxDQUNILElBQUcsU0FDSCxJQUFHO0FBVFg7QUFhQSx3REFBNkMsV0FBbUIsV0FBbUI7QUFDekUsd0JBQWMsZ0JBQWdCO0FBRTlCLG9CQUFVLFlBQVksU0FBUyxJQUFJO0FBQ25DLG9CQUFVLFlBQVksU0FBUyxJQUFJO0FBRXpDLFdBQU8sQ0FDSCxJQUFHLFNBQ0gsSUFBRztBQVJYOztBQWVBLGlEQUFzQyxJQUFZLElBQVksSUFBWTtBQUNoRSxpQkFBTyxTQUFTLElBQUk7QUFDcEIsaUJBQU8sU0FBUyxJQUFJO0FBRXBCLGtCQUFRLG1CQUFtQixNQUFNO0lBRXZDLGVBQWU7SUFDZixlQUFlO0FBRWYsV0FBTztBQVRYO0FBWUEsaURBQXNDLElBQVksSUFBWSxJQUFZO0FBQ2hFLG1CQUFTLEtBQUs7QUFDZCxtQkFBUyxLQUFLO0FBQ2Qsd0JBQWMsU0FBUyxTQUFTLFNBQVM7QUFFekMsaUJBQU8sVUFBVTtBQUV2QixXQUFPO0FBUFgiLCJmaWxlIjoicG9pbnQubHVhIiwic291cmNlUm9vdCI6IiJ9

package/dist/utils/quests.lua

@@ -0,0 +1,47 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____w3ts = require("lua_modules.w3ts.index")
+local Quest = ____w3ts.Quest
+local Timer = ____w3ts.Timer
+local ____misc = require("utils.misc")
+local tColor = ____misc.tColor
+function ____exports.addQuest(self, title, description, iconPath, required)
+    if required == nil then
+        required = true
+    end
+    local q = Quest:create()
+    if q then
+        q:setTitle(title)
+        q.required = required
+        q:setDescription(description)
+        if iconPath then
+            q:setIcon(iconPath)
+        end
+    end
+end
+function ____exports.setup_quests(self)
+    Timer:create():start(
+        1,
+        false,
+        function()
+            ____exports.addQuest(nil, "Basic Game Info", "\nA roguelite base assault game. \nChoose from a wide variety of units that are trained in various schools of magic and skills.\n Outsmart and counter your opponent..\n        ", "ReplaceableTextures\\CommandButtons\\BTNPeasant.blp")
+            ____exports.addQuest(
+                nil,
+                "Commands",
+                ("\n            \n" .. tColor(nil, "-cam ####", "goldenrod")) .. ": Sets the camera distance.\n            \n-playername xxxx   This will change your name.\n        ",
+                "ReplaceableTextures\\WorldEditUI\\Doodad-Cinematic.blp",
+                false
+            )
+            ____exports.addQuest(
+                nil,
+                "|cffffcc00Evolution Castle Assault v0.01|r",
+                "Created by JediMindTrix/NihilismIsDeath",
+                "ReplaceableTextures\\CommandButtons\\BTNClayFigurine.blp",
+                false
+            )
+        end
+    )
+end
+return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9xdWVzdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSxpQkFBNkI7QUFBcEI7QUFBTztBQUNoQixpQkFBdUI7QUFBZDtBQTBCVCxvQ0FBeUIsT0FBZSxhQUFxQixVQUFtQjtPQUFBO1FBQUEsV0FBb0I7O0FBQzFGLGNBQUksTUFBTTtPQUNaO1FBQ0EsRUFBRSxTQUFTO0FBQ1gscUJBQWE7UUFDYixFQUFFLGVBQWU7V0FDYjtZQUNBLEVBQUUsUUFBUTs7O0FBUHRCO0FBeEJBO0lBQ0ksTUFBTSxTQUFTO1FBQU07UUFBRztRQUFPO1lBQzNCLDBCQUNJLG1CQUNBLG9MQUVBO1lBSUo7O2dCQUNJO2lCQUNBLHNCQUNJLFlBQU8sYUFBYSxpQkFBWTtnQkFHcEM7Z0JBQ0E7O1lBR0o7O2dCQUFTO2dCQUE4QztnQkFBMkM7Z0JBQTREOztRQW5Cbkk7O0FBRG5DIiwiZmlsZSI6InF1ZXN0cy5sdWEiLCJzb3VyY2VSb290IjoiIn0=