Začínáme

GameOut vytváří venkovní honby za pokladem, které děti hrají na telefonech: stezka stanovišť na mapě, na každém úkol, padouch, který jim píše, časomíra, ze které nápovědy ubírají čas, a na konci poklad. Hru postavíte tady, vytisknete kartičky, pošlete hráčům jeden odkaz – a z živé konzole je sledujete, zatímco hrají.

1. Přihlaste se. Žádné heslo si vymýšlet nemusíte: přihlaste se odkazem zaslaným na váš e-mail, nebo účtem Google či GitHub. Účet se vytvoří při prvním přihlášení. Přihlásit se
2. Otevřete ukázkovou hru. Každý nový účet začíná s jednou (Ukázka: Operace TRUHLA): celá honba za pokladem se šesti stanovišti, padouchem, tiskovinami a obrázky. Otevřete ji a podívejte se, jak je hra postavená, vyzkoušejte ji na telefonu přes hráčský odkaz, vytiskněte kartičky. Je vaše – změňte ji, zkopírujte, nebo smažte. Hry
3. Postavte si vlastní. Hra se píše na záložkách: základ a hráčský odkaz, časomíra a pravidla, příběh a texty padoucha, stanoviště v pořadí, v jakém se hrají, kvíz, obrázky, tvář padoucha. Postavte se s telefonem na každé místo a stiskněte „Uložit mou polohu“, tím nastavíte špendlík. Ukládejte, jak často chcete – rozpracovaná hra s problémy je v pořádku, jen se zatím nedá spustit. Nebo nechte hru napsat AI asistenta a vložte jeho JSON na záložce Import – celá definice je jeden dokument.
4. Vytiskněte a připravte. Tiskoviny vám dají checklist, co kam schovat, kartičky stanovišť s kódy míst (pro případ, že GPS selže), dopis padoucha, zrcadlový dopis, písmena na kolíčky, cedulky ke klíčům, tabulku Morse a tajnou kartičku pro červený filtr.
5. Pošlete odkaz. Zapněte hráčský odkaz a dejte ho hráčům – jako QR kód, zprávu, nebo vytištěný na dopise. Nikdo nepotřebuje účet: hráč napíše své jméno (ze soupisky, nebo libovolné, pokud jste odkaz otevřeli) a herní kód, pokud jste nějaký nastavili. Děti v jednom týmu sdílejí jednu časomíru a jeden postup.
6. Sledujte a řiďte. Živá konzole ukazuje časomíru, stanoviště, hráče a chat každého týmu. Můžete pozastavit čas, přidat minuty, označit stanoviště za splněné, když telefon vzdal, odpovědět na volání o pomoc jako padouch, přesouvat hráče mezi týmy.
7. Volitelně připojte skript nebo asistenta. Api klíč umožní vašim skriptům číst vaše hry a jejich živý stav – třeba výsledkovou tabuli na projektoru. AI asistent, který umí MCP, může stavět a měnit hry, které mu otevřete. Obojí je popsáno níže. Přístup přes API

Hraní je zdarma: bezplatný účet má jednu hru a hrstku hráčů, což je narozeninová oslava. Zaplacené období tyto limity zvýší na pevný počet dní – nic se neobnovuje samo. Ceník a limity

Hry v této aplikaci

Hra je jeden dokument o třech částech: nastavení (příběh, časomíra, vzhled), stanoviště v pořadí, v jakém se hrají, a kvíz. Všechno, co ukazuje stránka úprav, je pole tohoto dokumentu a celý se dá zkopírovat a vložit zpět jako JSON – tak hru čte a píše i AI asistent.

Stanoviště

Každé stanoviště má místo (špendlík a poloměr v metrech), způsob, jak ho najít, úkol, přijímané odpovědi, nápovědy, které stojí čas, a písmeno, které odhalí. Stanoviště se odemykají jedno po druhém: hráči vidí další, až když splnili předchozí.

