Features & Limitations - aeryli/Scratch-3DS GitHub Wiki

1. Unique Features

3DS Screen modes

  • Any un-edited scratch project will be displayed on the Top Screen only.
  • If using a modded Scratch client like Turbowarp, you can go into the projects' Advanced Settings and change the resolution.
    • Setting it to 400x480 will enable both the top and bottom screen.
    • Setting it to 320x240 will enable only the Bottom screen.
    • Setting it to 400x240 will make the project perfectly fit to the top screen.
    • NOTE: make sure to click Store Settings In Project on Turbowarp to properly apply the settings.

Wii U Screen Modes

  • Currently, projects display exactly the same on both the TV and the Gamepad, and there's no way to change Screen modes.

Audio

  • mp3, ogg, and wav audio formats are supported.
  • A sound will take time to load if playing it for the first time.
    • Known Bug: On 3DS, if a sound has to load while other sounds are playing, all sounds will stop playing until the sound is loaded.
  • If you play any sound from the "Stage," the sound will play as a "Streamed Sound," and will not need to load.
  • Only one "Streamed Sound" can be playing at a time, so this is good for things like background music.
  • Sounds may fail to load on 3DS if the file size of the song is too high, or if there's too many sounds loaded at once.

Framerate

  • When using a modded Scratch client like Turbowarp, you can enable the 60 FPS (Custom FPS) advanced option, and change the FPS to any value.

Differently Implemented Blocks

  • The Username block returns the 3DS's nickname, and the Wii U's current Mii name.
  • The Touching __? block uses simpler box collision, which may lead to projects working incorrectly.
  • The Stop 'All' block brings you back to the Homebrew menu.

2. Limitations

As this is in a very W.I.P state, you will encounter many bugs, crashes, and things that will just not work.

List of known limitations:

  • There is no vector/svg sprite rendering. Images will only render if converted to bitmap beforehand, otherwise the sprite will show as a black square
  • Images will only work if it's in .png or .jpg format
  • Extensions (eg: pen and music extensions) are not yet supported
  • Some blocks may lead to crashing/unintended behavior (please open an issue if you know a block that's causing problems)
  • [Wii U] The first controller connected will be the only one that will work
  • [3DS] Performace is poor when lots of blocks are running at once
  • [3DS] If you have a bunch of large images, some may not load
  • [3DS] Images cannot be over 1024x1024 in resolution
  • [3DS] Some images may appear 'fuzzy' looking or have noticable inconsistencies

Unimplimented blocks

  • All say and think blocks
  • All* Costume Effects
    • *Ghost Costume Effect is supported.
  • Cloud variables
  • Show/hide list
  • When backdrop switches to
  • When this sprite clicked
  • When loudness > ___
  • All Color touching blocks
  • Set drag mode
  • Loudness

Roadmap / to-do list

Runtime

3DS

  • Stereoscopic 3D support

Wii U

  • Dual screen support
  • Improved controller support (multiple controllers, Wii Remotes)

Other

  • Ability to remap controls
  • Download projects from the Scratch website
  • Improve main menu UI