Skip to content

neoSphere 5.7.0

Compare
Choose a tag to compare
@fatcerberus fatcerberus released this 15 Dec 02:40
· 68 commits to main since this release

neoSphere 5.7.0 is the eighth major release in the neoSphere 5.0 series. This release adds support for SGM-only Sphere v2 targeting, brings back the describe() function in Cell, renames BufferStream back to DataStream, and fixes several bugs.

What's New?

  • It is now possible to target Sphere v2 using only a game.sgm file. To that end, Cell will now include the necessary fields in the SGM file when building a game targeting Sphere v2. For full backward compatibility, a corresponding game.json will still be generated in the distribution.

  • Save data (i.e. files written into ~/...) is now stored in a Sphere Saves folder under the user's Documents folder. If you have any save data stored in the old location (neoSphere -> Save Data under Documents), you'll need to move it to the new location if you want your games to continue to pick it up.

  • BufferStream has been renamed back to DataStream for consistency with the naming of JavaScript's built-in DataView, which serves a similar purpose. The class is also better documented now.

  • When targeting API level 4, JSON.fromFile() will no longer work. FS.readFile() should be used instead, with its new JSON read mode (refer to the API documentation). For backward compatibility, JSON.fromFile() will continue to work in games targeting API level 3 and under.

  • The describe() function has been re-added to the Cellscript API and should be preferred going forward, instead of assigning directly to Sphere.Game.

  • When debugging a Sphere game in SSj, code originating inside one of the sphere-runtime modules is now skipped over. This allows Step Into to be used more freely without the need to wade through system code.

Full Changelog

  • Adds support for targeting Sphere v2 without a JSON manifest.
  • Adds back support for the describe() function in Cellscripts.
  • Adds support for showing a game's targeted API level in SSj.
  • Adds the ability to automatically step over Sphere Runtime code while debugging.
  • Adds a new JSON read mode for FS.readFile().
  • Changes the Documents folder hierarchy so both screenshots and save data are put into a single Sphere Saves directory.
  • Removes support for the undocumented JSON.fromFile() function when targeting Sphere v2 API level 4 or higher.
  • Fixes an issue where neoSphere annoyingly creates an empty directory for Sphere v1 games in the user's Documents folder on every startup.
  • Fixes a bug where Cell rejects save IDs containing spaces as invalid.
  • Fixes a bug where the engine may crash on startup if it's unable to launch the requested game.