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.webpRequired and optional files
| File | Required | Purpose |
|---|---|---|
| index.html | Every version | Game entry point |
| owogg.json | Every version | Display, result, and capability contract |
| owogg.logo.png|jpg|jpeg|webp|svg | New game only | Catalog logo |
| description.md | When file-based descriptions are used | Default English Markdown |
| description_kr.md / _ja.md / _zh.md | Optional | Korean, Japanese, and Chinese descriptions |
| Description images | Optional | Raster files declared in description_images |
Current limits
| Item | Limit |
|---|---|
| Uploaded ZIP | 20 MiB compressed |
| Extracted total | 50 MiB |
| File count | 300 |
| Path depth | 16 segments |
| Logo | 2 MiB |
| Standalone owogg.json replacement | 256 KiB |
| Markdown description | 64 KiB per file |
| Description image | 5 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.