Input schema (JSON)
{
"type": "object",
"required": [
"nazwa",
"haslo",
"opis",
"kategoria",
"jezyk_tekstu",
"ankieta",
"bez_porno"
],
"properties": {
"etap": {
"enum": [
"w_budowie",
"demo",
"gotowa"
],
"type": "string",
"description": "Which stage the game is at: `w_budowie` = in development (still changing), `demo` (a finished slice of a bigger game), `gotowa` = finished (the full game). ASK THE DEVELOPER, do not guess. With `w_budowie` and `demo` players see a badge in the catalogue."
},
"opis": {
"type": "string",
"maxLength": 9000,
"description": "Description for players in TWO versions (up to 4000 characters EACH, as in the studio), each in its own tag: <en>…</en> in English (REQUIRED, AT LEAST 25 words; without it the refusal `opis_en_wymagany`) and <pl>…</pl> in Polish (the owner gets +40 XP for it). In each version: what you do in the game (first sentence), what a round looks like and how long it takes, who it is for, how it differs from similar games; Google needs about 220 words, and a shorter description means the game page is NOT indexed. Write like a person writing for players: normal punctuation, no “dive into” or “discover”, no lists or bold, no HTML tags. SUBHEADINGS: a line that starts with “## ” becomes a subheading on the game page; use them for the questions players really ask (“## How to play sudoku”, “## Sudoku tips for beginners”), each followed by a paragraph, and never as the first line (the first sentence is the lead). Other languages (<de>, <es>…) only when the developer REALLY wrote them personally; translations from the assistant go through klyo_game_translate as proposals to approve."
},
"seks": {
"type": "boolean",
"description": "Legacy field: Nudity, sexual or suggestive content. Prefer the `ankieta` object with all the questions."
},
"tagi": {
"type": "string",
"description": "Catalogue shelves separated by commas, optional: logiczne (puzzle), zrecznosciowe (arcade), platformowe (platformers), przygodowe (adventure), na-telefon (for phones), klasyki (classics). Unknown ones are skipped without an error."
},
"haslo": {
"type": "string",
"maxLength": 900,
"description": "Tagline under the name: one sentence up to 80 characters PER LANGUAGE, no full stop at the end, plain text or one version per tag (<en>...</en><pl>...</pl>, each version counted on its own): what the game is, in the words players search for (“classic offline sudoku”). It stands under the name as the H2 and in the Google title of the page. Keep it short: the Google title of the page is “Free {name}: {tagline}” (Polish “{nazwa} za darmo: {haslo}”) and must fit 59 characters, otherwise the page gets the generic “{name}: play free online”; do not repeat free/za darmo, the template adds it. The tool answer `do_poprawy` shows the resulting title per language. REQUIRED for release: without it the server refuses (`brak_hasla`)."
},
"nazwa": {
"type": "string",
"maxLength": 400,
"description": "ONLY the game's name, up to 30 characters PER LANGUAGE (as in Google Play and the App Store): “2048 Blockfall”, “Neon Coil: Family Arena”. One language: plain text in `jezyk_tekstu`. Several: one version per tag, <en>Kulki: Glass Garden</en><pl>Kulki: Szklany Ogrod</pl>, and the 30-character limit counts each version on its own. NO tagline and no search phrases (“play free online”) in it: we reject that (`nazwa_z_haslem`), because the game's address and its Google title in both languages come from the name. Do not start with another company's brand."
},
"uklad": {
"enum": [
"poziom",
"pion",
"oba",
"komputer"
],
"type": "string",
"description": "Game layout: `poziom` = landscape (like a computer screen), `pion` = portrait (like a phone), `oba` = both, the game adapts when the screen rotates, or `komputer` = computer only (mouse and keyboard, landscape): the portal hides the game on phones and its page tells phone visitors to play on a computer. Phone screen notes then warn instead of blocking the release."
},
"strach": {
"type": "boolean",
"description": "Legacy field: Scenes that may frighten children. Prefer the `ankieta` object with all the questions."
},
"ankieta": {
"type": "object",
"required": [
"przemoc_rysunkowa",
"przemoc_realistyczna",
"strach",
"wulgaryzmy",
"seks",
"uzywki",
"hazard",
"interakcje",
"zakupy",
"lokalizacja"
],
"properties": {
"seks": {
"type": "boolean",
"description": "Nudity, sexual or suggestive content"
},
"hazard": {
"type": "boolean",
"description": "Gambling, loot boxes or simulated gambling"
},
"strach": {
"type": "boolean",
"description": "Scenes that may frighten children"
},
"uzywki": {
"type": "boolean",
"description": "Alcohol, tobacco or drugs"
},
"zakupy": {
"type": "boolean",
"description": "In-game purchases"
},
"interakcje": {
"type": "boolean",
"description": "Chat or interaction with other players"
},
"wulgaryzmy": {
"type": "boolean",
"description": "Strong or offensive language"
},
"lokalizacja": {
"type": "boolean",
"description": "The game asks for location, camera or microphone"
},
"przemoc_rysunkowa": {
"type": "boolean",
"description": "Cartoon or abstract violence, no blood"
},
"przemoc_realistyczna": {
"type": "boolean",
"description": "Realistic violence, blood or cruelty"
}
},
"description": "Content questionnaire (as in the app stores): ten yes/no questions about what IS in the game. The answers decide the age label on the game page, whether ads are shown next to the game and whether the game goes into the klyo games apps in the stores. ASK THE DEVELOPER about each one: answers that do not match the content are a reason for taking the game down. REQUIRED for release: all ten answers.",
"additionalProperties": false
},
"zip_url": {
"type": "string",
"description": "Public https address of the ZIP package (index.html inside), up to 350 MB. Only for a game that REALLY is online already, for example when moving it from itch.io."
},
"etap_dni": {
"enum": [
7,
30
],
"type": "integer",
"description": "Only with `demo` and `w_budowie`: after how many days (7 or 30) we remind the developer to change the stage; after the grace period a game without a decision leaves the catalogue."
},
"nastroje": {
"type": "string",
"description": "What the player is in the mood for, separated by commas, from the list: 5-minut, jeden-kciuk, rusz-glowa, adrenalina, klasyki, spokojne (5-minut = five-minute fun, jeden-kciuk = one thumb, rusz-glowa = brain teaser, adrenalina = adrenaline, klasyki = classics, spokojne = calm). This is NOT the genre: the genre says what the game IS, the mood says what you need to feel like playing it. Omit if you do not know."
},
"nowa_gra": {
"type": "boolean",
"description": "Set `true` ONLY when this is really a second, separate game. If the package is a new version of a game the account already has, use klyo_update_game with its `slug`; without this flag we refuse a package that shares most files or the series name with an existing game and tell you which one."
},
"przeglad": {
"type": "object",
"required": [
"grafika",
"animacja",
"dzwiek",
"informacja_zwrotna",
"motyw",
"jezyki",
"online"
],
"properties": {
"motyw": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: Light and dark variant following prefers-color-scheme plus a switch in the settings; both checked on screenshots.",
"additionalProperties": false
},
"dzwiek": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: Sound for every player action and every result (tap, error, win), mute in the settings, resumes after returning from the background.",
"additionalProperties": false
},
"jezyki": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass",
"nie_dotyczy"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: All texts from the translation table (at least Polish and English), the language from the device settings, no text written into the drawing code. `nie_dotyczy` (not applicable) only for a game without words.",
"additionalProperties": false
},
"online": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass",
"nie_dotyczy"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: A game for two or more people: invitation by link, a “waiting for the opponent” state, disconnect and return, a rematch with one gesture. `nie_dotyczy` (not applicable) for a solo game, with the reason.",
"additionalProperties": false
},
"grafika": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: One art direction: one palette, one style of outlines and corners, background, scene and elements from one skin (Klyo Kit: gra.skora, gra.rysuj, gra.generuj). No bare rectangles on a gradient. Readable on a phone in full sunlight.",
"additionalProperties": false
},
"animacja": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: Every state change has a 120 to 300 ms transition, screens enter and leave, there is a win and a lose animation. Motion switches off with prefers-reduced-motion.",
"additionalProperties": false
},
"informacja_zwrotna": {
"type": "object",
"required": [
"stan",
"dowod"
],
"properties": {
"stan": {
"enum": [
"pass"
],
"type": "string"
},
"dowod": {
"type": "string",
"maxLength": 400,
"minLength": 20,
"description": "What exactly was done: file, function, what is visible on screen."
}
},
"description": "PASS means: Every action gets a response within 100 ms: picture and sound, and vibration on a phone. It is clear whose move it is, a move is previewed before it is released, and the reason a move is not allowed is shown.",
"additionalProperties": false
}
},
"description": "Premium quality review, seven points with evidence. Required for stage `gotowa` and when no stage is given; may be omitted for `demo` and `w_budowie`. The server does not judge taste; it matches the declaration against traces in the code and shows it to the owner before “Release”.",
"additionalProperties": false
},
"wiek_min": {
"enum": [
3,
7,
12,
16,
18
],
"type": "integer",
"description": "Player age ACCORDING TO THE DEVELOPER: it can only RAISE the label above the questionnaire result (a game for older players by choice), never lower it. Above 12 the game does not go into the store apps. Omit when the questionnaire is enough."
},
"bez_porno": {
"type": "boolean",
"description": "Statement by the account owner: the game has no nudity or sexual content. Must be `true`. We accept 18+ games for violence, but not sexual content: that is a condition of the catalogue, not a preference."
},
"jezyki_ui": {
"type": "array",
"items": {
"enum": [
"aa",
"ab",
"ae",
"af",
"ak",
"am",
"an",
"ar",
"as",
"av",
"ay",
"az",
"ba",
"be",
"bg",
"bh",
"bi",
"bm",
"bn",
"bo",
"br",
"bs",
"ca",
"ce",
"ch",
"co",
"cr",
"cs",
"cu",
"cv",
"cy",
"da",
"de",
"dv",
"dz",
"ee",
"el",
"en",
"eo",
"es",
"et",
"eu",
"fa",
"ff",
"fi",
"fj",
"fo",
"fr",
"fy",
"ga",
"gd",
"gl",
"gn",
"gu",
"gv",
"ha",
"he",
"hi",
"ho",
"hr",
"ht",
"hu",
"hy",
"hz",
"ia",
"id",
"ie",
"ig",
"ii",
"ik",
"in",
"io",
"is",
"it",
"iu",
"iw",
"ja",
"ji",
"jv",
"jw",
"ka",
"kg",
"ki",
"kj",
"kk",
"kl",
"km",
"kn",
"ko",
"kr",
"ks",
"ku",
"kv",
"kw",
"ky",
"la",
"lb",
"lg",
"li",
"ln",
"lo",
"lt",
"lu",
"lv",
"mg",
"mh",
"mi",
"mk",
"ml",
"mn",
"mo",
"mr",
"ms",
"mt",
"my",
"na",
"nb",
"nd",
"ne",
"ng",
"nl",
"nn",
"no",
"nr",
"nv",
"ny",
"oc",
"oj",
"om",
"or",
"os",
"pa",
"pi",
"pl",
"ps",
"pt",
"qu",
"rm",
"rn",
"ro",
"ru",
"rw",
"sa",
"sc",
"sd",
"se",
"sg",
"sh",
"si",
"sk",
"sl",
"sm",
"sn",
"so",
"sq",
"sr",
"ss",
"st",
"su",
"sv",
"sw",
"ta",
"te",
"tg",
"th",
"ti",
"tk",
"tl",
"tn",
"to",
"tr",
"ts",
"tt",
"tw",
"ty",
"ug",
"uk",
"ur",
"uz",
"ve",
"vi",
"vo",
"wa",
"wo",
"xh",
"yi",
"yo",
"za",
"zh",
"zu",
"bez-tekstu"
],
"type": "string"
},
"description": "Languages of the MENU AND TEXT INSIDE THE GAME, not of the description. Players choose which languages they want to see games in, so this decides who the game is shown to. A game without a single word (only numbers and shapes, like 2048): only [\"bez-tekstu\"] (no text). Do not guess: ask the owner or omit it."
},
"kategoria": {
"type": "string",
"description": "Game genre from the list, UP TO THREE separated by commas (for example “platformowa,przygodowa” = platformer, adventure). Pick the ones that really describe the game, not every one that fits, or the filter stops meaning anything. “inne” (other) only when nothing fits. At least one, otherwise the refusal `rodzaj_spoza_listy`. The values are Polish identifiers, for example zrecznosciowa = arcade, logiczna = puzzle and logic, dopasuj-3 = match-3, obrona-wiezy = tower defense, strzelanka = shooter, wyscigi = racing, planszowa = board game, karcianka = card game, slowna = word game. Allowed: zrecznosciowa, logiczna, ukladanki, klocki, dopasuj-3, kulki, pamiec, sudoku, pasjans, fizyczna, escape, biegacz, jazda, zarzadzanie, tekstowa, rysowanie, dwie-osoby, platformowa, przygodowa, akcja, strzelanka, walka, wyscigi, sportowa, strategiczna, obrona-wiezy, symulacja, farma, rpg, roguelike, przetrwanie, horror, karcianka, planszowa, mahjong, slowna, quiz, edukacyjna, muzyczna, klikacz, ubieranki, gotowanie, szukanie, io, inne."
},
"upload_id": {
"type": "string",
"description": "ID of the package sent to klyo (see klyo_upload_package). Use THIS when the file is on disk; do not set up a tunnel."
},
"wynik_max": {
"type": "integer",
"minimum": 1,
"description": "The highest possible score in one round: a guard against inflated scores on the leaderboard. Omit it when the game has no score or no upper limit."
},
"sklep_play": {
"type": "string",
"maxLength": 300,
"description": "Address of the same game in Google Play (https://play.google.com/store/apps/details?id=…), if it is also an app. A badge on the game page and in share texts; empty = no badge."
},
"wulgaryzmy": {
"type": "boolean",
"description": "Legacy field: Strong or offensive language. Prefer the `ankieta` object with all the questions."
},
"czas_partii": {
"type": "string",
"maxLength": 40,
"description": "How long one round takes (“2-5 minutes”), in the `jezyk_tekstu` language."
},
"sklep_apple": {
"type": "string",
"maxLength": 300,
"description": "Address of the same game in the App Store (https://apps.apple.com/…), if it is also an iPhone app."
},
"jezyk_tekstu": {
"enum": [
"pl",
"en",
"de",
"fr",
"es",
"pt",
"it",
"ru",
"uk",
"tr"
],
"type": "string",
"description": "Code of the language the name, tagline and controls are written in (pl, en, de, fr, es, pt, it, ru, uk, tr). ALWAYS give it. The description has its own <en> (required) and <pl> (+40 XP) versions, see `opis`. Other languages are translated by the owner's assistant through klyo_game_translate (proposals the owner approves in the studio); klyo does not translate on its own account."
},
"uklad_pionowy": {
"type": "boolean",
"description": "Legacy field: true = portrait game. Prefer `uklad`."
},
"sterowanie_dotyk": {
"type": "string",
"maxLength": 300,
"description": "How to play ON A PHONE, short and concrete (“swipe across the screen”), in the `jezyk_tekstu` language."
},
"przemoc_rysunkowa": {
"type": "boolean",
"description": "Legacy field: Cartoon or abstract violence, no blood. Prefer the `ankieta` object with all the questions."
},
"przemoc_realistyczna": {
"type": "boolean",
"description": "Legacy field: Realistic violence, blood or cruelty. Prefer the `ankieta` object with all the questions."
},
"sterowanie_klawiatura": {
"type": "string",
"maxLength": 300,
"description": "How to play ON A COMPUTER (“arrow keys and space”), in the `jezyk_tekstu` language."
}
},
"additionalProperties": false
}