@loonylabs/gamedev-server

Server-side game loop and session management for the loonylabs gamedev framework.

What's in here

Node.js game server infrastructure built on Socket.io. Handles the tick loop, player sessions, game state, and database persistence. Game-agnostic — no hardcoded game logic.

• Bootstrap — server setup, Socket.io wiring, connection handling
• Game loop — fixed-rate tick loop (20Hz), experience-aware loop
• Game state — GameSession class, player/entity state management
• Experience manager — register and switch between game experiences at runtime
• Manifest factory — auto-generates full server behavior from a GameManifest
• Manifest persistence — player + world state save/load via SQLite
• DB layer — generic createDb() factory (SQLite + Drizzle ORM)

Install

pnpm add @loonylabs/gamedev-server

Usage

Manifest-based (recommended)

import {
  createGameServer,
  ExperienceManager,
  SocketIOBroadcaster,
  createExperienceFromManifest,
  createManifestExperience,
  manifestPlayerState,
  manifestWorldState,
} from '@loonylabs/gamedev-server';
import { createDb } from '@loonylabs/gamedev-server';

// Create DB (include framework schema tables)
const db = createDb('./data/game.db', { manifestPlayerState, manifestWorldState }, CREATE_SQL);

// Register experiences — manifest only, no custom server code
const experienceManager = new ExperienceManager(db);

// Without persistence:
experienceManager.register(createExperienceFromManifest(manifest));

// With player + world persistence (SQLite):
experienceManager.register(createManifestExperience(manifest, db));

Key exports

| Export | Description | |--------|-------------| | createGameServer | Start Socket.io server | | ExperienceManager | Register + manage game experiences | | SocketIOBroadcaster | Broadcast messages to players | | createExperienceFromManifest | Build experience from GameManifest (no persistence) | | createManifestExperience | Build experience with SQLite player + world persistence | | buildPlayerState | Build initial player state from manifest (for protocol adapters) | | manifestPlayerState | Drizzle schema table for player persistence | | manifestWorldState | Drizzle schema table for world persistence | | createDb | Generic SQLite + Drizzle ORM factory | | createPersistenceHooks | Auto-save/load hooks for custom experiences |

Part of the loonylabs gamedev toolkit

| Package | Role | |---|---| | @loonylabs/gamedev-core | ECS, physics, dungeon gen | | @loonylabs/gamedev-client | Three.js renderer, cameras, input | | @loonylabs/gamedev-server | ← you are here | | @loonylabs/gamedev-protocol | Zod network schemas | | @loonylabs/create-game | Project scaffold CLI |

Get started: npx @loonylabs/create-game my-game ./my-game