function postostring(pos)
    return pos.x .. ' ' .. pos.y .. ' ' .. pos.z
end

function dirtostring(dir)
    for k, v in pairs(Directions) do
        if v == dir then
            return k
        end
    end
end

function comma_value(n)
    if not n then return "" end
    local left, num, right = string.match(tostring(n), '^([^%d]*%d)(%d*)(.-)$')
    if not left then return tostring(n) end
    return left .. (num:reverse():gsub('(%d%d%d)', '%1,'):reverse()) .. right
end

function formatTimeBySeconds(totalSeconds)
    local hours = math.floor(totalSeconds / 3600)
    local remainingSeconds = totalSeconds % 3600
    local minutes = math.floor(remainingSeconds / 60)
    return string.format("%02d:%02d", hours, minutes)
end

function formatTimeByMinutes(totalMinutes)
    local totalSeconds = totalMinutes * 60
    local hours = math.floor(totalSeconds / 3600)
    local remainingSeconds = totalSeconds % 3600
    local minutes = math.floor(remainingSeconds / 60)
    return string.format("%02d:%02d", hours, minutes)
end

function math.cround(value, rd)
    local _round = math.floor(value / rd)
    return _round * rd
end

function short_text(text, chars_limit)
    if not text then
        return ""
    end
    chars_limit = chars_limit or 20
    if string.len(text) <= chars_limit then
        return text
    end
    return string.sub(text, 1, chars_limit - 3) .. "..."
end

function formatMoney(amount, separator)
  local patternSeparator = string.format("%%1%s%%2", separator)
  local formatted = amount
  while true do
    formatted, k = string.gsub(formatted, "^(-?%d+)(%d%d%d)", patternSeparator)
    if (k==0) then
      break
    end
  end
  return formatted
end

function setStringColor(str, color)
    return str
end

function convertLongGold(amount, shortValue, normalized)
    local hasBillion = false
    local hasTrillion = false
  
    local fomarType = 0
    if normalized and amount >= 1000000 then
      amount = math.floor(amount / 1000000)
      fomarType = 1
    elseif normalized and amount >= 10000 then
      amount = math.floor(amount / 1000)
      fomarType = 2
    elseif shortValue and amount > 10000000 then
        fomarType = 1
      amount = math.floor(amount / 1000000)
    elseif shortValue and amount > 1000000 then
        fomarType = 2
      amount = math.floor(amount / 1000)
    elseif amount > 999999999 then
      fomarType = 1
      amount = math.floor(amount / 1000000)
    elseif amount > 99999999 then
      fomarType = 2
      amount = math.floor(amount / 1000)
    end
  
    local formatted = amount
    while true do
      formatted, k = string.gsub(formatted, "^(-?%d+)(%d%d%d)", '%1,%2')
      if (k==0) then
        break
      end
    end
  
    if fomarType == 1 then
      formatted = formatted .. " kk"
    elseif fomarType == 2 then
      formatted = formatted .. " k"
    end
  
    return formatted
end

function translateWheelVocation(id)
	if type(id) == "string" then
		id = tonumber(id)
	end
	
	if id == 1 or id == 11 then
		return 1 -- ek
	elseif id == 2 or id == 12 then
		return 2 -- rp
	elseif id == 3 or id == 13 then
		return 3 -- ms
	elseif id == 4 or id == 14 then
		return 4 -- ed
  elseif id == 5 or id == 15 then
    return 5 -- em
	end
  return 0
end

-- servers may have different id's, change if not working properly (only for protocols 910+)
function getVocationSt(id)
  if id == 1 or id == 11 then
    return "K0"
  elseif id == 2 or id == 12 then
    return "P0"
  elseif id == 3 or id == 13 then
    return "S0"
  elseif id == 4 or id == 14 then
    return "D0"
  elseif id == 5 or id == 15 then
    return "M0"
  end
  return "N"
end

function getVocationId(name)
  if string.find(name:lower(), "knight") then
    return 11 -- Elite Knight
  elseif string.find(name:lower(), "paladin") then
    return 12 -- Royal Paladin
  elseif string.find(name:lower(), "sorcerer") or string.find(name:lower(), "mag") then
    return 13 -- Master Sorcerer
  elseif string.find(name:lower(), "druid") then
    return 14 -- Elder Druid
  elseif string.find(name:lower(), "monk") then
    return 15 -- Elder Monk
  end

  return 0
end

function roundToTwoDecimalPlaces(num)
  return math.floor(num * 100 + 0.5) / 100
end

function pdumpItemId(itemId)
    if not itemId then
        g_logger.error("pdumpItemId: No itemId provided.")
        return
    end

    local itemType = g_things.getThingType(itemId, 0)
    if not itemType or (itemType:getId() ~= itemId and itemType:getId() == 0) then
        g_logger.error("pdumpItemId: Item " .. tostring(itemId) .. " not found.")
        return
    end

    local groups = {
        { name = "BASIC INFORMATION", props = { "getId", "getName", "getDescription", "getCategory", "getMeanPrice" } },
        { name = "DIMENSIONS AND TEXTURES", props = { "getWidth", "getHeight", "getLayers", "getAnimationPhases", "getRealSize", "getNumPatternX", "getNumPatternY", "getNumPatternZ", "getDisplacementX", "getDisplacementY" } },
        { name = "MOVEMENT PROPERTIES", props = { "isGround", "isGroundBorder", "isOnBottom", "isOnTop", "isNotWalkable", "isNotMoveable", "isNotPathable", "blockProjectile" } },
        { name = "INTERACTIONS", props = { "isPickupable", "isUsable", "isContainer", "isStackable", "isForceUse", "isMultiUse", "isWritable", "isChargeable", "isWritableOnce", "isFluidContainer", "isSplash", "isHangable", "isRotateable", "isMarketable", "isWrapable", "isUnwrapable" } },
        { name = "SPECIFICATIONS / FLAGS", props = { "isTranslucent", "hasDisplacement", "hasElevation", "hasFloorChange", "isLyingCorpse", "isAnimateAlways", "hasMiniMapColor", "hasLensHelp", "isFullGround", "isIgnoreLook", "isCloth", "isTopEffect", "isPodium", "hasWearOut", "hasClockExpire", "hasExpire", "hasExpireStop", "isAmmo", "isDualWield", "hasSkillWheelGem", "getClothSlot", "getElevation", "getMinimapColor", "getLensHelp", "getClassification" } }
    }

    g_logger.info(" ")
    g_logger.info("+--------------------------------------------------------+")
    g_logger.info(string.format("| DUMPING ITEM ID: %-37d |", itemId))
    g_logger.info("+--------------------------------------------------------+")

    for _, group in ipairs(groups) do
        g_logger.info(string.format("| >> %-51s |", group.name))
        g_logger.info("+--------------------------------------------------------+")
        for _, prop in ipairs(group.props) do
            local success, val = pcall(function() return itemType[prop](itemType) end)
            if success then
                if type(val) == "boolean" then
                    val = val and "true" or "false"
                end
                g_logger.info(string.format("|   %-25s : %-24s |", prop, tostring(val)))
            end
        end
        g_logger.info("+--------------------------------------------------------+")
    end
    g_logger.info("+--------------------------------------------------------+")
    g_logger.info(" ")

end