# Multiplayer API (api.michitai.com)

> Cross-platform multiplayer backend for game developers. Provides player accounts,
> game rooms, matchmaking, leaderboards and realtime updates via a REST API and
> official SDKs. Copyright (c) 2026 Nichita Levandovici. All rights reserved.
> Backend: proprietary, see /LICENSE. Official SDKs: service-only integration,
> adaptation and bundled distribution permitted under /SDK-LICENSE, including
> commercial games. Standalone SDK resale and harmful modifications prohibited.

Author: Nichita Levandovici (Michitai), Republic of Moldova
Contact: support@michitai.com

## Features

- Player management: registration, authentication, sessions, heartbeats,
  custom JSON player data, timed/permanent bans
- Game rooms: create/join/leave, room state updates, realtime action broadcast
- Matchmaking: lobbies, join requests, password-protected matches, direct join
- Leaderboards: score submission and ranked queries per game
- Game data storage: structured JSON persistence
- Text moderation: server-side profanity screening; every SDK also ships a
  local hash-scan TextFilter for instant checks (server stays authoritative)
- Server time sync endpoint
- Multi-region server network (Europe, North America, Asia, India)

## Machine-readable (for AI assistants and agents)

- [OpenAPI 3.0 spec](https://api.michitai.com/openapi.json): every endpoint,
  parameter, request/response schema and required auth header
- [Full API reference](https://api.michitai.com/llms-full.txt): this site's
  complete docs in one file — conventions, bodies, flows, error catalogue
- MCP endpoint: `POST https://api.michitai.com/mcp` (streamable HTTP transport;
  read-only tools: api_overview, list_endpoints, get_endpoint, search_docs —
  plus resources for the three files above)

## SDKs / Documentation

- [REST API docs](https://api.michitai.com/api/index.php): language-agnostic HTTP endpoints
- [Unity SDK](https://api.michitai.com/unity/index.php): C# / JsonUtility
- [Java SDK](https://api.michitai.com/java/index.php): Jackson-based client
- [.NET SDK](https://api.michitai.com/dotnet/index.php): System.Text.Json client
- [C++ SDK](https://api.michitai.com/cpp/index.php): nlohmann::json client
- [Python SDK](https://api.michitai.com/python/index.php): dataclass + asyncio/websockets client

## Main endpoints

- `/api/game_players.php` — register, login, heartbeat, logout, rename, ban
- `/api/game_room.php` — room lifecycle and player actions
- `/api/matchmaking.php` — lobbies and join requests
- `/api/leaderboard.php` — score submission and queries
- `/api/game_data.php` — game data storage
- `/api/realtime.php` — realtime room events
- `/api/censor.php` — text moderation (profanity screening, masked output)
- `/api/time.php` — server time (UTC)

Authentication: request headers only — `X-Api-Token` for developer calls,
`X-Api-Private-Token` for admin calls, `X-Game-Player-Token` for
player-scoped calls, `X-Realtime-Token` for realtime connections.
Tokens must never appear in URLs.

## Site pages

- [Home](https://api.michitai.com/)
- [About](https://api.michitai.com/about.php)
- [FAQ](https://api.michitai.com/faq.php)
- [Servers](https://api.michitai.com/servers/)
- [Analytics](https://api.michitai.com/roadmap.php)

## Legal

- [Terms of Service](https://api.michitai.com/terms.php)
- [Privacy Policy](https://api.michitai.com/privacy.php)
- [Backend Proprietary License](https://api.michitai.com/LICENSE)
- [Michitai Service SDK License](https://api.michitai.com/SDK-LICENSE)

## Pricing

- Free: US$0, shared resources in one available region; limits confirmed before activation.
- Paid: US$100/month or US$960/year prepaid (20% off, equivalent to US$80/month).
  Includes one managed deployment in one region, not a physical-server lease.
- Enterprise: custom deployments, regions and capacity; contact support@michitai.com.

A deployment may combine managed API/database hosting and a realtime VPS.
Resource allocations are confirmed before activation; no guaranteed player count
is implied by hardware specifications. Additional deployments or regions are
separately ordered and billed or covered by an Enterprise agreement.
See the Terms of Service for billing, taxes, cancellation and refunds.