How to Put your dbb Game on itch.io

May 09, 2023 · by dotbigbang (@_dotbigbang_)

Share on Twitter Share on Facebook

Follow dotbigbangFollowing dotbigbangUnfollow dotbigbang

Share this post:

Share on Twitter Share on Facebook

Follow dotbigbangFollowing dotbigbangUnfollow dotbigbang

How to Upload your dot big bang Game on itch.io

Introduction

You already know that your dot big bang game runs in a browser, and you can get players in by sharing a link anywhere. But what if you wanted to embed the experience directly in an itch.io page, like in this example? You can, through the power of iframes!

Steps

Create the index.html File

For an HTML build to play on itch, it needs to include a file called index.html. Fortunately for us, that’s all we need, so there’s no need to zip a folder or anything like that.

In your text editor or development environment of choice, create a new file called ‘index.html’.

Copy and paste the following code into it:

<html>
    <body>
        <iframe src="YOUR_GAME_URL_HERE" height="100%" width="100%" frameborder="0"></iframe>
    </body>
</html>

Copy your game’s URL, and substitute it into the iframe source, replacing the YOUR_GAME_URL_HERE.
Save the index.html file where you can access it to upload in the next step.

Upload the index.html File

On the Create a New Project page of the itch.io dashboard, give your project a title and tagline.
Set the Kind of project to HTML.
In the Uploads section, upload your index.html file.
In the Embed options section, change the Viewport dimensions to Width: 800px and Height: 400px.
Check the boxes for Mobile friendly (dbb games automatically give you mobile controls for your player!), Automatically start on page load and Fullscreen button.
Add any more customization you want, and click the Save & view page button

And that’s it! You game should be there for all the world to see.

More Tips

Jumping into a game directly from itch.io should give your players the ability to see what they can do in your game, but they won’t be logged in, or able to get into multiplayer instances. You should share the URL for your game as a link in the description, too, so that they can like and comment on your game and play together with others.