• Jak ho najít - tři způsoby: špendlík na mapě se vzdáleností (ten obvyklý), fotka místa s „přihořívá / samá voda“ podle GPS a bez špendlíku (hádanka), nebo jen slova a vzdálenost.
• Příchod - úkol se objeví, jakmile je telefon v poloměru (40 m ve výchozím stavu – GPS v lese není přesná). Každé stanoviště má také kód místa vytištěný na kartičce, který hráči zadají, když GPS selže. Vypněte „úkoly se objeví až po příchodu“ a úkoly se ukážou hned.
• Odpovědi - jedna nebo více přijímaných odpovědí; na velikosti písmen a diakritice nezáleží, takže „Beruška“, „beruska“ a „BERUSKA“ jsou stejná odpověď. Špatná odpověď dostane posměšek od padoucha, správná vlastní hlášku stanoviště nebo náhodnou pochvalu.
• Nápovědy - až tři na stanoviště, v pořadí, každá stojí čas podle nastavení časomíry (2 and 3 minut ve výchozím stavu). Žolík „nápověda zdarma“ jednu zaplatí.
• Písmena - každé stanoviště může odhalit jedno písmeno; písmena všech stanovišť jsou vodítkem k finálnímu heslu. Písmeno stanoviště nechte prázdné, když je heslo kratší než stezka.
• Nástroj v telefonu - stanoviště může vyžadovat jeden z nástrojů zabudovaných v hráčské stránce: zrcadlo (kamera ukazuje svět zrcadlově, aby šel přečíst dopis psaný pozpátku), kompas (pro „20 kroků na sever“), přijímač Morse, který pípá a bliká slovo, které nastavíte, červený filtr přes kameru, který odhalí text skrytý na vytištěné tajné kartičce, a tlačítko poplachu pro překážkovou dráhu. Nástroje jsou tam vždy; pojmenování jednoho na stanovišti dá jeho tlačítko pod úkol.
• Jen pro vás - „co připravit na místě“ jde do checklistu, tiskoviny (zrcadlový dopis, kartička s pokyny, cedulka ke klíči, písmena na kolíčky) na stránku tisku. Hráči je nikdy nevidí.
• Id - krátký identifikátor (s1, s2, …), pod kterým se ukládá postup týmů. Přejmenování nebo odebrání stanoviště hrané hry ztratí postup na něm. Vypnuté stanoviště hráči přeskočí a zůstane uložené na později.

Nastavení

• Časomíra - časový limit (60 minut ve výchozím stavu), co stojí nápovědy, jak dlouho žolík zmrazení zastaví časomíru (5 minut) a od kolika zbývajících minut si hráči mohou vyhrát čas zpět: kostky proti padouchovi a kvízové otázky, každá za bonus a každá povolená jen několikrát. Když čas vyprší, hra pokračuje – přesčas se ukazuje červeně.
• Příběh - jméno a tvář padoucha, dopis, který si hráči přečtou před startem, pravidla, co padouch říká po špatné nebo správné odpovědi, když dochází čas a když vyprší, a finále: falešné načítací hlášky, nápis „převzato“, řeč, věta odhalení a dovětek.
• Finále - přijímaná hesla, nápověda, fotka místa s pokladem a volitelně, kde na fotce je – po odpočtu se tam nakreslí kroužek.
• Vzhled - čtyři barvy hráčských stránek a jazyk jejich tlačítek a popisků (EN, CS, DE); texty hry jsou vaše v jakémkoli jazyce, ve kterém je napíšete.
• Texty - prostý, nebo se značkami b, i, u, em, strong, br a small; vše ostatní se odstraní. Emoji jsou vítány.

Obrázky a tvář

Obrázky, které ukazuje stanoviště nebo finále, se nahrávají na záložce Obrázky – JPEG nebo PNG do 12 MB, při nahrání zmenšené na 1600 pixelů – a na stanovišti se vybírají z nabídky s náhledy. Tvář padoucha se pro vás nakreslí ve čtyřech náladách (obyčejná, mrknutí pro přihlašovací stránku, smutná pro závěrečnou hádanku, smích pro odhalení): „Překvap mě“ nakreslí každým kliknutím jiného padoucha – tvar hlavy, vlasy, oči, nos, pusu, vousy, klobouk – nebo si styl, barvy a části vyberete sami a semínko nakreslí stejného padoucha znovu. Anebo nahrajte jeden obrázek tváře a vystrojte ho kloboukem, brýlemi, vousy nebo maskou, které se přes něj nakreslí.

Rozpracované hry, problémy a historie

Hra se píše na několikrát, proto se ukládá i s problémy – stanoviště bez odpovědi, finále bez hesla – a vypíše je. Co hra s problémy nemůže, je být SPUŠTĚNA: tlačítko START hráčů odmítá, dokud nejsou opraveny.

Každé uložení, které něco změnilo, uchová předchozí verzi na stránce historie hry – posledních 20 změn, vámi, sdíleným editorem nebo AI asistentem, každá s popisem, co změnila. Obnovení vrátí název, jazyk, nastavení, stanoviště a kvíz; nikdy nesahá na přepínače, obrázky, hráče ani jejich postup.

Definice jako JSON

