Title, icon, splash
Lives in: game.json
How the game presents itself before the first line — window name, shell icon, and boot splash. In-game panel and title-menu chrome are separate — Theme and the dialogue box · Title, pause and settings screens.
Title, version, authors, and window size: Name, window, language.
Checklist
| Set this | Where | What players see |
|---|---|---|
| Title | title (or title_key) | Window title; web page title; build folder slug; desktop app names |
| Version | version | Build folder (…-v1.0); store / changelog label |
| Authors | authors | Windows EXE company field; optional credits |
| Icon | icon | Desktop / window / web favicon / Android launcher |
| Splash | splash | Boot / loading look on web, Android, and delivered desktop builds |
| Android package | android.package_id | Required for Android builds — Platforms |
{
"title": "My Novel",
"version": "0.1",
"icon": "ui/icon.png",
"splash": {
"bg_color": "#1a1a2e"
}
}
Icon
"icon": "ui/icon.png"
Prefer a square PNG (≥256 px). One path; Build stamps each platform. Empty icon keeps the VN-Mikro player mark.
| Target | Result |
|---|---|
| Linux | Icons + desktop entry beside the player |
| Windows | Stamps the .exe (Explorer icon + version strings from title / authors) |
| macOS | .icns in the .app; Finder name from title |
| Web | Favicon / apple-touch icons next to index.html |
| Android | Launcher icons inside the APK / AAB |
If Windows stamp tools are missing on your machine (Wine / rcedit), Build can still finish with the default icon — Build and hand off.
Splash
Shared colours and logo at the root; optional web / android / desktop blocks override what that platform needs. Omitted colours are filled from your theme at Build time.
"splash": {
"bg_color": "#1a1a2e",
"logo": "sprites/logo.png",
"logo_max_width": 300,
"progress_bar": {
"width": "50%",
"height": 12,
"background": "#343a52",
"fill": "#7a8a9e"
},
"desktop": { "min_seconds": 0.6 }
}
| Key | Effect |
|---|---|
bg_color | Solid splash fill (else theme panel / background colour) |
logo | Centered brand mark |
background | Optional full-bleed art under the logo |
logo_offset_x / y | Nudge from centre |
progress_bar | Loading bar (web + Android overlay; not desktop) |
desktop.min_seconds | Minimum brand hold on desktop production builds (0 = as soon as ready) |
Platform nested blocks merge key-by-key over the root — Reusing settings.
Usually you need
| Want | Do |
|---|---|
| Named build | Set title + version |
| Your mark on the EXE / app | Set icon |
| Matching boot flash | Set splash.bg_color (and optional logo) |