FE PNG Loader 2026 Remake

-- Optimized F3X PNG Loader - Velocity Compatible + Fast Mode + Instant Mode
-- Changes: getcustomasset support, batch processing, skip transparent pixels,
-- parallel operations, configurable speed settings, INSTANT MODE

--// SETTINGS \\--
local SETTINGS = {
	BATCH_SIZE = 50,
	BATCH_DELAY = 0.03,
	SKIP_ALPHA_BELOW = 5,
	MAX_IMAGE_SIZE = 256,
	DOWNSCALE_FACTOR = 1,
	MERGE_SIMILAR_COLORS = true,
	COLOR_THRESHOLD = 10,
	USE_BULK_MOVE = true,
	PART_HEIGHT_MULTIPLIER = 5,
	FLAT_MODE = false,
	FLAT_HEIGHT = 1,

	-- INSTANT MODE SETTINGS
	INSTANT_MODE = false,
	INSTANT_THREADS = 100,        -- How many coroutines to spawn at once
	INSTANT_NO_YIELD = true,      -- Skip ALL yields for maximum speed
	INSTANT_SKIP_TRANSPARENCY = true, -- Skip transparency calls in instant mode
	INSTANT_QUEUE_SIZE = 500,     -- How many parts to queue before forcing yield
	INSTANT_PRECREATE_PARTS = true, -- Pre-create all parts before modifying them
}

--// EXECUTOR COMPATIBILITY \\--
local function getasset(path)
	if getcustomasset then
		return getcustomasset(path)
	elseif getsynasset then
		return getsynasset(path)
	end
end

local function httpget(url)
	if syn and syn.request then
		return syn.request({Url = url, Method = "GET"}).Body
	elseif http and http.request then