VOXPIX

// package.json: el motor, fijado a un commit
"voxpix": "github:andyeswong/voxpix#<commit>"

// vite.config: el alias, con ruta absoluta
resolve: { alias: { '@voxpix': fileURLToPath(
  new URL('./node_modules/voxpix/src', import.meta.url)) } }

// tsconfig: lo mismo en paths (con baseUrl)
"paths": { "@voxpix/*": ["node_modules/voxpix/src/*"] }

import { generateLayout } from '@voxpix/worldgen'
import { buildWorldState } from '@voxpix/world/build'
import { THEMES } from '@voxpix/samples/themes'
import { bakeWorld } from '@voxpix/world/bake'
import { TICK } from '@voxpix/world/state'
import { createCompositor } from '@voxpix/view/compositor'
import { walkFrames } from '@voxpix/anim/walk'

// Aquí, un tema de muestra; tu juego trae el suyo
// (un WorldLook: paleta, suelo, columnas...)
const { spec, look, ambient } = THEMES.medieval
const layout = generateLayout(spec, 7)  // semilla
const { world, state } =
  buildWorldState(layout, look)
const baked = bakeWorld(world, { topZ: 40 })
// GPU con WebGL2; si no, la CPU
const compositor = createCompositor(canvas)

// walk: los cuadros de andar de un modelo
// (Model.fromJSON de un .voxpix.json)
const walk = walkFrames(modelo)
// layout.spawn: los pies del jugador, en píxeles
// (el mundo cuenta y hacia el norte: se invierte)
const x = layout.spawn.x
const y = world.depth - 1 - layout.spawn.y
state.entities.add({
  model: walk[0], x, y, z: 1, facing: 0 })

// Pasos fijos de 1/60 s, a cualquier ritmo de
// pantalla (en 120 Hz, dos cuadros por paso)
let acc = 0, last = performance.now()
function loop(now) {
  acc += (now - last) / 1000; last = now
  while (acc >= TICK) { state.step(); acc -= TICK }
  // La vista: los pies proyectados, centrados
  const [fx, fy] = baked.cam.project(x + 0.5, y, 1)
  const vx = Math.floor(fx) - 192
  const vy = Math.floor(fy) - 108
  compositor.frame(state, baked, { vx, vy,
    vw: 384, vh: 216, time: now / 1000,
    lights: true, ambient })
  requestAnimationFrame(loop)
}
requestAnimationFrame(loop)
// Si el mundo cambia vóxeles (agua, destrucción),
// rehornea lo cambiado: rebakeChangedJobs + FrameBudget