cmd_instant_dgun.lua

function widget:GetInfo()
    return {
        name      = "Instant Dgun",
        desc      = "Aims when you press d-gun key down, fires when you release. VERSION 2: seamless integration with meta key use, it should feel just like with shift!",
        author    = "Errrrrrr",
        date      = "May 23, 2023",
        version   = "2.1",
        license   = "GNU GPL, v2 or later",
        layer     = 999999,
        enabled   = true,
        handler   = true,
    }
end

--------------------------------------------------------------------------------------------
-- Version 2 overhauled everything to smart cast commands logic, should be safer to use!
-- Added default_insert_mode parmam, the normal default is off, try the new meta key!
--------------------------------------------------------------------------------------------
local default_insert_mode = false

local enabled = true
local selectedUnits = {}
local active = false
local mouseClicked = false
local curMods = {false,false,false,false}   -- {alt, ctrl, meta, shift}

-- shortcuts
local echo = Spring.Echo
local GetActiveCommand = Spring.GetActiveCommand
local GetSelectedUnits = Spring.GetSelectedUnits
local GetUnitPosition = Spring.GetUnitPosition
local GetFeaturePosition = Spring.GetFeaturePosition
local GetModKeyState = Spring.GetModKeyState
local GetInvertQueueKey = Spring.GetInvertQueueKey
local GetMouseState = Spring.GetMouseState
local SetActiveCommand = Spring.SetActiveCommand
local TraceScreenRay = Spring.TraceScreenRay
local GetKeySymbol = Spring.GetKeySymbol
local GetKeyBindings = Spring.GetKeyBindings
local GiveOrder = Spring.GiveOrder


local function tableToString(t)
    local result = ""
  
    if type(t) ~= "table" then
      result = tostring(t)
    elseif t == nil then
      result = "nil"
    else
      for k, v in pairs(t) do
        result = result .. "[" .. tostring(k) .. "] = "
  
        if type(v) == "table" then
          result = result .. "{"
  
          for k2, v2 in pairs(v) do
            result = result .. "[" .. tostring(k2) .. "] = "
  
            if type(v2) == "table" then
              result = result .. "{"
  
              for k3, v3 in pairs(v2) do
                result = result .. "[" .. tostring(k3) .. "] = " .. tostring(v3) .. ", "
              end
  
              result = result .. "}, "
            else
              result = result .. tostring(v2) .. ", "
            end
          end
  
          result = result .. "}, "
        else
          result = result .. tostring(v) .. ", "
        end
        result = result .." \n"
      end
    end
  
    return "{" .. result:sub(1, -3) .. "}"
end

local function dumpToFile(obj, prefix, filename)
    local file = assert(io.open(filename, "w"))
    if type(obj) == "table" then
        for k, v in pairs(obj) do
            local key = prefix and (prefix .. "." .. tostring(k)) or tostring(k)
            if type(v) == "function" then
                local info = debug.getinfo(v, "S")
                file:write(key .. " (function) defined in " .. info.source .. " at line " .. info.linedefined .. "\n")
            elseif type(v) == "table" then
                file:write(key .. " (table):\n")
                dumpToFile(v, key, filename)
            else
                file:write(key .. " = " .. tostring(v) .. "\n")
            end
        end
    end
    if type(obj) == "string" then
        file:write(obj)
    end

    file:close()
end

local keyBindings = GetKeyBindings() -- Get the key bindings from the game, might not work here depending on widget load order

