dockyardrift

ARCHIVED — dockyardrift is staged, not dead. The Schizodio avatar collection (999 hand-crafted traits, deadlined end of June 2026) is the upstream dependency. Once those avatars exist, they’ll populate dockyardrift and other Hyperfy worlds as NPCs. Then SPICEX will use them as hidden collectibles. Then dockyardrift gets its final build. The vision never shifted — it just got sequenced correctly. We’ll be back.

Overview

dockyardrift is a live multiplayer 3D world running on lobby.ws. It’s the 3D web counterpart to SpiceX — a space for experimentation with real-time multiplayer, VRM avatars, and custom world logic.

Key features:

Custom third-person camera with smooth interpolation
VRM avatar loading with spring bone physics
Entity-component system for world objects
Real-time multiplayer synchronization
Hot-reload development workflow
AI-assisted development with Claude/Cursor/Opencode

Tech Stack

Lobby SDK — Hyperfy’s world building framework
JavaScript (SES) — App scripting environment
VRM — Avatar format
Three.js — Underlying 3D engine
WebSockets — Real-time multiplayer sync
msgpackr — Binary serialization

Architecture

Client-Server Model

// Client-side
if (world.isClient) {
  const action = app.create('action')
  action.onTrigger = () => {
    app.send("player:move", { data: position })
  }
}

// Server-side
if (world.isServer) {
  app.on("player:move", (data, networkId) => {
    app.position.fromArray(data)
    app.send("player:position", app.position.toArray())
  })
}

Entity Component System

World → Systems → Entities → Nodes. Each app is a self-contained entity with its own update loop, physics, and networking.

Configuration System

Apps configure themselves with declarative config arrays:

app.configure([
  {
    type: 'text',
    key: 'title',
    label: 'World Title',
    initial: 'dockyardrift'
  },
  {
    type: 'color',
    key: 'neonColor',
    label: 'Neon Accent',
    initial: '#00ffaa'
  }
])

Deployment

The gamedev deploy CLI command pushes changes live in seconds. The workflow:

Develop locally with gamedev dev (hot reload)
Build with npm run build
Deploy with gamedev deploy
Live at lobby.ws/worlds/dockyardrift

lobby.ws — Blog post about the platform
Cleetus Project — The VRM character that lives in dockyardrift
SpiceX — Godot counterpart, same universe