From 0f87c42f47a35382af57a7d62de1d7fcda35d16c Mon Sep 17 00:00:00 2001 From: masterdraco Date: Sun, 25 Oct 2026 21:02:07 +0100 Subject: [PATCH] feat(mp): etape 2a - ADNet (tabel <-> tekst, ASCII-sikker transport, opdeling og samling i bidder) --- FS25_ADSmartPickup/adNet.lua | 131 +++++++++++++++++++++++++++++++++ FS25_ADSmartPickup/modDesc.xml | 1 + 2 files changed, 132 insertions(+) create mode 100644 FS25_ADSmartPickup/adNet.lua diff --git a/FS25_ADSmartPickup/adNet.lua b/FS25_ADSmartPickup/adNet.lua new file mode 100644 index 0000000..0d47639 --- /dev/null +++ b/FS25_ADSmartPickup/adNet.lua @@ -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; | 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 diff --git a/FS25_ADSmartPickup/modDesc.xml b/FS25_ADSmartPickup/modDesc.xml index d510c75..f4b5a61 100644 --- a/FS25_ADSmartPickup/modDesc.xml +++ b/FS25_ADSmartPickup/modDesc.xml @@ -42,6 +42,7 @@ Menu: ESC-menuen, siden "Smart Pickup". Statusvindue: numpad *. Kræver AutoDriv +