A downloadable tool for Windows, macOS, and Linux

lets you open bitsy editor by Adam Le Doux and different flavors of bitsy like bitsy 3d and multicolor bitsy in a desktop app that can save and patch your files directly

bitsy cat the savior! here they come!!! no longer will you need to copy-paste bitsy data into your exported bitsy game with all the hacks every time you want to change something and see how it works! because bitsy savior can update game data in that html file with your game as you work ✨✨✨ it also lets you save and load game data quickly as a file instead of having to copy it, and other useful features, and has a shortcut for every command.

if you like it and can support me on ko-fi please do! it helps a lot 💜

how to use

aside from always having a compatible version of bitsy built-in, bitsy savior lets you open custom editors - bitsy forks, new versions of bitsy, or old versions of bitsy that might not be supported. when a bitsy savior feature is not available in the current editor you will see that the option will be grayed out in the 'File' menu. if you  need more details about why a feature isn't working, you can open the console (View -> Toggle Developer Tools) and look for bitsy savior feature status

after you select and run the editor in the launcher window, you will find most of the  useful stuff in the 'File' menu

also keep an eye on window title: it will show files that you are currently saving to. unsaved changes will be marked with • symbol

there are shortcuts for each action (use cmd instead of ctrl if you are on mac)

  1. ctrl+o: load game data from file and remember this file as a saving path for when you make changes in the editor. it is advised that you use this command instead of upload game from the download panel or copy-pasting new bitsy data in game data panel. it works more reliably when importing from html and provides a safer way to switch between different bitsy games. there are two kinds of files you can open:
    • text file with bitsy data ending with .txt or .bitsy
    • html file with a bitsy game
  2. ctrl+s: patch game data in html file with a bitsy game without modifying anything else. you can add hacks to your html file, patch data, and hacks are still going to be there
  3. ctrl+e: save game data as a separate text file
  4. ctrl+d: patch and export at the same time, ensuring that both files will have identical game data
  5. ctrl+shift+s: patch game data in html file, always opens a file-choosing dialog, like 'save as' option you would often see in other programs
  6. ctrl+shift+e: export game data, always show file-choosing dialog
  7. ctrl+alt+s: save as new html. equivalent of 'download game' from the download panel in web version of bitsy, but also remembers where you are saving so that you can patch this file later
  8. ctrl+r: run bitsy game in browser - will save everything and open html file you are patching

advanced

you can set up a javascript file to act as a custom patch for bitsy-editor. you can think of it as a set of commands you would run in the console in web version of bitsy

go to "File -> Settings -> Set editor patch" if you are on windows or linux

or "bitsy-savior -> Preferences -> Set editor patch" if you are on mac

notes

bitsy-savior is still in development and some things can change in the near future

please let me know about your experience! you can hit me up on bitsy discord or on twitter (@aloelazoe) or report a bug here

there are also these things to keep in mind:

  • when you patch html with a bitsy game, it will only update game data. things like window size or background color that you can configure in bitsy settings panel won't be updated
  • when you need to open a different bitsy game, please use "File -> Open" option to do that, rather than copy-pasting different game data. this will make sure you won't accidentally overwrite your other bitsy game with the new data
  • please keep the following in mind when you are working with both "patch" (html with a bitsy game) and "export" (game data exported to a separate text file) to save bitsy-data. when you reopen bitsy-savior, it remembers the paths and opens the files you worked on in your last session. it will load game data from the file you last saved to. if you worked with both "patch" and "export" files and saved both at the same time, it will load game data from "export" file, assuming that if you wanted to modify raw game data outside of the editor, you would do it in a separate text file then copy/paste everything wherever you need, rather than modifying the data in html file. if you want to load data from a different file, just open it through "File -> Open" menu before you save anything
  • the context menu for text fields (right click to copy/paste and such) isn't there yet, but you can use options from 'Edit' menu and the usual  ctrl+c/ctrl+v 
  • "new game" and "reset game data" buttons in the bitsy editor will also reset patch & export saving paths - you can be sure it won't accidentally overwrite those files with new data
  • it's still a good idea to be careful and make backups once in a while. it's easy to do with bitsy-savior: you can use ctrl+shift+e to export game data as a new file

Download

Download
bitsy-savior-mac-64.zip 75 MB
Version 2.0.0 Nov 20, 2020
Download
bitsy-savior-linux-64.zip 74 MB
Version 2.0.0 Nov 20, 2020
Download
bitsy-savior-windows-64.zip 76 MB
Version 2.0.0 Nov 20, 2020
Download
bitsy-savior-windows-32.zip 72 MB
Version 2.0.0 Nov 20, 2020

Development log

Comments

Log in with itch.io to leave a comment.

How can you add multiple hacks to  one game (if possible)?

hi! it's possible, should be pretty simple with borksy . or you can refer to the instructions in the hack repo if you want to add them manually.

(+1)

Thank you so much :)

(+2)

I was delighted to find your tool as I have been enjoying Bitsy since our country went into lockdown. I seem to be unable to load html files into Bitsy Saviour however and I would like to continue working on games I had begun in my browser! Any suggestions you could provide would be very helpful.

Thanks for all the work you have put into this tool :)

(+1)

hi! i think there were some problems with using 'download' panel. have you tried using 'file' -> 'open' from the menu bar?

I did try that but no luck. I can edit inside and make new projects but ti won't load for me. It's alright, I have acess to the web version at the moment. Will uninstall and try again soon!

hm.. could i ask what os are you using? and if there are any errors in the console (view -> toggle developer tools)?
i would appreciate your help documenting the issue when you try it next time(◍•ᴗ•◍)
https://github.com/aloelazoe/bitsy-savior/issues

oh and also you can always copy-paste game data manually in 'game  data' panel

(+1)

This is a very good point. Thanks for the help :) I'm planning to use my pi-zero to run bitsy as a pocket game studio for travelling. Your software will make that so much easier :)

(+1)

glad to hear that (◍•ᴗ•◍) good luck with your project✨