Hi everyone,
I've been working on construct3-minigame-adapter, an experimental tool for converting Construct 3 HTML5 exports into WeChat, Douyin and TikTok mini-game projects. I'd like to share it with other Construct developers working on these platforms and get feedback on compatibility.
The project combines an SDK v2 MiniGameBridge addon, an offline conversion CLI and a runtime adapter. You can call platform APIs from event sheets or JavaScript. It does not add a new option to Construct's export menu: you export HTML5 in Construct first, then run the converter to generate the target platform project.
The adapter keeps WeChat's wx, Douyin's tt and TikTok Native's TTMinis.game separate. The API catalog currently lists 194 names across 21 categories, covering areas such as storage, networking, input, audio, lifecycle events, login and ads. This is catalog coverage, not a claim that every API is available or has passed device testing. Capability checks and explicit errors help identify what the current host actually provides.
To try it:
1. Install the MiniGameBridge addon and open the editable MiniGameApiSuite.c3p demo, or add the object to your own project.
2. Export HTML5 from Construct and extract the ZIP.
3. With Node.js 22 or newer, run the CLI converter for your target platform using your own mini-game AppID.
4. Import or launch the output with the platform's development tools, then test on a device.
The documentation includes installation screenshots, conversion commands, an API reference and validation notes in English and Chinese. The repository provides the source, addon and editable demo; it does not redistribute Construct engine HTML5 exports or game builds containing that engine.
Current status: recorded testing includes a real Construct r495.2 export, conversion for all three targets, and rendering/category navigation in WeChat DevTools. TikTok iOS feedback includes working page display/navigation, but also a storage readback failure; the latest storage and device-info fixes still need phone retesting. Full device acceptance, real payments and the new image-rendering demo remain unverified. Compatibility is limited, including same-thread asynchronous Worker emulation, so please treat this as an experimental integration and test your game's plugins and runtime requirements.
GitHub: github.com/AnranS/construct3-minigame-adapter
Documentation and downloads: anrans.github.io/construct3-minigame-adapter/en
Validation details: anrans.github.io/construct3-minigame-adapter/en/validation
If you're targeting one of these platforms, I'd appreciate small reproducible projects or feedback on the workflow. Please include the Construct version, platform, device and first relevant error when reporting an issue, without credentials or private account details.
Thanks!