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/assets:

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

See packages/assets/README.md for full CLI usage, seed options, and the end-to-end asset workflow. API/database details: packages/api/README.md.