How to put up your WIP on itch.io

In light of the recent announcement about dashingdon’s discontinuation, I am coming up with this quick and dirty guide to putting up a WIP on itch.io. This is something I learnt through trial and error very recently - I’m not an expert. If there’re any mistakes I’ve made, feel free to let me know.

CoGdemos is also a good place to host WIPs, but I’m just providing this guide so that this community has access to another option.

Optional - Install the CoG save plugin.

I’ve tried this, and it’s not rocket science. Just head to this link, download a file and place it in the folder shown. Then, change two lines in the index.html file. That’s it. You should have the dashingdon-style save system up and running, and it’ll be available on itch.

Step 1 - Run the compiler in choicescript-main to generate an output.html file.

On Windows, double-click on run-compile.bat
On macOS, double-click on compile.command
Or use the compile.html file

This will give you an output.html file

Step 2 - Copy the html file and other relevant media to a new folder.

Copy output.html to a new, separate folder. Rename the file to index.html. If your game has any pictures or other media files, copy them into this same folder.

Step 3 (Optional) - Deal with that annoying hyperlink under the next button.

There is a link which says ‘Make your own games with Choicescript’ under the next button. I click it by accident on my iphone all the time, and it’s annoying.

Open up index.html (previously output.html) in notepad. Look for this line:
<p><a id="makeyourowngames" href="https://www.choiceofgames.com/make-your-own-games/choicescript-intro/">Make your own games with ChoiceScript</a></p>

Delete this line or shift it downwards by putting <br> multiple times in front of it.

Step 4 - Send the folder to a ZIP file.

Right click the folder containing the index.html (previously output.html) file as well as any media assets, and compress it to a ZIP file. This ZIP file is what we will upload to itch.

Step 5 - Create a page on itch

Click that down arrow next to your profile picture, then click Dashboard. On your dashboard, click Create New Project.

Enter a title and short description for your game. For Classification, you should pick ‘Games’. For Kind of project, you should pick ‘HTML’, or you can pick ‘downloadable’ if you prefer people to download your files to their devices instead. For Release status, I suppose you could pick ‘In development’ unless something else is more appropriate to your situation.

For Pricing, check ‘No payments’. Unless you have a commercial license, there is no reason you should be selecting the other options.

For Uploads, upload the ZIP file I talked about in step 4. Check the box which says that the file will be played in the browser.

For Embed options, well, whatever works for you. My recommendation would be to select ‘Click to launch in fullscreen’ from the dropdown menu. For Frame Options, I usually check ‘mobile friendly’, set Orientation to ‘portrait’ and check ‘enable scrollbars’.

For Details, well, type whatever you want to sell your project to the masses.

For Genre, I’d select ‘Interactive Fiction’.

For Tags, you can pick up to ten tags. I suggest having ‘choicescript’ and ‘text-based’ as basic selections.

For AI generation disclosure, well, be honest. A gentle reminder that Hosted Games will not accept any AI content.

You can probably skip App store links and Custom noun.

For Community, it’s up to you. Note that you have the power to delete comments and ban users for any or no reason at all. :sweat_smile:

For Visibility & Access, well, whatever works for you. ‘Public’ if you want a public WIP, ‘Restricted’ if you’re running a closed beta or patreon exclusive.

For Upload Cover Image, follow the suggested guidelines and upload cover art. If you want to attract views from itch users, I suggest trying to upload something decent, at least.

When you’re done, Save & view page.

Step 6 - You’re done.

You now have a page for hosting your WIP, which you can link to on your WIP thread here. You can also click Edit theme to mess with the display, but I won’t talk about that here.

Advantages to putting your WIP on itch

  1. More visibility from itch users.
  2. Access to analytical data on the number of people who viewed/played your game.
  3. Additional platform for people to leave comments.

Disadvantages

  1. More work to compile and upload a html file.
  2. Not possible for players to view scene files.
  3. High competition for visibility on itch.

Whether this is a good or bad option depends on your needs and preferences.

If anyone wants to point out any errors, improvements and so on to this guide, let me know. I am not an expert.

42 Likes

Thanks for this! I’ve used this method with pretty reliable success; the main issue that happened with me is that players sometimes needed to clear their cache after an update.

It’s also worth considering using the *ifid command so that progress will be saved if the player closes their tab.

8 Likes

Good that there is a second option, but as some authors have things like Patreon too I wonder if it is possible for some of them to host their public demos there as well? Might be a potential third option for some.

2 Likes

You can create downloadable attachments on Patreon the same way as you can on the forum, but you wouldn’t be able to host it to be playable in browser the way you can on cogdemos/your own website/itch.

3 Likes

Does itch support *create_array and temp_array commands?

1 Like

As long as you generated the output.html file with a version of choicescript which supports the commands, it should work. Best to download the latest version of choicescript when compiling your game.

4 Likes

Then me and itch don’t have a problem☺️

2 Likes

Thank you for this!

1 Like

Just a note, all scene files are rolled into the resulting html file, so they can be viewed in there (with a bit of search/replace to clean up the layout). So that’s less of disadvantage that may seem at first glance.

1 Like

Also not all authors like testers peeking at their code, so in that case it’s a bonus for the author.

3 Likes

True, although searching the resulting html file is a lot less intuitive than looking through the original scene files. Another way could be for the writer to make the scene files available for download separately, if they are comfortable with it.

But yeah, for writers who want to hide their code from the public, you’ve got a solution right here.

3 Likes

Thanks for sharing that .
If we did the first steps about the save system.
The readers will be able to save even after puplishing ,right?

1 Like

Yes, after publishing on itchio. But not games published with Choice of Games, Hosted Games, or Heart’s Choice.

2 Likes

Correct, but like what @HarrisPS said, only on itch. If you installed the save plugin and follow all the steps above, you’ll have a save system on itch.io which allows you to save and load anywhere without logging in, similar to dashingdon.

5 Likes