Záložka Import ukazuje současnou definici a přijímá novou. Je to jeden objekt se „settings“, „stations“ a „quiz“; chybějící část si nechá výchozí hodnoty, každá hodnota se ořízne na stejné meze, jaké vynucuje stránka úprav. Přesné schéma je to, co AI asistent dostane jako „capabilities“ – a ukázková hra je nejlepší příklad všech tří vyplněných částí.

{
  "settings": {
    "villain": "Rascal",
    "time_limit_sec": 3600,
    "hint_penalty_sec": [120, 180],
    "final": {"answers": ["piano"], "hint": "It plays music."},
    "intro": {"title": "Top secret", "letter": "Hello, agents! ...", "rules": ["You have 60 minutes."]}
  },
  "stations": [
    {
      "id": "s1", "title": "The mirror message", "icon": "🪞",
      "lat": 49.8989, "lng": 18.0044, "radius": 45, "nav": "map",
      "nav_text": "Go to the end of the street...",
      "task": "Read the letter with the <b>Mirror</b> tool.",
      "tool": "mirror", "answers": ["squirrel"], "hints": ["Tap Tools - Mirror."], "letter": "P"
    }
  ],
  "quiz": [{"q": "How many legs does a spider have?", "o": ["6", "8", "10"], "a": 1}]
}

Sdílení, kopírování a mazání

Hra se sdílí s jiným účtem přes jeho e-mailovou adresu, s jedním ze dvou oprávnění. Adresa, kterou zatím nikdo nemá, dostane sdílení ve chvíli, kdy se její majitel poprvé přihlásí.

Žádné oprávnění nedovoluje hru smazat, sdílet dál, obnovit její hráčský odkaz ani přepnout AI přepínač – to zůstává majiteli, stejně jako jeho velikostní limity: sdílený editor nemůže přidat stanoviště nad majitelův limit. Kopie je hra v účtu toho, kdo kopíroval, se stejnou definicí a obrázky, bez hráčů, bez postupu, s novým hráčským odkazem a vypnutým hraním – a počítá se do jeho limitů.

Smazání hry odstraní její hráče, jejich postup, chat, historii, sdílení a obrázky – okamžitě a navždy.

Hraní hry

Hráčský odkaz

Každá hra má jednu adresu – dlouhou, náhodnou a neuhodnutelnou –, která je pro hráče celým přihlášením. Je vypnutá, dokud ji nezapnete, a můžete jí dát datum konce. „Nový hráčský odkaz“ na stránce úprav okamžitě vytvoří jiný; starý přestane fungovat a všechny telefony se odhlásí.

Hráč otevře odkaz a napíše jméno. V režimu soupisky se dostanou dovnitř jen jména, která jste dali na soupisku (v živé konzoli); s otevřeným odkazem se může připojit kdokoli, kdo ho má, zadáním libovolného jména, až do vámi nastaveného limitu a limitu účtu. Herní kód – krátké slovo, které dětem řeknete – lze vyžadovat v obou režimech. U jmen nezáleží na velikosti písmen a hráč, který odkaz otevře znovu na stejném telefonu, zůstává přihlášený 7 dní.

Telefony potřebují HTTPS, polohu a kameru – stránka si o ně řekne, když je stanoviště potřebuje. Chrome a Safari na současném telefonu fungují; starému prohlížeči může chybět kompas nebo kamera, a na to jsou zálohou kódy míst a vytištěné kartičky.

Týmy

Každá hra začíná s jedním týmem pojmenovaným podle nastavení a každý hráč se do něj připojí, pokud je v živé konzoli nerozdělíte do týmů. Tým sdílí jednu časomíru, jeden postup, jeden chat a své žolíky: co vyřeší jedno dítě, platí pro všechny, a stránka každého telefonu to během pár sekund dožene (telefony se na stav ptají každých 5 sekund; hráč se počítá jako online 90 sekund po posledním ozvání).

Jak hra probíhá

1. Briefing: dopis padoucha, pravidla a tlačítko START, které spustí časomíru týmu.
2. Stanoviště: cesta k němu (mapa, vzdálenost, šipka kompasu nebo „přihořívá / samá voda“), po příchodu úkol, nástroj, pole pro odpověď a nápovědy.
3. Žolíci: nápověda zdarma a zmrazení, které na pár minut zastaví časomíru – každý jednou na tým.
4. Čas navíc: když času dochází, kostky proti padouchovi a kvízové otázky vrátí pár minut; když vyprší, hra pokračuje v přesčasu.
5. Chat: padouch píše hráčům (to jste vy, v konzoli), hráči odepisují a tlačítko „potřebujeme radu“ vám tým označí.
6. Závěrečná hádanka: zamíchaná písmena a heslo – pak falešné načítání, převzetí padouchem, řeč padoucha (zůstane, dokud hráči nestisknou Dál), k tomu padouchův smích – vymyšlený na místě, nebo nahraný –, dokud ho hráči na poslední obrazovce nezastaví, odpočet, fotka místa, statistika.

