Game tools | Pedro's Works

Updated on Monday, 2^nd of September 2024 (created 2019-10-12) — Filed under: Community List Gamedev Resource Puzzlescript

This is a concise compilation of puzzlescript game tools, including useful forks or mods, helpful tools. As a publicly shared, personal reference, it may be updated anytime.

The puzzlescript development guide contains a wealth of puzzlescript tips & tricks to smoothen your puzzlescript learning curve. Coordinated by Skalmantas Šimenas (that Scar), it is a document by the community to the community, so dive in & contribute!

An extensive list of Puzzlescript Code 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.

Over 100 puzzlescript s were made since 2013, and some of them are highlighted in the table below, alongside helpful 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 (tap) or (click) any tag to add it to the search.

Designing good levels is a potentially long process, but a may speed that up a bit. Writing puzzlescript rules in more complex situations may benefit from , and tools.

Adding a level to a puzzlescript game is a very common wish, for which there are many options, including Pedro's Game Bar!

Sometimes a little extra control over or effects in puzzlescript is desired.

Controllers such as a or a can be added to puzzlescript games, and there are more initiatives.

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

Using a larger , adding transparent , changing the default , or even playing puzzlescript in are possible!

With a different engine or , puzzlescript can run in different environments, and with alternative , in and out of the browser.

★	Title	Author(s)	Description	Year	Tags
-	JavaScript String Escape / Unescape	Anonymous (???)	Recover PuzzleScript source code from an exported HTML file	unknown	and
-	Beepbox Integration	Jamie Perconti	Set as background music files generated by beepbox.co	2013
-	Sprite Editor - bare bones	Owen Goss	a really bare bones HTML5 sprite editor that generates PuzzleScript sprite code	2013	and
-	Puzzlescript AI	Chong-u Lim and D. Fox Harrell	a system that automatically discovers solutions	2014
-	Sprite Editor	Boris van Schooten	HTML spritesheet editor with Puzzlescript import/export functions	2016	and
-	PZR	Colton Phillips	Turn png files into puzzlescript format quickly	2016	; and
-	Puzzlescript Embed	Benjamin Davis	embed a PuzzleScript game in any page	2016	and
-	PUZGraphical	???	Convert png to puzzlescript images and back	2016	; and
-	Puzzlescript with Test Framework	Richard Locke	Testing framework within the puzzlescript Language	2017	and
-	PZFXR	Nathan Whitehead	Command-line tool (C++) for WAV sound file generation, following the exact puzzlescript sound generating algorithm	2017	and
-	Add mute link	Thordur Agust	Add mute link to exported PuzzleScript page	2017	; and
-	Automatic level solver	Marcos Donnantuoni	Check for unintended solutions in puzzle designs. Building block for procedural level generation.	2018	and
-	Dario Zubovic's PS Fork	Dario Zubovic	Multifeature PS Fork: gamepad, level select, custom font, arbitrary sprite size, transparent colours, case sensitiveness, nosave	2018	; ; ; ; ; and
-	Sprites 8x8	Cyathea Tree Studio	8x8 sprites (higher resolution)	2018	and
-	Mouse Action Fork	Guilherme Stutz Töws (Zaratustra Productions)	Click a tile to trigger an Action command	2018	and
-	PuzzleClick Fork	Skalmantas Šimenas (that Scar)	Interact with the game by click and drag (with mouse)	2018	and
-	Puzzlescript C++ Wrapper	Xavier Direz (Narkhos)	Create standalone puzzlescript executables	2018	and
-	Puzzlang Web Viewer	Davidus of Polyomino	Display Puzzlescript games within a Unity WebGL wrapper	2018	and
-	Dungeonscript	Farbs	First-person perspective for any puzzlescript game	2018	and
-	Puzzlebit Retro Console	Gritfish	A retro console wrapper UI for Bitsy and PuzzleScript games, for touchscreen devices exclusively	2018	and
-	Accessible Puzzlescript Games	Phil Schatz	Accessible PuzzleScript Interpreter for screen readers	2018	; and
	Game Bar	site.author' id='p-replaceableclassconfigdatalinksiteauthorsiteauthorreplaceable'>Pedro	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	; ; ; and
-	MIS (formerly MixedAim Level Tool)	Kevin De Keyser	Interactively co-create PuzzleScript games with your computer, using a level transformer (plus a level editor, test mode and solver)	2019	; ; and
-	Level selector	Alan Hazelden (Draknek)	Level selector	2019
-	PSengine	Rogerup	Megadrive / MSX puzzlescript compiler	2019	and
-	Level and Sprite Rotator and Flipper	J. C. Miller (jcGyo)	Rotate levels and sprites; flip horizontal and vertically	2019	; and
-	Sprite Editor	Narkhos	Edit sprites quickly	2019	and
-	Puzzlescript Video Codec	Ethan Clark (EPGA Studios)	Convert a sequence of images (video) to PuzzleScript source code	2019	; and
-	Puzzlescript Syntax Highlighter for Notepad++	Hugo Balthazar	A User-Defined Language for PuzzleScript with 99% accurate highlight.	2019	and
-	Twine App Builder	Emilia	take games made in PuzzleScript and produce desktop builds	2020	and
-	Puzzle Engine	Adam Hess	C (ncurses/SDL) engine for running puzzlescript games outside of the browser.	2020	and
-	Level select fork	Pancelor	Level select, seamlessly integrated in puzzlescript. Press Esc to return to the selector.	2020	and
-	Large Maps Fork	Jack Lance	Speeds up the puzzlescript engine on large game maps, by evaluating only the local rules	2020	; and
-	Puzzlescript Command Prompt Flick Utility	Crouble (NarrowAdder)	make a giant flickscreen map by automatically stitching individual levels into the right position	2020	; and
-	Pseudo-3D fork	Martin Ender (Menderbug)	Enables an easy pseudo-3d effect by allowing sprites taller than 5 pixels, aligned at the bottom edge of the cell.	2021	; and
-	Puzzlescript +	Tom Hermans (Auroriax)	Aggregates the forks of that Scar, Marcos Donnantuoni and Dario Zubovic	2021	; ; ; and
-	Pattern:Script	Clement Sparrow	A template system, generating new rules and sprites automatically. Features rule parameters, tags and mappings; sprite copy/transform, debug support.	2021	; ; and
	Puzzlescript Sound Catalog	site.author'>Pedro	A database of SFC sounds contributed by the community.	2021
-	Background Music fork / MML	Kuchiwo Tsugumi (Competor)	Add background music to your puzzlescript code, using MML (Music Macro Language).	2022	; and
-	SFX unscrambler	Pancelor	Pick a sound, modify the wave shape using sliders, then search the SFX sound space for the closest match.	2022	and
-	PuzzlescriptNext	Davidus of Polyomino	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	; ; and
-	PuzzleScript Build System (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	; ; and

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

If you have a suggestion or you found these puzzlescript resources useful, do

2024-09-02 Added missing search tags, updated the page title and several table entries and fixed some broken links to this page — thanks Davidus of Polyomino

Puzzlescript Tools Purpose Puzzlescript guide Puzzlescript samples Puzzlescript forks and tools Design tools for levels and mechanics Level selector Music and sounds Accessibility and controllers Large level maps Graphics Engines and UIs Acknowledgments