bitsy-savior

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 would like to thank me for my work you can support me on ko-fi

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

you can ask on bitsy discord for help

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

loading editor url file:///home/hacknorris/downloads/bitsy-savior-linux-64/resources/app/src/bitsy/editor/index.html
an error occured when trying to load file:///home/hacknorris/downloads/bitsy-savior-linux-64/resources/app/src/bitsy/editor/index.html
Error: ERR_FAILED (-2) loading 'file:///home/hacknorris/downloads/bitsy-savior-linux-64/resources/app/src/bitsy/editor/index.html'
    at rejectAndCleanup (electron/js2c/browser_init.js:205:1288)
    at WebContents.stopLoadingListener (electron/js2c/browser_init.js:205:1673)
    at WebContents.emit (events.js:310:20) {
  errno: -2,
  code: 'ERR_FAILED',
  url: 'file:///home/hacknorris/downloads/bitsy-savior-linux-64/resources/app/src/bitsy/editor/index.html'
}