Živá konzole

Jeden tým v jednu chvíli, obnovovaný každých pár sekund: časomíra, na kterém stanovišti tým je a kolik nápověd vzal, kdo je přihlášený a online, chat a log toho, co se stalo. S oprávněním upravovat na to máte ruce:

• časomíra – spustit, pozastavit, pokračovat, přidat nebo ubrat minuty, ukončit, vynulovat;
• stanoviště – označit příchod nebo splnění, když telefon vzdal, znovu otevřít, vrátit nápovědy;
• žolíci – vrátit je nebo odebrat;
• chat – pište týmu nebo všem týmům jako padouch;
• týmy a hráči – přidat jména na soupisku, přesunout hráče, přejmenovat nebo smazat tým, vymazat postup týmu;
• a VYMAZAT – každý tým zpět na start, s hráči nebo bez nich, pro další skupinu.

Tiskoviny

Samostatná stránka určená pro tiskárnu: checklist (co kam schovat, sestavený ze stanovišť), dopis padoucha s odkazem a kódem, kartička každého stanoviště s kódem místa a pokyny, zrcadlový dopis vytištěný zrcadlově, písmena na kolíčky, cedulky ke klíčům, tabulka Morse a tajná kartička – modrý text pod červenými čmáranicemi, který červený filtr v telefonu (nebo kousek červené fólie) zviditelní. Tajnou kartičku tiskněte barevně; všechno zalaminujte.

API her

Vaše vlastní skripty mohou číst vaše hry a sledovat jejich průběh: výsledková tabule na projektoru v klubovně, bot, který fandí v chatu, domácí automatizace, která zazvoní, když je poklad nalezen. Vytvořte si api klíč na stránce Přístup API s rozsahem „API her“ a posílejte ho v hlavičce Authorization. Přístup přes API

Hra je dostupná, když jí majitel zapnul „Přístup API“ a majitel klíče ji vlastní nebo ji má nasdílenou. Všechno je JSON; podoba hry je stejná, jakou vidí AI asistent, takže skript i asistent čtoucí stejný účet čtou stejná pole.

curl https://gameout.xklid.net/api/v1/games/42/status \
    -H "Authorization: ApiKey <váš API klíč>"

Odpovědi

• 200 - JSON popsaný výše; 201 pro odeslanou zprávu.
• 401 - klíč chybí, je neznámý, vypnutý nebo mimo data platnosti.
• 403 - klíči chybí rozsah „API her“, volá z adresy, kterou jeho IP seznamy odmítají, nebo hra není dostupná: není vaše, není sdílená, nebo má vypnutý přístup API.
• 404 - žádná taková hra, nebo žádný takový tým.
• 422 - tělo není to, co endpoint přijímá – třeba prázdná zpráva – s kódem a větou.
• 429 / 402 - vyčerpaný limit – příliš rychle, nebo je spotřebovaný den či měsíc – s Retry-After a hlavičkami X-RateLimit. Odmítnuté volání nic nespotřebuje. Jak se limity počítají

Api čte a posílá zprávy; hry nestaví ani neřídí časomíru. Stavění je na webové aplikaci a AI asistentovi a časomíra patří vedoucímu hry v živé konzoli. Další endpointy budou mít stejnou podobu, až budou přidány.

AI přístup (MCP)

MCP je způsob, jakým AI asistent mluví s aplikací. Tato aplikace provozuje MCP server, takže asistent, který už používáte, vám může napsat celou honbu za pokladem – příběh, stanoviště, nápovědy, kvíz – rovnou do vašeho účtu a měnit ji, jak si povídáte, místo abyste věci kopírovali sem a tam.

Co asistent umí

• Vypsat hry, které jste mu otevřeli – vlastní i ty, které s vámi někdo sdílí –, a přečíst jednu celou.
• Vytvořit novou hru, změnit existující nebo ji zkopírovat.
• Sledovat probíhající hru: týmy, jejich časomíry, kde jsou, kdo je online.
• Číst tuto dokumentaci, vaše aktuální limity a vaši nedávnou aktivitu.

Co asistent nikdy nemůže

