idle-xboct/README.md

Idle-XBOCT

Idle-игра для Twitch-чата: аватары зрителей живут на экране стрима, команды чата управляют ими. План и все решения — в docs/PLAN.md.

Запуск (M1 — вертикальный срез)

pnpm install
pnpm dev

• сервер: http://localhost:3000 — WS на /ws, здоровье на /healthz
• overlay (browser source для OBS): http://localhost:5173
• web-мир: http://localhost:5174 — топ зрителей и лента событий

Сборка клиентов (pnpm build) — сервер начнёт раздавать их сам: /overlay/ и /web/ на порту 3000 (это режим для OBS, без vite dev-сервера). Там же — дашборд стримера: http://localhost:3000/dashboard/

Живой чат и спотлайт

Заполни packages/server/.env по чек-листу docs/twitch-setup.md — бот подключится к чату автоматически при старте (пример в .env.example).

Для спотлайта создай в твитч-панели награду за очки канала с названием «Показать меня» (меняется через SPOTLIGHT_REWARD) — зритель выкупает её, и камера едет к его аватару на минуту.

Скопируй .env.example в .env и включи FAKE_VIEWERS=5 — фейковые зрители начнут писать !рубить/!стоп. С DEV_HTTP=1 можно дёргать вручную:

curl -X POST http://localhost:3000/dev/command -H "content-type: application/json" \
  -d '{"name":"Тестер","text":"!рубить"}'

Живой чат: заполни TWITCH_* по чек-листу docs/twitch-setup.md — бот подхватит их при старте автоматически.

Дымовой тест (без twitch): сервер с IDLE_NO_TWITCH=1 DEV_HTTP=1 SQLITE_PATH=:memory:, затем pnpm --filter @idle/server smoke m5.