feat(mp): etape 2a - ADNet (tabel <-> tekst, ASCII-sikker transport, opdeling og samling i bidder)

This commit is contained in:
2026-10-25 21:02:07 +01:00
parent 81534ab873
commit 0f87c42f47
2 changed files with 132 additions and 0 deletions
+131
View File
@@ -0,0 +1,131 @@
-- 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<tal>; | s<længde>:<bytes> | T<nøgle><værdi>...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