How to avoid Renpy web pixelation?

[Chains]

I don't know if this has been asked before, I couldn't find anything about it.

My Renpy web game displays images as pixelated (like with a mosaic filter) when they are shown for the first time. It takes about 1 second before the pixelation is gone. I tried resizing the image files since I assumed they are too large for a web build but even small GUI imagebuttons are loaded this way, no matter how much I resize them. I have tried converting all images to webp files but this also didn't change anything.

My game has a 1920 x 1080 resolution and the GUI folder is 1.2MB. Individual character sprites are about 300KB. I don't have this issue when I am playing other people's Renpy web games, so I don't think my device is the issue.

Any ideas how to fix this?

[PyTom]

This happens when an image is shown, but hasn't been downloaded yet. There are a couple of ways you can fix this:

* You can include the images in the zip file, by not declaring them in progressive_download.txt
* You can make sure Ren'Py can predict the images. That's complex, but this article covers it - it works the same way on web and the rest of Ren'Py.

[Chains]

This happens when an image is shown, but hasn't been downloaded yet. There are a couple of ways you can fix this:

* You can include the images in the zip file, by not declaring them in progressive_download.txt
* You can make sure Ren'Py can predict the images. That's complex, but this article covers it - it works the same way on web and the rest of Ren'Py.

Thank you for the fast help, PyTom! I included the images in the zip file and it works perfectly now. But I'll also look into the article to avoid these issues in the future.