Nikdy nemůže smazat ani sdílet hru, přidat nebo odebrat hráče, sáhnout na časomíru nebo psát hráčům běžící hry, nahrávat obrázky, spravovat api klíče, měnit váš účet, vidět nebo provádět platby ani posílat e-maily. To nejsou nastavení, která musíte mít správně – není vůbec žádný způsob, jak to udělat, takže nic, co si asistent někde přečte, ho k tomu nepřemluví.

Vy rozhodujete, které hry vidí

Každá hra začíná pro AI zavřená. AI přístup zapínáte po jednotlivých hrách, na stránce úprav dané hry. Asistent může hru vrátit – smí AI přístup vypnout –, ale nikdy si ji nemůže vzít: zapnout AI přístup je vždy na vás, ve webové aplikaci. Jedinou výjimkou je hra, kterou vám asistent sám vytvořil: ta pro něj začíná otevřená, aby rozhovor mohl pokračovat, a s VYPNUTÝM hraním, aby rozepsaná hra nikdy nebyla za živým odkazem.

Hry, které s vámi sdílejí ostatní, se řídí stejným pravidlem, přičemž přepínač patří tomu, kdo hru vlastní. Asistent může sdílenou hru číst a sledovat, jakmile jí majitel zapnul AI přístup, a měnit ji jen tehdy, když vám sdílení dává oprávnění „upravovat“.

To samé platí pro klíč samotný. Klíč povoluje AI přístup, jen dokud je zapnutý jeho přepínač „AI přístup“, a nový klíč začíná bez něj, takže žádný váš klíč se nestal použitelným pro AI jen tím, že vznikl. Ten jeden přepínač je vše, co asistent potřebuje; samostatný přepínač „API her“ na stejném klíči pokrývá vaše vlastní skripty.

Vidíte, co udělal, a můžete se vrátit

Každá změna, kterou asistent udělá, je na hře označená – kdy se stala a zda asistent hru vytvořil – a verze před každou změnou je uložená na stránce historie hry, kde vidíte, co změnil, a jedním kliknutím to vrátíte. Každé jeho volání je ve vašem logu.

Hra, kterou napíše asistent, podléhá stejným pravidlům jako ta vaše: stejné meze každého pole, stejný seznam problémů, který brání spuštění, stejné limity stanovišť na hru a her na účet.

Limity

AI přístup má vlastní, přísnější limity požadavků, oddělené od api limitů vašich skriptů i od čehokoli, co dělají hráči – asistent, který se chová špatně, tak nemůže vyčerpat nic jiného. Vytváření a změny her jsou omezeny mnohem přísněji než čtení. Zobrazit limity

Připojení asistenta

Jsou dva způsoby a který použijete, záleží na AI aplikaci: některé vás přihlásí, jiné mají pole pro klíč. Oba otevírají totéž.

Přihlášením

Předejte AI aplikaci tuto adresu a nic dalšího. Pošle vás sem, abyste se přihlásili, ukáže vám, o co žádá, a vy to povolíte. Žádný klíč se nevytváří a nic se nikam nekopíruje:

https://gameout.xklid.net/api/mcp/

• Než ji povolíte, stránka ukáže, jak si aplikace říká, a adresu, na kterou vás pošle zpět. Název je jen to, co aplikace tvrdí; adresa je místo, kam se vaše povolení opravdu doručí, takže právě tu je třeba zkontrolovat.
• Každá aplikace, kterou jste povolili, je uvedena v části „Připojené aplikace“ na stránce Přístup přes API, se dnem připojení a časem posledního použití. „Odpojit“ ji ukončí okamžitě - další požadavek aplikace je odmítnut.
• Kdykoli je k vašemu účtu připojena aplikace, dostanete e-mail, takže připojení, které jste udělat nechtěli, nezůstane bez povšimnutí.
• Připojení skončí samo, když nebylo 30 dní použito, a nejpozději 365 dní poté, co jste je povolili. Pak vás aplikace požádá znovu.

Klíčem

AI aplikaci, která má pole pro klíč nebo hlavičku, předejte stejnou adresu a jeden ze svých klíčů se zapnutým „AI přístupem“:

POST https://gameout.xklid.net/api/mcp/
Authorization: Bearer <váš API klíč s AI přístupem>

Endpoint mluví JSON-RPC 2.0 přes HTTP – mluvení obstará MCP klient, vy jen vložíte adresu a klíč. Pak požádejte: „napiš mi honbu za pokladem pro osmileté v parku za naším domem, šest stanovišť, padouch pirát“ – a otevřete hru, kterou vytvořil, na stránce Hry.

S ID klienta a tajným klíčem klienta

