跳转到内容
Godot 中国站

微信小游戏导出工具

概述

Section titled “概述”

Godot WeChat Exporter 是一款桌面端工具，用于将 Godot 引擎导出的 Web 项目转换为可在微信小游戏平台运行的完整项目。工具基于 Tauri + Vue 3 + Rust 构建，目前提供 Windows 版本。

工具的核心流程：将 Godot 编辑器导出的 PCK 文件（Web 平台），自动转换为微信开发者工具可直接打开的小游戏项目目录。整体结构与 Unity 导出微信小游戏的方式类似。

当前适配引擎版本

Section titled “当前适配引擎版本”
  • Godot 4.6.1（持续跟进最新版本）

功能特性

Section titled “功能特性”
  • PCK 文件校验：自动读取并验证 Godot PCK 文件格式与版本兼容性
  • 两种首包资源模式：
    • 代码分包模式：PCK 直接打包进小游戏首包，适合 10MB 以下的轻量项目
    • CDN 模式：首包资源托管到 CDN 服务器，适合较大的项目
  • 自动生成项目结构：包括 game.json、project.config.json、WASM 分包等
  • 微信 API 适配层：内置 weapp-adapter.js，桥接 Godot 与微信小游戏运行时
  • 自定义启动画面：支持替换默认 splash 图片
  • 屏幕方向配置：支持横屏 / 竖屏切换
  • Brotli 压缩：WASM 文件经 Brotli 压缩，减小包体积

使用方式

Section titled “使用方式”

前置条件

Section titled “前置条件”
  1. 在 Godot 编辑器中将项目导出为 Web 平台，获得 PCK 文件
  2. 准备好微信小游戏的 AppID

导出步骤

Section titled “导出步骤”
  1. 打开 Godot WeChat Exporter
  2. 选择 Godot 导出的 PCK 文件
  3. 填写微信配置（AppID、项目名称、版本号）
  4. 选择首包资源模式（分包 或 CDN）
  5. 选择输出目录，点击导出

导出完成后，在微信开发者工具中打开输出目录下的 minigame 文件夹即可预览。如果选择了 CDN 模式，需要将输出目录下的 webgl 文件夹上传到指定的 CDN 地址。

关于分包与资源管理

Section titled “关于分包与资源管理”

本工具处理的是首包内容 —— 即小游戏启动时加载的核心资源。对于项目较大的情况，建议采用以下策略：

  • 首包尽量精简：只放游戏的登录页面、启动场景等必要资源，保持首包体积尽可能小
  • 后续内容自行管理分包下载：游戏运行后的关卡、素材等资源，通过自定义的分包下载逻辑按需加载

这种做法与 Unity 微信小游戏的资源管理思路一致 —— 首包保证快速启动，后续资源动态加载。

注意事项

Section titled “注意事项”
  • 代码分包模式下，PCK 文件大小不能超过 10MB（微信平台限制）
  • CDN 模式需要提供可访问的 CDN 地址
  • 导出前请确保 PCK 文件版本不高于工具内置的引擎版本
  • 目前仅提供 Windows 版本，macOS / Linux 版本后续推出

下载

Section titled “下载”