Skip to content

godothub/godot-minigame / skills

godot-wechat-minigame-adapter

Unverified

Apply the bundled self-contained Godot WeChat Mini Game adapter kit to an official Godot checkout. Use when the user wants to port official Godot to WeChat Mini Game, refresh a nearby 4.6-based port, or inspect the shipped patch/source bundle for WXMEMFS, `wx.request`, audio cleanup, display/input, WXGLX dual-path rendering, `.wasm.br`, and `wx.exitMiniProgram`. This skill is version-locked to the bundled upstream base and must not be described as a generic “Godot 4.x” patch dump.

FileKindSize
SKILL.mdskill md6.0 KB
agents/openai.yamlconfig269 B
assets/min-runtime/godot-loader.jsscript16.6 KB
assets/min-runtime/godot-sdk.jsscript7.8 KB
patches/fixes/4.7-webgl-context/001-context-swap-control.patchother4.2 KB
patches/fixes/4.7-webgl-context/README.mdmarkdown1.5 KB
patches/godot-4.6.2-rc-a16e481cf4/core/001-build-and-runtime-glue.patchother12.4 KB
patches/godot-4.6.2-rc-a16e481cf4/core/002-native-audio-routing.patchother6.3 KB
patches/godot-4.6.2-rc-a16e481cf4/core/003-wxglx-nine-patch-expansion.patchother5.7 KB
patches/godot-4.6.2-rc-a16e481cf4/core/004-wxglx-nine-patch-runtime-scope.patchother7.2 KB
patches/godot-4.6.2-rc-a16e481cf4/core/series.txtmarkdown142 B
patches/godot-4.6.2-rc-a16e481cf4/manifest.jsonconfig993 B
patches/godot-4.6.2-rc-a16e481cf4/optional/001-audio-worker.patchother820 B
patches/godot-4.6.2-rc-a16e481cf4/optional/series.txtmarkdown23 B
references/compatibility-matrix.mdmarkdown1.2 KB
references/migration-modules.mdmarkdown5.8 KB
references/recent-commit-deltas.mdmarkdown2.2 KB
references/runtime-shell.mdmarkdown3.8 KB
references/validation-checklist.mdmarkdown3.4 KB
references/wxglx-adaptation.mdmarkdown8.8 KB
scripts/apply_godot_patchset.pyscript5.6 KB
scripts/compress_wasm.batscript100 B
scripts/compress_wasm.shscript91 B
scripts/godot_process.jsscript5.3 KB
scripts/install_min_runtime.pyscript1.1 KB
scripts/validate_template_runtime.jsscript2.8 KB
sources/godot-4.6.2-rc-a16e481cf4/compress_wasm.batscript237 B
sources/godot-4.6.2-rc-a16e481cf4/compress_wasm.shscript215 B
sources/godot-4.6.2-rc-a16e481cf4/godot_process.jsscript5.3 KB
sources/godot-4.6.2-rc-a16e481cf4/optional/platform/web/js/libs/audio.worker.jsscript6.6 KB
sources/godot-4.6.2-rc-a16e481cf4/optional/platform/web/js/libs/lib.wx.api.d.tsscript516.7 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_blob.jsscript27.1 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_audio.jsscript88.8 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_crypto.jsscript116 B
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_display.jsscript26.4 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_fetch.jsscript8.9 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_fs.jsscript29.4 KB
sources/godot-4.6.2-rc-a16e481cf4/platform/web/js/libs/library_godot_input.jsscript23.2 KB
tests/test_godot_process_commit_frame.jsscript2.6 KB
tests/test_min_runtime_loader.jsscript3.8 KB
tests/test_template_glx_config.jsscript1.3 KB
tests/test_wechat_audio_context_source_reuse.jsscript3.9 KB
tests/test_wxglx_nine_patch_patch.jsscript2.2 KB

references/runtime-shell.md

View on GitHub
# Minimal SDK Runtime

Use this reference when replacing the old external `godot-minigame-sdk` dependency with the public runtime shell shipped in this skill.

## Bundled Files