Některé AI aplikace vás přihlásí, ale chtějí být nejdříve ručně nastaveny, s ID klienta a tajným klíčem klienta. Každý váš klíč má ID klienta, uvedené na stránce Přístup přes API v části „Použít tento klíč jako klienta OAuth“; tajným klíčem klienta je klíč sám.

• Adresy pro přesměrování, které AI aplikace uvádí, zapište do seznamu u klíče, jednu na řádek, přesně tak, jak je aplikace udává - nejvýše 10 na klíč. S prázdným seznamem klíč nikoho nepřihlásí.
• Pro každou AI aplikaci použijte jeden klíč. Každá pak má vlastní data platnosti, vlastní přepínač zap/vyp a vlastní IP seznamy a ukončení jedné se ostatních nedotkne.
• Aplikaci nastavenou s vaším klíčem můžete povolit jen vy - nikdo jiný se přes ni přihlásit nemůže.
• Vypnutí klíče, vypršení jeho platnosti nebo vypnutí jeho „AI přístupu“ okamžitě zastaví každou aplikaci přes něj připojenou. Nové vygenerování klíče tato připojení ukončí nadobro.

Pro technického čtenáře

Endpoint je MCP server přes transport Streamable HTTP v nejjednodušší podobě: každá zpráva je POST s tělem JSON-RPC 2.0 a odpovědí je prosté JSON tělo. Není tu žádný proud událostí k odběru, žádné id relace k uchování a nic, co by server posílal sám od sebe - notifikace je potvrzena 202 bez těla.

• Revize protokolu - server hovoří revizí 2026-07-28, která nemá handshake: každý požadavek uvádí svou revizi a schopnosti svého klienta v „_meta“ a zrcadlí revizi, metodu a název do hlaviček MCP-Protocol-Version, Mcp-Method a Mcp-Name, a „server/discover“ odpovídá to, co dříve handshake. Hlavičky, které neodpovídají tělu, jsou odmítnuty s 400. Klientům dřívějších revizí se slouží jako dosud: „initialize“ vyjedná jednu z 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. Revize, kterou server nehovoří, je odmítnuta se seznamem těch, kterými hovoří.
• Ověření - pověření v hlavičce Authorization a nic jiného – žádná relace neexistuje. Je to buď api klíč jako „Bearer <klíč>“ nebo „ApiKey <klíč>“, nebo OAuth přístupový token jako „Bearer <token>“. Klíč potřebuje zapnutý „AI přístup“; jeho data platnosti, přepínač zapnuto/vypnuto a IP seznamy platí přesně jako u API her. Pozor, cloudová AI služba volá z vlastních adres dodavatele, ne z vašich – seznam povolených adres u takového klíče musí obsahovat rozsahy, které dodavatel zveřejňuje, v notaci CIDR.
• Origin - požadavek bez hlavičky Origin je obyčejný klient agenta a projde. Požadavek s ní je prohlížeč, a pak musí být origin vlastní této aplikace nebo takový, který nasazení povoluje.
• Velikost požadavku - tělo JSON-RPC až do 1 MB – celá hra o třiceti stanovištích i s texty má hluboko pod sto kilobajtů.

Přihlášení (OAuth 2.1)

Klient, který nedostal nic než adresu endpointu, jej zavolá, dostane odpověď 401 a zbytek najde odtud: hlavička WWW-Authenticate té odpovědi uvádí metadata chráněného zdroje a ta uvádějí autorizační server - tuto samou aplikaci.

