导出 + 发布到 itch.io

May 12

游戏做完了！最激动人心的一步 — 让别人玩到你的游戏。

我们要做两件事：

导出为 Web 版（HTML5） — 在浏览器里就能玩
发布到 itch.io — 全世界都能搜到、能玩

还记得我们在第 1 章选了「兼容」渲染器吗？就是为了这一步！🎉

安装 Web 导出模板

第一次导出 Web 版需要下载导出模板：

路径：编辑器 → 管理导出模板 (Manage Export Templates)

如果是首次安装，点击「下载并安装」，等几分钟下载完成即可。

09-export-导出模板

配置 Web 导出

路径：项目 → 导出 (Export)

点击「添加」→ 选择 Web 平台。

09-export-配置

关键设置

项	推荐值	说明
`Custom HTML Shell`	留空	用 Godot 默认模板即可
`Head Include`	留空	如果想自定义页面 meta，可以加
`Canvas Resize Policy`	`Adaptive`	自适应窗口大小
`Focus Canvas on Start`	✅ 启用	启动就聚焦，方便按键响应
`Experimental Virtual Keyboard`	看需求	移动端用得上

导出游戏

在【导出】面板选中 Web 配置
点击右下角「导出项目」
选择一个空文件夹保存（比如 build/web/）
文件名填 index.html（itch.io 上传约定）

⚠️ 必须导出到空文件夹 — 否则会和已有文件混在一起。

导出后这个目录会出现一堆文件：

build/web/
├── index.html
├── index.js
├── index.pck       ← 游戏资源
├── index.wasm      ← 游戏引擎（WebAssembly）
├── index.audio.worklet.js
└── index.icon.png  ← 图标（可选）

本地测试

Web 导出无法直接双击 index.html 打开（浏览器安全策略会阻止 wasm 加载）。需要起一个本地 server：

# Python 自带 server（最方便）
cd build/web
python -m http.server 8000

# 或者 Node.js
npx serve build/web

打开浏览器访问 http://localhost:8000，能玩就说明导出成功。

09-export-本地测试

注册 itch.io

已有账号可以跳过这一步。

去 itch.io 注册账号，确认邮箱即可。

上传游戏

登录后，右上角头像 → Upload new project。

09-export-上传页面

填写项目信息

字段	填写建议
Title	游戏名（如 `XGGame-Bird`）
Project URL	URL slug（自动生成，可改）
Short description	一句话简介（搜索结果会显示）
Classification	选 `Games`
Kind of project	选 `HTML` ← 关键！
Release status	`Released` 或 `Prototype`
Pricing	`$0 or donate` （免费 / 自愿打赏）

上传文件 — 打包成 zip

itch.io 要求 Web 游戏打包成 zip 上传：

# 进入 build/web 目录
cd build/web

# 打包成 zip（不要有外层文件夹，要 index.html 在 zip 根目录）
zip -r ../xggame-bird-web.zip .

或者直接在文件管理器里：选中 build/web 里的所有文件（注意是文件，不是文件夹）→ 右键 → 压缩为 zip。

⚠️ 常见坑：zip 解压后必须直接看到 index.html，不能有外层文件夹。否则 itch.io 加载不出来。

上传 zip 后，勾选 「This file will be played in the browser」。

09-export-上传文件

配置嵌入设置（Embed Options）

下拉找到 Embed options：

项	值
Viewport dimensions	你游戏的窗口大小（如 `608 × 1080`）
Frame options	一般勾 `Fullscreen button` 让玩家可全屏
Mobile friendly	如果适配了移动端，勾上