Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/seleb/bitsy-hacks

a collection of re-usable scripts for bitsy game maker
https://github.com/seleb/bitsy-hacks

bitsy javascript

Last synced: 5 days ago
JSON representation

a collection of re-usable scripts for bitsy game maker

Awesome Lists containing this project

README

        

# bitsy hacks

```sh
npm i @bitsy/hecks
```

A collection of re-usable scripts for [Adam Le Doux](https://twitter.com/adamledoux)'s [Bitsy Game Maker](https://ledoux.itch.io/bitsy). See [Ayolland's Borksy](https://ayolland.itch.io/borksy) for a GUI that allows you to use these hacks with less copy-pasting.

Last tested against Bitsy 8.12

- [Contents](#contents)
- [How to use](#how-to-use)
- [FAQ](#FAQ)
- [Old Versions](#old-versions)
- [Further reading](#further-reading)

## Contents

- ๐Ÿ‘ฅ [avatar by room](/dist/avatar-by-room.js): change the avatar in certain rooms
- ๐Ÿ–ผ [backdrops](/dist/backdrops.js): makes the game have a backdrop
- ๐Ÿ”ˆ [basic sfx](/dist/basic-sfx.js): "walk" and "talk" sound effect support
- ๐Ÿ˜Œ [bitsymuse](/dist/bitsymuse.js): A variety of Bitsy sound and music handlers
- ๐Ÿ˜ด [canvas replacement](/dist/canvas-replacement.js): WebGLazy bitsy integration (this one's mostly just for me)
- ๐Ÿ˜ฝ [character portraits](/dist/character-portraits.js): high quality anime jpegs (or pngs i guess)
- ๐Ÿ™€ [character portraits animated](/dist/character-portraits-animated.js): high quality anime gifs
- โ›”๏ธ [close on ending](/dist/close-on-ending.js): Prevents from playing past an ending
- โžฟ [corrupt](/dist/corrupt.js): corrupts gamedata at runtime
- ๐ŸŽž [custom-exit-effects](/dist/custom-exit-effects.js): make custom exit transition effects
- ๐Ÿ…ฐ [custom text effect](/dist/custom-text-effect.js): make {custom}text effects{custom}
- ๐Ÿ’ฌ [dialog audio](/dist/dialog-audio.js): animal crossing-style audio
- ๐ŸŽบ [dialog audio vocal synth](/dist/dialog-audio-vocal-synth.js): animal crossing-style audio powered by the pink trombone vocal synth
- ๐Ÿ” [dialog box transition](/dist/dialog-box-transition.js): adds an easing transition animation to display the dialog box text
- ๐Ÿ”€ [dialog choices](/dist/dialog-choices.js): dialog choices
- ๐Ÿš€ [dialog jump](/dist/dialog-jump.js): jump from one dialog entry to another
- ๐Ÿ’ฌ [dialog pause](/dist/dialog-pause.js): add pauses in between printing text
- โŒจ [dialog prompt](/dist/dialog-prompt.js): prompt the user for text input in dialog
- โ†” [directional avatar](/dist/directional-avatar.js): flips the player's sprite based on directional movement
- ๐Ÿ” [direction in dialog](/dist/direction-in-dialog.js): provides a variable with player direction
- ๐Ÿ–ผ [dynamic background](/dist/dynamic-background.js): HTML background matching bitsy background
- ๐Ÿ“ [edit dialog from dialog](/dist/edit-dialog-from-dialog.js): edit dialog from dialog (yes really)
- ๐Ÿ–Œ [edit image from dialog](/dist/edit-image-from-dialog.js): edit sprites, items, and tiles from dialog
- ๐Ÿ‘ฏโ€โ™‚๏ธ [edit player from dialog](/dist/edit-player-from-dialog.js): change which sprite is controlled by the player
- ๐Ÿ  [edit room from dialog](/dist/edit-room-from-dialog.js): modify the content of a room from dialog
- ๐Ÿ”š [end-from-dialog](/dist/end-from-dialog.js): trigger an ending from dialog, including narration text (deprecated)
- ๐Ÿšช [exit-from-dialog](/dist/exit-from-dialog.js): exit to another room from dialog, including conditionals
- ๐Ÿ›ฐ [external-game-data](/dist/external-game-data.js): separate Bitsy game data from your (modded) HTML for easier development
- ๐ŸŒ [favicon-from-sprite](/dist/favicon-from-sprite.js): generate a browser favicon (tab icon) from a Bitsy sprite, including animation!
- ๐Ÿ’• [follower](/dist/follower.js): make sprites follow the player
- ๐ŸŽฎ [gamepad input](/dist/gamepad-input.js): HTML5 gamepad support
- ๐Ÿ‚ [gravity](/dist/gravity.js): Pseudo-platforming/gravity/physics
- ๐Ÿ•ท [itsy-bitsy](/dist/itsy-bitsy.js): for when bitsy's not small enough
- โ˜• [javascript dialog](/dist/javascript-dialog.js): execute arbitrary javascript from dialog
- ๐Ÿ”€ [logic-operators-extended](/dist/logic-operators-extended.js): adds conditional logic operators
- ๐Ÿ“œ [long dialog](/dist/long-dialog.js): put more words onscreen
- ๐Ÿ‘จโ€๐Ÿ‘จโ€๐Ÿ‘งโ€๐Ÿ‘ง [multi-sprite avatar](/dist/multi-sprite-avatar.js): make the player big
- ๐Ÿ”„ [online](/dist/online.js): multiplayer bitsy
- โฌ› [opaque tiles](/dist/opaque-tiles.js): tiles which hide the player
- ๐Ÿ“ƒ [paragraph-break](/dist/paragraph-break.js): Adds paragraph breaks to the dialogue parser
- โณ [permanent items](/dist/permanent-items.js): prevent some items from being picked up
- โžก [push sprites](/dist/push-sprites.js): sokoban-style sprite pushing
- ๐ŸŽญ [replace drawing](/dist/replace-drawing.js): add name-tags to replace drawings when the game is loading
- ๐Ÿ’พ [save](/dist/save.js): save/load your game
- ๐Ÿ›‘ [solid items](/dist/solid-items.js): treat some items like sprites that can be placed multiple times
- โฑ๏ธ [stopwatch](/dist/stopwatch.js): time player actions
- ๐Ÿ—ฃ [text-to-speech](/dist/text-to-speech.js): text-to-speech for bitsy dialog
- ๐Ÿฐ [tracery processing](/dist/tracery-processing.js): process all dialog text with a tracery grammar
- ๐ŸŽž [transitions](/dist/transitions.js): customizable WebGL transitions
- ๐Ÿ”ณ [transparent background](/dist/transparent-background.js): makes the game have a transparent background
- ๐Ÿ‘๏ธโ€๐Ÿ—จ๏ธ [transparent dialog](/dist/transparent-dialog.js): makes the dialog box have a transparent background
- ๐Ÿ [transparent sprites](/dist/transparent-sprites.js): makes all sprites have transparent backgrounds (deprecated)
- ๐Ÿ’ฑ [twine bitsy comms](/dist/twine-bitsy-comms.js): interprocess communication for twine and bitsy
- โ„ [unique items](/dist/unique-items.js): items which, when picked up, remove all other instances of that item from the game

![Custom text effect demo](https://i.imgur.com/peRLLHn.gif)![Follower demo](https://i.imgur.com/yg81aH2.gif)![Unique items demo](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):

```html