-- let's make a lookup table for faster cmd lookup
local keyToBinding = {}
--[[ for _, binding in pairs(keyBindings) do
    local key = binding["boundWith"]
    local cmd = binding["command"]
    if key and cmd then
        if keyToBinding[key] == nil then keyToBinding[key] = cmd
        else
            -- if there's clash, we need to add to existing
            local value = keyToBinding[key]
            if type(value) == "table" then  -- already more than one entry
                value[#value+1] = cmd
                keyToBinding[key] = value
            elseif type(value) == "string" then  -- one entry only
                local newValue = {value, cmd}
                keyToBinding[key] = newValue
            end
        end
    end
end  ]]

--table.save(keyToBinding, "LuaUI/config/keyToBinding.txt", "Smart Commands")

local skipFeatureCmd = {    -- these cannot be set on featureID
    [CMD.ATTACK]=true, [CMD.PATROL]=true, [CMD.FIGHT]=true, [CMD.MANUALFIRE]=true
}

local skipAltogether = {
    [10010]=true,   -- CMD_BUILD
    [30100]=true,   -- CMD_AREA_MEX
}

local isModKey = {
    [32]=true, [304]=true, [306]=true, [308]=true
}

local isBuildKey = {
    [122]=true, [120]=true, [118]=true, [99]=true
}


function widget:Initialize()
    local keyBindings = GetKeyBindings()
    for _, binding in pairs(keyBindings) do
        local key = binding["boundWith"]
        local cmd = binding["command"]
        if key and cmd then
            if keyToBinding[key] == nil then keyToBinding[key] = cmd
            else
                -- if there's clash, we need to add to existing
                local value = keyToBinding[key]
                if type(value) == "table" then  -- already more than one entry
                    value[#value+1] = cmd
                    keyToBinding[key] = value
                elseif type(value) == "string" then  -- one entry only
                    local newValue = {value, cmd}
                    keyToBinding[key] = newValue
                end
            end
        end
    end
    selectedUnits = GetSelectedUnits()
end

function toggle(_,_,args)
    enabled = not enabled
    local status = enabled and "on" or "off"
    echo("Smart Commands toggled ".. status)
end

function widget:MousePress(x, y, button)
    if not enabled or #selectedUnits == 0 then return false end

    mouseClicked = true
    --echo("mouse clicked TRUE")
end

local function isChatActive()
    return WG['chat'].isInputActive() or false
end

local function setActiveCmdFromKey(key)
    local result = false
    local keyString = GetKeySymbol(key)
    if keyString then 
        local keyString = "sc_"..keyString
        local modString = ""
        if curMods and curMods.ctrl then modString = "Ctrl+" end
        if curMods and curMods.alt then modString = "Alt+" end
        keyString = modString .. keyString
        --echo("keyString: "..keyString)
        local cmdName = keyToBinding[keyString]
        --echo("keyString: "..keyString..", cmdName: "..tostring(cmdName))
        if cmdName then
            --echo("command set through keybind search: "..tableToString(cmdName))
            if type(cmdName) == "table" then -- we have multiple commands possible
                local cmd
                for i=1, #cmdName do
                    cmd = cmdName[i]
                    result = SetActiveCommand(cmd)
                    if result then break end
                end
                --if not result then echo("Error in finding bound command!") end
            elseif type(cmdName) == "string" then -- only one command bound
                result = SetActiveCommand(cmdName)
            end
            active = true
            --echo("active")
        end
    end
    return result
end

function widget:KeyPress(key, mods, isRepeat)
--[[     if key == 8 and mods.alt then   -- alt+backspace
        toggle()
    end ]]
    if not enabled or #selectedUnits == 0 then return false end
    if isChatActive() then return false end
    if isBuildKey[key] then return false end


    --echo("key = " .. tostring(key))

    curMods = mods
    if isModKey[key] then 
        --echo("mod key only! ".. tostring(key))
        return false 
    end

    if mouseClicked and not isRepeat then 
        mouseClicked = false 
        --echo("mouse clicked FALSE")
    end
    active = setActiveCmdFromKey(key, mods, isRepeat)

    return active
end

function widget:KeyRelease(key)
    if not enabled or #selectedUnits == 0 then return false end
    if isChatActive() then return false end
    if isBuildKey[key] then return false end

    local alt, ctrl, meta, shift = GetModKeys()
    curMods.alt = alt
    curMods.ctrl = ctrl
    curMods.meta = meta
    curMods.shift = shift

    if isModKey[key] then return false end
    
    local cmdIndex, cmdID, cmdType, cmdName = GetActiveCommand()
    if active and mouseClicked then
        mouseClicked = false 
        --echo("mouseClicked false")
        if cmdID and cmdID > 0 and not skipAltogether[cmdID] and cmdID == 105 then  -- d-gun only!!!
            SetActiveCommand(0)
        end
        return false
    end
    --echo("cmdIndex: "..tostring(cmdIndex).." cmdID: "..tostring(cmdID).." cmdType: "..tostring(cmdType).." cmdName: "..tostring(cmdName))

    if active and cmdID ~= nil and cmdID > 0 and not skipAltogether[cmdID] and cmdID == 105 then
        executeCommand(cmdID)
        active = false
    end

end

local function GiveNotifyingOrder(cmdID, cmdParams, cmdOpts)

    if widgetHandler:CommandNotify(cmdID, cmdParams, cmdOpts) then
        return
    end

    GiveOrder(cmdID, cmdParams, cmdOpts.coded)
end

function widget:SelectionChanged(sel)
    if not enabled then return false end

    selectedUnits = sel
end

function executeCommand(cmdID)
    if not enabled or #selectedUnits == 0 then return false end

    local mouseX, mouseY = GetMouseState()
    local desc, args = TraceScreenRay(mouseX, mouseY, false)
    if desc == nil then 
        return 
    end

    local params = {}
    if desc == "unit" then
        params = {args}
        if CMD.FIGHT == cmdID or CMD.PATROL == cmdID then
            local fx, fy, fz = GetUnitPosition(args, true)
            params = {fx, fy, fz}
        end
    elseif desc == "feature" then
        params = {args+32000} -- seriously wtf
        if skipFeatureCmd[cmdID] then
            local fx, fy, fz = GetFeaturePosition(args, true)
            params = {fx, fy, fz}
        end
    else
        params = {args[1], args[2], args[3]}
    end
    --local alt, ctrl, meta, shift = GetModKeys()
    local cmdOpts
    local altOpts = GetCmdOpts(true, false, false, false, false)

    if default_insert_mode then curMods.meta = not curMods.meta end
 
    if curMods.meta and (cmdID ~= 34923 and cmdID ~= 34925) then
        cmdOpts = GetCmdOpts(curMods.alt, curMods.ctrl, false, curMods.shift, false)
        GiveOrder(CMD.INSERT, {0, cmdID, cmdOpts.coded, unpack(params)}, altOpts)
    else
        if cmdID == 34923 or cmdID == 34925 then  -- insert doesn't play nice with set_target
            curMods.meta = false
        end

        cmdOpts = GetCmdOpts(curMods.alt, curMods.ctrl, curMods.meta, curMods.shift, false)
        GiveOrder(cmdID, params, cmdOpts)
    end
    --echo("cmdID: ".. tostring(cmdID)..", opts: ".. tableToString(cmdOpts))
    -- echo("executeCommand set0")
    SetActiveCommand(0)
end

function widget:CommandNotify(id, cmdParams, cmdOpts)
    if not enabled or #selectedUnits == 0 then return false end

    if active and id > 0 then
        SetActiveCommand(0)
    end
end

function GetModKeys()
    local alt, ctrl, meta, shift = GetModKeyState()
  
    if GetInvertQueueKey() then -- Shift inversion
        shift = not shift
    end
  
    return alt, ctrl, meta, shift
end

function GetCmdOpts(alt, ctrl, meta, shift, right)
    local opts = { alt=alt, ctrl=ctrl, meta=meta, shift=shift, right=right }
    local coded = 0
  
    if alt   then coded = coded + CMD.OPT_ALT   end
    if ctrl  then coded = coded + CMD.OPT_CTRL  end
    if meta  then coded = coded + CMD.OPT_META  end
    if shift then coded = coded + CMD.OPT_SHIFT end
    if right then coded = coded + CMD.OPT_RIGHT end
  
    opts.coded = coded
    return opts
end