Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Encode and decode JSON values in Starline Lua scripts.
local data, err = json.Decode('{"name":"de_dust2","rounds":[1,2,3]}')
print(data.name) -- de_dust2
print(#data.rounds) -- 3
local body = json.Encode({ q = "hello", target = "da" })
local value, err = json.Decode(text)
nil plus an error string if the text is not valid JSON.
| JSON | Lua |
|---|---|
| object | Table with string keys |
| array | Table, 1-based |
| string | String |
| number | Number |
| true / false | Boolean |
| null | json.null |
local text, err = json.Encode(value)
nil plus an error string. Functions, userdata and threads cannot be encoded.
| Lua | JSON |
|---|---|
Table, keys 1..n with no gaps | array |
| Table, anything else | object |
| String | string |
| Number | number, with non-finite values written as null |
| Boolean | true / false |
nil, json.null | null |
json.EmptyObject | {} |
json.null preserves JSON null values inside Lua tables and encodes back to null.
local v = json.Decode('{"a":null}')
if v.a == json.null then print("a was null, not missing") end
{} and [] both decode to an empty Lua table, and an empty table encodes to []. Use json.EmptyObject when a server needs {}.
json.Encode({ filters = json.EmptyObject }) -- {"filters":{}}
http.Post(url, json.Encode({ text = "hello", to = "da" }), {
headers = { ["Content-Type"] = "application/json" },
}, function(res)
if not res.ok then return end
local data = json.Decode(res.body)
if data then print(data.translation) end
end)