${
	ScriptLoad("puzzlescript/puzzlescript-database.js",()=>PgdUpdate()),
	Hyper("PGDGame")
}

page.title
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#

page.summary
Currently the database contains **${DynamicText("titlenumber","over 1700")} puzzlescript games**. Whenever a new puzzlescript game is made, it will be added to this list by the community. **Found a missing title? Please add it now!**

Adding a puzzlescript game to this list
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#

To add a game to the "page.title" list in one click, simply use this handy ${Hoyper("Bookmarkletl")("Submit PuzzleScript Game","https://pedros.works/puzzlescript/puzzlescript-tagger.js")}
bookmarklet !

How? Simply add the [#bookmarklet] above to your bookmarks (instructions below), then on a game page of your choice run ([[click]] on) the new [#bookmarklet], causing the current game to add itself the page.title page.

${Hyper("Bookmarklet")}

Manual submission
============================================
You can also submit a game to the page.title by typing all details manually. This is only recommended when more practical than using the [#bookmarklet].
[Submit a game to the page.title]>>>RequestPGDSubmission()
As your edits will be immediately available on database refresh, please type carefully - even though all game entries can be corrected or completed later, by any user.

Where to find new games to add
============================================
If you want to add a game to the page.title but don't know where to look, you're in luck - for 99% of all new puzzlescript games show up at one of these sources:

- [Puzzlescript|www.puzzlescript.net]'s [official forum|https://groups.google.com/forum/#!forum/puzzlescript]
- @thinky
- itch.io's [Newest Puzzlescript Games|https://itch.io/games/newest/made-with-puzzlescript]
- @StephenLavelle's [Puzzlescript games|https://increpare.com/categories/puzzlescript.html]
- Github's [recently updated puzzlescript gists|https://gist.github.com/search?o=desc&q=puzzlescript&s=updated]


This is what makes the page.title so convenient - a single page where new games are gathered, so you won't need to search yourself. All new game contributions are thus very welcome!

Adding to or correcting game entries
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#

To correct a game entry in the page.title, simply [[tap]] the [[edit]] button

Conventions
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#


${Hyper("FilterSearch")}

Sorting
============================================
Date added
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
By default, all game entries are sorted by date of submission, most recent first. Usually those will be the newly released games, occasionally elusive old titles.

Custom
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
To sort the table differently, simply [[click]] the table headers: Title, Author, Year, Added
Games with unknown year of release (prior to 2019) are marked '0000' ~~but will self-correct (based on the creation date of the most recent gist) as soon as someone plays them in the console~~

Game :::labels
============================================
A game title may be unfinished or in progress :::beta, an extended or modified version of another game :::mod, a port of another game to puzzlescript :::demake and may have appended a version number (e.g **v0.0.0** ) and other notes...
For demakes or mods, or when a tribute to a known former author was meant, new authors may be labelled :::FormerAuthor.

Troubleshooting
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#

Real-time submission vs display delays
============================================
Game entries are submitted in real time, and become immediately available on page (re)load.
Please be aware that on page load, a static version of the table is displayed first, because it may take a few seconds to fetch the up-to-date table in real time. Once fetched, there is a small alert and the tag Up-to-date will be added to the table title.

Game/Author formatting issues, missing info
============================================
The [#bookmarklet] will copy the information present in the original puzzlescript game file, and may discard some characters such as parentheses and punctuation marks. So if a game entry is incorrect or incomplete, please correct it now!

Outdated information
============================================
Please note that the database doesn't track changes in game author/title after the submission. So please correct any outdated information as well!

Missing links
============================================
If a newly submitted game belongs to a known domain (e.g. puzzlescript.net), its link becomes immediately available. Otherwise, for security, it will be listed without a link (so people can google it themselves), until a periodic review. During this (infrequent) review, legitimate new domains will be added to the whitelist and their links enabled, whereas any suspicious submission will be removed.

Missing submitted game entries
============================================
Prototypes and examples
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
All game prototypes not listed in the page.title are filed instead under [game-tools#Puzzlescript examples] in a second database, alongside other useful examples of game mechanics, UI components, algorithms, etc...

Hidden from view
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
If, after re-submitting the game and fetching the most recent version of the database, a game is still not shown, most likely it was manually hidden from view. This is extremely rare and only happens when a game is:
	- **unplayable**, despite loading correctly; or
	- **not significantly different** from an earlier Puzzlescript game; or 
	- **already listed** with a different URL, corresponding to the most recent version.

If you believe a game currently shown strictly meets the above criteria to be hidden from view, please @@@ contact site.author @@@

FAQ
=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#

Why contribute to this database?
============================================
If you love (puzzlescript) games, you'll love to have a definite public list with all titles!**

Is the page.title complete?
============================================
The last exhaustive search ended 2019-12-31, with over 1300 games**. New games were added regularly ever since, but a few might be missing from the database. Shall you be lucky to find one, **please add it!**.

How could such a huge list of puzzlescript games be compiled with moderate effort?
============================================
The [#bookmarklet] is that quick and convenient - no typing involved. Have a try!

Is there any shorter, curated list with just the great titles?
============================================
You may be looking for site.author's curated list of [selected-puzzlescript-games] or other [selected-puzzlescript-games#notable lists]!

How could this long list of puzzlescript games become more useful?
============================================
Depending on traction, this collaborative list may gain a wiki-like character, so people could add detailed info like release year and tags, thus enabling better filtering. If pictures were added, this could become a puzzlescript gallery. Perhaps people would like to rate games or vote on their favourites!

Can this database be used in external projects?
============================================
For non-profit or educational projects, yes, as long as you cite it properly.
For all other projects, please @@@ contact site.author @@@ to discuss.

How to cite this database properly?
============================================
Just include all information below, using your favourite citing convention. If you are citing online, please ensure the link is clickable.

${Hyper("CitationSelf")}

${Hyper("Suggestions")}