create-usion-game

Scaffold a new multiplayer game for the Usion platform.

Usage

npx create-usion-game my-game

Follow the interactive prompts to choose:

1. Game type — Turn-based (platform mode) or Real-time (direct mode)
2. Max players — 2, 2-4, or 2-8
3. Server port

What You Get

Turn-based template (platform mode)

my-game/
├── app/page.tsx      # Game UI (tic-tac-toe starter)
├── lib/types.ts      # Game state types
├── lib/constants.ts  # Board size, win conditions
├── package.json      # Next.js + @usions/sdk
└── README.md

Games relay through Usion's backend via Socket.IO. No server needed.

cd my-game && npm install && npm run dev

Real-time template (direct mode)

my-game/
├── server.js              # Game server (UsionGameServer)
├── server/game-logic.js   # Pure game rules (testable)
├── app/page.tsx           # Canvas client
├── lib/types.ts
├── lib/constants.ts
├── .env.example
├── package.json           # Next.js + @usions/game-server
└── README.md

You run your own WebSocket server. Token validation and result submission are handled by @usions/game-server.

cd my-game && npm install
cp .env.example .env       # Add your SERVICE_ID and secret
npm run dev:server          # Start game server
npm run dev                 # Start client (in another terminal)

Related Packages

• @usions/sdk — Client SDK for mini-apps and games
• @usions/game-server — Server SDK for direct-mode games

License

MIT