world-store
A pure, Babylon-free, deterministic reference implementation of world-contract.
It is the systemic spine of the simulation: it holds the serializable
WorldState, resolves systemic causality (interactions, pickups, damage) in
itself with no external blessing, emits best-effort events, and answers
queries. A Babylon scene is later a view reconciled from this state — the
store never imports a 3D engine, so it is fully unit-testable and can host a
headless driver.
Queries return copies. getState(), getEntity() and query() hand back
a deep copy every call, so nothing a driver does to a result can reach the
sim. Read once and keep the result, not once per entity. The engine's own
systems (the view, which reconciles every frame) read store.liveState, which
is the live object: never write to it, and never hand it to a driver.
Demo
import { b3d, b3dSun, b3dSkybox, b3dGround, WorldStore, WorldView, sceneDelta } from 'tosijs-3d'
const store = new WorldStore() // a 'player' entity exists at the origin
store.spawn({ kind: 'npc', position: { x: -3, y: 0.9, z: 1 } })
const walker = store.spawn({ kind: 'npc', position: { x: 3, y: 0.9, z: -1 } })
store.spawn({ kind: 'item', position: { x: 0, y: 0.5, z: 3 } })
const scene = b3d(
{
sceneCreated(el, BABYLON) {
const cam = new BABYLON.ArcRotateCamera('cam', -Math.PI / 2, Math.PI / 3.2, 16, new BABYLON.Vector3(0, 0.5, 0), el.scene)
cam.attachControl(el.querySelector('canvas'), true)
el.setActiveCamera(cam)
new WorldView(el.scene, store) // capsules for characters, boxes for objects
let t = 0
el.scene.onBeforeRenderObservable.add(() => {
t += sceneDelta(el.scene)
store.moveEntity(walker, { x: Math.cos(t) * 3, y: 0.9, z: Math.sin(t) * 3 })
})
},
},
b3dSun(),
b3dSkybox({ timeOfDay: 10 }),
b3dGround({ width: 24, height: 24, texture: 'checker', textureTiles: 12 }),
)
preview.append(scene)
tosi-b3d { width: 100%; height: 100%; }
The store holds state; a world-view reconciles one mesh per entity from it every
frame — data flows one way, store → meshes. Here we spawn a few entities and move one in the
STORE; its cube follows. The render layer can never desync the sim.
Two method groups make the boundary legible in code:
WorldApimethods — what an external driver (e.g. a narrative engine) may call.- simulation methods — what the engine's own gameplay systems (player input, an interaction system, combat) call. A driver must NOT call these; they represent the player and world acting.
Determinism: ids come from a counter and time advances only via tick() — no
Date.now/Math.random — so the same inputs always produce the same trace.
Topology: places, portals and distance words
The store also implements the coordinate-free MinSimApi (see
world-contract). Coordinates never cross to the driver: it sees
topology and a qualitative distance ladder, never x/y/z. The store keeps real
geometry on its own side and turns it into those qualities with three pure
functions, exported for a driver's own sim to share:
proximityRung(distance, extent): a real distance in, an adjective out. The bands scale with the place'sextent: two metres iscontactin an intimate closet andsame-spotin a vast plain.routePortals(portals, from, to): the cheapest portal path between two places, so "how far to a place" is a graph fact (can the errand be done), not vector maths. Locked portals are skipped: a locked door is not a route until it opens.containmentPath(places, id): the root-to-here breadcrumb up theparentchain, for theSchematicView's "where am I".
import { proximityRung, routePortals } from 'tosijs-3d'
proximityRung(1.8, 'small') // 'reach'
proximityRung(1.8, 'vast') // 'same-spot'
routePortals(portals, 'study', 'garden') // { portals: ['door-1', 'gate-2'], cost: 45 } or null