It is now easier to export your game specifically to upload to websites like itch.io but you still need to follow some steps after exporting. These steps will allow you to export and upload so that your game can be downloaded or played directly in a web browser (a common requirement for game jams).
Step 1 - Set Game Label
Step 2 - Export as HTML Folder
Export your game as html but with the special command to save the .html and .js files in a folder.
Use the command
export -f gamename.html (change "gamename" to the name of your game; this will become the folder name as well) then press enter.
The -f command will name the files specifically and place them in a folder. Do not rename the files within the folder; itch.io requires that the main file is named index.html and that file looks for the .js file with the default name, so don't change either.
Step 3 - Zip Game Folder
Navigate to your exported game folder. You can do this easily with the Folder Command in PICO-8. The exported folder should be named: "gamename_html" (gamename replaced with what you titled your game in the export command in Step 2). If you do not see this folder, then you probably forgot to use the
export in Step 2.
Next, zip the folder. You may rename this zipped folder.
Step 4 - Create New Itch.io Project
Open itch.io in your browser, login or signup, and navigate to Upload New Project page.
Step 5 - Fill in Upload Form
Begin to fill in the uploading form with your game's information: Title, Description, and Classification. You may also upload your screenshots, video, and cover art for your game page in the upper part of this form as well.
Kind of Project
When you get to the section "Kind of Project" in the form, open the dropdown menu and select: "HTML — You have a ZIP or HTML file that will be played in the browser". You can include downloadable files as well later.
Continue filling the form as you wish: Release Status and Pricing.
When you get to the section "Uploads" click the red "Upload Files" button and navigate to your zipped game folder from Step 3. Select only that zipped folder to upload here.
Check the box, "This file will be played in the browser."
Under "Embed Options" section, leave the dropdown on "Embed in Page" and "Manually Set Size". ".leave the dropdown on "Embed in Page" and "Manually Set Size".
Under "Viewport dimensions" the suggested setting for the PICO-8 player is: Width: 750px × Height 680px
Under "Frame Options" section, click the checkboxes for "Mobile Friendly" and "Automatically start on page load." Leave the rest unchecked.
Finish the Form
Complete the rest of the form as you wish, entering the page content under "Details", the genre of your game, tags for searching for your game (make sure you include "pico-8" as a tag)
It is recommended to write a detailed How To Play description in the Details section to teach players how to control and win in your game. You can also use screenshots and images in this section to create a legend of the characters and symbols they should understand while playing. (You can always edit and add to this later)
When everything is ready, click the red "Save and view page" button at the bottom to begin uploading and creating the page.
Step 6 - Customize your Page
When you are viewing your game's page, you should see an Edit Theme button at the top. Click this to customize the page colors, banner, background and page borders.
To best match the embedded PICO-8 player, it is suggested to set the background (BG2) to a dark color such as #232323 and the text to a light color such as #cccccc. But you are free to get creative and match your game's color style however you'd like.
If you would like to further customize the embedded PICO-8 web player with custom buttons and styles, see Export As Webpage for details.
16 Jun 2023