# Loki

> Hosting and multiplayer for finished browser games. Host authority is the default. Server authority is opt-in.

Loki hosts a scanned, sandboxed browser build and runs rooms on the same playable URL. Creators do not upload a backend.

## Safety
Installing Loki is not a finished game. Each title still requires fine-tuning after installation. Play the game, adjust the integration, and ship again. You may need to test back and forth before the features work properly for that game.

## Packages
- @lokiplay/sdk@0.5.8 — JavaScript client
- lokiplay@0.5.8 — CLI: login, connect, validate, ship
- @lokiplay/ui-web@0.5.8 — optional overlay (no create/join)
- @lokiplay/mcp@0.5.8 — agent tools, not for the game bundle

## Start
- Docs: https://docs.lokiplay.cc/
- Quickstart: https://docs.lokiplay.cc/quickstart
- Agents: https://docs.lokiplay.cc/agents
- Safety: https://docs.lokiplay.cc/safety
- MCP: https://docs.lokiplay.cc/mcp
- App: https://app.lokiplay.cc/

## Rules
- Use @lokiplay/sdk. Do not import Nakama or Socket.IO.
- createHostedLokiClient({ projectId }) at boot on hosted play pages.
- createRoom() and joinRoom({ inviteCode }). Loki issues 6-digit codes.
- Public rooms: listPublicRooms() and joinPublic({ roomId }). create() stays invite-only unless visibility is "public". Loki does not add a public lobby screen; the game must build it. Do not make every room public.
- createSynchronizedRoom() for turns/events; createRealtimeRoom() for continuous host simulation. Not both in one mode.
- Calibrate realtime rooms. Do not copy snapshotHz into game.json tickRate.
- Host authority is casual/unranked, not anti-cheat. Server authority runs a pinned step module and does not elect a player host.
- The play link serves the last activated release. Local edits, including game.json and authority, show up only after lokiplay ship.
- Production multiplayer only from a Loki-hosted build.
- Login: LOKI_API_URL=https://api.lokiplay.cc npx lokiplay@0.5.8 login
- No inline scripts, remote fonts, or forms.
- Loki hosts finished web JavaScript games only. Support for Unity, Godot, iOS, and Android are coming soon. Do not install Loki into a native or engine project.

## Full docs
https://docs.lokiplay.cc/llms-full.txt