# 모두의 마을 / Modoo Village

> A multiplayer browser village connecting visitors to other online worlds.

## Public live player count

- [Public API documentation](https://modoovillage.com/public-api.html): English and Korean integration instructions.
- [OpenAPI contract](https://modoovillage.com/openapi.json): Machine-readable API specification.
- [Current player count](https://modoovillage.com/api/rooms): GET JSON; read the top-level `total` integer. It is the current connected player-session count across ALL channels. `rooms[].count` is per-channel; do not use just the first channel, and do not add `total` to the room counts. Multiple tabs/connections can count separately. This is not a unique-person count.
- [Health](https://modoovillage.com/api/health): GET JSON `{ "ok": true }` means the endpoint is responding.

No login, API key, game entry, or WebSocket connection is required to read these two GET endpoints. Fetch server-to-server; arbitrary browser-origin CORS access is not promised. Responses use `Cache-Control: no-store`. Poll about once per minute or less frequently, and record your own successful fetch timestamp. The player count includes connected test clients and the owner's IP; only private analytics exclude a configured test IP. NPCs are not connections and are not counted.

On HTTP/network/JSON/schema failure, show unknown/unavailable, not zero. A valid `total: 0` means zero connected player sessions at sampling time. A consumer's `online` / `online_at` fields are their own schema, not fields returned by this API. Read-only collection of these two endpoints is permitted. This does not grant access to private administration or analytics.