GAME CREATOR

ZIP package specification

Required files, relative-path rules, logos, descriptions, and current upload limits.

Recommended root layout

The clearest ZIP opens directly to the files below. The publisher can unwrap one shared top-level folder, but mixed roots are validated as-is.

text
my-game.zip
├─ index.html
├─ owogg.json
├─ owogg.logo.svg
├─ game.js
├─ style.css
├─ description.md
├─ description_kr.md
├─ description_ja.md
├─ description_zh.md
└─ assets/
   ├─ sprites.webp
   └─ how-to-play.webp

Required and optional files

FileRequiredPurpose
index.htmlEvery versionGame entry point
owogg.jsonEvery versionDisplay, result, and capability contract
owogg.logo.png|jpg|jpeg|webp|svgNew game onlyCatalog logo
description.mdWhen file-based descriptions are usedDefault English Markdown
description_kr.md / _ja.md / _zh.mdOptionalKorean, Japanese, and Chinese descriptions
Description imagesOptionalRaster files declared in description_images

Current limits

ItemLimit
Uploaded ZIP20 MiB compressed
Extracted total50 MiB
File count300
Path depth16 segments
Logo2 MiB
Standalone owogg.json replacement256 KiB
Markdown description64 KiB per file
Description image5 MiB each, up to 5

File and path rules

  • Reference CSS, JavaScript, images, fonts, and WASM through relative paths inside the ZIP.
  • Absolute paths, Windows drive paths, empty segments, and . or .. segments are rejected.
  • Do not include secrets, OAuth tokens, user IDs, OwOGG cookies, or server-only code.
  • Exclude source maps and development-server settings unless the release truly needs them.
  • Unity WebGL and Godot file types have supported MIME mappings, but you still need to test the exact build in a browser before submission.

Localized descriptions

When game.description is a file array, description.md is the required English default. The UI uses the current locale first, then English, then the short description. CommonMark is rendered, but raw HTML is not executed.

Only PNG, JPEG, GIF, WebP, and AVIF files explicitly listed in description_images can appear in the body. SVG, external URLs, and undeclared bundle files are not allowed as description images.

Continue reading