• Průběh - grant autorizačního kódu s PKCE, metoda S256, vyžadovaný od každého klienta. Požadavek bez code challenge je odmítnut; metoda „plain“ se nepřijímá. Odpověď na povolení nese „iss“ (RFC 9207).
• Klienti - tři druhy, rozlišené tvarem ID klienta. Adresa https je Client ID Metadata Document: načte se, bez následování přesměrování, a musí uvádět sama sebe a své adresy pro přesměrování. Takový klient je veřejný (metoda ověření „none“), nebo se podepisuje (private_key_jwt, s klíči v dokumentu nebo na své jwks_uri); sdílený tajný klíč se nepřijímá. Klient se může sám zaregistrovat na registračním endpointu (RFC 7591); ten, který o tajný klíč nežádá, je veřejný klient, ten, který se bude podepisovat, musí přinést své klíče. Registrace, kterou nikdo nepovolil, se po dni smaže. A každý API klíč s „AI přístupem“ je klient: jeho ID je uvedeno na stránce Přístup přes API, jeho tajným klíčem je klíč sám a jeho adresy pro přesměrování jsou tam zapsaný seznam.
• Ověření klienta - client_secret_basic, client_secret_post, private_key_jwt (RFC 7523, algoritmy RS256, RS384, RS512, ES256, ES384, ES512; assertion uvádí jako audience tento token endpoint nebo issuer, platí nejvýše 60 minut a funguje jen jednou), nebo none. Klient, který deklaroval, jak se prokazuje, je toho při každé výměně držen.
• Adresy pro přesměrování - porovnávají se znak po znaku. Přijímají se adresy https, adresy místní smyčky přes prosté http (localhost, 127.0.0.1, [::1] - libovolný port) a vlastní schéma aplikace ve tvaru obráceného doménového jména nebo jedno z: cursor, vscode, vscode-insiders. Nikdy fragment, nikdy vzor.
• Tokeny - neprůhledné a uložené pouze jako hash. Kód funguje jednou a 60 sekund, přístupový token 60 minut. Obnovovací token se vymění jednou a při každé výměně se nahradí; vyprší po 30 dnech bez výměny a připojení 365 dní poté, co bylo povoleno.
• Token použitý dvakrát - kód, který je vyměněn podruhé, nebo obnovovací token, který se vrátí více než 60 sekund po své výměně, ukončí celé připojení: drželi jej dva a nikdo nedokáže říci, který z nich neměl.
• Bez člověka - grant client credentials, pouze pro API klíč: ID klienta daného klíče a klíč jako tajný klíč, v hlavičce Authorization (Basic) nebo v těle. Odpoví přístupovým tokenem bez obnovovacího tokenu. Po celou dobu rozhoduje klíč - je-li vypnutý nebo mimo svá data platnosti, token při dalším volání přestane fungovat.
• Co token otevírá - MCP endpoint a nic jiného. API her bere jen api klíče a stránky webové aplikace neberou ani jedno.

Nástroje

Kromě nástrojů je pod schématem „gameout://“ pět zdrojů jen pro čtení: tato dokumentace, pevná pravidla definice (její JSON schéma, režimy navigace, nástroje telefonu) a vlastní limity, hry a aktivita účtu.

Pravidla, na která asistent narazí

• Hra bez AI přístupu pro něj neexistuje: není v seznamu, nedá se číst. Sdílená hra je dostupná, jakmile jí majitel zapnul AI přístup, a měnit ji lze jen s oprávněním „upravovat“.
• Definice, kterou pošle, se normalizuje stejnými pravidly jako na stránce úprav – hodnota mimo meze se ořízne, neznámá značka odstraní – a uloží se i s problémy, které každá odpověď vypíše. Hru s problémy hráči nemohou spustit.
• Platí limity účtu: nejvýše tolik her, tolik stanovišť na hru. Odpověď říká, jaký limit to je a že ho může zvýšit jen majitel účtu.
• Obrázky nelze posílat; stanoviště může pojmenovat ten, který nahrál vedoucí hry, a get_game názvy vypíše.
• Přejmenování nebo odebrání stanoviště hrané hry ztratí postup týmů na něm; odpověď update_game vyjmenuje stanoviště, která zmizela.

Chybějící nebo neplatné pověření odpoví 401 a pověření, které endpoint nesmí používat, 403 – obojí jako chyby JSON-RPC (kódy 4010 a 4030) s hlavičkou WWW-Authenticate. Nástroj, který běžel a odmítl – hra, na kterou nesmí sáhnout, dosažený limit, argumenty mimo jeho schéma – odpoví 200 s chybovým výsledkem, který model přečte a zareaguje. Vyčerpaný limit je 429 nebo 402, viz Jak se počítají limity.

Jak se limity počítají

Nic se tu neměří a žádný kredit nedochází. Existují dva druhy limitů: stropy toho, KOLIK účet má, a počítadla toho, JAK RYCHLE smějí jeho skripty a asistenti volat. Hraní – telefony dětí – se nepočítá do žádného z nich.

Velikostní limity

How many games the account may hold, and how many stations, players, teams and pictures one game may have. These are what a free account notices: a few games and a handful of players is a birthday party, a paid period is a school. They are caps on what EXISTS, which is why sharing, copying and replaying a game cannot get around them:

• hra se počítá v účtu, který ji VLASTNÍ, a její stanoviště, hráči, týmy a obrázky jsou omezeny limity jejího majitele – sdílený editor nemůže přidat deváté stanoviště do hry bezplatného účtu;
• kopie je nová hra v účtu toho, kdo kopíroval, a počítá se tam;
• vymazání hry a její opakování s další skupinou nic nestojí – limitem jsou hráči na soupisce, ne počet odehrání;
• když období skončí, hry zůstanou, jak jsou; co účet už nemůže, je přidávat nad bezplatné limity.