- `assets/min-runtime/godot-sdk.js`
- `assets/min-runtime/godot-loader.js`
- `scripts/install_min_runtime.py`

## What Current Godot Actually Uses

The bundled public adapter depends on only these pieces from the old SDK contract:

- `GODOTSDK.audio.WEBAudio.audioContext`
  - used by `platform/web/js/libs/library_godot_audio.js`
- `fsUtils.localFetch`
  - used by `platform/web/js/engine/preloader.js`
- keyboard adapter methods on `__globalAdapter`
  - used by `platform/web/js/libs/library_godot_input.js`
- `GameGlobal.GODOTSDK` as the host object that the WXMEMFS layer augments with:
  - `releasePck`
  - `getWxPath`
  - `getGodotPath`
- `GameGlobal.nowPolyfill`
  - required by the bundled `godot_process.js` patching step
- `GameGlobal.__godotMinigamePixelRatio`
  - synchronized from `wx.getWindowInfo().pixelRatio` when available so the loader and generated Godot display code render sharply on iOS high-DPI devices
  - `godot-loader.js` installs a `window.devicePixelRatio` getter only when the host property is configurable, and otherwise avoids assigning to read-only runtime properties

Keep these compatibility entries even though the current Godot-side runtime does not call them directly:

- `GODOTSDK.startGame`
- `GODOTSDK.copy_to_fs`
- `GODOTSDK.load_pack`
- `GameGlobal.GodotLoader`

## Preserved Global Names

The minimal runtime intentionally preserves:

- `GameGlobal.GODOTSDK`
- `window.fsUtils`
- `globalThis.fsUtils`
- `window.__globalAdapter`
- `globalThis.__globalAdapter`
- `GameGlobal.nowPolyfill`
- `GameGlobal.GodotLoader`

## What The Minimal `godot-sdk.js` Contains

- `nowPolyfill`
- `fsUtils.localFetch`
- `fsUtils.loadSubpackage`
- keyboard-only `__globalAdapter` methods
- `GODOTSDK.audio.WEBAudio.audioContext`
- `GODOTSDK.startGame`
- `GODOTSDK.copy_to_fs`
- `GODOTSDK.load_pack`
- `WXWebAssembly -> WebAssembly` override

## What The Minimal `godot-loader.js` Handles

- Uses `wx.getWindowInfo().pixelRatio`, `GameGlobal.__godotMinigamePixelRatio`, or `devicePixelRatio` for high-DPI loading output
- Loads images after installing `onload`/`onerror` handlers and retries relative/absolute local paths
- Draws the loading background with cover behavior instead of stretching it
- Normalizes subpackage progress whether WeChat reports `0..100` or `0..1`
- Flushes and commits the WebGL loading frame when the runtime exposes explicit swap control
- Pins one graphics context mode for both the loading screen and generated Godot runtime: `wxwebgl2` when GLX is supported, otherwise `webgl2`
- Reads `GameGlobal.__GODOT_DISABLE_WXGLX === true` before creating a context. Set it in a module imported before `godot-loader.js` to force standard `webgl2`; it is a startup-only switch.

The loader does not make an engine GLX-capable. Before allowing it to request `wxwebgl2`, complete the engine-side integration in `wxglx-adaptation.md`; otherwise force standard WebGL.

## What Was Deliberately Removed

Do not reintroduce these unless a real usage check proves they are required:

- the old full `godot-minigame-sdk` directory
- unrelated helper families from the legacy SDK
- multi-platform wrappers for non-WeChat targets
- test-only APIs

## Recommended Load Order

Load these before generated `godot.js`:

1. `godot-sdk.js`
2. `godot-loader.js`
3. generated `godot.js`

That order ensures:

- `nowPolyfill` exists before patched `godot.js` runs
- `fsUtils.localFetch` exists before `preloader.js` runs
- `GODOTSDK.audio.WEBAudio.audioContext` exists before `library_godot_audio.js` initializes
- `GameGlobal.GODOTSDK` exists before the WXMEMFS layer augments it

## Copy Strategy

Vendor both files into the downstream minigame host project and version them there. Do not keep them as a machine-local dependency.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall