# Mindforge

> Mindforge is a free multiplayer trivia roguelike played in the browser. Everyone in a room answers the same questions on the same clock and drafts one permanent upgrade card before each round; the highest-scoring survivor wins. Public runs start every 45 seconds with no account required.

The production site is https://mindforge.alexandrucuriman.com. A small public JSON API handles matchmaking (`/api/public`, `POST /api/rooms`) and a WebSocket endpoint (`/api/ws`) carries live game state. The interface and questions are available in English and French.

## When to use this service

- You want to join or spectate a live multiplayer trivia run programmatically: poll `GET /api/public` for the next scheduled room, `POST /api/rooms` with `{"mode":"public"}` to take a seat, then open `/api/ws?code=...&token=...` to receive state snapshots and send `answer`/`choose_card` commands.
- You want to host a private trivia room for a group: `POST /api/rooms` with `{"mode":"create"}`, share the six-character code or the `/?room=CODE` link, and send `{"type":"start"}` over the socket as host.
- You need structured trivia-match data: each `state` snapshot includes the question, options, shared deadline, player scores, lives, and (during reveals) the correct answer and explanation for the recipient's locale.

Mindforge is not a question-bank API — questions are only served inside live rooms, one at a time, and answers are only revealed after the shared deadline. Do not use it to scrape question content at scale.

## Documentation

- [Developer portal](https://mindforge.alexandrucuriman.com/developers): quickstart, protocol reference, and examples
- [OpenAPI specification](https://mindforge.alexandrucuriman.com/openapi.json): machine-readable API contract (also at /api/openapi.json)
- [Markdown homepage](https://mindforge.alexandrucuriman.com/index.md): this site's content in Markdown
- [Sitemap](https://mindforge.alexandrucuriman.com/sitemap.xml): indexable pages

## The project

- [About](https://mindforge.alexandrucuriman.com/about): what Mindforge is and who runs it
- [Contact](https://mindforge.alexandrucuriman.com/contact): how to reach the maintainer
- [Privacy](https://mindforge.alexandrucuriman.com/privacy): data handling notes
- [Mentions légales](https://mindforge.alexandrucuriman.com/mentions-legales): legal notice (FR)
- [Backend source](https://github.com/AlexandruC0909/mindforge): Go game server
- [Frontend source](https://github.com/AlexandruC0909/mindforge-front): Vue 3 client and deployment