Samotná čísla najdete na stránce s cenami. Jeden účet na osobu. Férové užívání

Tři oddělené příděly

• Webová aplikace - kolik těžších akcí za den uděláte na stránkách této aplikace: vytvoření nebo kopie hry, nahrání obrázku, nakreslení nebo vystrojení tváře padoucha. Uložení hry, kterou už máte, nestojí nic, ať je den jakýkoli.
• Volání api - co vaše vlastní skripty čtou přes API her.
• AI volání - každé volání, které asistent udělá přes MCP endpoint, se dvěma přísnějšími počítadly uvnitř: jedno pro volání, která hru MĚNÍ, a jedno pro volání, která ji VYTVÁŘEJÍ nebo kopírují.

Jsou to oddělená počítadla, ne díly jednoho čísla. Asistent, který se vymkne kontrole, nespotřebuje příděl, na kterém běží vaše vlastní skripty - právě v tom oddělení je celý smysl AI počítadla.

Co spotřebuje jedno volání

Jak se počítá okno

Denní limit běží 24 hodin od prvního volání, které ho spustí, ne od půlnoci; měsíční strop – ten má bezplatný účet – 30 dní od prvního volání. Každé počítadlo je dotázáno PŘED prací a započteno AŽ PO ní, a jen když práce proběhla: odmítnuté volání, neúspěšné, 403 i 404 nespotřebují nic. Dashboard ukazuje každé počítadlo a okamžik, kdy se resetuje.

Příliš rychlému skriptu se odpoví 429, skriptu, který vyčerpal den nebo měsíc, 402 – obojí s Retry-After v sekundách a hlavičkami X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset na každé započtené odpovědi. Asistent dostane totéž jako chybu JSON-RPC (kódy 4290 a 4020) a v každé běžné odpovědi zbývající limit – takže může říct „dnes je místo ještě na dvě hry“ místo devíti odmítnutí.

Telefony jedné hry dohromady a každý telefon zvlášť jsou omezeny za minutu na čísla nastavená pro třídu dotazující se najednou – děti jich nikdy nedosáhnou, jen skript – a pokusy o přihlášení do jedné hry jsou omezeny za hodinu a adresu, protože herní kód je slovo, které píše dítě, a slovo, které by skript mohl uhodnout. Nic z toho vám nedochází.

Váš účet

Přihlášení

Tři způsoby, všechny bez vlastního hesla: magický odkaz poslaný na váš e-mail, účet Google nebo účet GitHub. Ten, který použijete první, účet vytvoří; na stránce profilu můžete později přidat další e-mailové adresy a propojit ostatní přihlášení se stejným účtem. Hra sdílená na kteroukoli z vašich adres přijde do tohoto jednoho účtu. Hráči se nikam nepřihlašují – hráčský odkaz je celé jejich přihlášení. Nastavení profilu

Přehled a log

Dashboard ukazuje, kolik z velikosti účtu využíváte, kolik z každého denního limitu je spotřebováno a kdy se resetuje, co hráči nedávno dělali – spuštěné hry, nalezené poklady, splněná stanoviště –, nejhranější hry a stav vašich api klíčů a přístupu. Než api klíč vyprší, dostanete e-mail. Přehled

Uživatelský log je úplný záznam za těmi čísly: každé volání asistenta nebo skriptu a události účtu. Události samotných hráčů – kdo co kdy vyřešil – jsou v živé konzoli každé hry. Záznamy logu se uchovávají po dobu uvedenou v právním upozornění a pak se mažou. Log uživatele

Přístup a platby

Každý účet je zdarma, s limity, které stačí rodině. Koupě období dní zvýší limity na jeho délku a nic jiného nemění; není tu předplatné ani nic ke zrušení. Období koupená během běžícího se připojí na jeho konec. Když období skončí, hry zůstanou; jen už nejde přidávat nad bezplatné limity. Ceník a limity

Kde hledat pomoc

Po přihlášení se kontaktní formulář dostane přímo k provozovateli. Otázky, jak je hra postavená, obvykle zodpoví tato stránka – a AI asistent připojený k vašemu účtu ji za vás umí prohledat. Kontaktujte nás

Smazání účtu

Smazání účtu odstraní hry i s obrázky, hráči, postupem, chaty a historií, poskytnutá i přijatá sdílení, api klíče – každý skript a asistent, který je používá, okamžitě přestane fungovat –, adresy, propojená přihlášení a zbývající zaplacené období, které se nevrací. Nelze to vzít zpět. Co se uchovává a proč, uvádí právní upozornění. Právní informace