chore(release): 15.4.5 [skip ci]

## [15.4.5](v15.4.4...v15.4.5) (2021-06-12) ### Bug Fixes * add clearer note about bitsy 3d editor to 3d hack ([df0961f](df0961f)) * add note about simpler bitsy audio tool to bitsymuse ([0af7bce](0af7bce)) * update readme ([b67b4d4](b67b4d4))
seleb · Jun 12, 2021 · 5d5e5b0 · 5d5e5b0
1 parent 9c8ed9c
commit 5d5e5b0
Show file tree

Hide file tree

Showing 65 changed files with 109 additions and 72 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,12 @@
+## [15.4.5](https://github.com/seleb/bitsy-hacks/compare/v15.4.4...v15.4.5) (2021-06-12)
+
+
+### Bug Fixes
+
+* add clearer note about bitsy 3d editor to 3d hack ([df0961f](https://github.com/seleb/bitsy-hacks/commit/df0961fbaa699a94b06597454e6989e29c07a37d))
+* add note about simpler bitsy audio tool to bitsymuse ([0af7bce](https://github.com/seleb/bitsy-hacks/commit/0af7bce35c418011e104bdcaff7a833c7696756e))
+* update readme ([b67b4d4](https://github.com/seleb/bitsy-hacks/commit/b67b4d4e8c23ae09e67672131647bd4f255c5ab5))
+
 ## [15.4.4](https://github.com/seleb/bitsy-hacks/compare/v15.4.3...v15.4.4) (2021-05-16)
 
 

diff --git a/README.md b/README.md
@@ -8,6 +8,7 @@ A collection of re-usable scripts for [Adam Le Doux](https://twitter.com/adamled
 
 - [Contents](#contents)
 - [How to use](#how-to-use)
+- [FAQ](#FAQ)
 - [Further reading](#further-reading)
 
 ## Contents
@@ -76,9 +77,6 @@ A collection of re-usable scripts for [Adam Le Doux](https://twitter.com/adamled
 
 ![Imgur](https://i.imgur.com/peRLLHn.gif)![Imgur](https://i.imgur.com/yg81aH2.gif)![Imgur](https://i.imgur.com/r7AUHX4.gif)
 
-
-
-
 ## How to use
 
 Each script has a short "HOW TO USE" section included in the comments. For steps which say to `Copy-paste this script into a script tag after the bitsy source `, open your exported bitsy game and scroll to the bottom of the file (at the time of writing, it looks like this):
@@ -121,13 +119,40 @@ then edit it to look like this:
 </html>
 ```
 
+## FAQ
+
+- > I don't know javascript. Can I still use the hacks?
+
+  Yes, most of the hacks require little to no javascript experience.
+
+- > Can I import a hacked file back into the Bitsy editor?
+
+  Yes, but unfortunately only the gamedata will be imported, and the hacks will be lost. To edit a hacked game, it's recommended that you keep a copy of the hacked html file, and copy-paste edited gamedata into it. If you need to do this a lot, there are a few tools available to speed up your workflow (e.g. [bitsy-savior](https://aloelazoe.itch.io/bitsy-savior), [Borksy](https://ayolland.itch.io/borksy), [bitsy-boilerplate](https://github.com/seleb/bitsy-boilerplate)).
+
+- > Some of these hack files are kinda long. Do I need to copy the whole thing?
+
+  Yes, you need the entire hack file in order for it to work. If for some reason you're *really* concerned with filesize (you shouldn't be), you can programmatically compose and minify them (either by cloning this repo or by using the [bitsy-boilerplate](https://github.com/seleb/bitsy-boilerplate) project), but this is only recommended for developers familiar with javascript bundling.
+
+- > Can I combine multiple hacks?
+
+  Yes, but there are [known issues with specific combinations](https://github.com/seleb/bitsy-hacks/issues?q=is%3Aissue+label%3Amulti-hack+). If you're having issues using multiple hacks, try testing them one at a time to make sure they've each been setup correctly.
+
+- > Do the hacks work with forks like [Bitsy 3D](https://aloelazoe.itch.io/bitsy-3d), [Bitsy HD](https://vonbednar.itch.io/bitsy-x2), or [Bitsy Color](https://aurysystem.itch.io/multicolorbisty)?
+
+  It varies by hack and by fork. If something doesn't work, try testing against a regular Bitsy game to make sure you've setup the hack correctly.
+
+  Bitsy HD in particular is a fairly old fork, and generally needs [older versions of hacks](https://github.com/seleb/bitsy-hacks/tree/d419cf6b84822a6419a78ad82336333771b27bf0/dist).
+
+If your question isn't covered here, it may be in the general [Bitsy FAQ](https://docs.google.com/document/d/1jRz3wgkQU3kZN_LGChw4UlMWhVoc145J-euBtkr7NeE).
+
+For other issues, feel free to ping me, [open an issue](https://github.com/seleb/bitsy-hacks/issues/new), or ask for help on the [Bitsy discord](https://discordapp.com/invite/9rAjhtr)!
+
 ## Further reading
 
 - [Writing hacks with this repo's source code](https://github.com/seleb/bitsy-hacks/wiki)
 - [Claire Morley's "A Bitsy Tutorial"](http://www.shimmerwitch.space/bitsyTutorial)
 - [Bitsy games!](https://itch.io/games/tag-bitsy)
 - [AYolland's Borksy](https://ayolland.itch.io/borksy): Hack helper
+- [elkie's bitsy-savior](https://aloelazoe.itch.io/bitsy-savior): Safe saver
 - [ruin's image-to-bitsy](https://ruin.itch.io/image-to-bitsy): Artistic aid
-- [Fontsy](https://seansleblanc.itch.io/Fontsy): Typographic tool
-
-If you have any issues, feel free to ping me, [open an issue](https://github.com/seleb/bitsy-hacks/issues/new), or ask for help on the [bitsy discord](https://discordapp.com/invite/9rAjhtr)!
+- [Fontsy](https://seansleblanc.itch.io/Fontsy): Typographic tool
diff --git a/dist/3d.js b/dist/3d.js
diff --git a/dist/avatar-by-room.js b/dist/avatar-by-room.js
diff --git a/dist/backdrops.js b/dist/backdrops.js
diff --git a/dist/basic-sfx.js b/dist/basic-sfx.js
diff --git a/dist/bitsymuse.js b/dist/bitsymuse.js
diff --git a/dist/canvas-replacement.js b/dist/canvas-replacement.js
diff --git a/dist/character-portraits-animated.js b/dist/character-portraits-animated.js
diff --git a/dist/character-portraits.js b/dist/character-portraits.js
diff --git a/dist/close-on-ending.js b/dist/close-on-ending.js
diff --git a/dist/corrupt.js b/dist/corrupt.js
diff --git a/dist/custom-exit-effects.js b/dist/custom-exit-effects.js
diff --git a/dist/custom-keyhandlers.js b/dist/custom-keyhandlers.js
diff --git a/dist/custom-text-effect.js b/dist/custom-text-effect.js
diff --git a/dist/dialog-audio-vocal-synth.js b/dist/dialog-audio-vocal-synth.js
diff --git a/dist/dialog-audio.js b/dist/dialog-audio.js
diff --git a/dist/dialog-box-transition.js b/dist/dialog-box-transition.js
diff --git a/dist/dialog-choices.js b/dist/dialog-choices.js
diff --git a/dist/dialog-jump.js b/dist/dialog-jump.js
diff --git a/dist/dialog-pause.js b/dist/dialog-pause.js
diff --git a/dist/dialog-prompt.js b/dist/dialog-prompt.js
diff --git a/dist/direction-in-dialog.js b/dist/direction-in-dialog.js
diff --git a/dist/directional-avatar.js b/dist/directional-avatar.js
diff --git a/dist/dynamic-background.js b/dist/dynamic-background.js
diff --git a/dist/edit-dialog-from-dialog.js b/dist/edit-dialog-from-dialog.js
diff --git a/dist/edit-image-from-dialog.js b/dist/edit-image-from-dialog.js
diff --git a/dist/edit-player-from-dialog.js b/dist/edit-player-from-dialog.js
diff --git a/dist/edit-room-from-dialog.js b/dist/edit-room-from-dialog.js
diff --git a/dist/end-from-dialog.js b/dist/end-from-dialog.js
diff --git a/dist/exit-from-dialog.js b/dist/exit-from-dialog.js
diff --git a/dist/external-game-data.js b/dist/external-game-data.js
diff --git a/dist/favicon-from-sprite.js b/dist/favicon-from-sprite.js
diff --git a/dist/follower.js b/dist/follower.js
diff --git a/dist/gamepad-input.js b/dist/gamepad-input.js
diff --git a/dist/gravity.js b/dist/gravity.js
diff --git a/dist/itsy-bitsy.js b/dist/itsy-bitsy.js