bao

bao-demo.mp4

---

Complete repository for bao game client, servers and tools.

Try the Live Demo

You can fiddle around this implementation by going to the Demo Site

Credentials: demo / demo123

Tip: Press Command+G (Mac) or Ctrl+G (Windows/linux) to view debug info

Getting Started

Install dependencies and start the dev stack (API, client, Colyseus, core):

pnpm install
cp .env.example .env   # set MYSQL_*, JWT_SECRET, etc.
pnpm dev:db            # MySQL via Docker
pnpm db:migrate
pnpm dev

World data (maps, NPCs, objects) is managed with the bao CLI from @bao/cli:

npx bao convert maps --maps 34   # legacy maps → client JSON + meta sidecars
npx bao seed apply               # generate SQL and load MySQL

See packages/cli/README.md for full CLI usage. Static assets live in packages/assets. API/database details: packages/api/README.md.