Godot Version
4.5.1
Question
Hey everyone,
I’m working on deploying a Godot 4.5 game as a Telegram Mini App (TMA), and I’ve hit a wall.
The Problem: I’ve built a very simple prototype (just one button and a label) to test the deployment pipeline.
It works perfectly when opened directly in a desktop or mobile browser.
However, when I launch it inside Telegram as a Mini App, the Godot loading bar fills up completely, and then… nothing. It just hangs on a blank screen, and the game itself never appears.
Live Examples:
Working Browser Version: https://one-button-game.lewdmonkey.com/
Non-Working Telegram Bot: @godotOneButtonBot
What I’ve Tried: I’ve been debugging this for a while and I’m stumped. My focus has been on:
Godot Export Settings: I’ve tried tweaking various settings in the HTML5 export preset, but nothing has changed the outcome.
Nginx Configuration: I’m serving the files over HTTPS (as required by Telegram) using Nginx. I’ve double-checked my config, but I suspect I might be missing some crucial HTTP headers.
My Hypothesis: I’m guessing this is a specific environmental quirk of the Telegram Mini App platform that I’m not accounting for. Perhaps it’s related to missing headers (CORS, COOP, COEP?), or maybe I need to inject a specific JS script into the index.html to bridge Godot and the TMA API?
My Questions:
Has anyone here successfully deployed a Godot 4.x game as a Telegram Mini App?
If so, would you be willing to share your HTML5 export settings?
What did your Nginx (or other server) configuration look like?
I’ve searched extensively, and there seems to be very little information or discussion out there on combining Godot and TMAs. Any help, pointers, or advice would be massively appreciated!
Thanks in advance.