ludic/packages/ludic.base/baked.ludic
Orkuncakilkaya e1585de9b6 map packs: Fs.mount / Fs.unmount at run time, and a map's bakes under assets/baked/maps/<map>/
Maps ship outside the game, each one a content-addressed pack (.lmap: the .lpak format) downloaded to
the save root. The runtime already served reads from packs mounted at boot (packs.index); now one can
come and go while the game runs:

- Fs.mount(path) -> bool maps a pack over the ones mounted before it (searched first, as a later
  packs.index line is); Fs.unmount(path) -> bool gives the mapping back (munmap, UnmapViewOfFile on
  Windows) and closes the gap in the search order. Each slot keeps its length and path for it. A
  FILE* still open over one of its entries (a baked_open_range) is closed first. Still 8 packs at most.
- baked_path(map, file) is assets/baked/maps/<map>/<file> for a map's bake - what its .lmap carries
  and the game's own pack never does - and assets/baked/<file> for the rest.

The IR assembles for macOS and Windows (llvm-as). Compile-only: nothing mounted or run here.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:27:06 +03:00

66 lines
3.1 KiB
Text

# baked.ludic - what is deterministic made at build time (`ludic bake`) by the game's own code, and
# read at run time. Every baked file: a 32-byte header - "LBAK", the header's format, the bake's
# generator version, the payload's offset, a hash of its inputs, the payload's length - its key, and
# the payload, whose layout is the bake's own. The runtime checks the header, never the inputs:
# `ludic bake --check` holds a baked file to its inputs at build time.
export const BAKE_FORMAT: int = 1
const BAKE_HEAD: int = 32
export state BakeState {
said: []string = new []string # the keys a dev build has said it made at run time
}
# a map's bake: assets/baked/maps/<map>/<file>, which ships in that map's own pack (.lmap), never the
# game's; anything else: assets/baked/<file>, in the game's pack
export function baked_path(map: string, file: string) -> string {
if len(map) == 0 { return "assets/baked/" + file }
return "assets/baked/maps/" + map + "/" + file
}
# the payload of a baked file that is this bake at this version, or null (missing, not a baked file,
# another format, another key or version: the caller makes it at run time)
export function baked_open(path: string, key: string, version: int) -> []byte {
let b = Fs.read_bytes(path)
if b == null or len(b) < BAKE_HEAD { return null }
let off = bk_head_ok(b, len(b), key, version)
if off < 0 or long(off) + bk_u64(b, 24) > long(len(b)) { return null }
return view(b, off, int(bk_u64(b, 24))) # the payload, in place: no copy of a large bake
}
# the payload's offset when `b` (its first `have` bytes) is this bake's header and key, else -1
function bk_head_ok(b: []byte, have: int, key: string, version: int) -> int {
if have < BAKE_HEAD or b[0] != 76 or b[1] != 66 or b[2] != 65 or b[3] != 75 { return -1 } # "LBAK"
if bk_u32(b, 4) != BAKE_FORMAT or bk_u32(b, 8) != version { return -1 }
let off = bk_u32(b, 12)
if off < BAKE_HEAD + len(key) + 1 or have < BAKE_HEAD + len(key) + 1 { return -1 }
for i in 0 .. len(key) { if b[BAKE_HEAD + i] != key[i] { return -1 } }
if b[BAKE_HEAD + len(key)] != 0 { return -1 }
return off
}
# a dev build's line, once a key: the bake is missing or stale, so it is made at run time
export function bake_missing(bake_st: mut BakeState, key: string) -> void {
for i in 0 .. len(bake_st.said) { if bake_st.said[i] == key { return } }
push(bake_st.said, key)
print(`bake: {key} missing or stale - made at run time (ludic bake)`)
}
# a baked file written: its header, key and `n` bytes of payload; the directories made
export function bake_write(path: string, key: string, version: int, inputs_hash: long, payload: []byte, n: int) -> bool {
let off = BAKE_HEAD + ((len(key) + 1 + 7) / 8) * 8
let b = buffer(off + n)
b[0] = 76
b[1] = 66
b[2] = 65
b[3] = 75
bk_put32(b, 4, BAKE_FORMAT)
bk_put32(b, 8, version)
bk_put32(b, 12, off)
bk_put64(b, 16, inputs_hash)
bk_put64(b, 24, long(n))
for i in 0 .. len(key) { b[BAKE_HEAD + i] = key[i] }
for i in 0 .. n { b[off + i] = payload[i] }
let slash = bk_last_slash(path)
if slash > 0 { Fs.mkdir(path[0 .. slash]) }
return Fs.write_bytes(path, b, off + n)
}