Storage & Worlds

Rune gives state three lifetimes. Pick by how long it should live:

	Lives until	Values
Lua variables	/reload	anything
rune.session	client exit	strings
rune.store	forever (store.json on disk)	strings, numbers, booleans, tables

Session store

Survives /reload (the Lua VM is rebuilt) but not exit. Use it for mid-session state you don’t want a reload to wipe:

rune.session.set("kills", tostring(kills))
kills = tonumber(rune.session.get("kills") or "0")

Values are strings only. Use rune.json for tables:

local encoded, err = rune.json.encode({kills = 12, route = rune.json.array()})
if err then
    rune.echo(err)
    return
end
rune.session.set("my-script.state", encoded)

-- Later, including after /reload:
local saved = rune.session.get("my-script.state")
if saved ~= nil then
    local state, decodeErr = rune.json.decode(saved)
    if decodeErr then
        rune.echo(decodeErr)
        return
    end
    rune.echo("Kills: " .. state.kills)
end

The string survives reload; decoding rebuilds tables and JSON null values in the current VM. rune.session.delete(key) removes a stored entry.

Durable store

Backed by ~/.config/rune/store.json, which is pretty-printed, hand-editable, and written atomically on every set. Takes structured values:

rune.store.set("prefs", { autoloot = true, greet = "Hail, %s!" })
local prefs = rune.store.get("prefs") or {}

rune.store.set(key, nil) (or rune.store.delete(key)) removes a key.

Worlds

Named bookmarks, stored durably under the "worlds" key:

/world add viking vikingmud.org 2001
/world add secure mud.example.com 4000 tls
/worlds

Then /connect viking, rune viking from your shell, or bare /connect for a picker. From Lua:

rune.world.add(name, address, opts?)  -- extra opts keys stored verbatim
rune.world.get(name)                  -- { address = ... }
rune.world.list()
rune.world.remove(name)

The opts table is yours: the auto-login recipe stores a character name per world and reads it back on connect.

Gotchas

• Unstorable values (functions, cycles, mixed-key tables) return nil, err instead of writing — check the return when storing anything built at runtime.
• A corrupt store.json is preserved as store.json.bak at boot and reported, never silently discarded.
• store.json is plaintext on disk, so keep passwords out of it. The auto-login recipe shows alternatives.

Related: Storage reference, Slash command reference for the full /world and /connect forms