feat(mp): etape 2a - ADNet (tabel <-> tekst, ASCII-sikker transport, opdeling og samling i bidder)
This commit is contained in:
@@ -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
|
||||
@@ -42,6 +42,7 @@ Menu: ESC-menuen, siden "Smart Pickup". Statusvindue: numpad *. Kræver AutoDriv
|
||||
<l10n filenamePrefix="l10n/l10n"/>
|
||||
<extraSourceFiles>
|
||||
<sourceFile filename="adUtil.lua"/>
|
||||
<sourceFile filename="adNet.lua"/>
|
||||
<sourceFile filename="adCache.lua"/>
|
||||
<sourceFile filename="adNaming.lua"/>
|
||||
<sourceFile filename="adNames.lua"/>
|
||||
|
||||
Reference in New Issue
Block a user