This is more of a general feature request, and not specifically about the SDK. I didn't know where else to file it.
The SDK docs and help pages refer to the "game" unit in different ways, and there's no specified recommended way for developers to bundle and distribute games. Please provide one.
The following is a list of several conflicting behaviors and documentation I found, followed by how I naturally "expect" things to work (whether or not it's feasible or not is up to you - this isn't a criticism. I'm also assuming you probably thought about some of this stuff already)
- The Compiling a project section of the SDK refers to "pdx" being the output folder, but doesn't explicitly say that this is what you should distribute to players. On itch, some developers are distributing "pdx.zip" files, and some just a zip file which contains a .pdx directory, along with maybe other materials. Which is preferred?
- The dev page has the FAQ "How do I distribute my Playdate game?" but doesn't really address file formats. It should.
- The sideloading guide says to "Drag or select the .pdx game file (or zipped .pdx) to upload it.". Problem is, the "pdx game file" is not really a file. It's a directory (or "folder", depending on parlance). It's my understanding that it only kinda looks like a file in Mac, which not everyone uses.
- When you download a game from Pulp, the file is named like
Untitled-Pulp-Game_20220426191151.zip
-- why not include.pdx
in the file name? - When running the simualtor with a pdx.zip file as the first argument it gives the cryptic error " "(null)" was built with an old version of the SDK." (another thread about this). It should at least detect it's not pointed at a folder. (Opened a separate bug about this). It would be better if it could "read" zip files without complaint.
I think it would be really helpful if .pdx.zip files were "first-class" citizens, and were supported by the simulator and playdate itself -- is this feature missing as a performance tradeoff? Sideloading through the website supports "zipped pdx files", but sideloading over USB doesn't. It means that players who download "pdx.zip" files via itch have to go through the technical step of unzipping the file.
I think it's much more natural for players to think of "games" as single files, rather than directories with "file extensions" in their name, which is a very foreign concept (at least in the windows and linux world)