User:SergioFLS/Personal curation notes

From Flashpoint Datahub
Jump to navigation Jump to search

This page is meant as some notes on how I curate specific stuff, with the hopes it ends up being useful for Flashpoint curators.

Most of this is HTML5, as that's what I mostly curate of.

Scratch (scratch.mit.edu)

I've seen curators using the TurboWarp Packager for curations, and while convenient, most of the time isn't how the game was originally meant to be played.

I understand using packagers for games that only work on Scratch 2.0, as the original runtime that was found on scratch.mit.edu seems to be lost.

1.4 projects?

The first versions of Scratch had entirely different runtimes for web and desktop, which caused incompatibilities on the web player.

There were two players, a Java-based player, and a experimental Flash-based one, which was only accessible to registered users. The Experimental viewer was eventually used for Scratch 2.0.

An example of a project using the Java player is dig dug (846d15fe-8177-40db-8ab3-d413b55730fe).

TODO

2.0 projects

Projects updated before 2 January 2019 (the release of Scratch 3.0) are most likely guaranteed to work under Scratch 2.0.

Before the update though, the website actually gave you an option of downloading the project as an .sb2 file, but this feature was removed after the 3.0 update. You can still regenerate your own using .sb downloader, just put your link to the project, then click the "Download legacy version" button.

TODO packing

3.0 projects

As of writing this document, Scratch 3.0 is the latest version.

First of all, Load the assets with MAD4FP, with http://scratch.mit.edu/projects/{your project id}/fullscreen/ as the launch command (you can also end it with /embed/, but I prefer fullscreen as it lets the user download the .sb3 file more easily).

For the browser, Basilisk/Flashpoint Navigator does the job just fine, though:

  • One curation played .wav files incorrectly for some reason. Switching either to Chromium or browser mode mitigates this issue.
  • Seems like Scratch performs better under Chromium-based browsers. Use them if performance is the project's priority.

Once the page stops loading, you might notice that only the top navigation bar appears, but nothing else. This is because of scripts trying to load HTTPS content, you can just replace all instances of https:// to http:// on all .js files on the scratch.mit.edu folder (I use Notepad++'s Find in files function for this).

Once done that, open the Network monitor (you'll see why now), reload the page, and you will notice an error message along the lines of "We are so sorry, but it looks like Scratch has crashed." Seems like the Scratch runtime tries to load an asset, but MAD4FP fails to save it (possibly) due to having a very long URL.

Copy the URL that comes from the projects.scratch.mit.edu subdomain, replace http to https, and then download it yourself on a web browser (I tried cURLsDownloader and it also fails to download). Your resulting file will have the name of the project's ID, move it to {your content folder}/projects.scratch.mit.edu.

If the file is valid, it should be a JSON file, starting with {"targets":. If you get an error message, then that means the token expired, try doing everything all over again, or grab the URL again live with your web browser.

Once done that, let the project load. After that, the project files should be already saved. You should also try loading the UI assets for Turbo Mode (Shift+Flag), and the confirmation checkmark for user input (if the project uses it).

Now you'll have to test it without MAD4FP, as sometimes files give the 200 OK response, but fail to save.

You can now just delete the folders related to Google Analytics, and your files should be done.

If the descriptions ask you to run the project with TurboWarp for whatever reason, you can just run http://turbowarp.org/{your project id}/fullscreen with MAD4FP, and the process is mostly similar (you don't have to deal with projects.scratch.mit.edu, though). After that, put the TurboWarp URL as an alt.

TODO instructions for forkphorus