Purpose
#=#=#=#=#=#=#

This is a //concise// compilation of puzzlescript game tools, including useful [forks|#Design tools] or [mods|#Engines], [helpful|#Graphics] [tools|#Level selector].
As a publicly shared, personal reference, it may be updated anytime.

Puzzlescript guide
====================

The [puzzlescript development guide|https://docs.google.com/document/d/1oJ55pZXylgeUJUx-F6xThPq1pSQlRshdu3sJZNrYZuM/] contains a wealth of puzzlescript tips & tricks to smoothen your puzzlescript learning curve. Coordinated by @thatscar, it is a document by the community to the community, so **dive in & contribute**!

Puzzlescript samples
====================

An extensive list of [Puzzlescript Code Samples|puzzlescript-samples] for many game components or mechanics (and even some unfinished games) is listed as a separate page, complementary to the the full [Puzzlescript games database].

Puzzlescript forks and tools
#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=

Over 100 puzzlescript #fork​s were made since 2013, and some of them are highlighted in the table below, alongside helpful #tool​s. These cover useful features and language extensions not incorporated yet in the original repository. The engine has also been adapted to create 3D games, and wrapped to run in different environments.

Type in the search area below or [[click]] any tag to add it to the search.





Design tools for levels and mechanics
=====================
Designing good levels is a potentially long process, but a #solver may speed that up a bit.
Writing puzzlescript rules in more complex situations may benefit from #testing, #transformer and #syntax tools. 

Level selector
=====================
Adding a level #selector to a puzzlescript game is a very common wish, for which there are many options, including site.author's [game bar]!

Music and sounds
=====================
Sometimes a little extra control over #music or #sound effects in puzzlescript is desired.

Accessibility and controllers
=====================
Controllers such as a #mouse or a #gamepad can be added to puzzlescript games, and there are more #accessibility-focussed initiatives.

Large level maps
=====================
Making larger game #maps with puzzlescript is regarded by many people as a challenge. Tools exist to make it less heroic.

Graphics
=====================
Using a larger #sprite, adding transparent #colours, changing the default #font, or even playing puzzlescript in #3D are possible!

Engines and UIs
=====================
With a different engine or #compiler, puzzlescript can run in different environments, and with alternative #ui, in and out of the browser.

★★:=:shards:

★	TITLE																																					AUTHOR(S)>>>P						DESCRIPTION																																							YEAR			TAGS>>>InputLabeltl
-	[JavaScript String Escape / Unescape|https://www.freeformatter.com/javascript-escape.html]																Anonymous							Recover PuzzleScript source code from an exported HTML file																											unknown			tool, code
-	[Beepbox Integration|https://github.com/jtpercon/PuzzleScript]																							Jamie Perconti						Set as background music files generated by beepbox.co																												2013			music
-	[Sprite Editor - bare bones|http://streamingcolour.com/liveapps/puzzlescript/psspriteeditor/]															Owen Goss							a really bare bones HTML5 sprite editor that generates PuzzleScript sprite code																						2013			tool, sprite
-	[Puzzlescript AI|https://groups.csail.mit.edu/icelab/content/puzzlescript-ai]																			Chong-U Lim, D. Fox Harrell			a system that automatically discovers solutions																														2014			solver
-	[Sprite Editor|http://tmtg.net/tinyspriteeditor/]																										Boris van Schooten					HTML spritesheet editor with Puzzlescript import/export functions																									2016			tool, sprite
-	[PZR|https://gist.github.com/ColtonPhillips/e86a77a824f16e1c100ad703ee041880]																			Colton Phillips						Turn png files into puzzlescript format quickly																														2016			tool, convert, png
-	[Puzzlescript Embed|https://github.com/raggy/puzzlescript-loader]																						Benjamin Davis						embed a PuzzleScript game in any page																																2016			tool, UI
-	[PUZGraphical|https://groups.google.com/forum/#!topic/puzzlescript/fivnOtTK97Y]																			Anonymous							Convert png to puzzlescript images and back																															2016			tool, convert, png
-	[Puzzlescript with Test Framework|https://github.com/richlocke87/PuzzleScript]																			Richard Locke						Testing framework within the puzzlescript Language																													2017			fork, testing
-	[PZFXR|https://github.com/nwhitehead/pzfxr]																												Nathan Whitehead					Command-line tool (C++) for WAV sound file generation, following the exact puzzlescript sound generating algorithm														2017			tool, sound
-	[Add mute link|https://thorduragust.github.io/puzzlescriptMuteLink/]																					Thordur Agust						Add mute link to exported PuzzleScript page																															2017			tool, sound, music
-	[Automatic level solver|https://marcosdon.github.io/PuzzleScriptWithSolver/editor.html]																	Marcos Donnantuoni					Check for unintended solutions in puzzle designs. Building block for procedural level generation.																	2018			fork, solver
-	[Dario Zubovic's PS Fork|https://dario-zubovic.github.io/PuzzleScript/editor.html]																		Dario Zubovic						Multifeature PS Fork: gamepad, level select, custom font, arbitrary sprite size, transparent colours, case sensitiveness, nosave									2018			fork, selector, font, sprite, colour, save, gamepad
-	[Sprites 8x8|https://cyatheatree.github.io/PuzzleScript/editor.html]																					Cyathea Tree Studio					8x8 sprites (higher resolution)																																		2018			fork, sprite
-	[Mouse Action Fork|https://github.com/zarawesome/PuzzleScript/tree/mouse_action]																		Guilherme Stutz Töws				Click a tile to trigger an Action command																															2018			fork, mouse
-	[PuzzleClick Fork|https://github.com/ThatScar/PuzzleScript/]																							that Scar							Interact with the game by click and drag (with mouse)																												2018			fork, mouse
-	[Puzzlescript C++ Wrapper|https://github.com/Narkhos/Puzzlescript-Wrapper]																				Xavier Direz						Create standalone puzzlescript executables																															2018			compiler, executable
-	[Puzzlang Web Viewer|https://david-pfx.github.io/PuzzlangWeb/]																							David Bennett						Display Puzzlescript games within a Unity WebGL wrapper																												2018			compiler, unity
-	[Dungeonscript|http://dungeonscript.farbs.org/]																											Farbs								First-person perspective for any puzzlescript game																													2018			fork, 3d
-	[Puzzlebit Retro Console|https://github.com/gritfish/puzzlebit]																							Gritfish							A retro console wrapper UI for Bitsy and PuzzleScript games, for touchscreen devices exclusively																	2018			mobile, UI
-	[Accessible Puzzlescript Games|https://philschatz.com/puzzlescript/]																					Phil Schatz							Accessible PuzzleScript Interpreter for screen readers																												2018			accessibility, input, UI
★★	[Game Bar]																																				site.author							Adds a level selector, music playlist and hints support, fullscreen and mobile. Can be added to any game on the fly via a bookmarklet								2019			bookmarklet, hints, mobile, music, selector,
-	[MIS (formerly MixedAim Level Tool)|https://dekeyser.ch/puzzlescriptmis/]																				Kevin De Keyser						Interactively co-create PuzzleScript games with your computer, using a level transformer (plus a level editor, test mode and solver)								2019			editor, testing, solver, transform
-	[Level selector|https://groups.google.com/forum/#!topic/puzzlescript/uydhXEf8j0E]																		Alan Hazelden						Level selector																																						2019			selector
-	[PSengine|https://www.msx.org/forum/msx-talk/development/puzzlescript-on-msx]																			Rogerup								Megadrive / MSX puzzlescript compiler																																2019			compiler, executable
-	[Level and Sprite Rotator and Flipper|https://jcmiller11.github.io/psUtil/]																				jcGyo								Rotate levels and sprites; flip horizontal and vertically																											2019			tool, transform, sprite
-	[Sprite Editor|http://lafaceobscuredupixel.fr/pzSprt/]																									Xavier Direz						Edit sprites quickly																																				2019			tool, sprite
-	[Puzzlescript Video Codec|https://github.com/Clark-E/PuzzleScript-Video-Codec/]																			Ethan Clark							Convert a sequence of images (video) to PuzzleScript source code																									2019			tool, convert, video
-	[Puzzlescript Syntax Highlighter for Notepad++|https://cdn.discordapp.com/attachments/474018445680312340/584165272735318017/PuzzleScriptUDL.xml]		HugoBDesigner						A User-Defined Language for PuzzleScript with 99% accurate highlight.																								2019			code, syntax
-	[Twine App Builder|https://github.com/lazerwalker/twine-app-builder]																					Emilia (lazerwalker)				take games made in PuzzleScript and produce desktop builds																											2020			compiler, executable
-	[Puzzle Engine|https://github.com/HParker/puzzleengine]																									Adam Hess							C (ncurses/SDL) engine for running puzzlescript games outside of the browser.																						2020			compiler, executable
-	[Level select fork|https://github.com/pancelor/PuzzleScript/tree/level-select]																			Pancelor							Level select, seamlessly integrated in puzzlescript. Press Esc to return to the selector.																			2020			fork, selector
-	[Large Maps Fork|https://jacklance.github.io/PuzzleScript/editor.html]																					Jack Lance							Speeds up the puzzlescript engine on large game maps, by evaluating only the local rules																			2020			fork, map, performance
-	[Puzzlescript Command Prompt Flick Utility|https://github.com/Croubble/PuzzleScriptFlickScreenUtil]														Crouble								make a giant flickscreen map by automatically stitching individual levels into the right position																	2020			flickscreen, map, tool
-	[Pseudo-3D fork|https://github.com/broken-sign-games/PuzzleScript/]																						Menderbug							Enables an easy pseudo-3d effect by allowing sprites taller than 5 pixels, aligned at the bottom edge of the cell.													2021			fork, sprite, 3d
-	[Puzzlescript +|https://github.com/Auroriax/PuzzleScriptPlus]																							Auroriax							Aggregates the forks of @@ that scar,Marcos Donnantuoni,Dario Zubovic@@																								2021			fork, mouse, selector, solver, sprite
-	[Pattern:Script|https://github.com/ClementSparrow/Pattern-Script/wiki]																					Clement Sparrow						A template system, generating new rules and sprites automatically. Features rule parameters, tags and mappings; sprite copy/transform, debug support.				2021			fork, sprite, syntax, code
★★	[Puzzlescript Sound Catalog|puzzlescript-sounds.html]																								site.author							A database of SFC sounds contributed by the community.																												2021			sound
-	[Background Music fork / MML|https://github.com/competor/PuzzleScript]																					Competor							Add background music to your puzzlescript code, using MML (Music Macro Language).																					2022			sound, music, fork
-	[SFX unscrambler|https://pancelor.com/puzzlescript-sfx-unscrambler/]																					Pancelor							Pick a sound, modify the wave shape using sliders, then search the SFX sound space for the closest match.															2022			sound, tool
-	[PuzzlescriptNext|https://david-pfx.github.io/PuzzleScriptNext/]																						David Bennett						Aggregates Puzzlescript Plus, Pattern:Script and PuzzleFAB, with new features such as text sprites, animation, layer inspection, mouse click actions, property object maps, etc...	2023			fork, mouse, sprite, compiler
-	[PuzzleScript Build System (PSBS)|https://github.com/jcmiller11/PSBS]																					jcGyo								A fork-agnostic build system for Puzzlescript via Jinja2, featuring image/spritesheet import, source text & gist loading, gist saving, and much more				2023			compiler, tool, sprite, code





## Acknowledgments

Thanks to everyone who suggested changes and additions to this page!

| If you have a suggestion or you found these puzzlescript resources useful, do [leave a message on the guestbook!]>>>RequestGuestbook()

**2024-09-02** Added missing search tags, updated the page title and several table entries and fixed some broken links to this page -- thanks @DavidBennett