# GemTavern Game Link API

This is the AI-agent entrypoint for building game mods that connect to GemTavern.

Recommended read order:
1. /docs/game-link-protocol-v1.md
2. /docs/game-link-mod-author-guide.md
3. /schemas/game-link-protocol-v1.schema.json
4. /examples/fake-character-card-upsert.json
5. /examples/fake-live-event.json
6. /reference/game-link.asyncapi.json
7. /openapi.json

Key rules:
- Game mods send character cards and live game moments to GemTavern over the local Game Link WebSocket.
- The mod owns scene detection and promptDirective content.
- GemTavern is the generic chat, model, TTS, storage, and pairing runtime.
- GemTavern should not infer game scenes from raw state fields.
- Use promptDirective.sceneContext plus autoEventGuide for automatic game events.
- Use promptDirective.directUserGuide plus sceneContext for user text and voice turns.

Canonical assets:
- Full single-file context: /llms-full.txt
- Machine-readable manifest: /ai-index.json
- JSON Schema: /schemas/game-link-protocol-v1.schema.json
- AsyncAPI: /reference/game-link.asyncapi.json