-- AD Net -- Multiplayer etape 2a (plan docs/superpowers/plans/2026-10-25-adsmartpickup-multiplayer.md): serverens tilstand -- spejles til klienterne. Rene hjælpere uden spil-afhængighed: en Lua-værdi (tabeller af tal, tekst, bool) bliver til -- tekst og tilbage, og teksten deles i bidder, der sendes hver for sig og samles i vilkårlig rækkefølge. -- Format: n | t | f | d; | s: | T...e (funktioner/userdata springes over). ADNet = {} local function encodeValue(value, out, seen) local kind = type(value) if kind == "nil" then out[#out + 1] = "n" elseif kind == "boolean" then out[#out + 1] = value and "t" or "f" elseif kind == "number" then out[#out + 1] = "d" .. string.format("%.17g", value) .. ";" elseif kind == "string" then out[#out + 1] = "s" .. #value .. ":" .. value elseif kind == "table" then if seen[value] then error("ADNet.encode: cyklisk tabel") end seen[value] = true out[#out + 1] = "T" for key, item in pairs(value) do local keyKind, itemKind = type(key), type(item) if (keyKind == "string" or keyKind == "number" or keyKind == "boolean") and itemKind ~= "function" and itemKind ~= "userdata" and itemKind ~= "thread" then encodeValue(key, out, seen) encodeValue(item, out, seen) end end out[#out + 1] = "e" seen[value] = nil end -- funktioner, userdata og tråde springes over (de kan ikke sendes) end function ADNet.encode(value) local out = {} encodeValue(value, out, {}) return table.concat(out) end local function decodeAt(text, pos) local tag = text:sub(pos, pos) if tag == "n" then return nil, pos + 1 end if tag == "t" then return true, pos + 1 end if tag == "f" then return false, pos + 1 end if tag == "d" then local stop = text:find(";", pos + 1, true) if stop == nil then error("ADNet.decode: tal uden slut") end local number = tonumber(text:sub(pos + 1, stop - 1)) if number == nil then error("ADNet.decode: ugyldigt tal ved " .. pos) end return number, stop + 1 end if tag == "s" then local colon = text:find(":", pos + 1, true) if colon == nil then error("ADNet.decode: tekst uden længde") end local length = tonumber(text:sub(pos + 1, colon - 1)) if length == nil or length < 0 or length % 1 ~= 0 or colon + length > #text then error("ADNet.decode: ugyldig tekstlængde ved " .. pos) end return text:sub(colon + 1, colon + length), colon + length + 1 end if tag == "T" then local result = {} pos = pos + 1 while text:sub(pos, pos) ~= "e" do if pos > #text then error("ADNet.decode: tabel uden slut") end local key, item key, pos = decodeAt(text, pos) item, pos = decodeAt(text, pos) if key ~= nil and key == key then result[key] = item end -- (NaN kan ikke være nøgle) end return result, pos + 1 end error("ADNet.decode: ukendt tegn '" .. tag .. "' ved " .. pos) end function ADNet.decode(text) local value = decodeAt(text, 1) return value end -- Transport: spillets streamWriteString er ikke garanteret byte-sikker (NUL, UTF-8 delt over bidder), så alt uden -- for synlig ASCII sendes som %XX. Escaping ophæves først efter samlingen, så en bid må gerne skære midt i en %XX. function ADNet.toWire(text) return (text:gsub("[^\32-\36\38-\126]", function(char) return string.format("%%%02X", char:byte()) end)) end function ADNet.fromWire(text) return (text:gsub("%%(%x%x)", function(hex) return string.char(tonumber(hex, 16)) end)) end -- Teksten i bidder på højst size tegn (mindst én bid, også for tom tekst). function ADNet.split(text, size) local chunks = {} for start = 1, #text, size do chunks[#chunks + 1] = text:sub(start, start + size - 1) end if #chunks == 0 then chunks[1] = "" end return chunks end -- Samling pr. sektion: bidder af en ældre version end den, der er i gang eller allerede er samlet, kasseres; en nyere -- starter forfra. Data kommer fra netværket: ugyldigt index/total afvises i stedet for at fejle (review). function ADNet.newAssembly() return {} end local function isIndex(value, total) return type(value) == "number" and value % 1 == 0 and value >= 1 and value <= total end -- Returnerer den samlede tekst, når sektionens sidste manglende bid er kommet, ellers nil. function ADNet.addChunk(assembly, section, version, index, total, data) if type(version) ~= "number" or type(total) ~= "number" or total < 1 or total % 1 ~= 0 or not isIndex(index, total) or type(data) ~= "string" then return nil end local current = assembly[section] if current ~= nil and (version < current.version or (current.done and version == current.version)) then return nil end if current == nil or version > current.version then current = {version = version, total = total, parts = {}, count = 0} assembly[section] = current end if total ~= current.total then return nil end if current.parts[index] == nil then current.parts[index] = data current.count = current.count + 1 end if current.count < current.total then return nil end local text = table.concat(current.parts, "", 1, current.total) assembly[section] = {version = version, done = true} return text end